[Digital logo]
[HR]

OpenVMS System Manager's Manual


Previous | Contents

For more detailed information about the SET TERMINAL command and its qualifiers, see the OpenVMS DCL Dictionary.

7.5.1.1 Setting Default Characteristics with System Parameters

To change the default terminal characteristics for all terminals on a node, you can specify values for the system parameters TTY_DEFCHAR and TTY_DEFCHAR2. For more information on these parameters, see the OpenVMS System Management Utilities Reference Manual. For more information on setting system parameters, see Section 14.5.

7.5.1.2 Setting Characteristics in System Startup

To execute SET TERMINAL commands each time your system boots, add these commands to a site-specific startup command procedure. If your configuration is simple, you can add the commands to SYSTARTUP_VMS.COM. If your configuration requires a large number of commands, create a separate command procedure (for example, TERM_SETUP.COM) and execute it from the SYSTARTUP_VMS.COM. When the device setup command procedure finishes executing, control returns to SYSTARTUP_VMS.COM.


Caution

Digital recommends you limit the number of SET TERMINAL commands you include in startup command procedures. Large numbers (for example, hundreds) of SET TERMINAL commands can significantly slow down system startup. If you have a large number of terminals, change the default characteristics using the system parameters TTY_DEFCHAR and TTY_DEFCHAR2 as explained in Section 7.5.1.1.

You may want to include comments to provide the names of terminal owners, as shown in the following example.

Example

The following example provides sample commands you could include in your startup procedure to set up terminal devices:

$ SET TERMINAL TTC2:/SPEED=300/DEVICE_TYPE=LA36/PERMANENT  !JONES 
$ SET TERMINAL TTD1:/SPEED=9600/PERMANENT                  !WRENS 
$ SET TERMINAL TTD4:/SPEED=1200/PERMANENT                  !JRSMITH 
$ SET TERMINAL TTG4:/SPEED=1200/MODEM/PERMANENT            !DIALUP1 

7.5.2 Managing Virtual Terminals

Virtual terminals allow users to disconnect from a physical terminal without terminating a process; the process remains active on a virtual terminal. Virtual terminals are used for the following purposes:

Enabling Virtual Terminals

On VAX systems, you set up virtual terminals by entering the following commands:

$ RUN SYS$SYSTEM:SYSGEN
SYSGEN> CONNECT VTA0/NOADAPTER/DRIVER=TTDRIVER
SYSGEN> EXIT 
 
 

On Alpha systems, you set up virtual terminals by entering the following commands:

$ RUN SYS$SYSTEM:SYSMAN
 
SYSMAN> IO CONNECT VTA0/NOADAPTER/DRIVER=SYS$TTDRIVER
 
SYSMAN> EXIT 
 
 

Virtual terminals are identified by the VTAn: device name. After the SYSGEN or IOGEN command is entered, any terminal with the TT2$M_DISCONNECT characteristic set prior to login is treated as a virtual terminal.


Note

LAT terminals (LTAn:) can be disconnected if the TT2$M_DISCONNECT characteristic is set, but remote terminals (RTAn:) cannot be disconnected.

You can set the TT2$M_DISCONNECT characteristic in one of two ways:

Controlling the Use of Virtual Terminals

You can control the use of virtual terminal sessions in the following ways:

7.5.2.1 Using Virtual Terminals for Dynamic Asynchronous DECnet for OpenVMS (VAX Only)

Virtual terminals are required for dynamic asynchronous DECnet communication. A dynamic asynchronous line differs from a static asynchronous line or other DECnet line in that it is normally switched on for network use only for the duration of a dialup connection between two nodes. Dynamic switching of terminal lines to asynchronous DDCMP lines can occur if the following requirements are met:

See the DECnet-Plus for OpenVMS Applications Installation and Advanced Configuration for a detailed description of the procedure for setting up dynamic asynchronous DECnet lines.

7.5.2.2 Determining the Physical Terminal Type of a Virtual Terminal

