FILEDEF
1. If you do not issue a FILEDEF command for an os input or output
file, eMS uses the ddname on the DCB macro to issue the following
default file definition:
FILEDEF ddname DISK FILE ddname Al
See "Usage Notes" under the discussion of the ASSEMBLE command for
information on the default file definitions made by the assembler.
2. To identify DOS files for DOS program execution or to identify VSAM data sets for either OS or DOS program execution, you must use the
DLBL command.
3. A file definition established with the FILEDEF command remains in
effect until explicitly changed or cleared. The system clears file
definitions under the circumstances: • When the assembler or any of the language processors are
invoked. (Note that FILEDEF definitions entered with the PERM option are not cleared.) • When a program abends or when you issue the Immediate command HX
to halt command or program execution. 4. The FILEDEF command does not supply default values for LRECL and
BLKSIZE. As under OS, if DCB information is unavailable when a
file is opened, an open error is issued for the file. The
following chart summarizes the results at OPEN time, of specifying
LRECL and BLKSIZE options. r--­ BLKSIZE Not
Specified
Specified
Not
Specified
Specified L--- LRECL
Not
Specified Results I , --------f IIf the input file exists on disk, the , litem length (or item length +4 for vari- , ,able-length records) becomes the BLKSIZE.I --------I Not ILRECL=BLKSIZE (or LRECL=BLKSIZE-4, for , Specified Ivariable-length records). Specified IBLKSIZE=LRECL (or BLKSIZE=LRECL+4, for Ivariable-length records) e Specified !The values specified are used. , , I _________________________________________________________ -J If V or VB is specified for RECFM, LRECL must be at least 4 bytes
less than BLKSIZE. DOS sequential (SAM) files do not contain BLKSIZE, LRECL, or RECFM specifications. These options must be specified by a FILEDEF
command or DCB statement if OS macros are used to access DOS files. Otherwise the defaults, BLKSIZE=32760 and RECFM=U, are assumed.
LRECL is not used for RECFM=U files.
5. There is an auxiliary processing option for FILEDEF that is only
valid when FILEDEF is executed by an internal program call: this
option cannot be entered as a terminal command. The option, AUXPROC addr, allows an auxiliary processing routine to rece1ve
control during I/O operations. For details on to use this
option of the FILEDEF command, see Section 2. CMS Commands 93

FILEDEF
6. If a FILEDEF command is issued with a that matches a current defined by a previous FILEDEF command and the devices are
the same, the filename, filetype, fi1emode, and options previously
specified remain in effect, unless respecified by the new FILEDEF
command. If the devices are not the same, all previous
specifications are removed.
7. If the FILEDEF command is entered with no operands
r a list of
current 1efinitions is displayed.
There are two general forms for specifying the DISK operand in a FILEDEF
command. If you specify the first form:
FILEDEF ddname DISK fn ft (fm]
fn and ft (filename and filetype) are assumed to be a CKS fi1eid. If fm is the filemode of an as disk, fn and ft are assumed to be the only two
qualifiers of an as data set name. If fm is specified as an asterisk,
(*) then all disks are searched until a file with matching fn and ft is
found. You cannot use this form unless the OS data set name or DOS file-id
conforms to the as naming convention (1-to a-byte separated
by periods, to a maximum of 44 characters, including periods). Also,
the data set name can have only two qualifiers; otherwise, you must use
the DSN ? or DSN qua1l ••• form. For example, if the OS data set name
or DOS fi1e-id is TEST.SAMPLE.MAY, you enter:
FILEDEF MINE Bl DSN TEST SAMPLE MAY -- or --
FILEDEF KINE Bl DSN ?
TEST. SAMPLE. MAY If the OS data set name or DOS fi1e-id is TEST.SAMPLE, then you may
enter:
FILEDEF KINE DISK TEST SAMPLE B1
The second form of the DISK operand is used only with OS data sets
and DOS files: r , .. ,
FILEDEF ddname IDISK fn ft I Ifml {DSN ? } I IAll DSN qua1l [qua12 ••• ]
L .J L .J This form allows you to to enter OS and DOS file identifications that do not conform to as data set naming conventions. The DSN operand
corresponds to the DSN parameter on the OS DD (data definition)
statement. There are three ways you can specify this form: • FILEDEF ddname DISK fn ft fm DSN qua1l (qua12 ••• ]
This form of the FILEDEF command associates the CKS filename and
filetype you specify with the as data set name or DOS file-id specified
following the DSN operand. Once it is defined, you can refer to the OS data set name or DOS fi1e-id by using the eMS filename and filetype. If
you omit DISK, filename, filetype, and filemode, the d9fau1t values are
FILE ddname Al.
94 IBK CMS Command and Macro Reference