Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-HEL-CHECK

&pagelevel(3)&pagelevel

Show HEL threshold monitoring information

Component:

BS2000

Functional area:

Error logging

Domain:

ERROR-LOGGING

Privileges:

HARDWARE-MAINTENANCE

Function

The SHOW-HEL-CHECK command writes information about HEL record threshold monitoring to SYSOUT. It shows all the control records used to set hardware error monitoring thresholds. The MODIFY-HEL-CHECK command allows extra control records to be added to those which are present when the system is started up. Up to 50 records can be displayed. For each control record SHOW-HEL-CHECK indicates the monitoring function, the selection criteria for the HEL records which are to be monitored, and the threshold value itself.

The command is rejected if HEL logging is disabled.

The command supports structured output in S variables (see "Output in S variables").

Format

SHOW-HEL-CHECK                                                                                                                                    

       

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command successfully executed


32

CMD2009

Internal error on output to S variables


64

HEL0010

Hardware error logging is not active


64

HEL0110

Privilege error


130

OPS0001

Insufficient memory for structured output in S variables

Output format

The information is displayed in the form of a table. There is one line of information for each control record (up to 50 control records). The first line of the output is a header line containing the headings for the 7 columns of information. The control records appear in the order in which they were created.

Output column

Value

Meaning / Operand in MODIFY-HEL-CHECK command

MONITOR


Status of monitoring function

SYS_STD

System setting: CHECK = *STD

ON

Monitoring active: CHECK = *ON

OFF

Monitoring inactive: CHECK = *OFF

CTID


Selected monitoring class (CONTROL-ID =)

ANY

Not used as selection criterion (= *ANY)

M

Machine check (= *MCK)

C

Channel check (= *CCK)

R

Channel report words (= *CRW)

D

Disk device error (= *DISK)

T

Tape device error (= *TAPE)

S

Spool device error (=*SPOOL)

B

Error detected by BCAM (= *BCAM)

N

No interrupt (= *NINT)

Z

Device statistics (= *STAT)

PRIO


Selected error priority (PRIORITY =)

ANY

Not used as selection criterion (= *ANY)

L

Low priority (= *LOW)

M

Medium priority (= *MEDIUM)

H

High priority (=*HIGH)

ATTR


Selected error type (ATTRIBUTE =)

ANY

Not used as selection criterion (= *ANY)

H

Hardware error (= *HARDWARE-ERROR)

U

Uncorrectable error (= *UNCORRECTABLE)

C

Correctable error (= *CORRECTABLE) 

T

Tape error (*TAPE-ERROR)

O

Channel capacity exceeded (*OVERRUN)

DEVICE


Selected device (DEVICE =)


ANY

Not used as selection criterion (= *ANY)

MN = mn

Device mnemonic (= <alphanum-name 2..4>)

PATH = ccccuu

Device path name (= *UNIT(PATH = ccccuu))

THRESHOLD

<integer 1..255>

Threshold (MAXIMUM =)

ACT-COUNT

<integer 1..255>

Current value of threshold counter

Table 116: Output columns of the SHOW-HEL-CHECK command

Output in S variables

Output information

Name of the S variable

T

Contents              

Condition

Current threshold counter of threshold monitoring

var(*LIST).ACTUAL

I

<integer 1..255>


“Monitoring class” of the error reported in the HEL record

var(*LIST).CONTR-ID

S

*ANY
*BCAM
*CCK
*CRW
*DISK
*MCK
*NINT
*SPOOL
*STATIS
*TAPE


Name of the device for which the logging behavior is being defined

var(*LIST).DEV

S

*ANY
<c-string 2..6>


Type of device specification
*BY-MN = specified by unit mnemonic
*BY-PATH = specified by path name in cccuu form

var(*LIST).DEV-SPEC

S

*BY-MN
*BY-PATH


Type of error reported in the HEL record

var(*LIST).ERROR-ATTR

S

*ANY
*CORRECTABLE
*HARDWARE-ERROR
*OVERRUN
*TAPE-ERROR
*UNCORRECTABLE


Monitored threshold

var(*LIST).MAX

I

