CA Culprit Default File Assignments

Execution JCL › CA Culprit Default File Assignments

CA Culprit Default File Assignments

CA Culprit jobs execute in six phases. The following CA Culprit Processing Phases table lists the six CA Culprit processing phases and their functions. The CA Culprit System Diagram illustrates these processing phases. Introduction contains a detailed description of each processing phase.

Files that are assigned to each processing phase at a z/OS, z/VSE, z/VM installation appear in the tables under Default File Assignments for z/OS, z/VSE, and z/VM Installations and Default File Assignments for z/VSE Installations. These files are used during each processing phase as follows:

Precompile Phase

The precompile (CULP0) phase generates two output files. SYS004 (z/OS, z/VSE, z/VM) or the SYSLST system file contains the Sequential Parameter Listing. SYS005 contains unsorted user input parameters and statistics records that are used to determine resource requirements in subsequent processing phases.

Parameter Sort Phase

The parameter sort phase sorts all run parameters according to CA Culprit's standard sort. These are stored in SYS005.

Note: (z/VM only) To interface CA Culprit with external sort packages, see the CA IDMS Installation Guide for your operating system guide.

Compile Phase

The compile (CULL) phase generates a series of machine-language subroutines for each report. If errors are detected during this phase, appropriate compilation diagnostics are output on the Input Parameter Listing, which is stored in SYS004 at z/OS, z/VM, and z/VSE installations.

Extract Phase

The extract (CULL) phase reads the input data file or files, starting with SYS010, and the sorted parameter file from SYS005. In a database access run, the extract phase reads a key file from SYS002.

This phase writes information that pertains to totaling and output fields to the extracted items and statistics file. Items for reports that require sorting are written to file SYS006; items for reports that do not require sorting are written to file SYS008. The extract phase also generates and prints run-time error messages.

Data Sort Phase

The data sort phase sorts record items contained in the extracted items and statistics file (SYS006) and returns the sorted items to the same file.

Note: (z/VM only) To interface CA Culprit with external sort packages, see the CA IDMS installation guide for your operating system guide.

Output Phase

The output (CULE) phase reads the sorted extracted items and statistics file (SYS006) and the unsorted extracted items file (SYS008) for those reports that do not require sorting. This phase outputs printed reports to SYS004; reports written to tape or disk to SYS020, SYS021, and so on; reports written to CARD to SYSPCH; and reports written to special forms to SYS030, SYS031, and so on under z/OS, z/VM and to SYS004 under z/VSE.

The default file names listed in the tables under Default File Assignments for z/OS, z/VSE, and z/VM Installations and Default File Assignments for z/VSE Installations may not be appropriate for some installations. In these cases, the default file assignments can be changed by altering information stored on the installation's PROFILE CSECT. The installation default can also be altered at runtime (for that run only) with five-step JCL for file SYS010 in the CULP2 step and for SYS004 in the CULP4 step.

Note: For more information about PROFILE CSECT, see the CA IDMS Installation Guide for your operating system.

Under z/VSE, users can make use of a standard label track for label and extent information on CA Culprit files. In these cases, the installation's PROFILE CSECT may be altered. For example, a standard label track can be established for the file usually assigned to SYS005 by coding the following JCL statements:

// DLBL     WORKPARM,'PARMS',0
// EXTENT SYS036,123456,,,190,19

The line that refers to file SYS005 in the PROFILE CSECT must be changed to reflect the new file name and logical unit number.

CA Culprit Processing Phases

Processing Phases* Processing	Function I/O
Precompile (CULP0)	Performs preprocessing functions on CA Culprit parameters
Parameter sort	Sorts the CA Culprit parameters
Compile (CULL)	Generates machine-language subroutines for each report
Extract (CULL)	Reads the input file or files and writes totaling code and edit-control information to the extracted items and statistics file
Data sort	Sorts all items on the extracted items and statistics file
Output (CULE)	Performs automatic totaling and produces printed reports and output files

* Alternative names for each processing phase are included in parentheses ().