You can determine the physical terminal type associated with a virtual terminal. Because both direct connect and LAT lines can be virtual, you might not know the terminal characteristics of a LAT terminal at system startup time. You can set the characteristics of direct connect lines at system startup; however, you must enter a SET TERMINAL/INQUIRE command to determine the characteristics of a LAT line. (See Section 24.1 for more information on LAT software.)


Note

Using the command SET TERMINAL/INQUIRE clears the type-ahead buffer.

The following command procedure determines the physical terminal characteristics of both direct and LAT lines at system startup. Insert the following lines in your systemwide login procedure (SYLOGIN.COM). (This procedure assumes that your startup procedure has set all switches and LAT lines to "unknown.")

$ DEVCLASS = 'F$GETDVI ("SYS$COMMAND","DEVCLASS")' 
$ IF DEVCLASS .ne. 66 then goto alldone   !Not a terminal 
$ DEVTYPE = 'F$GETDVI ("SYS$COMMAND","DEVTYPE")' 
$ IF DEVTYPE .ne. 0 then goto got_devtype 
$ SET TERMINAL/INQUIRE   !Try to determine the device type 
$ DEVTYPE = 'F$GETDVI ("SYS$COMMAND","DEVTYPE")' 
$ got_devtype: 
$! Can now dispatch on 'devtype' to do different things depending 
$! on the type of terminal. 
$ alldone: 

You can uniquely identify a LAT terminal by using the F$GETDVI lexical function and specifying the item TT_ACCPORNAM. The function returns the terminal server node name and port name.

7.6 Managing Printers

To manage printers attached to your system, perform the following tasks:
Task For More Information
Set printer characteristics Section 7.6.1
Spool printers Section 7.6.2.1
Despool printers Section 7.6.2.2
Test spooling of printers Section 7.6.2.3

7.6.1 Setting Printer Characteristics

Printer characteristics must be set prior to starting queues for the printers. The DCL command SET PRINTER establishes characteristics for a line printer. The DCL command SET TERMINAL sets characteristics for a printer connected to a terminal or LAT port.

In addition, if you want to spool your printers, you must do so before starting the queues to be associated with those printers. For information about spooled printers, see Section 7.6.2.

To execute these commands each time your system boots, add these commands to your site-specific startup command procedure. If your configuration is simple, you can add the commands to SYSTARTUP_VMS.COM. If your configuration requires a large number of commands, create a separate command procedure (for example, PRINTER_SETUP.COM) and execute it from SYSTARTUP_VMS.COM. When the device setup command procedure finishes executing, control returns to SYSTARTUP_VMS.COM.

Example

The following example provides sample commands you could include in your startup procedure to set device characteristics for printers. This example also includes the commands used to spool printers. You generally include the commands to spool printers along with the commands to set device characteristics.

$! Set up line printer devices                  
$! 
$ SET PRINTER/PAGE=60/LOWERCASE/TRUNCATE LPA0: 
$ SET PRINTER/LA11/UPPERCASE/WRAP LPB0: 
$ SET DEVICE/SPOOLED=(LINE_PRINT,SYS$SYSDEVICE) LPA0: 
$ SET DEVICE/SPOOLED=(SYS$PRINT,SYS$SYSDEVICE) LPB0: 
$! 
$! Set up LAT printers 
$! 
$ SET TERMINAL LTA331:/SPEED=9600/DEVICE=LN03 - 
  /NOBROADCAST/NOECHO/HARDCOPY/NOTYPE_AHEAD/PERMANENT 
$ SET DEVICE LTA331:/SPOOLED=(MKTG$LN03_1,SYS$SYSDEVICE) 
$! 
$ SET TERMINAL LTA332:/DEVICE=LA210/PAGE=66  - 
  /NOBROADCAST/PERMANENT 
$ SET DEVICE LTA332:/SPOOLED=(LA210$PRINT,SYS$SYSDEVICE) 

7.6.2 Using Spooled Printers

Certain application programs print output by writing or copying data directly to a printer rather than submitting it to a queue. A spooled printer causes such an application program to write output to an intermediate storage device (such as a disk) so that the printer targeted to print the output remains available to other system users while the program is running.

