FPAMSRV - FASTPAM management function

Macro type: type S (E form/L form/D form/C form/M form); see "Macro types"

General

This description begins with an overview of the complete format of the FPAMSRV macro with all possible operands. Regardless of which function is specified (in the FCT operand), all operands may be entered in an FPAMSRV macro; the operands to be evaluated are determined by the current FPAMSRV function. The individual functions of the FPAMSRV macro are listed in brief after the format overview.
The format for each function and the operands which are evaluated for it are described separately in each function unit.
Operand values that are not addresses or registers are identified in the operand descriptions as “direct specifications”.
The “direct specifications” are always listed in the operand descriptions if they are theoretically possible in the format, even if the user could not possibly know their value when programming (e.g. the value of an ID assigned by the system).

The various forms of the MF operand are described in detail in the appendix ("Macro types").

Parameter list

The parameter list of the macro contains a header, whose fields are loaded automatically when the list is created with the L form.

If a parameter list is to be created dynamically with the D or C form, it must be initialized beforehand with a parameter list created with the L form. This is the only way of ensuring that the header of a parameter list contains the correct information.

Format

Operation	Operands
FPAMSRV	[,FCT = *ENAENV / *ENAIPO / *OPEN / *CLOSE / *DISIPO /         *DISENV / adr / (r)] [,ENVNAME = 'name' / adr / (r)] [,IPONAME = 'name' / adr / (r)] [,IPOADDR = (elem1,elem2)] [,IPOSIZE = size / adr / (r)] [,ENVID = nmbr / adr / (r)] [,IPOID = nmbr / adr / (r)] [,OPENID = nmbr / adr / (r)] [,LINK = 'name' / adr / (r)] [,FILE = 'pathname' / adr / (r)] [,FILE = 'pathname' / adr / (r)] [,LASTBLK = nmbr / adr / (r)] [,ACCNUMB = number / 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 = nmbr / adr / (r)] [,BLKSIZE = size / 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]

Functions

Function	Brief description	See
FCT = *ENAENV	Create a FASTPAM environment or connect the user to an existing environment	"FASTPAM function: ENABLE ENVIRONMENT"
FCT = *ENAIPO	Create a FASTPAM I/O area pool or connect the user to an existing pool	"FASTPAM function: ENABLE IOAREA POOL"
FCT = *OPEN	Open a PAM file	"FASTPAM function: OPEN"
FCT = *CLOSE	Close a PAM file	"FASTPAM function: CLOSE"
FCT = *DISIPO	Disable a FASTPAM I/O area pool, i.e. remove a link to the pool and possibly delete it	"FASTPAM function: DISABLE IOAREA POOL"
FCT = *DISENV	Disable a FASTPAM environment, i.e. remove a link to the environment and possibly delete it	"FASTPAM function: DISABLE ENVIRONMENT"

Note

All addresses passed to FASTPAM must be valid 31-bit addresses. In particular, bit 32 must not be set, otherwise it will be regarded as belonging to the address.