When a TP calls an intrinsic, information about the execution
of the intrinsic is returned to the TP in the Status parameter. The Status parameter is 32 bits long and is divided into two 16-bit
fields: the status info field and subsystem field,
as shown in Figure 5-1 “Status Parameter Fields”.
Figure 5-1 Status Parameter Fields
The status info field is a 16-bit integer that indicates whether
an error has occurred or a message has been generated. The status
info field can be positive, negative, or zero.
A value of zero indicates that the
intrinsic executed successfully, and no messages were generated.
A positive value indicates that the intrinsic executed
successfully, and further information is available. The positive
number in the status info field is the number of a status info message.
A negative value indicates that the intrinsic did
not complete successfully. The negative number in the status info
field is the number of a status info message describing the error
that has occurred.
All status info messages are listed in Appendix A “Status Info” in
this manual, along with their causes and any actions you should
take to resolve problems.
The subsystem field is a 16-bit integer that represents the
subsystem from which the status info message was returned.
A value of zero indicates that
the intrinsic executed successfully and no other information is
necessary. A zero is returned in the subsystem field when the status
info field is zero.
A value of 732 indicates that the message in the
status info field was returned by the APPC subsystem.
Programs should be able to reference the Status parameter as a full 32-bit integer and as two 16-bit
fields.
After executing an intrinsic, always compare the 32-bit value
in the Status parameter to zero (successful completion).If Status is not zero, compare the 16-bit value in the status
info field with the numbers of any messages that can be generated
by the intrinsic. At the end of every intrinsic description in this
chapter is a list of the important status info messages that can
be generated by that intrinsic.
Work with the application programmers at the remote site to
determine the procedures you will follow if you encounter errors.
See Appendix B “Sample Programs” for programming examples using LU
6.2 intrinsics with the Status parameter.
