Hitachi TrueCopy for z/OS user guide (December 2005)

190 TrueCopy for the XP128/XP1024/XP10000/XP12000
The work variable is part of an execution statement in a script. The following table provides a description
and the storage type of each work variable statement for list and non-list types.
Reserved Variables
Reserved variables include result variables (that is, result of macro execution) and status variables (that is,
pair status of specified volume). The reserved variables are for reference use only.
Reserved Result Variables
When a functional macro is executed (for example, CreateHrcPair), a result value (_Result) is issued. The
following figure illustrates the result statement format, and the following table lists and defines the valid
result values. When a new macro is initiated, the result value automatically resets to 0x0000. The
functional macro executes on the specified number of devices. If the macro does not satisfy the execution
condition, a conditional error occurs. If a conditional error is found, the result value is OR’ed with 0x1000,
and the macro is logged in the error and macro trace files (see ”Script Operations Window” on page 72).
If the return value of the API (application program interface) is not 0, an API error occurs. If an API error
occurs, the result value is OR’ed with 0x0100, and the macro is logged in the error and macro trace files.
Figure 73 Result statement format
Table 56 Work variables
Variable Type Description and Storage Type
List Type _ilDEV Numeric Stores the device number list.
Expression: _ilDevA, _ilDevB, _ilDevC
_ilPriority Numeric Stores the priority number list.
Expression: _ilPriorityA, _ilPriorityB, _ilPriorityC
_ilWork Numeric Stores any 16-bit numeric values.
Expression: _ilWorkA, _ilWorkB, _ilWorkC _ilWorkD, _ilWorkE,
_ilWorkF
_slWork String Stores any strings.
Expression: _slWorkA, _slWorkB, _slWorkC, _slWorkD, _slWorkE,
_slWorkF
Non-List Type _iNum Numeric Stores any 16-bit numeric value.
Expression: _iNumA, _iNumB, _iNumC, _iNumD, _iNumE, _iNumF
_sMsg String Stores any string.
Expression: _sMsgA, _sMsgB, _sMsgC, _sMsgD, _sMsgE, _sMsgF
Table 57 Reserved result variables
Variable Type Description
_Result Numeric Stores the execution results of a macro.
0 = normal end. Other values depend on the macro.