Hitachi TrueCopy for IBM z/OS User and Reference Guide (T5211-96001, June 2007)

B-34 TrueCopy for z/OS Scripting
Hitachi Universal Storage Platform V TrueCopy for IBM z/OS User’s Guide
Error Reporting
The TCz scripting error codes are slightly different than the general TCz error
codes. Figure B.10 shows the format of the scripting error codes. Table B.17
describes the TCz scripting error messages. Table B.18 lists the TCz scripting
error codes. In Table B.18 the message ID is the four-digit number displayed
on the error message. The internal code is the four-digit number displayed in
the fifth column of the error trace file.
X X X X
(4 bytes)
2nd byte: error type
0: Warning
1: Fatal
1st byte: occurrence location
1: Screen processing
2: Syntax analysis
3: Macro expansion
4: Syntax execution
5: API generation
6: Tracing
9: Other processing
Figure B-10 Scripting Error Code Format
Table B-17 Error Messages
Error Message Conditions to Verify Corrective Action
Syntax error
The syntax validity of the script is checked at
the start of execution. An error message will
be displayed if failed.
Use the scripting error code to determine
which line contains the syntax error (see
Table B.18), and fix the syntax error.
Parameter error
The parameter validity of the script is
checked on executing each instruction. An
error message will be displayed if failed.
Use the scripting error code to determine
which line contains the parameter error (see
Table B.18), and fix the parameter error.
Rejection
The result of the execution is checked on
each target device. If failed, the last error
status is displayed and error flag is set in the
reserved variable _Result. Also script
continues to be executed.
If you want to terminate the script or display
a message of error occurrence and indication
following steps, check that _Result is not 0 in
script.
Skip if not executable
The condition of each target device is
checked to be executable status. For
example, the M-VOL status must be simplex
to create a pair. If failed, error flag is set in
the reserved variable _Result. Also script
continues to be executed.
If you want to terminate the script or display
a message of error occurrence and indication
following steps, check that _Result is not 0 in
script.