DEFAPP
Define a checked logical name.
Parameters
logical-name
Specifies the logical name string. The logical name string can
contain from 1 to 255 characters.
By default, the logical name is placed in the application logi-
cal name table. The string may contain any characters that
constitute a valid logical name.
required-flag
Indicates whether to check for existance of the device, di-
rectory or file specified by the equivalence-name, and what
behaviour to take if its is not found.
If the equivalence-name is a device or directory, its existance
is always checked. A NO indicates that if the device or di-
rectory does not exist, the logical name should not be defined.
A YES indicates that if it does not exist, an error should be
reported and no logical name defined.
If the equivalence-name is a file, its existance is always
checked. A NO indicates that if the file does not exist, the
logical name will be defined to be the file in the found direc-
tory. A YES indicates that if the file does not exist, an error
should be reported and no logical name defined.
If the equivalence is a quoted string or there is more than one
equivalence, no checking is performed, and the required-flag
is ignored.
equivalence-name[,...]
Defines the equivalence names to be associated with the log-
ical name. An equivalence name string can contain from
1 to 255 characters. If the string is not intended as a valid
OpenVMS file (or node, device or directory) specification, use
the DEFLIT command.
You must include the punctuation marks (colons, brackets,
periods) that would be required if the equivalence name were
used directly as a file specification. Therefore, if you specify
a device name as an equivalence name, you must terminate
the equivalence name with a colon.
The DEFAPP command allows you to assign the same logical
name to more than one equivalence name. For example, you
can use the same logical name to access different directories
on different disks, or to access different files in different di-
rectories. When you specify more than one equivalence name
for a logical name, you create a search list. See the OpenVMS
DCL Concepts Manual for more information on search lists.
Note that the DEFAPP command does not check for the ex-
istance of the specified file, directory or device if more than
one equivalence is defined.
Examples
1.
$ DEFAPP FIN_WRK_DIR NO DISK_'CUR_ENV':[FIN.WRK]