15.2.11 Setting the handling of a macro variable when the value is a NULL string
The value of a macro variable can be used as event information received by an event job. For details about macro variables, see 2.2.6 Considerations regarding the use of macro variables in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide. For examples of defining macro variables in event jobs, 2.4.4(6) Passing information received by an event job in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
You can define the event information received by an event job as a macro variable that can be used to pass the event information to a succeeding job or jobnet. The information passed to a succeeding job or jobnet is called passing information. For an example of defining macro variables, see 2.4.4(6) Passing information received by an event job in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
If the passing information is a NULL string and only the macro variable name is specified without any prefixed or suffixed characters, you can select either of the following methods handling the macro variable:
-
The macro variable name itself is used as a string value (default)
-
The macro variable name is replaced with a NULL string
These methods for handling a macro variable whose value is a NULL string are described below with the use of examples.
- When the macro variable name itself is used as a string value:
-
-
When no characters are prefixed or suffixed to the macro variable name:
[?AJS2xxxxx?] → [?AJS2xxxxx?]
-
When characters are prefixed or suffixed to the macro variable name:
[aaa?AJS2xxxxx?bbb] → [aaabbb]
[ccc?AJS2xxxxx?] → [ccc]
[?AJS2xxxxx?ddd] → [ddd]
-
- When the macro variable name is replaced with a NULL string:
-
-
When no characters are prefixed or suffixed to the macro variable name:
[?AJS2xxxxxxxxx?] → []
-
When characters are prefixed or suffixed to the macro variable name:
[aaa?AJS2xxxxx?bbb] → [aaabbb]
[ccc?AJS2xxxxx?] → [ccc]
[?AJS2xxxxx?ddd] → [ddd]
-
The setting described in this subsection applies to jobs for which Standard is specified for Exec. Service. If Queueless Agent is specified, the macro variable name is always replaced with a NULL string. Note that this setting applies only to the following definition items, for which a macro variable could be used in JP1/AJS2 07-11 and earlier versions:
- Unix job:
-
-
Command statement
-
Script file name
-
Parameter
-
Environment variable
-
- PC job or flexible job:
-
-
Executable file name
-
Parameter
-
Environment variable
-
Note that this setting is not necessary when characters are always prefixed or suffixed to macro variable names, and when operation expects that macro variable names will be used as string values.
The following describes how to set the handling of a macro variable when the value is a NULL string.
- Organization of this subsection
(1) Definition procedure
-
Stop the JP1/AJS3 service.
Execute the following commands to confirm that all processes have stopped:
# /etc/opt/jp1ajs2/jajs_stop#1 # /opt/jp1ajs2/bin/jajs_spmd_status
- #1:
-
Confirm that automatic termination has been set.
-
Execute the following command to set the environment setting parameter described in (2) below:
jajs_config -k "definition-key" "parameter-name"=value
-
Restart JP1/AJS3.
The new settings are applied.
(2) Environment setting parameter
|
Definition key |
Environment setting parameter |
Explanation |
|---|---|---|
|
[{JP1_DEFAULT|logical-host}\JP1NBQCLIENT\Process]# |
"MacroOptionReplaceMode"= |
Specifies the handling of a macro variable whose value is a NULL string. |
- #:
-
The specification of the {JP1_DEFAULT|logical-host} part depends on whether the host is a physical host or a logical host. For a physical host, specify JP1_DEFAULT. For a logical host, specify the logical host name.
For details about the definition of this environment setting parameter, see 20.5.2(79) MacroOptionReplaceMode.