When you spool a printer, you specify a storage device and an output queue to be associated with that printer. When a process running an application directs its output to the spooled printer, the output is instead placed in a temporary file on the storage device. When the file is closed, the system submits the file for printing on the associated output queue. Both the spooling of the output file to an intermediate storage device and the subsequent queuing of a job consisting of this file occur without the direct intervention of the user.

If your system runs application programs that might write output directly to a printer, Digital recommends you spool your printers. Digital recommends you also spool your LAT printers to prevent privileged users from writing directly to a LAT printer. Writing directly to a LAT printer can cause problems for output queues that use the printer.

Figure 13-9 illustrates a sample configuration using spooled printers. Section 7.6.2.1 describes how to set up a spooled printer.

7.6.2.1 Spooling Printers

To spool a printer, use the SET DEVICE/SPOOLED command. This command associates the printer with a storage device (such as a disk) and an output queue.

You must spool a printer before you start the queue to be associated with the printer.

Enter the DCL command SET DEVICE/SPOOLED in the following format:

SET DEVICE/SPOOLED[=(queue-name[:],intermediate-disk-name[:])] output-device-name 

You should always specify the intermediate disk and queue explicitly. If the queue you associate with the spooled output device is a generic queue, a file written to that device is sent to the generic queue, which in turn places the job in one of its target queues. As a result, a job copied to the LPA0: device, for example, might not necessarily print on the printer LPA0:, but instead might print on one of the other printers targeted by the generic queue.

When you select an intermediate storage device, make sure that it has sufficient free space for the volume of spooled output. If you plan to enforce disk quotas on the intermediate device, make sure that all expected users have a quota authorized on the intermediate device. The intermediate device must be mounted before files can be written to it.

After establishing an output device as spooled, you should test the device, because errors in disk or queue names are not detected until spooling is attempted. This step is described in Section 7.6.2.3.

You should create a command procedure to set up your output devices each time the system reboots. Include the commands to set up spooled devices in this command procedure. For more information, see Section 7.6.1.

Example

The following example illustrates sample commands used to set up spooled printers. This example also includes the command used to set device characteristics. You generally include the commands to spool printers along with the command to set device characteristics in a startup command procedure to set up output devices.

$! Set up and spool line printer devices                  
$! 
$ SET PRINTER/PAGE=60/LOWERCASE/TRUNCATE LPA0: 
$ SET PRINTER/LA11/UPPERCASE/WRAP LPB0: 
$ SET DEVICE/SPOOLED=(SYS$PRINT,SYS$SYSDEVICE) LPA0: (1)
$ SET DEVICE/SPOOLED=(SYS$PRINT,SYS$SYSDEVICE) LPB0: 
$! 
$! Set up and spool LAT printers 
$! 
$   SET TERMINAL LTA331:/SPEED=9600/DEVICE=LN03 - 
    /NOBROADCAST/NOECHO/HARDCOPY/NOTYPE_AHEAD/PERMANENT 
$   SET DEVICE LTA331:/SPOOLED=(MKTG$LN03_1,SYS$SYSDEVICE)  (2)
$! 
$   SET TERMINAL LTA332:/DEVICE=LA210/PAGE=66 - 
    /NOBROADCAST/PERMANENT 
$   SET DEVICE LTA332:/SPOOLED=(LA210$PRINT,SYS$SYSDEVICE) (3)
  1. Spools the output device LPA0: by associating it with the storage device SYS$SYSDEVICE and the queue SYS$PRINT. When output from an application is directed to LPA0:, the data is temporarily stored on SYS$SYSDEVICE until the application completes. This keeps the output device LPA0: available for other jobs until the application's output is ready for printing. When the application completes, its output is submitted to the queue SYS$PRINT.
  2. Spools the LN03 device on LAT port LTA331: by associating it with the storage device SYS$SYSDEVICE and the queue MKTG$LN03_1.
  3. Spools the LA210 device on LAT port LTA332: by associating it with the storage device SYS$SYSDEVICE and the queue LA210$PRINT.

7.6.2.2 Despooling a Spooled Printer

Occasionally, you might need to disable spooling on a device. For example, the SET TERMINAL command can be executed only on a despooled output device. If you need to disable spooling to an output device, use the SET DEVICE command with the /NOSPOOLED qualifier.

