Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

1.4.1 Environment variables used to execute JP1/AJS3 commands

The following table lists the environment variables used for command execution.

Table 1-6 Environment variables used for command execution

Environment variable Description Referenced

AJSMANAGERHOST Logical host name of target host When a logical host name is omitted in the specification of a unit name for remote execution of a command^#1 that operates units or the ajsstatus command

JP1_HOSTNAME Logical host name of local host When JP1/AJS3 references the logical host name of the local host or when it references the logical host of the target of operation for command execution (assuming that no logical host name has been specified as a command option)^#2

AJSCONF Scheduler service name When a scheduler service name is omitted in the object name specification and it is also omitted in the -F option

AJSPATH AJS path name When a unit name is not specified as a full name (used as a job group name) in any command^#1 used to manipulate units

JP1_USERNAME JP1 user name When a JP1 user name different from the OS user name is used to acquire user access permissions by using a command used to manipulate a unit^#1 or a command used to operate execution agents

LANG Language type When the language type of the text to be output is identified.
In Windows, this environment variable is not available because the language type depends on the host settings.
If commands used to manipulate a unit^#1 are executed, make sure that the value of this environment variable is the same as the value of the AJSCHARCODE environment variable of the scheduler service in which the unit to be manipulated by the commands is defined.

TZ Time zone When calculating a schedule or displaying a date and time^#3

AJSAUTOJUDGE Specifies the function for automatically selecting a target unit from the list of units in a planning group When the -X option is omitted in any of the following commands:^#4

ajschgstat command

ajsintrpt command

ajskill command

ajsplan command

ajsrerun command

ajsshow command

AJSDISPSUBUNITTYPE Displays or hides the job group type When the ajsrestore command is used to output a list of the units backed up in the backup box to the standard output file^#5

#1

See Table 1-11 for the commands used to manipulate units.

#2

The user mapping to be used varies with whether or not the JP1_HOSTNAME environment variable is set.

If the JP1_HOSTNAME environment variable is set, the user mapping defined in the logical host specified with the JP1_HOSTNAME environment variable is used.

Otherwise, the user mapping defined in the physical host is used.

You must set the JP1_HOSTNAME environment variable if you reference a logical host.

Do not set JP1_HOSTNAME when referencing a physical host. Setting JP1_HOSTNAME may cause the command to fail.

#3

In Windows, make sure that the time zone used for command execution is the same as the system time zone.

#4

According to the value specified in the AJSAUTOJUDGE environment variable, select a target unit from the units listed in a planning group.

You can specify the following values for the AJSAUTOJUDGE environment variable:

YES

Specify this to automatically select a target unit.

When specifying a unit name in the command, omit a root jobnet name in a planning group.

NO

Specify this if you do not want to automatically select a target unit.

You must specify a unit for which the command will operate. You cannot omit a root jobnet name in a planning group.

AUTO or no specification

Whether a target unit will automatically be selected depends on how the unit name is specified.

If you want to automatically select a target unit
Specify a unit name without a root jobnet name in a planning group.

If you do not want to automatically select a target unit
Specify a unit name with a root jobnet name in a planning group. The command will operate for the specified unit only. However, if there is a unit having the same name as the path name specified without a root jobnet name in a planning group, a root jobnet name is assumed to be omitted so that a target unit will be selected automatically.

#5

According to the AJSDISPSUBUNITTYPE environment variable, determine the format of output to the standard output file.

You can specify the following values for the AJSDISPSUBUNITTYPE environment variable:

YES

Output the job group type.

(Output format)

save-file-name:save-source-unit-name:saved-unit-name:saved-unit-type(job-group-type)

Example:

0001:/group1:group2:g(p)

NO or no specification

Do not output the job group type.

(Output format)

save-file-name:save-source-unit-name:saved-unit-name:saved-unit-type

Example:

0001:/group1:p_group1:g

For an explanation of the unit type and job group type, see Table 2-11 in the description of the ajsprint in 2. Commands.

Environment variable	Description	Referenced
AJSMANAGERHOST	Logical host name of target host	When a logical host name is omitted in the specification of a unit name for remote execution of a command^#1 that operates units or the ajsstatus command
JP1_HOSTNAME	Logical host name of local host	When JP1/AJS3 references the logical host name of the local host or when it references the logical host of the target of operation for command execution (assuming that no logical host name has been specified as a command option)^#2
AJSCONF	Scheduler service name	When a scheduler service name is omitted in the object name specification and it is also omitted in the -F option
AJSPATH	AJS path name	When a unit name is not specified as a full name (used as a job group name) in any command^#1 used to manipulate units
JP1_USERNAME	JP1 user name	When a JP1 user name different from the OS user name is used to acquire user access permissions by using a command used to manipulate a unit^#1 or a command used to operate execution agents
LANG	Language type	When the language type of the text to be output is identified. In Windows, this environment variable is not available because the language type depends on the host settings. If commands used to manipulate a unit^#1 are executed, make sure that the value of this environment variable is the same as the value of the AJSCHARCODE environment variable of the scheduler service in which the unit to be manipulated by the commands is defined.
TZ	Time zone	When calculating a schedule or displaying a date and time^#3
AJSAUTOJUDGE	Specifies the function for automatically selecting a target unit from the list of units in a planning group	When the -X option is omitted in any of the following commands:^#4 ajschgstat command ajsintrpt command ajskill command ajsplan command ajsrerun command ajsshow command
AJSDISPSUBUNITTYPE	Displays or hides the job group type	When the ajsrestore command is used to output a list of the units backed up in the backup box to the standard output file^#5

[Contents][Back][Next]

[Trademarks]