HP 3000 Manuals

User Environment Control File Settings [ HP Data Entry and Forms Mgmt. Sys. (VPLUS) Technical Addendum ] MPE/iX 5.0 Documentation


HP Data Entry and Forms Mgmt. Sys. (VPLUS) Technical Addendum

User Environment Control File Settings 

The user environment control file, called VENVCNTL.PUB.SYS, enables the
programmer to assert limited control over terminal activities.  It is
opened and read on the VOPENTERM call and controls several items in the
user environment.  To implement a user environment control file, build
this file:

     BUILD VENVCNTL.PUB.SYS;DEV=DISC;REC=-80,1,F,ASCII 

The VENVCNTL file need not necessarily reside in PUB.SYS. However, if the
file resides in another group and account, you must set up the following
file equation:

     FILE VENVCNTL.PUB.SYS=VENVCNTL.mygroup.myaccount 

VPLUS only uses the first record in the file.  You should use only
currently defined records and currently defined bytes in those records.

When VOPENTERM executes, it searches for the VENVCNTL file.  If it is not
found, VPLUS executes as usual.  If the file exists and you have set one
or more of the bytes, VPLUS responds to your request, thereby enabling
you to bypass VOPENTERM defaults.  A value of 1 enables the byte.  A
value of 0 disables the byte.  If the byte is left blank, VPLUS handles
it as disabled.

The following example shows one method for enabling bytes 1, 5,
and 8.

     :EDITOR
     /A
         1     10001001
         2     //
     ...
     /K VENVCNTL.PUB.SYS
     /EXIT

Table 2-1 explains what occurs when a byte is enabled or disabled.

          Table 2-1.  User Environment Control File Settings 

----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|   Byte   |        Default (Byte Disabled)         |        Override (Byte Enabled)         |
|  Number  |                                        |                                        |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    1     | Uses the terminal identification       | Causes VOPENTERM to assume that only   |
|          | process required to recognize the      | newer model terminals (262X and later) |
|          | oldest HP block mode terminals (264X), | are being used.  Shortens the terminal |
|          | then attempts the simple ID request    | identification process if the terminal |
|          | supported by newer HP terminals (262X  | can send the terminal's ID string.     |
|          | and later).                            |                                        |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    2     | Disables the AIDS/MODES/USER keys      | Enables AIDS/MODES/USER keys during    |
|          | during VPLUS block mode.               | VPLUS block mode.  Allows the user to  |
|          |                                        | corrupt the VPLUS terminal             |
|          |                                        | configuration.                         |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    3     | Reserved.                              | Reserved.  Do not enable.              |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    4     | Enables the modified data tag (MDT)    | Disables the MDT feature.  Reduces     |
|          | feature if applicable to the terminal. | performance and increases data         |
|          |                                        | communications.  Used primarily to     |
|          |                                        | diagnose MDT or data communications    |
|          |                                        | related problems.                      |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    5     | Retains the carriage return character  | Strips the carriage return character   |
|          | if found at the end of a terminal      | if found at the end of a terminal      |
|          | status read.                           | status read.  May be needed for        |
|          |                                        | process handling applications or for   |
|          |                                        | applications that temporarily switch   |
|          |                                        | the terminal into character mode.      |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    6     | Does not affect the terminal status    | Extends the terminal status read       |
|          | read length.                           | length by one byte if the terminal is  |
|          |                                        | driven by an                           |
|          |                                        | MPE V SPU. Results in a loss of        |
|          |                                        | terminal refresh capability.  May be   |
|          |                                        | needed for buffered networks.          |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    7     | Does not affect the terminal status    | Reduces terminal status read length by |
|          | read length.                           | one byte if the terminal is driven by  |
|          |                                        | an                                     |
|          |                                        | MPE XL SPU. May cause form reads to    |
|          |                                        | not wait for user input on certain     |
|          |                                        | slower terminals.                      |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------

          Table 2-1.  User Environment Control File Settings(cont.) 

----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|   Byte   |        Default (Byte Disabled)         |        Override (Byte Enabled)         |
|  Number  |                                        |                                        |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    8     | Forces an 80-column configuration for  | Does not force an 80-column            |
|          | 700/9X terminals.  This terminal       | configuration for 700/9X terminals.    |
|          | action clears the display.  VTURNOFF   | Note that corrupted forms displays and |
|          | and VCLOSETERM set the 80-column       | data can occur if the terminal is      |
|          | configuration, thereby clearing the    | configured to a column width other     |
|          | 700/9X display.                        | than 80.                               |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    9     | Resets function key definitions (keys, | Optimizes VTURNOFF/VTURNON by not      |
|          | not labels) during VTURNOFF/VTURNON    | resetting function key definitions.    |
|          | normal operation.                      |                                        |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    10    | Uses dual terminator mode for all      | Does not use dual terminator mode for  |
|          | format mode reads if the terminal is   | all format mode reads if the terminal  |
|          | driven by an MPE XL SPU.               | is driven by an MPE XL SPU. HP 150     |
|          |                                        | touch screens will not function        |
|          |                                        | properly.  Also, recovering from a     |
|          |                                        | terminal hard reset or power failure   |
|          |                                        | is more difficult.                     |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|  11-19   | Reserved.                              | Reserved.  Do not enable.              |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|    20    | Does not flush pending driver          | Flushes the pending driver             |
|          | configuration requests prior to the    | configuration requests to correspond   |
|          | next read during a terminal open,      | to the terminal configuration prior to |
|          | close, or refresh.                     | the next read when the terminal is     |
|          |                                        | driven by an MPE XL SPU. This may be   |
|          |                                        | needed if intermittent timing problems |
|          |                                        | cause terminal status failures         |
|          |                                        | (CSTATUS = 2 or 4) or hung ports       |
|          |                                        | during a terminal open, close, or      |
|          |                                        | refresh.                               |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------
|          |                                        |                                        |
|  21-80   | Reserved.                              | Reserved.  Do not enable.              |
|          |                                        |                                        |
----------------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation