1.1 Message output formats
(1) Messages output to standard error output or standard output
The following subsections describe the format of messages output by the HiRDB system.
(a) Output format of HiRDB messages
AAAAA hh:mm:ss BBBB CCCCCCCC KFPA00000-E XX....XX
or
KFPA00000-E xx....xx
- AAAAA: Process ID (for AIX and HP-UX (IPF) editions, this is a 10-digit decimal number; for all other editions, this is a 5-digit decimal number)
- hh:mm:ss: time (in hours:minutes:seconds format) (8-digit decimal number)
- BBBB: Unit identifier (4 alphanumeric characters)
- CCCCCCCC: Name of the server that requested that the message be output (8 alphanumeric characters)
- KFPA00000-E: Message ID (11 alphanumeric characters)
- xx....xx: Message text (maximum of 243 characters)
Note that the unit identifier and the name of the server that requested that the message be output may not appear.
(b) Output format of pre-processor messages
pdcpp: filename, line-number: error-number: text
- pdcpp:
- Identifier of a message output by the C language preprocessor; for COBOL, the identifier is pdcbl.
- filename:
- Name of the UAP source file resulting in the error
- line-number:
- Line number in the UAP source file resulting in the error
- error-number:
- Message ID
- text:
- Message text
(2) Messages output to the standard output by the pdcat command
This type of message includes supplemental information, in addition to a message ID and message text. Whether or not the supplemental information is to be omitted is specified with the pdcat command's option flag. When this option flag is not specified, the additional information, message ID, and message text are all output.
Following is the format of a message with supplemental information that is output to the standard output:
AAAAAAA BB....BB CCCCCCC DDDD yyyy/mm/dd hh:mm:ss
EEEEEEEE FFFF GGGGGGGG HHH KFPA00000-E xx...xx
- Additional information:
- AAAAAAA:
- Message serial number (7 decimal digits)
- BB....BB:
- Process ID (for AIX and HP-UX (IPF) editions, this is a 10-digit decimal number; for all other editions, this is a 5-digit decimal number)
- CCCCCCC:
- Serial number of the message within the process (server) (7 decimal digits)
- DDDD:
- HiRDB identifier (4 alphanumeric characters)
- yyyy/mm/dd:
- Date (10 decimal digits in the format year/month/date)
- hh:mm:ss:
- Time (8 decimal digits in the format hour:minute:second)
- EEEEEEEE:
- Request source host name (first 8 characters)
- FFFF:
- Unit identifier (4 alphanumeric characters)
- GGGGGGGG:
- Name of the server requesting the message output (8 alphanumeric characters)
- HHH:
- Internal information used by the system (3 alphanumeric characters)
- Fixed part of message:
- KFPA00000-E:
- Message ID (11 decimal digits)
- xx...xx:
- Message text (up to 223 characters)
Some messages do not contain the request source unit identifier or request source server name.
(3) Messages output to an event log (in UNIX, syslogfile)
Messages that are output to an event log (in UNIX, syslogfile) include optional information in addition to a message ID and message text. Following is the format of messages issued by the HiRDB system:
mmm dd hh:mm:ss AA...AA HiRDB[nn....nn]: KFPA00000-E BBBB CCCC xx...xx (DD....DD)
- Supplemental information:
- mmm:
- Month (3 alphabetic characters)
- dd:
- Date (2 decimal digits)
- hh:mm:ss:
- Time (8 decimal digits in the format hour:minute:second)
- AA...AA:
- Standard host name of the message output request source (up to 63 alphanumeric characters)
- nn....nn:
- Process ID (for AIX and HP-UX (IPF) editions, this is a 10-digit decimal number; for all other editions, this is a 5-digit decimal number)
- KFPA00000-E:
- Message ID (11 alphanumeric characters)
- BBBB:
- HiRDB identifier (4 alphanumeric characters)
- CCCC:
- HiRDB unit identifier (4 alphanumeric characters)
- xx...xx:
- Message text*
- DD....DD:
- Process ID of the message output request source*
- * The message text and the process ID of the source that requested that the message be output must total no more than 233 characters (including spaces between characters). Text exceeding 233 characters is discarded.
Some messages do not contain a HiRDB identifier, HiRDB unit identifier, or process ID of the message output request source; in such cases, this supplemental information either is displayed as spaces or is omitted altogether (i.e., only the message text is displayed).