OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

prcls (Display status of servers)

Format

prcls [{-a|-g service-group-name|-l executable-form-file-name
      |-s server-name|-p process-ID|-x}]

Function

The prcls command displays to the standard output the status of specified servers.

Options

-a

Specifies that the status of all user servers and the system service is to be displayed.

-g service-group-name~<identifier, 1-31 characters>

Specifies the name of a service group, the status of all of whose servers is to be displayed.

-l executable-form-file-name~<identifier, 1-14 characters>

Specifies the execution form file name of a server whose status is to be displayed.

-s server-name~<identifier, 1-8 characters>

Specifies the name of a server whose status is to be displayed.

-p process-ID~<unsigned integer>

Specifies the ID of a process whose server's status is to be displayed.

When all these options are omitted, the status of the user server managed by the process server is displayed.

-x

Displays the service execution status of each process in the user server.

Output format

When the -x option is specified

[Figure]

aa...aa
Process ID (up to 10 characters)

bb...bb
Server name

cc...cc
Time when the service function is called
The time is updated each time the service function is executed. The time is the number of seconds from 00:00:00 January 1, 1970 for the TZ environment variable. The time is displayed as follows if the process has never executed the service function.
Thu Jan 1 09:00:00 1970 (when the TZ environment variable is JST-9)

dd...dd
Time when the service function is returned
The time is updated each time the service function is executed. The time is the number of seconds from 00:00:00 January 1, 1970 for the TZ environment variable. The time is displayed as follows if the process has never executed the service function.
Thu Jan 1 09:00:00 1970 (when the TZ environment variable is JST-9)

ee...ee
Total number of times the service function is executed after the process has started
The count resets to 0 when it exceeds 4294967295.

When an option other than the -x option is specified

[Figure]

a
Status of the server:
D: Engaged in server startup or termination processing
L: Engaged in server execution
*: Debugger process

bb...bb
Process ID (up to 10 characters)

cc...cc
User ID (up to 10 characters)
* is displayed for any process other than the child process generated from the process service.

dd...dd
Group ID (up to 10 characters)
* is displayed for any process other than the child process generated from the process service.

ee...ee
Server name (up to 8 characters)

ff...ff
Execution form file name (up to 14 characters)
utodbgpp: Execution format file of debugger working with appropriate server

gg...gg
Service group name (up to 31 characters)

Notes

To specify the -x option, TP1/Extension 1 must be installed. The operation is not guaranteed if TP1/Extension 1 is not installed.

Output messages

Message ID Description Output destination
KFCA00710-E Shared memory cannot be used. Standard error output
KFCA00712-E Unexpected error occurred. Standard error output
KFCA00750-E Memory is inadequate. Standard error output
KFCA00751-E prcls command format is invalid. Standard error output
KFCA00752-E Execution form file name is invalid. Standard error output
KFCA00753-E Server name is invalid. Standard error output
KFCA00754-E Process ID is invalid. Standard error output
KFCA00759-E Service group name is invalid. Standard error output
KFCA00790-I Output header Standard output
KFCA00791-I Help message Standard output