adshlsmsg command (displays a list of reply-request messages when a failure occurs)
- Organization of this page
Format
adshlsmsg [-h logical-host-name] [-n reply-request-message-number]
Description
This command displays a list of the reply-request messages in shared memory that are in reply-waiting status, as well as the reply-request messages in receive-waiting status and the replies to them.
In an execution environment, this command is executed by Administrators or root users with an administrator role on the machine where JP1/Advanced Shell is installed. In a development environment, general users can run this command.
Arguments
- -h logical-host-name ~<logical host name>((1 to 255 bytes))
-
When you are operating in a logical host environment, specifies the host name of the logical host where the command will be executed.
In Windows, the length of the logical host name must not exceed 196 bytes, and it is recommended that it not exceed 63 bytes. If you specify a name that exceeds 63 bytes, the command might not function correctly.
- -n reply-request-message-number ~<unsigned integer>((1 to 2147483647))
-
Specifies the reply-request message number of a reply-request message in reply-waiting status that you want to display, or of a reply-request message in receive-waiting status that you want to display together with the reply to it.
If only -n is specified and no reply-request message number is specified, any option that is specified next will be treated as the argument.
When this specification is omitted, the display is of all reply-request messages in shared memory on reply-waiting status, as well as of all reply-request messages in receive-waiting status and the replies to them.
If the -n option is specified more than once, the last specification takes effect.
Output items
The following describes the headers and contents that are output as a result of executing the adshlsmsg command.
-
MESSAGE-NO
The 10-digit decimal reply-request message number. This is the value that is specified in the -n option of this command or in the -n option of the adshchmsg command.
-
STATUS
The status of the reply-request message is output as follows.
-
Wait: The reply-request message is in reply-waiting status
-
Set: The reply-request message is in receive-waiting status
-
-
JOBID
The six-digit integer value representing the job ID issued by the adshread command for the job definition script.
-
LINENO
The line number in the job definition script executed by the adshread command.
-
DATE/TIME
The time the reply-request message was output (local time).
-
MESSAGE or RESPONSE
The following items are output:
-
msg=: Reply-request message body
-
res=: Reply contents (displayed only if in receive-waiting status)
-
Return codes
Return code |
Meaning |
---|---|
0 |
Normal termination |
Other than 0 |
Error termination |
Usage example
The following example shows the output when you view a list of reply-request messages in reply-waiting status, as well as reply-request messages in receive-waiting status and the replies to them.
$ adshlsmsg MESSAGE-NO STATUS JOBID LINENO DATE/TIME MESSAGE or RESPONSE [0000017622] [Wait] 000228 20 12/05/24 18:28:00 msg=STOP [0000017626] [Set ] 000229 136 12/05/24 18:28:10 msg=Continue (Y/N)? [0000017626] [Set ] 000229 136 12/05/24 18:28:10 res=Y