HPDENABLETERM [ High-Level Screen Management Intrinsic Library (Hi-Li) Reference Manual ] MPE/iX 5.0 Documentation
High-Level Screen Management Intrinsic Library (Hi-Li) Reference Manual
HPDENABLETERM
Enables a device.
Syntax
HPDENABLETERM globalpak, returnpak, termpak, devconfig
Parameter Descriptions
globalpak A compound parameter that passes information
between intrinsics. For a complete description
of this parameter, see "Global Parameters" in
Chapter 3.
returnpak A compound parameter that passes information
back from the intrinsic to the application.
For a complete description of this parameter,
see "Global Parameters" in Chapter 3.
termpak5 A compound parameter that passes information to
the intrinsic.
termfile An 88-byte character
array
that indicates the
name of the device to
be enabled.
bypassfeature A four-byte integer
that is used by the
application to
indicate the
intrinsic features
you do not want to
use.
0 = ignore
1 or 3 = do not enable touch sensing
2 or 3 = do not clear device screen
devconfig A compound parameter that provides input to and
and receives output from the intrinsic.
allolen A four-byte integer
that indicates the
size in bytes of the
allocated
configuration storage
area.
actualen A four-byte integer
that indicates in
bytes the actual
configuration data
captured.
configarea An array that
represents the area
allocated by the
application to retain
device configuration
information. A
minimum of 800 bytes
is required.
Discussion
HPDENABLETERM opens the device as a file and places the device in block
mode. Once the device is opened and controlled by the Hi-Li intrinsics,
you should not call system intrinsics such as FREAD and FWRITE to
communicate with the terminal. All device I/O for the opened device must
be performed through Hi-Li. If HPDENABLETERM is the first Hi-Li
intrinsic called, the comarea in globalpak is configured.
In addition to opening a device, you can also use this parameter to
request that the intrinsic read and return to the application function
key labels and the keys' functions.
NOTE The HPDENABLETERM or HPDOPENFORMS intrinsic must be the first Hi-Li
intrinsic you call.
MPE/iX 5.0 Documentation