High-Level Screen Management Intrinsic Library Reference Manual (32424-90002)

3- 23
the operator is to begin entering data. It
also tells HPDPROMPT to position the cursor at
this field. The field must be an input field.
A four-byte integer identifies the beginning
field by number or screen order. A positive
integer indicates a field number. A negative
integer indicates screen order. If you supply
a zero, HPDPROMPT moves the cursor to the first
enhanced input field on the screen. If no
fields are enhanced, the cursor is positioned
at the first physical input field on the
screen.
OR
A 36-byte character array that identifies the
beginning field by its USASCII name. This
array must be preceded by a double backslash
(\\). If you pass spaces in this array,
HPDPROMPT moves the cursor to the first
enhanced input field on the screen. If no
fields are enhanced, the cursor is positioned
at the first physical input field on the
screen.
msg A compound parameter that tells HPDPROMPT the
message that you want displayed in the message
window, and the length of that message. It is
made up of the following subparameters:
msglen A four-byte integer
that indicates in
bytes the length of
the message you want
HPDPROMPT to transfer
to the window area.
If you supply a zero,
HPDPROMPT fills the
window with blanks.
If you supply a
negative number,
HPDPROMPT does not
update the window
area and the previous
message is displayed.
msgline A character array of
up to 256 bytes that
identifies the
message you want
HPDPROMPT to display
in the window area.
fieldlist A compound parameter that identifies for
HPDPROMPT the fields you want highlighted.
This parameter is compatible with the HPDREAD
fieldlist parameter. It is made up of the
following subparameters:
listtype A four-byte integer
that tells HPDPROMPT
to list the fields by
number or name. You
can supply the
following values:
0 = null list
1 or 2 = fields
listed in number
format