OpenTP1 Version 7 Operation

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

scdls (Display scheduling status)

Format

scdls [{-a|-s server-name|-ac|-s server-name -c|-ae|-s server-name -e|
      -b[scheduling-buffer-group-name]|-p} [-t]]

Function

The scdls command outputs the scheduled status of a server working under the scheduling service, or service status to the standard output.

This command outputs the status of a buffer pool for storing messages to the standard output for each scheduling buffer group.

This command also outputs the load level of the scheduler daemon receiving the service request to the standard output.

Options

-a

Specifies that information about all servers, except the system service, that are active at the time the scdls command is entered is to be displayed. When this option is omitted, -a is assumed.

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

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

-ac

Displays the status of all servers working under the scheduling service, and service status. For a server for which service_hold=N (do not shut down on a service basis) has been specified in the user service definition, only its status is displayed.

-s server-name -c~<1-8 character identifier>

Displays the service status of the specified server. For a server for which service_hold=N (do not shut down on a service basis) is specified in the user service definition, only its status is displayed.

-ae

Displays the statuses of all services on all servers working under the scheduling service.

Statuses are displayed only for servers for which service_hold=Y (shut down on a service basis) or the scdsvcdef definition command (which specifies operations on a service basis) has been specified in the user service definition.

-s server-name -e~<identifier of 1 to 8 characters>

Displays the service status of the specified server.

Statuses are displayed only for servers for which service_hold=Y (shut down on a service basis) or the scdsvcdef definition command (which specifies operations on a service basis) has been specified in the user service definition.

-b scheduling-buffer-group-name

Displays the status of a buffer pool for storing messages used by the scheduling buffer group, and the scheduling status of the user server in that scheduling buffer group.

Specify the scheduling buffer group name specified in the schedule service definition.

When a scheduling buffer group name is not specified, information on all the scheduling buffer group names is displayed.

-p

Displays the load level of the scheduler daemon receiving the service request.

-t

Displays the time when a service request was last retrieved from the schedule queue. Do not specify this option at the same time as the -b or -p option.

Output format

(1) Scheduling status displayed

[Figure]

1. This information is displayed only when scdls -a is specified.

3. If scdls -a is specified, this information is displayed as many times as there are servers operating under the scheduler.

The 2. lines and the 3. lines are usually each displayed on a single line; on some display devices, they may be broken into multiple lines.

4. If the -t option is specified, this information is displayed only as many times as there are servers.

aaaa
Number of servers operating under the scheduler (decimal)

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

c
Status of the corresponding server:
S: Under server preparation
A: Can be scheduled
E: Under server termination processing
H: Server shutdown status
P: Service shutdown status being ready to accept service requests

dddddd
Number of service requests remaining in the scheduling queue (decimal, 6 digits)

eeeeee
Maximum number of service requests having remained in the scheduling queue (decimal, 6 digits)

ffffffff
Size of the message storage pool currently in use (decimal)

gggggggg
Size of the message storage pool currently not in use (decimal)

hhhhhhhh
Maximum size of the message storage pool that can be used (decimal)

iiiiiiii
Current maximum size of unused contiguous area in the message storage pool (decimal)

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

kk...kk
Time when a service request was last retrieved from the schedule queue
The time is displayed according to the setting in the TZ environment variable, based on the number of seconds from 00:00:00 on January 1, 1970. If no service requests have ever been retrieved from the schedule queue, the time is displayed as follows:
Example:

Thu Jan 1 09:00:00 1970 (when JST-9 is set for the TZ environment variable)

Notes
  • If the status of the corresponding server is E, 0 may be displayed for dddddd through iiiiiiii.
  • The information indicating the schedule status of MHP is the server name, server status and service group name. Ignore the other information, which is the control information for the schedule service.

(2) Service status displayed

[Figure]

1. This information is displayed only when scdls -ac is specified.

2. If scdls -ac is specified, this information is displayed as many times as there are servers working under the scheduling service.

3. For a server for which service_hold=Y (shut down on a service basis) is specified in the user service definition, this information is displayed as many times as there are services. If the -e option is specified, the information is displayed in the formatting indicated by the number 6.

4. and 5. This information is usually displayed on a single line, but may be broken into multiple lines on some display devices.

6. When service_hold=Y (shut down on a service basis) has been specified in the user service definition, or the scdsvcdef definition command is specified to control queues on a service basis, this information is displayed as many times as there are services. This information is displayed following the information indicated by the number 2 without a line break. If the -c option is specified, the information is displayed in the formatting indicated by the number 3.

7. If the -t option is specified, this information is displayed as many times as there are services. This information is displayed following the information indicated by the number 3 or 6, without a line break.

aaaa
Number of servers operating under the scheduling service (decimal, 1-4 digits)

bb...bb
Server name (1-8 characters)

c
Status of the corresponding server
S: Under server preparation
A: Can be scheduled
E: Under server termination processing
H: Server shutdown status
P: Shutdown status being ready to accept service requests

dd...dd
Service group name (1-31 characters)

e
Status of the service
S: Under server preparation
A: Can be scheduled
E: Under server termination processing
H: Service shutdown status
P: Shutdown status being ready to accept service requests

ff...ff
Service name (1-31 characters)

gg...gg
The number of service requests currently in the schedule queue for the service (up to 6 decimal digits)#

hh...hh
The maximum number of service requests that have been queued in the schedule queue for the service (up to 6 decimal digits)#

