VMS Help DEFINE, Qualifiers *Conan The Librarian (sorry for the slow response - running on an old VAX) |
1 - /EXECUTIVE_MODE
Requires SYSNAM (system logical name) privilege to create an executive-mode logical name. Creates an executive-mode logical name in the specified table. If you specify the /EXECUTIVE_MODE qualifier and you do not have SYSNAM privilege, the DEFINE command ignores the qualifier and creates a supervisor-mode logical name. The mode of the logical name must be the same or less privileged than the mode of the table in which you are placing the name.
2 - /GROUP
Requires GRPNAM (group logical name) or SYSNAM (system logical name) privilege to place a name in the group logical name table. Places the logical name in the group logical name table. Other users who have the same group number in their user identification codes (UICs) can access the logical name. The /GROUP qualifier is synonymous with the /TABLE=LNM$GROUP qualifier. If you enter more than one of the qualifiers /PROCESS, /JOB, /GROUP, /SYSTEM, or /TABLE, only the last one entered is accepted.
3 - /JOB
Places the logical name in the jobwide logical name table. All processes in the same job tree as the process that created the logical name can access the logical name. The /JOB qualifier is synonymous with the /TABLE=LNM$JOB qualifier. If you enter more than one of the qualifiers /PROCESS, /JOB, /GROUP, /SYSTEM, or /TABLE, only the last one entered is accepted.
4 - /LOG
/LOG (default) /NOLOG Displays a message when a new logical name supersedes an existing name.
5 - /NAME_ATTRIBUTES
/NAME_ATTRIBUTES[=(keyword[,...])] Specifies attributes for a logical name. By default, no attributes are set. Possible keywords are as follows: CONFINE The logical name is not copied into a spawned subprocess. This qualifier is relevant only for logical names in a private table. The logical name inherits the CONFINE attribute from the logical name table where it is entered; if the logical name table is "confined," then all names in the table are "confined." NO_ALIAS A logical name cannot be duplicated in the specified table in a less privileged access mode; any previously created identical names in an outer (less privileged) access mode within the specified table are deleted. If you specify only one keyword, you can omit the parentheses. Only the attributes you specify are set.
6 - /PROCESS
/PROCESS (default) Places the logical name in the process logical name table. The /PROCESS qualifier is synonymous with the /TABLE=LNM$PROCESS qualifier. If you enter more than one of the qualifiers /PROCESS, /JOB, /GROUP, /SYSTEM, or /TABLE, only the last one entered is accepted.
7 - /SUPERVISOR_MODE
/SUPERVISOR_MODE (default) Creates a supervisor-mode logical name in the specified table. The mode of the logical name must be the same as or less privileged than the mode of the table in which you are placing the name.
8 - /SYSTEM
Requires write (W) access or SYSNAM (system logical name) privilege to place a name in the system logical name table. Places the logical name in the system logical name table. All system users can access the logical name. The /SYSTEM qualifier is synonymous with the /TABLE=LNM$SYSTEM qualifier. If you enter more than one of the qualifiers /PROCESS, /JOB, /GROUP, /SYSTEM, or /TABLE, only the last one entered is accepted.
9 - /TABLE
/TABLE=name Requires write (W) access to the table to specify the name of a shareable logical name table. Specifies the name of the logical name table in which the logical name is to be entered. You can use the /TABLE qualifier to specify a user-defined logical name table (created with the CREATE/NAME_TABLE command); to specify the process, job, group, system, or clusterwide logical name tables; or to specify the process or system logical name directory tables. If you specify the table name using a logical name that has more than one translation, the logical name is placed in the first table found. For example, if you specify DEFINE/TABLE=LNM$FILE_ DEV and LNM$FILE_DEV is equated to LNM$PROCESS, LNM$JOB, LNM$GROUP, and LNM$SYSTEM, then the logical name is placed in LNM$PROCESS. The default is the /TABLE=LNM$PROCESS qualifier. If you enter more than one of the qualifiers /PROCESS, /JOB, /GROUP, /SYSTEM, or /TABLE, only the last one entered is accepted.
10 - /TRANSLATION_ATTRIBUTES
/TRANSLATION_ATTRIBUTES[=(keyword[,...])] Equivalence-name qualifier. Specifies one or more attributes that modify an equivalence string of the logical name. Possible keywords are as follows: CONCEALED Indicates that the equivalence string is the name of a concealed device. When a concealed device name is defined, the system displays the logical name, rather than the equivalence string, in messages that refer to the device. TERMINAL Logical name translation should terminate with the current equivalence string; indicates that the equivalence string should not be translated iteratively. If you specify only one keyword, you can omit the parentheses. Only the attributes you specify are set. Note that different equivalence strings of a logical name can have different translation attributes.
11 - /USER_MODE
Creates a user-mode logical name in the specified table. User-mode logical names created within the process logical name tables are used for the execution of a single image; for example, you can create a user-mode logical name to allow an image executing in a command procedure to redefine SYS$INPUT. User-mode entries are deleted from the process logical name table when any image executing in the process exits (that is, after a DCL command or user program that executes an image completes execution). Also, user-mode logical names are automatically deleted when invoking and exiting a command procedure.
|