Rational Developer for System z
Enterprise PL/I for z/OS, Version 4.2, Language Reference

Based storage and attribute

Extent specifications in BASED declarations
BASED VARYING string
Storage allocation for BASED variable
Locator variables
DEFINED and UNION attributes
INITIAL attribute
Locator data
POINTER variable and attribute
Built-in functions for based variables
ALLOCATE statement for based variables
FREE statement for based variables
REFER option (self-defining data)

A declaration of a based variable is a description of the generation: the amount of storage required and its attributes. (A based variable does not identify the location of a generation in main storage.) A locator value identifies the location of the generation. Any reference to a based variable that is not allocated is in error.

Read syntax diagramSkip visual syntax diagram>>-BASED--+---------------------+------------------------------><
          '-(locator-reference)-'
 
locator-reference
Identifies the location of the data.

When reference is made to a based variable, the data and alignment attributes used are those of the based variable, while the qualifying locator variable identifies the location of data.

A based variable cannot have the EXTERNAL attribute, but a locator reference for a based variable can have any storage class, including based.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)