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

3- 4
returnmsg A 256-byte character array that represents a
displayed message returned by the intrinsic.
lastitemtype A four-byte integer that indicates what type of
item terminated the read intrinsic. A zero (0)
means the read intrinsic was terminated by the
[ENTER] key or a function key. A one (1) means
the read intrinsic was terminated by a field.
lastitemnum A four-byte integer that indicates the
identifier, that is number, of the function key
or field that terminated the read intrinsic.
For fields, this is the field number FORMSPEC
assigns the field. For the [ENTER] key, the
value is zero. For function keys, the value
corresponds to the function number: f1 = 1,
2 = 2, and so on.
lastitemname A 32-byte character field that represents the
USASCII name of the item that terminated the
read intrinsic. What this variable contains
depends on the item:
- field contains a field name
ENTER key shows $ENTER
function key contains $PFK_n where n is the key
number
If the item is not one of the above, lastitem
contains $VACANT.
You can define a string up to 32 characters
long to replace the itemname returned. For an
example of how to do this, see the Discussion
for the returnpak parameter.
numdataerrs A four-byte integer that indicates the number
of data errors detected during data
initialization, editing, or reformatting.
numchngdflds A four-byte integer returned by HPDREAD that
indicates the number of fields into which the
operator keyed data. A returned value of -1
means information cannot be determined.
Discussion
The
returnpak parameter is initialized by the called intrinsic and
returns status information when that intrinsic is executed. This status
information is only kept until the next intrinsic is executed. For
example, if an error message is returned and you call the next intrinsic
before responding to the message, the message is lost.
Writing Replacement Strings for LASTITEMNAME
You can choose to replace the name associated with the last item with a
string you have defined. You define replacement strings in FORMSPEC by
constructing custom error messages that are retrieved by the HPDREAD
intrinsic, but not executed. For example, to write a replacement string
for the function key f3 within the form ADD_PART, write a processing
specification statement for any of the fields in form ADD_PART: