|
HP OpenVMS Systems Documentation |
|
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. FormatSET CONTROL [=(T,Y)] Parameter
DescriptionThe 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.
|
| #1 |
|---|
$ SET NOCONTROL=Y
|
The SET CONTROL command in this example disables the Ctrl/Y function as well as most Ctrl/C functions.
| #2 |
|---|
$ SET CONTROL=T
|
The SET CONTROL command in this example enables the Ctrl/T function.
| #3 |
|---|
$ SET NOCONTROL=(T,Y)
|
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.
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.
SET CPU cpu-id[,...]
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.
/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.
| #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.
| #4 |
|---|
$ SET CPU/REFRESH/ALL
|
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.
| #8 |
|---|
$ SET CPU/ASSIGN 15
|
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.
Sets the default day type specified in the user authorization file (UAF) for the current day.Requires OPER (operator) privilege.
SET DAY
None.
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.
/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.
| #1 |
|---|
$ SET DAY/PRIMARY
|
The SET DAY command in this example overrides the current default day type and sets today until midnight to a primary day.
| #2 |
|---|
$ SET DAY/DEFAULT
|
The SET DAY command in this example overrides the previous SET DAY command and sets today's day type to the UAF-defined 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.
SET DEFAULT [device-name[:]][directory-spec]
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.
| #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.
| #4 |
|---|
$ SET DEFAULT [-]
|
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.
| Previous | Next | Contents | Index |