Control HEL record threshold monitoring
Component: | BS2000 |
Functional area: | Error logging |
Domain: | ERROR-LOGGING |
Privileges: | HARDWARE-MAINTENANCE |
Function
The MODIFY-HEL-CHECK command controls threshold monitoring for hardware errors (HEL records). Once an error threshold has been reached, the message “CALL TELESERVICE” is displayed on the operator terminal (console) the next time the error occurs. However, the message is displayed only if the Teleservice alarm function has been enabled (see the MODIFY-HEL-TELESERVICE-ALARM command).
The following mechanisms are available for threshold monitoring control:
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)
The threshold can be set separately for each control mechanism
The current threshold counter of a specific monitor setting can be reset
Each MODIFY-HEL-CHECK command with at least one nondefault value generates an additional threshold monitoring control record. No more than 50 control records are allowed. During threshold monitoring, all the control records are scanned in the order in which they were generated. Only the last control record found for the error which has occurred is evaluated. For that reason, control records which describe an error in detail should not be generated until after “general” control records (e.g. only for a monitoring class).
MODIFY-HEL-CHECK CHECK=*STD with no other arguments causes all modifications made earlier to be reversed, with the result that any control records that have been added are deleted and only the default set of records remains (as at system startup).
MODIFY-HEL-CHECK CHECK=*STD and other specifications (e.g. monitoring class, error type, device, etc.) only the control records that correspond to all the specifications made are deleted.
The command is rejected if HEL logging is disabled or the maximum allowable number of control records (message HEL0108) has been reached.
If logging is disabled and restarted with START-HEL-LOGGING during a system session, the number of HEL records being monitored remains unchanged.
The SHOW-HEL-CHECK command lists the active threshold monitoring control records.
Format
MODIFY-HEL-CHECK | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
CHECK = *STD / *ON / *OFF
Specifies the HEL records for which threshold monitoring is to be enabled or disabled. The HEL records to be monitored 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.
CHECK = *STD
The CHECK setting defined by the system is applied to all the HEL records matching the specified selection criteria.
If no selection criteria are defined, or if the selection operands are explicitly set to *ANY, threshold monitoring is restored to the condition it was in at system startup (reset function). In this case, a threshold specification in the MAXIMUM operand is ignored.
When selection attributes are specified, only the control records that correspond to all the specifications made are deleted.
CHECK = *ON
Thresholds are monitored for all HEL records matching the specified selection criteria.
CHECK = *OFF
Threshold monitoring 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.
MAXIMUM = *STD / <integer 1..255>
Sets the threshold which is to apply to the selected HEL records.
This operand is ignored if combined with CHECK=*STD with no further selection criteria (reset function).
MAXIMUM = *STD
Sets the threshold to 10.
MAXIMUM = <integer 1..255>
Threshold specification for the selected HEL records.
RESET-COUNT = *OFF / *ON
Governs whether the current threshold counter of a threshold monitoring mechanism is to be reset. The monitoring mechanism must be precisely defined in the CONTROL-IDENTIFIER, ATTRIBUTE, PRIORITY and/or DEVICE operands.
RESET-COUNT = *OFF
The current threshold counter is not reset.
RESET-COUNT = *ON
The current threshold counter is reset.
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-CHECK.