HP OpenVMS Systems Documentation

System managers are often responsible for setting up and managing peripheral devices such as terminals and printers. This chapter describes these tasks. For information about managing storage media such as disks and tapes, see Chapter 9.

Information Provided in This Chapter

This chapter describes the following tasks:

This chapter explains the following concepts:

On some systems, device names follow the format ddcu, where dd is the device code, c is the controller designation, and u is the unit number.

Local Digital Storage Architecture (DSA) devices use a controller letter of "A" regardless of the physical controller the device resides on. Preceding the letter "A":

• All local DSA disk devices are named DUAn, where n is a unique disk unit number.
• All local DSA tape devices are named MUAn, where n is a unique tape unit number.

Use of a single controller letter requires that the unit number for each local DSA device be unique. Duplicate unit numbers are possible if the local disks reside on different controllers.

If the system is part of an OpenVMS Cluster environment, device names are formatted in one of the following ways:

• If the device is attached to a single computer or hierarchical storage controller (HSC) subsystem, the device name includes the node name in the format node$ddcu, where node refers to the node name of the system that the device resides on.
• If the device is to be accessed (or dual-ported) by two computers or HSC subsystems, you must identify the device with a unique, path-independent name that includes an allocation class.
  The allocation class is a numeric value from 1 to 255, which is used to create a device name in the form $allocation-class$device-name. For example, the allocation class device name $11$DUA8 identifies a disk that is accessed by two computers or HSC subsystems, both having an allocation class of 11.
• If the device is connected to a SCSI bus and the system parameter DEVICE_NAMING is set to 1, you can assign the device a port allocation class, a number from 0 to 32767 inclusive.
• If the device is assigned port allocation class 0, its name will be in the form node $ddcuuu. The device cannot be located on a SCSI bus that is also attached to another CPU.
• If the device is assigned a nonzero port allocation class, its name will be in the form $allocation-class$ddAuuu. The device can be located on a SCSI bus attached to another CPU, provided the other CPU has assigned the same port allocation class to the SCSI bus.

For more information about the device name format in VAXcluster or OpenVMS Cluster environments, refer to OpenVMS Cluster Systems.

For information about the naming conventions for Fibre Channel disk and tape devices, see Guidelines for OpenVMS Cluster Configurations.

8.2 Getting Information About Devices on the System

Use the DCL command SHOW DEVICES to retrieve information about devices on your system.

When you invoke the SHOW DEVICES command and do not specify a device or use a qualifier, the system displays information about all recognized devices.

If you specify a device name with the SHOW DEVICE command, the system displays information about the device you specified. If you use certain qualifiers with SHOW DEVICES, information is displayed about those devices that currently have volumes mounted or that have been allocated to processes. Refer to the OpenVMS DCL Dictionary for a list of qualifiers that can be used with the SHOW DEVICES command.

The following examples use the SHOW DEVICES command. Device protection is RWPL (read, write, physical, logical).

The SHOW DEVICES/FULL examples include both volume protection and device protection. In addition, if a volume has a protected subsystem enabled, it also appears in the display.

Examples

1. The following command shows all devices on the system:

   $ SHOW DEVICES Device Device Error Volume Free Trans Mnt Name Status Count Label Blocks Count Cnt $11$DUA9: (SNAP) Online 0 $11$DUA10: (SNAP) Mounted 2 PAGE 83643 3 26 $11$DUA13: (SNAP) Mounted 0 WORK1 192297 36 26 $11$DUA23: (SNAP) Online 0 $11$DUA24: (SNAP) Mounted 0 MONITORPLUS 776808 86 26 DAD0: (TULIP) Online 0 DAD9: (TULIP) Online 0 DAD44: (TULIP) Mounted wrtlck 0 CDBIN06JUL23 97947 1 1 ROSE$MUA0: Online 0 LAVNDR$MUA0: Online 0 TULIP$MUA1: Online 0 IRIS$MUA1: HostUnavailable 0 OPA0: Online 0 DBA0: Offline 0 FTA0: Offline 0 FTA239: Online 0 LTA0: Offline 0 LTA3401: Online spooled 0 LTA3402: Online spooled 0 RTA0: Offline 0 RTA1: Mounted 1 RTA2: Mounted 0 RTB0: Offline 0 TXA0: Online 0 TXA1: Online 0 XT0: Offline 0

