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

Optionally, you can specify a new name for DATASET or LOGSTREAM parameters.

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.
  • If the change is to ENF:
    • If the desired setting is to ENF, logrec error and environmental records are not recorded but are provided using the ENF 36 signal.
    • If the current medium is DATASET and ENF is requested, logrec closes and deallocates the logrec data set. - If the current medium is LOGSTREAM and ENF is requested, logrec disconnects from the log stream.
    • If the current setting is ENF and ENF is requested, logrec issues message IFB096I to the invoking console to indicate that ENF is already the current setting.
    • If the current setting is IGNORE and ENF is requested, or vice versa, logrec issues message IFB096I to the invoking console to indicate that the storage medium is already being skipped. No action is taken to change the LOGREC recording medium or enable or disable the ENF signal. Switching between IGNORE mode and ENF mode is not supported.
    Note: IBM recommends that you use the ENF setting in testing environments only. This support is not available via the parmlib IEASYSxx LOGREC parameter.