ICL 1900 Series George 3 Operating System Commands

GETONLINE (GL)

Function

Takes a magnetic tape from the pool, relabels it and makes it on-line to a program, or takes a worktape and makes it on-line to a program as a named worktape.

Format

1. GETONLINE magnetic tape peripheral name,magnetic tape name
   The first parameter is the peripheral name specified in the program's PERI instructions. It may be qualified be either READ or WRITE; if no qualfier is given, WRITE is assumed. The second parameter is the name that is to be given to the tape. It must be relative to the user's proper directory or to a pseudo user's directory owned by the proper user. The name may be qualified by a signed generation number. The TRAPGO entrant description qualifier may be given with GETONLINE command to set the required traps for the magnetic tape.
   
   
2. GETONLINE magnetic tape peripheral name,worktape name
   The first parameter is the peripheral name specified in the program's PERI instructions. It may be qualified be either READ or WRITE. If no qualfier is given, WRITE is assumed.

Forbidden contexts

NO CORE IMAGE

Execution

Format 1

GETONLINE is a command that combines the functions of GET and ONLINE. Provided that the user's budgets permit, a permanent directory entry for the magnetic tape is set up in the directory indicated by the magnetic tape name. A pool tape is then loaded, given a new header label and made on-line to the program.

Format 2

A worktape is obtained and made on-line to the object program and an entry is made in the job's temporary directory. The name in the tape's header label is not to be altered and so contains whatever was there when the tape was last used. The tape has a write permit ring.

Example

GETONLINE *MT1,TAPEDATA

Note

GETONLINE is the command equivalent of the open mode PERI #400.

Error Messages

As for GET and ONLINE commands