Running the Report Manually and Using ACFRPTS

Running the Logonid Modification Report (LL) › 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 Reports Using the ACFRPTS EXEC in “The Reports” chapter to use the ACFRPTS utility to run the Logonid Modification Report. Select the LL option.

Manual and ACFRPTS Parameters

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

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 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 prints selected SMF records in hexadecimal dump format. We provide this option 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 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 logonids to use for this report. This mask is compared to the logonid of the report being changed, not the logonid of the changer. The default is all logonids.

NOUPDATE|UPDATE

The UPDATE parameter requests a summary of logonid modifications including any JESx and logon validation updates. The NOUPDATE parameter (the default) lists only updates other than validation updates. NOUPDATE is the default because of the volume of validation updates (one for every job and session).

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 processes only 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. See 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 a summary report, only one line of information for each INSERT, CHANGE, or DELETE subcommand entry. DETAIL produces a DETAIL report that produces additional report lines that highlight changes made to any logonid records (by the ACF INSERT, CHANGE, or DELETE subcommand). Each of these additional lines shows the name of the logonid field whose value was changed or deleted; the old value of the field; and the new value of the field.

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