2. The following command requests a full listing of the status of the DAD42: RRD40 device. The device is located on node IRIS in an OpenVMS Cluster environment.

   $ SHOW DEVICES/FULL DAD42: Disk DAD42: (IRIS), device type RRD40, is online, mounted, software write- locked, file-oriented device, shareable, error logging is enabled. Error count 0 Operations completed 146 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWPL,O:RWPL,G:RWPL,W:RWPL Reference count 1 Default buffer size 512 Total blocks 1218000 Sectors per track 4 Total cylinders 50750 Tracks per cylinder 6 Allocation class 11 Volume label "CDBIN06JUL21" Relative volume number 0 Cluster size 3 Transaction count 1 Free blocks 15153 Maximum files allowed 152083 Extend quantity 5 Mount count 1 Mount status System Cache name "_$11$DUA21:XQPCACHE" Extent cache size 64 Maximum blocks in extent cache 1515 File ID cache size 64 Blocks currently in extent cache 0 Quota cache size 0 Maximum buffers in FCP cache 1330 Volume status: ODS-2, subject to mount verification, file high-water marking, write-through caching enabled.

3. The following command requests a full informational display about each DU device. This display shows only the first two devices: the mounted DUA8: device and the unmounted DUA9: device.

   $ SHOW DEVICES/FULL DU Disk $11$DUA8: (SNAP), device type RA90, is online, mounted, file-oriented device, shareable, served to cluster via MSCP Server, error logging is enabled. Error count 0 Operations completed 334 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWED,O:RWED,G:RWED,W:RWED Reference count 1 Default buffer size 512 Total blocks 2376153 Sectors per track 69 Total cylinders 2649 Tracks per cylinder 13 Host name "SNAP" Host type, avail HS70, yes Alternate host name "DRAGON" Alt. type, avail HS70, yes Allocation class 11 Volume label "DOCRES" Relative volume number 0 Cluster size 3 Transaction count 1 Free blocks 1211964 Maximum files allowed 297019 Extend quantity 5 Mount count 26 Mount status System Cache name "_$11$DUA21:XQPCACHE" Extent cache size 64 Maximum blocks in extent cache 121196 File ID cache size 64 Blocks currently in extent cache 0 Quota cache size 0 Maximum buffers in FCP cache 1330 Volume status: ODS-2, subject to mount verification, write-through caching enabled. Volume is also mounted on TANGO, WHOCRS, SIRE, BARKIN, SALT, SNEEZY, ARTIC, HEMMING, ROCKUP, HUTZPA, HAPPY, TOSIR, CHAIN, BOXER, SPELLN, WAYLND, ADAM, PINE, MONA, PALMER, WLDWND, ERICA, VALLEY. Disk $11$DUA9: (SNAP), device type RA90, is online, file-oriented device, shareable, served to cluster via MSCP Server, error logging is enabled. Error count 0 Operations completed 544 Owner process "" Owner UIC [SYSTEM] Owner process ID 00000000 Dev Prot S:RWED,O:RWED,G:RWED,W:RWED Reference count 0 Default buffer size 512 Total blocks 2376153 Sectors per track 69 Total cylinders 2649 Tracks per cylinder 13 Host name "SNAP" Host type, avail HS70, yes Alternate host name "DRAGON" Alt. type, avail HS70, yes Allocation class 11

If a volume was improperly dismounted, it may require rebuilding. Volumes are improperly dismounted when, for example, the system crashes. Use the /REBUILD_STATUS qualifier with the SHOW DEVICES command to determine if a volume needs rebuilding. Do not use the /REBUILD_STATUS qualifier with any other SHOW DEVICES qualifiers, except the /OUTPUT qualifier.

