HP 3000 Manuals

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