ICL 1900 Series George 3 Operating System Commands

ONLINE (OL)

Function

Connects a peripheral on-line to an object program.

Format

1. BASIC INPUT PERIPHERALS (*CR and *TR)
   (a) ONLINE basic input peripheral name,document name
   (b) ONLINE basic input peripheral name
2. BASIC OUTPUT PERIPHERALS (*LP, *CP and *TP)
   (a) ONLINE basic output peripheral name,document name,setup parameter, property parameter
   (b) ONLINE basic output peripheral name
3. MAGNETIC TAPE PERIPHERALS (*MT)
       ONLINE magnetic tape peripheral name, magnetic tape description
   The peripheral name may be qualified by READ or WRITE in parentheses. A MODE setting for the deck may also be indicated.
4. DIRECT ACCESS PERIPHERALS (*DA)
       ONLINE direct access peripheral name, exofile description
   The peripheral name may be qualified by READ, WRITE, OFFSET, OVERLAY or SCRATCH in parentheses.
5. ANTICIPATED COMMAND ISSUERS (*CI)
       ONLINE command issuer channel name
6. EXOTIC PERIPHERALS (any peripherals other than types 0, 1, 2, 3, 4, 5, 6, 9, 10, 11 or 13)
       ONLINE exotic peripheral name,data description
7. FLAG SETTING PERIPHERALS (*MX and *IT)
       ONLINE flag setting peripheral name, conceptual name

Forbidden contexts

NO CORE IMAGE

Execution

1. BASIC INPUT PERIPHERALS
   Format A
   
   The specified document is connected on-line to the current core image so that PERI instructions for the named peripheral are serviced by reading directly from the peripheral holding this document.
   
   Example
   
   ONLINE *CR0,:FRED.CARDINPUT
   
   Format B
   
   The job source is connected to the current core image in such a way that PERI instructions for the named peripheral are seviced by reading from the job source. The source may be a job description file or more usually will be the MOP terminal, in which case the user will be reqested to input data from the terminal whenever a PERI instruction is encountered in his current program.
   
   A job description file input from a paper tape reader may be read by tape or card reader instructions. If card reader instructions are used, care must be taken if the job description file is in NORMAL or ALLCHAR mode, since each line of input will be passed to the object program exactly as it is stored and may contain shift characters.
   
   MOP terminal input or a job description file input from a card reader or MOP terminal may also be read by tape or card reader instructions. In this case the input will be in card form, so if tape reader instructions are used, any shift characters will have to be added as follows:
   
       $    alpha shift
       ]    beta shift
       ^    delta shift
   
   Thus, newline is punched or typed as ^* and lower case letters are punched as ]ABC etc.
   
   The peripheral parameter may be qualified by the IDENTIFY option. This causes the request for input to be preceded by the identifier of the peripheral concerned. For example:
   
   *CR2_
   
   Example
   
   ONLINE *TR1
   
   
2. BASIC OUTPUT PERIPHERALS
   Format A
   
   The specified peripheral is connected on-line to the current core image. PERI instructions for this peripheral are serviced directly and output is preceded by the comment line
   
       #OUTPUT ONLINE BY 'username.jobname' ON date AT time
   
   and by the command line
   
       DOCUMENT document name
   
   The document seperators and terminators output at the beginning and end of the document and the action taken in the event of a peripheral failure during the output of these or the lines mentioned above are as for LISTFILE.
   
   Similarly, the setup parameter and the property parameter are dealt with as for LISTFILE.
   
   Examples
   
   ONLINE *LP1,PRINTDOC
   ONLINE *LP2,CHEQUEDOC,SETUP CHEQUEFILE,PROPERTY PRINT160
   
   Format B
   
   The current core image is connected to the monitoring file and, in the case of a MOP job, to the MOP terminal as well, PERI instructions for the named peripheral are serviced by sending the output in question direct to the user's terminal and/or to the monitoring file in the OBJECT and ONLINE categories.
   
   If tape punch instructions are used to send output to the MOP terminal or the monitoring file, output will include shift characters. Thus a newline will appear as ^*.
   
   As with input peripherals, output peripherals can have the IDENTIFY option to identify output to the terminal or monitoring file system, for example:
   
   *CP1 ABCD
   *LP2 ZXY
   
   Example
   
   ONLINE *CP3
   
   
