Updated: 11 December 1998

OpenVMS DCL Dictionary

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.

/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.

/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.

/SET=(n[,...])

Sets all user capabilities defined by the position values n specified by the /CAPABILITY qualifier.

Examples

$ SET CPU/CAPABILITY/GLOBAL/SET=(2,4)
 
      

This command sets user capabilities 2 and 4 in the global cell SCH$GL_DEFAULT_CPU_CAP.

$ 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.

$ 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.

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

$ 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.

$ 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.

Format

SET DEFAULT [device-name[:]][directory-spec]

Parameters

device-name[:]

Specifies the name of the device you want to go to.

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

$ SET DEFAULT [CARPENTER]
      

The SET DEFAULT command in this example changes the default directory to [CARPENTER]. The default disk device does not change.

$ SET DEFAULT $FLOPPY1:[WATER.MEMOS]
      

The SET DEFAULT command in this example sets your default to the WATER.MEMOS subdirectory on $FLOPPY1.

$ SET DEFAULT $FLOPPY1:
      

The SET DEFAULT command in this example sets the default device to $FLOPPY1. The directory name does not change.

$ 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:[WATER.MEMOS], this command sets your default to $FLOPPY1:[WATER]. If you are in $FLOPPY1:[WATER], this command sets your default to the master directory on the disk---$FLOPPY1:[000000].

$ SAVEDEF = F$ENVIRONMENT("DEFAULT")
$ SET DEFAULT [122001.JONES.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.JONES.APP10. Later, the symbol SAVEDEF is used to restore the original default directory.

$ 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.

$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.

$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.

Establishes a print device or terminal as a spooled device or establishes the operational status for a device.

Requires OPER (operator) privilege.

Format

SET DEVICE device-name[:]

Parameter

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 you want to change the spooling status; the device must be a disk or magnetic tape if you want to change the operational status.

Description

When you specify the /SPOOLED qualifier, program output that uses OpenVMS Record Management Services (RMS) or file control system (FCS) and that specifies the print device name is written onto an intermediate disk rather than written directly to the print device or terminal.

When you specify any of the following qualifiers, the operational status of the drive is changed: /AVAILABLE, /DUAL_PORT, /ENABLE, /ERROR_LOGGING, /POLL, or /SWITCH.

Qualifiers

/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 the /NOAVAILABLE qualifier, any attempt to allocate or mount the specified disk or magnetic tape is prevented. Devices are automatically set /AVAILABLE when brought online even if the device had been previously set /NOAVAILABLE.

/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.

/ENABLE

/NOENABLE

Enables or disables a path to a multipath device; the affected path is the one named in the /PATH qualifier. All paths are initially enabled; the current path cannot be disabled.

/ERROR_LOGGING

/NOERROR_LOGGING

Controls whether device errors are logged in the error log file. When you specify the /ERROR_LOGGING qualifier, all error messages reported by the device on which error logging is enabled are recorded in the error log file. Use the SHOW DEVICE/FULL command to find out the current status.

/LOG

/NOLOG (default)

Controls whether log information is displayed at the terminal.

/PATH="path-description-string"

Specifies a particular route to the device. The path description string identifies a path from the host to the device (for example, "PKA0.2343-A855-BC99-876F" or "PKC0.5"). Wildcard characters have no special meaning. The path description may be abbreviated to the minimum unique string. Note that this qualifier applies only to multipath devices.

/POLL

/NOPOLL

Specifies that the path specified by the /PATH qualifier is to be polled for continued availability as a path switch destination. This does not affect any attempt to switch to this path. Its purpose is only to inform an operator that a path may or may not be viable as a path switch destination. By default, all device paths are enabled for polling when they are discovered. Note that this qualifier applies only to multipath devices.

/PREFERRED_CPUS=cpu-a[,cpu-b,cpu-c,...]

/NOPREFERRED_CPUS

Allows you to specify a CPU or a set of candidate CPUs from which the operating system chooses the CPU to assign to the Fast Path port. The chosen CPU is called the preferred CPU for this Fast Path port. The Fast Path port's interrupt I/O completion processing and I/O initiation processing are performed on this preferred CPU.

In addition to selecting the preferred CPU, the User Preferred CPU is set for this port. Setting the User Preferred CPU prevents the port from being reassigned to another CPU unless the User preferred CPU is being stopped. The qualifier can be negated. When the /NOPREFERRED_CPUS qualifier is specified, the User Preferred CPU is cleared for the port, but it remains a Fast Path port, and the current preferred CPU is not changed.

If both /PREFERRED_CPUS and /NOPREFERRED_CPUS are specified on the same command line, /NOPREFERRED_CPUS is ignored.

If Fast Path is enabled, you can use the DCL command, SHOW DEVICES/FULL, to display the current preferred CPU and the User Preferred CPU.

For more information about using Fast Path features to improve I/O performance, refer to the OpenVMS I/O User's Reference Manual.

/SPOOLED[=(queue-name[:],intermediate-disk-name[:])]

/NOSPOOLED

Controls whether files are 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.

/SWITCH

Attempts to switch from the current path of a multipath device to the path named in the /PATH qualifier. The path switch is attempted only if the path has not been disabled by SET DEVICE/NOENABLE. The path switch is initiated but not completed before returning control to the user; use SHOW DEVICE/MULTIPATH to verify that the path switching has completed successfully.

Examples

$ SET DEVICE/SPOOLED=(LPA0)  LPA0:
      

In this example, 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.

$ SET DEVICE/ERROR_LOGGING  DBB2:
      

The SET DEVICE command in this example requests that all device errors reported on device DBB2 be logged in the error log file.

$ SET DEVICE/NOAVAILABLE DRA0:
      

The SET DEVICE command in this example prevents any attempt to mount a disk on device DRA0.

$ SET DEVICE/DUAL_PORT DRA0:
      

The SET DEVICE command in this example enables the dual port seize logic in device DRA0.

$ SET DEVICE/PREFERRED_CPU=1 PNA0
      

The Fast Path port PNA0 is assigned to CPU 1, and the User Preferred CPU is set to 1.

$ SET DEVICE/NOPREFERRED_CPU  PNA0
      

The port PNA0 will have the User Preferred CPU cleared, but will remain a Fast Path port, with CPU 1 as its current preferred CPU.

$ SET DEVICE/PREFERRED_CPU=(0,1,2)  PNA0
      

The operating system selects CPU 0,1, or 2 as the preferred CPU for Fast Path port PNA0, and sets its User Preferred CPU to the selected CPU.

$ SET DEVICE $10$DKA1001:/PATH="PGB0.0123-4567-89AB-CDEF"/ENABLE
      

In this example, a request is made to enable path "PGB0.0123-4567-89AB-CDEF" as a switch path destination. No error is indicated if the path was in the enabled state prior to the request. Had the /NOENABLE option been used, the path would have been removed from switch path consideration.

$ SET DEVICE $10$DKA1001:/PATH="PGB0.0123-4567-89AB-CDEF"/POLL
      

In this example, a request is made to enable path "PGB0.0123-4567-89AB-CDEF" for polling of its continued availability as a path switch destination. Had the /NOPOLL option been used, the path would have been removed from path availability polling consideration.

$ SET DEVICE $10$DKA1001:/PATH="PGB0.0123-4567-89AB-CDEF"/SWITCH
      

In this example, a request is made to switch from the current path to path "PGB0.0123-4567-89AB-CDEF". Should the path fail, the switch algorithm of the unspecified path is used.

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

9996PRO_048.HTML