HP 3000 Manuals

Data Manager Specific Field Attributes Screen [ HP ALLBASE/4GL Developer Reference Manual Vol. 1 ] MPE/iX 5.0 Documentation

HP ALLBASE/4GL Developer Reference Manual Vol. 1

Data Manager Specific Field Attributes Screen

This screen allows you to specify data manager specific attributes for a
field specification. Currently, only HP TurboIMAGE/iX-specific
attributes can be set. To display this screen, press the Data Mgr
Attribs. function key from the field specification screen.

Screen Image

Field Descriptions

Field Spec. Name This is a display only field that contains the name
of the field specification displayed on the field specification screen
when you accessed this screen.

Data Manager Enter the code to specify the data manager for which you
wish to add, change or delete attributes. Currently, HP ALLBASE/4GL only
supports the HP TurboIMAGE/iX data manager, so accept the default code T.

When you commit this field, the appropriate data manager window is
displayed. Any attributes previously defined for this data manager are
also displayed. If no attributes have been defined, the default
attributes for the field specification are displayed.

Currently, only the HP TurboIMAGE/iX window is available.

Action Enter the code of the action to be performed on the specified
field. It can be one of the following:

Code Action

A Add new data manager attributes for the field.

C Change field attributes for the data manager specified.

D Delete field attributes for the data manager specified.

This field defaults to A if no field attributes have been set for the
specified data manager and the default settings are displayed, or C if
field attributes do exist for the data manager.

Data Item Name Enter the name of the field specification as it will be
known to HP TurboIMAGE/iX. This name is used as an HP TurboIMAGE/iX data
item name in references to HP TurboIMAGE/iX databases. The name may
contain any characters legal for HP ALLBASE/4GL names, except the
underscore character (_). The following characters are also valid:

+, -, *, /, ?, ', #, %, &, and @.

This field defaults to the name in the Field Spec. Name field. Any
underscore characters in the base field specification name are converted
to hyphens (-).

HP TurboIMAGE/iX is not case sensitive, so HP ALLBASE/4GL automatically
changes lowercase characters in this field to uppercase.

Sub-item Count This is a display only field containing the number of
times the field specification is defined. It corresponds to the number
specified in the Repeated field on the field specification screen.

Type Designator Enter a code defining the HP TurboIMAGE/iX data item's
storage type. These item types map directly to HP TurboIMAGE/iX data
item type designators. The following table lists the available item
types and their meanings. For further information, refer to the HP
TurboIMAGE/iX Database Management System Reference Manual.

Code Meaning

E IEEE real number

I 2's complement (integer)

J Same as I except with COBOL range restrictions

K Absolute binary quantity (unsigned integer)

P Packed decimal (BCD, or binary coded decimal)

R "Classic" HP3000 real number

U Forced uppercase; all lowercase alphabetic characters are
shifted to uppercase

X Any printable ASCII character

Z A zoned decimal format number

The default value for this field is dependent upon the edit code and the
storage type specified on the field specifications screen. The following
table displays the default values.

------------------------------------------------------------------------------------------
| |
| Edit Code Storage Type Type Designator |
| |
------------------------------------------------------------------------------------------
| |
| X, A, or K C X |
| |
| U C U |
| |
| Q C X |
| |
| D or T C X |
| |
| N or S C X |
| |
| N or S I or L I |
| |

Sub-item Length

Enter a number between 1 and 255. This number represents the length of
each sub-item, in one of the following measurement units.

------------------------------------------------------------------------------------------
| |
| Type Designator Unit of Measurement Valid Sub-item Length |
| |
------------------------------------------------------------------------------------------
| |
| I, J, K Halfwords (16 bits) 1, 2, or 4 |
| |
| E, R Halfwords (16 bits) 2 or 4 |
| |
| U, X Bytes (8 bits) Any number |
| |
| Z Bytes (8 bits) <= 26 |
| |
| P Nibbles (4 bits) <= 26 and a multiple of 2 |
| |
------------------------------------------------------------------------------------------

The length of the data item as a whole equals the sub-item count
multiplied by the sub-item length, and must be an integral number of
halfwords.

For data items with type designators U, X, or Z, the data item length
must be divisible by 2. That is, the product of sub-item count and
sub-item length must be divisible by 2.

For data items with type designator P, the data item length must be
divisible by 4. That is, the product of sub-item count and sub-item
length must be divisible by 4.

In most situations, the default for this field should be satisfactory.
If you enter a value in this field that does not support HP TurboIMAGE/iX
field length rules, HP ALLBASE/4GL will display an error message when you
press Commit Data .

Function Keys

f1 Records Menu Cancels the current screen and displays the record
layout menu.

f2 Ranges Cancels the current screen and displays the validation
ranges screen.

f3 Tables Cancels the current screen and displays the validation
tables screen.

f4 Base Fld Specs. Cancels the current screen and displays the
field specification screen.

Additional Information

This screen is optional. If you do not complete this screen for a field
specification, and the field specification is used in a HP TurboIMAGE/iX
data set, the definition for the field specification uses the default
settings displayed on the screen.

These default settings are also used if you do not press the Commit Data
function key to confirm your data entry before exiting the screen.

The following table shows the default mapping of HP ALLBASE/4GL field
specification details onto HP TurboIMAGE/iX data types. It also shows
the default values for the HP TurboIMAGE/iX sub-item length of each type
of data type.

HP ALLBASE/4GL HP TurboIMAGE/iX

Edit Code Storage Type Sub-item Length
Type Designator

---------------------------------------------------------------------------------------

X, A, or K C X Field Length + pad

U C U Field Length + pad

Q C X 2

D or T C X 8

N or S C X Field Length + pad

N or S F K 2

N or S G K 4

N or S I I 1

N or S L I 2

N or S P P Field Length + pad

In the table above, pad is the smallest integer that can be used so that
the data item length is an integral number of halfwords.

The data item name field defaults to the field specification name (in
uppercase, with underscore characters converted to hyphens).

MPE/iX 5.0 Documentation