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

3- 16
(If) Element (Supply)
Mode Length/Format
------------------------------------------------------------------------------------
1 Library version An eight-byte character array
2 Native language A four-byte integer. The forms file must be open to use
this mode. See the Native Language Support Reference Manual
for the applicable codes.
3 Auto test option A four-byte integer. The forms file must have been opened
or the device enabled to use this mode. The following
values are returned:
0 = disabled
1 = enabled
4 Device token An array of 10 four-byte integers. If the device is not
enabled, the information returned is undefined. The array
is defined as follows:
The first integer in the array contains the file number
assigned to the open device. A zero is returned if the
device is not open.
The second integer in the array contains the system logical
device number assigned to the open device. A zero is
returned if the device is not open.
The third integer in the array contains the device type
identifier of the open device. A zero is returned if the
device is not open.
See Table D-1 in Appendix D for a list of device type
identifiers that you can specify.
The remainder of the array is undefined.
5 Form token A 200-byte record defined as:
currentformname A 32-byte character array that contains the name of the form
currently being processed.
nextformname A 32-byte character array that contains the name of the next
form to be processed.
currentformopt A four-byte integer that indicates whether the current form
is a repeating form, and if so, whether it is to be appended
to itself. The values returned are:
0 = normal sequence, do not repeat or append
1 = repeat current form
2 = repeat current form and append it to itself
nextformopt A four-byte integer that indicates whether the screen is to
be cleared when the next form is displayed or whether the
next form is to be appended to the current form. It also
indicates whether the form, if appended, is to be frozen on
the screen. The values returned are:
0 = clear screen, do not freeze or append
1 = append next form to current form
2 = freeze current form and append
next form to it.
databuflen A four-byte integer that indicates the data buffer length,
in bytes, of the current form.
screenlen A four-byte integer that indicates the screen length, in
lines, of the current form.
The remainder of the record is undefined.
The forms file must be open to use Mode 5.