17.47 deletenwctllist (deleting network control list)

Functionality

This command deletes all network control information on a management server. The conditions for deleting network control information are specified in the configuration file for the delete network control list command.

Execute this command on a management server. Complete the management server setup process, and start the management server service before executing this command.

Format

deletenwctllist.exe[∆-i∆configuration-file][∆-o∆CSV-output-file-storage-folder][∆-c∆command]

Arguments

-i∆configuration-file

Specify the full path of the configuration file for the delete network control list command. If you omit this argument, the following file is referenced.

JP1/IT Desktop Management 2installation-destination-folder\mgr\conf\deletenwctllist.ini

-o∆CSV-output-file-storage-folder

Specify the full path of the storage folder for outputting CSV files. If you omit this argument, CSV files are output to the following folder.

JP1/IT Desktop Management 2installation-destination-folder\mgr\temp

-c∆command

Specify the processing command to be executed. If you omit this argument, the command prompt will be standing by for you to enter commands directly. A list of commands is given below.

d: Outputs a CSV file of the network control information matching the conditions of the configuration file for the delete network control list command, and then deletes the matching network control information from the list.
o: Outputs a CSV file of the network control information matching the conditions of the configuration file for the delete network control list command.
e: Checks the configuration file for the delete network control list command, and then outputs the number of network control information entries matching the conditions.

Storage location

JP1/IT Desktop Management 2installation-destination-folder\mgr\bin\

You can execute this command without specifying the storage location for the executable file by using the command prompt provided by JP1/IT Desktop Management 2.

Format of the configuration file for the delete network control list command

The result of the AND condition for conditions set for each item in the configuration file for the delete network control list command acts as conditions for deleting network control information and outputting targets for deletion in CSV format.

The following describes the format of the configuration file for the delete network control list command.

Format

[WHERE]
macip_way=setting
macaddress=setting
ipaddress=setting
confirmation=setting
device=setting

Item description

Item	Description	Setting
`macip_way`	Specify the method used to set the MAC address and IP address. Always specify this setting.	0: Unspecified (deletes network control information for all MAC addresses and IP addresses) 1: Specify the MAC address only 2: Specify the IP address only 3: Specify a MAC address and IP address (AND) 4: Specify a MAC address and IP address (OR)
`macaddress`	Specify the MAC address to be deleted. Always specify this setting if the `macip_way` setting is 1, 3, or 4. Prefix matching is used as the distinction method. A colon (`:`) is used as a delimiter. Separate between multiple MAC addresses using a comma (`,`). Multiple MAC addresses are combined under the OR condition. You can specify up to 10 MAC addresses. All subsequent MAC addresses will be ignored.	The MAC addresses to be deleted
`ipaddress`	Specify the IP address to be deleted. Always specify this setting if the `macip_way` setting is 2, 3, or 4. Prefix matching is used as the distinction method. Separate between multiple IP addresses using a comma (`,`). Multiple IP addresses are combined under the OR condition. You can specify up to 10 IP addresses. All subsequent IP addresses will be ignored.	The IP addresses to be deleted
`confirmation`	Specify whether to only delete candidates for confirmation. Always specify this setting.	0: Delete all network control information. 1: Only delete network control information that is a candidate for confirmation.
`device`	Specify whether to only delete network confirmation information that is unrelated to the device. Always specify this setting.	0: Delete all network control information. 1: Only delete network control information that is unrelated to the device.

Configuration example

[WHERE]
macip_way=3
macaddress=00:00:01,00:00:02
ipaddress=192.168.0,192.168.1
confirmation=0
device=0

Format of the CSV output file

The format of the CSV output file is described below.

Output destination

CSV files are output to the folder with the -o option specified. If unspecified, CSV files are output to the following folder.

JP1/IT Desktop Management 2installation-destination-folder\mgr\temp

File name

deletenwclist_yyyymmddhhmmssfff-format-of-output-date.csv

For example: deletenwclist_20210531173140307.csv

Output items

MAC address
IP address
Host identifier
Confirmation candidacy (0: No effect, 1: Candidate for confirmation)

Notes

Execute this command when the management server setup is completed and the management server is running.
This command cannot be simultaneously executed by multiple users.
This command cannot be executed simultaneously with any of the following commands:
- exportdb
- importdb
- ioassetsfieldutil export
- ioassetsfieldutil import
- ioutils exportasset
- ioutils exportassetassoc
- ioutils exportdevice
- ioutils exportdevicedetail
- ioutils exportfield
- ioutils exportfilter
- ioutils exportoplog
- ioutils exportpolicy
- ioutils exporttemplate
- ioutils exportupdategroup
- ioutils exportupdatelist
- ioutils importasset
- ioutils importassetassoc
- ioutils importexlog
- ioutils importfield
- ioutils importfilter
- ioutils importpolicy
- ioutils importtemplate
- ioutils importupdategroup
- ioutils importupdatelist
- reorgdb
- startservice
- stopservice
- updatesupportinfo
- deletenwgroup
- deletepackage
- distributelicense
To execute this command, perform the following steps:
1. Stop the following services:
  
  Start the Administration Tools service, and then stop the following services from the list of services: Check the service outage before stopping the next service.
  - JP1_ITDM2_Agent Control
  - JP1_ITDM2_Service
  - JP1_ITDM2_Web Container
  - JP1_ITDM2_Web Server
  - JP1_ITDM2_Relay Manager Service^#
2. Execute the deletenwctllist command.
  
  Make sure that the service is stopped when you run the command before running it.
3. After the command is complete, start the next service:
  
  Start the Administration Tools service, and then start the following services from the list of services: Check the service startup before launching the next service.
  - JP1_ITDM2_Agent Control
  - JP1_ITDM2_Service
  - JP1_ITDM2_Web Container
  - JP1_ITDM2_Web Server
  - JP1_ITDM2_Relay Manager Service^#
#: If you are administering a single configuration management server, you do not need to stop or start this service.

Return values

The following table shows the return values of the deletenwclist command.

Return value	Description
0	The command finished normally.
31	Another command is being executed.
51	You do not have the permissions to execute this command.
150	The command execution was interrupted due to some other error.
-1 to -9	An initialization error occurred (JP1/IT Desktop Management 2 has not been set up)
-11 to -49	A database error occurred (the database has not been started)
-101 to -109	There was an error loading the configuration file for the delete network control list command. -101：`macip_way`, or file loading failed -102：`macaddress` -103：`ipaddress` -104：`confirmation` -105：`device`
-111 to -119	The specified format for the command argument is incorrect. -111: The number of arguments is invalid. -112: Invalid arguments found -113: The -c option value is invalid -114: A file with the -i option does not exist -115: A folder with the -o option does not exist
-201 to -209	Deletion error (database access error)
-211 to -229	CSV output error
-999	Other error

Example

The following example shows the use of this command to output network control information matching the conditions listed in the configuration file for the delete network control list command (C:\temp\deletenwclist.ini) to the default folder in CSV format, and then delete the network control information from the list:

deletenwclist.exe -i C:¥temp¥deletenwctllist.ini -c d

Related Topics:

17.1 Executing commands

To Page Top