Converting JCL to a file list
When you specify a data set that contains JCL, the data set is displayed on the Select DDNAME screen shown in following figure. From this data, you can select the ddnames to be converted to a file list. The parameters (space and catalog or SMS and DCB) associated with each selected ddname are also copied to the appropriate Edit File List screens.
The primary commands UP and DOWN or PF keys can be used to scroll the screen.
Information on the screen can be typed over; e.g., commented lines can be changed to uncommented lines and the I(nsert), R(epeat), and D(elete) line commands are also available when editing.
Select DDNAME Screen
COMMAND ===> SCROLL ===> CSR
LINE COMMAND: S (Select) PRIMARY COMMANDS: END (Process selected statements)
BR (Browse dataset) CAN (Quit without processing)
ED (Edit dataset) Edit (Edit JCL using ISPF Editor)
SEtup JOB Card EXP (Expand JCL procedures)
SELECT the DDNAMES to be copied to the allocate screen
SEL JCL DATA SET: 'PFHABCX.JCL.CNTL(TRIPROGM)'
--------------------------------------------------------------------------
''''' //ADSA99XA JOB (ACCNT),'USER',MSGCLASS=X,
''''' // NOTIFY=ADSA99X
''''' //*
''''' //STEP1 EXEC PGM=TRIMAINX,PARM='YES'
''''' //STEPLIB DD DSN=ADSA99X.WORK.LINKLIB,DISP=SHR
''''' //INFILE DD DSN=ADSA.CLASS.SOURCE(TRIDATA),DISP=SHR
''''' //OUTFILE DD SYSOUT=A,COPIES=3
''''' //*
''''' //STEP2 EXEC PGM=PROGRAM2
''''' //STEPLIB DD DSN=ADSA.TEST.LOAD,DISP=SHR
''''' //NEWFILE DD DSN=ADSA99X.NEW.OUT,DCB=(RECFM=FB,BLKSIZE=200),
''''' // SPACE=(TRK,(10,10)),DISP=(NEW,KEEP)
Use the primary commands as follows:
END
Copies the selected ddnames. After you enter the END command, but before the files are copied, any errors are reported. The errors must be corrected before the copy is performed.
CANcel
Cancels the ddname selection.
Edit
Accesses an ISPF edit session where you can make changes to your JCL.
EXPand
Expands references to cataloged, in-stream procedures and performs symbolic parameter replacement, making procedures available for use. See Things to Know About JCL Expansion for more information.
SEtup
Displays a screen on which you can enter and change the skeleton job card needed for the EXPAND function.
Use the line commands as follows:
S (Select)
Selects the DD statements to be copied to the file list. When you select DD statements, you are basically selecting the file names and all concatenated DD statements to be copied as a unit. Enter S on a line to select a single statement. Enter a beginning and ending SS to select all file names between the two entries. When you enter an S for an EXEC statement, all file names up to the next EXEC statement are selected. Any combination of these entries can be used to select all the files you require.
BR (Browse)
Displays the data set associated with the selected statement.
ED (Edit)
Displays the data set associated with the selected statement for editing.
Things to know about JCL expansion
There are two ways to expand the JCL:
- In one mode (job submission), the EXPAND command submits the current JCL as a job. If there are multiple jobs in the JCL, only the first job is processed; therefore, you should delete any jobs preceding the one you want to process.
If there is a job card present in the JCL, it is not used for this process. The SETUP command can be used to look at and change the job card that is used. Consider the following:- MSGCLASS, MSGLEVEL, and TYPRUN are supplied by the expand process and should not be included on the job card.
- The job card should be valid to avoid job-not-found or no-held-output conditions.
- Include only the minimum parameters required to pass the installation validation routines. Since the job does not actually run, extra parameters tend to cause undesired results, such as extra asynchronous messages to the terminal.
- In the other mode (direct expansion), Code Debug directly accesses the procedure libraries. For this to be possible, the installer must have provided the list of data sets containing the catalogued procedures and you must have read access to all of these libraries.
Unsupported keywords and subparameters
Not all JCL parameters in the JCL data set are copied to the file list; DEN is one, for example. The following JCL items are not supported:
- Special ddnames - JOBCAT, JOBLIB, STEPCAT, STEPLIB, SYSPROC
- Data sets extending onto more than five volumes
- Unresolved symbolic references
- Parameters not corresponding to fields on the Edit File List screens.
If a selected ddname contains parameters/keywords not specified on the Edit File List screens, the Allocate/Copy warning screen shown in the following figure is displayed.
Errors are identified by ddname, keyword, and JCL statement. If an error is found on a concatenated file, the name appears in the form ddname+nn.
Allocate/Copy (Errors) Screen
COMMAND ===>
LINE COMMAND: S (Select ) PRIMARY COMMANDS: CAN (Quit without processing)
WARNING: The following keywords and subparameters are not supported.
Press END to continue processing and ignore all these parameters
or Select a DD statement you wish to correct.
------------------------------------------------------------------------
''''' DDNAME: DOC1 KEYWORD: LABEL SUBPARAMETER:
JCL: // DISP=(NEW,CATLG,DELETE),LABEL=(,NL)
------------------------------------------------------------------------
''''' DDNAME: DOC2 KEYWORD: LABEL SUBPARAMETER:
JCL: // DISP=(NEW,CATLG,DELETE),LABEL=(,NL)
------------------------------------------------------------------------
''''' DDNAME: DOC3 KEYWORD: LABEL SUBPARAMETER:
JCL: // DISP=(NEW,CATLG,DELETE),LABEL=(,NL)
------------------------------------------------------------------------
The errors can be ignored by entering END. The JCL is displayed on the Edit File List 1 screen. To correct the errors, enter the S line command next to the ddname in question. The Select DDNAME 1 screen is displayed with the selected ddname at the top of the screen and the cursor positioned at the value in error. You can correct the errors from this screen.
By entering CANCEL, you are returned to the screen from which you entered the FAU.