Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Show HEL record logging settings

Component:	BS2000
Functional area:	Error logging
Domain:	ERROR-LOGGING
Privileges:	HARDWARE-MAINTENANCE

Function

The SHOW-HEL-LOGGING command writes information about HEL record logging to SYSOUT. It shows all the control records used to set the conditions for HEL record logging. The MODIFY-HEL-LOGGING 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-LOGGING indicates the status of the logging function and the selection criteria for the HEL records which are to be logged.

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-LOGGING

Return codes

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 5 columns of information. The control records appear in the order in which they were created.

Output column	Value	Meaning/Operand in MODIFY-HEL-LOGGING command
LOGGING		Status of monitoring function
	SYS_STD	System setting: CHECK = *STD
	ON	Logging active: CHECK = *ON
	OFF	Logging 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))

Table 117: Output columns of the SHOW-HEL-LOGGING command

Output in S variables

Output information	Name of the S variable	T	Contents
“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 the form cccuu	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
Monitoring status	var(*LIST).LOG-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-log ————————————————————————————————————————————————————————— (1)

% LOGGING  CTID PRIO ATTR DEVICE
% SYS_STD  ANY  ANY  ANY  ANY

/mod-hel-log logging=*off,control-id=*tape ——————————————————————————— (2) /mod-hel-log logging=*on,control-id=*disk,attribute=*uncorrectable ———— (3) /mod-hel-log logging=*on,device=*unit(001860) ————————————————————————— (4) /show-hel-log ———————————————————————————————————————————————————————— (5)

% LOGGING  CTID PRIO ATTR DEVICE
% SYS_STD  ANY  ANY  ANY  ANY
% OFF      T    ANY  ANY  ANY
% ON       D    ANY  U    ANY
% ON       ANY  ANY  ANY  UNIT = 001860

/mod-hel-log ————————————————————————————————————————————————————————— (6) /show-hel-log ———————————————————————————————————————————————————————— (7)

% LOGGING  CTID PRIO ATTR DEVICE
% SYS_STD  ANY  ANY  ANY  ANY

(1)	The SHOW-HEL-LOGGING lists the system’s default control records for HEL record logging.
(2)	The MODIFY-HEL-LOGGING adds a new control record: HEL records for hardware errors in monitoring class T are not to be logged.
(3)	The MODIFY-HEL-LOGGING command adds another new control record: HEL records for hardware errors in monitoring class D and with error attribute U are to be logged.
(4)	The MODIFY-HEL-LOGGING command adds yet another control record: HEL records for hardware errors affecting the hardware unit with the device address 001860 are to be logged.
(5)	The command lists all the currently defined logging control records. The control records added at Points 2, 3 and 4 above come at the end of the list.
(6)	MODIFY-HEL-LOGGING with no command-line arguments (all operands assuming their default values) resets the logging mechanism, which means that all the additional control records defined in the session are deleted.
(7)	The SHOW-HEL-LOGGING command again lists the system’s default logging control records (compare with Point 1).

Your Browser is not longer supported

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

SHOW-HEL-LOGGING