Starting and stopping record collection

SUSE Linux Enterprise Server 15 SP5 z/VM guest

By default, record collection for a particular z/VM recording service begins when the corresponding device is opened and stops when the device is closed.

About this task

You can use a device's autorecording attribute to be able to open and close a device without also starting or stopping record collection. You can use a device's recording attribute to start and stop record collection regardless of whether the device is opened or not.

You cannot start record collection if a device is open records already exist. Before you can start record collection for an open device, you must read or purge any existing records for this device.

Procedure

To be able to open a device without starting record collection and to close a device without stopping record collection write 0 to the device’s autorecording attribute. To restore the automatic starting and stopping of record collection write 1 to the device’s autorecording attribute. Issue a command of this form:
# echo <flag> > /sys/bus/iucv/drivers/vmlogrdr/<device>/autorecording
where <flag> is either 0 or 1, and <device> is one of: logrec, symptom, or account.
To explicitly turn on record collection write 1 to the device’s recording attribute. To explicitly turn off record collection write 0 to the device’s recording attribute. Issue a command of this form:
# echo <flag> > /sys/bus/iucv/drivers/vmlogrdr/<device>/recording
where <flag> is either 0 or 1, and <device> is one of: logrec, symptom, or account.

You can read both the autorecording and the recording attribute to find the current settings.

Examples

  • In this example, first the current setting of the autorecording attribute of the logrec device is checked, then automatic recording is turned off:
    # cat /sys/bus/iucv/drivers/vmlogrdr/logrec/autorecording
    1
    # echo 0 > /sys/bus/iucv/drivers/vmlogrdr/logrec/autorecording
  • In this example record collection is started explicitly and later stopped for the account device:
    # echo 1 > /sys/bus/iucv/drivers/vmlogrdr/account/recording
    ...
    # echo 0 > /sys/bus/iucv/drivers/vmlogrdr/account/recording
    To confirm whether recording is on or off, read the recording_status attribute.