gtpo1m1u | Operations |
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
|
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:
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