ICL 1900 Series George 3 Operating System Macros

SETUPRES

Function

This macro:

  1. Brings on-line the GEORGE source files to be edited or used in the GIN restore
  2. Implements the edits to produce the corrected source files
  3. Sets up restore instructions to compile the corrections
  4. If specified, adds a DUMP directive to the GIN restore file
  5. Provides an interface for special actions at the time of each edit, for example, FILECHECK on the corrected source file

Format

SETUPRES VDFfile description,EDfile description, RPACKfile description,SCDYusername, DUMP(string),ERlabel,IG2K

Parameters  
VDFfile description Version definition file
EDfile description File containing the corrections
RPACKfile description File to contain the restore instructions
SCDYusername Pseudo-user containing the source files
DUMP(string) The string is the parameter list to the restore time macro DUMP, which will be added to the end of the restore file. This is an optional parameter
ERlabel Optional parameter giving the label to GOTO if an error occurs during the execution of the macro
IG2K Optional parameter which causes SETUPRES to ignore files with generation number greater than 2000 in the SCDY directory

Forbidden contexts

NO USER, BREAK IN

Execution

  1. SETUPRES scans the corrections file to:-
    1. Determine which files are to be brought on-line for edits and MENDITS
    2. Checksum the restore instructions in the corrections
    3. Output the edit instructions for use by the SETUPRESA macro
    4. Generate the restore instructions
  2. SETUPRES scans the SCDY directory and the version definition file to determine where to get the source files from. Files in filestore will be RETRIEVEd if off-line and files on the source tapes will be brought on-line by use of the FILEIN macro
  3. The restore file will contain all the restore instruction except that there will be only one MENDIT for each segment. The restore file will be complete even if no edits are done for a correction because the corrected source files already exist
  4. The individual edits are implemented via the SETUPRESA macro

Library Entrants Accessed

:LIB.PROGRAM XKQ2 (Execute)
:MACROS.FILEIN (Execute)
:MACROS.SETUPRESA (Execute)
:MACROS.FILECHECK (Execute)

Example

SETUPRES VDF :VDF.VDF852,ED:EDITS.SN300,RPACK:GEOSOURCE.RES852SN300,SCDY:GEO, DUMP(1,G3853C,G3MK8D),ERIERROR,IG2K

Error Messages

ERROR: CHECK FAILED
ERROR IN MACRO
ERROR IN 'VDF' PARAMETER
ERROR IN 'ED' PARAMETER
ERROR IN 'RPACK' PARAMETER
ERROR IN 'SCDY' PARAMETER
ERROR IN 'DUMP' PARAMETER
ERROR ON '!' LINE
ERROR IN 'NAME' ON '!' LINE
ERROR IN 'OLDGEN' ON '!' LINE
ERROR IN 'NEWGEN' ON '!' LINE
ERROR IN RESTORE INSTRUCTION CHECKSUM
ERROR: EDITS FILE INCOMPLETE
ERROR: EDITS FILE OUT OF SEQUENCE