CA Culprit System Diagram

                     ┌─────────────┐
                     │ PARAMETERS  │
                     └─────┬───────┘     ┌─────────────┐
                           │             │ SEQUENTIAL  │
   ┌───────────┐     ┌─────▼───────┐     │ PARAMETER   │
   │  COPIED   ├─────► PARAMETER   ├─────► LISTING AND │ PRECOMPILE PHASE
   │PARAMETERS │     │ VALIDATION  │     │ PRELIMINARY │     (CULP0)
   └───────────┘     └─────┬───────┘     │ DIAGNOSTICS │
                           │             └─────────────┘
                     ┌─────▼───────┐
                     │ PARAMETER   │                     PARAMETER SORT
                     │   SORT      │
                     └─────┬───────┘
                           │             ┌─────────────┐
                     ┌─────▼───────┐     │ INPUT       │ COMPILE PHASE
                     │ BUILD CODE  ├─────► PARAMETER   │    (CULL)
                     └─────┬───────┘     │ LISTING     │
   ┌───────────┐           │             └─────────────┘
   │           │     ┌─────▼───────┐     ┌─────────────┐
   │   INPUT   ├─────► EXTRACT DATA├─────► RUNTIME     │ EXTRACT PHASE
   │           │     └─────┬───────┘     │ MESSAGES    │    (CULL)
   └───────────┘           │             └─────────────┘
                           ▼
                 No       SORT      Yes
         ┌───────────   <   REQUIRED  >    ───────┐
   ┌─────▼─────┐           ?            ┌─────▼──────┐
   │ NO SORT   │                        │  UNSORTED  │
   │EXTRACTED  │                        │  EXTRACTED │
   │  ITEMS    │                        │    ITEMS   │
   │           │                        │     AND    │
   │           │                        │ STATISTICS │
   └─────┬─────┘      ┌───────────┐     └─────┬──────┘
         │            │   SORT    ◄───────────┘
         │            │           ├───────────┐          DATA SORT
         │            └───────────┘           │
         │                              ┌─────▼──────┐
         │                              │  SORTED    │
         │                              │ EXTRACTED  │
         │                              │   ITEMS    │
         │                              │    AND     │
         │            ┌───────────┐     │ STATISTICS │
         │            │ EDIT AND  │     └─────┬──────┘
         └────────────►   TOTAL   ◄───────────┘
                      │PROCESSING │                      OUTPUT PHASE
                      └─────┬─────┘                        (CULE)
                        ┌───▼─────┐
                       ┌┴────────┐│
                      ┌┴───────┐ │
                      │REPORTS │
                      │

Default File Assignments for z/OS, z/VSE, and z/VM Installations

Phase	Mode	Linkname
Precompile	Output	SYS004 or SYSLST system file	Sequential Parameter Listing; preprocessor diagnostics
	Output	SYS005*	Unsorted, reformatted user parameters and statistics records
Parameter sort	Input	SYS005	Sorted, reformatted user parameters and statistics records
	Output	SYS005	Sorted, reformatted user parameters and statistics records
Compile/ Extract	Input	SYS002	Key file for database access runs
	Output	SYS004 or SYSLST system file	Input Parameter Listing; compilation diagnostics; runtime error messages (from extract phase)
	Input	SYS005	Sorted, reformatted user parameters and statistics records
	Output	SYS006*	Unsorted control records and report items for those reports requiring sorting
	Output	SYS007	Generated sort-control statements
	Output	SYS008	Report items for unsorted reports
	Input	SYS010, SYS011, etc.	User input file(s)
Data Sort	Input	SYS006	Sorted control records and report items
	Output	SYS006	Sorted control records and report items
	Input	SYS007	Generated sort-control statements
Output	Output	SYS004	Printed reports; error messages
	Input	SYS006	Sorted control records and report items
	Input	SYS008	Report items for unsorted reports
	Output	SYS020, SYS021, etc.	Nonprinted output for file types PS and IS (each output file is assigned sequentially, starting with SYS020)
	Output	SYS030, SYS031, and so on	Special forms reports (each report is assigned to a sequential output file, starting with SYS030)
	Output	SYSPCH	Card output

* z/VM users must use an external sort package to sort these files.

Default File Assignments for VSE Installations

Processing Phase	I/O Mode	File- Name	Logical Unit	Description
Precompile	Output		SYS004	Sequential Parameter Listing; preprocessor diagnostics
	Output	SYS005	SYS005	Unsorted, reformatted user parameters and statistics records
Parameter sort	Input	SYS005	SYS005	Sorted, reformatted user parameters and statistics records
	Output	SYS005	SYS005	Sorted, reformatted user parameters and statistics records
Compile/ Extract	Input	SYS002	SYS002	Key file for database access runs
	Output		SYS004	Input Parameter Listing; compilation diagnostics; runtime error messages (from extract phase)
	Input	SYS005	SYS005	Sorted, reformatted user parameters and statistics records
	Output	SYS006	SYS006	Unsorted control records and report items for those reports requiring sorting
	Output	SYS007	SYS007	Generated sort-control statements
	Output	SYS008	SYS008	Report items for unsorted reports
	Input	SYS010, SYS011, etc.	SYS010, SYS011, etc.	User input file(s)
Data sort	Input	SYS006	SYS006	Sorted control records and report items
	Output	SYS006	SYS006	Sorted control records and report items
	Input	SYS007	SYS007	Generated sort-control statements
Output	Output		SYS004	Printed reports; error messages
	Output	SYS004		Special forms reports (file type NS)
	Input	SYS006	SYS006	Sorted control records and report items
	Input	SYS008	SYS008	Report items for unsorted reports
	Output	SYS020, SYS021, etc.		Nonprinted output for file types PS and IS (each output file is assigned sequentially, starting with SYS020)
	Output	SYSPCH		Card output