Running the Report Manually and Using ACFRPTS

Running the Dataset Index Report (IX) › Running the Report Manually and Using ACFRPTS

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.

It also uses a DETAIL file, as follows:

DETAIL

This file is used if you specified the DETAIL parameter. The DETAIL report contains output of the decompiled rule set.

This file has the same characteristics as the SYSPRINT file. Do not assign both DETAIL and SYSPRINT to the terminal or printer devices. This will cause the output of both reports to interleave in a confusing manner. If the output device of both reports is disk, be sure that the file IDs you specify are different.

If the report generator does not find a FILEDEF for DETAIL, the output is to disk with a file ID of ACFRPTIX DETAIL A.

If the report generator finds a FILEDEF for DETAIL with a device of DISK that has the FILEDEF command default file ID of DETAIL FILE A, it assigns a file ID of ACFRPTIX DETAIL A to the file.

If the output device is the printer, the output file is given a filename and filetype of ACFRPTIX DETAIL.

The ACFRPTS utility for the Dataset Index Report issues FILEDEFs that direct both SYSPRINT and DETAIL to disk. The file IDs are IXREPORT LISTING A and IXDETAIL LISTING A.

See Running the Reports in “The Reports” chapter for information about running this report manually.

Follow the instructions listed in Running Reports Using the ACFRPTS EXEC in “The Reports” chapter to use the ACFRPTS utility to run the Dataset Index report. Select the IX option.

Manual and ACFRPTS Parameters

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

DETAIL|NODETAIL

The DETAIL parameter requests CA ACF2 for z/VM decompile access rule sets and display the results using the DETAIL output file. NODETAIL produces only a summary listing. When you specify NODETAIL, the DETAIL output file is not necessary.

EDATE(169365|cyyddd)

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

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

The year.

ddd

The day of the year.

When combined with the start date parameter, this parameter creates a window for report content. The defaults for start date and end date 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 interval 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 selects SMF records printed 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.

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 by the physical constraints of the output media you are using limits the maximum number of output lines per page. The default is 60.

PREFIX(********|mask)

This parameter specifies the data set high‑level index used as a search argument. ACFRPTIX checks the logonid owned data set PREFIX field and the key of each processed access rule set.

SDATE(000000|cyyddd)

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

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

The year.

ddd

The day of the year.

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

SELLID(smfval|nnn,...,nnn)

This parameters selects the logonid SMF journal record number. For combined SMF records, this is the CA ACF2 for z/VM combined SMF record number. For precombined SMF records, this is the precombined SMF record number for logonid SMF records. Defaults are determined in the same way as the defaults for the SELECT parameter. If you enter any SMF record number, the defaults are ignored.

SELRULE(smfval|nnn,...,nnn)

This parameter selects the access rule update journal number. For combined SMF records, this is the CA ACF2 for z/VM combined SMF record number. For precombined SMF records, this is the precombined SMF record number for access rule update SMF records. Defaults are determined in the same way as the defaults for the SELECT parameter. If you enter any SMF record number, the defaults are ignored.

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 systems.

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.