SETLOGRC command

Use the SETLOGRC command to change the logrec error and environmental recording medium originally specified in the IEASYSxx parmlib member during initial program load (IPL). You can specify one of the following options for logrec error recording:

• LOGSTREAM
• DATASET
• IGNORE

After the system processes the command, depending on the specified option, one of the following results will occur:

• If the change of medium is successful, the system issues message IFB097I to indicate the change and the new medium to the requesting console.
• If the change is to DATASET:
  • If the change of medium is to DATASET and the system was not originally initialized with a data set specified as the recording medium, the system now dynamically allocates and opens the specified data set. If no data set name is provided, then logrec defaults to using SYS1.LOGREC. If the system fails to open on the logrec data set, it issues messages IFB110I and IFB112I along with message IFB099I.
  • If the current medium is DATASET and DATASET is requested with a new data set name, logrec closes and deallocates the old data set, then allocates and opens the new data set for logrec recording.
  • If the current medium is LOGSTREAM and DATASET is requested, logrec disconnects from the log stream, then allocates and opens the data set for logrec recording. If problems arise when allocating the data set, logrec attempts to revert to log stream recording.
• If the change is to IGNORE:
  Note: IBM® recommends that you use the IGNORE setting in testing environments only.
  • If the current setting is IGNORE and IGNORE is requested, logrec issues message IFB096I to the invoking console to indicate that the desired medium is the current setting.
  • If the desired setting is to IGNORE, logrec error and environmental records are not recorded and are not provided in an ENF 36 signal.
  • If the current medium is DATASET and IGNORE is requested, logrec closes and deallocates the logrec data set.
  • If the current medium is LOGSTREAM and IGNORE is requested, logrec disconnects from the log stream.
• If the change is to LOGSTREAM:
  • If the desired setting is to LOGSTREAM and the connection to the log stream succeeds, the system issues message IFB094I to indicate the successful change of medium from LOGSTREAM to LOGSTREAM. If the change of medium is unsuccessful, the system issues message IFB099I. The system also issues message IFB100E to indicate that the system logger is unavailable. Logrec error and environmental records are internally buffered until the system logger becomes available. The buffer can hold only a certain number of records and will wrap when that number is exceeded.
  • If the connection is successful or when system logger and the log stream are available for writing, logrec writes records, including any buffered records, to the log stream.
  • If the current medium is DATASET and LOGSTREAM is requested, logrec closes and deallocates the logrec data set, then connects to the log stream.
  • If the current medium is LOGSTREAM and LOGSTREAM is requested, logrec disconnects from and then reconnects to the log stream. If a new log stream name is requested, logrec disconnects from the old log stream and connects to the new log stream.