Example of a KGUP job stream with non-existing data sets

Figure 1 shows an example of a panel in ISPF edit mode that contains a KGUP job stream where certain data sets did not exist previously.

Figure 1. KGUP JCL Set for Editing and Submitting (Files Do Not Exist)

 ISREDDE - SYS88218.T095045.RA000.LARSON.R0000003 ------------- COLUMNS 001 072
 COMMAND ===> _                                                SCROLL ===> CSR
 ****** ***************************** TOP OF DATA ******************************
 000001 //LARSON  JOB (ACCOUNT),'NAME',MSGCLASS=C
 000002 //*
 000003 //*
 000004 //*
 000005 //KGUP     EXEC PGM=CSFKGUP,PARM=('NOSSM')
 000006 //CSFCKDS  DD   DSN=LARSON.TEST.CSFCKDS,
 000007 //              DISP=OLD
 000008 //CSFIN    DD   DSN=LARSON.CSFIN.TESTDS2P(TEST2),
 000009 //              DISP=OLD
 000010 //CSFDIAG  DD   DSN=LARSON.TEST.CSFDIAG,
 000011 //              DISP=(,CATLG,CATLG),UNIT=SYSDA,
 000012 //              DCB=(RECFM=FBA,LRECL=133,BLKSIZE=13300),
 000013 //              SPACE=(TRK,(220,10),RLSE)
 000014 //CSFKEYS  DD   DSN=LARSON.TEST.CSFKEYS,
 000015 //              DISP=(,CATLG,CATLG),UNIT=SYSDA,
 000016 //              DCB=(RECFM=FB,LRECL=208,BLKSIZE=3328),
 000017 //              VOL=SER=TSO001,SPACE=(TRK,(60,10),RLSE)
 000018 //CSFSTMNT DD   DSN=LARSON.TEST.CSFSTMNT,
 000019 //              DISP=(,CATLG,CATLG),UNIT=SYSDA,
 000020 //              DCB=(RECFM=FB,LRECL=80,BLKSIZE=3200),
 000021 //              SPACE=(TRK,(60,10),RLSE)
 ****** **************************** BOTTOM OF DATA ****************************

The job stream contains information to create the diagnosis data set (CSFDIAG), key output data set (CSFKEYS), and the control statement output data set (CSFSTMNT) that did not previously exist. On the DISP parameter, the CATLG keyword specifies that you want the data set cataloged when the job ends normally and when the job ends abnormally. The unit parameter indicates the device you want the data set to reside on. The DCB parameter specifies the necessary data control block information such as the record format (RECFM), record length (LRECL) and block size (BLKSIZE).

When you submit the job, KGUP performs the functions you specified on the control statements. The functions KGUP performs change the CKDS. You can view the diagnostics data set to know whether KGUP successfully processed the control statements.