Control HEL record logging
Component: | BS2000 |
Functional area: | Error logging |
Domain: | ERROR-LOGGING |
Privileges: | HARDWARE-MAINTENANCE |
Function
The MODIFY-HEL-LOGGING command controls the scope of hardware error logging (HEL records). The command is rejected if HEL logging is disabled. The following control mechanisms are available:
Enabling/disabling the monitoring of all records of a monitoring class (control ID)
Enabling/disabling the monitoring of all records for a device, which can be identified by its device mnemonic or its device address
Enabling/disabling the monitoring of specific records or of a group of records with specific attributes (monitoring class, error type and error priority)
Enabling/disabling the monitoring of records which are excluded from logging
Each MODIFY-HEL-LOGGING command with at least one nondefault value generates an additional logging control record. No more than 50 control records are allowed.
The command is rejected if HEL logging is disabled or the maximum allowable number of control records (message HEL0108) has been reached.
MODIFY-HEL-LOGGING LOGGING=*STD with no other arguments causes all modifications made earlier to be reversed, with the result that the default setting applies again (as at system startup).
If logging is disabled and restarted with START-HEL-LOGGING during a system session, the number of HEL records being logged remains unchanged.
The SHOW-HEL-LOGGING command lists the current settings.
Format
MODIFY-HEL-LOGGING | |||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||
Operands
LOGGING = *STD / *ON / *OFF
Specifies the HEL records which are to be written to the log file. The HEL records to be logged can be identified more precisely with the selection operands CONTROL-IDENTIFIER, ATTRIBUTE, PRIORITY, and DEVICE, where a value of *ANY means that the operand is not to be used as a selection criterion. If more than one selection operand is used, the arguments are logically ANDed.
LOGGING = *STD
The LOGGING setting defined by the system is applied to all the HEL records matching the specified selection criteria (i.e. the submitter of the record determines the logging setting). If no selection criteria are defined, or if the selection operands are explicitly set to *ANY, the scope of logging is restored to the condition it was in at system startup (reset function).
LOGGING = *ON
All HEL records matching the specified selection criteria are written to the log file.
LOGGING = *OFF
Logging is disabled for all HEL records matching the specified selection criteria.
CONTROL-IDENTIFIER = *ANY / *MCK / *CCK / *CRW / *DISK / *TAPE / *SPOOL / *BCAM / *NINT / *STAT
The selection criterion is the monitoring class to which the error reported in the HEL record is allocated.
Operand value | Monitoring class |
|---|---|
*ANY | Not used as selection criterion |
*MCK | M (machine check) |
*CCK | C (channel check) |
*CRW | R (channel report words) |
*DISK | D (disk device error) |
*TAPE | T (tape device error) |
*SPOOL | S (spool device error) |
*BCAM | B (error detected by BCAM) |
*NINT | N (no interrupt) |
*STAT | Z (device statistics) |
ATTRIBUTE = *ANY / *HARDWARE-ERROR / *UNCORRECTABLE / *CORRECTABLE / *TAPE-ERROR / *OVERRUN
The selection criterion is the error type to which the error reported in the HEL record is allocated.
Operand value | Error type identification | |
|---|---|---|
*ANY | Not used as selection criterion | |
*HARDWARE-ERROR | Attribute H: | True hardware error |
*UNCORRECTABLE | Attribute U: | Uncorrectable error; only affects devices of the “older” generation |
*CORRECTABLE | Attribute C: | Software-correctable error; only affects devices of the “older” generation |
*TAPE-ERROR | Attribute T: | Logical tape error |
*OVERRUN | Attribute O: | Channel capacity exceeded (queued data cannot all be transferred); only affects devices which operate without an I/O buffer |
PRIORITY = *ANY / *HIGH / *MEDIUM / *LOW
The selection criterion is the error priority assigned to the error reported in the HEL record.
PRIORITY = *ANY
The error priority is not used as a selection criterion.
PRIORITY = *HIGH
Selects HEL records assigned priority H (high-priority errors).
PRIORITY = *MEDIUM
Selects HEL records assigned priority M (medium-priority errors).
PRIORITY = *LOW
Selects HEL records assigned priority L (low-priority errors).
DEVICE = *ANY / <alphanum-name 2..4> / *UNIT(...)
The selection criterion is the hardware unit in which the error reported in the HEL record occurred.
DEVICE = *ANY
The hardware unit affected by the error is not used as a selection criterion.
DEVICE = <alphanum-name 2..4>
Device mnemonic of a hardware unit.
Selects HEL records reporting errors affecting this hardware unit.
DEVICE = *UNIT(...)
Selects HEL records reporting errors affecting this hardware unit. The hardware unit is identified by its device address in the associated PATH operand.
PATH = <alphanum-name 1..6>
Device address in the form ccccuu.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command successfully executed | |
32 | HEL0100 | Internal error | |
32 | HEL0105 | Bourse problems | |
32 | HEL0108 | Too many control commands | |
64 | HEL0010 | Hardware error logging not active | |
64 | HEL0110 | Privilege error |
Example
See SHOW-HEL-LOGGING.