Use this system macro inline to write a specified error log record using
the SNAPC conventions. Common Link Access to Workstation (CLAW) control
program (CP) segments use this macro.
Format
- PRC=Rx
- This required register contains the primary return code indicating the
primary reason for the log error subrequest.
- SRC=Ry
- This required register contains the secondary return code indicating the
secondary reason for the log error subrequest.
- FAIL
- This optional parameter determines if the adapter is to be closed.
- YES
- The error log is written and the adapter is closed.
- NO
- The error log is written and the adapter is not closed.
Entry Requirements
This macro is for use in the control program (CP) only.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- The contents of all registers, except R14 and R15, are preserved across
this macro call.
Programming Considerations
- This macro can be run on any I-stream.
- The FAIL option sets the fail option bit. The fail bit must be set
for CLAW to fail.
Examples
This call indicates a primary return code is in register R6 and a secondary
return code is in R0. The FAIL option indicates the trace record will
be written and the adapter will be closed.
TCLAC PRC=R6,SRC=R0,FAIL=YES