GXLFST31 (GXLFST64) — free memory

Description

This service frees an area of memory previously obtained by the GXLGST31 (GXLGST64) service.

Performance Implications

There are no performance implications.

Syntax

call gxlfst31,(sys_svc_parm,
              memory_addr,
              memory_len,
              exit_diag_code,
              return_code 
              reason_code)

Parameters

sys_svc_parm

Supplied parameter

Type:: Address
Length:: Fullword (Doubleword)

The address of the system service parameter that was passed to the z/OS XML parser at initialization time.

memory_addr

Supplied parameter

Type:: Address
Length:: Fullword (Doubleword)

The address of a fullword (doubleword) that contains the address of the memory to be freed.

memory_len

Supplied parameter

Type:: Integer
Length:: Fullword (Doubleword)

A fullword (doubleword) that contains the length of the memory to be freed. Memory will always be freed in the same quantities under which it was allocated.

exit_diag_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword where the exit can store any diagnostic information (usually a reason code).

return_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword where the exit service stores the return code.

reason_code

Returned parameter

Type:: Integer
Length:: Fullword

The name of a fullword where the exit service stores the reason code.

Return and Reason Codes:

The z/OS XML parser uses the convention that the exit will provide a return code value of zero when successful. Any nonzero value indicates failure.

For reason code descriptions, see Reason codes listed by value.

Example

For an example using this exit service, see GXLEFRM (GXLFST example). These examples are located in SYS1.SAMPLIB .

Default Implementation

The z/OS XML parser will free all memory obtained. Memory is freed in the same quantities under which it was allocated. See the MVS™ assembler services reference (SA22-7606) for more details on the STORAGE macro.