Using the edit file list screens
The parameters associated with each file in the file list are specified on the Edit File List screens.
If your installation does not use SMS to manage DASD data sets, the screens shown in following figure is displayed.
Edit File List Screens Without SMS
If your installation uses SMS to manage DASD data sets, the screens shown in following figure are displayed.
Edit File List Screens With SMS
The RIGHT and LEFT scrolling commands let you move from one screen to another. The UP and DOWN scrolling commands are also available. Each screen is numbered, and contains information for the following categories:
- Edit File List 1 - DDNAME, dsname, and disposition.
Edit File List 2 - Space and catalog parameters or NON-SMS parameters.
2A. Edit File List 2A - SMS parameters
- Edit File List 3 - DCB parameters.
You can enter the parameters manually or type over the existing parameters to change the values.
The Edit File List screens show primary and line commands at the top of each screen. Note that the primary commands listed on each screen may vary, depending on the manner in which the FAU is accessed.
The line commands are entered by typing over the line command area (leftmost column of each screen). You can delete, insert, or repeat lines to make changes to the file list. The primary and line commands are described as follows:
Primary commands
CANcel
Exits the FAU without allocating or saving the file list. You are returned to the previous screen.
COPY
Copies an existing file list, JCL, or CLIST. See the Using the COPY Command on Edit File List Screens for more information.
ALLOCate
Allocates the file list and returns you to the Edit File List screen.
SAVE
Saves the file list and returns you to the Edit File List screen.
END
Terminates the FAU. Depending on the way you entered the FAU, the END command also allocates and/or saves the file list.
HELP
Displays interactive HELP.
Line commands
Dn (Delete)
Deletes a line, where n is the number of lines to delete. The ddname on the line and all related parameters are deleted. The block form (DD) of the command can be used to delete a block of lines.
In (Insert)
Inserts a blank line, where n is the number of lines to insert.
Rn (Repeat)
Repeats the line, where n is the number of times the line is to be repeated. The ddname and all related values are repeated. The block form (RR) can be used to repeat a block of lines.
S (Select detail)
Displays detail information about the DCB, data set allocation, security, and SYSOUT parameters for the selected ddname. The detail information is displayed on the File PARMS screens described in Displaying File Parameters.
BR (Browse data set)
Displays the data set referenced by the selected ddname.
ED (Edit data set)
Displays the data set referenced by the selected ddname for editing.
FB (File-AID BROWSE)
Displays the data set referenced by the selected DDNAME for viewing using BMC’s file utility.
FE (File-AID EDIT)
Displays the data set referenced by the selected DDNAME for editing using BMC’s file utility. Use the COMPILE primary command in File-AID to allow formatted viewing of data with a record layout.
Using the COPY Command on edit file list screens
When you use the COPY command on any of the Edit File List screens and you do not enter a data set name, the Copy screen shown in following figure is displayed for entering the data set name. Entering the COPY command with a data set name skips this screen.
In the DSNAME field, enter the name of the data set to be copied. Enter a value for the VOLUME field only if the data set is not cataloged. The data set can be either sequential or partitioned, fixed or variable block, with a record length of 80 or greater.
Copy Screen - Specifying the DSNAME
COMMAND ===>
Copy An Existing File Allocation List, CLIST, Or JCL
Enter/Verify the dataset to be copied:
DSNAME ===> 'ADSABCX.JCL.CNTL(TRIPROGM)'
VOLUME ===> (If not cataloged)
If the dataset contains JCL, a DDNAME selection list will be displayed
Press ENTER To Process Or END To Terminate The COPY Function
The data set is copied when you press Enter and the following occurs:
- If the data set being copied contains a file list, the parameters associated with each file are listed on the appropriate Edit File List screens. The commands listed at the top of the screens can be used to browse and edit the data, copy data, allocate the file list, and so on. See the Using the Edit File List Screens for a description of how to use these screens.
- If the data set being copied contains JCL, the JCL is displayed on the Select DDNAME screen. You can select the DD statements you want copied to the file list and perform other functions, such as editing. See the Converting JCL to a File List.
Edit File List 1 Screen - DDNAME, DSNAME, and disposition
The Edit File List 1 screen, shown in following figure, is used to enter the ddname, data set name, and disposition of the files to be allocated. When file information is copied from existing file lists, CLISTs, or JCL, this information is pre-filled on this screen.
Edit File List 1 Screen—DDNAME, data set Name, and Disposition
COMMAND ===> SCROLL ===> CSR
Line Commands: Primary Commands: ...MORE ===>
D (Delete) S (Select detail) CANcel (Quit without saving)
I (Insert) BR (Browse dataset) COPY (Copy JCL or File List)
R (Repeat) ED (Edit dataset) ALLOCate (Allocate and continue)
FB (File-AID Browse) END (Save and End)
FE (File-AID Edit)
File Allocation List: 'PFHABCX.ALLOC(FLIST)'
----------------------- DSNAME ----------------------- DISP
DDNAME DUMMY, HFS, TEMP, TERM, SYSOUT, *, OR A DATASET NAME STAT
-------------------------------------------------------------------------------
''''' INFILE JCL.CNTL(INPUT) SHR
''''' OUTFILE TEST.RESULTS NEW
''''' REPORT01 SYSOUT=A
''''' REPORT02 SYSOUT=*
''''' MASTERIN 'ABC.DATA.MASTER(+0) ' SHR
''''' MASTEROU 'ABC.DATA.MASTER(+1) ' NEW
''''' SORTWK01 TEMP
''''' SORTWK02 TEMP
''''' SORTWK03 TEMP
''''' ALTERNAT DUMMY
''''' SYSOUT TERM
The following ddnames are not allowed:
JOBLIB SYSPROC
STEPCAT
- Data set names can be fully qualified and enclosed in quotes. If the name is not enclosed in quotes, the user’s prefix is added at allocation time. A member of a PDS can be allocated by including the member name in parentheses with the data set name. A temporary data set that you want to allocate to more than one file can be entered in the form &&name (1-8 characters) with or without quotes.
The following names can also be entered: DUMMY, HFS, TEMP, TERM, and SYSOUT. They refer to a dummy data set, USS file, temporary data set with no name, data set sent to the terminal, and SYSOUT data set, respectively.
You can refer to the name of a previously allocated data set by specifying *.ddname. The Seeenced ddname could have been allocated previously in the current file list or before the current file list was used.
If you want to have the actual data stored in the file list, specify a data set name of asterisk (*). See the In-Stream Data.
The common types of data sets are discussed in Types of Files That Can Be Allocated. Valid values for the DISP field are:
MOD (M)OLD (O)
NEW (N)SHR (S)For normal data sets, the default is SHR for temporary data sets, the default is NEW; for the other allocations (DUMMY, TERM, SYSOUT), the DISP field is forced to blank.
Edit File List 2 Screen - Space and catalog information
The Edit File List 2 screen shown in following figure is used for the space and catalog information required to allocate files with a disposition of NEW. If the file disposition is NEW, default values are pre-filled for the UNITS, PRIMARY, SECONDARY, RLSE, and DEL? fields.
When file information is copied from existing file lists, CLISTs, or JCL, this information is pre-filled on this screen.
Edit File List 2 Screen—Space and Catalog Information
COMMAND ===> SCROLL ===> CSR
Line Commands: Primary Commands: ...MORE ===>
D (Delete) S (Select detail) CANcel (Quit without saving)
I (Insert) BR (Browse dataset) COPY (Copy JCL or File List)
R (Repeat) ED (Edit dataset) SAVE (Save File List)
FB (File-AID Browse) END (Allocate and continue)
FE (File-AID Edit)
File Allocation List: 'PFHABCX.ALLOC(FLIST)'
---------------- SPACE AND CATALOG INFO --------------------
DDNAME UNITS PRIMARY SECONDARY DIR RLSE CONTIG UNIT VOLUME DEL?
------------------------------------------------------------------------------
''''' INFILE
''''' OUTFILE TRK 4 2 YES YES
''''' REPORT01
''''' REPORT02
''''' MASTERIN
''''' MASTEROU TRK 40 20 YES YES
''''' SORTWK01 CYL 1 1 YES YES SYSDA
''''' SORTWK02 CYL 1 1 YES YES SYSDA
''''' SORTWK03 CYL 1 1 YES YES SYSDA
''''' ALTERNAT
''''' TEMP1 2048 200 200 YES
Values for space and catalog information are:
UNITS
Valid values are TRACK (TRK, TRKS, TRA), CYL, or a block size of 0 to 65535 bytes.
PRIMARY
Number of units to allocate. Values are 0 to 99999.
SECONDARY
Space is allocated if the primary allocation is exceeded. Values are 0 to 99999.
DIR
If a new data set is a PDS, this field reserves space for the member names. Values are 0 to 999.
RLSE
If the value is YES, all unused space is released when the data set is closed. YES is the default for new or temporary data sets. Can be blank for NO.
CONTIG
If the value is YES, all primary space is allocated on contiguous tracks and cylinders when more than one cylinder is needed. Can be blank (default/NO).
UNIT
I/O unit—hardware address, device type, or group name. Enter if your installation requires it.
VOLUME
Required for an existing data set that is not cataloged or if your installation requires it.
DEL?
Valid only if DISP=NEW. Values are YES (default), NO, USE, and question mark (?). If YES is specified, the old dsname is deleted before the new one is allocated. USE changes a DISP of NEW to OLD if the data set exists. A question mark (?) causes you to be prompted for the desired action.
Edit File List 2A Screen - SMS Parameters
The Edit File List 2A screen shown in following figure is used to enter the SMS parameters (data class, storage class, and management class) associated with the ddname.
When file information is copied from existing file lists, CLISTs, or JCL, this information is pre-filled on this screen.
Edit File List 2A Screen - SMS Parameters
COMMAND ===> SCROLL ===> CSR
Line Commands: Primary Commands: ...MORE ===>
D (Delete) S (Select detail) CANcel (Quit without saving)
I (Insert) BR (Browse dataset) COPY (Copy JCL or File List)
R (Repeat) ED (Edit dataset) SAVE (Save File List)
FB (File-AID Browse) END (Allocate and continue)
FE (File-AID Edit)
File Allocation List: 'PFHABCX.ALLOC(FLIST)'
----------- SMS --------------
DDNAME DATACLAS STORCLAS MGMTCLAS DEL?
-------------------------------------------------------------------------
''''' DDSMS1 DGDG1
''''' DDSMS2 DCLAS02 SCLAS01
''''' DDSMS3 VSAM1
''''' SYSIN
''''' INDATA
''''' VSAM1
Values for the SMS parameters are:
DATACLAS
Specifies the data class name defined by your site that contains the attributes related to the allocation of the file list.
STORCLAS
Specifies the storage class name defined by your site that contains the attributes related to the storage occupied by the file list.
MGMTCLAS
Specifies the management class name defined by your site that specifies how SMS is to manage the data set.
DEL?
Valid only if DISP=NEW. Values are YES (default), NO, USE, and question mark (?). If YES is specified, the old dsname is deleted before the new one is allocated. USE changes a DISP of NEW to OLD if the data set exists. A question mark (?) causes you to be prompted for the desired action.
Edit File List 3 Screen - DCB Parameters
The Edit File List 3 screen in following figure is used to specify the DCB (data control block) parameters for each file listed.
When file information is copied from existing file lists, CLISTs, or JCL, this information is pre-filled on this screen.
Edit File List 3 Screen—DCB Parameters
COMMAND ===> SCROLL ===> CSR
UP, DOWN, LEFT and RIGHT Scrolling Available
Line Commands: Primary Commands: ...MORE ===>
D (Delete) S (Select detail) CANcel (Quit without saving)
I (Insert) BR (Browse dataset) COPY (Copy JCL or File List)
R (Repeat) ED (Edit dataset) SAVE (Save File List)
FB (File-AID Browse) END (Allocate and continue)
FE (File-AID Edit)
File Allocation List: 'PFHABCX.ALLOC(FLIST)'
---------------------- DCB PARAMETERS --------------------
DDNAME RECFM LRECL BLKSIZE DSORG KEYLEN BUFNO BUFLEN OPTCD
-----------------------------------------------------------------------------
''''' INFILE
''''' OUTFILE FB 121 18997 PS
''''' REPORT01 1330
''''' REPORT02 1330
''''' MASTERIN
''''' MASTEROU
''''' SORTWK01
''''' SORTWK02
''''' SORTWK03
''''' ALTERNAT 19069
''''' TEMP1 FB 80 6160 PS
Values for the DCB parameters are:
RECFM
Record format. Valid values are:
FB FBS VBA VS
FBA V VBM U
LRECL
Logical record length. Values are 0 to 32760. Do not specify a LRECL if the RECFM is U (undefined-length records).
BLKSIZE
Block size. Values are 0 to 32760. If your program contains the clause BLOCK CONTAINS 0 RECORDS, enter a value to prevent an abend when the allocated file is opened. If fixed block, the value must be a multiple of the LRECL. If variable block, the value must be equal to or greater than the LRECL plus 4.
If the RECFM and LRECL fields are specified for a new data set, a default value is provided for BLKSIZE.
DSORG
Data set organization. Values are PS, PO, and DA. If DISP=NEW or TEMP, and DIR=0 or blank, PS is the default.
KEYLEN
Indicates the length of the record key. Values are 1 to 255.
BUFNO
Specifies the number of buffers to be used with the data set. Values are 1 to 255.
BUFLEN
Indicates the buffer length. Values are 1 to 32760.
OPTCD
Optional system services. Valid values are:
BHRZ
C J T
E O U
Displaying file parameters
Detailed information about the allocation, DCB, protection, SYSOUT, and HFS related parameters for a ddname in the file list can be displayed from any Edit File List screen.
To display detail information for a ddname, enter the S (Select detail) line command next to the ddname on the Edit File List screen. The File PARMS Menu shown in following figure is displayed.
File PARMS menu
OPTION ===>
DDNAME: INFILE DSN: 'SYS2.XPEDITER.V7R7M0.SLXTSAMP(TRIDATA)'
1 ALLOCATION - Specify data set allocation parameters
2 DCB - Specify data set description parameters
3 SYSOUT - Specify JES SYSOUT parameters
4 PROTECTION - Specify data set security parameters
5 HFS - Specify Hierarchical File System parameters
Press ENTER to Process or Enter END Command to Terminate
You can select to look at the allocation, DCB, protection, SYSOUT, and HFS parameters for the selected ddname. Depending on your selection, one of the five Parameters (PARMS) screens shown in following figure through HFS PARMS Screen (SH) is displayed. These screens display many of the keywords/parameters supported by the JCL DD statements.
The primary commands (which are also used as panel codes) listed at the top of each screen can be used to display other PARMS screens.
Shortcut: Use left and right scrolling to display the four screens in succession.
Items listed on the screens can be changed by typing over the information.
Allocation PARMS Screen (SA)
COMMAND ===>
Primary Commands: SA SD (Select DCB) SO (SYSOUT) SP (Protection) SH (HFS)
DDNAME: DSN:
DISP ===> ___ (Status) _______ (Normal Disp) _______ (Conditional Disp)
FAU DEL? ===> ______ (Yes, No, Use, Prompt) FREE ===> _____ (End/Close)
SPACE ===> _____ (Units) _____ (Primary) _____ (Secondary) ___ (Dir)
AVGREC _ RLSE ___ (Yes/No) CONTIG ______ ROUND ___ (Yes/No)
UNIT ===> ________ (Device) __ (Unit Count) DEFER ___ (Yes/No)
VOL SER ===> ______ ______ ______ ______ ______ (Serial Numbers)
VOL SEQ ___ VOL COUNT ___ PRIVATE ___ (Yes/No) MSVGP ________
REF DSN ______________________________________________
LABEL ===> ____ (Dataset Seq) ___ (Label Type) OPEN ___ (In/Out)
RETPD ____ EXPDT ________
STORCLAS ===> ________ MGMTCLAS ===> ________
SUBSYS ===> _________________________________________________________________
______________________________________________________________________________
DCB PARMS Screen (SD)
COMMAND ===>
Primary Commands: SA (Allocation) SD SO (SYSOUT) SP (Protection) SH (HFS)
DDNAME: DSN:
DCB ===> ______________________________________________ (Ref DSNAME)
RECFM _____ LRECL _____ BLKSIZE _____ DSORG ___
OPTCD _____ KEYLEN ___ KEYOFF _____ (SMS Only)
BFTEK _ BUFNO ___ BUFL _____ BUFOFF __ BFALN _ LIMCT _____
NCP __ TRTCH ______ DEN _ PRTSP _ STACK _ FUNC _____
DIAGNS _____ EROPT ___ (ACC/SKP/ABE)
RECORG ===> __ (SMS Only) RLS ===> ___ (SMS Only)
DSNTYPE ===> ________ (SMS Only)
LIKE ===> ______________________________________________ (SMS Only)
DATACLAS ===> ________
SYSOUT PARMS Screen (SO)
COMMAND ===>
Primary Commands: SA (Allocation) SD (DCB) SO SP (Protection) SH (HFS)
DDNAME: DSN:
SYSOUT ===> _ (Class) ________ (Writer) ____ (Form)
DEST ===> ________ (Node) ________ (User ID)
HOLD ===> ___ (Yes/No)
OUTPUT ===> ________ ________ ________ ________ ________ ________ ________
OUTLIM ===> ________ (Maximum Logical Records)
CHARS ===> ____ ____ ____ ____ (Table Names)
UCS ===> ____ (Character Set Code)
BURST ===> ___ (Yes/No)
FCB ===> ____ (FCB Name)
MODIFY ===> ____ (Module Name) _ (Table Reference Character)
FLASH ===> ____ (Overlay Name) ___ (Overlay Count)
COPIES ===> ___ GROUP ___ ___ ___ ___ ___ ___ ___ ___ (Group Values)
Protection PARMS Screen (SP)
COMMAND ===>
Primary Commands: SA (Allocation) SD (DCB) SO (SYSOUT) SP SH (HFS)
DDNAME: DSN:
ACCODE ===> ________ PROTECT ===> ___ (Yes/No)
SECMODEL ===> ______________________________________________
GENERIC ===> ___ (Yes/No)
HFS PARMS Screen (SH)
COMMAND ===>
Primary Commands: SA (Allocation) SD (DCB) SO (SYSOUT) SP (Protection) SH
DDNAME: DSN:
PATH ===>
PATHDISP ===> ______ (Normal Disposition)
______ (Abnormal Disposition)
PATHMODE ===> ______ ______ ______ ______ ______ ______ ______
______ ______ ______ ______ ______ ______ ______
PATHOPTS ===> _________ _________ _________
_________ _________ _________ _________
FILEDATA ===> ______