4.3.1 Variables used for the definition of service linkage job information
For a service linkage job, you can define and use information that changes with each job execution as variables.
- Organization of this subsection
(1) Types of variables
When defining service linkage job information, you can define and use the following items as variables. For details on specific locations where variables are defined and on definition items for which variables can be used, see 6. Operation.
-
Variables that store the values specified in custom job definitions
-
Variables that store environment variables of the service linkage job execution environment
In JP1/AJS3, you can also store the environment variables that are set at job execution in environment variables of the service linkage job execution environment. For details about environment variables that are set at job execution, see the descriptions of environment variables that are set when jobs are executed from JP1/AJS3 in the JP1/Automatic Job Management System 3 Command Reference.
-
Variables reserved by the system and available by default
Variables that are automatically set when a service linkage job is executed are variables reserved by the system and available by default.
Variable name
Description
?CSASUUID?
UUID acquired when the service linkage job started
?CSASSTARTDAY?
System date when the service linkage job started
?CSASSTARTTIME?
System time when the service linkage job started
-
Variables that store the results of the standard output of the executed command lines
-
Variables that store the values of authentication information
(2) Format of variable names
The format of variable names used for service linkage jobs is ?CSAany-character-string?.
For details about the format that can be specified for service linkage job information, see 6. Operation.
(3) How to use variables
When you reference variables in the definition items of the service linkage job information, how to use variables depends on the type of the variable.
-
Variables that store the values specified in custom job definitions
-
Variables that store environment variables of the service linkage job execution environment
-
Variables that are reserved by the system and available by default
-
Variables that store the values of authentication information
Specify the variable name as is in the format of ?CSAany-character-string?.
-
Variables that store the results of the standard output of the executed command lines
Specify in the format of ?CSAany-character-string[any-number]?. For any-number, specify the value of "number-of-lines-1" in the result of standard output. For example, to reference the first line of the results of standard output, specify ?CSAany-character-string[0]?. To reference the 15th line, specify ?CSAany-character-string[14]?. Do not add a leading zero to the number.
(4) Resolution of variables
The value of a variable is resolved when the service linkage job is executed. Note that if the variable is undefined or if the value of any-number is invalid when referencing the result of standard output, the variable portion is resolved as an empty character string.