gtpo1m1rOperations

ZBROW COLLECTION-Perform Maintenance on a Collection

Use this command to display information about the specified collection and to perform maintenance on the specified collection.

Requirements and Restrictions

Format




ADDAll
adds all the elements of a source collection to the specified target collection in the most correct way.

Notes:

  1. You cannot add elements from a collection that does not have keys to a collection that has keys.

  2. The size of the largest element in the source collection must be less than or equal to the maximum element size in the target collection.

  3. The size of the largest key in the source collection must be less than or equal to the maximum key size in the target collection.

  4. When the source collection is a binary large object (BLOB), the target collection must be a BLOB.

targetname
is the name of the target collection. The target collection must previously exist.

sourcename
is the name of the source collection.

ATTributes
displays the names and values of all of the attributes of the internal components of the specified collection.

colname
is the assigned name of the collection.

CAPTure
specifies that the collection and any assigned properties will be written to an external device. Collections cannot be captured or restored using blocked tapes.

COPY
makes a copy of the specified source collection, including the following:

newname
is the new name of the collection that was copied, migrated, or restored. The new name cannot already be associated with a collection.

COPYDD
makes a copy of the specified source collection using the specified data definition for the copy.

ddname
is the data definition (DD) to apply to the new collection.

DELete
marks a collection for deletion. The actual deletion will be delayed until a later time. The collection name is not deleted. Use the ZBROW NAME command with the REMOVE parameter specified to remove the name.

DUMP
dumps the contents of the specified collection to the printer. If no key path is specified, the primary key path is used.

KEYPath-keypathname
specifies one of the following, where keypathname is the 1- to 16-character alphanumeric name of the key path:

EMPTY
deletes all elements in the collection. If the collection specified is DS_DELETED and the data store is set to use delayed deletes, all pending deletes will be processed for the qualified data store.

MIGrate
migrates a specified source collection to a collection using new pools in the current format. This includes the following:

NAMe
displays the class name of the specified collection.

PARTs
displays the class names of the parts of the specified collection.

RECLaim
reclaims a collection marked for deletion.

RECONstruct
verifies and rebuilds the internal structures of a collection, and displays a list of all of the actions taken on the collection and any conditions that cannot be resolved.
Note:
If multiple chains are corrupt, the ZBROW COLLECTION command with the RECONSTRUCT parameter specified may fail. For example, ZBROW COL RECONSTRUCT colname DIRECTORY and ZBROW COL RECONSTRUCT colname KEYS will both fail with a 0200DC system error if the allocated data chain is corrupt.

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.

DATA
uses the internal mapping of a collection to rebuild the data chain.

KEYS
uses the data chain of a collection to rebuild the internal key (index) structure.

DIRECTory
uses the data chain and internal key (index) structure of a collection to rebuild the internal directory structure.

RESTore
restores a previously captured collection. Collections cannot be captured or restored using blocked tapes.

origname
is the name of the previously captured collection.

DDname-ddname
restores the data definition with the collections that will be displayed, where ddname is the name of the data definition.

SHADOW
specifies the use of shadowing for this restore. This parameter overrides the setting in the data definition.

VALidate
verifies the structure of the specified collection. If a key path name is not specified, the collection is verified without key path validation and the results of the verification are displayed. If the key path parameter is used, it verifies the structure of the specified key path and results in a dump if a structure that is not valid is found.

Additional Information

Examples

The attributes of the BANK1_DS inventory collection are displayed in the following example.

Note:
All fields displayed by this command are internal to TPFCS and are subject to change.

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