FPAMSRV - FASTPAM-Verwaltungsaufrufe formulieren

Makrotyp: S-Typ (E-Form/L-Form/D-Form/C-Form/M-Form, siehe "Typen von Makroaufrufen")

Allgemeines

Zunächst werden in einer Formatübersicht sämtliche Funktionsoperanden des Makros FPAMSRV dargestellt. Unabhängig von der angegebenen Funktion (Operand FCT) können bei einem FPAMSRV-Makro alle Operanden spezifiziert werden. Welche Operanden ausgewertet werden, hängt von der aktuellen FPAMSRV-Funktion ab. Im Anschluss an die Formatübersicht werden kurz die Funktionen des FPAMSRV-Makros aufgelistet. Das Format und die Operanden, die bei den einzelnen Funktionen ausgewertet werden, werden pro Funktionseinheit beschrieben.
Operandenwerte, die nicht Adress- und nicht Register-Angaben sind, werden in der Operandenbeschreibung als „direkte Angabe“ bezeichnet.
Die „direkte Angabe“ ist in der Operandenbeschreibung immer auch dann aufgeführt, wenn sie nur formal möglich ist, weil der Anwender den Wert bei dieser Angabe zum Programmierzeitpunkt noch nicht kennen kann (z.B. den Wert einer vom System vergebenen Kurzkennung).

Die Formen des MF-Operanden sind detailliert im Anhang ("Typen von Makroaufrufen") beschrieben.

Parameterliste

Die Parameterliste des Makros enthält einen Header, dessen Felder beim Aufbau der Parameterliste mithilfe der L-Form automatisch versorgt werden.

Wird eine Parameterliste mit der D-Form oder C-Form dynamisch aufgebaut, ist sie zuvor durch eine mithilfe der L-Form erzeugten Parameterliste zu initialisieren. Nur auf diese Weise ist eine korrekte Versorgung des Header einer Parameterliste gewährleistet.

Format

Operation	Operanden
FPAMSRV	[,FCT = *ENAENV / *ENAIPO / *OPEN / *CLOSE / *DISIPO /         *DISENV / adr / (r)] [,ENVNAME = 'name' / adr / (r)] [,IPONAME = 'name' / adr / (r)] [,IPOADDR = (elem1,elem2)] [,IPOSIZE = größe / adr / (r)] [,ENVID = zahl / adr / (r)] [,IPOID = zahl / adr / (r)] [,OPENID = zahl / adr / (r)] [,LINK = 'name' / adr / (r)] [,FILE = 'pfadname' / adr / (r)] [,FILE = 'pfadname' / adr / (r)] [,LASTBLK = zahl / adr / (r)] [,ACCNUMB = anzahl / adr / (r)] [,SHARUPD = *NO / *YES / adr / (r)] [,MODE = *INPUT / *INOUT / *OUTIN / adr / (r)] [,MAXIOLN = *NOT_SPECIFIED / *MINI / *MAXI / adr / (r)] [,EVENTNG = *NOT_SPECIFIED / *NO / *YES / adr / (r)] [,EIID = zahl / adr / (r)] [,BLKSIZE = größe / adr / (r)] [,RES = *NOT_SPECIFIED / *NO / *YE / adr / (r)] [,ENV = *HOST / *XCS / adr / (r)] [,LARGE_FILE = *FORBIDDEN / *ALLOWED / adr / (r)] MF = L
	MF = E,PARAM = adr / (r)
	MF = D[,PREFIX = F / pre]
	MF = C / M [,PREFIX = F / pre] [,MACID = PAM / macid]

Funktionen

Funktion	Kurzbeschreibung	siehe
FCT = *ENAENV	FASTPAM-Environment einrichten oder den Aufrufer an ein bestehendes anschließen	"Funktion ENABLE ENVIRONMENT"
FCT = *ENAIPO	FASTPAM-IO-Area-Pool einrichten oder den Aufrufer an einen bestehenden anschließen	"Funktion ENABLE IOAREA POOL"
FCT = *OPEN	PAM-Datei eröffnen	"Funktion OPEN"
FCT = *CLOSE	PAM-Datei schließen	"Funktion CLOSE"
FCT = *DISIPO	Verbindung zum FASTPAM-IO-Area-Pool lösen und ggf. FASTPAM-IO-Area-Pool abbauen	"Funktion DISABLE IOAREA POOL"
FCT = *DISENV	Verbindung zum FASTPAM-Environment lösen u. ggf. FASTPAM-Environment abbauen	"Funktion DISABLE ENVIRONMENT"

Hinweis

Alle an FASTPAM übergebenen Adressen müssen bereinigte 31-Bit-Adressen sein. Insbesondere darf das Bit 32 nicht gesetzt sein, da dies sonst als zur Adresse gehörend betrachtet wird.