HSMS outputs messages with a 7-character message code. The message ID is “HSM”. All HSMS messages have the format “HSM0ynn”, where “y” indicates the message class and nn is the sequence number within the message class.
HSMS distinguishes between the following message classes:
Message class | Type of message |
Class 0 | Result message |
Class 1 | Console message |
Class 2 | Error message and rejection of a statement |
Class 4 | Warning or error message (during processing of a statement) |
Class 9 | Error message with memory dump |
Messages in classes 0, 2 and 4 are statement-specific in terms of their meaning and effect.
The messages of classes 1 and 9 are of interest for the HSMS administrator (and the operator) only; not for nonprivileged users.
The location at which HSMS messages are displayed depends primarily on the system environment of the respective task (interactive or batch mode, user request, server task or main task).
HSMS outputs messages to the following destinations:
Type of task | Message class | Output destination |
Interactive user task | 0, 2, 4 | SYSOUT |
9 | Console | |
Batch user task | 0, 2, 4 | SYSLST |
9 | Console | |
Server task | 4 | Report |
1, 9 | Console, SYSOUT | |
Main task | 9 | Console |
Result messages (class 0)
Result messages are output in order to supply a user with information about the result of statement processing. Normally (i.e. with asynchronous processing), this is a temporary result.
The default weight of class 0 messages is “10”; a weight of “50” indicates that statement processing has not been terminated successfully.
Console messages (class 1)
Console message are output in order to provide the operator and the HSMS administrator with information on the HSMS status or an error situation in HSMS whose cause is known. The messages output during HSMS loading are typical examples of such messages.
Class 1 messages are normally output by the HSMS task or the HSMS server tasks; they are output to the console with routing code “U”. Messages from server tasks are additionally output to SYSOUT.
Error messages with rejection (class 2)
Class 2 error messages are output if HSMS rejects a statement for any of the following reasons:
invalid input
missing privilege
unavailable resources (no tape session)
The default weight of class 2 messages is “99”.
Messages during processing (class 4)
Class 4 messages are output during processing of an HSMS statement. They typically report an error which has occurred during processing or the reason why processing is aborted. Class 4 messages can be classified as follows:
Warnings indicate that an object specified by the user (file, volume, etc.) cannot be processed (object not available, user not privileged).
Processing is normally continued after output of the warning.
The default weight is “30” (normal error).Error messages after which processing is continued indicate that an object specified by the user cannot be processed or can only be partially processed due to an error.
The default weight is “50” (important error).Error messages after which processing is aborted indicate that an error has occurred in one of the basic HSMS functions which rendered processing impossible.
The default weight is “99”.
Error messages with dump (class 9)
Class 9 error messages indicate that an error occurred in HSMS whose cause is not known; error documentation is produced for diagnostic purposes.
Class 9 messages are output to the console with routing code “U”. Messages from interactive tasks are additionally output to SYSOUT, those from batch tasks to SYSLST.
The default weight of class 9 messages is “99”.