# Generic Error Listener Utility

The Substation ES Generic Error Listener Utility receives and prints Application Notification messages published by Substation ES. The sources `SXJ3IELS` and `SXR3IELS` are in the `USERHLQ.C` data set.

## Functions

The Substation ES Generic Error Listener Utility performs the following tasks:

- Receives and prints Substation ES data transformation notification messages.
- Receives and prints Substation ES operational and execution notification messages.

The utility listens to subjects or destination names you provide on the `SYSIN` DD Name. The name must correspond to the subject name on the recipe or trigger definition panel in the Error Subject field.

When an error or user notification is delivered during execution, a message is written to the subject defined in the Error Subject field. Even though these messages are processed by your application, the Substation ES Generic Error Listener Utility can serve as an alternate method for listening to the subjects and for printing the associated notifications forwarded by Substation ES.

## JCL Sample

The sample JCL is as follows:

- Data Set: `USERHLQ.JCL`
- Member:
  - `SXRRIELS` (Rendezvous)
  - `SXJRIELS` (EMS)

Before using this utility, you must specify the Rendezvous or TIBCO Enterprise Message Service transport parameters.

Also, review and select the appropriate Generic Error Listener Utility Control Parameters. See Generic Error Listener Utility Control Parameters.

## SYSIN Parameters

The messages to which the Substation ES Generic Error Listener Utility listens are determined by the keywords and operands in the `SYSIN` DD name file. See the following table.

Generic Error Listener Utility Control Parameters
Keyword | Operand | Description
--- | --- | ---
`SUBJECT` | {tibss.error.>} | Rendezvous only. These are the error subject names.
`QUEUE/TOPIC` | {tibss.error.out} | EMS only. This is the destination to which an error message is published if an ESB conversion or back-end system encounters errors.
`PSWD` |  | EMS only. This is the password associated with the user ID if a special identification is to be used in the session.
`UFLD-PFX` | {tibss-} | This is the prefix of the Substation ES system field name for the processing status. It is recommended that you do not change this value for IVP runs.
`USER` |  | EMS only. This is the user ID specified by you if a special identification is to be used in the session.

The examples are listed as follows:

- Rendezvous

      subject   my-error-subject
      subject   my-errors.>
      subject   substation.test.errors.*.subject

- TIBCO Enterprise Message Service

      queue     my-error-output
      topic     substation.test.errors (Applies to topic only.)

Copyright © TIBCO Software Inc. All rights reserved.