You must stop the corresponding queues before you can change the spooling status.

For more information about the SET DEVICE/NOSPOOLED command, see the OpenVMS DCL Dictionary.

7.6.2.3 Testing a Spooled Printer

After establishing an output device as spooled, you should test the device, because errors in disk or queue names are not detected until spooling is attempted. To test a spooled device, use a command procedure similar to the following:

$!          *****TESTING SPOOLED DEVICE*** 
$! 
$! set the device spooled 
$  SET DEVICE/SPOOLED=(SYS$PRINT,SYS$SYSDEVICE:) LPA0: 
$! 
$! create a test file 
$  CREATE TEST.LIS 
     !Add the first test record here. 
     !Ctrl/Z to exit the file 
$! 
$! write the file to the output device 
$  COPY TEST.LIS LPA0: 
$  EXIT 

7.7 Managing Tape Drives

When managing tape drives, perform the following tasks:
Task For More Information
Get information about tape drives Section 7.7.1
Change tape drive characteristics Section 7.7.2

For information about managing volumes on tape drives, see Section 8.2.

7.7.1 Getting Magnetic Tape Device Information

You can enter the SHOW DEVICES command to find available magnetic drives on your system. The SHOW DEVICES/FULL command enables you to retrieve additional information about the characteristics of a particular magnetic tape device.

7.7.2 Modifying Magnetic Tape Device Characteristics

Use the DCL command SET MAGTAPE to define the default characteristics associated with a specific magnetic tape device for subsequent file operations. The device must not be currently allocated to any other user.

The following examples illustrate uses of the SET MAGTAPE command in conjunction with the MOUNT command.

Examples

  1. $ MOUNT MTB1:/FOREIGN
    $ SET MAGTAPE MTB1:/DENSITY=800
    

    The MOUNT command mounts a tape on the MTB1: device. The /FOREIGN qualifier indicates that the tape is not in the standard format used by the operating system. For example, certain Backup utility (BACKUP) operations require you to mount a tape with the /FOREIGN qualifier.
    The SET MAGTAPE command defines the density at 800 bpi for writing to the magnetic tape. (The density is reset only if the magnetic tape has never been written before.)
  2. $ MOUNT MTA0:/FOREIGN
    $ SET MAGTAPE MTA0:/SKIP=FILES:4
    

    The MOUNT command mounts a foreign magnetic tape on the MTA0: device; the SET MAGTAPE command directs the I/O subsystem to position the magnetic tape to skip four files.
  3. $ MOUNT MTA1:/FOREIGN
    $ SET MAGTAPE/REWIND MTA1:
    

    The MOUNT command mounts a foreign tape on the MTA1: device; the SET MAGTAPE/REWIND command rewinds the volume.

7.8 Managing a Card Reader (VAX Only)

On VAX systems, the Digital CR--11 card reader reads computer card decks. Users can submit the two following types of card decks for processing:

To ensure that card decks are processed efficiently, you must understand their characteristics and the use of the card reader. The following sections describe which cards you should check before processing a deck through a card reader, and how to determine which cards are damaged.

7.8.1 Distinguishing the Type of Card Deck (VAX Only)

Before loading a card deck into the card reader, determine:

The following sections describe how to make these determinations.

7.8.1.1 Batch Job Card Deck (VAX Only)

A batch job card deck consists of three segments:

The initial two cards in a batch job card deck are the $JOB and the $PASSWORD cards. These cards log in the user and the batch job to the system. Following the initial two cards are program cards. Program cards contain instructions that direct the system to libraries, routines, and data needed to complete the batch job. The last card must be either an end-of-job command ($EOJ) card or an end-of-file (EOF) card. Either of these cards tells the system that this is the end of the job.

Checking Input

The system cannot execute the job without $JOB and $PASSWORD cards. If you are given a card deck with these cards omitted, return the deck so that the user can insert them.

Since the card deck contains the user's password, you must ensure that it is always handled with care to preserve the security of the user's account.

The last card in the deck must be either an $EOJ or an EOF card.