<integer 1..255>


Monitoring status

var(*LIST).MONITOR-STA

S

*OFF
*ON
*STD


Device path name

var(*LIST).PATH

S

<c-string 1..4>


Priority of the error reported in the HEL record

var(*LIST).PRIO

S

*ANY
*HIGH
*LOW
*MED


Example

/show-hel-check   ———————————————————————————————————————————————— (1)

% MONITOR CTID PRIO ATTR DEVICE      THRESHOLD ACT-COUNT
% SYS_STD D    H    ANY  ANY           16         0
% SYS_STD D    M    ANY  ANY           21         0
% SYS_STD T    M    ANY  ANY           21         0
% SYS_STD C    H    ANY  ANY           16         0
% SYS_STD C    M    ANY  ANY           16         0
% SYS_STD M    H    ANY  ANY            1         0
% SYS_STD M    M    ANY  ANY            3         0
% SYS_STD R    H    ANY  ANY            1         0
% SYS_STD R    M    ANY  ANY           16         0
% SYS_STD ANY  ANY  O    ANY         1000         0
% SYS_STD T    H    ANY  ANY            1         0

/mod-hel-check check=*std,control-id=*disk,prio=*low,max=100  ———— (2) 
/mod-hel-check check=*off,control-id=*tape,device=a1  ———————————— (3)
/show-hel-check   ———————————————————————————————————————————————— (4)

% MONITOR CTID PRIO ATTR DEVICE      THRESHOLD ACT-COUNT
% SYS_STD D    H    ANY  ANY           16         0
% SYS_STD D    M    ANY  ANY           21         0
% SYS_STD T    M    ANY  ANY           21         0
% SYS_STD C    H    ANY  ANY           16         0
% SYS_STD C    M    ANY  ANY           16         0
% SYS_STD M    H    ANY  ANY            1         0
% SYS_STD M    M    ANY  ANY            3         0
% SYS_STD R    H    ANY  ANY            1         0
% SYS_STD R    M    ANY  ANY           16         0
% SYS_STD ANY  ANY  O    ANY         1000         0
% SYS_STD T    H    ANY  ANY            1         0
% SYS_STD D    L    ANY  ANY          100         0
% OFF     T    ANY  ANY  MN = A1        0         0

/mod-hel-check check=*std   —————————————————————————————————————— (5)
/show-hel-check   ———————————————————————————————————————————————— (6)

% MONITOR CTID PRIO ATTR DEVICE      THRESHOLD ACT-COUNT
% SYS_STD D    H    ANY  ANY           16         0
% SYS_STD D    M    ANY  ANY           21         0
% SYS_STD T    M    ANY  ANY           21         0
% SYS_STD C    H    ANY  ANY           16         0
% SYS_STD C    M    ANY  ANY           16         0
% SYS_STD M    H    ANY  ANY            1         0
% SYS_STD M    M    ANY  ANY            3         0
% SYS_STD R    H    ANY  ANY            1         0
% SYS_STD R    M    ANY  ANY           16         0
% SYS_STD ANY  ANY  O    ANY         1000         0
% SYS_STD T    H    ANY  ANY            1         0

(1)

The SHOW-HEL-CHECK command lists the system’s default threshold monitoring control records.

(2)

The MODIFY-HEL-CHECK command adds a new control record: it sets a threshold of 100 for low-priority hardware errors in monitoring class D, and selects the system’s default CHECK setting.

(3)

The MODIFY-HEL-CHECK command adds a new control record: it sets the system default threshold (10) for hardware errors in monitoring class T affecting the device with the mnemonic name A1, and explicitly disables monitoring.

(4)

The command lists all the currently defined threshold monitoring control records. The control records added at Points 2 and 3 above come at the end of the list.

(5)

/MODIFY-HEL-CHECK CHECK=*STD with no command-line arguments (all operands assuming their default values) resets the threshold monitoring mechanism, which means that all the additional control records defined in the session are deleted.

(6)

The SHOW-HEL-CHECK command again lists the system’s default threshold monitoring control records (compare with Point 1).

Powered by Atlassian Confluence and Scroll Viewport.