gtpg2m2l | General Macros |
This general macro assigns a storage block of specified size and type to an entry control block (ECB). The address and logical size of the storage block are placed in the specified core block reference word (CBRW) in the ECB.
Format
|
Notes:
Registers R0-R7 can be used for (reg).
When the ID keyword is coded and the RTP keyword is not used, the second positional parameter is used to define the record ID type. Valid types for this variant are:
In previous TPF releases, this parameter was either P, for primary pool type or O for overflow pool type. P and O are still valid for migration and correspond to 0 and 1 respectively.
For example, by coding FILL=00, a storage block allocated is initialized to X'00's.
If the FILL parameter is not specified, the storage block contents are unpredictable; unless the SYSTC tag SBCLEAR is set on. SBCLEAR set on indicates that the system is to clear all blocks (with zeros) when the blocks are assigned to the ECB. The FILL parameter has priority over the SBCLEAR setting.
Entry Requirements
Return Conditions
Programming Considerations
Users can add their block type equates to the list of types in the macro and avoid assembly errors when using non-standard equates. The addition is done by modifying the AIF test for legitimate types:
AIF ('&P2' NE 'L0' AND '&P2' NE 'L1' AND '&P2' NE 'L2' AND '&P2' NE 'L4').ERR7
The types provided by TPF (L0, L1, L2, and L4) should not be changed.
Examples
GETCC D6,SIZE=(R4)
GETCC D3,L2,COMMON=YES
GETCC D1,L4,FILL=00,COMMON=YES
GETCC D0,L1,FILL=00
GETCC DE,SIZE=LCP3880+LSSC
GETCC D5,(R0)
GETCC D1,L4,FILL=00,COMMON=PROTECTED
GETCC DECB=(R7),ID=C'AA',RTP=0