Copyright Digital Equipment Corp. All rights reserved.

Parameters


equivalence-name[,...]

   Specifies a character string of 1 to 255 characters. Defines the
   equivalence name, usually a file specification, device name, or
   other logical name, to be associated with the logical name in
   the specified logical name table. If the string contains other
   than uppercase alphanumeric, dollar sign ($),  or underscore (_)
   characters, enclose it in quotation marks (" ").  Use two sets
   of quotation marks ("" "")  to denote an actual quotation mark
   within the string. Specifying more than one equivalence name for
   a logical name creates a search list. A logical name can have a
   maximum of 128 equivalence names.

   When you specify an equivalence name that will be used as a file
   specification, you must include the punctuation marks (colons
   (:),  brackets ([]),  and 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,
   terminate the device name with a colon.

   The ASSIGN command allows you to assign the same logical name to
   more than one equivalence name. When you specify more than one
   equivalence name for a logical name, you create a search list.
   For more information on search lists, see the OpenVMS User's
   Manual.


logical-name[:]

   Specifies the logical name string, which is a character string
   containing up to 255 characters. You choose a logical name to
   represent the equivalence name in the specified logical name
   table.

   If the string contains other than uppercase alphanumeric, dollar
   sign, or underscore characters, enclose it in quotation marks.
   Use two sets of quotation marks to denote an actual quotation
   mark. If you terminate the logical-name parameter with a colon,
   the system removes the colon before placing the name in a logical
   name table. (This differs from the DEFINE command, which saves
   the colon.) If the logical name is to be entered into the
   process directory (LNM$PROCESS_DIRECTORY) or system directory
   (LNM$SYSTEM_DIRECTORY) logical name tables, the name can have
   only 1 to 31 alphanumeric characters (including the dollar
   sign and underscore). If the logical name being entered into
   the process or system directory translates to a logical name
   table name, any alphabetic characters in the name should all be
   uppercase. By default, the logical name is placed in the process
   logical name table.

   If the logical name contains any characters other than
   alphanumeric characters, the dollar sign, or the underscore,
   enclose the name in quotation marks. If the logical name contains
   quotation marks, enclose the name in quotation marks and use
   two sets of quotation marks in the places where you want one set
   of quotation marks to occur. Note that if you enclose a name in
   quotation marks, the case of alphabetic characters is preserved.