MAREN V12.6 (en)

&pagelevel(4)&pagelevel

The entry point MARENPS is used for the program interface. In this mode, the statements to be issued to MAREN and all accruing data and results are exchanged between the user program and the user program MAREN 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 functions of the MAREN user program.

The following MAREN statements may not be used. Those marked with “(*)” are standard SDF statements, see also the “SDF Dialog Interface” manual [9]):

//CHECK-TSOSCAT

              //EDIT-VOLUME-ATTRIBUTES

              //EXECUTE-SYSTEM-COMMAND (*)

              //HOLD-PROGRAM (*)

              //MODIFY-SDF-OPTIONS (*)

              //MODIFY-TAPE-SET-ATTRIBUTES

              //REMARK             (*)

              //RESET-INPUT-DEFAULTS (*)

              //RESTORE-SDF-INPUT  (*)

              //SHOW-INPUT-DEFAULTS (*)

              //SHOW-INPUT-HISTORY (*)

              //SHOW-SDF-OPTIONS   (*)

              //STEP               (*)

              //WRITE-TEXT         (*)

The following operand values are strictly prohibited:

PASSWORD=*SECRET

              NEW-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 RESERVE-FREE-VOLUME, SHOW-VOLUME-ATTRIBUTES
Any output files required can be created by the calling main program from the catalog entries provided by MARENPS.

VOLUME = *BY-FILE

in the statement EXPORT-VOLUME

VOLUME = *BY-INPUT-FILE

in the statement MODIFY-VOLUME-ATTRIBUTES

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.

NUMBER-OF-VOLUMES = <integer 2..10>

in the statement RESERVE-FREE-VOLUME
This operand is not evaluated. As a rule, only a tape is processed. Otherwise the statement should be issued more than once.

SAVE-FILE-ID <> *ALL

in the statements

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

Program interface