LU 6.2 API Application Programmer's Reference Guide (30294-90008)

66 Chapter5
Intrinsic Descriptions
Status Parameter
Status Parameter
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.
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.