APT_ERROR_CONFIGURATION
Set the APT_ERROR_CONFIGURATION environment variable to control the format of InfoSphere® DataStage® output messages.
This variable's value is a comma-separated list of keywords (see table below). Each keyword enables a corresponding portion of the message. To disable that portion of the message, precede it with a "!".
Default formats of messages displayed by InfoSphere DataStage include the keywords severity, moduleId, errorIndex, timestamp, opid, and message.
The following table lists keywords, the length (in characters) of the associated components in the message, and the keyword's meaning. The characters "##" precede all messages. The keyword lengthprefix appears in three locations in the table. This single keyword controls the display of all length prefixes.
| Keyword | Length | Meaning |
|---|---|---|
| severity | 1 | Severity indication: F, E, W, or I. |
| vseverity | 7 | Verbose description of error severity (Fatal, Error, Warning, Information). |
| jobid | 3 | The job identifier of the job. This allows you to identify multiple jobrunning at once. The default job identifier is 0. |
| moduleId | 4 | The module identifier. For InfoSphere DataStage-defined messages, this value is a four byte string beginning with T. For user-defined messages written to the error log, this string is USER. For all outputs from a subprocess, the string is USBP. |
| errorIndex | 6 | The index of the message specified at the time the message was written to the error log. |
| timestamp | 13 | The message time stamp. This component consists of the string "HH:MM:SS(SEQ)", at the time the message was written to the error log. Messages generated in the same second have ordered sequence numbers. |
| ipaddr | 15 | The IP address of the processing node generating the message. This 15-character string is in octet form, with individual octets zero filled, for example, 104.032.007.100. |
| lengthprefix | 2 | Length in bytes of the following field. |
| nodename | variable | The node name of the processing node generating the message. |
| lengthprefix | 2 | Length in bytes of the following field. |
| opid | variable | The string <main_program> for error messages originating
in your main program (outside of a step or within the APT_Operator::describeOperator() override). The string <node_nodename> representing system error messages originating on a node, where nodename is the name of the node. The operator originator identifier, represented by "ident, partition_number", for errors originating within a step. This component identifies the instance of the operator that generated the message. ident is the operator name (with the operator index in parenthesis if there is more than one instance of it). partition_number defines the partition number of the operator issuing the message. |
| lengthprefix | 5 | Length, in bytes, of the following field. Maximum length is 15 KB. |
| message | variable | Error text. |
| 1 | Newline character |