Privilege ADA, DA, administrator without domains
Without the help of other MAREN components, this statement displays information from the MAREN catalog files.
Format
SHOW-MAREN-FILE Alias: SHMF |
| FILE-NAME = *MARENCAT / *MARENLOG / <filename 1..54> |
Operands
FILE-NAME =
FILE-NAME = *MARENCAT
Entries from the current MAREN catalog will be displayed.
FILE-NAME = *MARENLOG
Entries from the current MAREN log file will be displayed.
FILE-NAME = <filename 1..54>
Name of the file from which the MAREN catalog entries are to be displayed.
The following files can be read:
Volume catalog
The current volume catalog of MAREN and any number of copies of it can be assigned.Logging files
Here, too, the current open logging file or an older logging file (perhaps compiled from a number of individual files) can be used.Output files
These are files which contain full catalog entries in MAREN format, and which can be created using various MAREN and MARENADM statements.//SHOW-VOLUME-ATTRIBUTES OUTPUT=<filename>
Possible applications
Here are a selection of possible applications for SHOW-MAREN-FILE:
Information can be retrieved from the MAREN catalog even if the MARENCP control program crashes.
The output files generated by various statements (e.g. RESERVE-FREE-VOLUME) can be evaluated.
The logging files make it easy to check all accesses to a tape.
The catalog entries and MAREN parameters are output in the same format as in the statements SHOW-VOLUME-ATTRIBUTES VOL=<vsn> and SHOW-MAREN-PARAMETERS.
Once the statement has been issued, various input alternatives are offered depending on the specified file type (volume catalog, logging file, or output file).
Notes
Once a file name is entered, the associated file is checked. Various file attributes are checked to determine whether the file is a catalog file, and if so, what type it is. In the case of a volume catalog or a logging file, the file is opened in SHARED-UPDATE=YES mode to make it possible to access current catalog files.
If the file is a volume catalog, the MAREN parameters are listed (these are always in the first record in the volume catalog) and the following prompt is displayed:
MARM1E2 ENTER: VSN / POS(VSN) / +N / -N / ++ / -- / 'ETX' / END
If a logging file has been assigned, the following prompt is displayed without prior output:
MARM1E3 ENTER: FROM=VSN / LIST=VSN / VSN / +N / -N / ++ / -- / 'ETX' / END
If the file is an output file, the first catalog entry it contains is displayed. The following prompt is then output:
MARM1E1 ENTER: +N / -N / ++ / -- / 'ETX' / END; RECORD COUNTER = '(&00)'
In the case of MAREN output files in SAM format, the RECORD COUNTER catalog entry field indicates how many records were read from the file by the last action carried out. The number of catalog entries in the output file can thus be determined easily by entering “++” (position to end of file).
The following parameters can be used with all types of input files:
| Parameters | Action / notes |
| +n | Starting at the current position and working towards the end of the file, read the next “n” records and display the current record (n = max. 6-digit number). |
| -n | Starting at the current position and working towards the top of the file, read the next “n” records and display the current record (n = max. 6-digit number). |
| ++ | Display the last record in the file. |
| -- | Display the first record in the file. |
| 'ETX' | (Same as  ) Working towards the end of the file, display the next record (corresponds to entering “+1”). |
| END | End the display. Other MARENADM statements can then be entered. |
The following parameters can also be specified if the input file is a volume catalog:
| Parameters | Action / note |
| vsn | Display the first record in the input file with the specified archive number e.g. TAPE01). |
| POS(vsn) | Position to the specified VSN in the volume catalog and read the next record. The catalog entry may refer to the archive number specified or, if this does not exist, to the next highest archive number. |
The following parameters can also be specified for logging files in addition to those supported by all file types:
| Parameters | Action / note |
| vsn | Display the first logging entry for the specified archive number. |
| FROM=vsn | Display a brief summary of all logging entries beginning with the specified archive number. The logging entries are sorted chronologically within the individual VSN and file sequence number. |
| LIST=vsn | Display a brief summary of all logging entries for the specified archive number. The entries are listed in the order in which they were created. |
If the display is longer than the screen length for the FROM=<vsn> and LIST=<vsn> parameters, it can be interrupted by pressing the 
key.
If a FREE-POOL record is found while paging, the message is output instead of the output mask:
MARM214 FREE-POOL-NAME '(&00)', LAST ACCESS FUNCTION NAME '(&01)', FUNCTION NUMBER '(&02)'
Setting task switch 5 causes catalog entries and MAREN parameters to be listed line by line in interactive mode rather than in a single display screen. This improves the readability of entries in SYSOUT logs. In batch mode, output is on a line-by-line basis.
Outputting logging records
In the case of logging records, the catalog entry they contain is output first, followed by the logging information. The latter shows when the logging record was written and on which pubset. Example:
** LOGGING RECORD WRITTEN AT DATE: <date> AT TIME: <time> ON PVS: PI1B **
If all records relating to a particular archive number or to a number of archive numbers starting with a specific archive number are to be listed (parameter LIST=vsn or FROM=vsn), the list is limited to a few catalog entry fields. Catalog entries are not shown in full.
The following information is provided (where each line begins with the abbreviation which appears in the header):
| VOLUME FSEQ C# FUNCNAME FF LOG-DATE LOG-TIME C-ID HOSTNAME STA DV MN TSN RES# | - Archive number (VOLUME) - File sequence number (FILE-SEQUENCE) - Check number (CHECK-COUNT) - Function name of the last access (LAST-ACCESS-FUNCTION-NAME) - Function flag for the last access (LAST-ACCESS-FUNCTION-FLAG) - Date on which the logging entry was created - Time at which the logging entry was created - Catalog ID of the pubset on which the logging entry was written - Name of the system on which the tape was last processed - Status of the tape (VOLUME-STATUS) - Device type (DEVICE-TYPE) in internal format - Mnemonic name of the device on which the tape was last processed (DEVICE-NAME) - TSN of the task which last processed the tape (LAST-ACCESS-TSN) - Reservation counter of the tape (RESERVATION-COUNT) |
Example
In this example, the following information from the file $SYSMAREN.MARENLOG.14 is displayed:
after pressing
, the first logging record for the tape “A00001”after entering LIST=TST001, all logging entries for the tape “TST001” in abbreviated form
show-maren-file :data:$sysmaren.marenlog.14
|
The display is terminated with END.