gtpo1m6vOperations

ZGAFA-Get File Pool Address

Use this command to:

  1. Get a file address from a long-term pool.
  2. Set the record at the file address to 0.
  3. Add a record ID to the header of the record. You can use this record ID to perform subsequent file operations on the record at the assigned file address.

Requirements and Restrictions

None.

Format




device
is a 4-character alphanumeric device name as defined in the ONLFIL SIP macro (for example, 3380 or DEVA).

pool
is one of the following pool types:

SLT
Small, long-term pool

LLT
Large, long-term pool

SDP
Small, long-term duplicate record pool

LDP
Large, long-term duplicate record pool.

Note:
The duplicate record pools are valid only for partially duplicated databases.

recid
is a 2-character alphanumeric record ID or a 4-digit hexadecimal record ID.

Additional Information

This command can be used only to obtain large or small, long-term pool addresses. Use the ZGAFI command to obtain 4-KB file pool addresses.

Examples

In the following example, a file address is obtained from the large, long-term duplicate record pool.

+--------------------------------------------------------------------------------+
|User:   ZGAFA DEVA LDP 00AB                                                     |
|                                                                                |
|System: GAFA0001I 09.05.41 GAFA DEVA LDP F.A.-000C0001                          |
+--------------------------------------------------------------------------------+

Related Information

See TPF Database Reference for more information about file pool support.