SNA sense field values for RPL-based macroinstructions

When the application program or a logical unit receives an exception request, a negative response, or a logical unit status (LUSTAT) request, the associated sense data includes information regarding the reason for the exception condition. There are three types of information that describe the exception condition:
  • System-sense information
  • System-sense modifier information
  • User-sense information

System sense information indicates one of the five major classes of system-defined errors.

System-sense modifier information indicates one of many specific causes of the error indicated by the system-sense information. Like RTNCD and FDB2, the system-sense and its modifier information together form a specific type of error condition within a general class of error conditions.

User-sense information is generally used when the error condition is detected by the user-written program itself. In general, no particular codes or values are defined by IBM® to indicate types of errors. The logical unit must generate its own user-sense information that is understood by other logical units.

The SNA defined values for the sense fields can be found in the SNA Formats. Additional information is contained in the SNA Format and Protocol Reference Manual: Architectural Logic, and the SNA Sessions between Logical Units.

These three types of sense information—system, system modifier, and user—are set in RPL fields. Three fields (one for each type of sense information) are set by the application program when it sends a negative response or LUSTAT request to the logical unit. Three other fields are set by VTAM® when the application program receives an exception request, a negative response, or LUSTAT request from the logical unit. These are the names of the six fields, as they would be used on a manipulative or RPL macro:

Sense information

Received by the
application program

Sent from the
application program

System-sense information SSENSEI SSENSEO
System-sense modifier information SSENSMI SSENSMO
User-sense information USENSEI USENSEO