HELP SET — VMS 5.0
Defines or changes, for the current terminal session or batch job,
characteristics associated with files and devices owned by the
process.
Format:
SET option
Additional information available:
ACCOUNTINGACLAUDITBROADCASTCARD_READER
CLUSTERCOMMANDCONTROLDAYDEFAULTDEVICEDIRECTORY
ENTRYFILEHOSTKEYLOGINSMAGTAPEMESSAGE
ONOUTPUT_RATEPASSWORDPRINTERPROCESSPROMPT
PROTECTIONQUEUERESTART_VALUERIGHTS_LIST
RMS_DEFAULTSYMBOLTERMINALTIMEUICVERIFY
VOLUMEWORKING_SET
ACCOUNTING
Disables or enables the logging of various activities in the
accounting log file SYS$MANAGER:ACCOUNTNG.DAT. You can also use
SET ACCOUNTING to close the current accounting log file and to open
a new one with a version number incremented by 1.
Format:
SET ACCOUNTING
Additional information available:
Command Qualifiers
Additional information available:
/DISABLE
/DISABLE[=(keyword[,...])] Disables the logging of all activities in the accounting log file. To disable specific activities selectively, you include one or more keywords with /DISABLE. When you specify more than one keyword, separate them with commas and enclose the entire list in parentheses. See the SET ACCOUNTING command in the VMS DCL Dictionary for a list of all activities that can be enabled or disabled.
/ENABLE
/ENABLE[=(keyword[,...])] Enables the logging of all activities in the accounting file. To enable specific activities selectively, you include one or more keywords with /ENABLE. When you specify more than one keyword, separate them with commas and enclose the entire list within parentheses. See the SET ACCOUNTING command in the VMS DCL Dictionary for a list of all activities that can be enabled or disabled.
/NEW_FILE
/NEW_FILE Closes the current accounting file and opens a new version of that file.
Examples
1. $ SET ACCOUNTING/ENABLE=(BATCH,INTERACTIVE) This command requests that all batch and interactive jobs be recorded in the accounting file at job termination. 2. $ SET ACCOUNTING/NEW_FILE This command closes the current accounting file and creates a new version of it.
ACL
Allows you to modify the access control list (ACL) of an object.
Format:
SET ACL object-name
Additional information available:
Parameters
object-name Specifies the object whose access control list (ACL) is being modified. Wildcard characters are only allowed in the object name for objects that are files. Files must be disk files on Files-11 Structure Level 2 formatted volume.
Command Qualifiers
Additional information available:
/ACL/AFTER/BEFORE/BY_OWNER/CONFIRM/CREATED
/DEFAULT/DELETE/EDIT/EXCLUDE/JOURNAL/LIKE/LOG
/MODE/NEW/OBJECT_TYPE/RECOVER/REPLACE/SINCE
/ACL
/ACL[=(ace[,...])] Specifies one or more access control entries (ACEs) to be modified. When no ACE is specified, the entire access control list is affected. Separate multiple ACEs with commas. The specified ACEs are inserted at the top of the ACL unless the /AFTER qualifier is given.
/AFTER
/AFTER=ace Indicates that all access control entries (ACEs) specified with the /ACL qualifier will be added after the ACE specified with the /AFTER qualifier. By default, any ACEs added to the ACL are always placed at the top of the list. This qualifier cannot be used with the /EDIT qualifier.
/BEFORE
/BEFORE[=time] Selects a file that is dated before the specified time. You can specify either an absolute time or a combination of absolute and delta times. See Chapter 1 of the VMS DCL Concepts Manual for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed. This qualifier cannot be used with the /EDIT qualifier and can be used only with an object that is a file.
/BY_OWNER
/BY_OWNER[=uic] Selects a file whose owner user identification code (UIC) matches the specified owner UIC. If the /BY_OWNER qualifier is specified without a UIC, the UIC of the current process is assumed. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual. This qualifier cannot be used with the /EDIT qualifier and can be used only with an object that is a file.
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether a request is issued before each individual SET ACL
operation to confirm that the operation should be performed on that
object.
When the system issues the prompt, you can issue any of the
following responses:
YES NO QUIT
TRUE FALSE <CTRL/Z>
1 0 ALL
<RET>
You can use any combination of upper- and lowercase letters for word
responses. Word responses can be abbreviated to one or more letters
(for example, T, TR, or TRU for TRUE). Affirmative answers are YES,
TRUE, and 1. Negative answers are NO, FALSE, 0, and <RET>. QUIT or
<CTRL/Z> indicates that you want to stop processing the command at
that point. When you respond with ALL, the command continues to
process, but no further prompts are given. If you type a response
other than one of those in the list, the prompt will be reissued.
This qualifier cannot be used with the /EDIT qualifier and can be
used only with an object that is a file.
/CREATED
/CREATED Selects a file based on its creation date. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier. This qualifier cannot be used with the /EDIT qualifier and can be used only with an object that is a file.
/DEFAULT
/DEFAULT Creates an ACL for the specified files as if the files were newly created. For a directory file, the /DEFAULT qualifier propagates the entire ACL (except ACEs with the NOPROPAGATE option) so that a particular access protection can be propagated throughout a directory tree. For all other files, the /DEFAULT qualifier propagates the DEFAULT option ACEs in the ACL of the parent directory to the ACL of the specified files. The /DEFAULT qualifier uses the ACL of the parent directory of the specified file, not the current default directory. This qualifier cannot be used with the /EDIT qualifier and can be used only with an object that is a file.
/DELETE
/DELETE Indicates that the access control entries (ACEs) specified with the /ACL qualifier are to be deleted. If no ACEs are specified with /ACL, the entire ACL is deleted (except those with the PROTECTED option). If you specify an ACE that was not specified with the /ACL qualifier, you will be notified that the ACE does not exist, and the delete operation will continue. This qualifier cannot be used with the /EDIT qualifier.
/EDIT
/EDIT Invokes the ACL Editor and allows you to use the /JOURNAL, /MODE, or /RECOVER qualifiers. Any other qualifiers specified with /EDIT are ignored. For more information on the ACL Editor, see the VMS Access Control List Editor Manual.
/EXCLUDE
/EXCLUDE=(file-spec[,...]) Excludes any files that match the listed file specifications from the SET ACL operation. Wildcard characters are allowed in the file specification. However, you cannot use relative version numbers to exclude a specific version. The file specification can contain a directory specification, but it cannot contain a device name. This qualifier cannot be used with the /EDIT qualifier and can be used only with an object that is a file.
/JOURNAL
/JOURNAL[=file-spec] /NOJOURNAL Controls whether a journal file is created from the editing session. By default, a journal file is created if the editing session ends abnormally. If you omit the file specification, the journal file has the same name as the input file and a file type of JOU. You can use the /JOURNAL qualifier to specify a journal file name that is different from the default. No wildcard characters are allowed in the /JOURNAL file-spec parameter. You must specify /EDIT in order to use this qualifier.
/LIKE
/LIKE=(OBJECT_TYPE=type,OBJECT_NAME=name)
Indicates that the ACL of the object-name given with the /LIKE
qualifier is to replace the ACL of the objects specified with SET
ACL. Any existing ACE (except those with the PROTECTED option) will
be deleted before the ACL specified by /LIKE is copied. The type of
the source and destination objects do not have to be the same.
You can specify the following keywords for OBJECT_TYPE:
DEVICE
FILE (includes directory files)
SYSTEM_GLOBAL_SECTION
GROUP_GLOBAL_SECTION
JOBCTL_QUEUE
LOGICAL_NAME_TABLE
The object-name is specified as it is specified for the command. No
wildcard characters are allowed in the /LIKE parameters.
This qualifier cannot be used with the /EDIT qualifier.
/LOG
/LOG /NOLOG (default) Controls whether the SET ACL command displays the object name of the object that has been affected by the command. This qualifier cannot be used with the /EDIT qualifier.
/MODE
/MODE=[NO]PROMPT Determines whether the ACL editor prompts for field values. By default, the ACL editor selects prompt mode. You must specify the /EDIT qualifier to use this qualifier.
/NEW
/NEW Indicates that any existing ACE in the ACL of the object specified with SET ACL (except those with the PROTECTED option) is to be deleted. In order to use the /NEW qualifier, you must specify a new ACL or ACE with the /ACL, /LIKE, or /REPLACE qualifier. This qualifier cannot be used with the /EDIT qualifier.
/OBJECT_TYPE
/OBJECT_TYPE=type
Specifies the type of the object whose ACL is being edited. By
default, the ACL editor assumes that the object whose ACL is being
edited is a file. If the object is not a file, the /OBJECT
qualifier is required. The following keywords may be specified with
/OBJECT:
FILE Specifies that the object type is a file or a
directory file.
DEVICE Specifies that the object type is a device.
SYSTEM_GLOBAL_SECTION Specifies that the object type is a system
global section.
GROUP_GLOBAL_SECTION Specifies that the object type is a group
global section.
QUEUE Specifies that the object type is a batch or
device (printer, server, or terminal) queue.
LOGICAL_NAME_TABLE Specifies that the object type is a system
logical name table.
By default, a file object type is assumed, and therefore the
/OBJECT_TYPE=file need not be specified.
/RECOVER
/RECOVER[=file-spec] /NORECOVER (default) Specifies the name of the journal file to be used in a recovery operation. If the file specification is omitted with /RECOVER, the journal is assumed to have the same name as the input file and a file type of JOU. No wildcard characters are allowed with the /RECOVER file-spec parameter. You must specify /EDIT in order to use this qualifier.
/REPLACE
/REPLACE=(ace[,...]) Deletes the access control entries (ACEs) specified with the /ACL qualifier and replaces them with those specified with /REPLACE. Any ACEs specified with the /ACL qualifier must exist and must be specified in the order in which they appear in the ACL. This qualifier cannot be used with the /EDIT qualifier.
/SINCE
/SINCE[=time] Selects a file that is dated after the specified time. You can specify either an absolute time or a combination of absolute and delta times. See Chapter 1 of the VMS DCL Concepts Manual for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed. This qualifier cannot be used with the /EDIT qualifier and can be used only with an object that is a file.
AUDIT
Enables or disables security auditing on a VMS system. (Note that
you must specify the /ALARM qualifier.)
Format:
SET AUDIT
Additional information available:
Command Qualifiers
Additional information available:
/ALARM/DISABLE/ENABLE/FAILURE_MODE
/ALARM
/ALARM Causes alarm messages to be sent to all terminals enabled as security operators. See the description of the DCL command REPLY/ENABLE for details on how to enable terminals as security operators. Both /ALARM and either /ENABLE or /DISABLE are required.
/DISABLE
/DISABLE=(keyword[,...]) Indicates that one or more events should not result in any alarm. You can disable alarms for all events by specifying the keyword ALL, or you can specify the appropriate keywords to selectively disable alarms for from one to all events that are currently enabled. You must specify at least one keyword. See the /ENABLE qualifier description for a list of the keywords to use with the /DISABLE qualifier. In processing the SET AUDIT command, the system processes the /DISABLE qualifier last. Thus, if you accidentally specify both /ENABLE and /DISABLE in the same command, the /DISABLE qualifier prevails.
/ENABLE
/ENABLE=(keyword[,...])
Indicates that the particular event specified in the keyword list
should result in an alarm.
You can enable alarms for all events by specifying the keyword ALL,
or you can specify the appropriate keywords to selectively enable
alarms for from one to all events that are currently enabled. You
must specify at least one keyword.
The possible events that may be specified in the keyword list of
either the /ENABLE or /DISABLE qualifier are:
ACL An event requested by an access control
list (ACL) item, including ACLs on files
and global sections. Access control
lists are described in the Guide to VMS
System Security.
ALL All possible events.
AUDIT An event resulting from the execution of
a SET AUDIT command.
AUTHORIZATION The modification of any portion of the
system user (UAF) or network proxy
(NETPROXY) authorization file, including
any password changes; the modification of
any portion of the rights database.
BREAKIN=(keyword[,...]) The occurrence of one or more of the
following classes of breakin attempts, as
specified by one or more of the keywords:
ALL, DETACHED, DIALUP, LOCAL, NETWORK,
REMOTE
FILE_ACCESS=(keyword[,...]) The occurrence of file and global
section access events (regardless of the
value specified in the file's access
control list, if any). You can specify
one or more of the following keywords to
describe the file access event to be
noted.
ALL All types of file access
events, as defined by the
remaining keywords.
BYPASS [:access [,access...]] Successful
file access due to the use of
the BYPASS privilege
FAILURE [:access [,access...]]
Unsuccessful file access
GRPPRV [:access [,access...]] Successful
file access due to the use of
the GRPPRV privilege
READALL [:access [,access...]] Successful
file access due to the use of
the READALL privilege
SUCCESS [:access [,access...]] Successful
file access
SYSPRV [:access [,access...]] Successful
file access due to the use of
the SYSPRV privilege
Most of the keywords permit you to define
the type of file access that was obtained
with the following keywords:
ALL (default), READ, WRITE, EXECUTE,
DELETE, CONTROL
INSTALL The occurrence of any INSTALL operations.
LOGFAILURE=(keyword[,...]) The occurrence of one or more of the
following classes of login failure, as
specified by one or more of the keywords:
ALL (default), BATCH, DETACHED, DIALUP,
LOCAL, NETWORK, REMOTE, SUBPROCESS
LOGIN=(keyword[,...]) The occurrence of one or more of the
following classes of login attempts, as
specified by one or more of the keywords:
ALL (default), BATCH, DETACHED, DIALUP,
LOCAL, NETWORK, REMOTE, SUBPROCESS
LOGOUT=(keyword[,...]) The occurrence of one or more of the
following classes of logouts, as
specified by one or more of the keywords:
ALL (default), BATCH, DETACHED, DIALUP,
LOCAL, NETWORK, REMOTE, SUBPROCESS
MOUNT The issuing of a MOUNT or DISMOUNT
request
/FAILURE_MODE
/FAILURE_MODE=keyword
Specifies how VMS proceeds following a failed attempt to write a
security alarm. Specify one of the following failure modes:
WAIT Indicates that processes are placed in the
the MWAIT state to wait until the resource
is available. This is the default.
IGNORE Indicates that failing security alarms are
to be ignored. The first failed alarm
causes an error message to be written to
the operator console and log file. The
system maintains a count of the lost
alarms, which can be displayed with SHOW
AUDIT.
CRASH Forces a system failure if security alarms
cannot be written.
Examples
1. $ SET AUDIT/ALARM/ENABLE=(AUTHORIZATION,BREAKIN) The SET AUDIT command enables alarms at all terminals established as security operators for any change in the system user or network proxy authorization file and for any breakin attempts. 2. $ SET AUDIT/FAILURE_MODE=IGNORE This command directs VMS to ignore security alarms if they cannot be written and to maintain a count of the lost security alarms. Enter the comand SHOW AUDIT to display the number of lost alarm messages. 3. $ SET AUDIT/ALARM/DISABLE=ALL This command disables all alarms to security operators.
BROADCAST
Enables you to selectively screen out various kinds of messages from
being broadcast to your terminal.
Format:
SET BROADCAST=(class-name[,...])
Additional information available:
Parameters
class-name
Specifies the class of message that you want to enable or disable
for broadcast to your terminal. If you specify only one class, you
can omit the parentheses. The class names are:
ALL All message classes enabled
[NO]DCL CTRL/T and SPAWN/NOTIFY messages
[NO]GENERAL All normal REPLY messages or
messages from $BRDCST
[NO]MAIL Notification of mail
NONE All message classes disabled
[NO]OPCOM Messages issued by OPCOM
[NO]PHONE Messages from the Phone Utility
[NO]QUEUE Messages referring to print or batch
jobs issued by the queue manager
[NO]SHUTDOWN Messages issued from REPLY/SHUTDOWN
[NO]URGENT Messages issued from REPLY/URGENT
[NO]USER1 - [NO]USER16 Messages from the specified user
groups
CARD_READER
Defines the default translation mode for cards read from a card
reader. All subsequent input read from the specified card reader
will be converted using the specified mode.
Format:
SET CARD_READER device-name[:]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
device-name[:] Specifies the name of the card reader for which the translation mode is to be set. The device must not be currently allocated to any other user.
Command Qualifiers
Additional information available:
/026
/026 Sets the card reader for cards punched on an 026 punch.
/029
/029 Sets the card reader for cards punched on an 029 punch.
/LOG
/LOG /NOLOG Controls whether log information is displayed at the terminal to confirm that the card reader is set. By default, no log information is displayed.
Examples
1. $ ALLOCATE CR:
_CRA0: ALLOCATED
$ SET CARD_READER CRA0:/029
$ COPY CRA0: [MALCOLM.DATAFILES]CARDS.DAT
The ALLOCATE command requests the allocation of a card reader by
specifying the generic device name. When the ALLOCATE command
displays the name of the device, the SET CARD_READER command sets
the translation mode at 029. Then the COPY command copies all the
cards read by the card reader CRA0 into the file CARDS.DAT in the
directory [MALCOLM.DATAFILES].
CLUSTER
See HELP CLUSTER/EXPECTED_VOTES
Additional information available:
/EXPECTED_VOTES
Sets the total expected votes in the cluster to a value that you
specify or, if no value is specified, sets the total votes to a value
determined by the system.
Format:
SET CLUSTER/EXPECTED_VOTES[=value]
Additional information available:
Example
1. $ SET CLUSTER/EXPECTED_VOTES The SET CLUSTER command in this example instructs the system to calculate the total expected votes value for you, because no value is specified as part of the command string. The system uses the NODEn_VOTES + QUORUM_DISK_VOTES formula. 2. $ SET CLUSTER/EXPECTED_VOTES=9 The SET CLUSTER command in this example sets the total expected votes to 9, which is the value specified in the command string.
COMMAND
Invokes the Command Definition Utility to add commands to your
process command table or to a specified command table file. For a
complete description of the Command Definition Utility, including
information about the SET COMMAND command, see the VMS Command
Definition Utility Manual.
Format:
SET COMMAND [file-spec[,...]]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
[file-spec[,...]] Specifies the name of one or more command definition files. If you specify more than one name, separate them with commas. The default file type is CLD. See the VMS Command Definition Utility Manual for more information about writing a command definition file. Wildcard characters are allowed in the file specification.
Command Qualifiers
Additional information available:
/DELETE/LISTING/OBJECT/OUTPUT/REPLACE/TABLE
/DELETE
/DELETE=(verb[,...]) Specifies /DELETE mode to delete verbs from the command table you are modifying. You can use the /DELETE qualifier to delete a verb in either your process command table or in a command table file specified with the /TABLE qualifier. If you do not use the /TABLE qualifier to specify an alternate command table, the default is to delete verbs from your process command table. If you do not use the /OUTPUT qualifier to specify an output file, the default is to return the modified command table to your process. The verb specifies a verb to be deleted. If you specify two or more verbs, separate them with commas and enclose the list in parentheses. If you specify only one verb, you can omit the parentheses. You cannot use the /LISTING, /OBJECT, or /REPLACE qualifiers in /DELETE mode.
/LISTING
/LISTING[=file-spec] /NOLISTING Controls whether an output listing is created and optionally provides an output file specification for the listing file. A listing file contains a listing of the command definitions along with any error messages. The listing file is similar to a compiler listing. If you specify the /LISTING qualifier and omit the file specification, output is written to the default device and directory; the listing file will have the same name as the first command definition file and a file type of LIS. You can use the /LISTING qualifier only in /OBJECT or /REPLACE mode; you cannot create a listing in /DELETE mode. In /OBJECT and /REPLACE modes, the default is /NOLISTING.
/OBJECT
/OBJECT[=file-spec] Specifies /OBJECT mode to create an object module from a command definition file and optionally provides an object file specification. You cannot use the /OBJECT qualifier to create an object module from a command definition that contains the IMAGE keyword. You can specify only one command definition file when you use SET COMMAND/OBJECT. If you specify the /OBJECT qualifier and omit the file specification, output is written to the default device and directory; the object file will have the same name as the input file and a file type of OBJ. You cannot use the /DELETE, /OUTPUT, /REPLACE, or /TABLE qualifiers in /OBJECT mode.
/OUTPUT
/OUTPUT[=file-spec] /NOOUTPUT Controls where the modified command table should be placed. If you provide an output file specification, the modified command table is written to the specified file. If you do not provide an output file specification, the edited command table replaces your process table. The /NOOUTPUT qualifier indicates that no output is to be generated. You can specify an output file specification with the /OUTPUT qualifier only when you also use the /TABLE=file-spec qualifier to provide the input tables. The default file type is EXE. You can use the /OUTPUT qualifier only in /DELETE or /REPLACE mode; you cannot use the /OUTPUT qualifier in /OBJECT mode. In /DELETE and /REPLACE mode, the default is /OUTPUT with no file specification.
/REPLACE
/REPLACE Specifies /REPLACE mode to add or replace verbs in the command table you are modifying. You can use the /REPLACE qualifier to modify either the process command table or a command table file specified with the /TABLE qualifier. If you do not use the /TABLE qualifier to specify an alternate command table, the default is to modify your process command table. If you do not use the /OUTPUT qualifier to specify an output file, the default is to return the modified command table to your process. You cannot use the /OBJECT or /DELETE qualifiers in /REPLACE mode. If you do not explicitly specify /DELETE, /OBJECT, or /REPLACE mode the default is /REPLACE.
/TABLE
/TABLE=[file-spec] Specifies the command table that is to be modified. If you specify the /TABLE qualifier and omit the file specification, the current process command table is modified. If you include a file specification, the specified command table is modified. The default file type is EXE. If you use the /TABLE qualifier to provide an input command table file, you should also use the /OUTPUT qualifier to provide an output table file. Otherwise, the modified command table will be written to your process and will replace your process command table. You can only use the /TABLE qualifier in /DELETE or /REPLACE mode; you cannot use the /TABLE qualifier in /OBJECT mode. In /REPLACE and /DELETE mode, the default is /TABLE with no input file specification.
Examples
1. $ SET COMMAND SNAG This command adds the commands in SNAG.CLD to the command table in the current process. 2. $ SET COMMAND/OBJECT SNAG This command creates an object file using the commands in SNAG.CLD. This object file can then be linked with other object files to process application defined commands. 3. $ SET COMMAND/TABLE=MYTAB/OUTPUT=MYCLI SNAG This command adds the commands in SNAG.CLD to the command table MYTAB.EXE and writes the updated table to MYCLI.EXE. When you use the /TABLE qualifier to specify an input command table, you should use the /OUTPUT qualifier to specify an an output file. Otherwise, your process command table will be overwritten. 4. $ SET COMMAND/DELETE=HOLD This command deletes the definition for the verb HOLD from your process command table. The modified command table is returned to your process.
CONTROL
Determines whether control passes to the command interpreter when
CTRL/Y is pressed and whether process statistics are displayed when
CTRL/T is pressed.
Format:
SET [NO]CONTROL[=(T,Y)]
Additional information available:
Parameters
(T,Y) Specifies that one or both control functions, T (CTRL/T) or Y (CTRL/Y), be enabled or disabled by the SET CONTROL command. If you specify both control characters, separate them with a comma and enclose the list in parentheses. By default, if you do not specify either control character (T or Y), only Y is assumed.
Examples
1. $ SET NOCONTROL=Y The SET NOCONTROL command disables the CTRL/Y function as well as most CTRL/C functions. 2. $ SET CONTROL=T The SET CONTROL command enables the CTRL/T function. 3. $ SET NOCONTROL=(T,Y) The SET NOCONTROL command disables both the CTRL/T and CTRL/Y functions.
DAY
Allows you to reset the default day type specified in the user
authorization file (UAF) for the current day.
Format:
SET DAY
Additional information available:
Command Qualifiers
Additional information available:
/DEFAULT/LOG/PRIMARY/SECONDARY
/DEFAULT
/DEFAULT Overrides any previous SET DAY specification and specifies that the normal UAF defaults are to be used to determine today's day type.
/LOG
/LOG /NOLOG (default) Controls whether log information is displayed at the terminal to confirm that the new SET DAY information has been set.
/PRIMARY
/PRIMARY Sets today until midnight to a primary day.
/SECONDARY
/SECONDARY Sets today until midnight to a secondary day.
Examples
1. $ SET DAY/PRIMARY This command overrides the current default day type and sets the today until midnight to a primary day. 2. $ SET DAY/DEFAULT This command overrides the previous SET DAY command and sets today's day type to the UAF-defined default.
DEFAULT
Changes the default device and/or directory name for the current
process. The new default is applied to all subsequent file
specifications that do not explicitly include a device or directory
name.
When you change the default device assignment, the system equates
the specified device with the logical name SYS$DISK.
Format:
SET DEFAULT device-name[:]
Additional information available:
Parameters
device-name[:] Specifies a device and/or a directory name to be used as the default device or directory in file specifications. If you specify a physical device name, terminate the device name with a colon. If you specify a directory name, you must enclose it in square brackets. When you use a search list logical name as the first element in the SET DEFAULT parameter, the logical name is not translated by SET DEFAULT. Instead, SET DEFAULT retains the logical name so that RMS will be able to access the entire search list. If you issue the SHOW DEFAULT command, the search list logical name will be displayed as the default device, along with its equivalence strings. See Chapter 4 of the VMS DCL Concepts Manual for more information. You can use the minus sign as a directory-searching wildcard character in the directory specification.
Examples
1. $ SET DEFAULT [CARPENTER]
$ COPY A.* B.*
The SET DEFAULT command changes the default directory to
[CARPENTER]. The default disk device does not change. The
directory name [CARPENTER] is assumed to be the default directory
for subsequent file operations, such as the COPY command shown.
2. $ SET DEFAULT DISK2:
The SET DEFAULT command changes the default disk device to DISK2.
The default directory name does not change.
3. $ SET DEFAULT DISK0:[CLARK]
The SET DEFAULT command changes the default disk to DISK0 and the
default directory name to CLARK.
DEVICE
Establishes a print device or terminal as a spooled device or
establishes the status of error-logging for a device.
Format:
SET DEVICE device-name[:]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
device-name[:] Specifies the name of the device whose spooling or error-logging status is to change. The device must be a print device or a terminal if its spooling status is to change; the device must be a disk or magnetic tape if its error-logging status is to change.
Command Qualifiers
Additional information available:
/AVAILABLE/DUAL_PORT/ERROR_LOGGING/LOG
/SPOOLED
/AVAILABLE
/AVAILABLE /NOAVAILABLE Controls whether the specified disk is to be considered available. This command can be issued only after the specified disk has been dismounted. If you specify /NOAVAILABLE, any attempt to mount the specified disk is prevented.
/DUAL_PORT
/DUAL_PORT /NODUAL_PORT Controls whether the port seize logic in the device driver of the specified disk is to be enabled. This qualifier should be used only on disks that contain a dual port kit and have been dismounted.
/ERROR_LOGGING
/ERROR_LOGGING /NOERROR_LOGGING Controls whether device errors are logged in the error log file. Use the SHOW DEVICE/FULL command to find out the current status.
/LOG
/LOG /NOLOG (default) Controls whether log information will be displayed at the terminal.
/SPOOLED
/SPOOLED[=(queue-name[:],intermediate-disk-name[:])] /NOSPOOLED Controls whether files will be spooled to an intermediate disk. The queue name indicates the printer queue to which a file is queued. If a queue name is not supplied, the default is the name of either the printer or terminal. The intermediate disk name identifies the disk to which the spooled files are written. If the intermediate disk name is not supplied, the default is SYS$DISK (the current default disk). The intermediate disk must be mounted before files can be written to it. Once the device has been set spooled to a disk, that disk cannot be dismounted until the spooled device is set to /NOSPOOLED. All channels must be deassigned from a print device before its spooling characteristics can be changed. Also, the queue that is assigned to the device must be stopped.
Examples
1. $ SET DEVICE/SPOOLED=(LPA0) LPA0: In this command, the /SPOOLED qualifier requests that the printer queue LPA0 be spooled to an intermediate disk before files directed to the disk are printed. Because no intermediate disk was specified, the intermediate disk defaults to SYS$DISK. 2. $ SET DEVICE/ERROR_LOGGING DBB2: This command requests that all device errors reported on DBB2 be logged in the error log file. 3. $ SET DEVICE/NOAVAILABLE DRA0: This command prevents any attempt to mount a disk on DRA0. 4. $ SET DEVICE/DUAL_PORT DRA0: This command enables the dual port seize logic in DRA0.
/ACL
Allows you to modify the access control list (ACL) of a device. The
/ACL qualifier is required.
As of Version 5.0 of VMS, the SET DEVICE/ACL command is
superseded by the SET ACL command. SET DEVICE/ACL is synonymous with
with SET ACL/OBJECT_TYPE=DEVICE. DIGITAL recommends usage of the SET
ACL command.
Format:
SET DEVICE/ACL[=(ace[,...])] device-name
/SERVED
Allows you to make a disk on a local node available to all the nodes
in a cluster. The /SERVED qualifier is required.
Format:
SET DEVICE/SERVED node-name$DDcu:
Additional information available:
Parameters
node-name$DDcu: Specifies the device name of the device that you wish to make available to the cluster.
Example
1. $ SET DEVICE/SERVED DRA4: This command instructs the MSCP server to make the disk device DRA4 on your local node available to all other processors on your cluster.
DIRECTORY
Modifies the characteristics of one or more directories.
Format:
SET DIRECTORY directory-spec[,...]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
directory-spec[,...] Specifies one or more directories to be modified. You must supply a complete directory specification enclosed in square brackets. If you specify two or more directories, separate them with commas. Wildcard characters are allowed in directory specifications.
Command Qualifiers
Additional information available:
/BACKUP/BEFORE/BY_OWNER/CONFIRM/CREATED/EXCLUDE
/EXPIRED/LOG/MODIFIED/OWNER_UIC/SINCE/VERSION_LIMIT
/BACKUP
/BACKUP Selects directories according to the dates of their most recent backup. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier. Use of the /BACKUP qualifier is incompatible with /CREATED, /EXPIRED, and /MODIFIED. The default is /CREATED.
/BEFORE
/BEFORE[=time] Selects only those directories that are dated before the specified time. You can specify either an absolute time or a combination of absolute and delta times. See Chapter 1 of the VMS DCL Concepts Manual for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed.
/BY_OWNER
/BY_OWNER[=uic] Specifies that only those directories which are owned by the specified user identification code (UIC) will be modified. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual. If the /BY_OWNER qualifier is specified without a UIC, the UIC of the current process is assumed.
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether the SET DIRECTORY command displays the directory
specification of each directory before modifying it, and requests
you to confirm that the operation should be performed on that
directory.
When the system issues the prompt, you can issue any of the
following responses:
YES NO QUIT
TRUE FALSE <CTRL/Z>
1 0 ALL
<RET>
You can use any combination of upper- and lowercase letters for word
responses. Word responses can be abbreviated to one or more letters
(for example, T, TR, or TRU for TRUE). Affirmative answers are YES,
TRUE, and 1. Negative answers are NO, FALSE, 0, and <RET>. QUIT or
<CTRL/Z> indicates that you want to stop processing the command at
that point. When you respond with ALL, the command continues to
process, but no further prompts are given. If you type a response
other than one of those in the list, the prompt will be reissued.
/CREATED
/CREATED (default) Selects directories based on their dates of creation. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier. Use of the /CREATED qualifier is incompatible with /BACKUP, /EXPIRED, and /MODIFIED.
/EXCLUDE
/EXCLUDE=(directory-spec[,...]) Any directories that match the listed directory specifications are excluded from the SET DIRECTORY operation. Wildcard characters are supported for directory specifications. If you specify only one directory, you can omit the parentheses. You cannot include the device name in the directory specifications you supply with the /EXCLUDE qualifier.
/EXPIRED
/EXPIRED Selects directories according to the dates on which they will expire. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier. Use of the /EXPIRED qualifier is incompatible with /BACKUP, /CREATED, and /MODIFIED. The default is /CREATED.
/LOG
/LOG /NOLOG (default) Controls whether the SET DIRECTORY command displays the directory specification of each directory that is modified.
/MODIFIED
/MODIFIED Selects directories according to the dates on which they were last modified. This qualifier is only relevant when used with the /BEFORE or /SINCE qualifier. Use of the /MODIFIED qualifier is incompatible with /BACKUP, /CREATED, and /EXPIRED. The default is /CREATED.
/OWNER_UIC
/OWNER_UIC[=uic] Requires SYSPRV privilege to specify a UIC other than your own. Sets the owner user identification code (UIC) of the directory to the specified UIC. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual.
/SINCE
/SINCE[=time] Selects only those directories that are dated after the specified time. You can specify either an absolute time or a combination of absolute and delta times. See Chapter 1 of the VMS DCL Concepts Manual for for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed.
/VERSION_LIMIT
/VERSION_LIMIT[=n] Specifies the total number of versions that a file in the specified directory can have. If you do not specify a version limit, a value of 0 is used, indicating that the number of versions of a file is limited only to the Files-11 architectural limit---32,767. If you change the version limit for the directory, the new value applies only to files created after the change has been made. The new limit does not apply to new versions of files that existed before the change. The limits that apply to those files are the same as the limits for the initial versions of the files. The SET DIRECTORY version limit value refers to the number of files with the same file name and type that can exist in the directory at one time. It has no effect on the version number field of a particular file specification. Use the SET FILE command to set limits on file version numbers. Use the DIRECTORY/FULL command to find out what the current version limit is for a directory.
Examples
1. $ SET DIRECTORY/VERSION_LIMIT=5/CONFIRM [SMITH.FORTRAN] The SET DIRECTORY command limits to five the number of versions for files created after the command is issued. The /CONFIRM qualifier requests that you confirm whether or not the specified directory should actually be modified. 2. $ SET DIRECTORY/OWNER_UIC=[360,020] [DAVIDSON],[USERS] The SET DIRECTORY command modifies both the [DAVIDSON] and [USERS] directories, changing their owner UICs. Use of the OWNER_UIC qualifier requires SYSPRV (system privilege).
/ACL
Allows you to modify the access control list (ACL) of one or more
directories. The /ACL qualifier is required.
As of Version 5.0 of VMS, the SET DIRECTORY/ACL command is
superseded by the SET ACL command.
Format:
SET DIRECTORY/ACL[=(ace[,...])] directory-spec[,...]
ENTRY
Changes the current status or attributes of a job that is not
currently executing in a queue.
Format:
SET ENTRY entry-number
Additional information available:
ParameterCommand QualifiersExamples
Parameter
entry-number Specifies the entry number of the job you want to change.
Command Qualifiers
Additional information available:
/AFTER/BURST/CHARACTERISTICS/CLI/COPIES/CPUTIME
/FEED/FLAG/FORM/HEADER/HOLD/JOB_COUNT
/KEEP/LOG_FILE/LOWERCASE/NAME/NOCHECKPOINT
/NODELETE/NOTE/NOTIFY/OPERATOR/PAGES
/PARAMETERS/PASSALL/PRINTER/PRIORITY/RELEASE/REQUEUE
/RESTART/SETUP/SPACE/TRAILER/WSDEFAULT/WSEXTENT
/WSQUOTA
/AFTER
/AFTER=time /NOAFTER Requests that the specified job be held until after a specific time. If the specified time has already passed, the job is queued for immediate processing. You can specify either an absolute time or a combination of absolute and delta times. See Chapter 1 of the VMS DCL Concepts Manual for complete information on specifying time values.
/BURST
/BURST[=keyword]
/NOBURST
Controls whether a burst page is included at the beginning of a
print job. A burst page precedes a flag page and contains the same
information. However, it is printed over the perforation between
the burst page and the flag page. The printing on the perforation
makes it easy to separate individual print jobs.
When you specify /BURST, you need not specify /FLAG; a flag page
will automatically follow the burst page.
You can specify one of the following keywords:
ALL All printed files contain a burst page.
ONE The first printed file contains a burst page.
Use the /[NO]BURST qualifier to override the installation-defined
defaults that have been set for the printer queue you are using.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...]) /NOCHARACTERISTICS Enables you to change the characteristics desired for the job. If you specify only one characteristic, you can omit the parentheses. Codes for characteristics can be either names or values from 0 to 127 and are installation-defined. Use the SHOW QUEUE/CHARACTERISTICS command to see which characteristics have been defined for your system. Use the SHOW QUEUE/FULL command to see which characteristics are available on a particular queue. When you include the /CHARACTERISTICS qualifier with the SET QUEUE/ENTRY command, all the characteristics you specify must also be specified for the queue that will be executing the job. If not, the job will remain pending in the queue until the queue characteristics are changed or you delete the entry with the DELETE/ENTRY command. You need not specify every characteristic of a queue with the SET QUEUE/ENTRY command as long as the ones you specify are a subset of the characteristics set for that queue. The job will also run if no characteristics are specified. Specification of a characteristic for a queue does not prevent jobs that do not specify that characteristic from being executed.
/CLI
/CLI=filename Enables you to specify a different command language interpreter (CLI) to use in processing the job. The file name specifies that the CLI be SYS$SYSTEM:filename.EXE. If you do not specify the /CLI qualifier, the job is run by the CLI specified in the user's authorization record, or whatever CLI was specified when the job was originally submitted to the queue.
/COPIES
/COPIES=n Specifies the number of copies to print. The n parameter can be any number from 1 to 255. When you use the /COPIES qualifier with the SET QUEUE/ENTRY command, the number of copies can apply only to the entire job. You cannot use this qualifier to specify different numbers of copies for individual files within a multifile job.
/CPUTIME
/CPUTIME=option Defines a CPU time limit for the batch job. You can specify a delta time (see Chapter 1 of the VMS DCL Concepts Manual), the value 0, or the keyword NONE or INFINITE for n. When you need less CPU time than authorized, use the /CPUTIME qualifier to override the base queue value established by the system manager or the value authorized in your user authorization file. Specify 0 or INFINITE to request an infinite amount of time. Specify NONE when you want the CPU time to default to your user authorization file (UAF) value or the limit specified on the queue. Note that you cannot request more time than permitted by the base queue limits or your own UAF.
/FEED
/FEED /NOFEED Controls whether form feeds are inserted into print jobs when the printer nears the end of a page. The number of lines per form can be reset by the /FORM qualifier. You can suppress this automatic form feed (without affecting any of the other carriage control functions that are in place) by using the /NOFEED qualifier. When you use the /FEED qualifier with the SET QUEUE/ENTRY command, the qualifier applies to all files in the print job. You cannot use this qualifier to specify form feeds for individual files within a multi-file job.
/FLAG
/FLAG[=keyword]
/NOFLAG
Controls whether a flag page is printed preceding a print job. The
flag page contains the name of the user submitting the job, the job
entry number, and other information about the job. You can specify
one of the following keywords:
ALL Prints a flag page before each file in the job
ONE Prints a flag page before the first file in the job
Use the /[NO]FLAG qualifier to override the installation-defined
defaults that have been set for the printer queue you are using.
/FORM
/FORM=type Specifies the name of the form that you want for the print job. Specify the form type using a numeric value or alphanumeric code. Form types can refer to the width, length, or type of paper. Codes for form types are installation-defined. You can use the SHOW QUEUE/FORM command to find out the form types available for your system. The SHOW QUEUE/FULL command tells you which form is set for a specific queue. If you specify a form type different from that of the queue, your job remains pending until the form type of the queue is set equal to the form type of the job or you delete the job with the DELETE/ENTRY command. You can use the SET QUEUE/ENTRY to change the form type of your job to match that of the queue so your job can be printed. In order to have the form type for the queue changed, request that the system manager stop the queue, physically change the form type of the printer, and restart the queue specifying the new form type.
/HEADER
/HEADER /NOHEADER Controls whether a heading line is printed at the top of each output page in a print job.
/HOLD
/HOLD
/NOHOLD
Controls whether or not the job is to be made available for
immediate processing or held for processing later.
If you specify /HOLD, the job is not released for processing until
you specifically release it with the /NOHOLD or /RELEASE qualifier.
You can use the SET QUEUE/ENTRY command to release a job that was
previously submitted with a /HOLD qualifier or you can place a job
on hold so that it will run later.
You can use the /NOHOLD qualifier to release jobs that have been
held for the following reasons:
o A job was submitted with the /HOLD qualifier.
o A completed job is being held in a queue that has /RETAIN
specified.
o A user-written symbiont has refused a job.
/JOB_COUNT
/JOB_COUNT=n Requests that an entire print job be printed n times, where n is a decimal integer from 1 to 255. This qualifier overrides the /JOB_COUNT qualifier specified or defaulted with the PRINT command.
/KEEP
/KEEP /NOKEEP Controls whether the batch job log file is deleted after it is printed.
/LOG_FILE
/LOG_FILE=file-spec /NOLOG_FILE Controls whether a log file with the specified name is created for the batch job or whether a log file is created. When you use the /LOG_FILE qualifier, the system writes the log file to the file you specify. If you use /NOLOG_FILE, no log file is created. If neither form of the qualifier has been used for the job, the log file is written to a file in the default directory that has the same file name as the first command file and a file type of LOG. You can use the /LOG_FILE qualifier to specify that the log file be written to a different device. Logical names in the file specification are translated in the context of the process that executes the SET QUEUE/ENTRY command. The process executing the batch job must have access to the device on which the log file will reside. If you omit the /LOG_FILE qualifier and specify the /NAME qualifier, the log file is written to a file having the same file name as that specified by the /NAME qualifier; the file type is LOG. When you omit the /LOG_FILE qualifier, the job-name value used with /NAME must be a valid file name.
/LOWERCASE
/LOWERCASE /NOLOWERCASE Indicates whether the files must be printed on a printer that can print both uppercase and lowercase letters. The /NOLOWERCASE qualifier means that files can be printed on printers supporting only uppercase letters. If all available printers can print both uppercase and lowercase letters, you do not need to specify /LOWERCASE.
/NAME
/NAME=job-name Defines a name string to identify the job. The name string can have from 1 to 39 characters. The job name is used in the SHOW QUEUE command display. For batch jobs, the job name is also used for the batch job log file. For print jobs, the job name is also used on the flag page of the printed output. If the /NAME qualifier has not been specified for the job, the name string defaults to the file name of the first, or only, file in the job; the file type is LOG.
/NOCHECKPOINT
/NOCHECKPOINT For a batch job, erases the value established by the most recently executed SET RESTART_VALUE command. For a print job, clears the stored checkpoint so that the job will restart from the beginning.
/NODELETE
/NODELETE Cancels file deletion for a job that was submitted with the /DELETE qualifier. If no /DELETE qualifier was specified when the job was originally submitted to the queue, you cannot use the SET QUEUE/ENTRY to establish file deletion at a later time. You cannot use the /NODELETE qualifier to specify that individual files in a multi-file job not be deleted.
/NOTE
/NOTE=string Allows you to specify a message to appear on the flag page for the print job. The string can contain up to 255 characters.
/NOTIFY
/NOTIFY /NONOTIFY Controls whether a message is broadcast to any terminal at which you are logged in, notifying you when your job has been completed or aborted.
/OPERATOR
/OPERATOR=string Allows you to specify a message to be sent to the operator. The string can contain up to 255 characters. When the job begins execution, the queue pauses and the message is transmitted to the operator.
/PAGES
/PAGES=([l,]u) Specifies the number of pages to print for the specified job. You can use the /PAGES qualifier to print portions of a long file. When you use the /PAGES qualifier with the SET QUEUE/ENTRY command, the qualifier can only apply to an entire job. You cannot use this qualifier to specify different numbers of pages to be printed for individual files within a multi-file job. The l (lower) specifier refers to the first page in the group of pages that you want printed for that job. If you omit the l specifier, the printing starts on the first page of the job. The u (upper) specifier refers to the last page of the file that you want printed. When you want to print to the end of the file but do not know how many pages that will be, you can use "" as the u specifier. You can omit the parentheses when you specify only a value for u. For example, /PAGES=10 prints the first 10 pages of the job; /PAGES=(5,10) prints pages 5 through 10; /PAGES=(5,"") starts printing at page 5 and continues until the end of the job is reached.
/PARAMETERS
/PARAMETERS=(parameter[,...]) Specifies from 1 to 8 optional parameters to be passed to the job. Each parameter can have as many as 255 characters. If you specify only one parameter, you can omit the parentheses. The commas delimit individual parameters. To specify a parameter that contains any special characters or delimiters, enclose the parameter in quotation marks. For batch jobs, the parameters define values to be equated to the symbols named P1 through P8 in each command procedure in the job. The symbols are local to the specified command procedures.
/PASSALL
/PASSALL /NOPASSALL Specifies whether the symbiont bypasses all formatting and sends the output QIO to the driver with format suppressed. All qualifiers affecting formatting, as well as the /HEADER, /PAGES, and /PAGE_SETUP qualifiers, will be ignored. When you use the /PASSALL qualifier with the SET QUEUE/ENTRY command, the qualifier applies to the entire job. You cannot use this qualifier to specify PASSALL mode for individual files within a multifile job.
/PRINTER
/PRINTER[=queue-name] /NOPRINTER Controls whether the batch job log is queued for printing when your job is completed. The /PRINTER qualifier allows you to specify a particular printer queue. If you specify /NOPRINTER, /KEEP is assumed.
/PRIORITY
/PRIORITY=n Specifies the priority of the job. The priority value must be in the range of 0 through 255, where 0 is the lowest priority and 255 is the highest. The default value for /PRIORITY is the value of the SYSGEN parameter DEFQUEPRI. You must have either OPER (operator) or ALTPRI (alter priority) privilege to raise the priority value above the value of the SYSGEN parameter MAXQUEPRI. No privilege is needed to set the priority lower than the MAXQUEPRI value.
/RELEASE
/RELEASE
Releases a previously held job for processing. You can use this
qualifier to release jobs that have been held for the following
reasons:
o A job was submitted with the /HOLD qualifier.
o A job was submitted with the /AFTER qualifier.
o A completed job is being held in a queue that has /RETAIN
specified.
o A user-written symbiont has refused a job.
/REQUEUE
/REQUEUE=queue-name[:] Requests that the job be moved from the original queue to the specified queue.
/RESTART
/RESTART /NORESTART Specifies whether a batch or print job will be restarted after a system crash or a STOP/QUEUE/REQUEUE command.
/SETUP
/SETUP=module[,...] Calls for the specified modules to be extracted from the device control library and copied to the printer before a job is printed. When you use the /SETUP qualifier with the SET QUEUE/ENTRY command, the qualifier applies to the entire job. You cannot use this qualifier to specify different setup modules for individual files within a multi-file job.
/SPACE
/SPACE /NOSPACE Controls whether output is to be double-spaced. When you use the /SPACE qualifier with the SET QUEUE/ENTRY command, the qualifier applies to the entire job. You cannot use this qualifier to specify different spacing for individual files within a multi-file job.
/TRAILER
/TRAILER[=keyword]
/NOTRAILER
Controls whether a trailer page is printed at the end of a job. The
trailer page displays the job entry number, as well as information
about the user submitting the job.
When you use the /TRAILER qualifier with the SET QUEUE/ENTRY
command, trailer pages are placed at the end of each file in a
multi-file job. You can specify one of the following keywords:
ALL All printed files contain a trailer page.
ONE The last printed file contains a trailer page.
Use the /[NO]TRAILER qualifier to override the installation-defined
defaults that have been set for the printer queue you are using.
/WSDEFAULT
/WSDEFAULT=n Defines a working set default for a batch job. You can specify a positive integer in the range 1 through 65,535, 0, or the word NONE for n. Use this qualifier to override the base queue value established by the system manager or the value authorized in the user authorization file (UAF), provided you want to impose a lower value. Specify 0 or NONE if you want the working set value defaulted to either the UAF value or the working set quota specified on the queue. You cannot request a value higher than the default.
/WSEXTENT
/WSEXTENT=n Defines a working set extent for a batch job. You can specify a positive integer in the range 1 through 65,535, 0, or the word NONE for n. Use this qualifier to override the base queue value established by the system manager or the value authorized in the user authorization file (UAF), provided you want to impose a lower value. Specify 0 or NONE if you want the working set extent defaulted to either the UAF or the working set extent specified on the queue. You cannot request a value higher than the default.
/WSQUOTA
/WSQUOTA=n Defines the maximum working set size for a batch job. This is the working set quota. You can specify a positive integer in the range 1 through 65,535, 0, or the word NONE for n. Use this qualifier to override the base queue value established by the system manager or the value authorized in the user authorization file (UAF), provided you want to impose a lower value. Specify 0 or NONE if you want the working set quota defaulted to either the user authorization file value or the working set quota specified on the queue. You cannot request a value higher than the default.
Examples
1. $ PRINT/HOLD MYFILE.DAT
Job MYFILE (queue SYS$PRINT, entry 112) holding
.
.
.
$ SET ENTRY 112/RELEASE/JOB_COUNT=3
The PRINT command requests that the file MYFILE.DAT be queued to the
system printer, but placed in a hold status. The SET ENTRY
command releases the file for printing and changes the number of
copies of the job to three.
2. $ SUBMIT CLIMATE
Job CLIMATE (queue SYS$BATCH, entry 211) pending
$ SET ENTRY 211/HOLD/NAME=TEMP
The SUBMIT command queues a command procedure for batch processing.
The system assigns a job entry number of 211. The SET ENTRY command
places the job in a hold state and changes the job name to TEMP,
assuming that job 211 had not yet begun execution.
FILE
Modifies the characteristics of one or more files.
Format:
SET FILE file-spec[,...]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
file-spec[,...] Specifies one or more files to be modified. If you specify two or more files, separate them with commas. Wildcard characters are allowed in the file specifications.
Command Qualifiers
Additional information available:
/AI_JOURNAL/BACKUP/BEFORE/BI_JOURNAL/BY_OWNER
/CONFIRM/CREATED/DATA_CHECK/END_OF_FILE/ENTER
/ERASE_ON_DELETE/EXCLUDE/EXPIRATION_DATE/EXTENSION
/GLOBAL_BUFFER/LOG/MODIFIED/NODIRECTORY/OWNER_UIC
/PROTECTION/REMOVE/RU_ACTIVE/RU_FACILITY
/RU_JOURNAL/SINCE/STATISTICS/UNLOCK/TRUNCATE
/VERSION_LIMIT
/AI_JOURNAL
/AI_JOURNAL=(FILE=journal-file,[keyword,...])) /NOAI_JOURNAL Applicable only if you have the RMS Journaling option. See the VAX RMS Journaling Manual. The SET FILE/AI_JOURNAL command marks an RMS file for after-image journaling. You can also specify certain characteristics of the journal file with this command, including its file specification, whether or not it is to be created, its initial size, and its default extension quantity. The SET FILE/NOAI_JOURNAL command un-marks a file for after-image journaling. Keywords: Four keywords are used as parameters to the SET FILE/AI_JOURNAL command: FILE=, [NO]CREATE, ALLOCATION=, and EXTEND_QUANTITY=. You must always use the FILE= keyword; you can use also use any, all, or none of the other three keywords. Use an equal sign (=) immediately after the SET FILE/AI_JOURNAL command to use a keyword. If you use more than one of the keywords, enclose the list in parentheses and separate the items in the list with commas. FILE Specifies the journal file where all modifications (to the named data file) will be recorded. The FILE= keyword is required when you use the SET FILE/AI_JOURNAL command. The default file specification for the journal is the file specification of the data file that you name, but with a file type of .RMS$JOURNAL. If you are using after-image journaling to protect against the loss of data due to a device failure (such as a head crash), you should keep the journal file on a different device from the data file that is being journaled. CREATE Specifies that a new journal file is to be created. If no journal file exists, using this keyword creates a new file. If a journal file (with the file specification given in this command) already exists, using this keyword creates a new version of the journal file. In the latter instance, the data file named in this SET FILE command is journaled to the new journal file. Any other files that are being journaled to the previous version of the journal file will continue to be journaled to that previous version. Every time that you use the CREATE keyword, you should make a backup copy of the data file. If recovery becomes necessary, you will be able to perform after-image recovery only if a backup copy of the data file is available. ALLOCATION Specifies the initial size, in blocks, of the journal file. EXTEND_QUANTITY Specifies the default extension quantity, in blocks, for the journal file. You can specify a value from 0 to 65535. If the file is extended, the value that you specify will be used rather than the system default.
/BACKUP
/BACKUP /NOBACKUP Controls whether the BACKUP command will back up the contents of the specified files. This qualifier is valid only for Files-11 Structure Level 2 files. If you specify /NOBACKUP, BACKUP will record the attributes of the file but not the data in the file. The /NOBACKUP qualifier is useful for saving files that contain unimportant data, such as SWAPFILES.
/BEFORE
/BEFORE[=time] Selects only those files that are dated before the specified time. You can specify either an absolute time or a combination of absolute and delta times. See Chapter 1 of the VMS DCL Concepts Manual for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed.
/BI_JOURNAL
/BI_JOURNAL=(FILE=journal-file,[keyword,...])) /NOBI_JOURNAL Applicable only if you have the RMS Journaling option. See the VAX RMS Journaling Manual. The SET FILE/BI_JOURNAL command marks an RMS file for before-image journaling. You can also specify certain characteristics of the journal file with this command, including its file specification, whether or not it is to be created, its initial size, and its default extension quantity. The SET FILE/NOBI_JOURNAL command un-marks a file for before-image journaling. Keywords Four keywords are used as parameters to the SET FILE/BI_JOURNAL command: FILE=, [NO]CREATE, ALLOCATION=, and EXTEND_QUANTITY=. You can also use any, all, or none of the keywords. Use an equal sign (=) immediately after the SET FILE/BI_JOURNAL command to use a keyword. If you use more than one of the keywords, enclose the list in parentheses and separate the items in the list with commas. FILE Specifies the journal file where all modifications (to the named data file) will be recorded. The default file specification for the journal is the file specification of the data file that you name, but with a file type of RMS$JOURNAL. CREATE Specifies that a new journal file is to be created. If no journal file exists, using this keyword creates a new file. If a journal file (with the file specification given in this command) already exists, using this keyword creates a new version of the journal file. In the latter instance, the data file named in this SET FILE command is journaled to the new journal file. Any other files that are being journaled to the previous version of the journal file will continue to be journaled to that previous version. ALLOCATION Specifies the initial size, in blocks, of the journal file. EXTEND_QUANTITY Specifies the default extension quantity, in blocks, for the journal file. You can specify a value from 0 to 65535. If the file is extended, the value that you specify will be used rather than the system default.
/BY_OWNER
/BY_OWNER[=uic] Selects one or more files only if their owner user identification code (UIC) matches the specified owner UIC. If the /BY_OWNER qualifier is specified without a UIC, the UIC of the current process is assumed.
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether a request is issued before each individual SET FILE
operation to confirm that the operation should be performed on that
file.
When the system issues the prompt, you can issue any of the
following responses:
YES NO QUIT
TRUE FALSE <CTRL/Z>
1 0 ALL
<RET>
You can use any combination of upper- and lowercase letters for word
responses. Word responses can be abbreviated to one or more letters
(for example, T, TR, or TRU for TRUE). Affirmative answers are YES,
TRUE, and 1. Negative answers are NO, FALSE, 0, and <RET>. QUIT or
<CTRL/Z> indicates that you want to stop processing the command at
that point. When you respond with ALL, the command continues to
process, but no further prompts are given. If you type a response
other than one of those in the list, the prompt will be reissued.
/CREATED
/CREATED Selects files based on their dates of creation. This qualifier is relevant only when used with the /BEFORE or /SINCE qualifier.
/DATA_CHECK
/DATA_CHECK[=([NO]READ,[NO]WRITE)] Specifies whether a READ data check, a WRITE data check, or a combination of the two is performed on the file during transfers. If you do not specify either READ or WRITE, a WRITE data check is performed on the file by default.
/END_OF_FILE
/END_OF_FILE Resets the end-of-file mark to the highest block allocated.
/ENTER
/ENTER=new-file-spec Enables you to assign an additional name to a file. The file now has a second name, or alias, but both the original name and the alias reference the same file. For this reason, care should be taken when deleting files which have aliases. In order to keep the file but remove one of its names, use the /REMOVE qualifier with SET FILE. No wildcards are allowed in the file specification. Use of the /ENTER qualifier is discouraged.
/ERASE_ON_DELETE
/ERASE_ON_DELETE Specifies that the specified files will be erased from the disk (not just merely written over) when a command such as DELETE or PURGE is issued for the files. See DELETE/ERASE for more information.
/EXCLUDE
/EXCLUDE=(file-spec[,...]) Any files that match the listed file specifications are excluded from the SET FILE operation. If you specify only one file, you can omit the parentheses. Wildcard characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version. The file specification can contain a directory specification, but not a device specification.
/EXPIRATION_DATE
/EXPIRATION_DATE=date /NOEXPIRATION_DATE Controls whether an expiration date is assigned to the specified files. Specify the date according to the rules described in Chapter 1 of the VMS DCL Concepts Manual. Absolute date keywords are allowed. If you specify 0 as the date, today's date is used. Use of this qualifier requires ownership of the file or access control.
/EXTENSION
/EXTENSION[=n] Sets the default extend quantity for the file. You can specify a value from 0 to 65,535. If you omit the value specification or specify a value of 0, VAX RMS calculates its own /EXTENSION value. See the SET RMS_DEFAULT command for a description of the /EXTEND_QUANTITY qualifier.
/GLOBAL_BUFFER
/GLOBAL_BUFFER=n Specifies the VAX RMS global buffer count for the specified files. Specify a number (n) in the range of 0 through 32,767 to indicate the number of buffers that can be shared by processes accessing the file. A value of 0 disables buffer sharing.
/LOG
/LOG /NOLOG (default) Controls whether the SET FILE command displays the file specification of each file after the modification is made.
/MODIFIED
/MODIFIED Modifies the time value specified with the /BEFORE or /SINCE qualifier. /MODIFIED selects files according to the dates on which they were last modified. This qualifier is incompatible with /CREATED, which also allows you to select files according to time attributes. If you do not specify /MODIFIED, the default is /CREATED.
/NODIRECTORY
/NODIRECTORY Removes the directory attributes of a file. This qualifier allows you to delete the corrupted directory file even if other files are contained in the directory. When you delete a corrupted directory file, the files contained within it become lost. Use ANALYZE/DISK_STRUCTURE/REPAIR to place the lost files in [SYSLOST]. You can then copy the lost files to a new directory. This qualifier is valid only for the Files-11 Structure Level-2 files. For more information about the ANALYZE/DISK_STRUCTURE Utility, see the VMS Analyze/Disk_Structure Utility Manual.
/OWNER_UIC
/OWNER_UIC[=uic] Requires GRPPRV (group privilege) privilege to set the owner to another member of the same group. Requires SYSPRV (system privilege) privilege to set the owner to any UIC outside your group. Sets the owner user identification code (UIC) of the file to the specified UIC. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual.
/PROTECTION
/PROTECTION[=(code)] Enables you to change or reset the protection for one or more of your files. If no protection code is specified, the access of the specified files is set to the current default protection. SET FILE/PROTECTION cannot be used to change protection on a file over DECnet.
/REMOVE
/REMOVE Enables you to remove one of the names of a file that has more than one name, without deleting the file. If you have created an additional name for a file with the /ENTER qualifier of SET FILE, you can use the /REMOVE qualifier to remove either the original name or the alias. The file still exists and can be accessed by whatever name or names remain in effect. However, if you accidentally remove the name of a file that has only one name, you will not be able to access that file with most DCL commands; you will have to use the ANALYZE/DISK_STRUCTURE Utility to retrieve the file. Use of the /REMOVE qualifier is therefore discouraged.
/RU_ACTIVE
/RU_ACTIVE[=ru-facility] /NORU_ACTIVE Applicable only if you have the RMS Journaling option. See the VAX RMS Journaling Manual. The SET FILE/RU_ACTIVE command lets you designate the recoverable facility that controls active recovery units for the specified file; alternatively, it lets you clear the designation that a recoverable facility controls active recovery units for the specified file. The SET FILE/RU_ACTIVE command sets the RU_ACTIVE attribute on the file, corresponding to the recoverable facility that you specify. Use the SET FILE/RU_ACTIVE command in conjunction with the SET FILE/RU_FACILITY command to modify the facility that controls any active recovery units, or to clear the RU_ACTIVE attribute that may be set for a given file. The ru_facility is the number or name of a recoverable facility. It can be an integer from 0-255, or it can be the name of a DIGITAL-registered recoverable facility. RMS is recoverable facility 1; if you specify the number "1", that is equivalent to using the text "RMS". The number 0 corresponds to no recoverable facility and is equivalent to using the qualifier /NORU_ACTIVE.
/RU_FACILITY
/RU_FACILITY=ru-facility /NORU_FACILITY Applicable only if you have the RMS Journaling option. See the VAX RMS Journaling Manual. Identifies a recoverable facility for the file, allowing you access to a file that might otherwise be inaccessible because of active recovery units. You can use any other SET FILE qualifier along the /RU_FACILITY= qualifier. When a data file has active recovery units and RMS Journaling cannot resolve the recovery units (for example, if the recovery unit journal file is unavailable), the data file cannot be opened or even deleted. With the SET FILE/RU_FACILITY= command, you can gain access to a file that might otherwise be held by a recoverable facility (for example, RMS holding a file with active recovery units), and you can subsequently un-mark the file (in the latter case, for recovery unit journaling) and delete it. The number 0 corresponds to no recoverable facility and is equivalent to using the qualifier /NORU_FACILITY.
/RU_JOURNAL
/RU_JOURNAL[=keyword] /NORU_JOURNAL Applicable only if you have the RMS Journaling option. See the VAX RMS Journaling Manual. The SET FILE/RU_JOURNAL command marks an RMS file for recovery unit journaling. A data file must be marked for recovery unit journaling with the SET FILE/RU_JOURNAL command (and appropriate recovery unit services must be used in an application program) in order to use recovery unit journaling for a data file. You can also specify the default device on which recovery unit journals will be created for this file with this command. Keywords DEVICE=device-name-for-ru-journal LABEL=volume-name-for-ru-journal The DEVICE and LABEL keywords specify the default volume for recovery unit journals. By default, temporary recovery unit journal files are created in the [SYSJNL] directory on the same device as the file that is being journaled. Use the DEVICE=device-name-for-ru-journal keyword to specify the location of recovery unit journals using a device name or a logical name. Use the LABEL=volume-name-for-ru-journal keyword to specify the location of recovery unit journals using a volume label. You can only use one of these two keywords (LABEL= or DEVICE=) to specify the recovery unit journal location.
/SINCE
/SINCE[=time] Selects only those files that are dated after the specified time. You can specify either an absolute time or a combination of absolute and delta times. See Chapter 1 of the VMS DCL Concepts Manual for for complete information on specifying time values. You can also use the keywords TODAY, TOMORROW, and YESTERDAY. If no time is specified, TODAY is assumed.
/STATISTICS
/STATISTICS /NOSTATISTICS (default) Enables the gathering of RMS statistics on the specified file. These statistics can subsequently be viewed using the Monitor Utility, which is invoked with the DCL command MONITOR.
/UNLOCK
/UNLOCK Requests that one or more files be unlocked. A locked file is a file which has become inaccessible as a result of having been improperly closed.
/TRUNCATE
/TRUNCATE Requests that the file is to be truncated at the end of the block containing the end-of-file (EOF) mark.
/VERSION_LIMIT
/VERSION_LIMIT[=n] Specifies the maximum number of versions a file can have. If you do not specify a version limit, a value of 0 is used, indicating that the number of versions of a file is limited only to the Files-11 architectural limit, 32,767. When you create a new version of a file that would cause the version limit to be exceeded, the earliest version is deleted from the directory. When the /VERSION_LIMIT qualifier is in effect, only one version of a file is deleted each time a new file is created. For example, if you set the version limit to 3 when there are already five versions of that file in your directory, there will continue to be five versions of the file unless you specifically delete some or purge the directory. Once the number of versions is equal to or less than the current version limit, the version limit will be maintained.
Examples
1. $ SET FILE/EXPIRATION_DATE=15-APR-1988:11:00 BATCH.COM;3 The SET FILE command requests that the expiration date of the file BATCH.COM;3 be set to 11:00 A.M., April 15, 1988. 2. $ SET FILE/BEFORE=15-APR/ERASE_ON_DELETE PERSONNEL*.SAL This SET FILE command calls for all files that match the file specification PERSONNEL*.SAL and that are dated before April 15 of the current year to have their disk locations erased whenever one of them is deleted with commands such as DELETE or PURGE. 3. $ SET FILE/OWNER_UIC=[360,020]/VERSION_LIMIT=100 MYFILE.DAT The SET FILE command modifies the characteristics of the file MYFILE.DAT, changing the owner UIC and assigning a file version limit of 100. Note that you must have system privilege (SYSPRV) in order to change the owner UIC.
/ACL
Allows you to modify the access control list (ACL) of one or more
files. The /ACL qualifier is required.
As of Version 5.0 of VMS, the SET FILE/ACL command is superseded
by the SET ACL command. SET FILE/ACL is synonymous with SET
ACL/OBJECT_TYPE=FILE. DIGITAL recommends usage of the SET ACL
command.
Format:
SET FILE/ACL[=(ace[,...])] file-spec[,...]
HOST
Connects your terminal (through the current host processor) to
another processor, called the remote processor. Both processors
must be running DECnet.
Format:
SET HOST node-name
Additional information available:
ParametersCommand QualifiersExamples
Parameters
node-name Specifies the node name of the remote processor.
Command Qualifiers
Additional information available:
/BUFFER_SIZE
/BUFFER_SIZE=n Changes the packet size of the protocol message sent between the terminal and the remote processor if a connection to the remote processor is already established. The default buffer size is 1010 bytes; the value for n can range from 140 bytes to 1024 bytes. N is reset to 140 bytes if a value below 140 is specified; a value for n above 1024 bytes is reset to 1024.
/LOG
/LOG[=file-spec] /NOLOG (default) Controls whether a log file of the entire session is kept. If you use /LOG without the file specification, the log information is stored in the file SETHOST.LOG.
/RESTORE
/RESTORE /NORESTORE (default) Saves terminal characteristics before a remote terminal session is begun and restores them when the remote session is terminated.
Examples
1. $ SET HOST ALBANY
Username: SMITH
Password:
This SET HOST command connects the user terminal to the processor at
the network node named ALBANY. The remote processor then prompts
for user name and password. Use the normal login procedure to log
in to the remote processor.
2. $ SET HOST/BUFFER_SIZE=160 ROMIC
Username: BROWN
Password:
$ TYPE SCHEDULES.TXT
.
.
.
In this example, user BROWN on node SERIF logs in to remote node
ROMIC. BROWN wants to view the contents of a very large file and
resets the buffer size to force more frequent write operations to
the terminal screen. By changing the buffer size to a value just
about the minimum value of 140 bytes, the contents of SCHEDULES.TXT
should scroll more quickly to the screen.
3. $ SET TERMINAL/WIDTH=80
$ SET HOST/RESTORE GENEVA
Username: Jones
Password:
$ SET TERMINAL/WIDTH=132
.
.
.
$ logout
JONES logged out at 19-APR-1987 11:04:51.45
%REM-S-END, control returned to node _ORACLE
In this example, user JONES on node ORACLE logs into remote node
GENEVA and specifies that the original terminal screen width be
restored to 80 characters when the remote session is terminated.
/DTE
Connects your system to a remote system through an out-going
terminal line.
Format:
SET HOST/DTE terminal-name
Additional information available:
ParametersCommand QualifiersExamples
Parameters
terminal-name Specifies the name of an out-going terminal line, which connects your system either directly to another system, or to a modem.
Command Qualifiers
Additional information available:
/DIAL
/DIAL=(NUMBER:number[,MODEM_TYPE:modem-type]) Allows a modem attached to the out-going terminal line to be autodialed using the autodial protocol of that modem. The NUMBER: parameter is required and must be followed by the telephone number that is to be autodialed. The optional MODEM_TYPE: parameter may be used to specify a modem-type of DF03, DF112, or DMCL. The default modem-type is DF03. The modem-type DMCL indicates any modem that uses the DEC Modem Command Language. In addition, MODEM_TYPE: may be used to specify a modem-type other than a DF03, DF112, or DMCL. A template is provided for users who are interested in supporting other modems with autodial capabilities (see SYS$EXAMPLES:DTE_DF03.MAR).
/LOG
/LOG[=file-spec] /NOLOG Controls whether a log file of the entire session is kept. If you use the /LOG qualifier without the file specification, the log information is stored in the file SETHOST.LOG. When used to log a modem session, the log file will contain any noise which occurred on the phone line. For example, typing a file in order to get it recorded in the log file could result in noise being recorded along with the file data. Therefore, the use of the /LOG qualifier is not recommended for the purpose of file transfers. Asynchronous DECnet is the recommended way to transfer files. For additional information, see the VMS Networking Manual.
Examples
1. $ SET HOST/DTE TTA2:/DIAL=NUMBER:5551234
Username: SMITH
Password:
This SET HOST/DTE command connects the user terminal to the
out-going terminal line TTA2:, which is attached to a modem (type
DF03 by default) set to autodial the phone number 555-1234. The
remote processor then prompts for user name and password. Use the
normal login procedure to log in to the remote system.
2. $ SET HOST/DTE/DIAL=(NUMBER:5551234#,MODEM_TYPE:DF112) TTA2:
Username: SMITH
Password:
This command accomplishes the same thing as in the first example,
except that it uses the DF112 modem. Note that the number sign (#)
is required to activate the autodialer in the DF112.
/HSC
Connects your terminal to a remote HSC50 through the Computer
Interconnect bus.
Format:
SET HOST/HSC node-name
Additional information available:
Parameters
node-name Specifies the node name of the remote HSC50.
Command Qualifiers
Additional information available:
/LOG
/LOG[=file-spec] /NOLOG (default) Controls whether a log file of the entire session is kept. If you use /LOG without the file specification, the log information is stored in the file HSCPAD.LOG.
KEY
Changes the current key definition state. Keys are defined by the
DEFINE/KEY command.
Format:
SET KEY
Additional information available:
Command Qualifiers
Additional information available:
/LOG
/LOG (default) /NOLOG Controls whether the system displays a message indicating that the key state has been set
/STATE
/STATE=state-name /NOSTATE Specifies the state for the system to set. The state name can be any alphanumeric string. If you omit the /STATE qualifier or use /NOSTATE, the current state is left unchanged. The default state is DEFAULT.
LOGINS
Sets a limit on the number of users who can gain access to the
operating system. This command also displays the current
interactive level as described below.
Format:
SET LOGINS
Additional information available:
Command Qualifiers
Additional information available:
/INTERACTIVE
/INTERACTIVE[=n] Establishes the number of interactive users allowed to gain access to the system. When you do not supply a parameter value, SET LOGINS displays the current status of the login quotas.
MAGTAPE
Defines the default characteristics associated with a specific
magnetic tape device for subsequent file operations.
Format:
SET MAGTAPE device-name[:]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
device-name[:] Specifies the name of the magnetic tape device for which the characteristics are to be set. The device must not be currently allocated to any other user.
Command Qualifiers
Additional information available:
/DENSITY/END_OF_FILE/LOG/LOGSOFT/REWIND/SKIP
/UNLOAD
/DENSITY
/DENSITY=density Specifies the default density, in bits per inch (bpi), for all write operations on the magnetic tape device when the volume is mounted as a foreign tape or as an unlabeled tape. The density can be specified as 800, 1600, or 6250, if supported by the magnetic tape drive.
/END_OF_FILE
/END_OF_FILE Writes a tape mark at the current position on the magnetic tape volume.
/LOG
/LOG /NOLOG Displays information about the operations performed on the magnetic tape volume.
/LOGSOFT
/LOGSOFT (default) /NOLOGSOFT Controls whether soft errors on the specified device are to be logged in the error log file. Soft errors are errors that are corrected by the hardware without software intervention. This qualifier only affects devices that support hardware error correction, such as the TU78 magnetic tape drive. When used with other devices, this qualifier has no effect.
/REWIND
/REWIND Requests that the volume on the specified device be rewound to the beginning of the magnetic tape.
/SKIP
/SKIP=option
Requests that the magnetic tape volume be positioned according to any
of the following options:
BLOCK:n Directs the SET MAGTAPE command to skip the specified
number of blocks
END_OF_TAPE Directs the SET MAGTAPE command to position the volume
at the end-of-tape mark
FILES:n Directs the SET MAGTAPE command to skip the specified
number of files
RECORD:n Directs the SET MAGTAPE command to skip the specified
number of records
/UNLOAD
/UNLOAD Requests that the volume on the specified device be rewound and unloaded.
Examples
1. $ MOUNT MTB1:/FOREIGN
$ SET MAGTAPE MTB1: /DENSITY=800
The MOUNT command mounts a foreign tape on the device MTB1. The SET
MAGTAPE command defines the density for writing the magnetic tape at
800 bpi.
2. $ MOUNT MTA0:/FOREIGN
$ SET MAGTAPE MTA0:/SKIP=FILES:4
The MOUNT command mounts a foreign tape on the device MTA0; the SET
MAGTAPE command directs the magnetic tape position to skip four
files.
MESSAGE
Sets the format for system messages or specifies a process level
message file. Lets you override or supplement the system messages.
Format:
SET MESSAGE [file-spec]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
file-spec Name of the process level message file. Messages in this file supersede messages for the same conditions in the system message file or in an existing process message file. The default file type is EXE. No wildcard characters are allowed. If this parameter is not specified, the qualifiers apply to the system message file.
Command Qualifiers
Additional information available:
/DELETE/FACILITY/IDENTIFICATION/SEVERITY/TEXT
/DELETE
/DELETE Removes the currently selected process message file from your process. Do not specify file-spec with this qualifier.
/FACILITY
/FACILITY (default) /NOFACILITY Displays the facility name prefix for all messages that are returned for your process.
/IDENTIFICATION
/IDENTIFICATION (default) /NOIDENTIFICATION Displays the message identification prefix for all messages that are returned for your process.
/SEVERITY
/SEVERITY (default) /NOSEVERITY Displays the severity level for all messages that are returned for your process.
/TEXT
/TEXT (default) /NOTEXT Displays the message text for all messages that are returned for your process.
Examples
1. $ TYPE XXX
%TYPE-W-OPENIN, error opening DB1:[MALCOLM]XXX.LIS; as input
-RMS-E-FNF, file not found
.
.
.
$ SET MESSAGE/NOIDENTIFICATION
.
.
.
$ TYPE XXX
%TYPE-W, error opening DB1:[MALCOLM]XXX.LIS; as input
-RMS-E, file not found
When the first TYPE command is issued, the error messages include
all fields. Later, the SET MESSAGE command establishes that the
IDENT portion (the abbreviation for the message text) is omitted in
future messages. Note the absence of the IDENT component in the two
subsequent messages that result from attempting to type a file that
does not exist.
2. $ SET MESSAGE NEWMSG
The SET MESSAGE command specifies that the message text in
NEWMSG.EXE supplements the existing system messages.
ON
Controls whether the command interpreter performs error checking
following the execution of each command in a command procedure.
Format:
SET [NO]ON
Additional information available:
Examples
1. $ SET NOON
$ DELETE *.SAV;*
$ SET ON
$ COPY *.OBJ *.SAV
This command procedure routinely copies all object modules into new
files with the file type SAV. The DELETE command first deletes all
existing files with the SAV file type, if any. The SET NOON command
ensures that the procedure will continue execution even if there are
no files with the SAV file type in the current directory. Following
the DELETE command, the SET ON command restores error checking.
Then the COPY command makes copies of all existing files with OBJ
file type.
OUTPUT_RATE
Sets the rate at which output is written to a batch job log file.
Format:
SET OUTPUT_RATE[=delta-time]
Additional information available:
Parameters
delta-time Specifies how often output will be written from the output buffer to the batch job log file. See Chapter 1 of the VMS DCL Concepts Manual for information on how to specify a delta time. If you do not specify a delta time, then DCL writes the information in the output buffer to the log file but does not change the default output rate.
Examples
1. $ SET OUTPUT_RATE=:0:30
.
.
.
This command, when executed within a batch job, changes the default
output rate from once a minute to once every 30 seconds.
PASSWORD
Allows users to change their own passwords. Also allows system
managers to change the system password.
Format:
SET PASSWORD
Additional information available:
Command Qualifiers
Additional information available:
/GENERATE
/GENERATE[=value] Requests that passwords be generated for you. If the /GENERATE qualifier is used, the system will display five random passwords and ask you to select one of them. If you do not like any of the passwords displayed, pressing RETURN will cause five new passwords to be displayed. The optional value determines the number of letters in the passwords generated. For any value, n, SET PASSWORD will generate passwords of from n to (n+2) characters in length. Values of 1 through 10 may be specified. If no value is specified, SET PASSWORD will use a default value of 6, and will generate passwords of from 6 to 8 characters in length. If a value larger than 10 is specified, it will be ignored and a value of 10 (the largest acceptable value) will be used instead. Note that if your system manager has established a minimum password length for your account, SET PASSWORD/GENERATE=n will compare that length with the length of the optional value, and use the larger of the two values.
/SECONDARY
/SECONDARY Allows you to change your secondary password, or to create one if you do not currently have one. The procedure is the same as for setting your primary password. Once a secondary password has been established, you will receive two PASSWORD: prompts when logging in. The primary password should be typed in first, followed by the secondary password. You may remove your secondary password by specifying a RETURN, when SET PASSWORD/SECONDARY prompts you for a new password and verification. Once this is done, you will only receive a single PASSWORD: prompt when logging in. Secondary passwords make it possible to set up an account, such that two different people, each knowing one of the two passwords, would be required to access that account. The /SECONDARY and /SYSTEM qualifiers are incompatible.
/SYSTEM
/SYSTEM Requires both SECURITY and CMKRNL privileges. Indicates that you are changing the system password, rather than your user password. If a terminal line has the system password (SYSPWD) characteristic set, no terminal prompts will be sent to that terminal until the system password is entered. A system password is valid only for the node it is set on. In a VAXcluster, each node can have a different system password. The /SYSTEM and /SECONDARY qualifiers are incompatible.
Examples
1. $ SET PASSWORD
Old password: HONCHO
New password: BIG_ENCHILADA
Verification: BIG_ENCHILADA
In response to the SET PASSWORD command, the system prompts for the
old password, next for the new password. Then the system asks for
the new password again for verification purposes. If the user is
authorized to change this account's password, if the old password is
given correctly, and if the new password is given identically twice,
the password is changed. Otherwise, an error message appears and
the password remains unchanged.
Note that in a real session, neither the old password nor the new
password and its verification appear on the screen or paper.
PRINTER
Establishes the characteristics of a specific line printer. The
defaults listed below are the defaults for an initially bootstrapped
system.
Format:
SET PRINTER printer-name[:]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
printer-name[:] Specifies the name of a line printer that will have its characteristics set or modified. If the printer has been set to /SPOOLED, the logical I/O privilege (LOG_IO) is required to modify its characteristics.
Command Qualifiers
Additional information available:
/CR/FALLBACK/FF/LA11/LA180/LOWERCASE
/LOG/LP11/PAGE/PASSALL/PRINTALL/TAB/TRUNCATE
/UNKNOWN/UPPERCASE/WIDTH/WRAP
/CR
/CR /NOCR (default) Controls whether the printer driver outputs a carriage return character. Use this qualifier for printers on which line feeds do not imply carriage returns. Specify /NOCR for printers where the line feed, form feed, vertical feed, and carriage return characters empty the printer buffer. The /NOCR qualifier causes carriage return characters to be held back and output only if the next character is not a form feed or vertical tab. Carriage return characters are always output on devices that have the carriage return function characteristic set.
/FALLBACK
/FALLBACK /NOFALLBACK (default) Determines whether or not the printer attempts to translate characters belonging to the DEC Multinational Character Set into 7-bit equivalent representations. If a character cannot be translated, an underscore character is substituted. If the /PASSALL qualifier is in effect, it has precedence over the /FALLBACK qualifier.
/FF
/FF (default) /NOFF Indicates whether the printer performs a mechanical form feed. Use the /NOFF qualifier when the printer does not automatically perform mechanical form feeds. This qualifier allows the driver to convert form feeds into multiple line feeds and to output them.
/LA11
/LA11 Allows the operator to set the appropriate printer type when the printer is an LA11 line printer. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. If no printer type is specified, LP11 is assumed.
/LA180
/LA180 Allows the operator to set the appropriate printer type when the printer is an LA180 line printer. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. If no printer type is specified, LP11 is assumed.
/LOWERCASE
/LOWERCASE /NOLOWERCASE (default) Indicates whether the printer prints both upper- and lowercase letters or only uppercase. When the operator specifies the /NOLOWERCASE qualifier, all letters are translated to uppercase. The /[NO]LOWERCASE and /[NO]UPPERCASE qualifiers are complementary; that is, /LOWERCASE is equivalent to /NOUPPERCASE, and /NOLOWERCASE is equivalent to /UPPERCASE.
/LOG
/LOG /NOLOG (default) Determines whether information confirming the printer setting is displayed at the terminal from which the SET PRINTER command was issued.
/LP11
/LP11 (default) Allows the operator to set the appropriate printer type when the printer is an LP11 line printer. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. LP11 is the default printer type.
/PAGE
/PAGE=n Establishes the number of lines per page on the currently installed form; the number of lines can range from 1 through 255. The printer driver uses this value to determine the number of line feeds that must be issued to simulate a form feed. (See the /FF\/NOFF qualifier description for SET PRINTER.) The default value is 64 lines per page.
/PASSALL
/PASSALL /NOPASSALL (default) Controls whether the system interprets special characters or passes them as 8-bit binary data. If you specify /PASSALL, the printer does not expand tab characters to spaces, fill carriage return or line feed characters, or recognize control characters.
/PRINTALL
/PRINTALL /NOPRINTALL (default) Controls whether the line printer driver outputs printable 8-bit multinational characters.
/TAB
/TAB /NOTAB (default) Controls how the printer handles TAB characters. The /NOTAB qualifier expands all tab characters to spaces and assumes tab stops at eight character intervals. Use the /TAB qualifier when you do not want the system to convert tabs to spaces, but want the printer to process the tab characters. The VMS operating system requires that printers expand tabs at eight-character intervals.
/TRUNCATE
/TRUNCATE (default) /NOTRUNCATE Controls whether the printer truncates data exceeding the value specified by the /WIDTH qualifier. Note that the /TRUNCATE and /WRAP qualifiers are incompatible.
/UNKNOWN
/UNKNOWN Allows the operator to set the appropriate printer type when the printer is an unknown type. This qualifier provides information for the SHOW PRINTER command, which, in turn, provides the user with information about specific printers. If no printer type qualifier is specified, LP11 is assumed.
/UPPERCASE
/UPPERCASE (default) /NOUPPERCASE Indicates whether the printer prints both uppercase and lowercase letters or only uppercase ones. When you specify /UPPERCASE, all letters are translated to uppercase. The /[NO]UPPERCASE and /[NO]LOWERCASE qualifiers are complementary; that is, /UPPERCASE is equivalent to /NOLOWERCASE, and /NOUPPERCASE is equivalent to /LOWERCASE.
/WIDTH
/WIDTH=n Establishes the number of characters per output line on currently installed forms. The width, n, can range from 0 through 65535 for LP11 controllers, and from 0 through 255 for DMF32 controllers. The default value is 132 characters per line.
/WRAP
/WRAP /NOWRAP (default) Controls whether the printer generates a carriage return/line feed when it reaches the end of a line. If the /NOWRAP qualifier is specified, the printer will write characters out in the last position on the line. If the /WRAP qualifier is specified, the terminal generates a carriage return/line feed whenever the end of a line is reached. Note that the /TRUNCATE and /WRAP qualifiers are incompatible.
Examples
1. $ SET PRINTER/PAGE=60/WIDTH=80 LPA0: The SET PRINTER command establishes the size of an output page as 60 lines and the width of a line as 80 characters for printer LPA0. 2. $ SET PRINTER/LA11 LPB0: The SET PRINTER command establishes the line printer LPB0 as an LA11 printer. 3. $ SET PRINTER/LOWERCASE LPA0: The SET PRINTER command requests that lowercase printing be enabled on line printer LPA0.
PROCESS
Changes the execution characteristics associated with the specified
process for the current terminal session or job. If no process is
specified, changes are made to the current process.
Format:
SET PROCESS [process-name]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
process-name Specifies the name of the process for which the characteristics are to be changed. The process name can contain from 1 to 15 alphanumeric characters. Process names are linked to group numbers. The specified process must have the same group number in its user identification code (UIC) as the current process. You cannot specify the process-name for a process outside of your group. To change the characteristics of a process outside of your group, you must use the qualifier /IDENTIFICATION=pid. If you specify the /IDENTIFICATION qualifier, the process name parameter is ignored. If you include neither the process name nor the /IDENTIFICATION qualifier, the current process is assumed. The process name parameter is limited to use only with the /PRIORITY, /RESUME, and /SUSPEND qualifiers.
Command Qualifiers
Additional information available:
/DUMP/IDENTIFICATION/NAME/PRIORITY/PRIVILEGES
/RESOURCE_WAIT/RESUME/SUSPEND/SWAPPING
/DUMP
/DUMP /NODUMP (default) If an image terminates due to an unhandled condition, the /DUMP qualifier causes the contents of the address space to be written to a file in your current default directory. The file name will be the same as the image which terminated. The file type will be DMP. You can then use the ANALYZE/PROCESS_DUMP utility to analyze the dump.
/IDENTIFICATION
/IDENTIFICATION=pid Specifies the process identification value (PID) of the process for which characteristics are to be changed. The PID is assigned by the system when the process is created. When you specify a PID, you can omit the leading zeros. If you use the /IDENTIFICATION qualifier, the process name parameter is ignored. The /IDENTIFICATION qualifier can be used only with the /PRIORITY, /RESUME, and /SUSPEND qualifiers.
/NAME
/NAME=string Changes the name of the current process to the specified name. The string parameter can have from 1 to 15 alphanumeric characters.
/PRIORITY
/PRIORITY=n Requires GROUP or WORLD privilege to change the priority of other processes on the system. Requires alter priority (ALTPRI) privilege to set the priority higher than the base priority of the current process. Changes the priority for the specified process. If you do not have the ALTPRI privilege, the value you specify is compared to your current base priority, and the lower value is always used. GROUP or WORLD privilege is required to change the priority of other processes on the system.
/PRIVILEGES
/PRIVILEGES=(privilege[,...]) Requires SETPRV to enable a privilege that you are not authorized to have. Enables or disables the user privileges for the current process. If you specify only one privilege, you can omit the parentheses. See Appendix A in the VMS DCL Concepts Manual for a list of the privilege keywords. The table also contains a description of each privilege. If you do not have SETPRV, the privilege is not enabled, and a warning message is issued. Use the SHOW PROCESS/PRIVILEGES command to determine what privileges are currently enabled.
/RESOURCE_WAIT
/RESOURCE_WAIT
/NORESOURCE_WAIT
Enables or disables resource wait mode for the current process.
If you specify /NORESOURCE_WAIT, the process will receive an error
status code when system dynamic memory is not available or when the
process exceeds one of the following resource quotas:
Direct I/O limit
Buffered I/O limit
Buffered I/O byte count (buffer space) quota
/RESUME
/RESUME Specifies that a process suspended by a previous SET PROCESS command is to be resumed.
/SUSPEND
/SUSPEND[=keyword]
/NOSUSPEND
Requires privileges. See the text.
Temporarily stops the process's activities. The process remains
suspended until another process resumes or deletes it. Use the
qualifiers /NOSUSPEND and /RESUME to resume a suspended process.
Specify either of the following keywords with /SUSPEND to produce
different results:
Keyword Result
SUPERVISOR (default) Specifies that the named process will be
suspended to allow the delivery of
Asynchronous System Traps (ASTs) at EXEC or
KERNEL mode. Specifying this keyword is
optional.
KERNEL Specifies that the named process will be
suspended such that no asynchronous system
traps (ASTs) can be delivered. To specify
the KERNEL keyword, you must be in either
kernel mode or exec mode, or have either
CMKRNL or CMEXEC privilege enabled. Note
that this was the default behavior of SET
PROCESS/SUSPEND for Versions of VMS prior
to Version 5.0.
Depending on the operation, the process from which you specify
/SUSPEND requires privileges. You must have GROUP privilege to
suspend another process in the same group, unless that process has
the same UIC. You must have WORLD privilege to suspend any other
process in the system.
Note that you can specify SET PROCESS /SUSPEND=KERNEL to override
a previous SET PROCESS/SUSPEND=SUPERVISOR. SET PROCESS /SUSPEND=
SUPERVISOR does not, however, override SET PROCESS/SUSPEND=KERNEL.
/SWAPPING
/SWAPPING (default) /NOSWAPPING Requires the user privilege process swap privilege (PSWAPM) to disable swapping for your process. Enables or disables process swap mode for the current process. By default, a process that is not currently executing can be removed from physical memory so that other processes can execute. If you specify /NOSWAPPING, the process is not swapped out of the balance set when it is in a wait state.
Examples
1. $ SET PROCESS/NORESOURCE_WAIT
The SET PROCESS command disables resource wait mode for the current
process.
2. $ RUN/PROCESS_NAME=TESTER CALC
%RUN-S-PROC_ID, identification of created process is 0005002F
$ SET PROCESS/PRIORITY=10 TESTER
The RUN command creates a subprocess and gives it the name TESTER.
Subsequently, the SET PROCESS/PRIORITY command assigns the
subprocess a priority of 10.
3. $ SHOW PROCESS/SUBPROCESS
17-FEB-1988 12:17:24.45 VTA13: User: CHEESE
Processes in this tree:
CHEESE *
CHEESE_1
CHEESE_2
$ SET PROCESS/SUSPEND=KERNEL CHEESE_2
$
The SET PROCESS/SUSPEND=KERNEL command in this example suspends the
process CHEESE_1 such that no ASTs can be delivered to it.
PROMPT
Enables you to have DCL use a different prompt string.
Format:
SET PROMPT[=string]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
string Specifies the string to replace the default DCL prompt string ($ ). The string can consist of more than one character. All valid ASCII characters can be used in the string. In order to include spaces or lowercase letters in your string, you must enclose the string in quotation marks. Otherwise, letters are automatically converted to uppercase, and leading and trailing spaces are removed. If no string is specified with the SET PROMPT command, the DCL default prompt string ($ ) is restored.
Command Qualifiers
Additional information available:
/CARRIAGE_CONTROL
/CARRIAGE_CONTROL (default) /NOCARRIAGE_CONTROL Determines whether carriage return and line feed characters are inserted before the prompt string.
Examples
1. $ SET PROMPT ="DCL ---> "
DCL ---> SHOW TIME
15-APR-1987 14:08:58
The dollar sign prompt is replaced with the string "DCL ---> ".
When you see the prompt on your screen, you can enter any DCL
command. This example uses the SHOW TIME command.
PROTECTION
Establishes the protection to be applied to a particular file or a
group of files. The protection of a file limits the type of access
available to system users.
o Establish the default protection for all the files subsequently
created during the terminal session or batch job (see /DEFAULT).
o Establish the protection to be applied to a specific
non-file-structured device (see /DEVICE).
Note that SET PROTECTION cannot be used to change protection on a
file over DECnet.
Format:
SET PROTECTION[=(code)] file-spec[,...]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
code Defines the protection to be applied to the specified files. If no code is included, the access of the specified files is set to the current default protection. The format for specifying the code is described in Chapter 8 of the VMS DCL Concepts Manual. file-spec[,...] Specifies one or more files for which the protection is to be changed. A file name and file type are required; if you omit a version number, the protection is changed for only the highest existing version of the file. You can specify wildcard characters in the directory, file name, file type, and version fields.
Command Qualifiers
Additional information available:
/CONFIRM
/CONFIRM /NOCONFIRM (default) Controls whether the SET PROTECTION command displays the file specification of each file before applying the new protection, and requests you to confirm that the file's protection should be changed. If you specify /CONFIRM, you must respond to the prompt with a Y (YES) or a T (TRUE), and then press RETURN before the SET PROTECTION command will change the file protection. If you enter anything else, such as N or NO, the requested file protection is not applied.
/LOG
/LOG /NOLOG (default) Controls whether the SET PROTECTION command displays the file specification of each file after it has reset the protection.
/PROTECTION
/PROTECTION=(code) File-spec qualifier. Defines the protection code to be applied to the associated file specification. Use this qualifier to assign different protection codes to several files with a single SET PROTECTION command. If you specify the command's code parameter in addition to using the /PROTECTION qualifier with a file specification, the attributes specified with the command's code parameter are applied first. Any attributes specified with the /PROTECTION qualifier override the command's code parameter attributes. Specify the protection code using the format described in Chapter 8 of the VMS DCL Concepts Manual.
Examples
1. $ SET PROTECTION -
$_PAYROLL.LIS/PROTECTION=(SYSTEM:R,OWNER:RWED,GROUP:RW),-
$_PAYROLL.OUT/PROTECTION=(SYSTEM:RWED,GROUP:RWED,W)
The SET PROTECTION command changes the protection codes applied to
two files. To the file PAYROLL.LIS, it gives the system read-only
access; the owner read, write, execute, and delete access; and users
in the owner's group read and write access. To the file
PAYROLL.OUT, it gives the system and group all types of access; the
current access for the owner does not change, but the world is
denied all types of access.
2. $ SET PROTECTION A.DAT, B.DAT/PROTECTION=OWNER:RWED, C.DAT
The SET PROTECTION command specifies that the file A.DAT receive the
default protection established for your files. The existing
protection for the file B.DAT is overridden, only for the owner
category, to provide read, write, execute, and delete access. Note
that no protection is specified for the file C.DAT at either the
command or file level. Thus, like A.DAT, C.DAT receives the default
protection.
Since no version numbers are specified, the protection settings
affect only the highest versions of the three files.
3. $ SET PROTECTION=OWNER:D -
$_[MALCOLM.SUB1]SUB2.DIR/PROTECTION=GROUP:D
The SET PROTECTION command changes the protection for the owner and
group categories of the subdirectory [MALCOLM.SUB1.SUB2] to permit
deletion. However, the protection for the world and system
categories is not changed.
4. $ DIR/PROTECTION INCOME.DAT
Directory DBA0:[SMITH]
INCOME.DAT;2 (RWED,RWED,RWED,RWED)
INCOME.DAT;1 (RWED,RWED,RWED,RWED)
Total of 2 files.
$ SET PROTECTION=(OWNER:RWE) INCOME.DAT;1
$ PURGE
The file INCOME.DAT;1 has been protected against deletion by the
owner. However, since the owner is also a member of the group and
world categories, the file is still vulnerable to deletion. The
subsequent PURGE command will delete INCOME.DAT;1.
In order to protect the file against deletion by you (the owner),
you also need to protect the file against deletion by all outer
access categories. The following command shows the proper way to do
this.
$ SET PROTECTION=(OWNER:RWE,GROUP:RWE,WORLD:RWE) INCOME.DAT;1
/DEFAULT
Establishes the default protection for all files subsequently
created during the terminal session or batch job. The protection
for a file limits the type of access available to system users. The
/DEFAULT qualifier is required.
Format:
SET PROTECTION[=(code)]/DEFAULT
Additional information available:
Parameters
code Defines the protection to be applied to all files subsequently created in cases where a different protection is not specified with the SET PROTECTION or CREATE commands. The format for specifying the protection code is described in Chapter 8 of the VMS DCL Concepts Manual. If you fail to specify a protection code, the current default protection remains unchanged.
Examples
1. $ SET PROTECTION=(GROUP:RWED,WORLD:R)/DEFAULT The SET PROTECTION/DEFAULT command sets the default protection applied to all files subsequently created in this terminal session or batch job, allowing other users in the same group unlimited access and all users read access. The default protections for system and owner are not changed.
/DEVICE
Establishes the protection to be applied to a specific
non-file-structured device. The protection for a device limits the
type of access available to users. The /DEVICE qualifier is
required.
Format:
SET PROTECTION[=code]/DEVICE device-name[:]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
code Establishes the protection code for a device. The protection code defines the user and type of access allowed the user. The code should be specified according to the syntax rules explained in the Description section below. Only those protection code categories specified for the code parameter will be changed. Any protection code category that the operator does not specify will remain unchanged. device-name[:] Specifies the name of the device whose protection is to be set or modified. The device must be a non-file-structured device.
Command Qualifiers
Additional information available:
/OWNER_UIC
/OWNER_UIC=uic Requests that the specified user identification code (UIC) be assigned ownership of the device for the purpose of access checks. The default owner is the UIC of the process issuing the SET PROTECTION command. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual.
Examples
1. $ SET PROTECTION=(S:RWLP,O:RWLP,G,W)/DEVICE LAA0: This command requests that the protection for device LAA0 be set to allow all types of access to system processes and processes with the UIC of the current process, and to deny access to anyone else. 2. $ SET PROTECTION=(S:R,O,G,W)/DEVICE/OWNER_UIC=[1,4] TTA1: This command requests that the protection for the terminal TTA1 be set to allow only system processes to allocate the device, and denies access to anyone else. This type of protection is recommended for interactive terminals if system security is necessary. Note that the above protection code restricts which users can allocate the device, but does not restrict users from logging in to the device.
QUEUE
Changes the current status or attributes of the specified queue.
o Change the current status or attributes of a job that is not
currently executing in a queue (see /ENTRY).
Format:
SET QUEUE queue-name[:]
Additional information available:
Parameters
queue-name[:] Specifies the name of an execution queue or a generic queue.
Command Qualifiers
Additional information available:
/BASE_PRIORITY/BLOCK_LIMIT/CHARACTERISTICS/CLOSE
/CPUDEFAULT/CPUMAXIMUM/DEFAULT/DISABLE_SWAPPING
/ENABLE_GENERIC/FORM_MOUNTED/JOB_LIMIT/OPEN
/OWNER_UIC/PROTECTION/RECORD_BLOCKING/RETAIN
/SCHEDULE/SEPARATE/WSDEFAULT/WSEXTENT
/WSQUOTA
/BASE_PRIORITY
/BASE_PRIORITY=n Specifies the base process priority at which jobs are initiated from a batch queue. (You must stop and restart symbiont queues to change the symbiont priority for printer, terminal, or server queues.) The n specifier can be any decimal value from 0 through 15.
/BLOCK_LIMIT
/BLOCK_LIMIT=([lowlim,]uplim) /NOBLOCK_LIMIT Limits the size of print jobs that can be executed on a printer or terminal queue. This qualifier allows you to reserve certain printers for certain size jobs. You must specify at least one of the parameters. The lowlim parameter is a decimal number referring to the minimum number of blocks that will be accepted by the queue for a print job. If a print job is submitted that contains fewer blocks than the lowlim value, the job remains pending until the job limit for the queue is changed, enabling it to execute. The uplim parameter is a decimal number referring to the maximum number of blocks that will be accepted by the queue for a print job. If a print job is submitted that exceeds this value, the job remains until the job limit for the queue is changed, enabling it to execute. If you specify only an upper limit for jobs, you can omit the parentheses. For example, /BLOCK_LIMIT=1000 means that only jobs with 1000 blocks or less will execute in the queue. In order to specify only a lower job limit, you must use two sets of double quotation marks to indicate the upper specifier. For example, /BLOCK_LIMIT=(500,"") means any job with 500 or more blocks will execute in the queue. You can specify both a lower and upper limit. For example, /BLOCK_LIMIT=(200,2000) means that jobs with less than 200 blocks or more than 2000 blocks will not run in the queue. The /NOBLOCK_LIMIT qualifier cancels the /BLOCK_LIMIT setting previously established for that queue.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...]) /NOCHARACTERISTICS Specifies one or more characteristics for processing jobs on the queue. If only one characteristic is specified, you can omit the parentheses. Each time you specify /CHARACTERISTICS, all previously set characteristics are erased. Only the ones specified with the qualifier are now established for the queue. Queue characteristics are installation-specific. The characteristic parameter can be either a value from 0 through 127 or a characteristic name that has been defined by the DEFINE/CHARACTERISTIC command. When users include the /CHARACTERISTICS qualifier with a PRINT or SUBMIT command, all the characteristics they specify must also be specified for the queue that will be executing the job. If not, the job will remain pending in the queue until the queue characteristics are changed or they delete the entry with the DELETE/ENTRY command. Users need not specify every characteristic of a queue with a PRINT or SUBMIT command as long as the ones they specify are a subset of the characteristics set for that queue. The job will also run if no characteristics are specified. The /NOCHARACTERISTICS qualifier cancels any /CHARACTERISTIC settings previously established for that queue.
/CLOSE
/CLOSE Prevents jobs from being entered in the queue through PRINT or SUBMIT commands or as a result of requeue operations. To allow jobs to be entered, use the /OPEN qualifier. Whether a queue will accept or reject new job entries is independent of the queue's state (such as paused, stopped, stalled). When a queue is marked closed, jobs executing continue to execute and jobs already pending in the queue continue to be candidates for execution.
/CPUDEFAULT
/CPUDEFAULT=time Defines the default CPU time limit for batch jobs. Specify the CPU default time as a delta time value, the numeric value 0, or the keyword NONE or INFINITE. You can specify up to 497 days of delta time. The value 0 and the keyword INFINITE allow a job unlimited CPU time, subject to restrictions imposed by the /CPUMAXIMUM qualifier or the user authorization file (UAF). Specify NONE when a default CPU time limit is not needed. The time cannot exceed the CPU time limit set by the /CPUMAXIMUM qualifier. See Chapter 1 of the VMS DCL Concepts Manual for information on specifying delta times.
/CPUMAXIMUM
/CPUMAXIMUM=time Defines the maximum CPU time limit for batch jobs. Use this qualifier to override the CPU time limit specified in the user authorization file (UAF). Specify CPU maximum time as a delta time value, the numeric value 0, or the word NONE or INFINITE. You can specify up to 497 days of delta time. Specify NONE when a maximum CPU time limit is not desired. See Chapter 1 of the VMS DCL Concepts Manual for information on specifying delta times. A CPU time limit for processes is specified by each user record in the system (UAF). You can also specify the following: a default CPU time limit for all jobs in a given queue and a maximum CPU time limit for all jobs in a given queue.
/DEFAULT
/DEFAULT=(option[,...])
/NODEFAULT
Establishes defaults for certain options of the PRINT command.
Defaults are specified by the list of options. If you specify only
one option, you can omit the parentheses. Once an option is set for
the queue by the /DEFAULT qualifier, users do not have to specify
that option in their PRINT commands.
The options are:
[NO]BURST[=keyword] Specifies whether file burst pages will
be printed. If the keyword is ALL (the
default), burst pages are placed before
each file in the print job. If the
keyword is ONE, a burst page is placed
before the first copy of the first file
in the job.
[NO]FEED Specifies whether a form-feed is
automatically inserted at the end of a
page.
[NO]FLAG[=keyword] Specifies whether file flag pages will
be printed. If the keyword is ALL (the
default), flag pages are placed before
each file in the print job. If the
keyword is ONE, a flag page is placed
before the first copy of the first file
in the job.
FORM=type Specifies the default form for a
printer, terminal, or server queue. If
a job is not submitted with an explicit
form definition, then this form will be
used to process the job. The systemwide
default form, form=0, is the default
value for this keyword. See also
/FORM_MOUNTED.
[NO]TRAILER[=keyword] Specifies whether file trailer pages
will be printed. If the keyword is ALL
(the default), trailer pages are placed
at the end of each file in the print
job. If the keyword is ONE, a trailer
page is placed after the last copy of
the last file in the job.
If you specify any of the keywords BURST, FLAG, TRAILER without
specifying a value, the value ALL is used by default.
/DISABLE_SWAPPING
/DISABLE_SWAPPING /NODISABLE_SWAPPING Controls whether batch jobs executed from a queue can be swapped in and out of memory.
/ENABLE_GENERIC
/ENABLE_GENERIC /NOENABLE_GENERIC Specifies whether files queued to a generic queue that does not have specific targets can be placed in this execution queue for processing.
/FORM_MOUNTED
/FORM_MOUNTED=type Specifies the form type for a printer, terminal, or server execution queue. If the stock of the mounted form is not identical to the stock of the default form, as indicated by the DCL command qualifier /DEFAULT=FORM=type, then all jobs submitted to this queue without an explicit form definition will enter a pending state. If a job is submitted with an explicit form and the stock of the explicit form is not identical to the stock of the mounted form, then the job will enter a pending state. In both cases, the pending state will be maintained until the stock of the mounted form of the queue is identical to the stock of the form associated with the job. Specify the form type using a numeric value or a form name that has been defined by the DEFINE/FORM command. Form types are installation-specific.
/JOB_LIMIT
/JOB_LIMIT=n Indicates the number of batch jobs that can be executed concurrently from the queue.
/OPEN
/OPEN Allows jobs to be entered in the queue through PRINT or SUBMIT commands or as the result of requeue operations. To prevent jobs from being entered, use the /CLOSE qualifier. Whether a queue will accept or reject new job entries is independent of the queue's state (such as paused, stopped, stalled).
/OWNER_UIC
/OWNER_UIC=uic Requires OPER privilege. Enables you to change the user identification code UIC of the queue. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual.
/PROTECTION
/PROTECTION=(ownership[:access],...) Requires OPER privilege. Specifies the protection of the queue. By default, the queue protection is (SYSTEM:E, OWNER:D, GROUP:R, WORLD:W). If you include only one protection code, you can omit the parentheses.
/RECORD_BLOCKING
/RECORD_BLOCKING /NORECORD_BLOCKING Determines whether the symbiont can concatenate (or block together) output records for transmission to the output device. If you specify /NORECORD_BLOCKING, the symbiont is directed to send each formatted record in a separate I/O request to the output device. For the standard VMS print symbiont, record blocking can have a significant performance advantage over single-record mode.
/RETAIN
/RETAIN[=option] /NORETAIN Specifies that jobs be retained in the queue in a completed status after they have executed. The option parameter can be the keyword ALL or ERROR. If ALL is specified, all jobs are retained in the queue after execution. If ERROR is specified, only jobs that have completed unsuccessfully are retained in the queue. If you omit the option parameter, ALL is assumed. The /NORETAIN qualifier enables you to reset the queue to the default.
/SCHEDULE
/SCHEDULE=[NO]SIZE Specifies whether pending jobs in a printer or terminal queue are scheduled for printing based on the size of the job. When /SCHEDULE=SIZE is in effect, shorter jobs will print before longer ones. With /SCHEDULE=NOSIZE, jobs are printed in the order they were submitted, regardless of size. If you issue this command while there are pending jobs in any queue, its effect on future jobs is unpredictable.
/SEPARATE
/SEPARATE=(option[,...])
/NOSEPARATE
Specifies the job separation defaults for a printer or terminal
queue. The job separation options are:
[NO]BURST Specifies whether a burst page
will be printed at the beginning
of every job. Specifying BURST
also results in a flag page being
printed.
[NO]FLAG Specifies whether a flag page will
be printed at the beginning of
every job.
[NO]TRAILER Specifies whether a trailer page
will be printed at the end of
every job.
[NO]RESET=(module[,...]) Specifies a job reset sequence for
the queue. The specified modules
from the device control library
are used to reset the device each
time a job reset occurs.
/WSDEFAULT
/WSDEFAULT=n Defines a working set default for a batch job. The value set by this qualifier overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue. Specify a positive integer in the range 1 through 65,535, 0, or the word NONE as the value for n. If 0 or NONE is specified for n, the working set default value defaults to the value specified either in the UAF or by the SUBMIT command (if specified).
/WSEXTENT
/WSEXTENT=n Defines a working set extent for the batch job. The value set by this qualifier overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue. Specify a positive integer in the range 1 through 65,535, 0, or the word NONE as the value for n. If 0 or NONE is specified for n, the working set extent value defaults to the value specified either in the UAF or by the SUBMIT command (if specified).
/WSQUOTA
/WSQUOTA=n Defines the working set page size (working set quota) for a batch job. The value set by this qualifier overrides the value defined in the user authorization file (UAF) of any user submitting a job to the queue. Specify a positive integer in the range 1 through 65,535, 0, or the word NONE as the value for n. If 0 or NONE is specified for n, the working set quota value defaults to the value specified either in the UAF or by the SUBMIT command (if specified). A working set default size and a working set quota (maximum size) are included in each user record in the system user authorization file (UAF), and can be specified for individual jobs and/or for all jobs in a given queue.
/ENTRY
Changes the current status or attributes of a job that is not
currently executing in a queue. The /ENTRY qualifier is required.
The SET QUEUE/ENTRY command is superseded by the SET ENTRY command.
Note that the SET ENTRY command has the same qualifiers as the SET
QUEUE/ENTRY command; only the command parameters are different.
DIGITAL recommends usage of the SET ENTRY command. See SET ENTRY
for a complete description of this command.
Format:
SET QUEUE/ENTRY=entry-number queue-name[:]
RESTART_VALUE
Establishes a test value for restarting portions of batch jobs. If
the command is encountered by the system interactively, no action is
taken. Use the SET RESTART_VALUE in command procedures.
Format:
SET RESTART_VALUE=string
Additional information available:
Parameters
string Specifies the test value to be used in the batch job. The string can contain up to 255 characters.
RIGHTS_LIST
Allows users to modify the process or system rights list. You must
specify either /DISABLE or /ENABLE with the SET RIGHTS_LIST command.
Format:
SET RIGHTS_LIST id-name[,...]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
id-name[,...] Identifiers to be added to or removed from the process or system rights list. Id-name is a string of 1 to 31 alphanumeric characters, underscores, and dollar signs; each name must contain at least one nonnumeric character.
Command Qualifiers
Additional information available:
/ATTRIBUTES/DISABLE/ENABLE/IDENTIFICATION/PROCESS
/SYSTEM
/ATTRIBUTES
/ATTRIBUTES=(keyword[,...])
Specifies attributes to be associated with the identifiers.
Attributes may be added to new or existing identifiers. Valid
keywords are:
[NO]DYNAMIC Indicates whether or not unprivileged holders of the
identifiers may add or remove them from the process
rights list. The default is NODYNAMIC.
[NO]RESOURCE Indicates whether or not holders of the identifiers
may charge resources to them. The default is
NORESOURCE.
/DISABLE
/DISABLE Removes the identifiers from the process or system rights list. You cannot use /DISABLE with the /ENABLE qualifier.
/ENABLE
/ENABLE Adds the identifiers to the process or system rights list. You cannot use /ENABLE with the /DISABLE qualifier.
/IDENTIFICATION
/IDENTIFICATION=pid Specifies the process identification value (PID) of the process whose rights list is to be modified. The PID is assigned by the system when the process is created. When you specify a PID, you can omit the leading zeros. If you specify the /IDENTIFICATION qualifier, you cannot use the /PROCESS qualifier. By default, if neither the /IDENTIFICATION nor the /PROCESS qualifier is specified, the current process is assumed. You cannot use /IDENTIFICATION with the /SYSTEM qualifier.
/PROCESS
/PROCESS[=process-name] Specifies the name of the process whose rights list is to be modified. The process name can contain from 1 to 15 alphanumeric characters. If you specify the /PROCESS qualifier, you cannot use the /IDENTIFICATION qualifier. By default, if neither the /PROCESS nor the /IDENTIFICATION qualifier is specified, the current process is assumed. You cannot use /PROCESS with the /SYSTEM qualifier.
/SYSTEM
/SYSTEM Specifies that the desired operation (addition or removal of an identifier) be performed on the system rights list. You cannot use /SYSTEM with /PROCESS or /IDENTIFICATION.
Examples
1. $ SET RIGHTS_LIST/ENABLE/ATTRIBUTES=RESOURCE MARKETING
Adds the MARKETING identifier to the process rights list of the
current process. Specifying the RESOURCE attribute allows holders
of the MARKETING identifier to charge resources to it.
2. $ SET RIGHTS_LIST/ENABLE/SYSTEM PHYSICS101
%SYSTEM-F-NOCMKRNL, operation requires CMKRNL privilege
$ SET PROCESS/PRIVILEGES=(CMKRNL,SYSNAM)
$ SET RIGHTS_LIST/ENABLE/SYSTEM PHYSICS101
Adds the PHYSICS101 identifier to the system rights list. You must
have both the CMKRNL and SYSNAM privilege to modify the system
rights list.
RMS_DEFAULT
Defines default values for the multiblock and multibuffer counts,
network transfer sizes, prologue level, and extend quantity used by
VAX RMS for file operations. Defaults are set for sequential,
indexed sequential, or relative file organizations on a process-only
basis, unless a systemwide basis is requested.
Format:
SET RMS_DEFAULT
Additional information available:
Command Qualifiers
Additional information available:
/BLOCK_COUNT/BUFFER_COUNT/DISK/EXTEND_QUANTITY
/INDEXED/MAGTAPE/NETWORK_BLOCK_COUNT/PROLOG/RELATIVE
/SEQUENTIAL/SYSTEM/UNIT_RECORD
/BLOCK_COUNT
/BLOCK_COUNT=count Specifies a default multiblock count for sequential file operations to and from a disk. The specified count, representing the number of blocks to be allocated for each I/O buffer, can range from 0 through 127. If you specify 0, RMS uses the process default value. If this value is 0, RMS then uses the system default value. If the system default value is also 0, then RMS uses a value of 1. The /BLOCK_COUNT qualifier applies only to record I/O operations, not block I/O operations. For more information on multiblock count, see the description of the RAB$B_MBC in the VAX Record Management Services Reference Manual.
/BUFFER_COUNT
/BUFFER_COUNT=count Specifies a default multibuffer count for file operations. The specified count, representing the number of buffers to be allocated, can range from 0 through 127. When you use the /BUFFER_COUNT qualifier, you can use the /DISK, /INDEXED, /MAGTAPE, /RELATIVE, /SEQUENTIAL, and /UNIT_RECORD qualifiers to specify the types of file for which the default is to be applied. If /BUFFER_COUNT is specified without any of these qualifiers, /SEQUENTIAL is assumed. If you specify 0, VAX RMS uses the process default value. If this value is 0, RMS then uses the system default value. If the system default value is also 0, then RMS uses a value of 1. For more information on multibuffer count, see the description of the RAB$B_MBF in the VAX Record Management Services Reference Manual.
/DISK
/DISK Indicates that the specified defaults are to be applied to file operations on disk devices. If /SEQUENTIAL is specified, /DISK is assumed together with /MAGTAPE and /UNIT_RECORD.
/EXTEND_QUANTITY
/EXTEND_QUANTITY=n Specifies the number of blocks (n) to extend a sequential file. You can specify a value from 0 to 65,535. The /EXTEND_QUANTITY qualifier is used when the program does not specify an extent quantity. If you omit the value specification or if you specify a value of 0, VAX RMS calculates its own /EXTEND_QUANTITY value.
/INDEXED
/INDEXED Indicates that the specified multibuffer default is to be applied to indexed file operations.
/MAGTAPE
/MAGTAPE Indicates that the specified multibuffer default is to be applied to operations on magnetic tape volumes. If /SEQUENTIAL is specified, /MAGTAPE is assumed together with /DISK and /UNIT_RECORD.
/NETWORK_BLOCK_COUNT
/NETWORK_BLOCK_COUNT=count Specifies a default block count for network access to remote sequential, indexed sequential, and relative files. You can specify a value in the range of 0 to 127. The network block count value represents the number of blocks that VAX RMS is prepared to allocate for the I/O buffers used to transmit and receive data. For remote file access, the buffer size is negotiated between between VAX RMS and the remote system's file access listener (FAL) with the smaller of the two sizes being selected. Thus, the /NETWORK_BLOCK_COUNT value places an upper limit on the network buffer size that will be used. It also places an upper limit on the largest record that may be transferred to or from a remote file. In other words, the largest record that can be transferred must be less than or equal to this value. If you omit the value or specify a value of 0, VAX RMS uses the systemwide block count value. If this value is also 0, VAX RMS uses a size of one block.
/PROLOG
/PROLOG=n Specifies a default prologue level for indexed sequential files where n is a value of 0, 2, or 3. A value of 1 is not allowed. If 0 is specified, VAX RMS sets an appropriate prologue level. By default, 0 is assumed.
/RELATIVE
/RELATIVE Indicates that the specified multibuffer default is to be applied to file operations on relative files.
/SEQUENTIAL
/SEQUENTIAL (default) Indicates that the specified multibuffer default is to be applied to all sequential file operations, including operations on disk, magnetic tape, and unit record devices. The /SEQUENTIAL qualifier is the default if you do not specify either /RELATIVE or /INDEXED.
/SYSTEM
/SYSTEM Requires change-mode-to-kernel (CMKRNL) privilege. Indicates that the specified defaults are to be applied on a systemwide basis to file operations performed by all processes.
/UNIT_RECORD
/UNIT_RECORD Indicates that the multibuffer default is to be applied to file operations on unit record devices. If /SEQUENTIAL is specified, /UNIT_RECORD is assumed together with /DISK and /MAGTAPE.
SYMBOL
Controls access to local and global symbols in command procedures.
Format:
SET SYMBOL
Additional information available:
Command Qualifiers
Additional information available:
/SCOPE
/SCOPE=(keyword,...)
Controls access to local and global symbols. Allows the user to
treat symbols as being undefined. Possible keywords are:
[NO]LOCAL Specifying the NOLOCAL keyword causes all local symbols
defined in outer procedure levels to be treated as being
undefined by the current procedure and all inner
procedure levels. Specifying LOCAL removes any symbol
translation limit set by the current procedure level.
[NO]GLOBAL Specifying the NOGLOBAL keyword causes all global
symbols to be inaccessible to the current procedure
level and all inner procedure levels unless otherwise
changed. Specifying GLOBAL restores access to all
global symbols.
Examples
1. $ SET SYMBOL/SCOPE=NOLOCAL All local symbols defined in outer procedure levels are now undefined by the current procedure and all inner procedure levels. 2. $ SET SYMBOL/SCOPE=NOGLOBAL All global symbols are now inaccessible to the current procedure level and all inner procedure levels unless otherwise changed.
TERMINAL
Changes the system's interpretation of the terminal characteristics.
Format:
SET TERMINAL [device-name[:]]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
device-name[:] Specifies the name of the terminal whose characteristics are to be changed. If you do not specify a device name, the qualifiers change the characteristics of the current SYS$COMMAND device, if SYS$COMMAND is a terminal. If the current SYS$COMMAND device is not a terminal, the system returns an error message.
Command Qualifiers
Additional information available:
/ADVANCED_VIDEO/ALTYPEAHD/ANSI_CRT/APPLICATION_KEYPAD
/AUTOBAUD/BLOCK_MODE/BRDCSTMBX/BROADCAST
/CRFILL/DEC_CRT/DEVICE_TYPE/DIALUP/DISCONNECT
/DISMISS/DMA/ECHO/EDIT_MODE/EIGHT_BIT
/ESCAPE/FALLBACK/FRAME/FORM/FULLDUP/HALFDUP
/HANGUP/HARDCOPY/HOSTSYNC/INQUIRE/INSERT
/LFFILL/LINE_EDITING/LOCAL_ECHO/LOWERCASE
/MANUAL/MODEM/NUMERIC_KEYPAD/OVERSTRIKE/PAGE
/PARITY/PASTHRU/PERMANENT/PRINTER_PORT/PROTOCOL
/READSYNC/REGIS/SCOPE/SET_SPEED/SECURE_SERVER
/SIXEL_GRAPHICS/SOFT_CHARACTERS/SPEED/SWITCH/SYSPASSWORD
/TAB/TTSYNC/TYPE_AHEAD/UNKNOWN/UPPERCASE
/WIDTH/WRAP
/ADVANCED_VIDEO
/ADVANCED_VIDEO /NOADVANCED_VIDEO Specifies whether the terminal has advanced video attributes and is capable of 132-column mode operation. If the terminal width is set to 132 columns and /ADVANCED_VIDEO is enabled, the terminal page limit is set to 24 lines. If /NOADVANCED_VIDEO is enabled on a terminal set to 132 columns, the terminal page limit is set to 12 lines.
/ALTYPEAHD
/ALTYPEAHD Used with the /PERMANENT qualifier to control the size of the type-ahead buffer. You should specify SET TERMINAL/PERMANENT/ALTYPEAHD in the SYS$SYSTEM:STARTUP.COM for those communication lines that require this capability. In order to use this feature interactively, specify SET TERMINAL/PERMANENT/ALTYPEAHD. This specification will take effect at your next login.
/ANSI_CRT
/ANSI_CRT /NOANSI_CRT Specifies whether the terminal conforms to ANSI CRT programming standards. The /ANSI_CRT qualifier indicates that the terminal is capable of processing the ANSI sequences listed in the VMS I/O User's Reference Manual: Part I. Since ANSI standards are a proper subset of the DEC_CRT characteristics, the default for all VT100-family terminals is /ANSI_CRT.
/APPLICATION_KEYPAD
/APPLICATION_KEYPAD Specifies that the keypad is to be set to APPLICATION_KEYPAD mode so that you can use the DEFINE/KEY facility. By default, the terminal is set to /NUMERIC_KEYPAD mode.
/AUTOBAUD
/AUTOBAUD
/NOAUTOBAUD
When used with the /PERMANENT qualifier, controls whether to enable
automatic baud rate detection for a terminal line. Also sets the
default terminal speed to 9600 baud.
If you specify /AUTOBAUD, automatic baud rate detection is enabled
allowing the terminal baud rate to be set at login. You can set the
baud rate at login by pressing the RETURN key two or more times
separated by an interval of at least one second. The valid baud
rates are:
110 1200 4800
150 1800 9600
300 2400 19200
600 3600
NOTE
If you press a key other than RETURN, /AUTOBAUD
might detect the wrong baud rate. If this happens,
wait for the login procedure to time out before
continuing.
/BLOCK_MODE
/BLOCK_MODE /NOBLOCK_MODE Specifies whether the terminal is capable of performing block mode transmission, local editing, and field protection. Terminals that support all these functions include the VT131 and VT132.
/BRDCSTMBX
/BRDCSTMBX /NOBRDCSTMBX Controls whether broadcast messages are sent to an associated mailbox if one exists. For a description of message formats, see the VMS I/O User's Reference Manual: Part I.
/BROADCAST
/BROADCAST (default) /NOBROADCAST Controls whether the terminal can receive broadcast messages such as MAIL notifications and REPLY messages. By default, a terminal receives any messages the system operator or another privileged user sends. Use the /NOBROADCAST qualifier when you are using a terminal as a noninteractive device or when you do not want special output to be interrupted by messages. You can use the SET BROADCAST command to exclude only certain types of messages from being broadcast to your terminal, rather than eliminating all messages.
/CRFILL
/CRFILL[=formula] Specifies whether the system must generate fill characters following the pressing of the RETURN key on the terminal. The recommended formula is a number in the range of 0 through 9 indicating the number of null fill characters required to ensure that the RETURN completes successfully before the next meaningful character is sent. You might need to use this qualifier if you are using a non-DIGITAL terminal or a video terminal. This qualifier prevents the system from sending out data before the terminal is ready to accept it. The default is /CRFILL=0.
/DEC_CRT
/DEC_CRT[=(value1,value2,value3)] /NODEC_CRT[=(value1,value2,value3)] Specifies whether the terminal conforms to DEC VT100-family standards and supports the minimum VT100 standards including DEC escape sequences. Three optional values may be specified. A value of 1 requests that the DEC_CRT terminal characteristic be set. This is the default. A value of 2 requests that the DEC_CRT2 terminal characteristic be set. A value of 3 requests that the DEC_CRT3 terminal characteristic be set. This determines the minimum capabilities a terminal conforms to. Note that DEC_CRT2 and DEC_CRT3 are supersets of DEC_CRT. Clearing DEC_CRT will cause DEC_CRT2 and DEC_CRT3 to be cleared. Similarly, setting DEC_CRT3 will cause all subsets of DEC_CRT3 to be set. This includes ANSI_CRT. For more information, see the VMS I/O User's Reference Manual: Part I.
/DEVICE_TYPE
/DEVICE_TYPE=terminal-type
Informs the system of the terminal type. When you specify this
qualifier, the terminal sets the default characteristics for the
specified terminal.
You can specify any of the following terminal types:
UNKNOWN LA34
FT1 - FT8 LA38
LA12 LA100
LA36 LQP02
LA120 VT125
VT05 VT131
VT52 VT132
VT55 VT173
VT100 VT200
VT101 PRO_SERIES
VT102 LA210
VT105 VT300
For compatibility reasons, terminal types listed in the first column
can be specified as qualifiers by themselves (for example, /FT8).
However, you are encouraged to use the /DEVICE_TYPE qualifier.
Terminal types FT1 through FT8 permit up to eight different
categories of terminals that are not supported by VMS to be
identified as foreign terminals. See the VMS I/O User's
Reference Manual: Part I to find out how to obtain the terminal
type from a user program. When you specify a foreign terminal type
(FTn), you do not change the default characteristics established for
the terminal.
/DIALUP
/DIALUP /NODIALUP (default) Specifies that the terminal is a dialup terminal.
/DISCONNECT
/DISCONNECT /NODISCONNECT (default) Specifies that the process connected to this terminal not be discontinued if the line detects a hangup. The /DISCONNECT qualifier is valid only when /PERMANENT is specified. For more information on process connection, see the CONNECT and DISCONNECT commands.
/DISMISS
/DISMISS /NODISMISS (default) Determines the terminal driver's treatment of parity errors. If you specify /DISMISS, the terminal driver will ignore the data that caused the error. When /NODISMISS, the default, is in effect, the terminal driver terminates the currently outstanding I/O with an error status.
/DMA
/DMA /NODMA Controls the use of direct memory access (DMA) mode on a controller that supports this feature. The default is /DMA for DMA controllers, and /NODMA for non-DMA controllers.
/ECHO
/ECHO (default) /NOECHO Controls whether the terminal echoes (that is, displays) the input lines that it receives. When /NOECHO is set, the terminal displays only data that a system or user application program writes to it.
/EDIT_MODE
/EDIT_MODE /NOEDIT_MODE Specifies whether the terminal is capable of performing ANSI defined advanced editing functions.
/EIGHT_BIT
/EIGHT_BIT /NOEIGHT_BIT Indicates whether the terminal uses an 8-bit ASCII character code. The default is /NOEIGHT_BIT for all terminals, except the VT200 Series; the terminal interprets characters using 7-bit ASCII code. Note that you can use the Terminal Fallback Facility to set the 8-bit characteristic on terminals. If the terminal you specify has the Terminal Fallback Facility enabled, the /EIGHT_BIT qualifier has no effect. See the VMS Terminal Fallback Utility Manual for more information on terminal fallback.
/ESCAPE
/ESCAPE /NOESCAPE (default) Controls whether ANSI standard escape sequences transmitted from the terminal are handled as a single multiple-character terminator. If you specify the /ESCAPE qualifier, the terminal driver checks the escape sequences for syntax before passing them to the program. For information on escape sequences, see the VMS I/O User's Reference Manual: Part I.
/FALLBACK
/FALLBACK /NOFALLBACK If the VMS Terminal Fallback Facility (TFF) is enabled, activates the default character conversion tables for the named terminal. For more information, see the VMS Terminal Fallback Utility Manual. If TFF is not enabled on your system, then /[NO]FALLBACK has no effect.
/FRAME
/FRAME=n Controls the number of data bits that the terminal driver expects for every character that is input or output. The default depends on the /PARITY and /EIGHTBIT settings of the terminal. The n parameter can take a value from 5 through 8.
/FORM
/FORM /NOFORM Controls whether the terminal driver translates form-feed characters into one or more line feeds or merely outputs the untranslated form-feed character.
/FULLDUP
/FULLDUP (default) /NOFULLDUP Specifies whether the terminal's mode of operation is full-duplex or half-duplex. For a description of these modes of operation, see the VMS I/O User's Reference Manual: Part I. This qualifier is complementary to the /HALFDUP qualifier, that is, /FULLDUP is equivalent to /NOHALFDUP.
/HALFDUP
/HALFDUP (default) /NOHALFDUP Specifies whether the terminal's mode of operation is full-duplex or half-duplex. For a description of these modes of operation, see the VMS I/O User's Reference Manual: Part I. This qualifier is complementary to the /FULLDUP qualifier, that is, /HALFDUP is equivalent to /NOFULLDUP.
/HANGUP
/HANGUP /NOHANGUP (default) Controls whether the terminal modem is hung up when you log out. In order to specify /HANGUP, you might require LOG_IO or PHY_IO privilege depending on parameters specified during system generation.
/HARDCOPY
/HARDCOPY /NOHARDCOPY Indicates whether the terminal is a hard-copy or video terminal. It also affects how the terminal interprets certain input keys. The /HARDCOPY qualifier establishes the terminal as a hard-copy device. Thus, the DELETE (or RUBOUT) key cannot accomplish backspace deletions. Instead, a backslash character is output each time the DELETE key is pressed. This qualifier is complementary to the /SCOPE qualifier; that is, /HARDCOPY is equivalent to /NOSCOPE.
/HOSTSYNC
/HOSTSYNC /NOHOSTSYNC (default) Controls whether the system can synchronize the flow of input from the terminal. When you specify the /HOSTSYNC qualifier, the system generates a CTRL/S or a CTRL/Q to enable or disable the reception of input. When the type-ahead buffer is full, the system sends a CTRL/S to temporarily stop input; when the buffer is empty, the system sends a CTRL/Q so that more input can be entered. The size of the type-ahead buffer is established using system generation parameters.
/INQUIRE
/INQUIRE
Requests a response sequence from DIGITAL terminals and sets the
device type according to the response. Some VT100-family terminals,
including the VT101 and VT105, return a VT100-type response. LA38
terminals respond as LA34 terminals.
You can include the SET TERMINAL/INQUIRE command in your LOGIN.COM
file to automatically detect the terminal type.
CAUTION
This qualifier clears the type-ahead buffer. If the
response sequence is unrecognized, no action message
or error message is displayed. The /INQUIRE
qualifier should be used only on DIGITAL terminals.
However, the LA36 and VT05 terminals do not support
this feature.
/INSERT
/INSERT Sets the terminal to /INSERT mode. This feature allows you to insert characters when you are editing command lines. The default mode is /OVERSTRIKE, which allows you to type over the current character when you are editing a command line.
/LFFILL
/LFFILL[=formula] Specifies whether the system must generate fill characters following a line feed on the terminal. The recommended formula value is a number in the range from 0 through 9 indicating the number of null fill characters required to ensure that the line feed completes successfully before the next meaningful character is read. You might need to use this qualifier if you are using a non-DIGITAL terminal or a video terminal. This qualifier prevents the system from sending out data before the terminal is ready to accept it. The default is installation-dependent.
/LINE_EDITING
/LINE_EDITING /NOLINE_EDITING Enables the advanced line editing features for editing command lines. If you specify /LINE_EDITING, both RETURN and CTRL/Z are recognized as line terminators. Escape sequences are also enabled as line terminators. The default is installation-dependent.
/LOCAL_ECHO
/LOCAL_ECHO
/NOLOCAL_ECHO (default)
When used with the /ECHO qualifier, controls whether the terminal
echoes characters locally rather than relying on the host to echo
them.
Local echo mode is supported only for command level terminal
functions. Certain utilities that require control over echoing,
such as the EDT editor in screen mode, should not be used with
/LOCAL_ECHO set.
CAUTION
When logging in to terminals with /LOCAL_ECHO set,
VMS has no control over the echoing of passwords.
/LOWERCASE
/LOWERCASE /NOLOWERCASE Indicates whether the terminal has uppercase and lowercase characters. If you specify /NOLOWERCASE, all letters that are input are translated to uppercase. If you specify /LOWERCASE, lowercase characters are not converted to uppercase. This qualifier is complementary to the /UPPERCASE qualifier, that is, /LOWERCASE is equivalent to /NOUPPERCASE.
/MANUAL
/MANUAL Indicates manual switching of terminal lines to dynamic asynchronous DDCMP lines when your local terminal emulator does not support automatic switching. The /MANUAL qualifier should be specified with the /PROTOCOL=DDCMP and /SWITCH=DECNET qualifiers.
/MODEM
/MODEM /NOMODEM Indicates whether the terminal is connected to a modem or a cable that supplies standard EIA modem control signals. The VMS operating system automatically interprets modem signals. If the terminal is set to /MODEM and you enter SET TERMINAL /NOMODEM, you are automatically logged out.
/NUMERIC_KEYPAD
/NUMERIC_KEYPAD (default) Specifies that the keypad is to be set to /NUMERIC_KEYPAD mode so that you can use the keys on the numeric keypad to type numbers and punctuation marks. In order to use the DEFINE/KEY facility, you must set the terminal to /APPLICATION_KEYPAD.
/OVERSTRIKE
/OVERSTRIKE (default) Sets the terminal to /OVERSTRIKE mode. This feature allows you to type over the current character when you are editing a command line. You can set your terminal to /INSERT if you want to be able to insert characters when editing command lines.
/PAGE
/PAGE[=n] Specifies the page length of the terminal. For hard-copy terminals, the page size (n) equals the number of print lines between perforations on the paper. When the terminal reads a form feed character, it advances the paper to the next perforation. A page size of 0 indicates that the terminal treats each formfeed as a line feed. You can specify values of 0 through 255 for the page size. The default size is installation-dependent. However, if you specify /PAGE without a value, the default value for n is 0.
/PARITY
/PARITY[=option]
/NOPARITY (default)
Defines the parity for the terminal. You can specify either of the
following options:
EVEN
ODD
If you use the /PARITY qualifier without an option, the SET TERMINAL
command assumes /PARITY=EVEN.
/PASTHRU
/PASTHRU /NOPASTHRU (default) Controls whether the system interprets special characters or passes all data to an application program as binary data. A terminal operating in PASTHRU mode does not (1) expand tab characters to spaces, (2) fill carriage return or line feed characters, or (3) recognize other control characters. The setting of /TTSYNC is honored.
/PERMANENT
/PERMANENT Requires LOG_IO or PHY_IO privilege. Controls whether the characteristics that you specify are established permanently or only for the current terminal session. By default the characteristics that you set during a session are in effect only for that session. The permanent characteristics are restored when the current user logs out. If you use the /PERMANENT qualifier to override the system default characteristics established at system generation time, remember that if the system is halted, the permanent characteristics revert to those defined at system generation. You can use the /PERMANENT qualifier with the SET TERMINAL command in a system start-up file to establish the characteristics for all terminals on the system.
/PRINTER_PORT
/PRINTER_PORT /NOPRINTER_PORT Specifies that the terminal has a printer port available. This terminal attribute is not set automatically by SET TERMINAL/INQUIRE. The default is installation-dependent.
/PROTOCOL
/PROTOCOL=DDCMP /PROTOCOL=NONE (default) Controls whether the terminal port specified is changed into an asynchronous DDCMP line. Use the /PROTOCOL=NONE qualifier to change an asynchronous DDCMP line back into a terminal line. Note that the /PROTOCOL=DDCMP qualifier is a permanent characteristic; therefore, the /PERMANENT qualifier need not be specified for this characteristic. For more information on how to use these lines with DECNET, refer to the VMS Networking Manual.
/READSYNC
/READSYNC /NOREADSYNC (default) Controls whether the system solicits read data from a terminal using CTRL/Q and terminates the read using CTRL/S. The default is /NOREADSYNC; the system does not use CTRL/S and CTRL/Q to control reads to the terminal. The /READSYNC qualifier is useful for certain classes of terminals that demand synchronization or for special-purpose terminal lines where data synchronization is appropriate.
/REGIS
/REGIS /NOREGIS Specifies whether the terminal understands ReGIS graphic commands. This qualifier is set for VT125 terminals, which have graphics capabilities.
/SCOPE
/SCOPE /NOSCOPE Indicates whether the terminal is a video terminal, and thus how it reacts when certain keys are pressed. The /SCOPE qualifier establishes the terminal as a video terminal. Thus, when you press the DELETE key, the printing position is moved left one column and the character displayed in that position is erased. This qualifier is complementary to the /HARDCOPY qualifier, that is, /SCOPE is equivalent to /NOHARDCOPY.
/SET_SPEED
/SET_SPEED /NOSET_SPEED Requires either LOG_IO or PHY_IO privilege. Controls whether the /SPEED qualifier can be used to change the terminal speed. To reset the speed, use the /SET_SPEED qualifier and the /SPEED qualifier.
/SECURE_SERVER
/SECURE_SERVER /NOSECURE_SERVER (default) Determines whether the BREAK key on the terminal logs out the current process. With /SECURE_SERVER in effect, pressing the BREAK key when there is no current process initiates the login sequence. By default, the BREAK key has no effect. The /SECURE_SERVER qualifier has no effect on terminals that are set with /AUTOBAUD.
/SIXEL_GRAPHICS
/SIXEL_GRAPHICS /NOSIXEL_GRAPHICS Controls whether the terminal is capable of displaying graphics using the REGIS-defined SIXEL graphics protocol. The default is device-dependent.
/SOFT_CHARACTERS
/SOFT_CHARACTERS /NOSOFT_CHARACTERS Controls whether the terminal has the capability to load a user-defined character set. The default is device-dependent.
/SPEED
/SPEED=rate
Specifies the rate at which the terminal sends and receives data.
If you specify the rate as a single value, the input and output baud
rates are set to the same speed. To specify different baud rates
for input and output, specify the rate in the format (n,m). The
values n and m indicate the input (terminal to host) and output
(host to terminal) baud rates, respectively. Not all terminals
support different input and output baud rates. For specific
information on baud rates for your terminal, consult the manual for
that terminal.
The default transmission rates are installation-dependent.
The valid values for input and output baud rates are:
50 150 1800 4800
75 300 2000 7200
110 600 2400 9600
134 1200 3600 19200
NOTE
Some speeds are not supported on certain terminals.
For a list of speeds supported on a particular
terminal, see the appropriate hardware
documentation.
/SWITCH
/SWITCH=DECNET Causes the terminal lines at each node to be switched to dynamic asynchronous DDCMP lines, when specified with the /PROTOCOL=DDCMP qualifier. Note that the /SWITCH=DECNET qualifier is a permanent characteristic; therefore, the /PERMANENT qualifier need not be specified for this characteristic.
/SYSPASSWORD
/SYSPASSWORD /NOSYSPASSWORD (default) Determines whether the terminal requires that a system password be entered before the USERNAME: prompt is displayed. This qualifier requires LOG_IO privilege and should be used in conjunction with the /PERMANENT qualifier. For more information, see the Guide to VMS System Security.
/TAB
/TAB /NOTAB Controls how the terminal handles tab characters. The /NOTAB qualifier expands all tab characters to spaces and assumes tab stops at eight-character intervals. Use the /TAB qualifier when you do not want the system to convert tabs to spaces, but want the terminal to process the tab characters. VMS requires that terminals expand tabs at eight-character intervals. The default is device-dependent.
/TTSYNC
/TTSYNC (default) /NOTTSYNC Controls whether the system responds to a CTRL/S or CTRL/Q issued from the terminal in order to synchronize output. The default is /TTSYNC; the system stops sending output when CTRL/S is sent by the terminal and resumes output when a CTRL/Q is sent.
/TYPE_AHEAD
/TYPE_AHEAD (default) /NOTYPE_AHEAD Controls whether the terminal accepts unsolicited input, that is, input that you type when there is no outstanding read. When you specify /NOTYPE_AHEAD, the terminal is dedicated, and will accept input only when a program or the system issues a read to the terminal. Use the /NOTYPE_AHEAD qualifier to ensure that a specific terminal remains dedicated to a particular application. Logins are disabled on a terminal with /NOTYPE_AHEAD set. When you specify /TYPE_AHEAD, the amount of data that can be accepted is governed by the size of the type-ahead buffer. That size is determined by system generation parameters.
/UNKNOWN
/UNKNOWN Indicates that the system does not recognize the terminal type. When you specify this qualifier, the system uses the default terminal characteristics for unknown terminals.
/UPPERCASE
/UPPERCASE /NOUPPERCASE Specifies whether the terminal should translate all input lowercase letters to uppercase. This qualifier is complementary to the /LOWERCASE qualifier, that is, /UPPERCASE is equivalent to /NOLOWERCASE.
/WIDTH
/WIDTH=n Specifies the number of characters on each input or output line. The width value must be in the range 1 through 511. If the specified width on an ANSI terminal is 132, the screen is set to 132-character mode. If the terminal does not have advanced video option (AVO), the page length limit is set to 12 lines. When the /WRAP qualifier is in effect, the terminal generates a carriage return/line feed when a line reaches the column position specified by the width value.
/WRAP
/WRAP (default) /NOWRAP Controls whether or not the terminal generates a carriage return/line feed when it reaches the end of the line. The end of a line is determined by the setting of the terminal width. If you specify /NOWRAP and the terminal is accepting input, the terminal does not generate a carriage return/line feed when it reaches the end of a line, but continues to accept input at the last physical character position on the terminal line. If you specify /NOWRAP and the terminal is writing output, it continues to write characters out until it reaches the last position on the line. When you specify the /WRAP qualifier, the terminal generates a carriage return/line feed whenever the end of the line is reached. /WRAP is the default.
Examples
1. $ SET TERMINAL/DEVICE=VT102
This SET TERMINAL command establishes the current terminal as a
VT102 terminal and sets the default characteristics for that
terminal type.
2. $ SET TERMINAL/WIDTH=132/PAGE=60/NOBROADCAST
$ TYPE MEMO.DOC
.
.
.
$ SET TERMINAL/DEVICE=LA36
The first SET TERMINAL command indicates that the width of terminal
lines is 132 characters and that the size of each page is 60 lines.
The /NOBROADCAST qualifier disables the reception of broadcast
messages while the terminal is printing the file MEMO.DOC. The next
SET TERMINAL command restores the terminal to its default state.
TIME
Resets the system clock, which is used both as a timer to record
intervals between various internal events, and as a source clock for
displaying the time of day.
Requires both OPER and LOG_IO privileges.
Format:
SET TIME[=time]
Additional information available:
Parameters
time A date in the format day-month-year, a time in the format hour:minute:second.hundredth, or both. Day must be an integer in the range 1 through 31. Month must be JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, or DEC. Year must be an integer in the range 1858 through 9999. Hour must be an integer in the range 0 through 23. Minute must be an integer in the range 0 through 59. Second must be an integer in the range 0 through 59. Hundredth (of a second) must be an integer in the range 0 through 99. The hyphens, colons, and period are required delimiters. Delimit the date and time, when both are specified, with a colon. The syntax is sometimes specified as follows: [dd-mmm-yyyy[:]] [hh:mm:ss.cc] If the explicit time value is not specified, the interval system clock is automatically reset according to the time-of-year clock. Note that the time-of-year clock is optional for some processors. For further information about the time-of-year clock, see the VAX Hardware handbook.
Examples
1. $ SET TIME = 24-AUG-1988:19:31:0.0
Sets the date/time at August 24, 1988, 7:31 P.M.
2. $ SET TIME
$ SHOW TIME
19-DEC-1987 03:21:27.53
The SET TIME command sets the system time according to the
time-of-year clock. The SHOW TIME command requests a display of the
current time.
UIC
Changes the user identification code (UIC) of your process. Use
the SET UIC command to gain access to a restricted file, that is,
a file contained in a directory whose protection restricts access to
the owner of that directory. Requires CMKRNL (change mode to kernel
mode) privilege.
Format:
SET UIC uic
Additional information available:
Parameters
uic Specifies the group number and member number. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual.
Examples
1. $ SET UIC [370,10]
This command establishes your UIC as [370,10]. You can now read or
modify any files whose access is restricted to this UIC.
2. $ SET UIC [214,4]
$ SET DEFAULT [ANDERSON]
The SET UIC command sets your UIC to [214,4]; the SET DEFAULT
command sets the default directory name to [ANDERSON].
3. $ SET UIC [GEORGE]
This example sets the UIC to be that of the user named GEORGE who is
a member of the same group as the person issuing the SET UIC
command. Note the similarity of this UIC format to the directory
name format. Be sure not to use a UIC where a directory
specification is needed.
4. $ SET UIC [VMS,GEORGE]
This example sets the UIC to be that of the user named GEORGE who is
a member of the VMS group. The person issuing the SET UIC
command need not be a member of the VMS group.
VERIFY
Controls whether command lines and data lines in command procedures
are either displayed at the terminal or printed in a batch job log.
The information displayed by the SET VERIFY command can help you in
debugging command procedures.
Format:
SET [NO]VERIFY [=([NO]PROCEDURE, [NO]IMAGE)]
Additional information available:
Parameters
([NO]PROCEDURE, [NO]IMAGE) Specifies one or both types of verification. Procedure verification causes each DCL command line in a command procedure to be written to the output device. Image verification causes data lines (input data that is included as part of the SYS$INPUT input stream) to be written to the output device. If you do not specify either of the verification keywords, then both types of verification are set (with SET VERIFY) or cleared (with SET NOVERIFY). If you specify only one keyword, then the type of verification you specify is set or cleared; the other one is not affected. Also, when you specify only one keyword, you can omit the parentheses.
Examples
1. $ SET VERIFY
$ INDEX == "$INDEX.EXE
$ CONTENTS == "$CONTENTS.EXE
$ TABLE == "$TABLE.EXE
$ SET NOVERIFY
$ EXIT
Procedure and image verification are turned on at the beginning of
the command procedure so that the system will display all the
command and data lines in the procedure as it reads them. At the
end of the procedure, the SET NOVERIFY command restores the system
default (no procedure or image verification).
2. $ PROC_VER = F$ENVIRONMENT("VERIFY_PROCEDURE")
$ IMAGE_VER = F$ENVIRONMENT("VERIFY_IMAGE")
$ SET NOVERIFY
.
.
.
$ TEMP = F$VERIFY(PROC_VER, IMAGE_VER)
This command procedure uses the lexical function F$ENVIRONMENT to
save the current procedure and image verification setting. Then the
SET NOVERIFY command turns off both procedure and image
verification. Subsequently, the F$VERIFY function is used to
restore the original verification settings.
3. $ SET VERIFY
$ @TEST
$ RUN AVERAGE
1
2
3
$ EXIT
In this example, the SET VERIFY command turns procedure and image
verification on. When the command procedure TEST.COM is executed
interactively, the command lines and the data lines for the program
AVERAGE are displayed on the terminal. The data lines were entered
in the command procedure on lines that did not begin with the DCL
prompt.
4. $ SET VERIFY = PROCEDURE
In this example, procedure verification is turned on. If image
verification was previously on, it remains on; if image verification
was off, it remains off.
5. $ SET VERIFY
$ COUNT = 1
$ IF P'COUNT' .NES. "" THEN GOTO &P'COUNT'
.
.
.
$ EXIT
When this command procedure is executed interactively, the SET
VERIFY command causes the command and data lines to be displayed.
Symbols that are substituted during the first phase of symbol
substitution (such as 'COUNT') are displayed by the SET VERIFY
command, but other symbols are not. The following lines are
displayed when this procedure is executed interactively:
$ COUNT = 1
$ IF P1 .NES. "" THEN GOTO &P1
.
.
.
Although these values are not displayed, the value for P1 is
substituted during the third phase of symbol substitution, and the
value for &P1 is substituted during the second phase.
VOLUME
Modifies the characteristics of one or more mounted Files-11
volumes.
Format:
SET VOLUME device-spec[:][,...]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
device-name[:][,...] Specifies the name of one or more mounted Files-11 volumes.
Command Qualifiers
Additional information available:
/ACCESSED/DATA_CHECK/ERASE_ON_DELETE/EXTENSION
/FILE_PROTECTION/HIGHWATER_MARKING/LABEL/LOG
/MOUNT_VERIFICATION/OWNER_UIC/PROTECTION
/REBUILD/RETENTION/UNLOAD/USER_NAME/WINDOWS
/ACCESSED
/ACCESSED[=n] Requires operator (OPER) privilege. Specifies the number of directories to be maintained in system space for ready access. If you specify a value greater than the current value, the new value is effective immediately. However, if you specify a value that is less than the current value, the new value is written to the home block and will not take effect until the next time the volume is mounted. You can specify a number (n) in the range of 0 through 255. If you specify the qualifier /ACCESSED and omit the number of directories, a default value of 3 is used.
/DATA_CHECK
/DATA_CHECK[=(option[,...])]
Defines a default for data check operations following all reads
and/or writes to the specified volume. You can specify the
following options:
[NO]READ Determines whether checking is performed following all
read operations.
[NO]WRITE Determines whether checking is performed following all
write operations.
If you specify the /DATA_CHECK qualifier without specifying an
option, the default qualifier /DATA_CHECK=WRITE is used. If you
omit the /DATA_CHECK qualifier, no checking is performed.
/ERASE_ON_DELETE
/ERASE_ON_DELETE /NOERASE_ON_DELETE (default) Specifies that when a file on the volume is deleted, the space occupied by that file is erased. For more information on how the erasing is done, see the DELETE/ERASE command.
/EXTENSION
/EXTENSION[=n] Specifies the number of blocks to be used as a default extension size for all files on the volume. You can specify a number (n) in the range of 0 through 65535. If you specify the /EXTENSION qualifier without specifying a value, a default value of 0 (the VAX RMS default) is used. For example, during an update operation, the extension default is used when a file increases to a size greater than its initial default allocation.
/FILE_PROTECTION
/FILE_PROTECTION=(code) Specifies the default protection to be applied to all files on the specified volume. Specify the code according to the rules given in Chapter 8 of the VMS DCL Concepts Manual. Note that this attribute is not used while the volume is in use on a VMS system, but is provided to control the process use of the volume on RSX-11M systems. VMS always uses the default file protection; the protection can be changed with the DCL command SET PROTECTION/DEFAULT.
/HIGHWATER_MARKING
/HIGHWATER_MARKING /NOHIGHWATER_MARKING Specifies that all files on the disk volume are subject to file highwater marking. This qualifier applies to Structure Level 2 volumes only. If you specify /HIGHWATER_MARKING, SET VOLUME sets the File Highwater Mark (FHM) volume attribute. FHM is a mechanism that guarantees that a user cannot read data that he has not written. The /NOHIGHWATER_MARKING qualifier disables FHM for the volume.
/LABEL
/LABEL=volume-label Specifies a 1- through 12-character alphanumeric name to be encoded on the volume. Lowercase letters are automatically changed to uppercase. The specified label remains in effect until it is explicitly changed (that is, dismounting the volume does not effect the label).
/LOG
/LOG /NOLOG (default) Controls whether the SET VOLUME command displays the volume specification of each volume after the modification.
/MOUNT_VERIFICATION
/MOUNT_VERIFICATION /NOMOUNT_VERIFICATION Specifies whether the volume is subject to mount verification.
/OWNER_UIC
/OWNER_UIC[=uic] Sets the owner UIC of the volume to the specified UIC. Specify the UIC using standard UIC format as described in Chapter 8 of the VMS DCL Concepts Manual. If you specify the /OWNER_UIC qualifier without specifying a UIC, the current process UIC is used.
/PROTECTION
/PROTECTION=(code) Specifies the protection to be applied to the volume. The protection controls who can read, write, and delete files on the volume. If you do not specify a protection code, protection defaults to all types of access for all categories of user. Specify the code according to the rules given in Chapter 8 of the VMS DCL Concepts Manual. When you specify a protection code, access type E (execute) indicates create access.
/REBUILD
/REBUILD Recovers caching limits for a volume that was improperly dismounted. If a disk volume was dismounted improperly (such as during a system failure), and was then remounted with the MOUNT/NOREBUILD command, you can use SET VOLUME/REBUILD to recover the caching that was in effect at the time of the dismount.
/RETENTION
/RETENTION=(min[,max]) Specifies the minimum (min) and maximum (max) retention times to be used by the file system to determine the expiration date for files on the volume. When a file is created on the volume, the expiration date is initially set to the current time + max. Each time the file is accessed, the current time is added to the min time, and if this sum is greater than the expiration date, a new expiration date is computed. If you omit the max value, a default value that is the smaller of (2 x min) or (min + 7) days is used. For example, /RETENTION=3- is the same as /RETENTION=(3-,6-), while /RETENTION=10- is the same as /RETENTION=(10-,17-).
/UNLOAD
/UNLOAD (default) /NOUNLOAD Specifies whether the volume is unloaded (that is, spun down) when the DCL command DISMOUNT is issued.
/USER_NAME
/USER_NAME[=user-name] Specifies a user name of up to 12 alphanumeric characters to be recorded on the volume. If you specify the /USER_NAME qualifier without specifying a user name, the current process user name is used.
/WINDOWS
/WINDOWS[=n] Specifies the number of mapping pointers to be allocated for file windows. You can specify a number (n) in the range 7 through 80. If you specify the /WINDOWS qualifier without specifying a number, a default value of 7 is used.
Examples
1. $ SET VOLUME/DATA_CHECK=(READ,WRITE) DBC5
This command requests that data checks be performed following all
read and write operations to DBC5.
2. $ SET VOLUME/FILE_PROTECTION=(S:RWED,O:RWED,G:RE,W:RE) DBC5
This command sets the default protection to be applied to all files
created on volume DBC5. System and owner are granted all types of
access; group and world are permitted only to read and execute files
on DBC5.
3. $ SET VOLUME/LABEL=LICENSES DBC5
This command encodes the label LICENSES on the volume DBC5. Note
that if characters in labels are entered in lowercase, they are
changed to uppercase by the /LABEL qualifier.
4. $ SET VOLUME/ACCESSED=25/USER_NAME=MANAGER/LOG DBA0:
This command specifies that 25 directories are to be maintained in
system space for ready access for the volume DBA0. The command also
assigns the user name MANAGER to the volume and displays the volume
specification after the volume is modified.
5. $ SET VOLUME/REBUILD/LOG NODE$DBA2:
%SET-I-MODIFIED, _NODE$DBA2: modified
The SET VOLUME/REBUILD command causes a rebuild operation to begin
on the volume that is mounted on NODE$DBA2:. The /LOG qualifier
directs SET VOLUME to display a notification message.
WORKING_SET
Redefines the default working set size for the process, or sets an
upper limit to which the working set size can be changed by an image
that the process executes.
Format:
SET WORKING_SET
Additional information available:
Command Qualifiers
Additional information available:
/ADJUST/EXTENT/LIMIT/LOG/QUOTA
/ADJUST
/ADJUST (default) /NOADJUST Enables or disables the system's changing of the process working set.
/EXTENT
/EXTENT=n Specifies the maximum number of pages that can be resident in the working set during image execution. The extent value must be greater than the minimum working set defined at system generation, and it must be less than or equal to the authorized extent defined in the user authorization file. If you specify a value greater than the authorized extent, the command sets the working set limit at the maximum authorized value.
/LIMIT
/LIMIT=n Specifies the size to which the working set is to be reduced at image exit. If you specify a value greater than the current quota, the quota value is also increased.
/LOG
/LOG /NOLOG (default) Determines whether or not confirmation of the SET WORKING_SET command is displayed.
/QUOTA
/QUOTA=n Specifies the maximum number of pages that any image executing in the process context can request. An image can set the working set size for the process by calling the Adjust Working Set Limit ($ADJWSL) system service, which is described in the VMS System Services Manual. If you specify a quota value that is greater than the authorized quota, the working set quota is set to the authorized quota value.
Examples
1. $ SHOW WORKING_SET
Working Set /Limit= 150 /Quota= 350
/Extent= 350
Adjustment enabled Authorized Quota= 350 Authorized
Extent= 350
$ SET WORKING_SET/LIMIT=100
%SET-I-NEWLIMS, new working set: Limit = 100 Quota = 350
Extent = 350
$ SHOW WORKING_SET
Working Set /Limit= 100 /Quota= 350
/Extent= 350
Adjustment enabled Authorized Quota= 350 Authorized
Extent= 350
The SET_WORKING SET command sets the working set size for any image
in the process to 100.