21.1.1 Setting execution agent restrictions

(1) Setting an execution agent profile

1. Copy the model file to the environment-settings file storage folder.

   The model file and the environment-settings file storage folder are as follows:

   In Windows:

   Model file:

   JP1/AJS3-Manager-installation-folder\conf\ajsprof_AJSROOT1_agent.conf.model

   Environment-settings file storage folder

   For a physical host:

   JP1/AJS3-Manager-installation-folder\conf

   For a logical host:

   shared-folder\jp1ajs2\conf

   In UNIX:

   Model file:

   /etc/opt/jp1ajs2/conf/ajsprof_AJSROOT1_agent.conf.model

   Environment-settings file storage directory

   For a physical host:

   /etc/opt/jp1ajs2/conf

   For a logical host:

   shared-directory/jp1ajs2/conf

2. Rename the copy of the file to the predetermined name.

   Rename the file to:

   ajsprof_scheduler-service-name_agent.conf

3. Use a text editor to edit the file.

   Specify the necessary settings in the execution agent profile.

   In Windows:

   For editing, use a text editor such as Notepad.

   You can also use either of the following methods to copy execution agent names or execution agent group names from the defined execution agents or execution agent groups:

   - Copy execution agent names or execution agent group names from the list output by using the ajsagtshow command. For details about the copying procedure, see (2) Copying from the list output by the ajsagtshow command.

   - Copy execution agent names or execution agent group names from the results of a search in JP1/AJS3 - View. For details about the copying procedure, see (3) Copying from the results of a search in JP1/AJS3 - View.

   For details about execution agent profiles, see 21.1.2 Details of execution agent profile.

   In UNIX:

   For editing, use a text editor such as vi.

   You can copy execution agent names or execution agent group names from the list of defined execution agents or execution agent groups output by using the ajsagtshow command. For details about the copying procedure, see (2) Copying from the list output by the ajsagtshow command.

   For details about execution agent profiles, see 21.1.2 Details of execution agent profile.

   Cautionary note:

   The following information is set in the model file:

   - Full name of the unit to which the file is applied: /example

   - Restriction check when the unit is defined: Restrictions are checked

   - Operation when the unit is defined: The dialog box cannot be closed by clicking OK if an execution target that is not allowed has been specified.

   - Restriction check when a job is executed: Restrictions are checked.

   - Permitted execution target: Execution is allowed only on the default execution agent (@SYSTEM).

   If this model file is applied as is when a unit named /example exists, the jobs in the /example unit become executable only on the default execution agent. Before you apply the execution agent profile, edit it as needed to fit the operation.

4. Apply the execution agent profile settings.

   Do the following to enable the execution agent profile settings:

   • If the JP1/AJS3 service is not running:

     Start the JP1/AJS3 service. The execution agent profile settings for all scheduler services configured on the relevant host are enabled.

   • If the JP1/AJS3 is running but the scheduler service is not:

     Do either of the following:

     - Start the scheduler service. The execution agent profile settings for the scheduler service you started are enabled.

     - Execute the following command:

     ajsprofalter -F scheduler-service-name -t agent -m set

     The execution agent profile settings for the scheduler service which are specified with the -F option are enabled.

   • If the JP1/AJS3 service and the scheduler service are both running:

     Execute the following command:

     ajsprofalter -F scheduler-service-name -t agent -m set

   The execution agent profile settings for the scheduler service which are specified with the -F option will be enabled.

   For details about the ajsprofalter command, see ajsprofalter in 3. Commands Used for Normal Operations in the manual JP1/Automatic Job Management System 3 Command Reference.

To Page Top

(2) Copying from the list output by the ajsagtshow command

To copy execution agent names or execution agent group names from a list of execution agent definitions output by the ajsagtshow command:

1. Execute the ajsagtshow -n command.

2. Copy the required execution agent names or execution agent group names from the output result of the ajsagtshow command.

   Copy the required names from the shaded part shown below.

   

3. Paste the copied information into the execution agent profile.

   Paste the copied execution agent names or execution agent group names on the lines between @SYS_AGENTLIST_START and @SYS_AGENTLIST_END in the execution agent profile.

To Page Top

(3) Copying from the results of a search in JP1/AJS3 - View

To copy execution agent names or execution agent group names from the results of a search in JP1/AJS3 - View:

1. Use the JP1/AJS3 - View Search window to find the execution agents configured in the target unit.

2. In the Search window, choose Options, and then Save Csv Unit Data.

   The search results are copied to the clipboard in CSV format.

3. Paste the search results into a spreadsheet.

4. Copy the execution agent names from the information you have pasted.

   Copy the required names in the shaded part shown below.

   

5. Paste the copied information into the execution agent profile.

   Paste the copied information on the lines between @SYS_AGENTLIST_START and @SYS_AGENTLIST_END in the execution agent profile.

Cautionary note:

If the job is running on the manager host with no execution agent specified in the detailed definition of a unit, the default execution agent @SYSTEM is not output to the JP1/AJS3 - View search result. Accordingly, manually add @SYSTEM to the execution agent profile.

To Page Top