HP OpenVMS DCL Dictionary
HP OpenVMS DCL Dictionary
SET CONTROL
Enables or disables the Ctrl/Y or the Ctrl/T function. Pressing Ctrl/Y
interrupts a command and returns you to the DCL command level. Pressing
Ctrl/T momentarily interrupts a command to print a line of statistics.
SET CONTROL=T requires that SET TERMINAL/BROADCAST be set for
the information to be displayed at your terminal.
Format
SET CONTROL [=(T,Y)]
SET NOCONTROL [=(T,Y)]
Parameter
(T,Y)
Specifies that T (Ctrl/T) or Y (Ctrl/Y) be enabled or disabled. If you
specify only one character, you can omit the parentheses. If you do not
specify either T or Y, Y is the default.
Description
The Ctrl/Y function provides a general-purpose escape from the current
operation. The Ctrl/Y function can generally be used during an
interactive terminal session to interrupt the current command, command
procedure, or program image.
The SET NOCONTROL=Y command can be used for special application
programs. When the SET NOCONTROL=Y command is executed in a
system-specified command procedure for a particular user at login, that
user can communicate only with the application program that controls
the terminal.
When you press Ctrl/Y and SET NOCONTROL=Y is in effect, the INTERRUPT
message is displayed, but no interruption takes place.1
SET NOCONTROL=Y also disables the Ctrl/C cancel function for all
commands and programs that do not have special action routines
responding to the Ctrl/C function.
The Ctrl/T function displays a single line of statistical information
about the current process. When you press Ctrl/T during an interactive
terminal session, it momentarily interrupts the current command,
command procedure, or image to display statistics. The statistical
information includes the node and user names, the current time, the
current process, CPU usage, number of page faults, level of I/O
activity, and memory usage. For example:
BOSTON::SMITH 16:21:04 EDT CPU=00:00:03.33 PF=778 IO=296 MEM=277
|
When SET NOCONTROL=T (the default) is in effect, pressing Ctrl/T does
not cause any statistics to be displayed.
Examples
The SET CONTROL command in this example disables the Ctrl/Y function as
well as most Ctrl/C functions.
The SET CONTROL command in this example enables the Ctrl/T function.
The SET CONTROL command in this example disables both the Ctrl/T and
Ctrl/Y functions.
| #4 |
$ []Ctrl/T
NODE22::SMITH 16:21:04 (DCL) CPU=00:03:29.39 PF=14802 IO=18652 MEM=68
$ SET NOCONTROL=T
$ []Ctrl/T
|
As shown in this example, when you press Ctrl/T, the system displays
the appropriate information. The SET NOCONTROL=T command disables the
Ctrl/T function. Now when you press Ctrl/T, no information is displayed.
Note
1 Note that DCL maintains a pending
Ctrl/Y asynchronous system trap (AST) to the terminal driver. This
affects captive command procedures when using the SET HOST command. For
more information, see the description of the SET HOST command.
|
Changes the user capabilities associated with the specified CPUs.
Requires ALTPRI and WORLD privileges.
Format
SET CPU cpu-id[,...]
Parameter
cpu-id
Specifies a decimal value representing the identity of a processor in
an OpenVMS multiprocessing system. On a VAX 6000 system or an Alpha
7000 system, the CPU is the backplane slot number of the processor.
Qualifiers
/ALL
Applies the specified operation to all CPUs in the active set.
/ASSIGN [=option] (Alpha only)
Assigns the CPU to the current instance if no option is specified.
If an option is specified, the CPU is assigned to that resource.
| Option |
Description |
|
$$PARTITION
|
The current soft partition of the OpenVMS instance.
|
|
$$HARD_PARTITION
|
The hard partition of the OpenVMS instance.
|
Supported only on AlphaServer systems that support partitioning.
/AUTO_START (Alpha only)
/NOAUTO_START
Sets or clears the instance-specific autostart flag for the specified
CPUs.
When autostart is enabled, that CPU will join the OpenVMS active set
when it is assigned or migrated into the partition. The CPU will also
autostart if a power-up transition is completed while the CPU is owned
by the issuing instance.
Supported only on AlphaServer systems that support partitioning.
/CAPABILITY
/NOCAPABILITY
Allows bits in the process user capability mask to be set or cleared
individually, in groups, or all at once.
Note
The SET CPU/[NO]CAPABILITY command will fail if there is an active
process that requires a capability that is not available on any
remaining active CPU.
|
Specifying the /CAPABILITY qualifier has no direct effect, but merely
indicates the target of the operations specified by the following
secondary qualifiers:
|
/SET=(
n[,...])
|
Sets all user capabilities defined by the position values
n, where
n has the range of 1 to 16.
|
|
/CLEAR=(
n[,...])
|
Clears all user capabilities defined by the position values
n, where
n has the range of 1 to 16.
|
The secondary qualifiers can all be used at once as long as the user
capability bits defined in the /SET and /CLEAR parameters do not
overlap.
The /NOCAPABILITY qualifier clears all user capability bits.
/CLEAR=(n[,...])
Clears all user capabilities defined by the position values n
specified by the /CAPABILITY qualifier.
/FAILOVER=option (Alpha only)
/NOFAILOVER
Establishes instance-specific failover relationships for each CPU in
the instance's potential set.
When the instance crashes, CPUs with a failover target other than the
current instance will be assigned or migrated to that target.
Specifying the /FAILOVER qualifier has no direct effect; however, it
indicates the target of the operations specified by the following
options:
| Option |
Description |
|
instance_name
|
The name of any valid running instance in the current hard partition.
|
|
partitionID
|
The numeric ID of any partition (reflected in the configuration tree)
in the current hard partition. An operating system instance is not
required to be running with this identifier.
|
|
$$PARTITION
|
Assigns a resource to the current partition of the current instance.
|
|
$$HARD_PARTITION
|
Assigns a resource to the hard partition node of the configuration
tree. This makes the CPU available to multiple soft partitions below it.
|
The /FAILOVER qualifier generates a resource assignment only when the
current instance crashes.
Supported only on AlphaServer systems that support partitioning. 99
/GLOBAL
Modifies the global cell SCH$GL_DEFAULT_CPU_CAP. This global cell is
used to initialize the user capability mask of CPUs that are brought
into the active set for the first time.
/MIGRATE=option (Alpha only)
Transfers ownership of the CPU from the current instance to another
soft partition.
| Option |
Description |
|
instance_name
|
The name of any valid running instance in the current hard partition.
|
|
partitionID
|
The numeric ID of any partition (reflected in the configuration tree)
in the current hard partition. An operating system instance is not
required to be running with this identifier.
|
Supported only on AlphaServer systems that support partitioning.
/POWER=option (Alpha only)
Turns the power on or off in one or more CPU slots. Valid options are
ON and OFF.
Supported only on AlphaServer GS series systems.
/OVERRIDE_CHECKS (Alpha only)
Directs the SET/CPU command to bypass a series of checks that determine
whether the specified processor is eligible for removal from the active
set.
/REFRESH (Alpha only)
Examines and updates the OpenVMS context for the specified CPU or CPUs,
using the hardware configuration tree.
/SET=(n[,...])
Sets all user capabilities defined by the position values n
specified by the /CAPABILITY qualifier.
/START (Alpha only)
Initiates a request for the specified CPU to join the OpenVMS active
set if it is not already there.
Examples
| #1 |
$ SET CPU/CAPABILITY/GLOBAL/SET=(2,4)
|
This command sets user capabilities 2 and 4 in the global cell
SCH$GL_DEFAULT_CPU_CAP.
| #2 |
$ SET CPU/CAPABILITY/GLOBAL/SET=(2,4) 0
|
This command sets user capabilities 2 and 4 in the global cell
SCH$GL_DEFAULT_CPU_CAP, as well in the active CPU 0.
| #3 |
$ SET CPU/CAPABILITY/SET=(1,2) 0
$ SHOW CPU/FULL
PIPERI, a DEC 3000 Model 500
Multiprocessing is ENABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 1
System Page Size = 8192
System Revision Code =
System Serial Number =
Default CPU Capabilities:
System: QUORUM RUN
Default Process Capabilities:
System: QUORUM RUN
PRIMARY CPU = 00
CPU 00 is in RUN state
Current Process: VMSADU PID = 00000094
Serial Number:
Revision: F001
VAX floating point operations supported.
IEEE floating point operations and data types supported.
PALCODE: Revision Code = 5.48-01
PALcode Compatibility = 0
Maximum Shared Processors = 0
Memory Space: Physical address = 00000000 00054000
Length = 81920
Scratch Space: Physical address = 00000000 00104000
Length = 8192
Capabilities of this CPU:
System: PRIMARY QUORUM RUN
User bitmask: 00000003
Processes which can only execute on this CPU:
NETACP PID = 0000008F Reason: PRIMARY Capability
$ SET CPU/CAPABILITY/CLEAR=1 0
$ SHOW CPU/FULL
PIPERI, a DEC 3000 Model 500
Multiprocessing is ENABLED. Full checking synchronization image loaded.
Minimum multiprocessing revision levels: CPU = 1
System Page Size = 8192
System Revision Code =
System Serial Number =
Default CPU Capabilities:
System: QUORUM RUN
Default Process Capabilities:
System: QUORUM RUN
PRIMARY CPU = 00
CPU 00 is in RUN state
Current Process: VMSADU PID = 00000094
Serial Number:
Revision: F001
VAX floating point operations supported.
IEEE floating point operations and data types supported.
PALCODE: Revision Code = 5.48-01
PALcode Compatibility = 0
Maximum Shared Processors = 0
Memory Space: Physical address = 00000000 00054000
Length = 81920
Scratch Space: Physical address = 00000000 00104000
Length = 8192
Capabilities of this CPU:
System: PRIMARY QUORUM RUN
User bitmask: 00000002
Processes which can only execute on this CPU:
NETACP PID = 0000008F Reason: PRIMARY Capability
|
In this example, the first SET CPU command sets user capabilities 1 and
2 for CPU 0. The second SET CPU command clears capability 1.
This command updates the OpenVMS context in this instance for all CPUs
physically residing in the current hard partition.
| #5 |
$ SET CPU/FAILOVER=WFGLXA 12
|
This command sets CPU 12 to failover to another instance (WFGLXA), if
the current instance crashes.
| #6 |
$ SET CPU/FAILOVER=$$HARD 13
|
This command assigns CPU 13 to hard partition ownership if the current
instance crashes. Assignment to the hard partition makes the CPU
visible and available to other instances for assignment.
| #7 |
$ SET CPU/ASSIGN=$$HARD 14
|
This command assigns CPU 14, currently owned by the instance, to hard
partition ownership. Assignment to the hard partition makes the CPU
visible and available to other instances for assignment.
This command assigns CPU 15, currently owned by the hard partition, to
this instance. If the CPU is powered, in the potential set, and
autostart enabled, then it will automatically join the active set.
SET DAY
Sets the default day type specified in the user authorization file
(UAF) for the current day.
Requires OPER (operator) privilege.
Format
SET DAY
Parameters
None.
Description
The SET DAY command overrides the default primary and secondary day
types that are used to control daily logins. These default day types
are defined by the system manager in the user authorization file (UAF).
The SET DAY command is useful when you need to override the day type
because of a change in the work days of a particular week. For example,
Monday, which is normally a work day, is occasionally a holiday. You
can use the SET DAY command to override the normal day type for Monday
and set it to a different day type.
Qualifiers
/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
/NOLOG (default)
Controls whether log information is displayed at the terminal to
confirm that the new SET DAY information has been set.
/PRIMARY
Sets today until midnight to a primary day.
/SECONDARY
Sets today until midnight to a secondary day.
Examples
The SET DAY command in this example overrides the current default day
type and sets today until midnight to a primary day.
The SET DAY command in this example overrides the previous SET DAY
command and sets today's day type to the UAF-defined default.
SET 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]
Parameters
device-name[:]
Specifies the name of the device you want to go to.
Note
The SET DEFAULT command will accept a node name with the device name
(that is, node-name::device-name). However, the results of operations
using a default with a node name are unpredictable. Some utilities and
applications do not allow a node name to be specified in a file
specification and will fail if the default file specification contains
a node name.
|
directory-spec
Specifies 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.
On Alpha systems, if the length of the resulting default directory
specification exceeds 255 characters, the SET DEFAULT attempts to
replace the default directory string with a generated directory
specification. If this happens, then in addition to the normal syntax
check, the entire path to that specification, including the device, is
verified and must exist for the call to succeed.
On Alpha systems, if the process parse style is set to extended, then
the directory specification may include a directory ID (DID).
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 OpenVMS Record Management Services (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 [TANNER]
|
The SET DEFAULT command in this example changes the default directory
to [TANNER]. The default disk device does not change.
| #2 |
$ SET DEFAULT $FLOPPY1:[MOREAU.MEMOS]
|
The SET DEFAULT command in this example sets your default to the
MOREAU.MEMOS subdirectory on $FLOPPY1.
| #3 |
$ SET DEFAULT $FLOPPY1:
|
The SET DEFAULT command in this example sets the default device to
$FLOPPY1. The directory name does not change.
The SET DEFAULT command in this example changes the default directory
to the parent directory of the one you are currently in. For example,
if the current directory is $FLOPPY1:[NIELSEN.MEMOS], this command sets
your default to $FLOPPY1:[NIELSEN]. If you are in $FLOPPY1:[NIELSEN],
this command sets your default to the master directory on the
disk---$FLOPPY1:[000000].
| #5 |
$ SAVEDEF = F$ENVIRONMENT("DEFAULT")
$ SET DEFAULT [122001.ZAMORA.APP10]
.
.
.
$ SET DEFAULT 'SAVEDEF'
|
The command procedure in this example uses the F$ENVIRONMENT lexical
function to save the current default directory in the symbol named
SAVEDEF. The SET DEFAULT command changes the default directory
122001.ZAMORA.APP10. Later, the symbol SAVEDEF is used to restore the
original default directory.
| #6 |
$ SHOW DEFAULT
WORK:[TOP]
$ DEFINE X WORK:[TOP.SUB1],WORK:[TOP.SUB2]
$ SET DEFAULT X
$ SHOW DEFAULT
X:[TOP]
= WORK:[TOP.SUB1]
= WORK:[TOP.SUB2]
$ DIRECTORY
Directory WORK:[TOP.SUB1]
KUDOS.TMP;1
Total of 1 file.
Directory WORK:[TOP.SUB2]
KUDOS.TMP;1
Total of 1 file.
Grand total of 2 directories, 2 files.
$ DIRECTORY []
Directory WORK:[TOP]
KUDOS.TMP;1 NETSERVER.LOG;2
Total of 2 files.
|
In this example, the default directory is WORK:[TOP]. X is then defined
to be a search list consisting of two subdirectories. When the SET
DEFAULT X command is entered, the search list (X) is equated with the
logical name SYS$DISK and is entered into the disk field. The
subsequent SHOW DEFAULT command shows both the search list and the
current default directory, followed by the expanded search list.
If a DIRECTORY command is entered, the directories searched are those
contained in the logical name X; however, if the current default
directory specification ([]) is explicitly entered, the current default
directory, rather than SYS$DISK, is searched.
| #7 |
$SET PROCESS/PARSE_STYLE=EXTENDED
$SET DEFAULT WORK:[11,1,0]
$SHOW DEFAULT
WORK:[11,1,0]
$DIRECTORY
Directory WORK:[11,1,0]
X.X;1
Total of 1 file.
|
On Alpha systems, the SET DEFAULT command in this example uses a
directory ID (DID) in the directory specification.
| #8 |
$SET PROCESS/PARSE_STYLE=EXTENDED
$SET DEFAULT -
WORK:[.LONG_DIRECTORY_NAME_AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA]
$SET DEFAULT -
WORK:[.LONG_SUBDIRECTORY_NAME_BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB]
$SET DEFAULT -
WORK:[.LONG_SUBDIRECTORY_NAME_CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC]
$SET DEFAULT -
WORK:[.LONG_SUBDIRECTORY_NAME_DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD]
$SET DEFAULT -
WORK:[.LONG_SUBDIRECTORY_NAME_EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE]
$SHOW DEFAULT
MDA0:[15,1,0]
$SET DEFAULT [-]
%RMS-F-DIR, error in directory name
$SET DEFAULT [.TEST]
$SHOW DEFAULT
MDA0:[15,1,0.TEST]
|
On Alpha systems, because the total length of the default directory
string would exceed 255 characters in this example, a Directory ID is
used in the directory specification. When the default directory string
is replaced with a Directory ID, it is not possible to use the minus
sign to specify the next higher directory.
|
