gtpo1m1pOperations

ZBROW ALTER-Alter the Contents or Access Mode of a Specified Collection

Use this command to change the contents or access mode of a collection.

With this command you can:

Requirements and Restrictions

Format




ELEment
causes the contents of the specified collection to be changed.

colname
is the 1- to 32-character alphanumeric name of the collection you want to change.

ADD
adds the qualified element to the specified collection.

MODify
updates the qualified element in the specified collection.

DELete
deletes the qualified element from the specified collection.

MODE
causes the access mode of the specified collection to be changed.

NORMAL
sets the access mode of the collection to NORMAL. All functions are allowed for the collection.

NOCHANGE
sets the access mode of the collection to NOCHANGE. The collection can only be read or deleted; it cannot be updated or added to.

NODELETE
sets the access mode of the collection to NODELETE. The collection can be read, updated, or added to.
Note:
The mode applies to the collection and not to its elements so that an application can delete all the elements in a collection with this mode, but it cannot delete the actual collection itself.

READONLY
sets the access mode of the collection to READONLY. The collection can only be read; it cannot be updated, added to, or deleted.

Additional Information

Examples

In some of the following examples, the ZBROW QUALIFY command is shown only to make the examples more complete.

The recoup index collection access mode is changed to NORMAL in the following example.

+--------------------------------------------------------------------------------+
|User:    ZBROW QUAL SET DS-BANK1_DS                                             |
|                                                                                |
|System:  BROW0607I 10.21.26 QUALIFICATION PROCESSING COMPLETED                  |
|                                                                                |
|User:    ZBROW ALT MODE DS_RECOUP NORMAL                                        |
|                                                                                |
|System:  BROW0602I 10.23.40 BROWSER QUALIFIED FOR DSNAME BANK1_DS               |
|System:  BROW0425I 10.23.40 ACCESS MODE FOR COLLECTION CHANGED                  |
|System:  BROW0410I 10.23.40 BROWSE OF COLLECTION COMPLETED                      |
+--------------------------------------------------------------------------------+

The qualified element of collection ARRAYL1 is modified in the following example.

+--------------------------------------------------------------------------------+
|User:    ZBROW QUAL SET DATA-1234567891011                                      |
|                                                                                |
|System:  CSMP0097I 15.09.25 CPU-B SS-BSS  SSU-HPN  IS-01                        |
|         BROW0607I 15.09.25 QUALIFICATION PROCESSING COMPLETED                  |
|                                                                                |
|User:    ZBROW ALTER ELEMENT ARRAYL1 MODIFY                                     |
|                                                                                |
|System:  CSMP0097I 15.09.25 CPU-B SS-BSS  SSU-HPN  IS-01                        |
|         BROW1120I 15.09.25 BEGIN DISPLAY OF THE QUALIFIED ELEMENT              |
|         ABCDEFGHIJKLM                                                          |
|         ALTERED TO -                                                           |
|         1234567891011                                                          |
|         BROW1110I 15.09.25 ALTER REQUEST COMPLETED                             |
+--------------------------------------------------------------------------------+

The following example shows the addition of an element to an array collection.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL DISP ALL                                                     |
|                                                                                |
|System: CSMP0097I 16.47.54 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0606I 16.47.54 BROWSER QUALIFICATION DISPLAY                        |
|        TERM ADDRESS - 10000                                                    |
|        DSNAME       - TO2SVTDS                                                 |
|        DATA         - TESTDATA                                                 |
|        DATA LENGTH  - 30                                                       |
|        DATA PAD     - X%F0                                                     |
|        BROW0607I 16.47.54 QUALIFICATION PROCESSING COMPLETED+                  |
|                                                                                |
|User:   ZBROW ALTER ELEMENT ARRAYL1 ADD                                         |
|                                                                                |
|System: CSMP0097I 16.50.22 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW1110I 16.50.22 ALTER REQUEST COMPLETED+                             |
|                                                                                |
|User:   ZBROW DISPLAY ELEMENT ARRAYL1 INDEX-201 RSA-0.40                        |
|                                                                                |
|System: CSMP0097I 16.55.14 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0602I 16.55.14 BROWSER QUALIFIED FOR DSNAME TO2SVTDS                |
|        BROW0408I 16.55.14 COLLECTION ELEMENT DISPLAY                           |
|        CLASS ID 0000007D SEQ CTR 00000001 LGH 00000030                         |
|         00000000- E3C5E2E3 C4C1E3C1 F0F0F0F0 F0F0F0F0 TESTDATA 00000000        |
|         00000010- F0F0F0F0 F0F0F0F0 F0F0F0F0 F0F0F0F0 00000000 00000000        |
|         00000020- F0F0F0F0 F0F0F0F0 F0F0F0F0 F0F0F0F0 00000000 00000000        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED+                            |
|        CSMP0097I 16.55.14 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0410I 16.55.14 BROWSE OF COLLECTION COMPLETED+                      |
|                      	                                                         |
+--------------------------------------------------------------------------------+