3. MAGNETIC TAPE PERIPHERALS (*MT)
   
   The magnetic tape specified by hte second parameter is loaded, or, if no magnetic tape name is given, a work tape is loaded. The tape is then opened and connected to the current program in such a way that PERI instructions for the named magnetic tape will be srviced by reading from/writing to this magnetic tape. The tape must have a 1900 Series header label, or have been introduced to the system by a REDON command if the tape is a non-standard tape or Xenotape. In this case the magnetic tape description must be qualified by NONSTANDARD. PERI instructions with the exception of open mode PERIs will control tape operations directly as under a standard EXECutive. GIVE may be specified as a qualifier to the magnetic tape description.
   
   After an ONLINE command for a standard magnetic tape, a work tape is left positioned immediately after the header label. (A non-standard tape is positioned before the first block on the tape.) The program's open PERI to the tape will then have no effect other than the normal replies being set. Program open mode PERIs for which no ONLINE command has been given will be implemented normally.
   
   The magnetic tape peripheral name may be qualified by READ or WRITE and MODE in parentheses. If READ is specified, the tape will be opened for reading and the absence of the write permit ring will be tested. If WRITE is specified the presence of a write permit ring will be tested.
   
   In most cases, if neither READ nor WRITE is specified, the tape will be opened for reading, but no test will be made on the write permit ring unless the user requesting the tape does not have a trap to permit WRITE access, in which case the absence of a write permit ring will be tested. However, if the magnetic tape peripheral name is the only parameter given and is not qualified, the WRITE qualifier will be assumed and the tape will be opened as for an open mode #600 PERI.
   
   If MODE n is specified the action taken will depend on whether the tape is already loaded or not. If the tape is loaded, a check will be made to ensure that the deck is in the correct mode. If it is not but can be changed to the required value a temporary change will be made. If the deck is unsuitable and cannot be switched to the required mode then the tape will be unloaded and a message is output listing suitable decks for the tape to be loaded in. If the tape is not loaded a 'PLEASE LOAD' message will be output indicating the required mode.
   
   If a worktape name is given, then a WRITE qualifier is assumed unless READ is specified.
   
   The ONLINE command provides all the alternative methods of opening the tape provided by the open mode PERI instructions, apart from modes #400 and #500. See below for the open modes and the parameter formats of the equivalent ONLINE commands.
   
   

   #100	magnetic tape peripheral name,magnetic tape description
   #200	magnetic tape peripheral name(READ),magnetic tape description
   #300	magnetic tape peripheral name(WRITE),magnetic tape description
   #400	For this mode, see the GETONLINE command
   #600	magnetic tape peripheral name(WRITE)

   
   Whether the tape is opened by an ONLINE command or by an open mode PERI, the following message is sent to the monitoring file system (COMMENT category):
   
       USED MT tape serial number,magnetic tape name
   
   where the magnetic tape name is the local name of the tape, or in the case of a named worktape:
   
       USED MT tape serial number,worktape name
   
   Examples
   
   ONLINE *MT0,(1234,:BILL.A(2/50))
   ONLINE *MT1(WRITE)
   ONLINE *MT1
   ONLINE *MT1(MODE36),(1234X,FREDSTAPE)
   ONLINE *MT1(MODE36),FREDSTAPE(NONSTANDARD)
   ONLINE *MT2,!WORKTAPE
   
   
