Sample JCL for Starting ARCMAIN from z/OS
The following sample JCL shows how to start Teradata ARC from z/OS:
//ARCJOB PROC ARCPARM=,DBCPFX=, //USERJOB JOB <job info> //ARCJOB PROC ARCPARM=,DBCPFX= // DUMP=DUMMY,DUMPDSN=,DSEQ=,DVOL=, // RESTORE=DUMMY,RSTRDSN=,DBCLOG= //* //STEP1 EXEC PGM=ARCMAIN // PARM='&ARCPARM' //STEPLIB DD DSN=&DBCPFX..AUTHLOAD, // DISP=SHR //ARCHIVE DD &DUMP,DSN=&DBCPFX..&DUMPDSN,DISP=(,CATLG), // UNIT=TAPE,LABEL=(&DSEQ,SL), // VOL=SER=(&DVOL) //ARCIN DD &RESTORE,DSN=&DBCPFX..&RESTORE&RSTRDSN,DISP=OLD //DBCLOG DD DSN=&DBCPFX..&DBCLOG,DISP=OLD //SYSPRINT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* // PEND //* //S1 EXEC ARCJOB,ARCPARM='SESSIONS=100 HEX', // DBCPFX=DBCTEST,DUMP='DUMP.DATA',DSEQ=1, // DVOL='TAPE01,TAPE02',DBCLOG='ARCLOG.DATA' //SYSIN DD DATA,DLM=## LOGON DBC,DBC ARCHIVE DATA TABLES (PERSONNEL) ALL, RELEASE LOCK, INDEXES FILE=ARCHIVE; LOGOFF; ##
Starting with ARCMAIN 14.10, ARCMAIN writes a new format archive data set which always has the attribute DCB=RECFM=VBA. ARCMAIN 14.10 will read archive data sets of the new format and the old format, which it recognizes by the data set attribute DCB=RECFM=U.
The new archive data set format is not compatible with the old archive data set format. ARCMAIN depends on recognizing the archive data set format from the RECFM DCB attribute of the data set. On z/OS, if the RECFM DCB attribute is specified in the DD statement which identifies the archive input data set, that specification overrides and hides the actual RECFM DCB attribute of the data set itself, potentially misleading ARCMAIN as to the archive format.
Starting with ARCMAIN 13.10, the RECFM, LRECL, and BLKSIZE DCB attributes for output archive data sets are set by default to optimum values for the output device supplied by z/OS. With ARCMAIN 13.10 and later, Teradata recommends removing RECFM, LRECL, and BLKSIZE DCB attribute specifications from all archive data set DD statements, whether ARCMAIN is reading or writing the archive data set.
The JCL example uses these syntax elements:
- DUMP is the archive keyword, with DUMPDSN as the data set name for the archive output file. DUDISP specifies whether to KEEP or CATLG the output file.
- DBCLOG is the log file data set name created by Teradata ARC.
- DBCPFX is the high-level qualifier for Teradata Database load libraries.
The database DBCLOG card indicates the restart log file, and the data set must have RECFM either F, FBS or FS. For better results, set BLKSIZE near 32K. The ARCHIVE card is not needed in this example; it is shown for illustration purposes. Create and catalog database DBCLOG once and reuse it as needed. To create the database DBCLOG file, see the file on the release tape called ARCLOG, in dbcpfx.PROCLIB.