gtpo1m1xOperations

ZBROW QUALIFY-Qualify ZBROW for a Data Store

Use this command to specify to which data store and parameters subsequent ZBROW commands apply. With this command you can:

Requirements and Restrictions

Format




DISPlay
displays the current ZBROW command qualification.

ALL
displays the current entire ZBROW command qualification when used with the DISPLAY parameter. When used with the RESET parameter, all entries of the qualification are zeroed out, including the data store name.

RESet
zeros out all entries of the qualification except the data store name.

SET
sets or updates the qualification of the specified parameters.

DATA
specifies the data that will be used to retrieve from, or store into, a collection. The maximum input size is 108 characters.

decval
is a character string.

X%hexval
is a hexadecimal character string.

DLEN-datalen
specifies the hexadecimal length of the data being added, modified, or removed, where datalen is the length. The maximum data length is X'80' bytes. If no data length is specified, the length of the data entered is determined dynamically. If a length is specified that is less than the actual length of the data, an error will be generated on a subsequent command that attempts to use that data. If a length is specified that is greater than the actual length of the data, the data is padded at the end with the character specified by the DPAD parameter. If a delete operation is being performed on a binary large object (BLOB), this parameter is required and specifies the number of bytes to delete.

DPAD
specifies the character to use in data padding operations.

decpad
specifies the character to use in padding operations, where decpad is a single character.

X%hexpad
specifies the hexadecimal value to use in padding operations, where hexpad is a 1-byte value.

DSname-dsname
specifies the data store name that the ZBROW command will use for all subsequent ZBROW commands, where dsname is a 1- to 8-character data store name.

INDEX-index
specifies the index of the element to be added, modified, or deleted, where index is a 1-based decimal value. If you specify INDEX, you cannot specify SEARCH or SPAD. You can specify SEARCH and SPAD concurrently.

SEARCH
specifies the search field of the element to be added, modified, or deleted. If you specify INDEX, you cannot specify SEARCH or SPAD. You can specify SEARCH and SPAD concurrently. If the length of the search field specified is less than the collection search field size, SEARCH is padded at the end with the character specified by SPAD. The maximum size of the search field is 108 characters.

SPAD
specifies the character to use in SEARCH padding operations. If you specify INDEX, you cannot specify SEARCH or SPAD. You can specify SEARCH and SPAD concurrently.

RSA-displacement
specifies the starting address of data in an element or a BLOB as the target to be modified, where displacement is a 0-based starting hexadecimal displacement.

Additional Information

Examples

The ZBROW qualification is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL DISP                                                         |
|                                                                                |
|System: BROW0602I 08.37.20 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|                                                                                |
+--------------------------------------------------------------------------------+

The entire ZBROW qualification is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL DISP ALL                                                     |
|                                                                                |
|System: CSMP0097I 09.45.15 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0606I 09.45.15 BROWSER QUALIFICATION DISPLAY                        |
|        TERM ADDRESS - 10000                                                    |
|        DSNAME       - TO2SVTDS                                                 |
|        DATA         - TESTING                                                  |
|        DATA LENGTH  - 20                                                       |
|        DATA PAD     - G                                                        |
|        BROW0607I 09.45.15 QUALIFICATION PROCESSING COMPLETED+                  |
|                                                                                |
+--------------------------------------------------------------------------------+

The ZBROW qualification, except for the data store name, is reset in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL RESET                                                        |
|                                                                                |
|System: CSMP0097I 09.05.50 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0607I 09.05.50 QUALIFICATION PROCESSING COMPLETED                   |
|                                                                                |
|User:   ZBROW QUAL DISP ALL                                                     |
|                                                                                |
|System: CSMP0097I 09.15.50 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        BROW0606I 09.15.50 BROWSER QUALIFICATION DISPLAY                        |
|        TERM ADDRESS - 10000                                                    |
|        DSNAME       - TO2SVTDS                                                 |
|        BROW0607I 09.15.50 QUALIFICATION PROCESSING COMPLETED                   |
|                                                                                |
+--------------------------------------------------------------------------------+

The ZBROW qualification is set to data store BANK1_DS in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL SET DS-BANK1_DS                                              |
|                                                                                |
|System: BROW0607I 08.36.31 QUALIFICATION PROCESSING COMPLETED                   |
+--------------------------------------------------------------------------------+

The ZBROW qualification is set to data store TO2SVTDS and the data is specified to be NEWDATA in the following example. This qualification can be used to allow the contents of a collection to be changed on a subsequent ZBROW ALTER command.

+--------------------------------------------------------------------------------+
|User:   ZBROW QUAL SET DS-TO2SVTDS DATA-NEWDATA                                 |
|                                                                                |
|System: BROW0607I 08.53.59 QUALIFICATION PROCESSING COMPLETED                   |
|                                                                                |
+--------------------------------------------------------------------------------+

See ZBROW ALTER-Alter the Contents or Access Mode of a Specified Collection for more examples.

Related Information