CHANGE-CONSLOG-FILE

Close current logging file and open new file

Component:	BS2000
Functional area:	Error logging
Domain:	ERROR-LOGGING SECURITY-ADMINISTRATION
Privileges:	OPERATING SAT-FILE-MANAGEMENT TSOS

Function

The CHANGE-CONSLOG-FILE command closes the current logging file and opens a new one (see also “Logging file” in the “Introduction to System Administration” [14]).
This enables the closed logging files to be evaluated during the current session. Read access to the logging file currently open is obtained with the SET-CONSLOG-READ-MARK command.
If a CHANGE-CONSLOG-FILE command is already being processed, all further CHANGE-CONSLOG-FILE commands are rejected. Depending on the NBKESNR system parameter, up to 99 files can be created per session or 999 per day. The NBKESNR system parameter also governs whether the CONSLOG file is created under the TSOS or SYSAUDIT user ID. The NBLOGENF system parameter (NBLOGENF=E(nforced)) can be used to prevent the last possible CONSLOG file from being changed.
When printing the closed logging file it is advisable to specify the LAST-CHARACTER=252 operand in the PRINT-DOCUMENT command.

Format

CHANGE-CONSLOG-FILE                                                                                                                           

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
1	0	NBR0905	CONSLOG not active
2	0	NBR0906	CONSLOG being deactivated
	64	NBR0904	Last possible sequence number reached, command no longer possible
	130	EXC065A	CHANGE-CONSLOG already being processed