HELPLIB.HLB  —  DEFINE  Parameters
 logical-name

    Specifies the logical name string, which is a character string
    containing from 1 to 255 characters. The following rules apply:

    o  If the logical name is to be entered into the process or
       system directory logical name tables (LNM$PROCESS_DIRECTORY,
       LNM$SYSTEM_DIRECTORY), then the name can only have from 1 to
       31 alphanumeric characters, including the dollar sign ($)  and
       underscore (_).  If the logical name translates to a logical
       name table name, any alphabetic characters in the name should
       all be uppercase.

    o  If you specify a colon (:)  at the end of a logical name, the
       DEFINE command saves the colon as part of the logical name.
       (This is in contrast to the ASSIGN command, which removes the
       colon before placing the name in a logical name table.) By
       default, the logical name is placed in the process logical
       name table.

    o  If the string contains any characters other than uppercase
       alphanumerics, the dollar sign, or the underscore character,
       enclose the string in quotation marks (" ").  Use two sets of
       quotation marks ("" "")  to denote actual quotation marks.
       When you enclose a name in quotation marks, the case of
       alphabetic characters is preserved.

 equivalence-name[,...]

    Specifies a character string containing from 1 to 255 characters.
    The following rules apply:

    o  If the string contains any characters other than uppercase
       alphanumerics, the dollar sign, or the underscore character,
       enclose the string in quotation marks. Use two sets of
       quotation marks to denote an actual quotation mark. 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.

    o  When you specify an equivalence name that will be used as a
       file specification, 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 DEFINE command allows you to assign multiple equivalence
    names to a single logical name. For example, you can use the same
    logical name to access different directories on different disks
    or to access different files in different directories.
Close Help