If the last card is not one of these end cards, you can type an end card on the card punch (12-11-0-1-6-7-8-9 overpunch in column 1) and place it at the end of the deck.

Checking Output

The log file produced by a card reader batch job is queued for printing to the default system printer queue, SYS$PRINT. To have the log file queued to a different queue, the user can specify the /PRINTER qualifier on the $JOB card.

If an error occurs while the system is attempting to validate the $JOB and $PASSWORD cards, the operator communication manager (OPCOM) sends to the card operator an error message that reports the job card and the error.

7.8.1.2 Data Card Deck (VAX Only)

A data deck contains data that will be either read by a program or copied to a file for later use. The process that reads the data deck is usually associated with an interactive user at a terminal or with a batch job submitted by an interactive user. Since the user and process already are logged in to the system, the first card can contain any data the user specifies. Then, either the program must read the exact number of cards supplied, or the last card must be an EOF card to inform the program that this is the end of the data deck.

When a user wants a data deck to be read, you must make sure the user has allocated the card reader. If the card reader is not allocated, the system tries to submit the deck as a batch job and subsequently flushes the deck through the reader, rejecting the job.

If the program does not read the exact number of cards (as with the COPY command), the EOF card must be the last card in the deck, to inform the program that this is the end of the deck. Without this card, the program waits indefinitely for more cards, and the system prints "card reader off line" messages on the operator's terminal. If the card deck lacks an EOF card, you can type one on a card punch and insert it at the end of the deck.

7.8.1.3 Setting Card Reader Translation Modes (VAX Only)

For the system to read input properly, the card reader must be set to the correct translation mode---the same as the translation mode of the card punch that prepares the deck. The system supports 026 and 029 card punches.

Make sure the following conditions exist so you can set the card reader to the correct translation mode:

To set the translation mode of the card reader for many decks of the same type, use the SET CARD_READER command. This command is described in the OpenVMS DCL Dictionary. By default, when the system is booted, the translation mode is set to 029.

7.8.2 Running the Input Symbiont Interactively (VAX Only)

To run the input symbiont interactively and take card image input from an OpenVMS Record Management Services (RMS) file, follow these steps:

  1. Enter a command in the following format:
    DEFINE/USER_MODE SYS$INPUT filename 
    

    For example:
    $ DEFINE/USER_MODE SYS$INPUT SPECIAL_FILE.DAT 
    
  2. Enter the following command:
    $ RUN SYS$SYSTEM:INPSMB
    

Running the input symbiont interactively requires the following:

All messages are displayed to the terminal rather than to the card operator.


Chapter 8
Managing Storage Media

This chapter discusses the following:

Information Provided in This Chapter

This chapter describes the following tasks:
Task Section
Allocating and deallocating disk and tape drives Section 8.2
Initializing volumes Section 8.3
Protecting volumes Section 8.4
Mounting volumes Section 8.5
Setting up disk volume sets Section 8.6
Mounting ISO 9660 volume sets and groups Section 8.7
Mounting tape volume sets Section 8.8
Dismounting volumes and volume sets Section 8.9
Using command procedures for media setup Section 8.10
Managing disk space Section 8.11
Using the Analyze/Disk_Structure utility to check and repair disks Section 8.12
Using mount verification for recovery Section 8.13
Using the Bad Block Locator utility to detect media errors Section 8.14

This chapter explains the following concepts:
Concept Section
Disks, including Files--11 structures Section 8.1.1
Magnetic tape Section 8.1.2
Public and private disk volumes Section 8.1.3
Tape and disk volume protection Section 8.4
Disk volume sets Section 8.6.1
Disk quotas Section 8.11.1
Mount verification Section 8.13.1

8.1 Understanding Storage Media Concepts

Concepts related to storage media in general include the following:
Term Definition
Device (or Drive) Hardware that allows access to storage media.
Media Physical items on which you can store data.
Volume Logical unit of data storage; one or more media units. A disk or tape must be mounted on a device for the operating system to recognize it as a volume.


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  6017P019.HTM
  OSSG Documentation
  22-NOV-1996 14:21:44.06

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal