Previous Topic: TCP/IP REXEC InterfaceNext Topic: VM Batch System Support

Installation Options › Unit Record Logging Support

Unit Record Logging Support

To start real unit record devices, issue the following CP command:

START

They are also started automatically at IPL if you do not specify the DRAIN option.

Optional unit record logging support produces an SMF record when output begins or when input from a reader begins. Unit record logging monitors the files processed on real devices.

This section provides information on implementing unit record logging support on your system.

Implementing Unit Record Logging Support

Set the VMXAOPTS macro URLOG operand to YES (the default) to activate unit record logging support. Enter the following command to display this setting:

ACF SHOW ACTIVE

To implement unit record logging support, you must perform the following steps:

  1. Instruct your system operators to always respond DRAIN to the spool system startup prompt. This eliminates potentially confusing messages, problems with spool files, and the status of unit record devices.
  2. Be sure no site modifications or other products use VMUSRFD (VMDUSERx field in the VMDBK of the system ID). CA ACF2 for z/VM requires that VMUSRFD, defined in VMXAOPTS, must be available for the system ID (anchored off ASYSVM in the PSA). CA ACF2 for z/VM uses VMUSRFD to build a dummy minilogonid off the system VMDBK to place user information in the reports.
  3. Ensure that you issued the START command before input or output begins on a real device and modify the unit record class definitions in HCPRIO so no users can create spool files for those devices. If you start the system without the DRAIN option, CA ACF2 for z/VM does not start I/O to those devices. Or, you can note the classes defined in HCPRIO. Remember that the system can automatically start spool files for these classes if you do not specify the DRAIN option.

Output

CA ACF2 for z/VM writes an SMF record that appears in the ACFRPTCL report with a command name of $START. $START is a pseudocommand name CA ACF2 for z/VM sends when it starts input or output on a real device. For additional information about the ACFRPTCL report, see the Report and Utilities Guide.