Function
Provides a listing, in readable form, of the statistics files produced by the Backing Store Unjammer. It may also retrieve these files without listing them, or erase them.
Format
LISTUNJAM ONLYnumber,FROMnumber,TOnumber,ERASE,NOLIST
The parameters may be present in any order and are all optional, but only one of ONLY, FROM or TO must be included. The parameters may be abbreviated to the first two letters. Parameters have the following meanings:-
| ONLYnumber | If the file with fgn of number exists, it is the only file listed. If it does not exist, a display is sent to the monitoring file and the macro terminates. |
| FROMnumber | If the file with fgn of number exists, it is listed together with all files numerically suceeding it until a file that does not exist is reached. If the specified file does not exist, a display is sent to the monitoring file and the macro terminates. |
| TOnumber | If the file with fgn of number exists, all the files with contiguous fgns up to and including number are listed in ascending order of generation number. If the specified file does not exist, a display is sent to the monitoring file and the macro terminates. |
| FROMnumber,TOnumber | All existing files with an fgn between the limits specified by the numbers are listed in ascending order of generation number. If the number specified in FROM is greater than the number specified in TO a display is sent to the monitoring file and the macro terminates. |
| ERASE | If this parameter is included, the files specified by the above parameters are erased. |
| NOLIST | If this parameter is included, the files specified by the above parameters are not listed. This enables the macro to be used for merely retrieving the files concerned, or, when ERASE is given, for erasing the files without listing them. |
Forbidden contexts
NO USER, USER unless under :DUMPER
Execution
The macro issues its own error messaegs, and so it changes the reporting level to report displays only when it is entered. It then tests to see if at least one of ONLY, FROM, TO is present, and if not a message is sent to the monitoring file and the macro terminates.
If at least one of these parameters is present the macro issues RETRIEVE commands for the statistics files, and evaluates the start and finish parameters for listing and/or erasing the files. A display is given, naming the files on which the macro is operating. If FROM and TO are both included, displays are given naming which files between the limits do not exist.
If NOLIST is absent, PROGRAM LUNJ is loaded. Each statistics file is assigned to the program in turn, and the output is sent to a workfile. If the program does not HALT:-OK, a core print is taken. After all the files have been processed the workfile is listed.
If the ERASE parameter is given, when the files have been successfully listed (unless NOLIST was specified) the macro erases them.
The macro finally terminates with a display
"LISTUNJAMMING" CONCLUDED
and sets the reporting level to FULLBUT,COMMANDS.
Examples
LISTUNJAM ONLY25,ERASE
LISTUNJAM TO25
LISTUNJAM FROM1,NOLIST
LISTUNJAM FROM1,TO40,NOLIST,ERASE
Files Accessed
:DUMPER.PROGRAM LUNJ (Execute)
:DUMPER.UNJAMMER (Read)
Reporting Messages
"LISTUNJAMMING" STARTED
OPERATING ON FILE n
OPERATING ON FILES n TO m
UNJAMMER FILE n DOES NOT EXIST
UNJAMMER FILES n TO m DO NOT EXIST
LISTING PROGRAM LOADED
ERASE SEGMENT ENTERED
"LISTUNJAMMING" CONCLUDED
Error Messages
"TO" PARAM LESS THAN "FROM" NOT ALLOWED
NEGATIVE PARAMETER NOT ALLOWED
PARAMETER(S) MISSING
INCORRECT PARAMETER FORMAT
FILE SPECIFIED DOES NOT EXIST
PROGRAM IN ERROR - CORE PRINT GIVEN,BR>
UNANTICIPATED COMERR - PLEASE REPORT
Notes