FASTPAM function: DISABLE IOAREA POOL

This function removes the link between the user and the I/O area pool. If the function is called by the last user, the I/O area pool is disabled. The I/O area pool is addressed by the short ID that is returned by ENABLE IOAREA POOL.

The DISIPO function evaluates only the function operands described below.

Format FCT=*DISIPO

Operation	Operands
FPAMSRV	[,FCT = *DISIPO / adr / (r)] [,IPOID = nmbr / adr / (r)] MF = L
	MF = E,PARAM = adr / (r)
	MF = D[,PREFIX = F / pre]
	MF = C / M [,PREFIX = F / pre] [,MACID = PAM / macid]

Operand descriptions

FCT

Defines the FASTPAM function to be executed.

Only a direct specification is allowed for the MF=L form.

= *DISIPO
Direct specification of the DISABLE IOAREA POOL function.

This function removes the link between the user and the I/O area pool. If the function is called by the last user, the I/O area pool is disabled. The I/O area pool is addressed by the short ID that is returned by ENABLE IOAREA POOL.

This function will not be executed if files using the I/O area pool are still open (return code FPAMOFI).

= addr
Symbolic address of a 1-byte field containing the value for the DISABLE IOAREA POOL function.

= (r)
Register containing the value for the DISABLE IOAREA POOL function.

IPOID

Designates the short ID of the I/O area pool to be disconnected or disabled.
If the same parameter list is used as for ENABLE IOAREA POOL, the short ID need not be specified, since it will already be contained in the FPAMIPID field of the parameter list.

Only a direct specification is allowed for the MF=L form.

= nmbr
Direct entry of a decimal numeric value for the short ID of the I/O area pool.

= addr
Address of a 4-byte field containing the short ID of the I/O area pool.

= (r)
Register containing the short ID of the I/O area pool.

MACID

See the description under the format FCT=*ENAENV on "FASTPAM function: ENABLE ENVIRONMENT".

MF

The forms of the MF operand are described in detail in the appendix on "Macro types".

PARAM

See the description under the format FCT=*ENAENV on "FASTPAM function: ENABLE ENVIRONMENT".

PREFIX

See the description under the format FCT=*ENAENV on "FASTPAM function: ENABLE ENVIRONMENT".

Possible return codes of the FASTPAM function FCT=*DISIPO

Standard header: ccbbaaaa

The following code relating to execution of the FPAMSRV macro is returned in the standard header (cc = SUBCODE2, bb = SUBCODE1, aaaa = MAINCODE):

X'cc'	X'bb'	X'aaaa'	Meaning
	X'00'	X'0000'	Function executed successfully.
	X'01'	X'0010'	Function not executed. Invalid short ID for the I/O area pool
	X'20'	X'0028'	Function not executed. System error. Run system diagnostics.
	X'40'	X'0036'	The *DISIPO/*DISENV function cannot be executed, since files opened with the corresponding I/O area pool or environment still exist.
	X'40'	X'0056'	A TU user is attempting to disable a FASTPAM I/O area pool created by a privileged user.