Function
Runs the tape-to-tape processor (TTTP), which processes incremental dump tapes by copying a series of increments directly from one tape to another.
Format
TTTP parameter list
A table of possible parameters is as follows:-
| Parameter | Abbreviation | Default if Omitted | Formats not permitted in REVISION mode |
|---|---|---|---|
| Parameters which are either present or absent | |||
| NLD | NL | Not NLD | |
| NODUMP | ND | Not NODUMP | |
| OPS | OP | This parameter should never be specified in the parameter list. It will be included by the macro if required. | |
| RETURN | RT | REUSE | |
| REUSE | RU | REUSE | |
| REVISION | RV | Normal run | |
| WTDUMP | WT | WTDUMP | |
| Parameters which are true of false | |||
| DIAG | DI | FALSE | |
| FREQUP | FQ | FALSE | |
| POOLTAPES | PL | FALSE | |
| Parameters which are followed by a character string or integer | |||
| CINCS | CI | 3 | |
| COPIES | CS | 2 | |
| COPMON | CM | 2 | |
| CORE | CO | Present core size of the program | |
| DEPTH | DE | 1 | |
| FROM | FR | FROMincrement number | |
| KEEP | KE | ||
| ONTO | ON | Existing GEO3PROCTAPE | ONTOtsn |
| QUIET | QT | Await operator action for every significant program event | |
| RATIO | RA | 2 | |
| REDUMP | RD | 0 | |
| RESTART | RE | Restart automatically after a system reload | |
| SAFETY | SA | 10 | |
| TO | TO | See parameter specification | TOincrement number |
Notes:
A more details specification of the parameters follows:-
| CINCS (CI) | |
|---|---|
| Format: | CINCS integer |
| Function: | Specifies by how many general restorable increments the information produced by LISTDUMP may be out of date and still allow TTTP to run. If the information is found to be out of date the macro will ask if LISTDUMP is to be run |
| Default: | If the parameter is omitted, the default value is 3 |
| Notes: | The parameter is optional and has no fixed position |
| COPIES (CS) | |
| Format: | COPIES integer or COPIES INSTPARA |
| Function: | Specifies the number of output tapes. The second format sets this number to the installation parameter DUMPTAPES |
| Default: | If the parameter is omitted, the default value is 2 |
| Notes: | The parameter is optional and has no fixed position. The integer specified must be such that 1 ≤ integer ≤ 3. The second format may be used in REVISION mode, to set COPIES to the current value of DUMPTAPES, but the value of COPIES will not change whenever DUMPTAPES does so |
| COPMIN (CM) | |
| Format: | COPMIN integer or COPMIN NONE |
| Function: | The first format specifies the minimum number of output tapes with which TTTP may not proceed if it cannot get COPIES tapes |
| Default: | If the parameter is omitted, the default value is 2 |
| Notes: | The parameter is optional and has no fixed position. The integer specified must be such that 1 ≤ integer ≤ 3 |
| CORE (CO) | |
| Format: | COREinteger |
| Function: | Specifies the amount of core given to the program, in words |
| Default: | If the parameter is omitted, the default value is the amount of core specified in the program's request slip |
| Notes: | The parameter is optional and has no fixed position. If an integer is specified that is less than the core size in the request slip, an error occurs |
| DEPTH (DE) | |
| Format: | DEPTHinteger |
| Function: | Specifies the number of extra sets of tapes to be kept per increment after processing, over and above the set just produced |
| Default: | If the parameter is omitted, the default value is 1 |
| Notes: | The parameter is optional and has no fixed position. The integer
specified must be such that 0 ≤ integer ≤ 3 It is strongly advised that TTTP should not be run with DEPTH set to zero |
| DIAG (DI) | |
| Format: | DIAG TRUE or DIAG FALSE |
| Function: | Specifies whether TTTP is to produce diagnostic printout (if set to TRUE) or not (if set FALSE) |
| Default: | If the parameter is omitted, the default is FALSE |
| Notes: | The parameter is optional and has no fixed position. Usually, it will not be necessary to run with this parameter set TRUE |
| FREQUP (FQ) | |
| Format: | FREQUP TRUE or FREQUP FALSE |
| Function: | Normally, :SYSTEM.INCINDEX is updated by TTTP after 20 increments have been processed; when a tape fail occurs; when a new input tape is required and at the end of all processing. This will occur if the second format is used. If the first format is used, in addition to these occasions, :SYSTEM.INCINDEX will be updated after processing each non-obsolete increment |
| Default: | If the parameter is omitted, the default is FALSE |
| Notes: | The parameter is optional and has no fixed position |
| FROM (FR) | |
| Format: | FROM increment number or FROM OLDUN or FROM OLDEST |
| Function: | Specifies the increment at which TTTP is to start processing. If the second format is used, TTTP will start processing at the oldest increment which has not been processed by TTTP. If the third format is used, TTTP will start processing at the oldest record in :SYSTEM.INCINDEX |
| Notes: | The parameter is mandatory and has no fixed position. If the parameter is not given, TTTP will ask at which increment to start processing and will not continue until it is given. The first format is not valid in REVISION mode |
| KEEP (KE) | |
| Format: | KEEP integer or KEEP OFF |
| Function: | The first format specifies the number of tapes to be kept for the
increment. The DEPTH parameter has no effect if this format is used. The second format indicates that any KEEP parameters set in REVISION mode should be ignored. |
| Notes: | If the KEEP parameter is less than the COPIES parameter an error is given. If they are equal, a warning is given since this is equivalent to proceeding with DEPTH set to zero |
| NLD (NL) | |
| Format: | NLD |
| Function: | Specifies that TTTP is not to run LISTDUMP but is to use its existing information about the filestore |
| Default: | If the parameter is omitted, LISTDUMP is run |
| Notes: | The parameter is optional and has no fixed position. It is ignored in REVISION mode |
| NODUMP (ND) | |
| Format: | NODUMP |
| Function: | This specifies that, on conclusion or processing, TTTP should not wait for a dump or attempt to release obsolete tapes from INCINDEX |
| Default: | If the parameter is omitted, TTTP will wait for a dump at the end of every run in wshich the tapes have become obsolete; and following the dump, will release obsolete taps from INCINDEX |
| Notes: | The parameter is optional and has no fixed position |
| ONTO (ON) | |
| Format: | ONTO tsn or ONTO OLD or ONTO NEW or ONTO POOL or ONTO SPARE |
| Function: | Specifies tapes which TTTP is to try to use as output tapes. The
first format may be included in the parameter line any number of
times (though only the first 6 tsns will be stored). The second format specifies that TTTP should use, as output tapes, those tapes which it last used as output tapes. This can only be done if increments are processed contiguously. The third format specifies that TTTP should try to get new output tapes frum :DUMPER called GEO3PROCTAPE. If it cannot get enough tapes it will attempt to get pool tapes if POOLTAPES is TRUE. The fourth format specifies that TTTP should ignore unused GEO3PROCTAPEs and get tapes from the pool. The fifth format indicates that TTTP should attempt to use spare GEO3PROCTAPEs |
| Default: | If the parameter is omitted, TTTP will attempt to get tapes from :DUMPER called GEO3PROCTAPE. If it cannot get enough tapes from :DUMPER and, if POOLTAPES is true, it will then attempt to get pool tapes |
| Notes: | The parameter is optional and has no fixed position. The first format is not valid in REVISION mode |
| OPS (OP) | |
| Format: | OPS |
| Function: | This parameter is used by the macro to tell the program to direct program-issued displays and questions to the operator's console if TTTP is not being run from a MOP terminal |
| Default: | The parameter will be included (or not) by the macro as and when required and so should not be used |
| POOLTAPES (PL) | |
| Format: | POOLTAPES TRUE or POOLTAPES FALSE |
| Function: | Specifies whether TTTP must ask the operators before getting output tapes from the pool (if set FALSE) or can proceed without asking (if set TRUE) |
| Default: | If the parameter is omitted, the default is FALSE |
| Notes: | The parameter is optional and has no fixed position |
| QUIET (QT) | |
| Format: | QUIET YES or QUIET NO or QUIET or QUIET ASK |
| Function: | The first format allows TTTP to continue without asking the operators
OK TO GO ON? after routine events such as tape fails. The second and third formats have an identical effect in that TTTP will terminate whenever an unexpected program event occurs, rather than ask the operators OK TO GO ON? The format is the standard default and is only needed where the value has been changed in REVISION mode |
| Default: | If the parameter is absent, TTTP will ask the question OK TO GO ON? after every unexpected program event |
| Notes: | The parameter is optional and has no fixed position |
| RATIO (RA) | |
| Format: | RATIO number where number is expressed as an integer or a number to one decimal place |
| Function: | Specifies the minimum compression ratio (that is, the ratio of old size to new size of increments within range) with which TTTP may proceed without asking if it can process the increments specified |
| Default: | If the parameter is omitted, the default value is 2 |
| Notes: | The parameter is optional and has no fixed position. The number specified must be greater than or equal to 1 |
| REDUMP (RD) | |
| Format: | REDUMP integer or REDUMP ALL |
| Function: | Specifies that TTTP is to mark certain increments to be redumped. If the first format is used, those increments which are within range and which have a useful size less than integer filestore blocks (512 words) will be marked to be redumped. If the second format is used, all increments within range will be marked to be redumped. |
| Default: | If the parameter is omitted, no increments will be marked to be redumped except those for which failure in transcription occurs, no non-failing tapes being available |
| Notes: | The parameter is optional and has no fixed position |
| RESTART (RE) | |
| Format: | RESTART YES or RESTART NO or RESTART ASK |
| Function: | RESTART specifies action to be taken after a system break. RESTART YES leads to TTTP being automatically restarted from the increment following the last one updated in :SYSTEM.INCINDEX, RESTART NO gives restart, and RESTART ASK leads to the question being put to the operator. The parameter is effective in REVISION mode |
| Default: | RESTART YES |
| RETURN (RT) | |
| Format: | RETURN |
| Function: | Specifies that TTTP is to DUMP RETURN tapes in :SYSTEM.INCINDEX which have become obsolete |
| Default: | If the parameter is omitted, TTTP will REUSE obsolete tapes |
| Notes: | The parameter is optional and has no fixed position. If both RETURN and REUSE are specified, the last one given will be accepted |
| REUSE (RU) | |
| Format: | REUSE |
| Function: | Specifies that TTTP is to DUMP REUSE tapes in :SYSTEM.INCINDEX which have become obsolete |
| Default: | If the parameter is omitted, TTTP will still REUSE obsolete tapes. (The parameter is necessary in the case when the default setting has been changed by REVISION to return tapes) |
| Notes: | The parameter is optional and has no fixed position. If both RETURN and REUSE are specified, the last one given will be accepted |
| REVISION (RV) | |
| Format: | REVISION |
| Function: | Specifies that the parameters following are to be used to reset the default options. No processing is done in a REVISION run |
| Default: | If the parameter is omitted, TTTP will be run in normal mode |
| Notes: | The parameter is optional, but, if included, it must be the first parameter given. A parameter error will result if this is not the case or if it is the only valid parameter given |
| SAFETY (SA) | |
| Format: | SAFETY integer |
| Function: | Specifies the number of general restorable increments before the last in :SYSTEM.INCINDEX beyond which TTTP is not allowed to process |
| Default: | If the parameter is omitted, the default value is 10 |
| Notes: | The parameter is optional and has no fixed position |
| WTDUMP (WT) | |
| Format: | WTDUMP |
| Function: | WTDUMP cancels the effect of NODUMP, and is only needed if NODUMP has been used in REVISiON mode, and it is required to revert to the default situation in which TTTP waits for a dump before releasing obsolete tapes from INCINDEX |
Execution
The macro first runs the LISTDUMP macro, if required, handing over to it and relevant parameters. LISTDUMP is used to update the information in the files :DUMPER.USEFUL FILES and :DUMPER.INC LENGTHS.
The TTTP program is then loaded and entered, the LISTDUMP parameters having been removed. Taking into account the parameters specified and using the information in the two files mentioned above, together with that in :SYSTEM.INCINDEX and :DUMPER.LITTLE INDEX, TTTP decides which increments it is to process, which tapes are required as input tapes and which are available as output tapes. It then asks for the tapes required and, when it is satisfied that the right tapes have been on-lined, copies the useful files from the input tapes to the output tapes. (A useful file is defined as one which is the latest version of an extant terminal file.)
It may be that new input/output tapes will be required and the program requests these as necessary. If TTTP comes across a situation which it cannot deal with itself, it will ask a question at the MOP terminal or operator's console, as appropriate. When all the useful files have been copied, TTTP will issue a command to release those tapes in :SYSTEM.INCINDEX which it is possible to return or reuse unless the NODUMP parameter has been given.
TTTP may be run in REVISION mode, whereby the parameters are used to reset certain variables. This is achieved by SAVEing the non-overlaid part of the program.
Files Accessed
:MACROS.LISTDUMP (Execute)
:DUMPER.PROGRAM G3DR (Execute)
:DUMPER.PROGRAM TTTP (Execute, Write)
:DUMPER.OVERLAY TTTP (Execute)
:DUMPER.LITTLE INDEX (Read, Append)
:SYSTEM.INCINDEX (Read, Append)
:DUMPER.USEFUL FILES (Read, Write)
:DUMPER.INC LENGTHS (Read, Write)
:DUMPER.COMFILE (Execute, Write)
:DUMPER.INCINDEXCOPY (Read, Write)
Messages
Various messages are output, the majority of which are self explanatory. Full details can be found in the manual TP4438, George 3 and 4 Operations Management.