This report uses the standard SYSPRINT and SYSIN files. Since ACFRPTXR does not process SMF data, it does not use the standard RECxxxxx file. See Common Files in “The Reports” chapter for information about these files. This report also uses the following files:
This is a work file. If you do not enter a FILEDEF command for this file, ACFRPTRX assigns a file ID of ACFRPTRX SYSUT1 A1. Refer to the definition of SYSUT2 below for additional information.
This is a work file. If you do not enter a FILEDEF command for this file, ACFRPTRX assigns a file ID of ACFRPTRX SYSUT2 A1.
If you entered a FILEDEF for SYSUT1 or SYSUT2, the file ID the FILEDEF command specified or defaulted to is used. All FILEDEF command options are ignored. Do not assign a filemode number of 3 to these files as CMS will erase the files before the report generator is finished using them. By specifying a FILEDEF for this file, you tell the report generator to use a minidisk other than your A-disk for these work files. This can correct a minidisk full situation that can occur when the report generator runs. You could specify a CP T-disk that you defined and formatted.
ACFRPTRX erases any file with the same file ID in effect for these files during initialization. The files are erased during program termination.
The ACFRPTS utility does not issue a CMS FILEDEF command for these files. You can enter them before starting the procedure.
This file specifies a list of data set names the ACFRPTXR report processes. This file is only used if you specify DSET and do not specify DSN. You can use this file to process a list of multiple data set names.
This file has the same characteristics as the SYSIN file.
When you specify TERMINAL as the input device, you are prompted with “DS?” to enter report parameters.
The syntax of the SYSDSLST statement is:
dsn [vol] RKEY(rulekey)
The dsn and vol parameters are positional. They must appear in this sequence and before RKEY, if you use it.
dsn
Specifies a full-qualified data set name to process. This parameter is mandatory. Do not use quotes in the data set name.
vol
Specifies the name of the volume where the data set resides. This parameter is optional. If you do not specify this parameter, all volser specification in the access rule data set are ignored (they all match).
RKEY(rulekey)
Specifies an alternate access rule key to use instead of the data set high‑level index. This parameter is optional.
The ACFRPTS utility does not issue a FILEDEF command for SYSDSLST. You can enter a FILEDEF for SYSDSLST before starting the utility. The file must exist when you start ACFRPTS. If you specified DSET and you did not specify a dsn as a report parameter and did not enter a FILEDEF, ACFRPTS will prompt you for the input.
This file specifies a list of resource names to process. This file is only used if you specified RSRC and did not specify TYPE and NAME as parameters.
This file has the same characteristics as the SYSIN file.
When you specify TERMINAL as the input device, you are prompted by “RS?” for report parameters.
The syntax of the SYSRSLST statement is:
TYPE(type) NAME(name)
The TYPE and NAME parameters are positional. They must appear in this sequence.
TYPE(type)
Specifies the three-character resource type. This parameter is mandatory. For example, TYPE(DIA) represents the resource rules for CP DIAL.
NAME(name)
Specifies the key under which the rule is stored. For example, TYPE(DIA) NAME(TESTVM) produces an access report for DIALs to TESTVM virtual machines. You can mask the NAME keyword as NAME(-), resulting in a cross-reference report entry for each resource name stored under a particular resource type.
The ACFRPTS utility does not issue a FILEDEF command for SYSRSLST. You can enter a FILEDEF for SYSRSLST before starting the utility. The file must exist when you start ACFRPTS. If you specified RSCS and did not specify the TYPE and NAME report parameters and did not enter a FILEDEF, you will be prompted for the input.
See Running the Reports in “The Reports” chapter for information about running the Cross-Reference 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 Cross‑Reference Report. Select the XR option.
Following is a list of the parameters and their defaults used to generate the XR report manually and using ACFRPTS.
The DSET parameter processes data set access rules. You can provide the DSN, RKEY, and VOL input parameters through the JCL parameter field or the SYSDSLST input file. Refer to the DSN, RKEY, and VOL parameter descriptions below.
The RSRC parameter processes resource rules. You can provide the TYPE and NAME input parameters through the JCL parameter field or the SYSRSLST input file. Refer to the TYPE and NAME parameter descriptions below.
This parameter processes a single data set. This parameter is valid only when you specify the DSN parameter above. If you enter a value for this parameter, the report generator does not use the SYSDSLST file. The data set name you specify must be fully qualified, but must not be specified in quotes. The report generator uses data set name high-level index as the key to identify the applicable access rule set unless you specified the Rule key field. When you want to list a full rule set for a particular $KEY, you can mask this parameter as - (dash) and define the applicable $KEY value in the RKEY parameter.
The LID parameter creates a cross-reference report and list of all logonids that have access to the specified data set or resource. NOLID suppresses the listing of logonids. The report only lists applicable data sets or resource rule sets.
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.
This parameter specifies the name of the resource to process. You can only use this field when you also use the RSRC and TYPE parameters. You can specify the name as a dash to process every name present in the TYPE parameter. If you do not specify a value for NAME and TYPE, the report generator uses the SYSRSLST file for input. You cannot specify the NAME and TYPE parameters on the JCL parameter field and in the SYSRSLST file.
This parameter processes access rule sets. You can only specify a value for this parameter if you used the DSET parameter to specify the key of the rule set to be used to validate the data set access. This is similar to the concept of using the CA ACF2 for z/VM Data Set Prevalidation exit to perform the same function at run time. You only need to specify a value for this parameter if a rule record other than the one under the data set high-level index is to be used for rule checking. You can mask this parameter with a dash to list all the rule entries for a particular key. The default is your logonid.
The RRSUM parameter creates an additional Rule Record Summary portion of the ACFRPTXR report at the end of the report. This includes an entry for each rule record (high-level index, $KEY value, or resource TYPE and NAME combination) used in producing the report. This portion of the report contains the detailed logonid lists for each %CHANGE and %RCHANGE record encountered (assuming you also specified the LID option. When you see the %CHANGE DATA EXISTS or %RCHANGE DATA EXISTS in the report after the RULE KEY line, the related LID and UID entries are printed in the Rule Record Summary.
The NORRSUM parameter suppresses the Rule Record Summary.
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.
This parameter specifies the three-character resource type to process. The report generator only uses this parameter used when you specify the RSRC and NAME parameters. If you specify a TYPE and NAME in the JCL parameter field, you cannot use the SYSRSLST file.
This parameter that specifies the volume serial number of the volume where the data set resides. If you do not specify a volume serial, ACFRPTS ignores all volume information on the access rule set (volume masks specified in the rules are considered matches). You can only use this field when you use the DSET parameter.
|
Copyright © 2009 CA Technologies.
All rights reserved.
|
|