gtpg2m2fGeneral Macros

GCFLC-Get Core Block and Large File Address.

This general macro is a combination of the control program macros GETLC and GETCC. This macro obtains an available large block of storage and an available large file storage address from the short or long term pool records indicated by the requested record id.

The address and size of the storage block is placed in the specified core block reference word (CBRW) of the specified ECB data level.

The address of the file record is inserted into the file address reference word (FARW) of the specified ECB 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
This parameter must be coded as an ECB data level D0-DF.

dummy
This is a dummy parameter that no longer has meaning. It is required to preserve the position of the parameter following. The value S or L can be used, or it may just be indicated with commas.

record_id
A valid record ID, the characteristics of which are used to determine whether a long term, short term, or duplicate file address is obtained.

Entry Requirements

Return Conditions

Programming Considerations

Examples

GCFLC  D0,L,OM

The address and size of a storage block of type OM is put into the core block 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.