gtpo1m2iOperations

ZCHCH-Chain Chase Utility

Use this command to obtain a list of file pool addresses chained from a specific location in a specific record, and display each file pool address or only the last address in the chain.

Requirements and Restrictions

None.

Format




fileaddr
is the 8- or 16-digit hexadecimal file pool address of the record from which the chain chase begins.

F
chases the standard forward chains.

B
chases the standard backward chains.

U
chases the chain address at the location specified for displacement.

num
is the maximum number (1-999) of chained records to be chased.

displacement
is the 3-byte hexadecimal displacement (location) in the chain chase at which the file pool address of the next record in that chain chase is found.

HDR
specifies the type of standard header. Specify one of the following:

4
specifies that the records have a 4-byte standard header. If you specify this value, you can specify a 4-byte file address or an 8-byte file address in 4x4 format.

8
specifies that the records have an 8-byte standard header. If you specify this value, you can specify an 8-byte FARF6 address or an 8-byte file address in 4x4 format. Do not specify a 4-byte file address.

L
displays details about only the last record in the chain.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZCHCH HELP

ZCHCH ?

Examples

The examples that follow provide the following information:

 NR. 
is a 3-character record number.

 F.A. 
is the file pool address.

 I.D. 
is a record ID of 2 alphanumeric characters, a blank, and 4 hexadecimal characters.

The results of a forward chain chase are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZCHCH F4034035 F 002 HDR-4                                              |
|                                                                                |
|System: CRZ10010I 21.46.00 CHAIN CHASE-FORWARD                                  |
|                                                                                |
|        NR.       F.A.        I.D.                                              |
|                                                                                |
|        1   00000000F4034035  A3 C1F3                                           |
|        2   00000000F4034039  A3 C1F3                                           |
|        CHAIN CHASE LIMIT REACHED                                               |
|                                                                                |
|        2   RECORDS CHASED                                                      |
|                                                                                |
|        MORE RECORDS IN CHAIN                                                   |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The results of a backward chain chase are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZCHCH F4034035 B 002 HDR-4                                              |
|                                                                                |
|System: CRZ10011I 21.46.00 CHAIN CHASE-BACKWARD                                 |
|                                                                                |
|        NR.       F.A.        I.D.                                              |
|                                                                                |
|        1   00000000F4034035  A3 C1F3                                           |
|        2   00000000F4034031  A3 C1F3                                           |
|        CHAIN CHASE LIMIT REACHED                                               |
|                                                                                |
|        2   RECORDS CHASED                                                      |
|                                                                                |
|        MORE RECORDS IN CHAIN                                                   |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The results of a chain chase at the location specified for displacement are displayed in the following example. In this example, an 8-byte file address in 4x4 format and HDR-8 were specified; therefore, the 8-byte chain chase occurred.

+--------------------------------------------------------------------------------+
|User:   ZCHCH 00000000F4028801 U 002 064 HDR-8                                  |
|                                                                                |
|System: CRZ10012I 11.51.49 CHAIN CHASE-DISPL.064                                |
|                                                                                |
|        NR.       F.A.        I.D.                                              |
|                                                                                |
|        001 00000000F4028801  Y2 E8F2                                           |
|        002 00000000000C0001  Y2 E8F2                                           |
|        CHAIN CHASE LIMIT REACHED                                               |
|                                                                                |
|        002 RECORDS CHASED                                                      |
|                                                                                |
|        NO MORE RECORDS IN CHAIN                                                |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

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