Für die Programmschnittstelle wird der Entry MARENPS verwendet. Bei dieser Betriebsart werden die auszuführenden Anweisungen an MAREN übergeben sowie alle anfallenden Daten und Ergebnisse zwischen dem Benutzerprogramm und dem Benutzerprogramm MAREN über Speicherbereiche ausgetauscht. Es findet kein Datenverkehr mit den Systemdateien SYSDTA und SYSOUT statt.
Für die Benutzung der Programmschnittstelle steht nicht der volle Funktionsumfang des Benutzerprogramms MAREN zur Verfügung.
Folgende MAREN-Anweisungen dürfen nicht verwendet werden. Bei den mit „(*)“ markierten Anweisungen handelt es sich um SDF-Standardanweisungen, siehe Handbuch „Dialogschnittstelle SDF“ [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 (*)
Generell unzulässig sind folgende Operandenwerte:
PASSWORD=*SECRET NEW-PASSWORD=*SECRET VOLUME=<vsn list>
Ersatzweise muss die entsprechende Anweisung für jede einzelne Archivnummer gesondert aufgerufen werden.
Folgende Operandenwerte dürfen bei einzelnen Anweisungen nicht angegeben werden. Leiten diese Operandenwerte eine Struktur ein, so darf auch kein Operand dieser Struktur verwendet werden:
OUTPUT = <filename>
bei den Anweisungen RESERVE-FREE-VOLUME, SHOW-VOLUME-ATTRIBUTES evtl. benötigte Ausgabedateien können vom aufrufenden Hauptprogramm mit den von MARENPS gelieferten Katalogeinträgen erstellt werden.
VOLUME = *BY-FILE
bei der Anweisung EXPORT-VOLUME
VOLUME = *BY-INPUT-FILE
bei der Anweisung MODIFY-VOLUME-ATTRIBUTES
VERSION = *LATEST / <integer -9999..0> / *NOT-CREATED
bei der Anweisung SHOW-VOLUME-ATTRIBUTES
TYPE-OF-VOLUMES = *VALID / *OBSOLETE
bei der Anweisung SHOW-VOLUME-ATTRIBUTES
BATCH-PROCESSING = *YES
bei der Anweisung PRINT-VOLUME-ATTRIBUTES
UPDATE = *TEMPORARY / *PERMANENT
bei der Anweisung PRINT-VOLUME-ATTRIBUTES
Dies gilt für den UPDATE-Operanden in allen drei Strukturen SELECT, SORT und LAYOUT-CONTROL.
NUMBER-OF-VOLUMES = <integer 2..10>
bei der Anweisung RESERVE-FREE-VOLUME
Dieser Operand wird nicht ausgewertet. Es wird generell immer nur ein Band bearbeitet. Sonst muss die Anweisung mehrmals eingegeben werden.
SAVE-FILE-ID <> *ALL
bei allen Anweisungen