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.
-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.
(1) Scheduling status displayed
- 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
- 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
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
- 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.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.