%GENERATION (PL/I)

Returns a specific generation of a controlled variable in your program.

reference

A controlled variable.

expression

The generation number n of a controlled variable x, where:

1 ≤ n ≤ ALLOCATION(x)

To return the oldest instance of x, specify:

%GENERATION(x,1)

To return the most recent instance of x, specify:

%GENERATION(x,ALLOCATION(x))

Usage notes

You cannot use the %GENERATION built-in function while you replay recorded steps.

Refer to the following topics for more information related to the material discussed in this topic.