Change hardware error logging file
Component: | BS2000 |
Functional area: | Error logging |
Domain: | ERROR-LOGGING |
Privileges: | HARDWARE-MAINTENANCE, TSOS |
Function
The CHANGE-HEL-FILE closes the current HEL (Hardware Error Logging) file and opens a new logging file.
Hardware error logging is initiated either automatically on system startup or explicitly with the START-HEL-LOGGING command. The CHANGE-HEL-FILE command is rejected if logging is not active (message HEL0010).
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, in addition to TSOS, all user IDs including the maintenance IDs (HARDWARE-MAINTENANCE privilege) have read access to HEL logging files.
A HEL logging 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.
Format
CHANGE-HEL-FILE |
SPACE = *UNCHANGED / *STD / <integer 24..65536 2Kbyte> |
Operands
SPACE = *UNCHANGED / *STD / <integer 24..65536>
Defines the size (primary allocation, plus rounding as required; see the PRIMARY-ALLOCATION operand of the CREATE-FILE command) of the logging file that is to be created.
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 logging file is given the specified number of PAM pages.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command successfully executed | |
32 | HEL0100 | Internal error | |
32 | HEL0105 | Bourse problems | |
32 | HEL0106 | DMS error | |
32 | HEL0107 | DMS error | |
64 | HEL0010 | Hardware error logging nor active | |
64 | HEL0110 | Privilege error |
Example
/change-hel-file
% HEL0001 HW-ERROR-LOGGING FILE ':1SBZ:$TSOS.SYS.HEL.2017-01-29.141847' OPENED WITH 'SPACE= 402'
The CHANGE-HEL-FILE command with no operands opens a new logging file of the default size (in this case rounded up to 402 PAM pages; see the SPACE operand).