LOGREC

LOGREC={dsname | LOGSTREAM | LOGSTREAM=lsname | IGNORE}

LOGREC specifies the LOGREC recording medium to be used for error and environmental recording. If this parameter is omitted, then SYS1.LOGREC is the default data set name specification.

Tip: Before you specify LOGSTREAM to define a log stream as the LOGREC recording medium, load the initial program with a LOGREC data set initialized by IFCDIP00. If you do not load the initial program with a LOGREC data set, you cannot change the LOGREC recording medium from LOGSTREAM to DATASET using the SETLOGRC command.

dsname: Specifies the name of the LOGREC data set to be used for error recording. In a multisystem environment, if you specify a unique name for each of your LOGREC data sets, IBM® suggests that you not place these names in the SYSTEMS exclusion resource name list in parmlib member GRSRNLxx.
Before an IPL, the LOGREC data set must have been allocated, cataloged (unless on the SYSRES) in the system master catalog, and initialized using IFCDIP00. In a multisystem environment, take care in running IFCDIP00 to ensure, if using the SYS1.LOGREC data set name default, that the correct LOGREC data set is initialized.
LOGSTREAM | LS: Specifies that the LOGREC log stream (SYSPLEX.LOGREC.ALLRECS) is to be used for the error and environmental recording. The log stream provides a single repository for all of the MVS™ images in a sysplex. The log stream eliminates the need to allocate, catalog, and initialize a LOGREC data set on each system. When reporting programs, such as EREP, are run, the single log stream can be used as input to the program.
LOGSTREAM=lsname | LS=lsname: Specifies the name of a log stream resource to which to record LOGREC entries. With this functionality, you can use a log stream other than the default SYSPLEX.LOGREC.ALLRECS.
IGNORE: Specifies that error and environmental recording are to be ignored. Logrec records are not recorded to the output medium; no records are written to a LOGREC data set or to the LOGREC log stream. Also, the system does not issue the ENF event code 36 signal for records when IGNORE is specified.
Attention: This specification is intended to be used only on test systems when a LOGREC data set is not established and the LOGREC log stream is not defined.

Table 1 shows syntax examples of the LOGREC parameter and the results they produce.

Table 1. Syntax examples for the LOGREC parameter
Example	Result
`LOGREC=SYSA.LOGREC`	The data set SYSA.LOGREC is used.
`LOGREC=SYSTEMA.LOGREC`	The data set SYSTEMA.LOGREC is used.
`LOGREC=&SYSNAME..LOGREC`	Assuming the value that is specified on the SYSNAME= parameter is SYSTEMA, the data set SYSTEMA.LOGREC is used.
`LOGREC=LOGSTREAM`	The LOGREC log stream, SYSPLEX.LOGREC.ALLRECS, is used by SVC 76 (LOGREC) to record error and environmental records.
`LOGREC=LS`	SVC 76 (LOGREC) uses the LOGREC log stream SYSPLEX.LOGREC.ALLRECS to record error and environmental records.
`LOGREC=LOGSTREAM=LOGREC.TEST1`	SVC 76 (LOGREC) uses the log stream LOGREC.TEST1 to record error and environmental records.
`LOGREC=LS=LOGREC.TEST1`	SVC 76 (LOGREC) uses the log stream LOGREC.TEST1 to record error and environmental records.
`LOGREC=IGNORE`	No error or environmental recording by SVC 76 will occur.

Value range: One of the allowable specifications. The value Start of change

for dsname Start of change

and lsname End of change

can contain system symbols. When the dsname option is used, only one data set can be specified.

Default: SYS1.LOGREC

Associated parmlib member: When LOGSTREAM is specified, see COUPLExx (cross-system coupling facility (XCF) parameters).