Hitachi TrueCopy for IBM z/OS User and Reference Guide (T5211-96001, June 2007)
TrueCopy for z/OS Scripting B-29
Hitachi Universal Storage Platform V TrueCopy for IBM z/OS User’s Guide
Reserved Variables
Reserved variables include result variables (i.e., result of macro execution)
and status variables (i.e., pair status of specified volume). The reserved
variables are for reference use only.
Reserved Result Variables
When a functional macro is executed (e.g., CreateHrcPair), a result value
(_Result) is issued. Figure B.9 illustrates the result statement format, and
Table B.14 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. 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.
_
Result:0xNNNN
Reserved
Reserved
Result of API (0: Normal, 1: Error)
Result of functional macro (0:Normal, 1: Error)
Figure B-9 Result Statement Format
Table B-14 Reserved Result Variables
Variable Type Description
_Result Numeric
Stores the execution results of a macro.
0 = normal end. Other values depend on the macro.
_MsgResult Numeric
Stores the execution results of a Message (internal) macro.
1 = OK, 6 = Yes, 7 = No.
_SelectResult Numeric
Stores the number of devices found by SelectHrcDevice macro.
0 = no devices found.