gtpo1m1v | Operations |
Use this command to display path information for a specific structure of a collection. Use the ZBROW PATH command to display the following:
Requirements and Restrictions
Format
|
You can specify the beginning characters of a key if a partial search is desired.
Additional Information
For nonunique collections and partially specified keys, the path information for the first key found will be retrieved.
Examples
In the examples that follow, the ZBROW QUALIFY command with the SET parameter specified was issued to set the data store qualification to FAP.BSS before the examples were created.
The following example shows the path display for a DS_INVENTORY partial key of 18003465. The following fields may be included in displays of key path entries:
The first pair of lines in the display show the entry for the root index record of the index structure. These lines show the first 16 bytes of the highest key of the collection itself. The next pair of lines show the actual high key of the path that will be followed through the index structure for the specified key. This is the entry from the root, and the specified RRN is the RRN of the next index record in the path. The next entry is the entry from that index record and contains the high key of the data record that would contain the specified data entry for the given key if it exists. Because there is only one TYPE-I display line, the index structure is only two records deep (the root record and the intermediate index record), and the data record would be the third record read.
Because keys can be a maximum of 256 bytes in length and, therefore, would not fit on an output line, the display shows only the first 16 bytes of both the highest key in the root and the first key in the path. Thereafter, the display will show the first 14 bytes of the following keys starting at the first character that is different from the previous key. The first number in the display line is the displacement of the first different character. So, for the TYPE-D line, the displacement of the first different character is 2 and then the next 14 characters are displayed. If no characters are different, the displacement value will be 0 and the full first 16 characters will be displayed.
+--------------------------------------------------------------------------------+ |User: ZBROW PATH KEY DS_INVENTORY KEY-X%18003465 | |System: BROW0602I 16.45.53 BROWSER QUALIFIED FOR DSNAME FAP.BSS | | BROW0801I 16.45.54 PATH FOR SPECIFIED KEY FOR COLLECTION DS_INVENTORY | | | | ROOT KEYLENGTH - 16 RRN-0 | | 00 1801F26F 00000000 00000000 B031C597 ..2?..........Ep | | TYPE - I NEXT RRN-24C | | 00 18003526 00000000 00000000 B031477B ...............# | | TYPE - D NEXT RRN-273 | | 02 3470 00000000 00000000 B03146E7 .............X | | END OF DISPLAY | | | | BROW0410I 16.45.54 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The following example shows the path display for a DS_INVENTORY partial key of the highest key value of 1801F26F:
+--------------------------------------------------------------------------------+ |User: ZBROW PATH KEY DS_INVENTORY KEY-X%1801F26F | |System: BROW0602I 16.58.40 BROWSER QUALIFIED FOR DSNAME FAP.BSS | | BROW0801I 16.58.40 PATH FOR SPECIFIED KEY FOR COLLECTION DS_INVENTORY | | | | ROOT KEYLENGTH - 16 RRN-0 | | 00 1801F26F 00000000 00000000 B031C597 ..2?..........Ep | | TYPE - I NEXT RRN-261 | | 00 1801F26F 00000000 00000000 B031C597 ..2?..........Ep | | TYPE - D NEXT RRN-2F1 | | 00 1801F26F 00000000 00000000 B031C597 ..2?..........Ep | | END OF DISPLAY | | | | BROW0410I 16.58.40 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The index structure for the DS_INVENTORY collection for the key starting with hexadecimal string B0309868 using the TIME_INDEX3 key path is displayed in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW PATH KEY DS_INVENTORY KEYP-TIME_INDEX3 KEY-X%B0309868 | |System: BROW0602I 10.06.07 BROWSER QUALIFIED FOR DSNAME FAP.BSS | | BROW0801I 10.06.07 PATH FOR SPECIFIED KEY FOR COLLECTION DS_INVENTORY | | TYPE - I KEYLENGTH - 12 RRN-E7D | | 00 B030ACE8 B1481B56 03128A01 ...Y........ | | TYPE - D KEYLENGTH - 12 RRN-DD8 | | 02 9A85 B1481B14 DA8C6C01 .e......%. | | END OF DISPLAY | | | | BROW0410I 10.06.07 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The RRN of the data record and the displacement in the data object of the first byte of the array entry for index 120 is displayed in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW PATH INDEX ARRAY1 120 | | | |System: BROW0602I 10.15.14 BROWSER QUALIFIED FOR DSNAME FAP.BSS | | BROW0803I 10.15.14 INFORMATION FOR INDEX 120 FOR COLLECTION ARRAY1 | | | | RRN - 6 DISPLACEMENT - 5C4 | | END OF DISPLAY | | | | BROW0410I 10.15.14 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The RRN of the data record and the displacement in the data object for RBA 12AB0 is displayed in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW PATH RBA BLOB1 12AB0 | | | |System: BROW0602I 10.17.05 BROWSER QUALIFIED FOR DSNAME FAP.BSS | | BROW0804I 10.17.05 INFORMATION FOR RBA 12AB0 FOR COLLECTION BLOB1 | | | | RRN - 12 DISPLACEMENT - EC4 | | END OF DISPLAY | | | | BROW0410I 10.17.05 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The RRN path for the DS_INVENTORY collection for RRN 8D is displayed in the following examples. The TYPE value describes the type of index entry, as follows:
Directory entries are shown in standard or expanded format. Standard format indicates that file addresses are stored in 4-byte fields and expanded format indicates that file addresses are stored in 8-byte fields.
The directory entries in the following example are shown in standard format.
+--------------------------------------------------------------------------------+ |User: ZBROW PATH RRN DS_INVENTORY 8D | | | |System: BROW0602I 17.12.33 BROWSER QUALIFIED FOR DSNAME FAP.BSS | | BROW0802I 17.12.33 PATH FOR RRN 8D FOR COLLECTION DS_INVENTORY | | | | TYPE - S DISPLACEMENT - 4C | | DIRECTORY - 00000040 180000B5 180000B6 00000000 | | TYPE - R DISPLACEMENT - 1F4 | | DIRECTORY - 00020040 1800069A 1800069B 00000000 | | TYPE - I DISPLACEMENT - 10 | | DIRECTORY - 00000040 1801CE18 1801CE19 00000000 | | TYPE - D DISPLACEMENT - 7C0 | | DIRECTORY - 00000040 1801C43A 1801C43B 00000000 | | END OF DISPLAY | | | | BROW0410I 17.12.33 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The directory entries in the following example are shown in expanded format.
+--------------------------------------------------------------------------------+ |User: ZBROW PATH RRN DS_INVENTORY 8D | | | |System: BROW0602I 17.12.33 BROWSER QUALIFIED FOR DSNAME FAP.BSS | | BROW0802I 17.12.33 PATH FOR RRN 8D FOR COLLECTION DS_INVENTORY | | | | TYPE - S DISPLACEMENT - 4C | | DIRECTORY - 00008040 00000000 180000B5 00000000 | | 180000B6 00000000 | | TYPE - R DISPLACEMENT - 1F4 | | DIRECTORY - 00028040 00000000 1800069A 00000000 | | 1800069B 00000000 | | TYPE - I DISPLACEMENT - 10 | | DIRECTORY - 00008040 00000000 1801CE18 00000000 | | 1801CE19 00000000 | | TYPE - D DISPLACEMENT - 7C0 | | DIRECTORY - 00008040 00000000 1801C43A 00000000 | | 1801C43B 00000000 | | END OF DISPLAY | | | | BROW0410I 17.12.33 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
Related Information