Activate hardware error logging
Component: | BS2000 |
Functional area: | Error logging |
Domain: | ERROR-LOGGING |
Privileges: | HARDWARE-MAINTENANCE |
Function
The START-HEL-LOGGING command activates the hardware error logging (HEL) mechanism and opens a logging file.
As HEL is started up automatically during system startup, the command is required only in the following cases:
HEL has not been activated owing to a startup error
HEL has been terminated by a system error
HEL has been disabled by a STOP-HEL-LOGGING command
Hardware errors are logged in the logging file which has been opened; the type of errors that are recorded can be defined with the MODIFY-HEL-LOGGING command. The CHANGE-HEL-FILE command can be used to close the current logging file and open another.
HEL logging files are created under the TSOS user ID with a default name formed on the pattern $TSOS.SYS.HEL.yyyy-mm-dd.hhmmss. The name components yyyy-mm-dd and hhmmss respectively identify the date and time when the logging file was initially opened. The file access rights are by default set to USER-ACCESS=*SPECIAL and ACCESS=*READ, which means that all user IDs, including the user ID with the HARDWARE-MAINTENANCE privilege, have read access to HEL logging files.
A HEL log file is given the size specified in the SPACE operand. There is no provision for dynamic extension (SECONDARY-ALLOCATION=0). If the file grows to the size of the primary allocation, it is automatically closed and a new logging file is created and opened.
HEL logging file are evaluated using the ELSA utility (Error Logging System Analysis; see the “ELSA” manual [16]).
Format
Operands
FILE = *SAME / *NEXT
Specifies which logging file to open.
FILE = *SAME
Opens the most recent logging file and continues writing to it.
If no logging file exists, a new one is created with the default name.
FILE = *NEXT
Creates a new logging file with the default name and opens it.
SPACE = *UNCHANGED / *STD / <integer 24..65536 2Kbyte>
Defines the size (primary allocation, plus rounding as required; see the PRIMARY-ALLOCATION operand of the CREATE-FILE command) of a new logging file.
If an existing logging file is to be reopened, the SPACE argument is irrelevant.
SPACE = *UNCHANGED
The logging file is to be the same size as the old one.
SPACE = *STD
The logging file is given the default size of 400 PAM pages.
SPACE = <integer 24..65536 2Kbyte>
The log file is given the specified number of PAM pages.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command successfully executed | |
1 | 0 | CMD0001 | Hardware error logging is already active |
32 | HEL0100 | Internal error | |
32 | HEL0101 | Resources not available | |
32 | HEL0105 | Bourse problems | |
32 | HEL0106 | DMS error | |
32 | HEL0107 | DMS error | |
64 | HEL0110 | Privilege error |
Example
See the SHOW-HEL-LOGGING command.