All report generators use two input files and one output file. This section explains these files.
These are the input files that contain the SMF records you accessed. Typically, these files have a CMS file ID of SMF yydddnnn. The CMS FILEDEF command that defines an SMF file for input specifies the CMS file ID.
The xxxxx portion of the ddname can be any characters that are unique for each SMF input file. The ACFRPTS utility uses a dollar sign, followed by a four digit sequential number starting with 0001 (for example, REC$0025).
The report generators automatically convert precombined SMF records to combined format records. See the SELECT report parameter for the report you are processing for further information. The ACFRPTPP utility can also convert precombined format SMF records to combined SMF records.
The ACFRPTS utility issues the FILEDEF commands for the SMF input files that you specify. Below is an example of a CMS FILEDEF command for an SMF input file:
FILEDEF REC1 DISK SMF 91092001 C
This SMF input file is located on your C disk.
The report generators process the SMF files in the same order as you entered the FILEDEF commands. You should issue the FILEDEF commands in chronological order.
This file provides one method of specifying parameters to the CA ACF2 for z/VM report generators. This file can be fixed or variable, with a record length of up to 256 characters. Valid devices are TERMINAL, DISK, and DUMMY. If ACFRPTS does not find a FILEDEF for this file, it uses TERMINAL.
When TERMINAL is the input device, ACFRPTS prompts you to enter the report parameters with a string consisting of the report ID (the last two characters of the report name) and a question mark (for example, DS? for the ACFRPTDS report). Reply with any report parameters you want to specify. You are then prompted for more parameters after each reply until you enter a null or blank link that signals the end of your input.
When the device is DUMMY, the report generator proceeds as if the device was a terminal and the first response was a null line.
You can use XEDIT to create the SYSIN file on a CMS minidisk. See the chapter of the report you want to run for information about valid report parameters. Below are two examples of CMS FILEDEF commands for a SYSIN file:
FILEDEF SYSIN DISK RPTCL SYSIN A FILEDEF SYSIN TERMINAL
The ACFRPTS utility does not issue a FILEDEF for this file. If you issued a FILEDEF for SYSIN, the report generator uses it.
This is the report output file. Valid output devices are TERMINAL, PRINTER, DISK, and DUMMY. The record format of the output file is always variable.
The LRECL option is the only FILEDEF option that is recognized. For TERMINAL, PRINTER, and DUMMY output, the record length includes the carriage control character. TERMINAL output does not include the carriage control character. The default LRECL for terminal devices is 132. All other devices have a default of 133. If the FILEDEF specifies a LRECL that is less than the actual length of an output record, that record is truncated. Use caution if you specify a LRECL that is different than the default.
Below is an example of CMS FILEDEF commands for SYSPRINT files:
FILEDEF SYSPRINT DISK ACFRPTCL LISTING A FILEDEF SYSPRINT DISK FILEDEF SYSPRINT TERMINAL FILEDEF SYSPRINT PRINTER
If ACFRPTS does not find a FILEDEF for SYSPRINT, it uses the TERMINAL (as in the third line in the previous example).
If a CMS FILEDEF command specifies DISK as out, but does not specify a file ID (as in the second line in the previous example), FILEDEF enters a default file ID of ddname FILE A (in this case, SYSPRINT FILE A1). If the report generator finds a FILEDEF for SYSPRINT with a device of DISK that has the default file ID, the output file is assigned a file ID of reportname LISTING A1. This lets multiple reports use a single FILEDEF and generates separate output files for each report generator. If a file already exists with the file ID of the output file, it is erased during the report generator initialization.
If the output device is PRINTER, the output spool file is given a name and type of reportname LISTING. This is displayed when you issue the following command:
CP QUERY PRINTER ALL
Report generator output is generally 80 characters wide. This width lets you easily read the output when you send the output to the terminal or when you browse the output file on disk. Some reports let you specify PRINTER as a report parameter to provide a wider format. The PRINTER format is never the default, even if the output device is PRINTER.
|
Copyright © 2009 CA Technologies.
All rights reserved.
|
|