jcocmddel
- Organization of this page
Function
JP1/IM requests command execution in the Execute Command window of JP1/IM - View, or uses the automated action function to request command execution. This command allows you to terminate and delete commands on a JP1/Base host that are being executed or queued in the above manner.
Use this command when a command execution problem occurs, such as when a wrong command is executed while the system is being used, or when a time-consuming command prevents the next command from being executed. Before you execute this command, use the jcocmdshow command to check the target command's status and confirm that it is not required (can be deleted).
Format
jcocmddel [-h logical-host-name]
[-s target-host-name]
[-f]
[command-ID | ALL]
Required execution permission
In Windows: Administrators (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)
In UNIX: Superuser or JP1/Base administrator permission
Command directory
- In Windows:
-
installation-folder\bin\
- In UNIX:
-
/opt/jp1base/bin/
Arguments
-h logical-host-name
Specify the logical host if you are using JP1/Base in a cluster system. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed. There is no need to specify this argument unless you are running a cluster system.
-s target-host-name
Specify the name of the target host on which the command to be deleted exists. You can enter a character string that is from 1 to 255 bytes to specify the host. If you omit this option, the local host is assumed.
-f
Specify this option if you want to suppress the confirmation message that is displayed when a command is deleted. If you specify this option, the selected command is forcibly deleted.
command-ID | ALL
Specify a command to be deleted. To delete a specific command, you must specify the corresponding command ID shown when the jcocmdshow command is executed. To delete all commands that are currently being executed or queued, specify ALL.
Use spaces to delimit multiple command IDs.
Return values
|
0 |
Normal end |
|
1 |
The command ID was not found, or some commands have been deleted from the JP1/Base command execution management. |
|
2 |
Invalid argument |
|
4 |
Insufficient system resources |
|
8 |
No permission to execute commands |
|
16 |
An error occurred during communication with JP1/Base command execution management. |
|
32 |
An error occurred during access to the common definitions. |
|
64 |
No response from the target host |
|
65 |
Version incompatible with the target host |
|
128 |
Internal error |
|
129 |
Maximum connections error |
|
255 |
Other error |
Example
In this example, the command 1234 that is currently being executed on the target host host01 is deleted.
jcocmddel -s host01 1234
Output example
jcocmddel -s host01 1234 KAVB2291-Q Do you want to delete the specified command ID(s) [Y/y or N/n] -> KAVB2293-I The command(s) were deleted successfully from command execution control.