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

FILEDEF • FILEDEF ddname DSN ? This form of the FILEDEF command allows you to specify the OS data
set name or DOS file-id interactively. Using this form, you can
enter an OS data set name or DOS file-id containing eBbedded special
characters such as blanks and hyphens. If you use this form, the
default filename and filetype for your file, FILE ddname, is the eMS filename and filetype associated with the OS data set name or DOS file-ide The filemode for this form is always the default, A1.
To use the interactive DSN operand, you key in DSN 1; CMS then
requests that you enter the as data set name or DOS file-id exactly
as it appears in the data set or file. Do not oBit the periods that
separate the qualifiers of an OS data set name, but do not insert
periods where they do not appear. quall[ .guaI2 ••• 1
where quall.quaI2... are the qualifiers of the JS data set DOS file-ide When you use this form, you must code the
separating the qualifiers • name or
periods • FILEDEF ddname mode DSN quaIl (quaI2 ••• ] This form allows you to specify the as data set name or DOS file-id explicitly. (This form can be used for DOS file-ids only if they
comply with the as naming convention of 1- to 8-byte qualifiers
separated by periods, to a maximum of 44 characters, including
periods.) Again, the default value for the filename and filetype is
FILE ddname. When you use this form, you must omit the periods that
separate the qualifiers of the os data set name. For example, for an
os data set or DOS file named MY.FILE.IN, you enter:
FILEDEF ddname Bl DSN MY FILE IN
All of these forms have many variations, as is apparent from the
command format.
ddnamel device 1 rfilenamel filetypel filemodel [ da tasetnam e) ]
ddnameN deviceN [filenameN filetypeN filemodeN [ da tasetname]]
A list of current definitions is displayed if the FILEDEF command
is entered with no operands. DMSFLD069I DISK 'mode' NOT ACCESSED The specified disk is not accessed; the file definition remains in
effect. You should access the disk before you attempt to read or
write the file. DMSFLD220R ENTER DATA SET NAME:
A FILEDEF command with the DSN 1 operand was entered. Enter the
exact OS or DOS file identification, including embedded periods and
blanks. Section 2. CMS Commands 95