Sometimes you may have a logical name that conflicts with a physical name.
The system always recognizes and accepts a device's physical name, whether or not a logical name has been assigned to that device. Thus, you can specify a magnetic tape running on drive MT2 and assigned the logical name STAR as either MT2: or as STAR:.
If you put an underscore before a physical name, the system will not try to interpret it as a logical name (for example, _MT2:). A physical device name preceded by an underscore causes the system to access that device, regardless of any prior assignment.
RSTS/E evaluates the parts of a file specification in the following sequence. When a file specification contains a name followed by a colon, RSTS/E first determines whether or not the name is a user logical. If it is, then the system replaces the name with its expansion. (An expansion is the device name or PPN to which the logical name was assigned.) Otherwise, it checks to see if the name is a system-wide lOgical.
If the name is not a system-wide logical, RSTS/E then determines whether the name designates a valid physical device on your RSTS/E system. (During system
generation, your system manager selects which devices are valid on your system.) Finally, if the device name is not a physical device name, the system displays the error message:
?Not a valid device
6-20 Working with Devices
ASSIGN
ASSIGN
The ASSIGN command assigns a logical name to a directory or a physical device.
The names you assign stay in effect until you log out, or until you deassign the name with the DEASSIGN command.
- - - Note
The ASSIGN command has additional capabilities for users with greater levels of privilege. See the RSTSIE System Manager's Guide for more information.
Format
ASSIGN device-name:[ [ppn]] logical-name[:]
Prompts
Device: devnam: [ [ppn] ] Logical name: logical-name
When you use the ASSIGN command, one of the following can occur:
o The command works as expected, and no message is displayed.
o The assignment statement is incorrect, and one of the following error messages displays:
?Not a valid device
?No file naMe or type perMitted
o You exceed the maximum number of logical name assignments you can make, and the following error message displays:
?Too Many logical naMes assigned
o You reassigned a logical name and the following informational message displays:
Previous logical naMe asSignMent replaced Command Parameters
devnam: [ [ppn] ]
Specifies the name of the device or PPN to be assigned a logical name. Brackets around the PPN are required, as in the following example:
$ ASSIGN MT1:[2,214J WINDY:
logical-name[: ]
Specifies a one- to six-character logical name to associate with the device.
Working with Devices 6-21
ASSIGN
The ASSIGN command equates a logical name to a part of a physical file specifica-tion. The following example equates the logical name EXCER: to the directory OB2:[3,24]:
$ ASSIGN DB2:[3,24] EXCER:
The string "OB2:[3,24]" is called the "expansion" of the logical name EXCER.
Later, you can refer to the directory by its logical name when you issue a RSTS/E command. For example:
$ DIRECTORY EXCER:
When the system executes this DIRECTORY command, it replaces the logical name EXCER: with its expansion, OB2:[3,24], and lists all of the files in that directory on your terminal.
Another example is:
$ TYPE EXCER:RUNNER.DAT
When the system executes this command, it replaces the logical name EXCER: with its expansion and displays the contents of the file OB2:[3,24]RUNNER.OAT on your terminal.
You can equate a logical name to a physical device name, to a directory, or to both.
For example:
$ ASSIGN DB2: EXCER
$ ASSIGN [3,24] EXCER:
$ ASSIGN DB2:[3,24] EXCER:
! (DB2: is a physical device)
! ( [3,24] is a directory)
! ( [3,24] is a directory on DB2:) When you assign a logical name, the partial file specification that you assign to the logical name may itself include a previously assigned logical name. When the system executes the ASSIGN command, it replaces the previously assigned logical name with its expansion and displays an informational message. Therefore, if you later change the assignment of the first logical name, the expansion of the second logical name is not affected. For example, consider the following sequence of commands:
$ ASSIGN DB2: WORK:
$ ASSIGN WORK:[3,24] EXCER:
$ DEASSIGN WORK:
$ TYPE EXCER:RUNNER.DAT
In this example, the logical name EXCER: corresponds to OB2:[3,24]. The TYPE command displays OB2:[3,24]RUNNER.OAT even though the logical name WORK:
has been deassigned.
6-22 Working with Devices
DEASSIGN
DEASSIGN
The DEASSIGN command cancels logical name assignments you made with the ASSIGN command.
---Note
The DEASSIGN command has additional capabilities for users with greater levels of privilege. See the RSTSIE System Manager's Guide for more information.
Format
DEASSIGN Uogical-name[:]
Command Qualifiers fALL
Prompts
Logical Name: logical-name[:]
Command Parameters logical-name[: ]
Specifies a one- to six-character logical name to deassign.
A logical name is required unless you specify I ALL. If you do not specify either I ALL or a logical name, the system prompts you for a logical name. For example:
$ DEASSIGN ffiTI)
Logical NalTle: E}{CER ffiTI)
Command Qualifiers fALL
Deletes all logical names that you assigned. For example:
$ DEASSIGN/ALL ffiTI)
Working with Devices 6-23
Whenever you use the PRINT command to print files or use the SUBMIT command to execute command procedures for batch processing, you are automatically using the RSTS/E Print/Batch Services (PBS) facility. This chapter describes the commands you use to:
o Place entries on a print or batch queue for printing or batch processing
o Check the status of your print or batch job on a queue
o Modify your print or batch entry before it is printed or processed o Delete a print or batch entry from a queue
Your system manager usually sets up default print and batch queues for your system, so that you only need to use the simple commands this chapter describes to print files or submit command procedures for batch processing. If you are interested in, or need to know, more detailed information about how PBS performs its print and batch processing functions, see the complete description of PBS organization and operations in the RSTSIE System Manager's Guide.
Table 7-1 summarizes the PBS commands that this chapter describes.
Table 7-1: Print/Batch Services Commands
Command Meaning
PRINT Produces a listing, or "hard cOPY," of a file SUBMIT Submits a command file for batch processing
SHOW ENTRY Displays the names of files that are currently being printed or processed, as well as files pending on the print or batch queue
SET ENTRY Modifies one or more attributes of a file that is entered on a print or batch queue
DELETE/ENTRY Cancels an entry on the print or batch queue SHOW QUEUE Displays the status of a print or batch queue.
7-1