For each volume, SHOW DEVICES/REBUILD_STATUS returns one of the following values:

Do either of the following steps to rebuild a volume:

• Use SET VOLUME/REBUILD
• Dismount the volume and then mount the volume again using MOUNT/REBUILD

Device EMUL$DKB500, in the following example, needs rebuilding.

$ SHOW DEVICES/REBUILD_STATUS
Device Name             Rebuild needed?

ADU15$DKA300:           Information unavailable
EDIV$DKA300:            Information unavailable
EMUL$DKB200:            No
EMUL$DKB300:            No
EMUL$DKB500:            Yes
FTA0:                   Not applicable
OPA0:                   Not applicable

You can use the SHOW DEVICE command to retrieve information about ISO 9660-formatted devices. The following example illustrates the use of the SHOW DEVICES/FULL command to obtain information about an ISO 9660-formatted CD-ROM. Note that the ACP process name is given and that the volume status is listed as ISO 9660. The display tells the user that the mounted members of the volume set are relative volume numbers (RVN) 1, 64, and 65535.

$ SHOW DEVICE DKA1/FULL

Disk $1$DKA1: (VMSRMS), device type RRD40, is online, allocated,
    deallocate on dismount, mounted, software write-locked, file-oriented
    device, shareable, served to cluster via MSCP Server.

    Error count                    0    Operations completed                  9
    Owner process           "_FTA5:"    Owner UIC                    [FIN,USER]
    Owner process ID        20200066    Dev Prot            S:RWPL,O:RWPL,G:R,W
    Reference count                2    Default buffer size                 512
    Total blocks                 256    Sectors per track                    32
    Total cylinders                1    Tracks per cylinder                   8
    Allocation class               1

    Volume label          "VOLUME_1"    Relative volume number                1
    Cluster size                   0    Transaction count                     1
    Free blocks                    0    Maximum files allowed                 0
    Extend quantity                0    Mount count                           1
    Mount status             Process    ACP process name             "DKA1CACP"

  Volume status:  ISO 9660.
  Members of this volume set are $1$DKA1: (rvn 1), $1$DKA7: (rvn 64), $1$DKA16:
          (rvn 65535).

You can set security protection characteristics on devices using the following DCL commands:

• INITIALIZE
• MOUNT
• SET SECURITY/PROTECTION
• SET VOLUME

For more information about these commands, refer to the OpenVMS DCL Dictionary.

By default, allocating a tape or disk device requires VOLPRO privilege. However, you can grant access to unprivileged users in two ways:

• Set device protection to grant control access to group or world, as appropriate.
• Add an ACL to the device and grant a general identifier to all users who should have access.

Section 9.3.4 has more information about the VOLPRO privilege.

8.3.1 Granting Access to a Specific Device

To grant access to a specific device, use the SET SECURITY command as shown in either of the following examples:

$ SET SECURITY/CLASS=DEVICE DKA300/PROT=W:RWC

This example grants world read, write, and control access for the device DKA300.

$ SET SECURITY/CLASS=DEVICE DKA300/ACL=(IDENTIFIER=CHEKOV, ACCESS=CONTROL)

This example grants control access for the device DKA300 to users with the CHEKOV identifier.

8.3.2 Granting Access to All Devices

Use the following method to grant a specified class of users access to all devices:

1. Set the security template for a particular device type to allow access to a desired class of users. Use a command such as the following one, which sets the template for disk devices:

   $ SET SECURITY/CLASS=SECURITY_CLASS/PROFILE=TEMPLATE=DISK - _$ DEVICE/ACL=(ID=CHEKOV, ACCESS=R+W+D+C)

   
   This access will apply to all specified devices initialized in the future.
2. Run the following command procedure:

   SYS$EXAMPLES:RESET_DEVICE_PROTECTION.COM

   
   This command procedure applies the protection specified in the security template to all current devices.

The system uses a software component called a device driver to control I/O operations for a particular device type. For a device to function on a system, the device must be connected, and the device driver must be loaded into memory.

The AUTOCONFIGURE command connects all devices physically attached to the system and loads their device drivers. Using AUTOCONFIGURE saves effort and reduces the possibility of error.

The site-independent startup command procedure, STARTUP.COM, automatically configures devices, because it includes the AUTOCONFIGURE command.

On VAX systems, the following commands in STARTUP.COM perform autoconfiguration:

$ SYSGEN := $SYSGEN
$ SYSGEN AUTOCONFIGURE ALL

On Alpha systems, the following commands in STARTUP.COM perform autoconfiguration:

$ SYSMAN := $SYSMAN
$ SYSMAN IO AUTOCONFIGURE

During autoconfiguration, the CONFIGURE phase of STARTUP.COM creates a detached process to perform the following tasks:

• Detect any devices connected to HSx devices (storage controllers)
• Load the drivers for HSx devices
• Make the HSx devices known to the system
• Make disk and tape devices served by OpenVMS hosts known to the system

In general, when you add a SCSI disk or tape, you should shut down the system and power down the machine before you connect the device. When you power the system up, OpenVMS automatically configures the device.

Some controllers, such as the HSZ series, allow you to quiesce the SCSI bus and then add or remove a device. When you add a device, you must rerun AUTOCONFIGURE. Note however, that for served storage devices, your system must be running the CONFIGURE process.

In certain cases, you might want to suppress autoconfiguration of devices in system startup. See the following sections for more details.

On VAX systems, whenever possible, use the SYSGEN command AUTOCONFIGURE to connect standard devices and load device drivers. However, in some cases, such as connecting non-Compaq devices, you cannot use the AUTOCONFIGURE command. In addition, AUTOCONFIGURE does not connect the following devices or load their device drivers:

• Console storage device
• Network communications logical device
• Virtual terminals

In addition to these devices, other devices and drivers might be present that AUTOCONFIGURE does not connect and load. On VAX systems, use the System Generation utility (SYSGEN) to manually connect devices and load device drivers.

For more information, refer to the SYSGEN section of the OpenVMS System Management Utilities Reference Manual and the OpenVMS VAX Device Support Manual. (These manuals have been archived but are available on the OpenVMS Documentation CD-ROM.)

To manually connect special devices each time the system starts up, add these SYSGEN commands to the site-specific startup command procedure SYCONFIG.COM. For more information, see Section 5.2.4.1.

Console Storage Device

To connect the console storage device on VAX systems, use the following CONNECT command:

$ RUN SYS$SYSTEM:SYSGEN
SYSGEN> CONNECT CONSOLE
SYSGEN> EXIT

Network Communication Device

To connect the network communications logical device on VAX systems, run the appropriate startup files for the particular network protocol. For example, three common net stack startups are:

Virtual Terminals

For information about connecting virtual terminals and loading their driver, see Section 8.6.2.

For information about configuring virtual terminals in conjunction with TCP/IP Services Telnet, see Compaq TCP/IP Services for OpenVMS Management.

Event-Handling Device Driver

A Compaq-supplied driver named SYS$SYSTEM:CONINTERR.EXE permits real-time processes to connect to interrupt vectors for quick response to and special handling of real-time events. The driver is not associated with any specific device type. Refer to the OpenVMS VAX Device Support Manual for more information. (This manual has been archived but is available on the OpenVMS Documentation CD-ROM.)

Example

The commands in the following example autoconfigure the devices attached to a VAX system, and connect the console block storage device and the network software device:

$ RUN SYS$SYSTEM:SYSGEN
SYSGEN> AUTOCONFIGURE ALL
SYSGEN> CONNECT CONSOLE
SYSGEN> EXIT
$ @SYS$MANAGER:STARTNET