gtpo1m1wOperations

ZBROW PROPERTY-Alter or Display a Property

Use this command to define, delete, or display a property for the specified collection. When defining these properties (also referred to as attributes), you can:

Requirements and Restrictions

Format




DEFine
defines or modifies a property for the specified collection.

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

propname
is the 1- to 64-character alphanumeric name of the property you want to define, delete, or display.

CHAR
specifies a 1-byte character. This character cannot be a space, dash (-), or equal sign (=).

DOUBLE
specifies an 8-byte nonnegative decimal value. The maximum value for a DOUBLE type is 263 -1. A decimal value is entered, but it is displayed as the internal representation of the number. This consists of a sign bit, a 7-bit hexadecimal characteristic, and a 24-bit hexadecimal fraction (significand), which is preceded by an implied decimal point. The number is calculated as:
(-1) × (sign bit) × (significand) × (Base^Exponent)

where: Exponent = characteristic - Bias, and the Bias=64 and the Base=16 in an S/370 environment.

LONG
specifies a 4-byte nonnegative decimal value. The maximum for a LONG type is 231 -1.

STRING
specifies a C character string that is up to 256 bytes. The string cannot contain any spaces, dashes, or equal (=) signs.

STRUCT
specifies a structure that is up to 1000 bytes.

VALue-value
specifies the value of the property. The value must be consistent with the type specified.

MODE
specifies one of the following modes for a property:

NORMAL
specifies that you can read, change, or delete the property mode with no restrictions.

NOCHANGE
specifies that the property can only be read and deleted. It cannot be changed.

NODELETE
specifies that the property mode can be read or changed but it cannot be deleted.

READONLY
specifies that the property mode can only be read. The property mode cannot be changed or deleted. A READONLY property is only deleted when the target collection is deleted.

DELete
deletes a property for the specified collection.

ALL
specifies one of the following:

DISPlay
displays either a definition of a property (including the type, mode, and value) or all defined property names for a specific collection. Numeric values are displayed in hexadecimal.

Additional Information

None.

Examples

The DICTIONARYNAME property is defined for the DICT1 collection and given a value of MYDICTIONARY 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 PROPERTY DEFINE DICT1 DICTIONARYNAME STRING VAL-MYDICTIONARY      |
|                                                                                |
|System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|        BROW0510I 18.56.22 PROPERTY DEFINITION REQUEST COMPLETED                |
+--------------------------------------------------------------------------------+

The property type, mode, and value of the DICTIONARYNAME property for the DICT1 collection are displayed in the following example along with the PID of the property collection.

+--------------------------------------------------------------------------------+
|User:   ZBROW PROPERTY DISPLAY DICT1 DICTIONARYNAME                             |
|                                                                                |
|System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|        BROW0501I 18.56.50 PROPERTY DISPLAY                                     |
|        PID  - 0200FC19 AEA2673D C6C1D74B C4C24040                              |
|               1801C43F 00000000 00000000 00000000                              |
|        NAME:                                                                   |
|        DICTIONARYNAME                                                          |
|        TYPE - STRING   MODE - NORMAL                                           |
|        VALUE - MYDICTIONARY                                                    |
|        BROW0510I 18.56.50 PROPERTY DEFINITION REQUEST COMPLETED                |
+--------------------------------------------------------------------------------+

A list of all properties defined for the DICT1 collection and the PID of the property collection is displayed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZBROW PROPERTY DISPLAY DICT1 ALL                                        |
|                                                                                |
|System: BROW0602I 08.38.57 BROWSER QUALIFIED FOR DSNAME BANK1_DS                |
|        BROW0501I 18.59.41 PROPERTY DISPLAY                                     |
|        PID  - 0200FC19 AEA2673D C6C1D74B C4C24040                              |
|               1801C43F 00000000 00000000 00000000                              |
|        DICTIONARYNAME                                                          |
|        MYPROP                                                                  |
|        BROW0510I 18.59.41 PROPERTY DEFINITION REQUEST COMPLETED                |
+--------------------------------------------------------------------------------+

Related Information