LE Codes

A standard Language Environment condition token is a 12 byte field.

Bits 0-31	Bits 32-33	Bits 34-36	Bits 37-39	Bits 40-63	Bits 64-95
Condition ID	Case Number	Severity	Control Code	Facility ID	I. S. I.

For the type of condition which is most commonly used, Case 1, the Facility ID plus the value of the second half-word of the Condition ID uniquely identifies the related message.

For example, if the condition token began with the hexadecimal value "000300A359C9C7E9", then the error message is IGZ0163S. x'C9C7E9' is IGZ and x'00A3' is 163 decimal.

IBM-assigned Facility IDs are:

CEE = Language Environment
IBM = PL/I
EDC = C/C++
IGZ = COBOL
FOR = FORTRAN

The severity code is coded as

0 = Informational
1 = Warning
2 = Error
3 = Severe
4 = Critical

Note that if the first 4 bytes of the condition token are binary zeroes, the remaining bytes will also be zero, indicating successful completion.

The Case Number value will be binary value 1 or 2, indicating the format of the Condition ID field. LE callable services and most applications return Case 1 Condition IDs - the first two bytes represent the condition severity, followed by the message number. Case 2 conditions may be returned by some operating systems and some compiler libraries; they are not produced directly by LE.

The control code is used to identify whether the Facility ID was assigned by IBM.

The final 4 bytes are Instance Specific Information (ISI) which can provide information specific to a specific occurence of a message.

For More Information

Visit the Language Environment page here.