HELP SET — VMS 5.2
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
DISPLAYENTRYFILEHOSTKEYLOGINSMAGTAPE
MESSAGEONOUTPUT_RATEPASSWORDPRINTERPROCESS
PROMPTPROTECTIONQUEUERESTART_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. The SET AUDIT
command is also used to modify the characteristics of the audit
server process, set up long term journaling (archiving) of audit
events, and monitor resource consumption on the system. (Note that
you must specify the /ALARM qualifier when enabling or disabling
security auditing and when using the /FAILURE_MODE qualifier.)
Requires the SECURITY privilege.
Format:
SET AUDIT
Additional information available:
Event Definition QualifiersAudit Journal QualifiersAudit Server QualifiersArchiving Qualifiers
Resource Monitoring QualifiersExamples
Event Definition Qualifiers
Additional information available:
/ALARM/DISABLE/ENABLE/FAILURE_MODE/VERIFY
/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. The /ALARM qualifier is required when enabling or disabling security auditing with the /ENABLE or /DISABLE qualifiers or when specifying an audit failure mode with the /FAILURE_MODE qualifier.
/DISABLE
/DISABLE=(keyword[,...]) Disables security auditing for the specified events. To disable alarms for all events, specify the keyword ALL. You can also 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.
/ENABLE
/ENABLE=(keyword[,...])
Enables security auditing for the specified events. To enable alarms
for all events, specify the keyword ALL. You can also 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 as follows:
ACL An event requested by an access control
list (ACL) item, including ACLs on files
and global sections.
ALL All possible events.
AUTHORIZATION The modification of any portion of the
system user authorization file (SYSUAF)
or network proxy authorization file
(NETPROXY), including any password
changes; the modification of any portion
of the rights database (RIGHTSLIST).
BREAKIN=(keyword[,...]) The occurrence of one or more of the
following classes of break-in 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 object's access control
list, if any). You can specify one or
more of the following keywords to
describe the object access event to be
noted.
ALL
All types of object access
events, as defined by the
remaining keywords.
BYPASS [:access [,access...]]
Successful object access due to
the use of the BYPASS privilege
FAILURE [:access[,access...]]
Unsuccessful object access
GRPPRV [:access [,access...]]
Successful object access due to
the use of the GRPPRV
privilege
READALL [:access [,access...]]
Successful object access due to
the use of the READALL
privilege
SUCCESS [:access [,access...]]
Successful object access
SYSPRV [:access [,access...]]
Successful object access due
to the use of the SYSPRV
privilege
Most of the keywords permit you to define
the type of object 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 issuance of a MOUNT or DISMOUNT
request
/FAILURE_MODE
/FAILURE_MODE[=keyword]
Specifies how the VMS operating system proceeds following a failed
attempt to write a security alarm to OPCOM's mailbox. Specify one of
the following keywords with the /FAILURE_MODE qualifier:
WAIT Indicates that processes are placed in 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.
The /ALARM qualifier is required when specifying an audit failure
mode.
/VERIFY
/VERIFY (default) /NOVERIFY Specifies that control is not returned to the users (at the DCL command level) until the audit server has completed the request.
Audit Journal Qualifiers
Additional information available:
/DESTINATION
/DESTINATION=file-spec Specifies the name and location of the security audit log file in the audit server database. The device, if part of the file specification, must be a disk volume. Because the system security log file is automatically created when the system is first installed and restored each time the system boots, this qualifier is only required when you want to move the log file. Once you have updated the audit server database, execute the command SET AUDIT/SERVER=NEW_LOG to make the new location of the log file known to all audit server processes in the cluster. The previous audit log file is closed, and all subsequent audit event messages generated on the cluster are redirected to the new audit log file. The /JOURNAL=SECURITY qualifier is required when redirecting the system security audit log file with the /DESTINATION qualifier.
/JOURNAL
/JOURNAL[=journal-name] Specifies the name of the audit journal. The default, /JOURNAL=SECURITY, represents the system security audit log file, and is currently the only supported audit journal type. The /JOURNAL qualifier is required when changing the location of the audit log file with the /DESTINATION qualifier.
/VERIFY
/VERIFY (default) /NOVERIFY Specifies that control is not returned to the users (at the DCL command level) until the audit server has completed the request.
Audit Server Qualifiers
Additional information available:
/INTERVAL/LISTENER/SERVER/VERIFY
/INTERVAL
/INTERVAL=(option-keyword[,...])
Specifies the delta times to be used for regular audit server
operations. See the VMS DCL Concepts Manual for information about
specifying delta times.
In most cases, the defaults noted should be sufficient.
Option Keyword Description
ARCHIVE_FLUSH=time Specifies the period of time the audit
server waits before flushing information
to be archived. The default is one minute.
JOURNAL_FLUSH=time Specifies the period of time the audit
server waits before flushing information
in the various audit journal buffers. The
default is 5 minutes.
RESOURCE_SCAN=time Specifies the period of time the audit
server waits before monitoring the volume
containing the audit journal for resource
exhaustion. Resource exhaustion occurs
when the volume has no free disk space.
The default is 5 minutes.
RESUME_SCAN=time Specifies the period of time the audit
server waits before reviewing an existing
resource exhaustion condition. The default
is 15 minutes.
/LISTENER
/LISTENER=device /NOLISTENER Specifies the name of a mailbox device which receives a copy of all security audit events. The user-defined mailbox can be used for processing of system security events as they occur, rather than logging events to the system audit journal for inspection at a future time. See the VMS Audit Analysis Utility Manual for a description of the message formats written to the listener mailbox. Specify the SET AUDIT/NOLISTENER command to remove a listener device from the system.
/SERVER
/SERVER=option-keyword[,...])
Specifies the audit server characteristics to be modified.
In most cases, the defaults noted should be sufficient.
Option Keyword Description
CREATE_SYSTEM_LOG Causes the audit server to create a new
local system security audit log file.
Other audit servers in the cluster are
not affected. This keyword may be used by
sites operating a multiple-environment
cluster where it may be necessary to
create a new log file on a specific
node in the cluster. CREATE_SYSTEM_LOG is
synonomous with NEW_LOG for nonclustered
systems.
EXIT Initiates an audit server shutdown. This
is the only method for removing the audit
server process from the system; the audit
server cannot be deleted or suspended.
FINAL_ACTION=action Specifies the action taken by the audit
server when resource exhaustion conditions
have been met. Resource exhaustion occurs
when the audit server attempts to buffer
audit messages and runs out of virtual
memory. (See the Guide to VMS System
Security for more information about
resource monitoring.) Specify one of the
following values:
CRASH Crash the system if the system
runs out of virtual memory.
This is the default.
IGNORE_NEW Ignore new event messages
until resources are available.
Events messages leading up
to the resource condition are
saved; new messages are lost.
PURGE_OLD Removes old event messages
until resources are available
in order to save the most
current messages.
FLUSH Copies all buffered audit and archive
records to the audit log file and security
archive file, respectively.
NEW_LOG Creates a new clusterwide audit log file.
The audit log file is created by the audit
server process running on the local system
and is opened by all audit servers in the
cluster. (Typically, this is used daily to
generate a new version of the audit log
file.)
REDIRECT_SYSTEM_LOG Causes the audit server on the local node
to redirect security event messages to
a new audit log file, whose location was
previously defined by the /DESTINATION
qualifier. Audit server processes (and log
files) on other nodes in the cluster are
unaffected.
RESUME Requests the audit server process to
resume normal activity on the system,
if adequate disk space is available.
Normally, once a resource monitoring
action threshold has been reached,
the audit server process suspends most
system activity and waits 15 minutes
before attempting to resume normal system
activity.
START Starts the audit server process on the
system.
/VERIFY
/VERIFY (default) /NOVERIFY Specifies that control is not returned to the user (at the DCL command level) until the audit server has completed the request.
Archiving Qualifiers
Additional information available:
/ARCHIVE
/ARCHIVE=option-keyword[,...])
Specifies the classes of audit messages events to be written to the
security archive file. Specify one or more of the following
keywords:
Option Keyword Description
NONE Disables archiving on the system. By
default, archiving is disabled on the
system.
[NO]ALL Enables or disables archiving of all
system security events.
SYSTEM_ALARM Enables archiving of all system-generated
alarm events.
SYSTEM_AUDIT Enables archiving of all system-generated
audit events. Reserved for future use.
USER_ALARM Enables archiving of all user-generated
alarm events. Reserved for future use.
USER_AUDIT Enables archiving of all user-generated
audit events. Reserved for future use.
/DESTINATION
/DESTINATION=file-spec Specifies the name of the archive log file. Events may be archived to a local or remote file on any file-structured disk device. See the Guide to VMS System Security for information about creating a security archive file.
/VERIFY
/VERIFY (default) /NOVERIFY Specifies that control is not returned to the users (at the DCL command level) until the audit server has completed the request.
Resource Monitoring Qualifiers
Additional information available:
/EXCLUDE/JOURNAL/RESOURCE/THRESHOLD/VERIFY
/EXCLUDE
/[NO]EXCLUDE=process-id
Adds a process ID (PID) to the audit server process exclusion list.
The process exclusion list contains those processes which will not
be suspended by the audit server process if a resource exhaustion
reaches the action threshold. By default, the following processes
are always contained in the process exclusion list and are never
candidates for process suspension:
CACHE_SERVER
CLUSTER_SERVER
CONFIGURE
JOB_CONTROL
OPCOM
SWAPPER
VWS$DISPLAYMGR
VWS$EMULATORS
Use the SET AUDIT/NOEXCLUDE=process-id command to remove a process
from the process exclusion list. (PIDs are not automatically removed
from the process exclusion list when processes log out from the
system.)
/JOURNAL
/JOURNAL=[journal-name] Specifies the name of the audit journal. The default, /JOURNAL=SECURITY, represents the system security audit log file, and is currently the only supported audit journal type. The /JOURNAL qualifier is required when specifying resource monitoring characteristics with the /RESOURCE or /THRESHOLD qualifiers.
/RESOURCE
/RESOURCE=option-keyword[,...])
Controls whether resource monitoring is in effect on the system,
specifies the method used to monitor available resources, and
determines the action the audit server will take if the available
resources are depleted. The /JOURNAL qualifier is required when
specifying resource monitoring with the /RESOURCE qualifier. See the
Guide to VMS System Security for more information about resource
monitoring.
Option Keyword Description
DISABLE Disables or enables resource monitoring on the
ENABLE security audit journal file. By default, resource
monitoring is enabled on the system.
MONITOR_MODE=mode Specifies the method the audit server uses to
monitor available resources. Specify one of the
following keywords:
COUNT Controls whether resource monitoring
is based on the amount of free disk
space required to store a fixed number
of event messages.
PERCENTAGE Controls whether resource monitoring
is based on the percentage of the disk
volume or volume set available.
SPACE Controls whether resource monitoring
is based on the number of free blocks
on the disk. This is the default method
used for resource monitoring.
TIME Controls whether resource monitoring
is based on the amount of free disk
space needed to store events which
occur over a fixed period of time
(in seconds).
/THRESHOLD
/THRESHOLD=type
Specifies the thresholds the audit server uses for resource
monitoring. The values which may be specified for each of the
thresholds described depends on the mode of resource monitoring
enabled on the system (see /RESOURCE=MONITOR_MODE). The /JOURNAL
qualifier is required when modifying audit server thresholds
with the /THRESHOLD qualifier.
Threshold Type Meaning
WARNING=value Specifies the threshold at which the audit
server notifies all security operator terminals
that resource exhaustion has occurred.
ACTION=value Specifies the threshold at which the audit
server suspends normal system activity.
RESUME=value Specifies the threshold at which the audit
server resumes normal system activity.
The following table lists the default warning, action, and resume
thresholds for each resource monitor mode. Normally, the defaults
listed should be sufficient.
Monitor Mode WARNING ACTION RESUME
------------ ------- ------ ------
SPACE (blocks) 1000 250 750
PERCENTAGE (of volume) 1 0 1
COUNT (number of messages) 5000 1250 3750
TIME (seconds) 1000 250 750
/VERIFY
/VERIFY (default) /NOVERIFY Specifies that control is not returned to the users (at the DCL command level) until the audit server has completed the request.
Examples
1. $ SET AUDIT/ALARM/ENABLE=(ACL,MOUNT,AUTHORIZATION)
$ SET AUDIT/ALARM/ENABLE=(BREAKIN:ALL,LOGFAIL:ALL)
$ SHOW AUDIT
Security alarm failure mode is set to:
WAIT Processes will wait for resource
Security alarms currently enabled for:
ACL
MOUNT
AUTHORIZATION
BREAKIN: (DIALUP,LOCAL,REMOTE,NETWORK,DETACHED)
LOGFAILURE: (BATCH,DIALUP,LOCAL,REMOTE,NETWORK,SUBPROCESS,DETACHED
The SET AUDIT command in this example enables security alarms and audit
journal messages for a number of security events; the display from the
SHOW AUDIT command identifies the events being audited. Note that, by
default, VMS places processes in the MWAIT state to wait for resources
if an attempt to write a security audit to the OPCOM mailbox fails.
2. $ SET AUDIT/FAILURE_MODE=IGNORE
The SET AUDIT command in this example directs the VMS operating system
to ignore security alarms if they cannot be written and to maintain a
count of the lost security alarms. Enter the command SHOW AUDIT to
display the number of lost alarm messages.
3. $ SET AUDIT/ALARM/DISABLE=ALL
The SET AUDIT command in this example disables all security alarms
and audit journal messages.
4. $ SET AUDIT/JOURNAL=SECURITY -
_$ /DESTINATION=AUDIT$:[AUDIT]SECURITY_AUDIT.LOG
$SET AUDIT/SERVER=NEW_LOG
The first SET AUDIT command in this example updates the audit server
database with the new name and location of the system security audit
log file. The second command in the example causes all audit server
processes in the cluster to open the new log file.
5. $ SET AUDIT/ALARM/ENABLE=ALL/DISABLE=FILE:ALL
The SET AUDIT command in this example enables auditing of all classes
of security events except file access alarms.
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 SET 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
Enables or disables CTRL/Y or CTRL/T. CTRL/Y interrupts a command
and returns you to the DCL command level. CTRL/T momentarily
interrupts a command to print a line of statistics. When SET
NOCTROL=Y is in effect, the INTERRUPT message is displayed, but no
interruption takes place.
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
Sets your default device and directory specifications. 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[:]][directory-spec]
Additional information available:
Parameters
device-name[:] The name of the device you want to go to. directory-spec The name of the directory you want to go to. A directory name must be enclosed in brackets. Use the minus sign to specify the next higher directory from the current default. You must specify either the device-name parameter or the directory-spec parameter. If you specify only the device name, the current directory is the default for the directory-spec parameter. If you specify only the directory name, the current device is the default for the device-name parameter. You can use a logical name but it must constitute at least the device part of the specification. When you use a search list logical name as the parameter, the logical name is not translated by the SET DEFAULT command. Instead, the SET DEFAULT command retains the logical name so that RMS is able to access the entire search list. If you enter the SHOW DEFAULT command, the search list logical name is displayed as the default device, along with its equivalence strings.
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 operational status for a device.
Requires OPER privilege.
Format:
SET DEVICE device-name[:]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
device-name[:] Specifies the name of the device whose spooling or operational 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 operational status is to change.
Command Qualifiers
Additional information available:
/AVAILABLE/DUAL_PORT/ERROR_LOGGING/LOG
/SPOOLED
/AVAILABLE
/AVAILABLE /NOAVAILABLE Controls whether the specified disk or magnetic tape is to be considered available. You must dismount the specified disk or magnetic tape before entering the SET DEVICE/[NO]AVAILABLE command. If you specify /NOAVAILABLE, any attempt to allocate or mount the specified disk or magnetic tape 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 is 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[,...]
DISPLAY
Directs the output of a DECwindows application. Output can be
directed from any VAX processor running a DECwindows application,
including workstations, to any DECwindows workstation.
Both source and destination nodes must be part of the same network.
Format:
SET DISPLAY [display-device]
Additional information available:
ParameterCommand QualifiersExamples
Parameter
display-device Specifies a logical name for the workstation display you are creating or modifying. If you are directing application output to multiple workstation displays, you can use different logical names to point to each display. If you do not specify a display-device string, the logical name DECW$DISPLAY is used. This means that by default, application output will be displayed on the workstation display device referred to by DECW$DISPLAY. By entering the command SHOW DISPLAY, you can see the workstation node where applications will be displayed by default. If you specified your own logical name in the SET DISPLAY/CREATE command, include that logical name in the SHOW DISPLAY command.
Command Qualifiers
Additional information available:
/CREATE/PERMANENT/NODE/TRANSPORT
/CREATE
/CREATE Creates the workstation display device (WSAn:) on which a DECwindows application is displayed. You must specify the /CREATE qualifier the first time you use the SET DISPLAY command, but you need not respecify it if you continue to redirect output from applications to other workstations with subsequent SET DISPLAY commands. When /CREATE is specified without /NODE, the workstation device defaults to the current node.
/PERMANENT
/[NO]PERMANENT Cancels the redirected display by deassigning the logical name DECW$DISPLAY. If you specified a logical name as the display- device parameter with the SET DISPLAY/CREATE command, entering the SET DISPLAY/NOPERMANENT display-device command cancels the redirected display by deassigning the logical name you specified. The DECwindows Session Manager defines DECW$DISPLAY in your job logical name table when you open a terminal (DECterm) window. When you redirect application output to another workstation with the SET DISPLAY/CREATE command, an additional DECW$DISPLAY logical name is defined in your process logical name table. This definition supersedes the definition in the job logical name table. Output from applications run from the process in which you executed the SET DISPLAY/CREATE command will be displayed on the workstation referred to by the definition of DECW$DISPLAY in the process logical name table. Enter the SHOW DISPLAY command to see where this application will be displayed. To see whether multiple definitions for DECW$DISPLAY exist, enter the command SHOW LOGICAL DECW$DISPLAY. If DECW$DISPLAY is still defined (for example, in the job logical name table) after you specify the /NOPERMANENT qualifier, any DECwindows applications run from this process will be displayed on the workstation device to which output is now directed. Enter the SHOW DISPLAY command if you are unsure of the node to which DECW$DISPLAY refers. Use caution when entering the SET DISPLAY/NOPERMANENT command. If you modify or delete the definition of DECW$DISPLAY from the job logical name table, you will be unable to start another session. Be careful not to specify the /NOPERMANENT qualifier without having first redirected the display with the SET DISPLAY/CREATE command. You cannot specify /NOPERMANENT and /CREATE on the same command line.
/NODE
/NODE=workstation_display Defines the workstation on which you want to display DECwindows applications. The node name you provide cannot be a cluster alias (a name that represents multiple nodes configured in a VAXcluster), but must instead identify an actual node. You must create a workstation display device with the /CREATE qualifier before you can redirect the output from applications to other workstations. Do not enter the SET DISPLAY/NODE=workstation_ display command without having previously specified the /CREATE qualifier. Make sure that you are authorized to display applications on the workstation you specify. See the VMS DECwindows User's Guide for more information about using the DECwindows Session Manager to authorize yourself to display applications from other nodes. Each node, both source and destination, must be defined in each other's network node database. For example, to display applications on node HUBBUB from ZEPHYR, HUBBUB must be entered in ZEPHYR's network node database. ZEPHYR must be defined in HUBBUB's network node database. In addition, users on ZEPHYR must be authorized in the DECwindows Session Manager to display applications on HUBBUB. See the VMS Networking Manual and the VMS Network Control Program Manual for information about entering nodes in a network node database.
/TRANSPORT
/TRANSPORT=transport-name Defines the mechanism, for example, DECNET or LOCAL, that passes information between the application and the workstation. The transport mechanism is used to send input from the user to the application and output from the application to the display. If you specify the /CREATE qualifier, the default transport is DECNET. Use the /TRANSPORT=LOCAL qualifier to optimize the performance of applications running and displaying on the same node.
Examples
1. $ SHOW DISPLAY
Device: WSA1:
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
$ SET DISPLAY/CREATE/NODE=ZEPHYR
$ SHOW DISPLAY
Device: WSA2:
Node: ZEPHYR
Transport: DECNET
Server: 0
Screen: 0
$ SPAWN/NOWAIT/INPUT=NL: RUN SYS$SYSTEM:DECW$CLOCK
$ SET DISPLAY/NOPERMANENT
$ SHOW DISPLAY
Device: WSA1:
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
In this example, you are logged in to your workstation, here
referred to as node 0. (0 is the standard shorthand notation for
representing your node.) You want to run the DECwindows Clock on
your workstation and display it on another workstation, ZEPHYR.
Assuming you are authorized to display applications on ZEPHYR, you
redirect the application's output to ZEPHYR with the SET DISPLAY
command and enter the SHOW DISPLAY command to verify the location of
the redirected display. You then run Clock. When you finish running
Clock, you disable the redirected display by entering the SET
DISPLAY/NOPERMANENT command. Finally, you enter the SHOW DISPLAY
command to verify that any applications subsequently run on your
node will also be displayed there.
Note that a new workstation display device, WSA2, is created when
you enter the SET DISPLAY/CREATE command. When you cancel the
redirected display with the SET DISPLAY/NOPERMANENT command,
application output is once again displayed on the workstation
display device referred to by WSA1.
2. $ SET DISPLAY/CREATE/NODE=FLOPSY RABBIT
$ SHOW DISPLAY RABBIT
Device: WSA2:
Node: FLOPSY
Transport: DECNET
Server: 0
Screen: 0
$ RUN/DETACHED/OUTPUT=WSA2: SYS$SYSTEM:DECW$CLOCK
$ SET DISPLAY/CREATE/NODE=ZEPHYR ZNODE
$ SHOW DISPLAY ZNODE
Device: WSA3:
Node: ZEPHYR
Transport: DECNET
Server: 0
Screen: 0
$ RUN/DETACHED/OUTPUT=WSA3: SYS$SYSTEM:DECW$CALENDAR
$ RUN SYS$SYSTEM:DECW$BOOKREADER
$ SHOW DISPLAY
Device: WSA1:
Node: 0
Transport: LOCAL
Server: 0
Screen: 0
In this example, you are logged in to your node, and want to direct
the output from applications to several workstation displays in the
same session. By specifying different logical names in the SET
DISPLAY command, you can redirect the output without changing the
logical name definition for DECW$DISPLAY. This allows you to display
the output from most applications on your default display but
occassionally display output on another workstation. You can also
continue to run and display applications on your node. In this
example, Clock is displayed on node FLOPSY, Calendar is displayed on
node ZEPHYR, and Bookreader is displayed on your workstation.
Note that to run your applications with the DCL command RUN
/DETACHED, you must use the device name that equates to the logical
display device name you specified in the SET DISPLAY command. Use
the SHOW DISPLAY command to obtain this device name.
ENTRY
Changes the current status or attributes of a job that is not
currently executing in a queue.
Requires OPER privilege, EXECUTE (E) access to the queue, or DELETE
(D) access to the specified jobs.
Format:
SET ENTRY entry-number [,...]
Additional information available:
ParameterCommand QualifiersExamples
Parameter
entry-number [,...] Specifies the entry number (or a list of entry numbers) of the jobs you want to change. The system assigns a unique entry number to each queued print or batch job in the system. By default, the PRINT and SUBMIT commands display the entry number when they successfully queue a job for processing. These commands also create or update the local symbol $ENTRY to reflect the entry number of the most recently queued job. To find a job's entry number, enter the SHOW ENTRY or SHOW QUEUE command.
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. For information on specifying time values, see the VMS DCL Concepts Manual.
/BURST
/BURST /NOBURST Controls whether two file flag pages with a burst bar between them are printed preceding each file in a job. Use the /[NO]BURST qualifier to override the /DEFAULT options that have been set for the output queue you are using. The /[NO]BURST qualifier does not override the /SEPARATE options set for the queue. When you specify /BURST for a file, the /[NO]FLAG qualifier does not add or subtract a flag page from the two flag pages that are printed preceding a file.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...])
/NOCHARACTERISTICS
Specifies the name or number of one or more characteristics to be
associated with the job. Characteristics can refer to such things as
color of ink. If you specify only one characteristic, you can omit
the parentheses.
A characteristic's number must range from 0 to 127. To see which
characteristics have been defined for your system, use the SHOW
QUEUE/CHARACTERISTICS command. To see which characteristics are
associated with a particular queue, use the SHOW QUEUE/FULL command.
A print job can be processed on an execution queue if none, some, or
all of the characteristics associated with the queue also are
associated with the job. That is, the job's characteristics must be
a subset of the queue's characteristics. However, if any of the
characteristics associated with the job are not associated with the
queue, the job remains pending until one or more of the following
occurs:
- the characteristics specified with the queue are changed to
make the job's characteristics a subset of the queue's
characteristics (using, for example, the SET QUEUE
/CHARACTERISTICS command)
- the characteristics specified with the job are changed to make
the job's characteristics a subset of the queue's
characteristics (using, for example, the SET ENTRY
/CHARACTERISTICS command)
- the job is moved to a queue on which all the job's
characteristics have been specified (using, for example, the
SET ENTRY/REQUEUE command)
- the job is deleted (using, for example, the DELETE/ENTRY
command)
/CLI
/CLI=filename Specifies the name of a command language interpreter (CLI) to use in processing the batch 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 file (UAF), 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 value of n can be any number from 1 to 255. When you use the /COPIES qualifier with the SET ENTRY command, the number of copies can apply only to the entire print job. You cannot use this qualifier to specify different numbers of copies for individual files within a multifile job.
/CPUTIME
/CPUTIME=option Specifies a CPU time limit for the batch job. You can specify time as delta time, 0, INFINITE, or NONE. If the queue on which the job executes has a defined CPUMAXIMUM value, the smaller of the specified job and queue values is used. If the queue on which the job executes does not have a specified maximum CPU time limit, the smaller of the SUBMIT command and user authorization file (UAF) values is used. If the queue on which the job executes does not have a specified maximum CPU time limit and the UAF has a specified CPU time limit of NONE, either the value 0 or the keyword INFINITE allows unlimited CPU time. If you specify NONE, the specified queue or UAF value is used. CPU time values must be greater than or equal to the number specified by the SYSGEN parameter PQL_MCPULM. For information on specifying time values, see the VMS DCL Concepts Manual.
/FEED
/FEED /NOFEED Controls whether form feeds are inserted into the print job when the printer reaches the bottom margin of the form in use. 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 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 multifile job.
/FLAG
/FLAG /NOFLAG Controls whether a flag page is printed preceding each file in a print job. The flag page contains the name of the user submitting the job, the job entry number, and other information about the file being printed. Use the /[NO]FLAG qualifier to override the installation-defined defaults that have been set for the output queue you are using or to override the qualifier specified in the PRINT command that queued the job.
/FORM
/FORM=type
Specifies the name or number of the form to be associated with the
print job. If you omit the /FORM qualifier, the default form for the
execution queue is associated with the job.
Forms have attributes such as print image width and length or paper
stock, which the print symbiont associates with a job when the job
is processed. To see which forms have been defined for your system,
use the SHOW QUEUE/FORM command. To find out which form is mounted
currently on a particular queue and which form is specified as that
queue's default form, use the SHOW QUEUE/FULL command.
The stock of the form associated with the job must match the stock
of the form mounted on the execution queue on which you want the job
to be processed. If the stocks do not match, the job remains pending
until one or more of the following occurs:
_ A form with the same stock as the job's form is mounted on the
queue (using, for example, the SET QUEUE/FORM_MOUNTED command)
- A form with the same stock as the queue's mounted form is
specified with the job (using, for example, the SET ENTRY/FORM
command)
- The job is moved to a queue on which the stock of the mounted
form matches the stock of the job's form (using, for example,
the SET ENTRY/REQUEUE command)
- The job is deleted (using, for example, the DELETE/ENTRY
command)
/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 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 enter SET ENTRY /NOHOLD
or SET ENTRY/RELEASE. You can use the SET 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 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 Creates a log file with the specified file specification. You can specify a different device name, as long as the process executing the batch job has access to the device on which the log file will reside. Logical names in the file specification are translated in the context of the process that executes the SET ENTRY command. 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 print job 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 Names the job. The job name must be 1 to 39 alphanumeric characters. The SHOW ENTRY and SHOW QUEUE commands display the job name. 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. The default job name is the nane of the first, or only, file in the job.
/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 you did not specify the /DELETE qualifier when the job was originally submitted to the queue, you cannot use the SET ENTRY command to establish file deletion at a later time. You cannot use the /NODELETE qualifier to cancel deletion of individual files in a multifile job .
/NOTE
/NOTE=string
Specifies a message of up to 255 characters to appear on the flag
page of a print job. Enclose messages containing lowercase letters,
blanks, or other nonalphanumeric characters (including spaces) in
quotation marks ("").
/NOTIFY
/NOTIFY /NONOTIFY Controls whether a message notifies you when your job has been completed or aborted. Notification is sent to any terminal session on the same cluster at which you are logged in.
/OPERATOR
/OPERATOR=string
Specifies a message string of up to 255 characters to be sent to the
operator just before the print job begins to print. Enclose the
message in quotation marks ("") if it contains spaces, special
characters, or lowercase characters.
/PAGES
/PAGES=([lowlim,]uplim)
Specifies the number of pages to print for the specified job. You
can use the /PAGES qualifier to print portions of long files. By
default, all pages of the file are printed. When you use the /PAGES
qualifier with the SET ENTRY command, the qualifier can apply only
to an entire job. You cannot use this qualifier to specify different
numbers of pages to be printed for individual files within a
multifile job.
The lowlim specifier refers to the first page of the file that you
want to print. If you omit the lowlim specifier, the printing starts
on the first page of the file.
The uplim specifier refers to the last page of the file that you
want to print. When you want to print to the end of the file but do
not know how many pages are in the file, use two consecutive
quotation marks ("") as the uplim specifier.
You can omit the parentheses when you specify only a value for the
uplim specifier. For example, /PAGES=10 prints the first 10 pages of
the file; /PAGES=(5,10) prints pages 5 through 10; /PAGES=(5,"")
starts printing at page 5 and continues until the end of the file is
reached.
/PARAMETERS
/PARAMETERS=(parameter[,...]) Specifies from one to eight 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 of the print job 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, are ignored. When you use the /PASSALL qualifier with the SET 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 Queues the batch job log file for printing when the job is completed. The default output queue for the log file is SYS$PRINT. The /PRINTER qualifier allows you to specify an output queue. The /NOPRINTER qualifier assumes the /KEEP qualifier.
/PRIORITY
/PRIORITY=n Requires OPER or ALTPRI privilege to raise the priority above the value of the SYSGEN parameter MAXQUEPRI. Specifies the job-scheduling priority of the job. The value of n is an integer 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. No privilege is needed to set the priority lower than the MAXQUEPRI value.
/RELEASE
/RELEASE Releases for processing jobs submitted with the /HOLD qualifier or /AFTER qualifier, jobs held in a queue with the /RETAIN qualifier, and jobs refused by a user-written symbiont.
/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 failure or a STOP/QUEUE/REQUEUE command.
/SETUP
/SETUP=module[,...] Extracts the specified modules from the device control library (containing escape sequence modules for programmable printers) and copies the modules to the printer before each file in a print job is printed. When you use the /SETUP qualifier with the SET ENTRY command, the qualifier applies to the entire print job. You cannot use this qualifier to specify different setup modules for individual files within a multifile job.
/SPACE
/SPACE /NOSPACE Controls whether output of a print job is double-spaced. Specifying /NOSPACE causes the output to be single-spaced. When you use the /SPACE qualifier with the SET ENTRY command, the qualifier applies to the entire job. You cannot use this qualifier to specify different spacing for individual files within a multifile job.
/TRAILER
/TRAILER[=keyword] /NOTRAILER Controls whether a trailer page is printed at the end of each file in a print job. The trailer page displays the entry number, as well as information about the user submitting the job and the files being printed. When you use the /TRAILER qualifier with the SET ENTRY command, trailer pages are placed at the end of each file in a multifile job. Use the /[NO]TRAILER qualifier to override the installation-defined defaults that have been set for the output queue you are using or the qualifier specified in the PRINT command that queued the job.
/WSDEFAULT
/WSDEFAULT=n Defines for a batch job a working set default, the default number of physical pages that the job can use. If the queue on which the job executes has a nonzero default working set, the smaller of the specified job and queue values is used. If the queue on which the job executes has a working set default of 0, the smaller of the specified job value and the value established in the user authorization file (UAF) is used. If you specify 0 or NONE, the specified queue or UAF value is used. Working set default values must range between the numbers specified by the SYSGEN parameters PQL_MWSDEFAULT and WSMAX.
/WSEXTENT
/WSEXTENT=n Defines for the batch job a working set extent, the maximum amount of physical memory that the job can use. The job uses the maximum amount of physical memory only when the system has excess free pages. If the queue on which the job executes has a nonzero working set extent, the smaller of the specified job and queue values is used. If the queue on which the job executes has a working set extent of 0, the smaller of the specified job value and the value established in the user authorization file (UAF) is used. If you specify 0 or NONE, the specified queue or UAF value is used. Working set extent values must range between the numbers specified by the SYSGEN parameters PQL_MWSEXTENT and WSMAX.
/WSQUOTA
/WSQUOTA=n Defines for the batch job a working set quota, the amount of physical memory that the job is guaranteed. If the queue on which the job executes has a nonzero working set quota, the smaller of the specified job and queue values is used. If the queue on which the job executes has a working set quota of 0, the smaller of the specified job value or the value established in the user authorization file (UAF) is used. If you specify 0 or NONE, the specified queue or UAF value is used. Working set quota values must range between the numbers specified by the SYSGEN parameters PQL_MWSQUOTA and WSMAX.
Examples
1. $ PRINT/HOLD MYFILE.DAT
Job MYFILE (queue SYS$PRINT, entry 112) holding
$ SET ENTRY 112/RELEASE/JOB_COUNT=3
The PRINT command in this example requests that the file MYFILE.DAT
be queued to the system printer, but placed in a hold status. The
SET ENTRY command releases the job for printing and requests that
three copies of the job be printed.
2. $ SUBMIT CLIMATE
Job CLIMATE (queue SYS$BATCH, entry 211) pending
$ SET ENTRY 211/HOLD/NAME=TEMP
The SUBMIT command in this example queues the command procedure
CLIMATE.COM for processing as a batch job. The SET ENTRY command
places the job in a hold state and changes the job name to TEMP,
assuming that the job has 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.
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/SEMANTICS/SINCE/STATISTICS
/TRUNCATE/UNLOCK/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 unmarks 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 Specifies that BACKUP records the contents of the file. The /NOBACKUP qualifier causes BACKUP to record the attributes of the file but not its contents. Valid only for Files-11 Structure Level 2 files. The /NOBACKUP qualifier is useful for saving files that contain unimportant data, such as SWAPFILES.
/BEFORE
/BEFORE[=time] Selects only those files dated prior to the specified time. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, or YESTERDAY. See the VMS DCL Concepts Manual for complete information on specifying time values.
/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 unmarks 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 only those files whose owner user identification code (UIC) matches the specified owner UIC. The default UIC is that of the current process. Specify the UIC using standard UIC format as described in the VMS DCL Concepts Manual.
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether a request is issued before each SET FILE operation
to confirm that the operation should be performed on that file. The
following responses are valid:
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), but these abbreviations must
be unique. 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, DCL issues an error message and redisplays the prompt.
/CREATED
/CREATED Modifies the time value specified with the /BEFORE or /SINCE qualifier. /CREATED selects files based on their dates of creation.
/DATA_CHECK
/DATA_CHECK[=([NO]READ,[NO]WRITE)] Specifies whether a READ data check (rereading each record), a WRITE data check (reading each record after it is written), or a combination of the two is performed on the file during transfers. By default, a WRITE data check is performed.
/END_OF_FILE
/END_OF_FILE Resets the end-of-file mark to the highest block allocated.
/ENTER
/ENTER=new-file-spec Use with caution. Assigns an additional name to a single file so that the file has a second name, or alias. However, both the original name and the alias reference the same file. For this reason, take care when deleting files that have aliases. 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.
/ERASE_ON_DELETE
/ERASE_ON_DELETE Specifies that the specified files will be erased from the disk (not just merely written over) when a DELETE or PURGE command is issued for the files. See DELETE/ERASE for more information.
/EXCLUDE
/EXCLUDE=(file-spec[,...]) Excludes the specified file from the SET FILE operation. You can include a directory name but not a device name in the file specifications. Wildcard characters are supported for file specifications. However, you cannot use relative version numbers to exclude a specific version. If you specify only one file, you can omit the parentheses.
/EXPIRATION_DATE
/EXPIRATION_DATE=date /NOEXPIRATION_DATE Requires ownership of the file or access control. Controls whether an expiration date is assigned to the specified files. Specify the date according to the rules described in the VMS DCL Concepts Manual. Absolute date keywords are allowed. If you specify 0 as the date, today's date is used.
/EXTENSION
/EXTENSION[=n] Sets the extend quantity default for the file. The value of n can range from 0 through 65,535. If you omit the value specification or specify a value of 0, VMS 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 Sets the VAX RMS global buffer count (the number of buffers that can be shared by processes accessing the file) for the specified files. The value n must be an integer in the range 0 through 32,767. A value of 0 disables buffer sharing.
/LOG
/LOG /NOLOG (default) Displays the file specification of each file modified as the command executes.
/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 Use with extreme caution. This qualifier removes the directory attributes of a file and 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 are 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 Verify Utility, see the VMS Analyze/Disk_Structure Utility Manual.
/OWNER_UIC
/OWNER_UIC[=uic] Requires GRPPRV to set the owner to another member of the same group. Requires SYSPRV to set the owner to any UIC outside your group. Specifies an owner user identification code (UIC) for the file. The default is the UIC of your process. Specify the UIC using standard UIC format as described in the VMS DCL Concepts Manual.
/PROTECTION
/PROTECTION[=(code)] Cannot be used to change the protection on a file via DECnet. Enables you to change or reset the protection for one or more of your files. The ownership categories are SYSTEM, OWNER, GROUP, AND WORLD. The access categories are R (read), W (write), E (execute), and D (delete). If you specify /PROTECTION without the ownership and access code, the file protection is set according to the current default protection. See the VMS DCL Concepts Manual for more information on specifying protection code.
/REMOVE
/REMOVE Use with caution. This qualifier 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 cannot access that file with most DCL commands; use the ANALYZE/DISK_STRUCTURE utility to retrieve the file.
/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 unmark 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.
/SEMANTICS
/SEMANTICS=semantics-tag /NOSEMANTICS You use /SEMANTICS to create or change a semantics tag. You use /NOSEMANTICS to remove a semantics tag from a file. For more information, see the Guide to VMS File Applications.
/SINCE
/SINCE[=time] Selects only those files dated after the specified time. You can specify time as an absolute time, a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, or YESTERDAY. See the VMS DCL Concepts Manual for complete information on specifying time values.
/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.
/TRUNCATE
/TRUNCATE Truncates the file at the end of the block containing the end-of- file (EOF) marker, that is, releases allocated but unused blocks of the file.
/UNLOCK
/UNLOCK Makes one or more improperly closed files accessible.
/VERSION_LIMIT
/VERSION_LIMIT[=n] Specifies the maximum number of versions for the specified file. 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 of 32,767. When you exceed that limit, the earliest version of the file is deleted from the directory without notification to the user. 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 is maintained.
Examples
1. $ SET FILE/EXPIRATION_DATE=19-APR-1990: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., December 31, 1988. 2. $ SET FILE/BEFORE=31-DEC/ERASE_ON_DELETE PERSONNEL*.SAL This SET FILE command calls for all files that match the file specification PERSONNEL*.SAL and are dated before December 31 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. You must have system privilege (SYSPRV) 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 to which you will connect.
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-1990 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. Exit from the remote system by typing CTRL/\; that
is, type a backslash (\) while holding down the CTRL key.
You must have an account on the remote system in order to log in to
that system after the connection is made.
You must be able to assign a channel to the terminal port specified.
By default, BYPASS privilege is required but this can be changed by
setting the device protection for the terminal port.
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 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: keyword is the telephone number to be autodialed and is a required parameter. The MODEM_TYPE: parameter is optional and can be used to specify a modem-type other than a DF03, DF112, or DMCL. By default, a modem-type of DF03 is assumed. DMCL is 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 do not specify a file, the log information is stored in the file SETHOST.LOG. When used to log a modem session, the log file contains 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 SET HOST/DTE command in this example 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.
3. $ ALLOCATE TTA2:
$ SET TERMINAL/TYPE_AHEAD
$ SET HOST/DTE TTA2:
Username: Smith
Password:
$ DEALLOCATE TTA2:
In this example, the outgoing port is set to NOTYPE_AHEAD. Once the
port is allocated, the terminal line is set to TYPE_AHEAD to allow
the login to the remote system.
/DUP
Connects your terminal to a storage controller through the
appropriate bus for that controller. For use only with storage
controllers. Requires the DIAGNOSE privilege.
Format:
SET HOST/DUP node-name
Additional information available:
ParameterCommand QualifiersExample
Parameter
node-name Specifies the node name of the storage controller.
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.
/SERVER
/SERVER=server-name Specifies the server name for the target storage controller. This qualifier is required.
/TASK
/TASK=task-name Specifies the utility or diagnostic name to be executed on the target storage controller under direction of the server. This qualifier is required.
Example
$ SET HOST/DUP/SERVER=DUP$/TASK=DIRECT BLKHOL %HSCPAD-I-LOCPROGEXE, Local program executing - type ^<backslash> to exit utility The SET HOST/DUP command in this example connects the user terminal to the utility program called DIRECT executing on a storage controller named BLKHOL under direction of the DUP$ server.
/HSC
Connects your terminal to a remote HSC through the Computer
Interconnect bus.
Format:
SET HOST/HSC node-name
Additional information available:
Parameters
node-name Specifies the node name of the remote HSC.
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
Establishes, changes, or removes a password. SET PASSWORD can be
used by users to change their own passwords, and by the system
managers to change the system password.
Format:
SET PASSWORD
Additional information available:
Command Qualifiers
Additional information available:
/GENERATE
/GENERATE[=value] Generates a list of 5 random passwords. Press RETURN to repeat the procedure until a suitable password appears. Value is a number from 1 to 10 that restricts the length of the password. For any value n, SET PASSWORD generates passwords of from n to (n+2) characters long. If no value is specified, SET PASSWORD uses a default value of 6, and generates passwords from 6 to 8 characters long. Values greater than 10 are not accepted and produce errors. If your system manager has established a minimum password length for your account, SET PASSWORD/GENERATE=n compares that length with the length of the optional value, and uses the larger of the two values.
/SECONDARY
/SECONDARY Creates or allows you to replace a secondary password. The procedure is the same as 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. Secondary passwords make it possible to set up an account that requires two different people to access it. Each person knows one of the two passwords, and both passwords are required to log in successfully. To remove your secondary password, press the RETURN key when SET PASSWORD/SECONDARY prompts you for a new password and verification. After you do this, you will receive a single PASSWORD: prompt when logging in. If you remove the secondary password, your system manager must restore it. The /SECONDARY and /SYSTEM qualifiers are incompatible.
/SYSTEM
/SYSTEM Requires both SECURITY and CMKRNL privileges. Changes the system password, rather than a user password. If a terminal line has the system password (SYSPWD) characteristic set, no terminal prompts are 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. Refer to the Guide to VMS System Security for more information about the use of system passwords.
Examples
1. $ SET PASSWORD
Old password: HONCHO
New password: BIG_ENCHILADA
Verification: BIG_ENCHILADA
In response to the SET PASSWORD command, the system first prompts
for the old password and then for the new password. The system then
prompts again for the new password to verify it. The password
changes 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. 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. If no process is specified, changes are made to the current process. Requires GROUP privilege to change other processes in the same group. Requires WORLD privilege to change processes outside your group. Format: SET PROCESS [process-name]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
process-name
Requires that you own the process or that you have GROUP privilege
and that the process is in your group. Specifies the name of the
process for which the characteristics are to be changed. Process
names can be up to 23 alphanumeric characters long in the following
format:
[node-name::]process-name
o The node name can have as many as six alphanumeric characters.
o The colons count for two characters.
o The process name can have as many as 15 characters.
A local process name can look like a remote process name. Therefore,
if you specify ATHENS::SMITH, the system checks for a process named
ATHENS::SMITH on the local node before checking node ATHENS for a
process named SMITH.
The default process is the current process. the process name is
compatible 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) Causes the contents of the address space to be written to the file named SYS$LOGIN:image-name.DMP when an image terminates due to an unhandled error. You can then analyze the dump with the ANALYZE/PROCESS_DUMP Utility.
/IDENTIFICATION
/IDENTIFICATION=pid Requires GROUP or WORLD privilege for processes other than your own. Specifies the process identification value (PID) of the process for which characteristics are to be changed. Overrides the process-name parameter. Compatible only with the /PRIORITY, /RESUME, and /SUSPEND qualifiers. 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.
/NAME
/NAME=string Changes the name of the current process to a string of 1 through 15 characters.
/PRIORITY
/PRIORITY=n Requires ALTPRI privilege to set the priority higher than the base priority of the specified 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.
/PRIVILEGES
/PRIVILEGES=(privilege[,...]) Requires SETPRV privilege to enable a privilege you do not have. Enables privileges for the process. Use the SHOW PROCESS /PRIVILEGES command to determine what privileges are currently enabled.
/RESOURCE_WAIT
/RESOURCE_WAIT /NORESOURCE_WAIT Enables resource wait mode so that the process waits for resources to become available. If you specify the /NORESOURCE_ WAIT qualifier, the process receives 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, or buffered I/O byte count (buffer space) quota.
/RESUME
/RESUME Allows a process suspended by a previous SET PROCESS /SUSPEND command to resume operation. The /RESUME qualifier is equivalent to the /NOSUSPEND qualifier.
/SUSPEND
/SUSPEND[=SUPERVISOR]
/SUSPEND=KERNEL
/NOSUSPEND
Requires privileges as described in the table below. 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 Specifies that the named process is to be suspended to
(default) allow the delivery of Asynchronous System Traps (ASTs)
at EXEC or KERNEL mode. Specifying this keyword is
optional.
KERNEL Specifies that the named process is to 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. Permits the process to be swapped. 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 OCALA::CHEESE
17-FEB-1990 12:17:24.45 User: CHEESE Process ID: 31400208
Node: OCALA Process name: "CHEESE"
Processes in this tree:
CHEESE *
CHEESE_1
CHEESE_2
$ SET PROCESS OCALA::CHEESE_2 /SUSPEND=KERNEL
$
The SET PROCESS/SUSPEND=KERNEL command in this example suspends the
process CHEESE_2 on node OCALA 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 that limits other users' access to a file
or a group of files.
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 you
omit the code, the access is set to the current default protection.
The code is made up of the following components:
o Ownership category - SYSTEM, OWNER, GROUP, or WORLD. Each
category can be abbreviated to its first character.
o Access category - R (READ), W (WRITE), E (EXECUTE), or D
(DELETE). The access category is assigned to each ownership
category. A null access specification means no access.
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 only for the highest
existing version of the file. Wildcard characters are allowed.
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. To change the protection, type Y (YES) or T (TRUE) at the system prompt and press RETURN. If you enter anything else, such as N or NO, the file protection is not changed.
/LOG
/LOG /NOLOG (default) Controls whether the system displays the file specification of each file for which the protection is changed as the command executes.
/PROTECTION
/PROTECTION=(code) File-spec qualifier. If you follow a file specification with the /PROTECTION qualifier, the code specified with /PROTECTION overrides the command's code parameter. The /PROTECTION qualifier lets you assign different protection codes to several files with a single SET PROTECTION command.
Examples
1. $ DELETE INCOME.DAT;3
%DELETE-W-FILNOTDEL, error deleting DISK1:[SMITH]INCOME.DAT;3
-RMS-E-
PRV, insufficient privilege or file protection violation
$ SET PROTECTION=OWNER:D INCOME.DAT;3
$ DELETE INCOME.DAT;3
In this example, the file INCOME.DAT;3 has been protected against
deletion. The SET PROTECTION command gives the owner the ability to
delete the file INCOME.DAT;3.
2. $ 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.
3. $ 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.
4. $ 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.
5. $ 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/DESCRIPTION
/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 execution queue. The base priority specifier can be any decimal value from 0 through 15. You also can specify this qualifier for an output execution queue. In this context the /BASE_PRIORITY qualifier establishes the base priority of the symbiont process when the symbiont process is created.
/BLOCK_LIMIT
/BLOCK_LIMIT=([lowlim,]uplim) /NOBLOCK_LIMIT Limits the size of print jobs that can be processed on an output execution 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 are 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 block limit for the queue is changed. After the block limit for the queue is decreased sufficiently, the job is processed. The uplim parameter is a decimal number referring to the maximum number of blocks that are accepted by the queue for a print job. If a print job is submitted that exceeds this value, the job remains pending until the block limit for the queue is changed. After the block limit for the queue is increased sufficiently, the job is processed. 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 are processed in the queue. To specify only a lower job limit, you must use two double quotation marks to indicate the upper specifier. For example, /BLOCK_LIMIT=(500,"") means any job with 500 or more blocks is processed 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 20 00 blocks are not processed in the queue. The /NOBLOCK_LIMIT qualifier cancels the previous /BLOCK_LIMIT setting for that queue.
/CHARACTERISTICS
/CHARACTERISTICS=(characteristic[,...]) /NOCHARACTERISTICS Specifies one or more characteristics for processing jobs on an execution queue. If a queue does not have all the characteristics that have been specified for a job, the job remains pending. If you specify only one characteristic, you can omit the parentheses. Each time you specify /CHARACTERISTICS, all previously set characteristics are cancelled. Only the characteristics specified with the qualifier are 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. The /NOCHARACTERISTICS qualifier cancels any /CHARACTERISTICS 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 accepts or rejects 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 pending in the queue continue to be candidates for execution.
/CPUDEFAULT
/CPUDEFAULT=time Defines the default CPU time limit for jobs in a batch execution queue. You can specify time as delta time, 0, INFINITE, or NONE. You can specify up to 497 days of delta time. If the queue does not have a defined CPUMAXIMUM time limit and the value established in the user authorization file (UAF) has a specified CPU time limit of NONE, either the value 0 or the keyword INFINITE allows unlimited CPU time. If you specify NONE, the CPU time value defaults to the value specified either in the UAF or by the SUBMIT command (if included). CPU time values must be greater than or equal to the number specified by the SYSGEN parameter PQL_MCPULM. The time cannot exceed the CPU time limit set by the /CPUMAXIMUM qualifier. For information on specifying delta time, see the VMS DCL Concepts Manual.
/CPUMAXIMUM
/CPUMAXIMUM=time Defines the maximum CPU time limit for all jobs in a batch execution queue. You can specify time as delta time, 0, INFINITE, or NONE. You can specify up to 497 days of delta time. The /CPUMAXIMUM qualifier overrides the time limit specified in the user authorization file (UAF) for any user submitting a job to the queue. Either the value 0 or the keyword INFINITE allows unlimited CPU time. If you specify NONE, the CPU time value defaults to the value specified either in the UAF or by the SUBMIT command (if included). CPU time values must be greater than or equal to the number specified by the SYSGEN parameter PQL_MCPULM. For information on specifying delta times, see the VMS DCL Concepts Manual.
/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. After you set an option
for the queue with the /DEFAULT qualifier, you do not have to
specify that option in your PRINT commands. If you do specify these
options in your PRINT command, the values specified with the PRINT
command override the values established for the queue with the
/DEFAULT qualifier. Possible options are as follows:
[NO]BURST[=keyword] Controls whether two file flag pages with
a burst bar between them are printed
preceding output. If you specify the value
ALL (default), these flag pages are
printed before each file in the job. If
you specify the value ONE, these flag
pages are printed once before the first
file in the job.
[NO]FEED Specifies whether a form feed is inserted
automatically at the end of a page.
[NO]FLAG[=keyword] Controls whether a file flag page is
printed preceding output. If you specify
the value ALL (default), a file flag page
is printed before each file in the job. If
you specify the value ONE, a file flag
page is printed once before the first file
in the job. without an explicit form
definition, this form is used to process
the job. See also /FORM_MOUNTED.
[NO]TRAILER[=keyword] Controls whether a file trailer page is
printed following output. If you specify
the value ALL (default), a trailer page is
printed with each file in the job. If you
specify the value ONE, a trailer page is
printed once with the last file in the
job.
FORM=type Specifies the default form for an output
execution queue. If a job is submitted
without an explicit form definition, this
form is used to process the job. See also
/FORM_MOUNTED.
[NO]TRAILER[=keyword] Controls whether a file trailer page is
printed following output. If you specify
the value ALL (default), a trailer page is
printed with each file in the job. If you
specify the value ONE, a trailer page is
printed once with the last file in the
job.
When you specify the BURST option for a file, the [NO]FLAG option
does not add or subtract a flag page from the two flag pages that
are printed preceding the file.
For information on establishing mandatory queue attributes, see the
description of the /SEPARATE qualiifer. For information on
specifying default queue attributes, see the Guide to Maintaining a
VMS System.
/DESCRIPTION
/DESCRIPTION=string
/NODESCRIPTION
A string of up to 255 characters used to provide operator-supplied
information about the queue.
Enclose strings containing lowercase letters, blanks, or other
nonalphanumeric characters (including spaces) in quotation marks
("").
The /NODESCRIPTION qualifier removes any descriptive text that may
have been associated with the queue.
/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 specify explicit queue names can be placed in this execution queue for processing.
/FORM_MOUNTED
/FORM_MOUNTED=type Specifies the form type for an output execution queue. If the stock of the mounted form is not identical to the stock of the default form, as indicated by the /DEFAULT=FORM qualifier, all jobs submitted to this queue without an explicit form definition 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, the job enters a pending state. In both cases, jobs remain pending until the stock of the mounted form of the queue is identical to the stock of the form associated with the job. To specify the form type, use either 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. Specify a number in the range 0 through 255.
/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 in the queue, use the /CLOSE qualifier. Whether a queue accepts or rejects new job entries is independent of the queue's state (such as paused, stopped, stalled).
/OWNER_UIC
/OWNER_UIC=uic Requires OPER privilege or CONTROL and EXECUTE access to the queue. Enables you to change the user identification code (UIC) of the queue. Specify the UIC using standard format as described in the VMS DCL Concepts Manual.
/PROTECTION
/PROTECTION=(ownership[:access],...) Requires OPER privilege or CONTROL and EXECUTE access to the queue. Specifies the protection of the queue. Ownership categories are SYSTEM, OWNER, GROUP, WORLD; each category can be abbreviated to its first character. Access categories are R (READ), W (WRITE), E (EXECUTE), or D (DELETE); a null access specification means no access. If you include only one protection code, you can omit the parentheses. For more information on specifying protection codes, see the VMS DCL Concepts Manual. For more information on controlling queue operations through UIC-based protection, see the Guide to Maintaining a VMS System.
/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 sends 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 Holds jobs in the queue in a retained status after they have executed. The /NORETAIN qualifier enables you to reset the queue to the default. Possible options are as follows: ALL Holds all jobs in the queue after execution (default) ERROR Holds in the queue only jobs that complete unsuccessfully
/SCHEDULE
/SCHEDULE=[NO]SIZE Specifies whether pending jobs in an output queue are scheduled for printing based on the size of the job. When the /SCHEDULE=SIZE qualifier is in effect, shorter jobs print before longer ones. When /SCHEDULE=NOSIZE is in effect, jobs are printed in the order they were submitted, regardless of size. If you enter this command while there are pending jobs in any queue, its effect on future jobs is unpredictable.
/SEPARATE
/SEPARATE=(option[,...])
/NOSEPARATE
Specifies the mandatory queue attributes or job separation options
for an output execution queue. Job separation options cannot be
overridden by the PRINT command.
The job separation options are as follows:
[NO]BURST Specifies whether two job flag pages
with a burst bar between them are
printed at the beginning of each job.
[NO]FLAG Specifies whether a job flag page is
printed at the beginning of each job.
[NO]TRAILER Specifies whether a job trailer page is
printed at the end of each job.
[NO]RESET=(module[,...]) Specifies one or more device control
library modules that contain the job
reset sequence for the queue. The
specified modules from the queue's
device control library (by default
SYS$LIBRARY:SYSDEVCTL) are used to
reset the device each time a job reset
occurs. The RESET sequence occurs after
any file trailer and before any job
trailer. Thus, all job separation pages
are printed when the device is in its
RESET state.
When you specify /SEPARATE=BURST, the [NO]FLAG separation option
does not add or subtract a flag page from the two flag pages that
are printed preceding the job.
For information on establishing queue attributes that can be
overridden, see the description of the /DEFAULT qualifier.
For more information on specifying mandatory queue attributes, see
the Guide to Maintaining a VMS System.
/WSDEFAULT
/WSDEFAULT=n Defines for a batch job a working set default, the default number of physical pages that the job can use. 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. If you specify 0 or NONE, the working set default value defaults to the value specified in the UAF or by the SUBMIT command (if included).
/WSEXTENT
/WSEXTENT=n Defines for the batch job a working set extent, the maximum amount of physical memory that the job can use. The job uses the maximum amount of physical memory only when the system has excess free pages. 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. If you specify 0 or NONE, the working set default value defaults to the value specified in the UAF or by the SUBMIT command (if included). 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). You can specify a working set default and a working set quota for individual jobs or for all jobs in a given queue.
/WSQUOTA
/WSQUOTA=n
Defines for a batch job the working set quota, the amount of
physical memory that is available to the 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. If you specify 0 or
NONE, the working set default value defaults to the value specified
in the UAF or by the SUBMIT command (if included) the specified job
or UAF value is used.
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). You can specify a working set default and a working set
quota for individual jobs or for all jobs in a given queue.
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). You can specify a working set default and a working set
quota for both individual jobs and for all jobs in a given queue.
The decision table (Table DCL-1) shows the action taken for
different combinations of specifications that involve working set
size and working set quota values.
Table DCL-1 Working Set Default, Extent, and Quota Decision
Value Specified By
The SUBMIT Value Specified
COMMAND? For The Queue? Action Taken
No No Use the UAF value
No Yes Use value for the queue
Yes Yes Use smaller of the two
values
Yes No Compare specified value with
UAF value; use the smaller
/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
Assigns a value to the global symbol BATCH$RESTART. This global
symbol defines the location at which a batch job is restarted after
its execution has been interrupted. Use the SET RESTART_ VALUE
command in command procedures. This command has no meaning if you
enter it interactively.
Format:
SET RESTART_VALUE=string
Additional information available:
Parameter
string A string of up to 255 characters specifying the label at which the batch job should begin executing when the batch job is restarted.
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. Lets you treat symbols
as being undefined. Possible keywords are as follows:
NOLOCAL Causes all local symbols defined in outer procedure
levels to be treated as being defined by the current
procedure and all inner procedure levels.
LOCAL Removes any symbol translation limit set by the current
procedure level.
NOGLOBAL Causes all global symbols to be inaccessible to the
current procedure level and all inner procedure levels
unless otherwise changed.
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
Sets the characteristics of a terminal. Entering a qualifier changes
a characteristic; omitting a qualifier leaves the characteristic
unchanged.
Format:
SET TERMINAL [device-name[:]]
Additional information available:
ParametersCommand QualifiersExamples
Parameters
device-name[:] Specifies the name of the terminal. The default is SYS$COMMAND, if that device is a terminal. If the device is not a terminal, an error message is displayed.
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/FORM/FRAME/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/SECURE_SERVER/SET_SPEED
/SIXEL_GRAPHICS/SOFT_CHARACTERS/SPEED/SWITCH/SYSPASSWORD
/TAB/TTSYNC/TYPE_AHEAD/UNKNOWN/UPPERCASE
/WIDTH/WRAP
/ADVANCED_VIDEO
/ADVANCED_VIDEO /NOADVANCED_VIDEO Specifies that the terminal has advanced video attributes and is capable of 132-column video. 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 Causes the terminal driver to create a permanent, alternate type-ahead buffer. The sysgen parameter TTY_ALTYPAHD determines the size of the type-ahead buffer. This specification is effective at your next login and stays in effect until you reboot your VAX computer. You should specify SET TERMINAL/PERMANENT/ALTYPEAHD in the SYS$SYSTEM:STARTUP.COM for those communication lines that require this capability. To use this feature interactively, specify SET TERMINAL/PERMANENT/ALTYPEAHD. This specification is effective at your next login.
/ANSI_CRT
/ANSI_CRT /NOANSI_CRT Specifies whether the terminal conforms to ANSI CRT programming standards. 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
Specifies that the terminal baud rate is set when you log in and
sets the default terminal speed to 9600 baud. You must press the
RETURN key two or more times at intervals of at least one second for
the baud rate to be correctly determined. 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.
The /AUTOBAUD quaslifier must be used with the /PERMANENT qualifer.
The valid baud rates are as follows:
110 1200 4800
150 1800 9600
300 2400 19200
600 3600
/BLOCK_MODE
/BLOCK_MODE /NOBLOCK_MODE Performs block mode transmission, local editing, and field protection. .
/BRDCSTMBX
/BRDCSTMBX /NOBRDCSTMBX Sends broadcast messages to an associated mailbox if one exists.
/BROADCAST
/BROADCAST (default) /NOBROADCAST Enables reception of broadcast messages (such as those issued by MAIL and REPLY). Specify 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. Use SET BROADCAST to exclude certain types of messages from being broadcast to your terminal, rather than eliminating all messages.
/CRFILL
/CRFILL[=fill-count] Generates the specified number of null characters after each carriage return before transmitting the next meaningful character (to ensure that the terminal is ready for reception). The value must be an integer in the range 0 through 9. The default is /CRFILL=0.
/DEC_CRT
/DEC_CRT[=(value1,value2,value3)]
/NODEC_CRT[=(value1,value2,value3)]
Specifies that the terminal conforms to DIGITAL VT100-, VT200- , or
VT300-family standards and supports the minimum standards, including
the additional DIGITAL escape sequences.
One of the following three optional values may be specified:
1 (default) Requests that the DEC_CRT terminal characteristic
be set.
2 Requests that the DEC_CRT2 terminal characteristic
be set.
3 Requests that the DEC_CRT3 terminal characteristic
be set. A level 3 terminal is described as
follows:
o Supports a status line (line 25, at the bottom
Note that DEC_CRT2 and DEC_CRT3 are supersets of DEC_CRT. Clearing
DEC_CRT causes DEC_CRT2 and DEC_CRT3 to be cleared. Similarly,
setting DEC_CRT3 will cause all subsets of DEC_CRT3 (including
ANSI_CRT) to be set.
/DEVICE_TYPE
/DEVICE_TYPE=terminal-type
Informs the system of the terminal type and sets characteristics
according to the device type specified. You can specify any of the
following terminal types:
UNKNOWN LA34
FT1 - FT8 LA38
LA12 LA100
LA36 LQP02
LA120 VT125
LN03 LN01K
VT05 VT131
VT52 VT132
VT55 VT173
VT100 VT200
VT101 PRO_SERIES
VT102 LA210
VT105 VT300
The default characteristics for the VT100, VT102, and VT125 series
terminals are as follows:
/ADVANCEDVIDEO /CRFILL=0 /LFFILL=0 /SPEED=9600
/NOALTYPEAHD /ECHO /LOWERCASE /TAB
/ANSI_CRT /NOEIGHT_BIT /NODMA /TTSYNC
/NOAUTOBAUD /NOESCAPE /PAGE=24 /TYPE_AHEAD
/NOBLOCK_MODE /NOFORM /NOPARITY /WIDTH=80
/NOBRDCSTMBX /FULLDUP /NOPASTHRU /WRAP
/BROADCAST /NOHOSTSYNC /NOREADSYN
/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 disconnected if the line detects a hangup. The /DISCONNECT qualifier is valid only when /PERMANENT is specified.
/DISMISS
/DISMISS /NODISMISS (default) Causes the terminal driver to ignore data causing a parity error (instead of terminating 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.
/ECHO
/ECHO (default) /NOECHO Causes the terminal to display the input it receives. With /NOECHO, the terminal displays only system or user application output, or both.
/EDIT_MODE
/EDIT_MODE /NOEDIT_MODE Specifies that the terminal can perform ANSI-defined advanced editing functions.
/EIGHT_BIT
/EIGHT_BIT /NOEIGHT_BIT Uses 8-bit ASCII protocol rather than 7-bit ASCII protocol. You can use the Terminal Fallback Facility (TFF) to set the 8-bit characteristic on terminals. If the terminal you specify has the TFF 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) Validates escape sequences.
/FALLBACK
/FALLBACK /NOFALLBACK Displays the 8-bit DEC Multinational Character Set characters on the terminal in their 7-bit representation. The default depends on the /EIGHTBIT setting of the terminal. If the VMS Terminal Fallback Facility (TFF) is enabled, it activates the default character conversion tables for the named terminal. See the VMS Terminal Fallback Utility Manual for more information. If TFF is not enabled on your system, /FALLBACK has no effect and no error message is displayed.
/FORM
/FORM /NOFORM Transmits a form feed rather than translating it into multiple line feeds.
/FRAME
/FRAME=n Specifies the number of data bits that the terminal driver expects for every character that is input or output. The value of n can be from 5 through 8. The default value depends on the /PARITY and /EIGHTBIT settings of the terminal.
/FULLDUP
/FULLDUP (default) /NOFULLDUP Operates in full duplex mode. The /FULLDUP qualifier is equivalent to /NOHALFDUP.
/HALFDUP
/HALFDUP /NOHALFDUP (default) Operates in half duplex mode. The /HALFDUP qualifier is equivalent to /NOFULLDUP.
/HANGUP
/HANGUP /NOHANGUP (default) May require LOG_IO or PHY_IO privilege depending on system generation parameter settings. Controls whether the terminal modem is hung up when you log out.
/HARDCOPY
/HARDCOPY /NOHARDCOPY Establishes the device as a hardcopy terminal and outputs a backslash (\) when the DELETE key is pressed. The /HARDCOPY qualifier is equivalent to /NOSCOPE.
/HOSTSYNC
/HOSTSYNC /NOHOSTSYNC (default) When you specify the /HOSTSYNC qualifier, the system stops transmission to the terminal (by generating a CTRL/S) when the input buffer is full and resumes transmission (by generating a CTRL/Q) when the input buffer is empty.
/INQUIRE
/INQUIRE
Sets the device type according to a response elicited from the
terminal; the default is UNKNOWN. Works only on DIGITAL terminals,
and not on the LA36 or VT05 terminals. Some VT100- family terminals,
including the VT101 and VT105, return a VT100- type response. LA38
terminals respond as LA43 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 editing command lines. The default mode is /OVERSTRIKE, which allows you to type over the current character when editing a command line. Use CTRL/A to switch from one mode to the other.
/LFFILL
/LFFILL[=fill-count] Transmits to the terminal the specified number of null characters after each line feed before transmitting the next meaningful character (to ensure that the terminal is ready for reception). The value must be an integer in the range 0 through 9. The default is installation-dependent. The default is installation-dependent.
/LINE_EDITING
/LINE_EDITING /NOLINE_EDITING Enables advanced line-editing features for editing command lines: both RETURN and CTRL/Z are recognized as line terminators, as are escape sequences.
/LOCAL_ECHO
/LOCAL_ECHO
/NOLOCAL_ECHO (default)
Echoes characters locally (rather than the host echoing them) for
command level terminal functions. (Do not use /LOCAL_ECHO with
utilities that require control over echoing, such as line editing or
EDT's screen mode.)
CAUTION
When logging in to terminals with /LOCAL_ECHO set, the
VMS operating system has no control over the echoing of
passwords.
/LOWERCASE
/LOWERCASE /NOLOWERCASE Passes lowercase characters to the terminal. The /NOLOWERCASE qualifier translates all input to uppercase. /LOWERCASE is equivalent to /NOUPPERCASE.
/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 that the terminal is connected to a modem or a cable that supplies standard EIA modem control signals. If your terminal has the MODEM characteristic, typing SET TERMINAL/NOMODEM automatically logs you out.
/NUMERIC_KEYPAD
/NUMERIC_KEYPAD (default) Specifies that the keypad is to be set to /NUMERIC_KEYPAD mode, which allows you to use the keys on the numeric keypad to type numbers and punctuation marks. In order to use the DEFINE/KEY facility, which allows you to enter DCL commands defined with the DEFINE/KEY command, set the terminal to /APPLICATION_KEYPAD. Specifies whether the keys of the numeric keypad are used to type numbers and punctuation marks (/NUMERIC_KEYPAD) or to enter DCL commands defined with the DEFINE/KEY command (/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. Set your terminal to /INSERT if you want to insert characters when editing command lines. Use CTRL/A to switch from one mode to the other.
/PAGE
/PAGE[=lines-per-page] For hardcopy terminals, specifies the number of print lines between perforations. (When the terminal reads a form feed, it advances the paper to the next perforation.) The value of n can be from 0 through 255 and defaults to 0 (which treats a form feed as a line feed).
/PARITY
/PARITY[=option] /NOPARITY (default) Passes data with odd or even parity, where option equals ODD or EVEN. If you specify /PARITY without an option, the value defaults to EVEN.
/PASTHRU
/PASTHRU /NOPASTHRU (default) Passes all data (including tabs, carriage returns, line feeds, and control characters) to an application program as binary data. The setting of /TTSYNC is allowed. Make sure that you spell both these qualifiers exactly as they appear in the text.
/PERMANENT
Requires LOG_IO or PHY_IO privilege. Sets characteristics on a permanent basis, that is, over terminal sessions. However, the characteristics revert to their initial values if the system is halted and restarted. Use in a system startup file to establish characteristics for all terminals on the system.
/PRINTER_PORT
/PRINTER_PORT /NOPRINTER_PORT Specifies that the terminal has a printer port (an attribute not set by the SET TERMINAL/INQUIRE command). The default is installation-dependent. See Figure DCL-1 for a list of default terminal characteristics.
/PROTOCOL
/PROTOCOL=DDCMP /PROTOCOL=NONE (default) Controls whether the terminal port specified is changed into an asynchronous DDCMP line. The /PROTOCOL=NONE qualifier changes an asynchronous DDCMP line back into a terminal line. Note that /PROTOCOL=DDCMP is a permanent characteristic; therefore, the /PERMANENT qualifier is not required.
/READSYNC
/READSYNC /NOREADSYNC (default) Uses the CTRL/S and CTRL/Q functions to synchronize data transmitted from the terminal. 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 that the terminal understands REGIS graphic commands.
/SCOPE
/SCOPE /NOSCOPE Establishes the device as a video terminal. /SCOPE is equivalent to /NOHARDCOPY.
/SECURE_SERVER
/SECURE_SERVER /NOSECURE_SERVER (default) Causes the BREAK key on the terminal to log out the current process (except on a virtual terminal). With /SECURE_SERVER in effect, pressing the BREAK key when there is no current process initiates the login sequence. With /NOSECURE_SERVER in effect, the break is ignored. On terminals set with /AUTOBAUD, with the /SECURE_SERVER qualifier in effect, pressing the BREAK key disconnects the current process but is not required to start a new login sequence. However, when /NOAUTOBAUD is set, the /SECURE_SERVER characteristic requires a break to initiate a new login sequence.
/SET_SPEED
/SET_SPEED /NOSET_SPEED Requires either LOG_IO or PHY_IO privilege. Allows the /SPEED qualifier to be used to change the terminal speed.
/SIXEL_GRAPHICS
/SIXEL_GRAPHICS /NOSIXEL_GRAPHICS Specifies that the terminal is capable of displaying graphics using the sixel graphics protocol. The default is device-dependent.
/SOFT_CHARACTERS
/SOFT_CHARACTERS /NOSOFT_CHARACTERS Specifies that the terminal is capable of loading a user-defined character set. The default is device-dependent.
/SPEED
/SPEED=(input-rate,output-rate)
Sets the baud rate at which the terminal receives and transmits
data. If the input and output rates are the same, specify
/SPEED=rate.
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 as follows:
50 150 1800 4800
75 300 2000 7200
110 600 2400 9600
134 1200 3600 19200
/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 /SWITCH=DECNET is a permanent characteristic; therefore, the /PERMANENT qualifier is not required.
/SYSPASSWORD
/SYSPASSWORD /NOSYSPASSWORD (default) Requires LOG_IO privilege. Determines whether the terminal requires that a system password be entered before the Username: prompt.
/TAB
/TAB /NOTAB Does not convert tab characters to multiple blanks. The /NOTAB qualifier expands all tab characters to blanks and assumes tab stops at 8-character intervals. The default is device dependent.
/TTSYNC
/TTSYNC (default) /NOTTSYNC Stops transmitting to the terminal when CTRL/S is pressed and resumes transmission when CTRL/Q is pressed.
/TYPE_AHEAD
/TYPE_AHEAD (default) /NOTYPE_AHEAD Accepts unsolicited input for the terminal to the limit of the type-ahead buffer. When you specify /NOTYPE_AHEAD, the terminal is dedicated, and accepts input only when a program or the system issues a read to the terminal. 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 Specifies a terminal type that is unknown to the system, which then uses the default terminal characteristics for unknown terminals.
/UPPERCASE
/UPPERCASE /NOUPPERCASE Translates lowercase to uppercase characters. The /UPPERCASE qualifier is equivalent to /NOLOWERCASE.
/WIDTH
/WIDTH=characters-per-line Specifies the maximum characters per line. This value must be an integer in the range 1 through 511. With /WRAP, the terminal generates a carriage return and line feed when the width specification is reached. 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. Specifies a terminal type that is unknown to the system, which then uses the default terminal settings.
/WRAP
/WRAP (default) /NOWRAP Generates a carriage return and line feed when the value of /WIDTH is reached.
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-1989:19:31:0.0
Sets the date/time at August 24, 1989, 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 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. By default, both yypes of verification are set or cleared with SET VERIFY or 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. If you specify only one keyword, 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 affect 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.