HELP ASSIGN — MicroVMS 4.6
Associates equivalence names with a logical name. If you specify an existing logical name, the new equivalence names replace the existing equivalence names. Format ASSIGN equivalence-name,... logical-name
Additional information available:
Parameters
equivalence-name
A character string of 1 to 255 characters. If the string contains
other than upper case alphanumeric, dollar sign, or underscore
characters, enclose it in quotation marks ("). Use double quotation
marks ("") to denote an actual quotation mark. Specifying more than
one equivalence name for a logical name creates a search list.
logical-name
A character string of 1 through 255 characters. If the string contains
other than upper case alphanumeric, dollar sign, or underscore
characters, enclose it in quotation marks ("). Use double quotation
marks ("") to denote an actual quotation mark. If you terminate
logical-name with a colon, the system removes the colon. If the
logical name is to be entered into the process or system directory
logical name tables, then the name may only have from 1 to 31
alphanumeric characters (including the dollar sign and underscore).
Avoid assigning a logical name that matches the file name of an
executable image in SYS$SYSTEM:. Such an assignment will prohibit
you from invoking that image.
Qualifiers
Additional information available:
/EXECUTIVE_MODE/GROUP/JOB/LOG/NAME_ATTRIBUTES
/PROCESS/SUPERVISOR_MODE/SYSTEM/TABLE/TRANSLATION_ATTRIBUTES
/USER_MODE
/EXECUTIVE_MODE
/SUPERVISOR_MODE (default) /USER_MODE Executive mode requires SYSNAM privilege. Specifies the mode of the logical name. If you specify executive mode, but do not have SYSNAM privilege, a supervisor mode logical name is created. The mode of the logical name must be the same as or external to (less privileged than) the mode of the table in which you are placing the name. If you specify a user mode logical name in the process logical name table, that logical name is used for the execution of a single image only; user mode entries are deleted from the logical name table when any image executing in the process exits (that is, after any DCL command or user program that executes an image) completes execution.
/GROUP
/JOB /PROCESS (default) /SYSTEM Group logical names require SYSPRV or GRPNAM privilege. System logical names require SYSNAM or SYSPRV privilege. Specifies the table in which the logical name is to be placed. The /GROUP qualifier is synonymous with /TABLE=LNM$GROUP. The /JOB qualifier is synonymous with /TABLE=LNM$JOB. The /PROCESS qualifier is synonymous with /TABLE=LNM$PROCESS. The /SYSTEM qualifier is synonymous with /TABLE=LNM$SYSTEM.
/JOB
See /GROUP.
/LOG (default)
/NOLOG Displays a message when a new logical name supersedes an existing name.
/NAME_ATTRIBUTES[=(keyword,...)]
Specifies the attributes for a logical name. (By default, no attributes are set. You can specify the following keywords for attributes: +----------+-----------------------------------------------+ | CONFINE | Does not copy the logical name into a spawned | | | subprocess. Relevant only for logical names | | | in a private table. | +----------+-----------------------------------------------+ | NO_ALIAS | Prohibits creation of logical names with the | | | same name in an outer (less privileged) access| | | mode within the specified table. Deletes any | | | previously created, identical names in an | | | outer access mode within the specified table. | +----------+-----------------------------------------------+
/PROCESS
See /GROUP.
/SUPERVISOR_MODE
See /EXECUTIVE_MODE.
/SYSTEM
See /GROUP.
/TABLE=name
Requires WRITE access to the table if the table is shareable. Specifies the name of the logical name table in which the logical name is to be entered. You can specify user-defined tables (created with the CREATE/NAME_TABLE command), the process, group, job, or system logical name table, or the process or system logical name directory table. The default is LNM$PROCESS. If you specify a table name that translates to more than one table, the logical name is placed in the first table found.
/TRANSLATION_ATTRIBUTES[=keyword,...]
Qualifies each equivalence-name. Specifies attributes of the equivalence-name. Possible keywords are: +-----------+----------------------------------------------+ | CONCEALED | Indicates that the equivalence string is the | | | name of a concealed device | +-----------+----------------------------------------------+ | TERMINAL | Terminates logical name translation after | | | iterative translation of this equivalence | | | string | +-----------+----------------------------------------------+
/USER_MODE
See /EXECUTIVE_MODE.
/MERGE
Removes all jobs from one queue and merges them into another existing queue. Does not affect jobs that are executing. Format ASSIGN/MERGE merge-queue-name source-queue-name Requires the Secure User Environment Option. Requires OPER privilege or EXECUTE access to both queues.
Additional information available:
Parameters
merge-queue-name Name of the queue into which the jobs are being merged. source-queue-name Name of the queue from which the jobs are being removed.
/QUEUE
Assigns, or redirects, a logical queue to a single execution queue. Format ASSIGN/QUEUE execution-queue-name[:] logical-queue-name[:] Requires the Secure User Environment Option. Requires OPER privilege or EXECUTE access to both queues.
Additional information available:
Parameters
execution-queue-name[:] Name of the execution queue. The queue cannot be a logical, generic, or batch queue. logical-queue-name[:] Name of the logical queue.