ICL 1900 Series George 3 Operating System Commands

FIND

Function

Loads the named program from the specified magnetic tape or UDAS device (Format 1); or from a filestore magnetic tape file (Format 2).

Format

  1. FIND program name,device type,device description, COREnumber,OVERLAYSmagnetic tape description
  2. FIND program name,,file description,COREnumber, OVERLAYS

The program name has the standard format of # followed by four characters. This parameter is mandatory.

The device type is MT if the program is to be loaded from magnetic tape or DA if it is to be loaded from a UDAS device (Format 1 above).

If the program is to be found from a filestore magnetic tape file, the second parameter must be null (Format 2 above). It must not be omitted.

If format 2 of FIND is used, the third parameter (file description) is a file description specifying the magnetic tape file from which the named program is to be loaded. The third parameter is mandatory.

The device description specifies the magnetic tape or UDAS device from which the named program is to be loaded (Format 1 above). Accordingly, this parameter is a magnetic tape description or an exofile description as appropriate.

Note that the magnetic tape or exofile name must be of the form PROGRAM xxxx, where xxxx is an expression consisting of four alphanumeric characters, the first of which must be alphabetic.

Notes

  1. If a GPL overlay program is to be loaded from a magnetic tape (see Format 1), either a magnetic tape description may be given with the OVERLAYS parameter, or a workfile may be specified.
  2. If a GPL overlay program is to be loaded from a magnetic tape filestore file (see Format ), either a workfile must always be specified with the OVERLAYS parameter.

Forbidden contexts

NO USER, PROGRAM, BREAK-IN

After the command, the context will be CORE IMAGE if the specified program has been loaded or NO CORE IMAGE if the specified program cannot be found.

Execution

FIND is a system macro that loads a bootstrap (a subject program), makes the specified device ONLINE (Format 1) or ASSIGNs a magnetic tape to the specified file (Format 2), and enters the bootstrap which searches for the specified program. When the program is found the message:

    PROGRAM program name FOUND

is displayed.

The program's request slip is examined and the requested core obtained. (If the CORE parameter is present, the number given there is taken to indicate the size required.) The program's request slip is then given to GEORGE 3 and the program loaded.

Examples

FIND #XE20,DA,(775173,PROGRAM XE20),CORE22000
FIND #XE99,,PROGRAM TAPE,OVERLAYS

Notes

  1. If the program has a Type 6 Supplementary Request Block, an attempt will be made to obtain the modes required by means of a 165/9 extracode.
  2. If the program has a Type 2 Entry Block, the program will be entered at the specified address.
  3. If the program being loaded has no binary block with a destination address in the range 0 to 7 and if the progrma event previous to the FIND command was caused by a 160/2 extracode, the values in the accumulators of the core image will be the same after the command as before the 160/2 extracode was issued.
  4. FIND accesses the entrants :LIB.PROGRAM XK62 and :LIB.PROGRAM XK73, in execute mode.

Error Messages

device type FAIL OR BINARY PROGRAM FORMAT ERROR
device description NOT AVAILABLE
device type READ OR WRITE ERROR
file description NOT AVAILABLE
magnetic tape description NOT AVAILABLE
22AM/EBM NOT AVAILABLE
E.D.S. ENTRY BLOCK OR CHECKSUM ERRORS
ERROR IN program name'S REQUEST BLOCK
ONLINE device type FAIL
PARAMETER 1 NOT RECOGNISED
PARAMETER 2 NOT RECOGNISED
PROGRAM program name NOT FOUND
PROGRAM EXCEEDS REQUESTED SIZE
PROGRAM IS TOO BIG
PROGRAM IS SPARSE AND CAN ONLY BE LOADED BY GEORGE 4
UNIDENTIFIED ERROR