ii...ii
The current size of the buffer pool for storing messages used by the service (up to 8 decimal digits. Unit: bytes)#

jj...jj
The maximum size of the buffer pool for storing messages used by the service (up to 8 decimal digits. Unit: bytes)#

kk...kk
The number of instances of the service being executed concurrently (up to 4 decimal digits)#

ll...ll
The maximum number of instances of the service that have been executed concurrently (up to 4 decimal digits)#

mm...mm
Time when a request for the service was last retrieved from the schedule queue#
The time is displayed according to the TZ environment variable, based on the number of seconds from 00:00:00 on January 1, 1970. If no requests for the service have ever been retrieved from the schedule queue, the time is displayed as follows:
Example:
Thu Jan 1 09:00:00 1970 (when JST-9 is set for the TZ environment variable)

#
If the scdsvcdef definition command for controlling queues on a service basis is not specified in the user service definition, **...** is displayed for these items.

(3) Status of buffer pool for storing messages displayed

[Figure]

The lines 1. to 5. are each displayed on a single line.

1. This information is displayed only when a scheduling buffer group name is not specified.

5. This information is displayed for each of the servers sharing the scheduling buffer.

If a scheduling buffer group name is not specified, lines of 2. to 5. are displayed for each of the buffer groups.

aaaa
Number of scheduling buffer groups (1-4 digits decimal)

bb...bb
Scheduling buffer group name (up to 8 characters identifier)

cc...cc
Length of the buffer pool for storing messages in the scheduling buffer group (1-8 digits decimal, bytes)

dd...dd
Size of the buffer pool for storing messages currently in use (1-8 digits decimal, bytes)

ee...ee
Current maximum size of the available buffer pool for storing messages
If the buffer pool for storing message is insufficient for storing a message, ******** is displayed.

ff...ff
Server name (up to 8 characters identifier)

g
Server status (one character)
S: Preparing
A: Available for scheduling
E: In process of server termination processing
H: Shutdown
P: Shutdown but available for accepting service

hh...hh
Number of service requests remaining in the scheduling queue of the server (1-6 digits decimal)

ii...ii
Maximum number of service requests having remained in the scheduling queue of the server (1-6 digits decimal)

jj...jj
Size of the buffer pool for storing messages used by the server (1-8 digits decimal, bytes)

kk...kk
Maximum size of the buffer pool for storing messages having used by the server (1-8 digits decimal, bytes)

(4) Load level of scheduler daemon displayed

[Figure]

1 and 2:
This information is usually displayed on a single line. On some display devices, however, it may be broken into multiple lines.

2.
The information is displayed for each of the scheduler daemons if the multi-scheduler facility starts multiple scheduler daemons.

aa...aa
Server name of scheduler daemon (up to 8 characters)

bb...bb
Identifier of scheduler daemon (up to 14 characters), consisting of the multi-scheduler group name and port number delimited by ": "
For a master scheduler daemon, the multi-scheduler group name is indicated as ********, and the port number is indicated as ***** when the scd_port operand of the schedule service definition is not specified.

cc...cc
Number of active processing threads (1-5 digits decimal)

dd....dd
Maximum number of active processing threads (1-5 digits decimal)

ee...ee
Time when the number of active processing threads rises to a maximum (8 characters)
When there is no active processing thread, "**.**.**" is displayed.

ff...ff
Number of times a shortage of processing threads occurs (1-10 digits decimal)

gg...gg
Maximum number of times a shortage of processing threads occurs successively (1-10 digits decimal)

hh...hh
Time when the number of times a shortage of processing threads occurs rises to a maximum (8 characters)
When no shortage of processing threads has occurred, "**.**.**" is displayed.

ii...ii
Period of time between when a processing thread receives a service request and when scheduling is completed (11 digits including 6 decimal places)
If the period of time for scheduling becomes less than 0 because the time of the OS is reset or because of any other reasons, "*****.******" is displayed.

jj...jj
Maximum period of time between when a processing thread receives a service request and when scheduling is completed (11 digits including 6 decimal places)

kk...kk
Time when the period of time between when a processing thread receives a service request and when scheduling is completed rises to a maximum (8 characters)
When no service requests are received, "**.**.**" is displayed.

ll...ll
Number of service requests received in unit time (1-10 digits decimal)
This indicates the number of service requests received during the interval processing time that the scheduler daemon performs every 10 seconds. If the interval processing time takes much time, the unit time may become longer than 10 seconds.

mm...mm
Maximum number of service requests received in unit time (1-10 digits decimal)

nn...nn
Time when the number of service requests received in unit time rises to a maximum (8 characters)
When no service requests are received, "**.**.**" is displayed.

Notes

The information of scheduler daemon's load level is updated or referenced without locking to minimize the influence on the processing performance. Therefore, the displayed information may be invalid depending on the timing. In this case, re-execute the command. The information displayed by this option only includes service requests provided via the scheduler daemon. If a service request is scheduled to SPP of the local node, the information of the service request may not be updated because it bypasses the scheduler daemon.

Output messages

Message ID Description Output destination
KFCA00880-I Help message Standard output,
standard error output
KFCA00890-E Error occurred during scdls command processing. Standard error output
KFCA00891-E Usage of the scdls command is invalid. Standard error output
KFCA00892-E scdls command execution environment has not been set up. Standard error output
KFCA00893-E Specified server name is invalid. Standard error output
KFCA00894-E scdls command cannot be executed due to inconsistent versions. Standard error output