PGFREEA — Free virtual storage contents

Description

Note: IBM® recommends that you use the PGSER macro rather than PGFREEA.

The PGFREEA macro makes virtual storage areas, below 16 megabytes, that were fixed by the PGFIXA macro eligible for page-out.

Syntax

The standard form of the PGFREEA macro is written as follows:

Syntax	Description

`name`	`name`: Symbol. Begin `name` in column 1.

␢	One or more blanks must precede PGFREEA.

PGFREEA

␢	One or more blanks must follow PGFREEA.

No additional parameters are specified.

Restrictions

Use of the PGFREEA macro is subject to the following restrictions:

The issuer of the PGFREEA must provide a fixed virtual subarea list (VSL) or chain of them, pointed to by register 1. For a description of the VSL, see z/OS MVS Programming: Authorized Assembler Services Guide.
The user must be in supervisor state, protection key 0.
The user must provide DSECTs for IHAPSA, CVT, and IHAPVT.

Output

If the PGFREEA is successful, all pages will be freed and register 15 will contain a return code of zero. If unsuccessful, all pages up to, but not including the one that caused the abend will be freed. The user will be abended with a system completion code of X‘171’.