The entry point MAREN1PS is used for the program interface. In this mode, the statements to be issued to MARENADM and all accruing data and results are exchanged between the user program and MARENADM via storage areas. There is no data communication with the system files SYSDTA and SYSOUT.
The program interface does not provide access to the full range of MARENADM functions.The following MARENADM statements may not be used. The statements marked with (*) are standard SDF statements, see the “SDF Dialog Interface” manual [20]:
//CHECK-TSOSCAT
//COPY-VOLUME-CATALOG
//DELETE-VOLUME-ENTRY
//EDIT-MAREN-PARAMETERS
//EDIT-VOLUME-ATTRIBUTES
//EXECUTE-SYSTEM-COMMAND (*)
//HOLD-PROGRAM (*)
//MODIFY-ADMINISTRATION-SCOPE
//MODIFY-SDF-OPTIONS (*)
//MODIFY-TAPE-SET-ATTRIBUTES
//REMARK (*)
//RESET-INPUT-DEFAULTS (*)
//RESTORE-SDF-INPUT (*)
//SHOW-INPUT-DEFAULTS (*)
//SHOW-INPUT-HISTORY (*)
//SHOW-MAREN-FILE
//SHOW-MAREN-STATUS
//SHOW-SDF-OPTIONS (*)
//SHOW-VSNS
//STEP (*)
//UPDATE-MAREN-CATALOG
//VERIFY-MAREN-CATALOG
//WRITE-TEXT (*)
The following operand values are strictly prohibited:MAREN-PASSWORD=*SECRET
PASSWORD=*SECRET
VOLUME=<vsn list>
Instead, the corresponding statement must be issued individually for each archive number.
The following operand values must not be used with certain statements. If these operand values introduce a structure, no operand in that structure may be used:
OUTPUT=<filename>
in the statements REMOVE-USER-VOLUMES, RESERVE-FREE-VOLUME, SHOW-FREE-VOLUMES, SHOW-VOLUME-ATTRIBUTES
Any output files required can be created by the calling main program from the catalog entries provided by MAREN1PS.
SORT-MODE = *RESERVATION-COUNT / *LAST-ACCESS-DATE / *FREE-DATE
in the statement SHOW-FREE-VOLUMES
VOLUME=*BY-TSOSCAT
in the statement ADD-RESERVED-VOLUME
VOLUME=*ALL(INPUT-FILE=<filename>)
in the statement ADD-RESERVED-VOLUME
The catalog entries must be read from the input file by the main program and the archive numbers must be added individually with ADD-RES-VOL VOLUME= <vsn>. Attributes which have no operands in ADD-RES-VOL (e.g. CREATION-DATE) can then be assigned using the MODIFY-VOLUME-ATTR statement.
INIT-FILE=<filename>
in the statement FREE-VOLUMES
If an output file is to be created, INIT-FILE=*DUMMY must be specified. The MAREN catalog entries passed to the archive area by MAREN1PS must be output to a SAM file by the main program.
INIT-FILE=<filename>
in the statement INITIALIZE-VOLUMES
VOLUME=*BY-FILE
in the statements EXPORT-VOLUME, FREE-VOLUMES, RETURN-VOLUMES
VOLUME=*BY-INPUT-FILE
in the statement MODIFY-VOLUME-ATTRIBUTES
The main program must read the catalog entries from the input file, extract the archive number and the file sequence number, and supply these as values for the VOLUME and FILE-SEQ operands of the MODIFY-VOLUME-ATTRIBUTES statement.
VERSION=*LATEST / <integer -9999..0> / *NOT-CREATED
in the statement SHOW-VOLUME-ATTRIBUTES
TYPE-OF-VOLUMES=*VALID / *OBSOLETE
in the statement SHOW-VOLUME-ATTRIBUTES
BATCH-PROCESSING=*YES
in the statement PRINT-VOLUME-ATTRIBUTES
UPDATE=*TEMPORARY / *PERMANENT
in the statement PRINT-VOLUME-ATTRIBUTES
This applies to the UPDATE operand in each of the structures SELECT, SORT, and LAYOUT-CONTROL.
MESSAGE-DESTINATION=*PRINTER / *FILE
in the statements RETURN-VOLUMES, SECURE-FREE-VOLUMES
NUMBER-OF-VOLUMES > 1
in the statements RESERVE-FREE-VOLUME, SECURE-FREE-VOLUMES
This operand is not evaluated. As a rule, only a tape is processed. Otherwise the statement must be entered more than once.
SAVE-FILE-ID <> *ALL
in the statements