HP 3000 Manuals

HPDSETENV [ 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

HPDSETENV 

Allows your application to configure elements of the current execution
environment.

Syntax 

HPDSETENV globalpak, returnpak, mode, envbufdescrpt, envbuf 

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.

mode                      A four-byte integer returned to the intrinsic
                          that specifies the element in the execution
                          environment that you want to configure.  The
                          values you can specify are:

                          2 = native language identifier

                          3 = auto test option

                          78 = switch device out of block mode

                          79 = switch device into block mode

envbufdescrpt             A four-byte integer that is input to the
                          intrinsic.  Use this parameter for those cases
                          when your application is allowed to specify the
                          size and arrangement of the configuration
                          update passed in the envbuf parameter.

                          Note:  The input format of most of the
                          available configuration updates is fixed.  If
                          this is the case, this parameter is ignored.

envbuf                    A compound parameter that is input to the
                          intrinsic.  It defines the area that contains
                          the configuration update.  The value you supply
                          for this parameter depends on the mode you have
                          specified:

  (If)                                               (Supply) 
  Mode        Element                             Length/format 

---------------------------------------------------------------------------------------

2        Native language   A four-byte integer that specifies the language conventions
                           to be used.  To use this feature, the forms file must be
                           open and your application must ensure the following:

                           - An "international" forms file is currently being accessed.

                           - Native language subsystem software is installed on the
                           system you are using.

                           - The native language you are requesting must be on the
                           system.  See the Native Language Support Reference Manual 
                           (Part No.  ?)  for the language codes that you can use.

3        Auto test option  A four-byte integer that sets up automatic terminal
                           interaction.  To use this mode, the forms file must have
                           been opened or the device enabled.  The values you can
                           supply are:

                           0 = disable

                           1 = enable

78       Switch out of     An 88-byte character array that is the name of the device
         block mode        file you want to switch out of block mode.  To use this
                           mode, the device must have been enabled by HPDENABLETERM.

79       Switch into block An 88-byte character array that is the name of the device
         mode              file you want to switch into block mode.  To use this
                           feature, the device must have been enabled and switched out
                           of block mode.

Discussion 

HPDSETENV is designed for advanced programming applications.  It allows
you to configure various elements of your application's current execution
environment.  You can configure four elements in your application's
environment.  You can:

   1.  Configure the native language identifier so that prompts and data
       editing follow the conventions of a particular language.

   2.  Turn on the auto test feature so that your application can execute
       without someone having to be at the terminal.  One possible use of
       this feature is for automatic test suites.

   3.  Momentarily switch a device into

   4.  - or out of block mode.



MPE/iX 5.0 Documentation