gtpo1m1r | Operations |
Use this command to display information about the specified collection and to perform maintenance on the specified collection.
Requirements and Restrictions
Format
|
Notes:
If you enter ZBROW COL RECONSTRUCT and it fails, enter a ZBROW COLLECTION command specifying the VALIDATE parameter for the collection and determine which chains are corrupt. Depending on the response to the ZBROW COLLECTION command with the VALIDATE parameter specified, you may either have to enter a ZBROW COLLECTION command with the RECONSTRUCT parameter specified for a different chain, or you may have to manually repair one of the chains using the ZAFIL command before attempting to enter the ZBROW COLLECTION command with the RECONSTRUCT parameter specified.
Additional Information
Examples
The attributes of the BANK1_DS inventory collection are displayed in the following example.
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-BANK1_DS | | | |System: BROW0607I 08.36.31 QUALIFICATION PROCESSING COMPLETED | | | |User: ZBROW COL ATTR DS_INVENTORY | | | |System: BROW0602I 10.11.38 BROWSER QUALIFIED FOR DSNAME TPFDB | | BROW0406I 10.11.38 COLLECTION ATTRIBUTES DISPLAY | | ATTRIBUTE VALUE | | COLLECTION CLASS NAME - OIDinventory | | PART NAME ********** OIDentry | | CLASS NAME ** OBJECT | | OBJECT_ID 00000034 | | OBJECT_LGH 00000742 | | OBJECT_SEQ_CTR 0000000F | | CLASS NAME ** ObjectPart | | OBJ_Part_CHANGE 00 | | OBJ_Part_RESERVE2 000000 | | OBJ_Part_PartID 00000000 | | OBJ_Part_OIE 00812288 | | CLASS NAME ** OIDentry | | OIDentry_OID 0002FC16 AF44D6F9 E3D7C6C4 C2404040 | | **** 1802F078 1802F079 00000000 00000000 | | OIDentry_Class_Value 00000000 00000000 00000000 00000000 | | **** 00000000 00000000 00000000 00000000 | | MORE DATA AVAILABLE, ENTER ZPAGE TO CONTINUE | +--------------------------------------------------------------------------------+
Collection MY_BROWSE is captured in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW COL CAPT MY_BROWSE | | | |System: COSK0079A 14.39.19 *CP* HPN MOUNT ARB TAPE FOR OUTPUT | | | |User: ZTMNT ARB F32 AO BP | | | |System: COTM0008W 14.40.33 TMNT HPN DEVICE F32 VSN A00139 | | UNEXPIRED FILE OVERWRITTEN | | COTM0310I 14.40.33 TMNT HPN TAPE ARB MOUNTED ON DEVICE F32 | | VSN A00139 G0011 S0001 F38K SL NOBLK NOCOMP | | COTC0300A 14.41.30 TCLS HPN REMOVE ARB FROM DEVICE F32 | | VSN A00139 G0011 S0001 F38K SL NOBLK NOCOMP | | BROW0650W 14.39.19 BROWSER NOT QUALIFIED, TPFDB ASSUMED | | BROW0602I 14.39.19 BROWSER QUALIFIED FOR DSNAME TPFDB | | BROW0421I 14.41.30 COLLECTION MY_BROWSE SUCCESSFULLY CAPTURED | | BROW0419I 14.41.30 CAPTURE COMPLETED | +--------------------------------------------------------------------------------+
Collection OLDCOL is copied in the following example to a new collection called NEWCOL.
+--------------------------------------------------------------------------------+ |User: ZBROW COL COPY OLDCOL NEWCOL | | | |System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS | | BROW0303I 08.38.57 COLLECTION NAME SUCCESSFULLY DEFINED | | BROW0417I 08.38.57 COLLECTION COPIED SUCCESSFULLY | | BROW0411I 08.38.57 COPY COMPLETED | +--------------------------------------------------------------------------------+
Collection OLDCOL is copied using the specified data definition to a new collection called NEWCOL in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW COL COPYDD OLDCOL NEWCOL MYDD | | | |System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS | | BROW0303I 08.38.57 COLLECTION NAME SUCCESSFULLY DEFINED | | BROW0411I 08.38.57 COPY COMPLETED | +--------------------------------------------------------------------------------+
Collection USER_110154687 is deleted in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW COL DELETE USER_110154687 | | | |System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS | | BROW0415I 08.38.57 COLLECTION MARKED FOR DELETION | | BROW0412I 08.38.57 DELETE COMPLETED | +--------------------------------------------------------------------------------+
The following example causes TPFCS to dump the contents of collection DS_INVENTORY to a printer.
+--------------------------------------------------------------------------------+ |User: ZBROW COL DUMP DS_INVENTORY | | | |System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS | | BROW0410I 08.38.57 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
All pending deletes are processed for data store BANK1_DS and all entries are removed from the DS_DELETED collection in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW COL EMPTY DS_DELETED | | | |System: BROW0602I 11.15.33 BROWSER QUALIFIED FOR DSNAME BANK1_DS | | BROW0415I 11.15.33 COLLECTION HAS BEEN EMPTIED | | BROW0426I 11.15.33 EMPTY PROCESSING COMPLETED | +--------------------------------------------------------------------------------+
In the following example, collection OLDCOL is migrated to a new collection called NEWCOL, which uses new pools in its current format.
+--------------------------------------------------------------------------------+ |User: ZBROW COL MIGRATE OLDCOL NEWCOL | | | |System: BROW0602I 11.37.52 BROWSER QUALIFIED FOR DSNAME OLDCOL | | BROW0303I 11.37.52 COLLECTION NAME SUCCESSFULLY DEFINED | | BROW0423I 11.37.52 COLLECTION MIGRATED SUCCESSFULLY | | BROW0424I 11.37.52 MIGRATION PROCESSING COMPLETED | | | +--------------------------------------------------------------------------------+
The class name of the BANK1_DS inventory collection is displayed in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW COL NAME DS_INVENTORY | | | |System: BROW0602I 10.09.29 BROWSER QUALIFIED FOR DSNAME TPFDB | | BROW0407I 10.09.30 COLLECTION NAME DISPLAY | | COLLECTION CLASS NAME - OIDinventory | | BROW0410I 10.09.30 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The parts of the BANK1_DS inventory collection are displayed in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW COL PARTS DS_INVENTORY | | | |System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS | | BROW0403I 08.38.57 COLLECTION PARTS DISPLAY | | PART NAME | | 0 OIDentry | | 1 OIDinventory | | 2 MemKey | | BROW0410I 08.38.57 BROWSE OF COLLECTION COMPLETED | +--------------------------------------------------------------------------------+
The BANK1_DS inventory is being reclaimed in the following example.
+--------------------------------------------------------------------------------+ |User: ZBROW COL RECLAIM DS_INVENTORY | | | |System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS | | BROW0413I 08.38.57 RECLAIM COMPLETED | +--------------------------------------------------------------------------------+
In the following example, the structure of collection MYCOLLECT is verified and the internal directory structure of the collection is automatically reconstructed.
+--------------------------------------------------------------------------------+ |User: ZBROW COL RECONSTRUCT MYCOLLECT DIRECTORY | | | |System: BROW0650W 12.41.48 BROWSER NOT QUALIFIED, TPFDB ASSUMED | | BROW0602I 12.41.48 BROWSER QUALIFIED FOR DSNAME TPFDB | | BROW0404I 12.41.49 RECONSTRUCTION REPORT DISPLAY | | PID: 0002FC16 AF4469DD E3D7C6C4 C2404040 _ | | 1802F104 1802F105 00000000 00000000 | | | | ACTION ID DESCRIPTION | | RECN1100 - ALLOCATED DIRECTORY CHAIN RECONSTRUCTED. | | CHAIN LENGTH IS 00000001 | | END OF DISPLAY | +--------------------------------------------------------------------------------+
Collection MY_BROWSE is restored in the following example.
+---------------------------------------------------------------------------------------------+ |User: ZBROW COL RESTORE MY_BROWSE HIS_BROWSE | | | |System: TPXD0001A 14.42.13 LOAD TAPE VOLUME A00139 INTO DRIVE 0f32 MOUNTED AS ARA | | COSK0079A 14.42.13 *CP* HPN MOUNT ARA TAPE FOR INPUT | | | |User: ZTMNT ARA F32 AI | | | |System: COTM0310I 14.42.57 TMNT HPN TAPE ARA MOUNTED ON DEVICE F32 | | VSN A00139 G0012 S0001 F38K SL NOBLK | | BROW0650W 14.42.13 BROWSER NOT QUALIFIED, TPFDB ASSUMED | | BROW0602I 14.42.13 BROWSER QUALIFIED FOR DSNAME TPFDB | | BROW0422I 14.43.57 COLLECTION MY_BROWSE SUCCESSFULLY RESTORED AS HIS_BROWSE | | BROW0420I 14.43.57 RESTORE COMPLETED | +---------------------------------------------------------------------------------------------+
In the following example, the structure of collection DICT2 is verified.
+--------------------------------------------------------------------------------+ | User: ZBROW COL VALIDATE DICT2 | | | | System: BROW0602I 09.29.26 BROWSER QUALIFIED FOR DSNAME TO2KEYP | | BROW0402I 09.29.32 VALIDATION REPORT DISPLAY | | PID: 0200FC16 B1ADD50F E3D6F2D2 C5E8D740 | | 1800E0B8 00000000 00000000 00000000 | | | | ACTION ID DESCRIPTION | | VALD0000 - VALIDATE FOUND NO STRUCTURAL ERRORS | | ON ALLOCATED DIRECTORY CHAIN. | | VALD0000 - VALIDATE FOUND NO STRUCTURAL ERRORS | | ON ALLOCATED DATA CHAIN. | | VALD0000 - VALIDATE FOUND NO STRUCTURAL ERRORS | | ON ALLOCATED KEY CHAIN. | | VALD0000 - VALIDATE FOUND NO STRUCTURAL ERRORS | | ON CONTROL CHAIN. | | END OF DISPLAY | | | +--------------------------------------------------------------------------------+
Related Information