REL request (REL) for the IMS installed level API

Use the REL function of the DFSGVRM API to release the storage that were returned by the CALL function for the output areas and that is no longer needed.

If the RETAREA register or the parameter list field GVRMP_A_OUTPUT_AREA is nonzero after the output area is returned by the CALL function, regardless of the return code the calling application must use the REL function to release the storage that were allocated for the output areas. The output area address is set to zero when the output area is not present on return.

Syntax for REL requests

Read syntax diagramSkip visual syntax diagramDFSGVRMFUNCTION=REL,AREA=( R1 - R12)

Parameters for REL requests

AREA=(R1-R12)
Specifies a register that contains the address of the output area to be released.

Return and reason codes for REL requests

When the DFSGVRM FUNC=REL request is made, IMS returns the return code in register 15 and the reason code in register 0.

Table 1. Return and reason codes for REL requests
Return code Reason code Meaning
X'00000000' X'00000000' The request completed successfully.
X'00000010' Return code from STORAGE RELEASE Unable to free the output area that is referred to by the AREA= parameter.
X'000010FF' Various An internal error occurred.