Your Browser is not longer supported

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

{{viewport.spaceProperty.prod}}

REMPLNK - Delete pool link name

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

By means of the REMPLNK macro, the user deletes either one specific pool link name or all pool link names from the job's pool table. The file linked to the pool link name must have been closed correctly before the pool link name can be deleted. If REMPLNK is issued for all names in the pool table, any pool link names linked to files which are still open are not deleted, but macro execution is regarded as successfully completed.

Formatt

Operation

Operands

REMPLNK

MF = L
,MODE = SINGLE
,LINKNAME = name /
        
ALL

MF = E,PARAM = adr / (r)

MF = D[,PREFIX = pre]

MF = C[,PREFIX = pre][,MACID = macid]

Operand descriptions

MACID

Evaluated only in conjunction with MF=C; defines the second through fourth characters of each field name and equate generated in the data area when the macro is expanded.

Default value:

MACID = ISR

= macid 
Three-character string defining the second through fourth characters of the generated field names and equates.

MF

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

MODE

Specifies whether one specific pool link name or all pool link names in the job's pool table are to be deleted.

= SINGLE
The user must specify a pool link name.The pool link name specified for LINKNME is to be deleted.

LINKNME = name
Specifies which pool link name is to be deleted. “name” is a pool link name defined by means of the ADDPLNK macro.

= ALL
All pool link names which are not linked to files which are still open are to be deleted.

PARAM

Specifies the address of the operand list; evaluated only in conjunction with MF=E (see "Macro types").

= addr
Symbolic address (name) of the operand list.

= (r)
Number of the register containing the address of the operand list. The register must be loaded with this address value before the macro is called.

PREFIX

Evaluated only in conjunction with MF=C or MF=D; defines the first character of each field name and equate generated in the data area when the macro is expanded.

Default value:

PREFIX = D

= pre
One-character prefix with which the field names and equates generated by the assembler are to begin.

Return codes

Unless otherwise specified, the field names and the EQU statements for the return codes generated by the C and D forms of the macro begin with the character string DISR, but this can be modified by PREFIX and MACID.

The return codes are stored in the standard header of the operand list.

Main return code

Meaning

DISROK X'0000'

The macro was executed successfully

DISRNPAR X'0001'

Access to the operand list was not possible

DISRNREM X'0002'

ISAM pools not supported on remote host

DISRINVN X'0003'

Catalog ID unknown

DISRNACC X'0004'

Catalog ID not accessible

DISRINVN X'0005'

The specified pool link name is invalid

DISRNANF X'0006'

The pool link name was not found

DISRPUSE X'0009'

The specified pool link name is linked to a file which is still open

DISDSYSE X'000B'

A system error occurred during macro execution

DISRRLNK X'FFFF'

The macro could not be executed (linkage error):
evaluate subsidiary return code 1