The Reporting Facility requires that several data sets be made available, through JCL, to process specific requests. Some of these data sets are always required and some are optional, depending on the function to be performed.
The following is a summary of each data set potentially required for execution of the Reporting Facility. The names stated below represent the names that must appear in the appropriate JCL commands:
Defines the Reporting Facility call library. This file is optional, except:
This is a direct-access disk file and you must format and load it with data prior to its use. The file can be as large as necessary to contain all of the source members to be cataloged, but should occupy at least one full cylinder. The physical type of device on which this library file resides in a single run of the Reporting Facility is determined by either the installation default value or the OPTION DISK= override parameter.
Take extreme care when modifying the default physical device type of the Reporting Facility disk files. Protect this file from concurrent update or access to avoid potential destruction of the source library.
Specifies an optional output file to be created rather than a report generated. The sole purpose of invoking the Reporting Facility in the Write-Only mode is to create a single, sequential, fixed-length output file. When you invoke Write-Only mode, all output is directed to this file.
This file varies in size, depending on the size and number of output records to be created by the program. When the output file is a disk file, the physical type of device on which it is to reside is determined either by the installation default value or by the OPTION DISK= override parameter.
Is an optional data set used in conjunction with OPTION SNAP. When used in a z/OS environment, this is a standard SYSOUT type data set, that is, the output is assumed to be directed to a system printer. When used in a z/VSE environment, this is the sequential disk file containing print line images of the output as a result of OPTION SNAP.
The content of this file then prints separately according to the specifications of a utility function you prepared. The installation default value of the OPTION DISK= override parameter determines the physical type of device on which the data set resides.
Is an optional data set used in conjunction with OPTION DUMP. When used in a z/OS environment, this is a standard SYSOUT type data set, that is, the output is assumed to be directed to a system printer.
The content of this file then prints separately according to the specifications of a utility function prepared by you. The device type on which the data set resides is determined either by the installation default value or by the OPTION DISK= override parameter.
Is a required data set used as a work file during the compilation of the Reporting Facility program. The device type on which it resides is determined by the installation default value. It is not possible to temporarily override the device type for this file on a per run basis. Make a valid DRWORK disk file available for every execution of the Reporting Facility, regardless of the mode of operation selected, in both z/OS and z/VSE environments.
The Reporting Facility uses this file to temporarily store volatile internal control blocks and the generated code to read input files and produce reports. The file can be a temporary file; you need to maintain it only for the current run. Define it as a direct-access disk file.
The size of the file varies based on the size of the Reporting Facility program to be compiled, the number of input files to be read, and the number of reports to be produced. The minimum suggested allocation is between 10 and 20 tracks, or 200 to 300 blocks if the file resides on an FBA device.
Defines the Reporting Facility Hit File and is required only when executing in the Primary mode. SORTIN must be used in a z/OS environment, SORTIN1 in a z/VSE environment. The system creates this file during the record selection phase of the Reporting Facility. The file contains only the fields from the input files necessary to produce the final reports.
This file varies in size, depending on the size and number of reports to be produced and the size of the largest sort key required for a particular report. It is required for OPTION XREF.
Is required in a z/OS environment only when executing in the Primary mode. This data set specifies the library, usually SYS1.SORTLIB, that contains the stand-alone sort program modules.
Defines the temporary output file from the sort, and is required only when executing in the Primary mode. This file is a sequential disk data set with a variable blocked format. It must have the same physical characteristics as the SORTIN or SORTIN1 file.
Most sort packages allow the same physical disk extent to be used for both SORTIN and SORTOUT. This method of invoking an in-place sort is highly recommended to both increase the efficiency of the sort and conserve resources.
Specifies multiple temporary work files for the sort and is, therefore, required only when executing in the Primary mode. You can specify from one to six work files in a z/OS environment and from one to eight in a z/VSE environment. The number of work files in a particular run is controlled by either the installation default value or the OPTION SORT= override parameter.
Specifies the data set from which all of the Reporting Facility commands are read. This file is required for any execution of the Reporting Facility, regardless of intent. SYSIN must be specified in a z/OS environment; however, in a z/VSE environment, the command automatically reads from SYSIPT by placing them immediately behind the EXEC statement.
Specifies the data set to which all printed output is directed. This includes both the compiler source listing and the output report. z/OS environments must specify SYSPRINT; however, SYSLST is usually handled automatically in a z/VSE environment.
Specifies, in a z/OS environment only, the data set to which the printing of a formatted dump is directed if the Reporting Facility recognizes an abend condition that warrants immediate termination of the run. This data set is optional.
|
Copyright © 2014 CA.
All rights reserved.
|
|