2.8.1 Specifying the environment files to use the user-reply functionality
In JP1/Advanced Shell, you can specify the operating environment by using two types of environment files, the system environment file for applying the same operating environment to multiple jobs, and a job environment file for applying a different operating environment to each job. If you will be using the user-reply functionality, you must edit the system environment file as appropriate for the system's environment.
Once you have edited the system environment file, you must restart the daemon or service.
- Organization of this subsection
(1) Specifying the spool root directory
Use the SPOOL_DIR parameter to specify the spool root directory to which job execution results are to be output. When you will be using the user-reply functionality, you must define the SPOOL_DIR parameter only in the system environment file. Path names cannot contain multibyte characters.
For details about the SPOOL_DIR parameter, see SPOOL_DIR parameter (defines the spool root directory path name) in 7. Parameters Specified in the Environment Files.
(2) Specifying the JP1 event destination host
You must use the HOSTNAME_JP1IM_MANAGER parameter in the system environment file to specify the operation management server on which the JP1/IM - Manager that is the destination of JP1 events is running. If this parameter is omitted, the host name displayed when the hostname command is executed on the server on which JP1/Advanced Shell is running is assumed as the destination of JP1 events. Define the HOSTNAME_JP1IM_MANAGER parameter only in the system environment file. Also, verify that the name of the host on which JP1/Advanced Shell is run can be resolved on the host specified in this parameter.
For details about the HOSTNAME_JP1IM_MANAGER parameter, see HOSTNAME_JP1IM_MANAGER parameter (specifies the operation management server on which JP1/IM - Manager is running that is to be the destination of JP1 events) in 7. Parameters Specified in the Environment Files.
(3) Specifying JP1 event flow control
When you use the user-reply functionality, the conditions shown in the table below concerning output of JP1 events must be satisfied. These conditions apply to all JP1 events that are received by the same JP1/IM.
|
No. |
Description |
Output condition |
|---|---|---|
|
1 |
JP1 events |
The number of JP1 events output per second must be less than 2. |
|
2 |
Reply-waiting events |
The number of reply-waiting events output per minute must be less than 1. |
In JP1/Advanced Shell, you use the USERREPLY_JP1EVENT_INTERVAL parameter to specify the minimum interval at which JP1 events are to be issued by the adshecho or adshread command. If multiple jobs issue events, specify the parameter in such a manner that the frequency of JP1 event issuance by the adshecho and adshread commands from all jobs satisfies the above conditions.
For details about the USERREPLY_JP1EVENT_INTERVAL parameter, see USERREPLY_JP1EVENT_INTERVAL parameter (specifies the minimum interval at which JP1 events are to be issued) in 7. Parameters Specified in the Environment Files.
(4) Specifying the maximum number of concurrent reply-request messages that can be output
You use the USERREPLY_WAIT_MAXCOUNT parameter to specify the maximum number of concurrent reply-request messages that can be output by the user-reply functionality for each physical or logical host. Specify in this parameter a value that is at least equal to the number of jobs that will execute the adshread command concurrently.
For details about the USERREPLY_WAIT_MAXCOUNT parameter, see USERREPLY_WAIT_MAXCOUNT parameter (specifies the maximum number of concurrent reply-request messages that can be output for a physical or logical host) in 7. Parameters Specified in the Environment Files.