Running the Report Manually and Using ACFRPTS

Running the Information Storage Update Log (EL) › 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.

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

Follow the instructions listed in Running CA-ACF2 Reports Using the ACFRPTS EXEC in “The Reports” chapter to use the ACFRPTS utility to run the Information Storage Update Log. Select the EL option.

Manual and ACFRPTS Parameters

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

CLASS(*|class)

This parameter lets you request update information for a specific resource class. Resource classes are one character. The default is * or all classes. When you use CLASS with the TYPE parameter, you can differentiate between infostorage records that have the same type, but different classes. The box below lists all the predefined CA ACF2 for z/VM type names. Your site can define additional type codes.

Storage Class	Type of Record
C	Control record-with a type code of SER or VMO
E	Entry record-with a type code of SGP or SRC
L	Command limiting record-with a type code of VRC, VSC, or VRD
P	Profile Records
R	Resource rule set-with a type code of ACT, ALG, GRP, DIA, IUC, or VMC
S	Scope record-with type code of SCP
T	Shift or zone record-with type code of SFT or ZON
X	XREF record-with type code of RGP or SGP

The name of the record can be one of the following:

Control record name
Record ID for entry records
Key (designated in the $KEY control statement) for resource rule sets
Scope record name
Name of the shift or zone.

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 SDATE parameter, this parameter creates a window for report content. The defaults for SDATE and EDATE cause 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.

ID(-|rsrcmask)

This parameter specifies a mask for the actual name of the resource rule set or entry list. When you also specify the TYPE parameter, using this field lets you search for specific infostorage updates. The default is all resource rule sets.

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

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

MASK(********|lidmask)

This parameter specifies a mask for the logonid of the person updating the Infostorage database, providing a summary of activity by a single person or group of people. The default, ********, implies CA ACF2 for z/VM reports on all logonids.

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 1 to indicate the 21st century.

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:

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.
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. Refer to the @SMF macro of the ACFFDR in the Installation Guide for these 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.

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.

SUMMARY|DETAIL

The SUMMARY parameter produces only one line of information for each INSERT, CHANGE, or DELETE subcommand entry. SUMMARY is the default.

The DETAIL parameter produces additional lines of information for any INSERT, CHANGE, or DELETE subcommand entry updating the Infostorage database for structured infostorage records, such as VMO records and resource rules. This information includes the name of each field changed in the Infostorage database record; the old value of each field; the new value of each field; and, when a change affects a resource rule, a complete afterimage of a decompiled resource rule set. For deleted resource rules, it shows the deleted decompiled rule.

This detail information is not produced for unstructured infostorage records, such as scope and shift. SMF records for unstructured infostorage records contain the deleted image, however, the information is unprintable on the report.

The deleted image on the SMF record is available as a tracking mechanism. It creates a specific audit trail of deleted records, giving a detailed image of each deleted record. If you need to reconstruct a CA ACF2 for z/VM database record, you can create a new record from the image. The following fields appear as an additional line of information on control record updates when you specify the DETAIL parameter:

FIELD

The name of the field in the record that was updated

OLD VALUE

The value of the field before the update was made

NEW VALUE

The value of the field after the update.

When the DETAIL parameter is in effect, the values before and after the change to structured infostorage records can be reported as follows:

If the value of a field is too long, it is continued onto more than one line of the report
If a field contains no value, the following message appears for the value of that field on the report:
```
---NULLS---
```
If the value of a field cannot be reconstructed (such as the password), the following message appears for the value of that field:
```
---NONPRINTABLE---
```
If the user printing the report does not have authorization to list the value of a field, the following message appears for the value of that field:
```
---NOT AUTH---
```
If no fields were changed, the report generator displays the following message instead of the old and new values for the field:
```
***NO FIELDS CHANGED***
```
For changed or inserted resource rules, CA ACF2 for z/VM decompiles and prints the afterimage of the rule set instead of the old and new values of the rule. For deleted resource rules, CA ACF2 for z/VM decompiles and prints the image of the resource rule before it was deleted.

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.

TYPE(-|typemask)

This parameter specifies a mask for the actual type of resource rule set, entry list, or other Infostorage database update. The default is all types. You can define additional type codes locally.

Valid VM resource types are:

ACT

For account resource rules.

ALG

For AUTOLOG command rules.

DIA

For DIAL command rules.

GRP

For group machine rules (Class R). Also for Group Profile Records (Class P).

IUC

For Inter-User Communications Vehicle (IUCV) rules.

PGR: For POSIX/OpenExtensions.
SAF: For System Authorization Facility (SAF) resource validation.

SCP

For scope lists.

SER

For ACFSERVE privileges.

SFT

For time shift records.

SGP

For input source group entry lists.

SRC

For input source name translation entry lists.

SUR: For LogonBy/surrogate user rules.
USR: For USER Profile Records.

VMC

For Virtual Machine Communications Facility (VMCF) rules.

VMO

For VM system option records.

VMR: For VMRDR (VM READER) FTP rules.

VRC

For command limiting rules.

VSC

For command models.

VRD

For diagnose limiting rules.

ZON

For time zone records.

This parameter selects by only the three-character type code and does not differentiate between storage classes. Therefore, to prevent possibly confusing reports, do not assign duplicate type codes or use the CLASS parameter with the TYPE parameter.