gtpo1m1y | Operations |
Use this command to manage recoup indexes, which describe the location of embedded file addresses and persistent identifiers (PIDs) in collections. With this command, you can:
Requirements and Restrictions
Format
|
See TPF Database Reference for more information about the format of the file addresses embedded in collections.
Additional Information
None.
Examples
An entry is added to recoup index INDEX001 in data store TESTX.DS in the following example. The entry has a key of TOKEN001 and indicates that all user collections associated with this recoup index are either homogeneous or a BLOB. If the collection is homogeneous, there is a PID at displacement 0 of each element; if the collection is a BLOB, there is a PID at displacement 0.
In this example, the ZBROW QUALIFY command is shown only to make the example more complete. You only have to enter the ZBROW QUALIFY command once; you do not have to enter the command again until the target data store needs to change to another data store.
+--------------------------------------------------------------------------------+ |User: ZBROW QUAL SET DS-TESTX.DS | | | |System: BROW0607I 10.56.31 QUALIFICATION PROCESSING COMPLETED | | | |User: ZBROW RECOUP ADD INDEX001 ETOK-TOKEN001 DISP-0 ETYPE-PID | | | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TESTX.DS | | BROW1011I 10.56.43 RECOUP INDEX ENTRY SUCCESSFULLY ADDED | | | +--------------------------------------------------------------------------------+
Recoup index INDEX001 is created in the following example to describe a homogeneous collection.
+--------------------------------------------------------------------------------+ |User: ZBROW RECOUP DEFINE INDEX001 HOMOG DESC-PRIMARY_INDEX | | | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TESTX.DS | | BROW1012I 10.56.43 RECOUP INDEX SUCCESSFULLY DEFINED | | | +--------------------------------------------------------------------------------+
Recoup index INDEX001 is deleted in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW RECOUP DELETE INDEX001 | | | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TESTX.DS | | BROW1013I 10.56.43 RECOUP INDEX SUCCESSFULLY DELETED | | | +--------------------------------------------------------------------------------+
The contents of recoup index INDEX001 in data store TPFDB are displayed in the example that follows. The display shows the recoup index header and each entry in the recoup index, where:
The following fields, which are not shown in this example, are included with displays for heterogeneous recoup indexes:
+--------------------------------------------------------------------------------+ |User: ZBROW RECOUP DISPLAY INDEX001 | | | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TPFDB | | BROW1001I 10.56.43 RECOUP INDEX DISPLAY | | NAME - INDEX001 | | PID - 0002FC16 AF798883 E3D7C6C4 C2404040 | | 18036D0B 18036D0C 00000000 00000000 | | DESC - PRIMARY_INDEX | | TYPE - HOMOGENEOUS CONTROL - NONE | | TOKEN - C1C3E3F0F0F14040 TYPE-PID DISPL-40 | | TOKEN - C1C3E3F0F0F24040 TYPE-PID DISPL-6F | | END OF DISPLAY | | BROW1014I 10.56.43 RECOUP INDEX DISPLAY SUCCESSFUL | | | +--------------------------------------------------------------------------------+
The names of all recoup indexes defined in a data store are shown in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW RECOUP DISPLAY ALL | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TPFDB | | BROW1001I 10.56.43 RECOUP INDEX DISPLAY | | INDEX001 | | INDEX002 | | INDEX003 | | INDEX004 | | INDEX005 | | IT00000 | | IT00002 | | IT00003 | | IT00004 | | END OF DISPLAY | | BROW1014I 10.56.43 RECOUP INDEX DISPLAY SUCCESSFUL | +--------------------------------------------------------------------------------+
Recoup index INDEX001 is associated with the MYCOLLECT collection in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW RECOUP LINK MYCOLLECT INDEX001 | | | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TESTX.DS | | BROW1015I 10.56.43 RECOUP INDEX SUCCESSFULLY LINKED | | | +--------------------------------------------------------------------------------+
The index entry corresponding to a key of TOKEN001 in recoup index INDEX001 is removed in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW RECOUP REMOVE INDEX001 ETOK-TOKEN001 | | | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TESTX.DS | | BROW1016I 10.56.43 RECOUP INDEX ENTRY SUCCESSFULLY REMOVED | | | +--------------------------------------------------------------------------------+
The recoup index associated with the MYCOLLECT collection is disassociated with the collection in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW RECOUP UNLINK MYCOLLECT | | | |System: BROW0602I 10.56.43 BROWSER QUALIFIED FOR DSNAME TESTX.DS | | BROW1017I 10.56.43 RECOUP INDEX SUCCESSFULLY UNLINKED | | | +--------------------------------------------------------------------------------+
Related Information