gtpo1m1uOperations

ZBROW NAME-Alter or Display Collection Name Information

Use this command to define, display, or remove a name for a persistent identifier (PID) of a collection. Use the name in the other ZBROW messages in place of the PID. Use the ZBROW QUALIFY command to determine which data store (DS) to apply the request.

Requirements and Restrictions

Format




DEFine
defines a name for a collection and associates it with a specified PID.

colname
is the 1- to 32-character name of the collection that you want to define, display, or remove.

PID-pid
specifies the PID, where pid is the 64-character hexadecimal PID value.
Note:
You are not required to enter the trailing zeros for pid.

DISPlay
displays the PID associated with a collection name or, if specified with the ALL parameter, displays all defined collection names.

ALL
displays all defined collection names in the browser dictionary along with their associated PID values.

REMove
removes the name of the collection definition from the TPFCS browser dictionary.

Additional Information

Whenever a data store is defined using the ZOODB DEFINE command with the DS parameter specified, the following browser names (see the example for ZBROW QUAL SET DS-BANK1_DS) are also added to the browser dictionary of the data store:

DS_BROWSE
Name of the browser dictionary of the data store.

DS_DELETED
Name of the deleted PID collection of the data store.

DS_INVENTORY
Name of the inventory collection of the data store. The inventory collection name is not defined if NOINVENTORY was specified on the latest TO2_createDS or TO2_changeDS request.

DS_RECOUP
Name of the recoup index collection of the data store.

DS_SYSTEM_DICT
Name of the system dictionary of the data store.

DS_USER_DICT
Name of the user dictionary of the data store.

Examples

The USER_ACCOUNTS name is assigned to the data store user account collection of the BANK1_DS collection 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 NAME DEF USER_ACCOUNTS PID-0200FC19AD58DB59C2C1D5D2F16DC4E2980081D|
|                                                                                |
|System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|        BROW0303I 08.38.57 COLLECTION NAME SUCCESSFULLY DEFINED                 |
|        BROW0310I 08.38.57 NAME DEFINITION REQUEST COMPLETED                    |
+--------------------------------------------------------------------------------+

The PID of the BANK1_DS inventory collection is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW NAME DISP DS_INVENTORY                                            |
|                                                                                |
|System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|        BROW0301I 08.38.57 NAME DEFINITION DISPLAY                              |
|                                                                                |
|        NAME - DS_INVENTORY                                                     |
|        PID  - 0200FC19 AD58DB59 C2C1D5D2 F16DC4E2                              |
|               980081DD 00000000 00000000 00000000                              |
|        END OF DISPLAY                                                          |
|                                                                                |
|        BROW0310I 08.38.57 NAME DEFINITION REQUEST COMPLETED                    |
+--------------------------------------------------------------------------------+

All the collection names and corresponding PIDs in the browser dictionary for data store BANK1_DS are displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW NAME DISP ALL                                                     |
|                                                                                |
|System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|        BROW0301I 08.38.57 NAME DEFINITION DISPLAY                              |
|                                                                                |
|        NAME - USER_ACCOUNTS                                                    |
|        PID  - 0200FC19 AD58DB59 C2C1D5D2 F16DC4E2                              |
|               980081DD 00000000 00000000 00000000                              |
|        NAME - DS_BROWSE                                                        |
|        PID  - 0200FC19 AEC8FD8E C2C1D5D2 F16DC4E2                              |
|               180BDA9E 00000000 00000000 00000000                              |
|        NAME - DS_DELETED                                                       |
|        PID  - 0200FC19 AEC8FD8E C2C1D5D2 F16DC4E2                              |
|               180BDA9C 00000000 00000000 00000000                              |
|        NAME - DS_INVENTORY                                                     |
|        PID  - 0200FC19 AEC8FD8E C2C1D5D2 F16DC4E2                              |
|               180BDA99 00000000 00000000 00000000                              |
|        NAME - DS_RECOUP                                                        |
|        PID  - 0200FC19 AEC8FD8E C2C1D5D2 F16DC4E2                              |
|               180BDA9D 00000000 00000000 00000000                              |
|        NAME - DS_SYSTEM_DICT                                                   |
|        PID  - 0200FC19 AEC8FD8E C2C1D5D2 F16DC4E2                              |
|               180BDA9B 00000000 00000000 00000000                              |
|        NAME - DS_USER_DICT                                                     |
|        PID  - 0200FC19 AEC8FD8E C2C1D5D2 F16DC4E2                              |
|               180BDA9A 00000000 00000000 00000000                              |
|        END OF DISPLAY                                                          |
|                                                                                |
|        BROW0310I 08.38.57 NAME DEFINITION REQUEST COMPLETED                    |
+--------------------------------------------------------------------------------+

The USER_ACCOUNTS collection name is removed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW NAME REM USER_ACCOUNTS                                            |
|                                                                                |
|System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|        BROW0304I 08.38.57 COLLECTION NAME SUCCESSFULLY REMOVED                 |
|        BROW0310I 08.38.57 NAME DEFINITION REQUEST COMPLETED                    |
+--------------------------------------------------------------------------------+

The PID of the MATIP_DS database is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW NAME DISP HOSTNAMES                                               |
|                                                                                |
|System: BROW0602I 07.33.37 BROWSER QUALIFIED FOR DSNAME MATIP_DS                |
|        BROW0301I 07.33.37 NAME DEFINITION DISPLAY                              |
|                                                                                |
|        NAME - HOSTNAMES                                                        |
|        PID  - 0200FC19 B2C4CB4B D4C1E3C9 D76DC4E2                              |
|               18003B5C 00000000 00000000 00000000                              |
|        END OF DISPLAY                                                          |
|                                                                                |
|        BROW0310I 07.33.37 NAME DEFINITION REQUEST COMPLETED                    |
+--------------------------------------------------------------------------------+

Related Information