gtpg2m2pGeneral Macros

GETSC-Get Small File Storage Address

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

Format




Notes:

  1. dummy

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

Dx
Specify an ECB data level (D0-DF).

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

record_id
A 2-character record ID must be specified as parameter three. The assembly program will use the given ID to generate the V-constant of the macro expansion. The V-constant is resolved by the link editor program. The resolution of this V-constant determines whether a long, short, or duplicate address is dispensed.

Entry Requirements

Return Conditions

Programming Considerations

Examples

GETSC D0,L,OM

The address and size 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.