The following example shows the modification of the element at index 201.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL DISP ALL                                                     |
|                                                                                |
|System: CSMP0097I 16.59.22 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0606I 16.59.22 BROWSER QUALIFICATION DISPLAY                        |
|        TERM ADDRESS - 10000                                                    |
|        DSNAME       - TO2SVTDS                                                 |
|        DATA         - X%E7E7E7E7                                               |
|        INDEX        - 201                                                      |
|        RSA          - 4                                                        |
|        BROW0607I 16.59.22 QUALIFICATION PROCESSING COMPLETED+                  |
|                                                                                |
|User:   ZBROW ALTER ELEMENT ARRAYL1 MOD                                         |
|                                                                                |
|System: CSMP0097I 16.59.53 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW1120I 16.59.53 BEGIN DISPLAY OF THE QUALIFIED ELEMENT               |
|        DATA                                                                    |
|        ALTERED TO -                                                            |
|        XXXX                                                                    |
|        BROW1110I 16.59.53 ALTER REQUEST COMPLETED+                             |
|                                                                                |
|User:   ZBROW DISPLAY ELEMENT ARRAYL1 INDEX-201 RSA-0.40                        |
|                                                                                |
|System: CSMP0097I 17.00.24 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0602I 17.00.24 BROWSER QUALIFIED FOR DSNAME TO2SVTDS                |
|        BROW0408I 17.00.24 COLLECTION ELEMENT DISPLAY                           |
|        CLASS ID 0000007D SEQ CTR 00000002 LGH 00000030                         |
|         00000000- E3C5E2E3 E7E7E7E7 F0F0F0F0 F0F0F0F0 TESTXXXX 00000000        |
|         00000010- F0F0F0F0 F0F0F0F0 F0F0F0F0 F0F0F0F0 00000000 00000000        |
|         00000020- F0F0F0F0 F0F0F0F0 F0F0F0F0 F0F0F0F0 00000000 00000000        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED+                            |
|        CSMP0097I 17.00.24 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0410I 17.00.24 BROWSE OF COLLECTION COMPLETED+                      |
|                      	                                                         |
+--------------------------------------------------------------------------------+

The following example attempts to delete the element at index 201 (the last element of the array). Note that the ZBROW DISPLAY command does not display the deleted element.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL DISP ALL                                                     |
|                                                                                |
|System: CSMP0097I 17.02.14 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0606I 17.02.14 BROWSER QUALIFICATION DISPLAY                        |
|        TERM ADDRESS - 10000                                                    |
|        DSNAME       - TO2SVTDS                                                 |
|        INDEX        - 201                                                      |
|        BROW0607I 17.02.14 QUALIFICATION PROCESSING COMPLETED+                  |
|                                                                                |
|User:   ZBROW ALTER ELEMENT ARRAYL1 DEL                                         |
|                                                                                |
|System: CSMP0097I 17.02.55 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW1110I 17.02.55 ALTER REQUEST COMPLETED+                             |
|                                                                                |
|User:   ZBROW DISPLAY ELEMENT ARRAYL1 INDEX-201 RSA-0.40                        |
|                                                                                |
|System: CSMP0097I 17.03.21 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0602I 17.03.21 BROWSER QUALIFIED FOR DSNAME TO2SVTDS                |
|        BROW0408I 17.03.21 COLLECTION ELEMENT DISPLAY                           |
|        CLASS ID 00000000 SEQ CTR 00000000 LGH 00000000                         |
|        DATA LENGTH LESS THAN SPECIFIED RSA                                     |
|        BROW0410I 17.03.21 BROWSE OF COLLECTION COMPLETED+                      |
|                      	                                                         |
+--------------------------------------------------------------------------------+

The following example shows the addition of an element to a keyset collection.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL DISP ALL                                                     |
|                                                                                |
|System: CSMP0097I 17.06.24 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0606I 17.06.24 BROWSER QUALIFICATION DISPLAY                        |
|        TERM ADDRESS - 10000                                                    |
|        DSNAME       - TO2SVTDS                                                 |
|        DATA         - SYSTEMTESTDATA1234                                       |
|        RSA          - 10                                                       |
|        SEARCH       - KEY1                                                     |
|        BROW0607I 17.06.24 QUALIFICATION PROCESSING COMPLETED+                  |
|                                                                                |
|User:   ZBROW ALTER ELEMENT KEYSETS1 ADD                                        |
|                                                                                |
|System: CSMP0097I 17.11.49 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW1110I 17.11.49 ALTER REQUEST COMPLETED+                             |
|                                                                                |
|User:   ZBROW QUAL DISP ALL                                                     |
|                                                                                |
|System: CSMP0097I 17.13.09 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0606I 17.13.09 BROWSER QUALIFICATION DISPLAY                        |
|        TERM ADDRESS - 10000                                                    |
|        DSNAME       - TO2SVTDS                                                 |
|        DATA         - SYSTEMTESTDATA1234                                       |
|        DATA LENGTH  - 40                                                       |
|        RSA          - 0                                                        |
|        SEARCH       - KEY1                                                     |
|        BROW0607I 17.13.09 QUALIFICATION PROCESSING COMPLETED+                  |
|                                                                                |
|User:   ZBROW DISPLAY ELEMENT KEYSETS1 USEQUAL                                  |
|                                                                                |
|System: CSMP0097I 17.12.44 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0602I 17.12.44 BROWSER QUALIFIED FOR DSNAME TO2SVTDS                |
|        BROW0408I 17.12.44 COLLECTION ELEMENT DISPLAY                           |
|        CLASS ID 0000007D SEQ CTR 00000000 LGH 00000012                         |
|         00000000- E2E8E2E3 C5D4E3C5 E2E3C4C1 E3C1F1F2 SYSTEMTE STDATA12        |
|         00000010- F3F4                                34                       |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED+                            |
|        CSMP0097I 17.12.44 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0410I 17.12.44 BROWSE OF COLLECTION COMPLETED+                      |
|                      	                                                         |
+--------------------------------------------------------------------------------+

The following example attempts to delete an element from a log collection.

+--------------------------------------------------------------------------------+
|User:   ZBROW ALTER ELEMENT LOGL1 DEL                                           |
|                                                                                |
|System: CSMP0097I 17.15.13 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW1157E 17.15.13 DELETION OF LOG/KEYEDLOG ELEMENTS NOT ALLOWED        |
|        BROW1151E 17.15.13 ALTER REQUEST FAILED+             	                  |
+--------------------------------------------------------------------------------+

Related Information