adshchmsg command (replies manually to a reply-request message when a failure occurs)

Format

adshchmsg [-h logical-host-name] -n reply-request-message-number {-r reply|-d}

To Page Top

Description

This command enters a reply to a reply-request message in shared memory when a failure occurs. It can also be used to cancel the reply-waiting status of a reply-request message.

You specify the reply-request message number of the reply-request message in the -n option and the reply in the -r option. To cancel the reply-waiting status of a reply-request message, you specify the reply-request message number of the reply-request message in the -n option and you specify the -d option (which requests cancellation).

In an execution environment, this command can be executed by the root or an Administrator with an administrator role on the machine where JP1/Advanced Shell is installed. In a development environment, a general user can run this command.

To Page Top

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 work.

-n reply-request-message-number ~<unsigned integer>((1 to 2147483647))

Specifies the reply-request message number of the reply-request message that you want to reply to or whose reply-waiting status you want to cancel. Specify the reply-request message's number as displayed by the adshlsmsg command.

Either the -r option or the -d option must also be specified or an error will result.

If no reply request message number is specified, the option that is specified next will be treated as the argument, resulting in an error.

-r reply ~<ASCII character string>((0 to 512 bytes))

Specifies the reply to be read by the issuer of the reply-waiting event. If the reply contains a space, enclose the reply string in double quotation marks (").

An error results if the -n option is not specified.

If you specify a character string that exceeds 512 bytes, only the first 512 bytes are treated as the reply. If a character string that contains an end-of-line code is specified, the portion of the character string following the end-of-line code will be ignored.

-d

Specifies that the reply-waiting status of the reply-request message specified in the -n option is to be canceled. An error results if the -n option is not also specified.

To Page Top

Return codes

To Page Top

Notes

• In the following cases, the item that is specified last will be the one that takes effect:

  • The -r and the -d option are both specified.

  • The -r option is specified more than once.

  • The -n option is specified more than once.

To Page Top