4. DIRECT ACCESS PERIPHERALS (*DA)
   
   The exofile named by the second parameter is connected to the current program. PERI intsructions for the specified direct access channel are seviced by processing the specified exofile.
   
   The peripheral name will be *DA; the only distinction between devices is contained in the serial number. The peripheral name may be qualified by READ, OVERLAY, WRITE, OFFSET or SCRATCH. The exofile description may be qualified by GIVE (all modes) and MAYBE (SCRATCH mode only).
   
   Examples
   
   ONLINE *DA0(WRITE),(100,XFILE(3))
   ONLINE *DA1(OFFSET),F120(-1)
   ONLINE *DA1(SCRATCH),(80,2,#231,#232)
   ONLINE *DA3,(200,FILEX)(GIVE)
   ONLINE *DA1(SCRATCH),(40,1)(MAYBE)
   
   
5. ANTICIPATED COMMAND ISSUERS
   
   After this command has been obeyed a channel will exist between GEORGE 3 and the object program. The program can then, by issuing certain combinations i the available modes, make the channel appear to GEORGE 3 to be a MOP terminal.
   
   Example
   
   ONLINE *CI2
   
   
6. EXOTIC PERIPHERALS
   
   The specified peripheral is connected on-line to the current core image in a similar way to a normal basic peripheral such that transfers are implemented directly between the peripheral and the program. The difference is that GEORGE 3 does not perform transfers on these devices and cannot therefore connect an input exotic peripheral by document name or head the output to an output exotic peripheral with the usual output headings.
   
   The name in the second parameter is used by GEORGE 3 to request the operators to prepare the device concerned if necessary. The message output to the operator's console is
   
       PLEASE CHECK data description ON UNIT n
   
   where n is the operator's number of the device concerned. Preparing the device may mean the operators have to load a document on an input exotic peripheral, ensure that the correct stationary is on an output exotic peripheral or merely ensure that the peripheral is ready for use. The operator will know what action is appropriate depending on the type of device involved.
   
   If the job has to be set waiting for the specified device, the message
   
       WAITING FOR peripheral type
   
   will be sent to the job's monitoring file. This message, preceded by the appropriate user name and job name, will also be output to the operator's console.
   
   The message
   
       WAITING FOR data description TO BE CHECKED
   
   may also be sent to the job's monitoring file. Both these messages are in the COMMENT category.
   
   Examples
   
   ONLINE *GP1,GOUT
   ONLINE *201,GOUT
   
   
7. FLAG SETTING PERIPHERALS
   
   The peripherals in this group are those flag setting peripherals which can be used for MOP and/or for system use of 7020. All other types of flag setting peripherals are exotic peripherals.
   
   The flag setting peripherals which may be used by the system are uniplexer (type 10) and multiplexer (type 11). A multiplexer or uniplexer may be connected to a program as a whole unit, or as a conceptual unit. In each case the connection is effected by means of an ONLINE command.
   
   If a whole unit is being onlined, the peripheral must first be made available for connection to a program. For details of how to do this, see the MOP command. If the job has to be set waiting for the specified device, the message
   
       WAITING FOR peripheral type
   
   will be sent to the job's monitoring file in the COMMENT category. This message, preceded by the appropriate user name and job name, will also be output to the operator's console.
   
   Before an ONLINE command for a flag setting peripheral is obeyed, a REALTIME ON command must have been issued.
   
   Examples
   
   ONLINE *MX0
   ONLINE *MX1,CL CONCEP
   
   The conceptual name parameter is the name of the conceptual required as defined in a previous CONCEPTUAL command.
   
   

Error Messages

Basic Peripherals

DOCUMENT NAME FORMAT ERROR
ERROR IN PARAMETER SEQUENCE
z NOT FOUND
PERIPHERAL PARAMETER MISSING
TRACING AND REPORTING ARE SUCH THAT YOU WILL GET NO OUTPUT FROM THIS COMMAND

Magnetic Tape Peripherals

MT NAME z DOES NOT AGREE WITH THE DIRECTORY ENTRY
MT z CORRECTLY IDENTIFIED BUT NOT AVAILABLE
MT z DOES NOT BELONG TO USER DESCRIBED
MT z IS A POOL TAPE
MT z REQUESTED NOT IDENTIFIED
RELATIVE GENERATION NUMBERS ARE NOT PERMITTED FOR THIS TYPE OF ENTRANT
TAPE HEADER DOES NOT AGREE WITH DIRECTORY ENTRY
XENOTAPE DESCRIPTION MUST HAVE NAME AS WELL AS TSN
XENOTAPE NAME AND TSN z DUPLICATE NAME AND TSN ALREADY IN SYSTEM
YOU ARE ALREADY USING z
NO WORK TAPES AVAILABLE
THE WORKFILE STACK SYSTEM HAS BEEN CORRUPTED
MT z HAS BEEN WRONGED BY THE USER
MT z HAS BEEN WRONGED BY THE OPERATORS
MT z IS IN QUERY STATUS
A DEAD COMMAND HAS BEEN GIVEN TO MT z
MT z IS A WORK TAPE
NO TAPE AVAILABLE TO USE
TSN DOES NOT APPLY TO NONSTANDARD TAPES

Direct Access Peripherals

FILE NOT FOUND z
FILE z NOT TO BE WRITTEN
SYSTEM FILE CORRUPT ON z
z NOT ONLINE
NO SERIAL NUMBER z
FILE NAME PARAMETER MISSING
ILLEGAL NAME z
FILE z IS PROTECTED
FILE z NOT FOUND
FILE z IS LOCKED OUT
FILE z IS IN USE BY GEORGE
FILE z IS NOT TO BE WRITTEN TO
SCRATCH FILE CANNOT BE OPENED

Exotic and Flag Setting Peripherals

JOB IS NOT REALTIME
z DOES NOT DESCRIBE A UNIPLEXER
z IS NOT CURRENTLY AVAILABLE
z NOT RECOGNISED PERIPHERAL TYPE z NOT AVAILABLE