Using JCL to execute File-AID/Batch

The JCL used to execute File-AID/Batch follows the same format and structure as a typical MVS batch job. The JCL must include a job statement, execute statement, and data definition statements for all input and output files.

File-AID/Batch can also be executed as a callable subroutine. See Execution Methods and Parameters for requirements.

The JCL used to execute File-AID/Batch is listed in the following figure. Each statement of the JCL is described below.

Related topics

Functions-and-modifiers

File-AID-Batch-parameters

JCL Required for File-AID Execution

 //JOBNAME   JOB  JOB CARD INFORMATION  
 //STEPNAME  EXEC PGM=FILEAID,REGION=8M
 //STEPLIB   DD   DSN=File-AID LOAD LIBRARY NAMES
 //STEPCAT   DD   DSN=CATALOG NAME
 //SYSPRINT  DD   SYSOUT=*
 //SYSLIST   DD   SYSOUT=*
 //SYSTOTAL  DD   SYSOUT=*
 //DDxx      DD   DSN=INPUT DATASET NAME
 //DDxxO     DD   DSN=OUTPUT DATASET NAME
 //DDxxRF    DD   DSN=REFORMAT DEFINITION DATASET NAME
 //DDxxRL    DD   DSN=RECORD LAYOUT DATASET NAME
 //DDxxRLN   DD   DSN=COMPARE NEW DATASET - RECORD LAYOUT DATASET NAME
 //DDxxXR    DD   DSN=XREF DATASET NAME (XREF MEMBER)
 //DDxxXRN   DD   DSN=COMPARE NEW DATASET - XREF DATASET NAME (XREF MEMBER)
 //DDxxSC    DD   DSN=SELECTION CRITERIA DATASET NAME (SC MEMBER)
 //DDxxSCN   DD   DSN=COMPARE NEW DATASET - SELECTION CRITERIA DATASET NAME (SC MEMBER)
 //DDxxCP    DD   DSN=COMPARE CRITERIA DATASET NAME
 //DDxxC     DD   DSN=NEW COMPARE DATASET NAME
 //DDxxCOn   DD   DSN=NEW COMPARE OUTPUT FILES
 //DDxxCSV   DD   DSN=COMMA SEPARATED VALUE OUTPUT FILES
 //ANYNAME   DD   DSN=OUTPUT DATASET NAME
 //SYSIN     DD   *
 (CONTROL CARDS)
 /*
 //

EXEC

Required statement that tells the operating system to execute program FILEAID.

We recommend specifying a region of 8M or greater to avoid any memory/shortage problems. The region size required is affected by the DCB parameter BUFNO coded on DD statements. The BUFNO= parameter coded explicitly on a DD statement will override the File-AID default of 6 or the installation defined default set at configuration time. For more information, see File-AID/MVS additional parameters (FAMVALL). The greater the number specified the higher region size is required at execution time.

If you specify PARM=TSO when printing PDS members, print output is formatted in 80 character mode and a new page is not started for each member. (For additional information, see TSO Execution Parameters.)

STEPLIB

Optional statement to use only when program FILEAID is not present in the normal link libraries of your system. Concatenate the load library (SXVJLOAD) and the customized load library (CXVJLOAD)

STEPCAT

Optional statement that points to a catalog that contains the data sets when the data sets reside in a catalog other than the system catalog. In most cases, STEPCAT may be eliminated or replaced with a JOBCAT statement.

SYSPRINT

Lists all submitted control cards, and all error and completion messages issued during execution. If SYSPRINT is not provided, File-AID dynamically allocates it. Define SYSPRINT as an output writer class (SYSOUT=*) or a sequential file.

SYSLIST

Optional statement to use when selecting data for hardcopy output. Define SYSLIST as an output writer class. If SYSLIST is not provided, File-AID dynamically allocates it. SYSLIST may optionally be defined as a sequential file.

Important

For SYSLIST, if the batch job is executing a Source or JCL compare with a wide detail report specified, the LRECL must be 183, and the BLKSIZE must be n*183.

SYSTOTAL

Optional statement used to receive a report showing comments and totals produced by any ACCUM parameters. Define SYSTOTAL as an output writer class (SYSOUT=*), or a sequential file.

Important

To direct SYSPRINT, SYSLIST, or SYSTOTAL to a data set, the DCB attributes are RECFM=FBM, LRECL=133 and BLKSIZE=n*133. Using an LRECL of 80 forces File-AID/Batch to produce output in 80 character mode. If PARM=TSO is specified, print data set attributes are modified to LRECL=80. (See “TSO Execution Parameters” on page 6-1 for additional information.) Any LRECL larger than 80 and less than 133 can truncate print lines and should be avoided. If the RECFM of the data set is not FBM, it will be modified to FBM by File-AID at execution time, unless install option displacement X’22’ is set to A, in which case the RECFM is changed to FBA.

DDxx

Describes the input data sets to File-AID. The xx value can be any number from 00 to 99 that matches a corresponding control card ($$DDxx). Access a maximum of 100 input data sets per execution. You must use at least one DDxx statement.

DDxxO

Defines an output data set to be created by a COPY, DROP or REFORMAT function. The xx value must match the xx value in the corresponding input data set (DDxx). Process a maximum of 100 output data sets per execution. The data sets can be on tape, cards, printers, or disks. Basic DCB information (RECFM, BLKSIZE, LRECL) is copied from the corresponding input data set unless otherwise specified. File-AID supports LRECL up to 32,760 and BLKSIZE up to the maximum for the device, such as 256K for 3590 tape unit.

DDxxRF

Defines a reformat definition data set created with File-AID online Reformat utility. Specify the PDS member name in parentheses. This DD is only required when using the REFORMAT function. The DD is generated from File-AID online option 9, Reformat, when processing in batch is requested.

DDxxRL

Defines a record layout dataset, a COBOL or PL/I copybook source, PDS, or a PANVALET or LIBRARIAN library to use with the FPRINT function or parameter or a formatted Compare function. You may specify the member name with the LAYOUT parameter or in the Compare Criteria dataset. This DD is required when using the FPRINT function or parameter and the RLPRINT parameter. This DD is also required whenever DDxxSC is present and the selection criteria member specifies FIELD_NUMBER for any field.

DDxxRLN

Defines a record layout dataset, a COBOL or PL/I copybook source, PDS, or a PANVALET or LIBRARIAN library to use with a formatted COMPARE for the COMPARE NEW dataset. You may specify the member name with the LAYOUT parameter or in the Compare Criteria dataset. This DD is also required whenever DDxxSC is present and the selection criteria member specifies FIELD_NUMBER for any field.

DDxxXR

Defines a record layout cross reference (XREF) dataset. Enclose the XREF member name in parens after the dataset name. This DD is generated from File-AID online option 5.1, Print Data, when layout usage is X (Use XREF). This DD is also required whenever DDxxSC is present and the selection criteria member specifies FIELD_NUMBER for any field.

DDxxXRN

Defines a record layout cross reference (XREF) dataset to use with a formatted Compare for the Compare New dataset. Enclose the XREF member name in parens after the dataset name. This DD is also required whenever DDxxSC is present and the selection criteria member specifies FIELD_NUMBER for any field.

DDxxSC

Defines a File-AID selection criteria data set. Enclose the selection criteria member name in parens after the dataset name. This DD is generated from File-AID online options, such as Search/Update, Print and Compare, when using selection criteria.

DDxxSCN

Defines a File-AID selection criteria data set to use for the Compare New dataset. Enclose the selection criteria member name in parens after the dataset name. This DD is generated from File-AID online option 10, Compare.

Note

When using selection criteria with JCL created prior to release 8.7.0, you must duplicate the DDxxSC statement to a DDxxSCN statement. This DDxxSCN statement will then apply the selection criteria to the new file. See JCL Required for File-AID Execution.

DDxxCP

Defines a data set containing the key information and compare criteria to be applied during a compare. This DD is generated from File-AID online option 10, Compare or coded per the instructions in Compare Criteria Control Cards.

DDxxC

Defines the new data set and member to be compared. This DD is generated from File-AID online option 10, Compare.

DDxxCOn

Defines n (1 - 6) File-AID Compare function output files. This DD is generated from File-AID online option 10, Compare.

DDxxCSV

Defines a Comma Separated Value (CSV) output file. This DD is generated from File-AID online option 3.1, Load Library Utility for the Batch processing option (see also LMODCLAS-LMC, LMODDIR-LMD, LMODMAPA-LMA, and LMODMAPN-LMN). For LMODCLAS, the output CSV file lists all PDSE Binder Classes of selected member(s). For LMODDIR, the output CSV file includes directory entry and link-edit attributes of selected member(s). For LMODMAPA and LMODMAPN, the output CSV file includes all CSECT MAP information, including directory entry and link-edit attributes, compiler options (COBOL or Enterprise PL/I), if selected (see also CPLRO ). The CSV file must be a sequential, variable data set with a minimum record length of 2769. Each field is enclosed in double quotes (") and separated by a comma (,).

ANYNAME

Optional statement that is only required with the USER function. Defines any output data set specified by the WRITE parameter of the USER function. Use any name. File-AID can create a default maximum of eight data sets per execution. To change the default value, and to allow the WRITE parameter to reference up to 99 data sets, see parameter MAXOUT-MO. Basic DCB information (RECFM, LRECL, BLKSIZE) is copied from the current open input data set unless otherwise specified.

The DD names DDxxM, DDxxRL, DDxxSC, DDxxXR, FAPRINT, FAUDCTL, FAUDWKF, SYSLIST, SYSPRINT, and SYSTOTAL are reserved for use by File-AID. Do not use for ANYNAME.

SYSIN

Defines the input control cards to process. Place all File-AID control cards after the SYSIN card. They must be in 80-character format, but may be stored on any type of physical sequential device. If no control cards are submitted, File-AID defaults to a COPY function for every pair of input and output data sets (DDxx and DDxxO) specified in the JCL.

The control statement ($$DD01) corresponds to the input data set (//DD01) and the output data set (//DD01O) because both contain the same value in the DDxx field.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*