gtpg2m2nGeneral Macros

GETLC-Get Large File Storage Address

This general macro obtains an available file storage record address from a pool section of large records. The selection of a specific pool is based on the specified record ID. The address of the file storage record is stored into the file address reference word (FARW) of the specified data level.

Note:
This macro is provided for backward compatibility only. New programs should be written using the GETFC macro (see GETFC-Get File Pool Address and Storage Block).

Format




Notes:

  1. dummy

label
A symbolic name can be assigned to the macro statement.

Dx
An ECB data level (D0-DF) must be specified

dummy
This symbol is no longer required. However, it must be accounted for by inserting delimiting commas or a character such as an L or S as formerly required.

record_id
A 2-character record ID must be specified as parameter 3. The assembly program uses the given ID to generate the V-constant of the macro expansion. The V-constant is resolved by the linkage editor program. The resolution of this V-constant determines whether a long term, short term, or duplicate pool address is returned.

Entry Requirements

Return Conditions

Programming Considerations

Examples

GETLC D0,L,OM

The address of a storage block of type OM is put into the file address reference word for data level D0. Whether the block is from the long term pool or the short term pool depends on the definition of the OM record returned. The L is merely a placeholder and has no other meaning.