The following is sample JCL that executes Finalist with the Finalist driver program (FINALIST) on a z/OS platform.
Note: Finalist requires a region size of approximately
100M. Region size will vary depending on options
selected.
1 //stepname EXEC PGM=FINALIST,REGION=0M
2 //STEPLIB DD DSN=user.loadlib,DISP=SHR
// DD DSN=CEE.SCEERUN,DISP=SHR
// DD DSN=CEE.SCEERUN2,DISP=SHR
3 //CBDATA DD DSN=finalist.datafile,DISP=SHR
4 //CBCTYST DD DSN=finalist.citystate,DISP=SHR
//* EWS FILE
//CBEWS DD DISP=SHR,DSN=finalist.EWSFILE
//* ELOT FILE
//LTDATA DD DISP=SHR,DSN=lot.DATAFILE
//* LACS FILES
//LLKDB DD DISP=SHR,DSN=hlq.FINALIST.LLKDB
//LLKSUD DD DISP=SHR,DSN=hlq.FINALIST.LLKSUD
//* DPV FILES
//DPVDB DD DISP=SHR,DSN=hlq.FINALIST.DPVDB
//DPVSDB DD DISP=SHR,DSN=hlq.FINALIST.DPVSDB
//DPVHDB DD DISP=SHR,DSN=hlq.FINALIST.DPVHDB
//DPVSUD DD DISP=SHR,DSN=hlq.FINALIST.DPVSUD
//* SUITELINK FILES
//SLKDB DD DISP=SHR,DSN=hlq.FINALIST.SLKDB
//RDIDB DD DISP=SHR,DSN=hlq.FINALIST.RDIDB
//PRCSLYDB DD DISP=SHR,DSN=hlq.FINALIST.PRCSLYDB
5 //PBFNJOB DD *
; These cards are sample JOB cards
[FILES]
fInput=INFILE
fDefinition=PBFNDEF
fOutErrorsFile=BADFILE
fOutValidFile=GOODFILE
fOutAllFile=OUTFILE
fConfigFile=PBFNCFG
[OPTIONS]
cInputFileType=MFFIXED
cRecSz=600
jAttach=no
6 //PBFNDEF DD *
; These cards are sample DEF cards
[INPUT]
iFirm=278,40
iUrban=318,28
iAddress1=346,64
iAddress2=410,64
iCity=474,42
7 //PBFNCFG DD *
--Sample config cards
FILE SECTION:
--------------
CITY DIRECTORY FILENAME = CBCTYST
ZIP+4 DIRECTORY FILENAME 1 = CBDATA
CASS SECTION:
--------------
BATCH REPORT FILENAME = SYSFINAL
3553 REPORT FILENAME = SYSPRT7
PRODUCT SECTION:
------------------
SOFTWARE KEY = your software key
REPORT SECTION:
------------------
REPORT FILENAME = SYSPRT3
REPORT TITLE = FINALIST REPORT FILE FROM PBFN.CFG
Address Detail Report PAGE LEN = 60
Address Detail Report MAX REC = 1000
Address Detail Report NTH REC = 1000
Address Detail Report TYPE = ON
Address Detail Report ISOL = ON
Address Detail Report SUGG = ON
Address Detail Report INFO = ON
LOG MSG SECTION:
-------------------
LOG FILENAME = SYSPRT1
LOG LEVEL = 3
8 //INFILE DD DSN=user.input.file,DISP=SHR
9 //OUTFILE DD DSN=user.output.file,DISP=SHR
10 //GOODFILE DD DSN=user.optional.file,DISP=SHR
//BADFILE DD DSN=user.optional.file,DISP=SHR
11 //SYSPRINT DD SYSOUT=*
12 //SYSFINAL DD SYSOUT=*
13 //SYSPRT1 DD SYSOUT=*
14 //SYSPRT3 DD SYSOUT=*
15 //SYSPRT7 DD SYSOUT=*
16 //EXCPIN DD *
17 L1CANTEN CANTON RP356
/*
//Enter the values that appear in capital letters exactly as shown and in the same logical sequence. Enter the values that appear in lower-case letters with the appropriate substitutions to meet your installation requirements. A number appears to the left of each statement that contains a user-defined variable. These numbers correspond to the following descriptions.
| Statement Number | Description |
|---|---|
| 1 | This statement executes FINALIST. Enter a statement name for "stepname," and any other values required for your site. |
| 2 | This statement identifies the load library containing the Finalist driver, programs, and subroutines. Replace "user.loadlib" with the name of the library containing the Finalist programs and subroutines. You may also need to specify the names of your LE runtime libraries. |
| 3 | This statement identifies your Finalist Data File on disk. Replace "finalist.datafile" with the name of your Data File. |
| 4 | This statement identifies your Finalist City/State File on disk. Replace "finalist.citystate" with the name of your City/State File. |
| 5 | This statement identifies the JOB cards necessary to run FINALIST. |
| 6 | This statement identifies the DEF cards necessary to run FINALIST. In this case the JOB card specified PBFNDEF for the DEF cards. It could have specified a different DD name. |
| 7 | This statement identifies the configuration cards necessary to run FINALIST. In this case the JOB card specified PBFNCNFG for the configuration cards. It could have specified a different DD name. |
| 8 | This statement defines your input name-and-address file as identified by the JOB card. It could have specified a different DD name. |
| 9 | This statement defines your output name-and-address file. It could have specified a different DD name. |
| 10 | This statement defines additional output file(s). It could have specified different DD names. |
| 11 | The SYSPRINT statement identifies the writer (print) class for the Finalist driver program (FINALIST). It contains a list of the parameters presented to the input and a list of options in effect for this run. |
| 12 | The SYSFINAL statement identifies the writer (print) class for Finalist. It contains the Finalist Batch Report. |
| 13 | This statement identifies where the Finalist system will write any error messages. |
| 14 | This statement identifies the location of optional reports. |
| 15 | This statement identifies the writer (print) class for the USPS Form 3553 (CASS Summary Report). |
| 16-17 | Statement 16 activates the exceptions table processing logic when running the Finalist system Data File. Statement 17 is a sample entry to the exceptions table. You can also have exceptions table processing as a separate data set instead of in-stream data. If you use a separate data set, the record length must be 80. To use Finalist without the exceptions table, either omit these two statements or use the following single statement instead of statement 16 and 17: //EXCPIN DD DUMMY |