1.1.3 Specifying a unit name in a command when using a planning group
If operating a unit under a planning group with the following commands, units, which have a generation at the command executions, are automatically selected as operands without the root jobnet name specified. Therefore, when the commands are executed, you can operate the running root job or its subordinate jobs even if the root jobnet name is not specified.
-
ajschgstat
-
ajsintrpt
-
ajskill
-
ajsplan
-
ajsrerun
-
ajsshow
Whether a unit is automatically selected as an operand depends on the value specified in -X option in the above commands or on the value of the environment variable set in AJSAUTOJUDGE. Other than the above commands, irrespective of the setting of the environment variable AJSAUTOJUDGE, the root jobnet name under a planning group cannot be omitted. The unit name should be specified in a full path which you want to operate.
For details of the commands above, see 1.5 Commands. For detail of the environment AJSAUTOJUDGE see 1.4 Environment variables.
The following rules apply whether the automatic selection setting is valid:
-
The values specified in the -X option of the command has the priority. If the -X option is specified, the decision takes place according to the specified value.
- When -X yes is specified:
-
Automatic selection is effective. You can specify a unit name without the root jobnet under the planning group. The running units are selected automatically and execution takes place on the corresponding units.
- When -X no is specified:
-
Automatic selection is not effective. You cannot omit the root jobnet name under the planning group. Specify the unit name in a full path.
- When -X auto is specified:
-
Specify the root jobnet name in a full path under the planning group. In this case, the specified unit is an operand. The path name without specifying the root jobnet name under the planning group is shared by another unit is considered as omitted, the running units are automatically selected and the corresponding units are operated.
-
If the -X option is not specified, the value of the environment variable AJSAUTOJUDGE decides actions.
- When AJSAUTOJUDGE is YES:
-
Automatic selection is effective. You can specify a unit name without the root jobnet under the planning group. The running units are selected automatically and execution takes place on the corresponding units.
- When AJSAUTOJUDGE is NO:
-
Automatic selection is not effective. You cannot omit the root jobnet name under the planning group. Specify the unit name in a full path.
- When AJSAUTOJUDGE is AUTO:
-
Specify the root jobnet name in a full path under the planning group. In this case, the specified unit is an operand. The path name without specifying the root jobnet name under the planning group is shared by another units is considered as omitted, the running units are automatically selected and the corresponding units are operated.
- When value is not set:
-
Automatic selection is effective. You can specify a unit name without the root jobnet under the planning group. The running units are selected automatically and execution takes place on the corresponding units. If the unit name specified without a jobnet name cannot be found, the unit is considered as a full path name, and the corresponding unit is executed. If there is not corresponding unit, it is an error.
For a unit under the job group, the root jobnet name should be specified even if the value of the -X is specified or that of the environment variable AJSAUTOJUDGE is set.
For the environment variable AJSAUTOJUDGE used for remote command execution, the value set when JP1/AJS3 is started is applied.
The following figure shows the unit configuration of a planning group when a command operates a unit under the planning group.
|
The following example of the ajsplan command shows, in the unit configuration shown in Figure 1-1, depending on the option specification and the setting of the environment variable, which unit is treated as an operand.
- When -X yes is specified:
-
Command sequence: ajsplan -h -X yes /Planning_group
Operand unit: planning group/Jobnet1-3
Command sequence: ajsplan -h -X yes /Planning_group/Job1
Operand unit: planning group/Jobnet1-3/Job1
- When -X no is specified:
-
Command sequence: ajsplan -h -X no /Planning_group/Jobnet1-3/Job1
Operand unit: planning group/jobnet1-3/Job1
- When -X auto is specified:
-
Command sequence: ajsplan -h -X auto /Planning_group
Operand unit: Planning_group/Jobnet1-3
Command sequence: ajsplan -h -X auto /Planning_group/Jobnet1-1
Operand unit: Planning_group/Jobnet1-1
Command sequence: ajsplan -h -X auto /Planning_group/Job1
Operand unit: Planning_group/Jobnet1-3/Job1
- When AJSAUTOJUDGE is YES:
-
Command sequence: ajsplan -h /Planning_group
Operand unit: Planning_group/Jobnet1-3
Command sequence: ajsplan -h /Planning_group/Job1
Operand unit: Planning_group/Jobnet1-3/Job1
- When AJSAUTOJUDGE is NO:
-
Command sequence: ajsplan -h /Planning_group/jobnet1-3/Job1
Operand unit: Planning_group/jobnet1-3/Job1
- When AJSAUTOJUDGE is AUTO:
-
Command sequence: ajsplan -h /Planning_group
Operand unit: Planning_group/jobnet1-3
Command sequence: ajsplan -h /Planning_group/Jobnet1-1
Operand unit: Planning_group/Jobnet1-1
Command sequence: ajsplan -h /Planning_group/Job1
Operand unit: Planning_group/jobnet1-3/Job1
- When no value is specified in AJSAUTOJUDGE:
-
Command sequence: ajsplan -h /Planning_group
Operand unit: Planning_group/jobnet1-3
Command sequence: ajsplan -h /Planning_group/Jobnet1-1
Operand unit: Planning_group/Jobnet1-1
Command sequence: ajsplan -h /Planning_group/Job1
Operand unit: Planning_group/Jobnet1-3/Job1
The root jobnet name under the planning group (Planning_group/Jobnet1-2) and the unit name under the root jobnet under the root jobnet (Planning_group/Jobnet1-2/Jobnet1-2) share the same unit name, the root jobnet name should be omitted when specifying the unit name. The running units are automatically selected and the corresponding units are operated.
If you want to operate the root jobnet under the planning group (Planning_group/Jobnet1-2), either specify no in the -X option or specify NO in the environment variable AJSAUTOJUDGE. with the unit name in a full path.