jcocmdshow

Organization of this page

Function
Format
Required execution permission
Command directory
Arguments
Return values
Example
Output example

Function

JP1/IM requests command execution from the Execute Command window of JP1/IM - View, or uses the automated action function to request command execution. This command allows you to check the statuses of 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. This command provides the following formation:

ID: A unique ID assigned to a command being executed or queued in command execution management
STATUS: The execution status of a command in command execution management (R indicates that the command is being executed, and Q indicates that the command is currently queued.)
TYPE: The name of the function requesting command execution (WIN indicates that it was requested from JP1/IM -View, and ACT indicates that it was requested by the automated action function.)
USER: The name of the JP1 user requesting command execution
STIME: The time that command execution management received the command from JP1/IM
ETIME: The length of time that has elapsed since command execution started
COMMAND: The name of the command being executed or queued

For safety reasons, we recommend that you use this command to check the status of a command that you want to delete. Before you use the jcocmddel command to delete the command, confirm that it is not required (can be deleted).

To Page Top

Format

jcocmdshow [-h logical-host-name]
           [-s target-host-name]
           [-window]
           [-act]
           [-state {r|q}]
           [-ph command-submitting-host-name]
           [-v]

To Page Top

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

To Page Top

Command directory

In Windows:: installation-folder\bin\
In UNIX:: /opt/jp1base/bin/

To Page Top

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 that contains commands whose execution statuses are to be checked. 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.

`-window`

If you want to check the execution statuses of commands for which execution was requested from the Execute Command window of JP1/IM - View, specify this option. If you specify both this option and the -act option, or if you omit both options, the command displays the execution statuses of commands for which execution was requested by the Execute Command window of JP1/IM - View and the automated action function.

`-act`

If you want to check the execution statuses of commands for which the automated action function requested execution, specify this option. If you specify both this option and the -window option, or if you omit both options (-window and -act), the command displays the execution statuses of commands for which execution was requested by the Execute Command window of JP1/IM - View and the automated action function.

`-state {r|q}`

Specify a command execution status. If you want to know which commands are running, specify r. Likewise, if you want to know which commands are queued, specify q.

If you omit this option, information on the commands that are running and queued is output.

`-ph` `command-submitting-host-name`

If you want to know which commands were submitted from a specific host, specify this option.

`-v`

If you want to vertically display information output by the jcocmdshow command, specify this option.

If you omit this option, the information items output by the jcocmdshow command are not displayed on individual lines.

To Page Top

Return values

`0`	Normal end
`1`	No command available in 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

To Page Top

Example

In this example, the execution statuses of commands being executed on the target host host01 are displayed.

jcocmdshow -s host01

To Page Top

Output example

When the -v option is omitted:

jcocmdshow -s host01
ID   STATUS TYPE USER     STIME           ETIME     COMMAND
1234 R      WIN  jp1admin Feb 13 18:55:29 000:01:05 "C:\WINNT\system32\notepad.exe"

When the -v option is specified:

jcocmdshow -s host01 -v
ID       :1234
STATUS   :R
TYPE     :WIN
USER     :jp1admin
STIME    :Feb 13 18:55:29
ETIME    :000:01:05
COMMAND  :"C:\WINNT\system32\notepad.exe"

To Page Top