Previous Topic: Report Parameter Cross ReferenceNext Topic: Sample Report


Running the Report Manually and Using ACFRPTS

This report uses the standard SYSPRINT, SYSIN, and RECxxxxx files. See Common Files in “The Reports” chapter for information about these files. See Running the Reports Manually in “The Reports” chapter for information about running this report manually.

Follow the instructions listed in Running Reports Using the ACFRPTS EXEC to use the ACFRPTS utility to run the DIRMAINT Event Log. Select the DL option.

Manual and ACFRPTS Parameters

Listed below are the parameters and their defaults used to generate the DL report manually and using ACFRPTS.

ALL|COMMAND|MDISK|OVERLAP

These parameters specify which types of DIRMAINT journal SMF records are processed. You can specify one or more of these parameters. The report processes all records that match the parameters you specify.

ALL

Processes all types of DIRMAINT journal SMF records.

COMMAND

Processes DIRMAINT command SMF records. You can abbreviate COMMAND with CMD.

MDISK

Processes DIRMAINT minidisk SMF records.

OVERLAP

Processes DIRMAINT minidisk overlap SMF records.

DETAIL|SHORT

This parameter lets you specify whether you want a short or detailed report. SHORT produces only the cross‑reference table. This table is a listing of DIRMAINT commands and logonids of users that issued these DIRMAINT commands. It also produces a count.

EDATE(169365|cyyddd)

This parameter specifies the Julian date you are using as an ending point for selecting information.

c

0 to indicate the 20th century or 1 to indicate the 21st century.

yy

The year.

ddd

The day of the year.

When combined with the SDATE parameter, this parameter creates a window for report content. The defaults for SDATE and EDATE causes the report generator to process all available records. The default is 169365, December 31, 2069.

ETIME(2359|hhmm)

This parameter specifies the end of the time internal for selecting SMF records. This time is based on a 24‑hour clock. Any SMF records generated after the specified time of day are ignored. The default is 2359.

HEX

This parameter prints selected SMF records in hexadecimal dump format. This option is provided primarily for diagnostic purposes.

If a report generates a hex dump of an SMF record, the dumped record shows a four‑byte RDW (two bytes for the record length followed by two‑bytes of binary zeros). This is true even when the input file does not have a RDW. This is the internal format of every SMF record that matches the SMF mapping macros. It provides a consistent format for the dump. This information applies to records dumped due to an error in the SMF record and when you specify HEX.

JOBMASK(********|jobmask,...,jobmask)

This parameter specifies the job name to limit records appearing on this report to those pertaining to the job or jobs indicated by the job name or job name mask. You must use commas or blanks to separate multiple job names. The default is all jobs. In VM, this is equal to the virtual machine user ID.

LIDMASK(********|lidmask)

This parameter lets you specify a logonid or group of logonids for this report. The default requests information for all logonids that created a DIRMAINT SMF record.

LINECNT(60|nnn)

This parameter specifies the number of output lines printed on a page. CA ACF2 for z/VM report generators that issue multiple line reports check whether a complete report item will fit on a page to prevent splitting the information. Only the physical constraints of the output media you are using limit the maximum number of output lines per page. The default is 60.

MASK(-|cmdmask)

This parameter lets you request information for one or more DIRMAINT commands. The default is all DIRMAINT commands.

NLIDMASK(********|lidmask)

This parameter lets you exclude logonids from the report. For example, if you specify NLIDMASK(PAY-), all information on users with logonids that begin with PAY are excluded from the report. Any logonids you specify in this parameter are overridden by those you specified in the LIDMASK parameter.

NMASK(-|cmdmask)

This parameter lets you exclude information for one or more DIRMAINT commands. Commands you specify through this parameter override commands specified in the MASK parameter. The default is null, no DIRMAINT command is excluded.

SDATE(000000|cyyddd)

This parameter specifies the Julian date you are using as a starting point for selecting information.

c

0 to indicate the 20th century or 1 to indicate the 21st century.

yy

The year.

ddd

The day of the year.

The report generator ignores any input SMF records generated before the SDATE value. The default is 000000.

SELECT(smfval|nnn,...,nnn)|NOSELECT

This parameter defines the SMF record number CA ACF2 for z/VM uses. Generally, this parameter is not necessary because the default SMF numbers are usually correct. The SMF record numbers required for a report are the combined SMF record number for every system that produced the SMF data and the precombined SMF record numbers for the CA ACF2 for z/VM SMF record type the report generator processes. Do not specify precombined SMF record numbers for CA ACF2 for z/VM SMF record types that this report does not process.

If this parameter enters any SMF record number, the report generator only processes those SMF records. It does not use the defaults.

Default SMF numbers are determined in the following manner:

  1. If CA ACF2 for z/VM is active or if this is a NOAUTO IPL and you are the NOAUTO UPDATE user, it uses the SMF record numbers specified by the @SMF macro in the ACFFDR. If a precombined SMF record number is specified as zero, then the report generator uses the precombined default. The ACF2 parameter of the @SMF macro in the ACFFDR defines the combined format SMF record number.
  2. If this is a NOAUTO IPL and you are not the NOAUTO UPDATE user, it uses the combined SMF number default of 230. For precombined SMF records, it uses the precombined SMF number default. See the Installation Guide for more information about the @SMF macro values.

If you are processing z/OS SMF data and use the default SMF record numbers for other types of SMF records on the z/OS system, you must specify the correct SMF number in this parameter.

When processing CA ACF2 for z/VM SMF data on VM, you must specify this parameter if you are running reports during a NOAUTO IPL and you are not the NOAUTO UPDATE user and the SMF record numbers are not the same as the defaults. You also need to specify this parameter if the @SMF macro in the ACFFDR specifies incorrect SMF record numbers.

SIZE(2500|size)

This parameter defines the number of elements allowed in the cross‑reference table.

STIME(0000|hhmm)

This parameter specifies the beginning of the time interval for selecting SMF records. This time is based on a 24‑hour clock. Any SMF records generated before the specified time of day are ignored. The record selection begins at the STIME specified for each date in the SDATE/EDATE range and ends on each date at the ETIME you specified. The default is 0000.

SYSID(********|sysid)

This parameter specifies the CA ACF2 for z/VM system ID that was active on the system when the SMF records were generated. You can specify a single system ID or a system ID mask. You cannot specify multiple masks or a series of IDs. The default is all system.

TERMINAL|PRINTER|SUMMARY

These parameters let you select one of three output formats.

PRINTER

132 characters wide with five lines of output per SMF record.

SUMMARY

80 characters wide with a one line summarization of each SMF record.

TERMINAL

80 characters wide with five lines of output per SMF record (the default).

TITLE(cmdparm|string)

This parameter specifies a character string that is added to the other title information at the top of the report. This character string can be up to 35 characters long. If you do not specify this parameter, the report generator uses the first 35 characters in the command parameters. If this character string is longer than 35 characters, it uses the first 35 characters. If you use ACFRPTS or the full‑screen feature, you cannot specify command parameters.

UID(-|uidmask)

This parameter specifies the UID mask the report pertains to. Dash (-) is the default, reporting on all UIDs.