More information:
Purpose
Defines the general characteristics of each input file to be read.
The input file can be a sequential tape or disk file, indexed sequential disk file, card file, or VSAM file. The file can also be defined to IDD. One INPUT (IN) parameter is required for each file read. CA Culprit can read and process up to 32 files per run.
During processing, CA Culprit places input data in a contiguous area called the input buffer. If a single input file is read, the buffer contains a single occurrence of the input record; when multiple input files are read, the buffer contains one record from each file.
In a match-file run, CA Culprit establishes a status byte for each input file (a file-specific status byte) and a composite indicator (M*ID) that reflects the status of any or all input files. The file-specific status byte appears in the input buffer following each input record; the composite indicator appears in the last byte position of the input buffer.
Note: For more information on match-file runs, see the CA Culprit for CA IDMS User Guide.
Syntax
Col 2 ▼ ►►─── INput ─┬────────────────────────────────────────────┬───────────────────► └─ record-size ─┬─ F ◄──┬───┬──────────────┬─┘ ├─ V ───┤ └─ block-size ─┘ └─ U ───┘ ►─┬──PS ◄──┬───────────────────┬───┬───┬─────────────────────┬───────────────►◄ │ └─ ( device-type ) ─┘ │ │ ┌─────────────────┐ │ ├─ IS ───┬───────────────────┬───┤ └─▼─ input-options ─┴─┘ │ └─ ( device-type ) ─┘ │ ├─ CARD ─────────────────────────┤ ├─ VS ─┬──────────────────┬──────┤ │ └─ ( ─┬─ KS ─┬─ ) ─┘ │ │ ├─ ES ─┤ │ │ └─ RS ─┘ │ └─ UM ( module-name ) ───────────┘
Expansion of Input-options
►►─┬────────────────────────────────────┬──┬────────────────────────────────┬─► └ DD = ─┬┬─ SYS010 ◄────────────────┬┤ └─ DD2 = file-name logical-unit ─┘ │└─ ddname ─────────────────┘│ ├┬─ SYS010,010 ◄ ───────────┬┤ │└─ file-name logical-unit ─┘│ └┬─ SYS010 ◄ ───────────────┬┘ └─ linkname ───────────────┘ ►─┬───────────────────┬──┬─────────────────┬─────────────────────────────────► └─ MB = ─┬─ Keep ──┬┘ └─ PW = password ─┘ └─ Dummy ─┘ ►─┬───────────────────────────────────────────────────────────────┬──────────► └─ LT = ─┬─ S ◄──┬─┬──────────────────────────────────────────┬─┘ ├─ N ───┤ └─ skip-file-count ─┬────────────────────┬─┘ └─ A ───┘ └─ skip-block-count ─┘ ►─┬──────────────────────────┬──┬────────────────────────────────┬───────────►◄ │ ┌───────────────┐ │ └─ FN = file-name ─┬───────────┬─┘ └─ MK = ─▼─ field-name ──┴─┘ └─ version ─┘
Syntax Rules
Specifies the parameter type. It must be coded starting in column 2.
Specifies the size of the input record. Record-size must be a number in the range 1 through 32767; this value is coded in any column after IN or INPUT. This value is required for all file types (see below) except CARD.
For variable-length records, record-size is the length of the longest record in the file; this value must include the 4-byte record descriptor word.
Specifies that the input file contains fixed-length records. F is the default.
Specifies that the input file contains variable-length records.
Specifies that the length of the records in the input file is undefined.
Specifies the size of a physical block of records. This value must be a number in the range 1 through 32767. The following considerations apply to block-size:
Specifies sequential file organization. This is the default. 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, and FBA.
Specifies indexed sequential file organization. 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, and 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. Device-type must be specified on the INPUT parameter or assigned in execution JCL. This rule applies even for a tape or disk management system (for example, TFAST, DFAST) that ignores the assignment.
Specifies an input card file. If CARD is specified, all other INPUT parameter specifications can be omitted.
(z/OS, z/VSE, and z/VM only) Indicates a virtual storage (VSAM) file organization and can be qualified in one of three ways.
If one of the qualifiers is specified, it must be enclosed in parentheses; for example, VS(RS).
Indicates a key-sequenced VSAM file. This is the default.
Indicates an entry-sequenced VSAM file.
Indicates a relative-record VSAM file.
Specifies a user input module. The module name must be enclosed in parentheses, and is specified as follows:
Note: For more information on user input modules, see the CA Culprit for CA IDMS User Modules Guide.
See the expanded syntax below.
Specifies the ddname (z/OS and z/VM) or filename (z/VSE) for the input file.
In a match-file run, the second and subsequent input files default to SYS011, SYS012, and so forth. If DD= is specified, it must appear on the INPUT parameters for each file in the run. These files must be defined in the execution JCL.
Note: Ddname, file-name and logical-unit, or linkname-a specifications must not conflict with CA Culprit system file assignments; these assignments can be changed, as described in the CA IDMS Installation Guide for your operating system.
(z/OS and z/VM only) Specifies the name assigned to the DD statement that defines the input file; the default is SYS010.
(z/VSE only) Specifies the name assigned to the input file in execution JCL and the number of the device on which the appropriate file resides; the default filename is SYS010.
Logical-unit must be a number in the range 0 through 255. When DD=file-name is specified, logical-unit must also be specified. The default logical unit number is SYS010.
z/VSE users can use system standard label information as an alternative to inserting input file TLBL or DLBL and EXTENT JCL statements in the CA Culprit job stream. If filenames and logical unit numbers used in the standard label information area differ from CA Culprit input file requirements, then a DD= specification can be used to modify CA Culprit requirements, as shown in the following table.
(BS2000/OSD only) Specifies the name associated with the input file by means of the /ADD-FILE-LINK command; the default is SYS010.
|
System Standard Label Information |
DD= Statement |
Explanation |
|---|---|---|
|
// TLBL SYS010,'TAPE-DATA' // ASSGN SYS010,X'282' |
None required |
The label information agrees with the CA Culprit input file default, so no specification is required. |
|
// TLBL SYS025,'TAPE-DATA' // ASSGN SYS010,X'282' |
DD=SYS025,010 |
The specification uses the same filename as in the standard label information (SYS025) and specifies the default logical unit number (010). SYS010 must be assigned to the appropriate tape device. |
|
// TLBL TAPEIN,'TAPE-DATA' // ASSGN SYS015,X'282' |
DD=TAPEIN,15 |
The specification uses the same filename as in the standard label information (TAPEIN) and indicates a logical unit number of 015. SYS015 is assigned to the appropriate tape device. |
|
// DLBL MASTER,'DISK-FILE',0 // EXTENT SYS020,111111,,,19,380 // ASSGN SYS020,DISK, VOL=PRODISK,SHR |
DD=MASTER,20 |
The specification uses the same filename as on the DLBL statement and the same logical unit number as on the EXTENT statement. SYS020 is assigned to the appropriate disk device. |
Note: The first three table entries are tape label examples; the fourth entry is a disk label example. Assignments can be either permanent or made at run time.
(z/VSE only) Specifies an alternating assignment for sequential tape or disk files. At run time, CA Culprit treats an end-of-file condition as if it were an end-of-volume condition; CA Culprit can therefore read multiple files of the same format as though they were part of a single file. The file type for these files must be PS.
File-name is the name of the alternating file. Logical-unit is a number in the range 0 through 255 that specifies the logical unit number.
Additional considerations for tape and disk files follow:
In response to a DD2= specification, CA Culprit prompts the operator for additional input at end-of-file for each file. If the operator's reply is N or n, normal end-of-file procedures apply; if the reply is Y or y, CA Culprit reads another file, as described above. CA Culprit performs label processing and special positioning for each file if these operations are requested.
Under z/OS and z/VM, CA Culprit performs alternate file processing (concatenation) through execution JCL.
Specifies input buffer options as follows:
Applies to match-file runs. When MB=KEEP is specified, CA Culprit retains a record in the buffer until a new record from the same file replaces it.
Note: For more information on match-file runs, see the CA Culprit for CA IDMS User Guide.
Specifies that a portion of the input buffer is to be reserved for special handling. The value of record-size on this INPUT parameter determines the size of the dummy area. Subsequent REC parameters define specific areas within the dummy area, as required by the CA Culprit program. Space is reserved in the input buffer according to where the MB=DUMMY request is encountered in the input stream.
Dummy buffer areas can be used by user procedure modules (see the CA Culprit for CA IDMS User Modules Guide) or to establish a storage area that is available to all reports in a CA Culprit run.
A unique 1- to 8-character password that can be inspected by a user input module.
If special characters are used (that is, characters other than letters, numbers, or hyphens), the password must be enclosed in single quotation marks. Hexadecimal literals must appear in the form X'password-string'.
Specifies label type information for PS (sequential) files:
(Default) Indicates standard labels.
Indicates that labels are omitted on a tape file. Under z/VSE, users can optionally specify a number of files and blocks of data to be skipped over when reading the tape.
Indicates the number of files (tape marks) to be skipped;
Indicates the number of blocks of data at the beginning of the file that are to be skipped. Both numbers must be in the range 0 through 32767.
Indicates standard and user-defined labels. This specification is invalid for match-file runs.
Specifies from one to four match keys for match-file processing. Field-name is discussed under REC Parameter?Overview.
Note: For more information on match-file runs, see the CA Culprit for CA IDMS User Guide.
Identifies a nondatabase file defined to IDD:
If this keyword expression is specified and appropriate values are stored in the Integrated Data Dictionary (IDD), IDD automatically supplies the file record size, record type, block size, file type, device type, or user module name and label type. IDD also automatically generates a REC parameter for every field referenced on other CA Culprit parameters if the field is in a record in the file.
If other specifications appear on an INPUT parameter that specifies FN=file-name, these specifications override values stored in IDD unless CA Culprit security is in effect.
The 1- to 32-character name of a file whose field definitions are to be used in subsequent CA Culprit parameters. If the file name contains anything other than letters, numbers, or hyphens, it must be enclosed in quotation marks.
Identifies the file version being accessed; the default is the highest existing version number for the named file.
Examples
Sample INPUT parameters are shown and described below.
Example 1
INPUT 80 DD=INPUT1
In a z/OS environment, input is a sequential file that contains 80-byte records. The file is identified in the execution JCL on the DD statement named INPUT1.
To define the same input file in a z/VSE environment, the block size (400) and logical unit (20) must also be specified as shown below:
INPUT 80 400 DD=INPUT1,20
Example 2
IN 324 V 328 PS(3350) DD=SYS015,231 LT=N,22
In a z/VSE environment, input is an unlabeled sequential file that is identified on DD statement SYS015. This file contains variable-length records; the size of the longest record is 324 bytes, including the 4-byte record descriptor word. The longest physical block is 328 bytes; this value includes the block control prefix. The file is stored on logical unit SYS231, a 3350 disk volume. The first 22 tape marks are bypassed as specified by the LT= keyword expression.
Example 3
INPUT 500 5000 PS DD2=SYS016,16
Input is obtained from two sequential files in the z/VSE environment. CA Culprit reads file SYS010 on default logical unit SYS010 and then reads file SYS016 on logical unit SYS016. CA Culprit continues to alternate between these files until the operator requests end-of-file conditions by responding with an N to a CA Culprit prompt. With disk files, the first file is read from SYS010, the second from SYS016, the third from SYS017, and so forth. At the end of each file, CA Culprit prompts the operator to specify another read operation, as appropriate.
Example 4
IN 120 UM(INTPROG) PW=LETMEIN *$THIS USER INPUT MODULE SUPPLIES ALL INPUT TO THIS RUN
User-written module INTPROG is a sequential input file composed of 120-byte fixed-length records; password verification is required to access INTPROG. To accommodate a comment, the user specified a continuation line by coding an asterisk (*) in column 1; a dollar sign ($) indicates a comment.
Example 5
INPUT FN=PAYROLL-MASTER
PAYROLL-MASTER is the name of a file defined to IDD. IDD automatically supplies the information CA Culprit requires to read the file (for example, record size, record type, and file type).
|
Copyright © 2014 CA.
All rights reserved.
|
|