ICL 1900 Series George 3 Operating System Commands

GET (GE)

Function

Causes a magnetic tape currently in the pool to be allocated to the user or an entry for a named worktape to be set up in the job's temporary directory.

Format

1. GET magnetic tape name
   The magnetic tape name must be qualified by *MT and must be relative to the user's proper directory or to a pseudo user's directory owned by the proper user.
   The TRAPGO entrant description qualifier may be given with GET command to set the required traps for the magnetic tape.
   
   
2. GET worktape name
   The worktape name must be qualified by *MT.

Forbidden contexts

NO USER

Execution

Format 1

A test is made to ensure that the user's budget of SPACEMT permits the addition of another tape. A request to the operator to load a pool tape is then generated. When one is loaded, an entry for this tape is set up in the directory implied by the magnetic tape name, and the user name associated with this directory is entered in :SYSTEM.SERIAL to indicate that the tape is an owned tape. The specified local name of the tape is written in a new header label. The following message is output on the operator's console:

    MT tape serial number IS NO LONGER A POOL TAPE

and the message

    USED MT tape serial number,magnetic tape description

is sent to the monitoring file system (COMMENT category).

A READ and WRITE access trap is set up for the owner and his SPACEMT budget is updated.

Format 2

A worktape is obtained and left on a deck ready for use, and an entry is made in the job's temporary directory. The name in the tape's header label is not changed and so contains whatever was there when the tape was last used. The tape has a write permit ring.

Example

GET MTDATA(*MT)
GET !WORKTAPE(*MT)

Error Messages

DEVICE TYPE QUALIFIER IMPERMISSILE
DEVICE TYPE QUALIFIER MISSING
MAGNETIC TAPE DESCRIPTION FOR THIS COMMAND MUST CONTAIN A LOCAL NAME
MAGNETIC TAPE DESCRIPTION FOR THIS COMMAND MUST NOT CONTAIN A SERIAL NUMBER
NO POOL TAPE AVAILABLE
USER HAS NO SPACEMT BUDGET AVAILABLE
USER IS OVERDRAWN ON SPACEMT BUDGET
NO WORKTAPE AVAILABLE