adshmdctl command (starts and stops the user-reply functionality management daemon) (UNIX only)
- Organization of this page
Format
adshmdctl [-h logical-host-name] {start [reuse]|stop|status|conftest [environment-file-name]|help}
Description
This command starts and stops the user-reply functionality's management daemon. The user-reply functionality's management daemon manages the shared memory for the user-reply functionality.
When the user-reply functionality is used, reply-request messages are stored in shared memory. Normally, they are released when the user-reply functionality management daemon is stopped. If the user-reply functionality management daemon terminates because of a failure without releasing the shared memory, you must use this command to release the shared memory. The following is the procedure for doing this:
-
Execute this command with the start reuse option specified
-
Execute this command with the stop option specified, and then stop the user-reply functionality's management daemon
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.
It is recommended that the length of the logical host name not exceed 63 bytes. If you specify a name that exceeds 63 bytes, the command might not function correctly.
If the logical host name specification is omitted, any option that is specified next will be treated as the argument.
- start [reuse]
-
Specifies that the user-reply functionality's management daemon is to be started.
If reuse is specified, the information in the reply-request messages will be used as is by the user-reply functionality.
When the user-reply functionality is used, reply-request messages are stored in shared memory, and normally they are released when the user-reply functionality's management daemon is stopped. If the user-reply functionality's management daemon terminates because of a failure without releasing the shared memory, the user must release the shared memory by first starting the management daemon with the reuse option specified in the adshmdctl command, and then terminating the management daemon by specifying the adshmdctl command with the stop option specified.
- stop
-
Specifies that the user-reply functionality's management daemon is to be stopped.
If there are reply-request messages that have not yet been replied to, the waits for replies will be cancelled.
- status
-
Specifies that the operating status of the user-reply functionality's management daemon is to be returned, using one of the following return codes:
-
0: The user-reply functionality's management daemon is running
-
1: The user-reply functionality's management daemon is not running
-
- conftest [environment-file-name]
-
Specifies an environment file whose parameters are to be checked. The results are output to the standard output.
If environment-file-name is omitted, the system environment file is checked.
- help
-
Specifies that a help for the adshmdctl command is to be displayed.
Return codes
|
Return code |
Meaning |
|---|---|
|
0 |
Normal termination |
|
Other than 0 |
Error termination |
Notes
-
Start the user-reply functionality's management daemon as a root job.
-
Do not change the file system environment while the user-reply functionality's management daemon is running.
-
The adshmdctl command sets the LANG environment variable to C and launches the management daemon of the user-reply functionality. For this reason, subsequent messages and JP1 events are output in English.