More information:
Purpose
OUTPUT parameters describe the physical characteristics of output reports or files, such as the number of characters per line, number of lines per page, and output file type. Additionally, the user can specify either a details-only or totals-only report.
Syntax
Col 2 ▼ ►►─── nnOUTput ─┬───────────────────────────────┬──┬─────┬────────────────────► └─ record-size ─┬──────────────┬┘ ├─ T ─┤ └─ block-size ─┘ └─ D ─┘ ►─┬──────────────────────────────────────────────┬───────────────────────────► ├─ PS ─┬───────────────────┬───────────────────┤ │ └─ ( device-type ) ─┘ │ ├─ IS ─┬───────────────────┬───────────────────┤ │ └─ ( device-type ) ─┘ │ ├─ CARD ───────────────────────────────────────┤ ├─ NS ─┬────────────────┬──────────────────────┤ │ └─ ( forms-id ) ─┘ │ └─ UM ( module-name ─┬──────────────────┬─ ) ──┘ └─ ,special-value ─┘ ►─┬─────────────────────────────────────┬───┬───────────────────────┬────────► └─ DD = ─┬─ ddname ─────────────────┬─┘ └─ LP = lines-per-page ─┘ ├─ file-name logical-unit ─┤ └─ linkname ───────────────┘ ►─┬──────────────────┬───────────────────────────────────────────────────────►◄ └─ LT = ─┬─ S ◄ ─┬─┘ └─ N ───┘
Syntax Rules
Identifies the report associated with the OUTPUT parameter.
It is a 2-digit number in the range 00 through 99 and must be coded starting in column 2.
Specifies the parameter type. It must be coded starting in column 4.
Specifies the output record size for the report. It is coded in any column after OUT or OUTPUT. The default value for record-size is 132 bytes or the value specified on the PROFILE parameter for the run.
For printed and card output, CA Culprit adds an extra byte to the value of record-size to accommodate a carriage control character or stacker select character, respectively. The extra byte precedes the data in the output record.
Depending on the operating system and file type (see below), the following considerations apply:
Specifies the size of a physical block of output records. In a z/VSE environment, this parameter must be specified for file types PS and IS (see below); under z/OS and z/VM block size serves for documentation purposes only.
The maximum block size is 32,760 bytes. Additionally, block-size must not exceed the track capacity of the applicable disk device.
Specifies a totals-only (T) report or a details-only (D) report. If this parameter is not specified, CA Culprit prints both total and detail lines.
Specifies the file type or organization of the output file; if this parameter is not specified, the output is a printed report.
Valid specifications appear below:
Specifies sequential file output. Device-type is an optional qualifier that must be enclosed in parentheses. Possible values for device-type are TAPE, 2311, 2314, 3310, 3330, 3340, 3350, 3370, 3375, 3380, or FBA.
Note: Under z/OS and z/VM, users can specify device-type for documentation purposes. Under z/VSE, CA Culprit determines the device type if the file is assigned to a particular device in execution JCL. CA Culprit requires device-type to be specified in either execution JCL or on the OUTPUT parameter; this rule applies even with a tape or disk management system (for example, TFAST, DFAST) that may ignore the assignment.
z/OS, z/VSE, and z/VM users can create variable-length output by using a PS output file type. Execution JCL for the output file must specify RECFM=V OR VB. The output lines contain the record descriptor word (RDW) in the first four bytes of the file; bytes 1-2 hold the record length and bytes 3-4 hold binary zeros. If the output records are the same as the input records, CA Culprit rewrites the input RDW as the output RDW. If a new RDW is required for output, CULLUS33 (numeric field conversion), a CA-supplied procedure module, can be used to convert the calculated output field length into a binary number at run time.
Note: For more information on using this module, see the CA Culprit for CA IDMS User Modules Guide.
Specifies indexed sequential (ISAM) file output. Device-type is an optional qualifier that must be enclosed in parentheses. Possible values for device-type are 2311, 2314, 3310, 3330, 3340, 3350, 3370, 3375, 3380, or FBA.
When IS is specified, a SORT parameter is required, and the primary sort field must appear on a type 5 edit parameter (see SORT Parameter—Overview and Edit Parameters—Overview). A details-only report (D) should be specified on the OUTPUT parameter to prevent automatic totaling; otherwise, a CA Culprit ISAM error may occur.
Note: Under z/OS and z/VM users can specify device-type for documentation purposes. Under z/VSE, CA Culprit determines the device type if the file is assigned to a particular device in execution JCL. CA Culprit requires device-type to be specified in either execution JCL or on the OUTPUT parameter; this rule applies even with a tape or disk management system (for example, TFAST, DFAST) that may ignore the assignment.
Specifies an output card file. If CARD is specified, record size and block size specifications can be omitted.
Note: (z/OS and z/VM only) Users must specify RECFM=FA or FBA and LRECL=81 in execution JCL for SYSPCH because the output record for CARD output includes a stacker-select character. Alternatively, a PS output file type can be specified; CA Culprit will direct output to the default or specified ddname. Execution JCL provides a list of default ddnames for output files.
Specifies output on special forms. Forms-id specifies the type of special form. It is a 1- to 10-character identifier that must be enclosed in parentheses. Identifiers that contain special characters (that is, anything other than letters, numbers, or hyphens) must be enclosed in single quotation marks within parentheses.
The effect of forms-id depends on the SF= keyword coded on the PROFILE parameter.
Operating system considerations appear below:
Note: For details on using this module, see the CA Culprit for CA IDMS User Modules Guide.
Specifies that edited output lines are passed to an output module for special handling. Operating system considerations appear below:
Specifies a 2-byte value optionally passed to an output module. The value of special-value and the type of data contained in this specification vary, depending upon the needs of the output module.
Note: For more information on coding special values with CA-supplied output modules, see the CA Culprit for CA IDMS User Modules Guide.
Specifies the name of the output file.
Execution JCL contains a list of default ddnames and filenames. When the DD= keyword expression is specified for a tape or disk report in a CA Culprit run, it must be specified on the OUTPUT parameter for all tape or disk reports in the run.
Specifies the name of the DD statement in z/OS execution JCL or FILEDEF statement in z/VM JCL that describes the output file. This keyword expression is not valid if the file type is omitted (that is, output is a printed report).
Specifies the file name of the output file in a z/VSE environment and the logical unit number of the device that receives the output file.
If DD = file-name is specified, logical-unit must also be specified. Logical-unit is a number in the range 0 through 255.
In a z/VSE environment, a DD= specification is invalid when either the file type is omitted (that is, output is a printed report) or the file type is CARD.
Specifies the maximum number of printed lines for each report page. This specification applies only to printed reports and output modules as follows:
The following considerations apply to lines-per-page:
When the specified number of lines is reached, CA Culprit prints title and header lines (if any) at the top of a new page, followed by detail and total lines. The line count is reset to zero.
Specifies the label type for tape file output as follows:
Examples
Sample OUTPUT parameters are shown and described below.
Example 1
25OUT 120 LP=40
Report 25 is a printed report that contains 120 characters on each line. Each page of the report contains up to 40 lines classified as detail lines, total lines, and break lines associated with these edit lines; additionally, header lines and a title line are printed if they were specified for Report 25.
Example 2
99OUTPUT T CARD
Report 99 is output to a card file. The report contains only total lines.
Example 3
02OUT 140 700 D PS(TAPE) DD=SYS036,36 LT=N
In a z/VSE environment, a sequential output file is written to an unlabeled tape; the file, described on DD statement SYS036, is assigned to logical unit SYS036. The file contains 140-byte fixed-length records; each block contains 5 records. The records contain details-only information.
Example 4
01OUTPUT 70 NS(INVOICE) LP=28 DD=SYS018
Report 01 is printed on special forms. Each page of Report 01 contains 28 lines of 70 characters. CA Culprit writes this report to the file described on DD statement SYS018. DD= is a valid specification for special forms output, although it is not valid for standard printed output.
Under z/OS and z/VM, the special forms specification serves for documentation purposes only, because execution JCL handles forms control. CA Culprit does not reprint the first page and does not prompt the operator in a z/OS environment.
Example 5
44OUTPUT D UM(DTAILREP) LP=55
Detail lines for Report 44 pass to a user-written output module, DTAILREP. CA Culprit inserts a page eject after every 55 lines.
|
Copyright © 2014 CA.
All rights reserved.
|
|