home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 36 Tips / 36-Tips.zip / alltips.zip / DASET.FAX < prev    next >
Text File  |  1994-12-02  |  60KB  |  1,203 lines

  1. DOS Settings, Description of Each        7/18/94
  2.  
  3.       FILE:  OSDASET.FAX  -  6/02/94
  4.  
  5.       TITLE:  940602  DESCRIPTION OF DOS SETTINGS FOR
  6.                       AN OS/2 DESKTOP ICON
  7.  
  8.  
  9.       DESCRIPTION:
  10.                                STANDARD DOS SETTINGS
  11.                                ---------------------
  12.  
  13.             This document describes the ability of Standard DOS
  14.             Settings in an OS/2 Virtual DOS Machine (VDM).
  15.  
  16.             Depending on hardware configuration, and software level.
  17.             Some of these settings may not exist.
  18.  
  19.       AUDIO_ADAPTER_SHARING
  20.         Function:   Allows access to audio hardware for the DOS
  21.                     session. Two applications cannot use an audio
  22.                     adapter even if one is not required to run the
  23.                     program. This will allow you to minimize conflicts
  24.                     by defining audio specifications for each DOS
  25.                     session.
  26.  
  27.                     Select Optional to indicate that a program in this
  28.                     DOS sesion should use an audio adapter if one is
  29.                     available.
  30.  
  31.                     Select Required to indicate that a program in this
  32.                     DOS session must have access to an audio adapter.
  33.  
  34.                     Select None to indicate that a program in this DOS
  35.                     session does not require an audio adapter.
  36.         Default:    None.
  37.         Settable:   At any time.
  38.  
  39.       COM_DIRECT_ACCESS
  40.         Function:   When set on, VCOM.SYS will allow direct access to
  41.                     the COM ports.
  42.         Advantages: Programs that need direct access like AS/400
  43.                     Asynch Router, FastLynx, FSDUAT, and MS Word will
  44.                     now work.
  45.         Drawbacks:  Buffers in COM.SYS can not be used. Characters
  46.                     may be lost and some applications may suffer from
  47.                     the lack of buffering.
  48.         Default:    Off.
  49.         Settable:   At VDM creation only.
  50.  
  51.       COM_HOLD
  52.         Function:   When  set  on, provides exclusive access to COM
  53.                     ports for the specified VDM, preventing other
  54.                     processes from using the port and preventing the
  55.                     operating system from releasing the port until
  56.                     the VDM terminates.
  57.         Advantages: For  certain  applications  which  use  COM
  58.                     ports and which require multiple programs to
  59.                     access the COM port  (for example,  this  setting
  60.                     prevents the COM port from being released when
  61.                     the first program terminates).
  62.  
  63.  
  64.  
  65.  
  66.  
  67.        Drawbacks:   If not required by the application running in a
  68.                     VDM, this  setting  may  prevent  other
  69.                     applications from accessing COM ports.
  70.         Default:    Off.
  71.         Settable:   At VDM creation only.
  72.         Examples:   Certain bulletin board applications use one
  73.                     program to dial the BBS and another to exchange
  74.                     information; setting COM_HOLD on  prevents the
  75.                     operating system from releasing the COM port when
  76.                     the first program terminates.
  77.  
  78.       COM_RECEIVE_BUFFER_FLUSH
  79.         Function:   Will allow control of the received data buffers
  80.                     when the dos session is switched to the
  81.                     foreground, or when the Dos program enables the
  82.                     received data interrupt.
  83.  
  84.                     Select Receive Data Interrupt Enable to indicate
  85.  
  86.                     that, for this DOS session, the operating system
  87.                     is to discard data in the received data buffer
  88.                     when the DOS program enables the received data
  89.                     interrupt.
  90.  
  91.                     Select Switch to Foreground to indicate that, for
  92.                     this DOS session, the operating system is to
  93.                     discard data in the received data buffer when the
  94.                     DOS program is switched to the foreground.
  95.  
  96.                     Select ALL to indicate that communications data be
  97.                     discarded when a DOS program enables the received
  98.                     data interrupt or the program is switched to the
  99.                     foreground.
  100.  
  101.                     Select NONE to indicate that, for this DOS
  102.                     session, the operating system is to keep data in
  103.                     the received data buffer.
  104.         Default:    None.
  105.         Settable:   At VDM creation only.
  106.  
  107.       COM_SELECT
  108.         Function:   When set, this will allow a program to select
  109.                     and use one communication port.
  110.         Advantages:  You can limit your program to just the COM port
  111.                     that it requires, some programs like Laplink pro
  112.                     will try to take over every available  COM port.
  113.                     Communications that are not selected are hidden
  114.                     from the program.
  115.         Drawbacks:  Some programs need to have access to the COM
  116.                     ports to work, even if they are not using them.
  117.         Default:    All (Full access to the COM ports.)
  118.         Settable:   At VDM creation only.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.       DOS_AUTOEXEC
  128.         Function:   To specify a different batch file other than
  129.                     the default AUTOEXEC.BAT.
  130.       Advantages:   Different batch files could be specified for
  131.                     different dos programs.
  132.         Default:    AUTOEXEC.BAT in root directory.
  133.         Example:    A new batch file which contains some SET
  134.                     statements relative to an individual program, can
  135.                     be kept separately .
  136.         Settable:   At VDM creation only.
  137.  
  138.       DOS_BACKGROUND_EXECUTION
  139.         Function:   When set off, suspends execution of the program
  140.                     when it is in the background.
  141.         Advantages: Many DOS applications are written on the
  142.                     assumption that they  are  single  tasking  and
  143.                     that  all  the  resources  of  the work station
  144.                     can be monopolized. It is not uncommon for  a
  145.                     program to continually poll for keyboard input
  146.                     (Examples are WordPerfect 5.1 and Lotus 1-2-3
  147.                     R2.2).  In a multitasking environment, this can
  148.                     impact system performance,  especially when  more
  149.                     than one such program is running.  Turning the
  150.                     DOS application off when  its  virtual  DOS
  151.                     machine  is  in  the  background reduces its
  152.                     demands on the system.
  153.                     Also    see    "IDLE_SENSITIVITY"   in   and
  154.                     "IDLE_SECONDS"
  155.         Drawbacks:  Communications programs will fail if background
  156.                     execution  is turned off, as will DDE for Windows
  157.                     applications.
  158.                     Try  changing the values of IDLE_SECONDS and
  159.                     IDLE_SENSITIVITY before turning
  160.                     DOS_BACKGROUND_EXECUTION off.
  161.         Default:    On (Background execution is enabled).
  162.         Settable:   At any time.
  163.         Examples:   If more than two DOS programs are  running  and
  164.                     tuning  with IDLE_SENSITIVITY and IDLE_SECONDS
  165.                     does not provide sufficient improvement,  turn
  166.                     DOS_BACKGROUND_EXECUTION off for the least used
  167.                     application.
  168.  
  169.       DOS_BREAK
  170.         Function:   Enables  or  disables Ctrl+Break for the
  171.                     specified VDM.  Also check for  the  BREAK
  172.                     statement  in  the  CONFIG.SYS. Set BREAK=ON
  173.                     in the  CONFIG.SYS  to  make Ctrl+Break and
  174.                     Ctrl+C working in addition to setting DOS_BREAK
  175.                     on.
  176.        Advantages:  Enables  a  DOS  application  running  in  the
  177.                     VDM to be interrupted using the Ctrl+Break or
  178.                     Ctrl+C key sequences.
  179.         Drawbacks:  This setting is useful only if an application
  180.                     must be quickly interrupted;  the user may easily
  181.                     terminate a VDM by closing it from the Window
  182.                     List.
  183.  
  184.  
  185.  
  186.  
  187.         Default:    Off (Ctrl+Break is disabled).
  188.         Settable:   At VDM creation only.
  189.         Examples:   If the user wishes to have the  option  to
  190.                     interrupt  a  DOS  batch  file  running  in  a
  191.                     virtual DOS machine, this setting should be
  192.                     turned on.
  193.  
  194.       DOS_DEVICE
  195.         Function:   This  setting  can be used to add or modify
  196.                     information about DOS device drivers for the
  197.                     specified VDM, in addition to  the information
  198.                     specified in CONFIG.SYS.
  199.         Default:    When  this  setting  is  selected,  a list is
  200.                     displayed which contains information about each
  201.                     DOS device  driver  specified in CONFIG.SYS.  The
  202.                     information consists of the path and file name of
  203.                     each DOS device driver and its current
  204.                     parameters, if applicable.  For example:
  205.  
  206.                        c:\os2\mdos\ansi.sys
  207.  
  208.                     The user may:
  209.                     -   Type  the  name  of a DOS device driver to
  210.                         add it. Typing  should begin on a new line.
  211.                     -   Delete all the  information  about  a  device
  212.                         driver  to remove it.
  213.                     -   Type or delete to add, change, or delete a
  214.                         value.
  215.         Settable:   At VDM creation only.
  216.         Examples:   A program to support hardware such as a scanner
  217.                     may include a device  driver  that  is  needed
  218.                     only for itself. The device  driver should be
  219.                     loaded with the DOS_DEVICE  setting  instead
  220.                     of in the CONFIG.SYS.
  221.       DOS_FCBS
  222.         Function:   Specifies  the  maximum  number of file control
  223.                     blocks (FCBs)  which may be opened by
  224.                     applications running in the VDM.  Note that this
  225.                     setting affects  only  those  modules  which  use
  226.                     file-sharing.
  227.         Advantages: Reducing this setting may improve DOS application
  228.                     performance in  a  resource-constrained
  229.                     networking environment.  When the maximum number
  230.                     of FCBs is opened by an application, the least
  231.                     recently used FCB is closed to allow additional
  232.                     files  to  be opened; see DOS_FCBS_KEEP below.
  233.         Drawbacks:  Reducing  this  setting  to  an  excessively  low
  234.                     number may inhibit the  performance  of
  235.                     applications  which  use  large  numbers  of
  236.                     files.  Check  application  documentation  for
  237.                     recommended FCB settings.
  238.         Default:    16.
  239.         Settable:   At VDM creation only.
  240.         Examples:   None.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.       DOS_FCBS_KEEP
  248.         Function:   Specifies  the  number of file control blocks
  249.                     FCBs that will be protected against automatic
  250.                     closure.
  251.         Advantages: If this setting is specified as "n," the first
  252.                     "n" files are protected  against  automatic
  253.                     closure  as  described  in "DOS_FCBS".
  254.                     This may improve application
  255.                     performance.
  256.         Default:    8.
  257.         Settable:   At VDM creation only.
  258.         Examples:   None.
  259.  
  260.       DOS_FILES
  261.         Function:   Specifies  the  maximum  number  of file handles
  262.                     which may be opened in a VDM.
  263.         Advantages: Setting this  value  higher  than  the  default
  264.                     may  improve performance  for  applications
  265.                     which  use  a large number of files.    Check
  266.                     application  documentation  for  recommended
  267.                     settings.
  268.         Drawbacks:  Setting  the  number  of  file  handles higher
  269.                     than necessary reduces the available memory.
  270.         Default:    20.
  271.         Settable:   At any time.
  272.         Examples:   DBASE IV requires a DOS_FILES setting of at least
  273.                     40.
  274.       DOS_HIGH
  275.         Function:   Determines whether DOS is loaded outside the
  276.                     640KB low memory address space.
  277.         Advantages: Loading DOS into high memory allows more
  278.                     available memory for application code and data
  279.                     within the 640KB address space.
  280.         Drawbacks:  Applications which  require  access  to DOS
  281.                     internal control  structures require DOS to be
  282.                     loaded  into  low  memory,  and therefore cannot
  283.                     use this setting.
  284.         Default:    Off (DOS is loaded into low memory).
  285.         Settable:   At VDM creation only.
  286.         Examples:   None.
  287.  
  288.       DOS_LASTDRIVE
  289.         Function:   Specifies  the highest available logical drive
  290.                     letter for the  specified VDM.   This setting is
  291.                     similar  to  the  LASTDRIVE=  statement in a DOS
  292.                     CONFIG.SYS.
  293.         Default:    Z.
  294.         Settable:   At VDM creation only.
  295.         Examples:   Each  additional  drive  letter uses about 100
  296.                     bytes. Setting the LAST_DRIVE to a lower letter
  297.                     such as J or K provides more  conventional memory
  298.                     for an application.
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.       DOS_RMSIZE
  307.         Function:   Specifies  the DOS memory size.  This is the
  308.                     amount of memory which is available to DOS
  309.                     applications.
  310.         Advantages: The virtual video device driver uses this setting
  311.                     on  certain  video adapters to set even more than
  312.                     640KB.
  313.          Drawbacks: This  setting  is  of little use to most users
  314.                     as there is no point specifying less than 640KB.
  315.         Default:    The default is 640KB.
  316.         Settable:   At VDM creation only.
  317.         Examples:   None.
  318.  
  319.       DOS_SHELL
  320.         Function:   To specify the DOS command processor, or to add
  321.                     parameters to affect the command processor.  This
  322.                     points by default to COMMAND.COM.  If a user has
  323.                     a different command processor, it should be
  324.                     specified here.
  325.         Advantages: The  user  may  specify  a  command  processor
  326.                     other than the  default   COMMAND.COM,   if
  327.                     required  by  a  specialized application, or
  328.                     may alter the environment space available for
  329.                     the VDM.
  330.         Default:    C:\OS2\MDOS\COMMAND.COM C:\OS2\MDOS /P
  331.         Settable:   At VDM creation only.
  332.  
  333.       DOS_STARTUP_DRIVE
  334.         Function:   Specifies  the  location  of the DOS kernel to be
  335.                     loaded into  the VDM.
  336.         Advantages: Allows specific versions of DOS to be loaded into
  337.                     a VDM using  the VMB facility, allowing the
  338.                     execution of version-dependent DOS applications.
  339.         Drawbacks:  Performance may not be as good as the VDM
  340.                     kernel,  which  is  optimized for the OS/2
  341.                     environment.
  342.         Default:    The DOS Emulation kernel is loaded.
  343.         Settable:   At VDM creation only.
  344.         Examples:   See Chapter 12, "Virtual Machine Boot."
  345.  
  346.       DOS_UMB
  347.         Function:   Specifies  whether  DOS  owns  Upper Memory
  348.                     Blocks (UMBs) and manages the loading of device
  349.                     drivers and TSR programs.
  350.         Advantages: Setting DOS_UMB on allows use of the DEVICEHIGH=
  351.                     and LOADHIGH  statements, to load device  drivers
  352.                     and  TSR  programs  into Upper  Memory  Blocks,
  353.                     thereby preserving space in low memory for use by
  354.                     applications.
  355.         Drawbacks:  Certain applications which make use of UMBs  need
  356.                     to access and  manage the UMBs directly; such
  357.                     applications will not run when DOS_UMB is set on,
  358.                     because DOS owns the UMBs.
  359.          Default:   Off (UMBs are owned by certain types of TSR
  360.                     programs and  DOS  device  drivers if necessary).
  361.         Settable    At VDM creation only.
  362.         Examples:   None.
  363.  
  364.  
  365.  
  366.  
  367.       DOS_VERSION
  368.         Function:   Allows  the  operating  system to report a "fake"
  369.                     DOS version  number in response to a request from
  370.                     a program in the VDM, in order to support
  371.                     applications which check for a  DOS  version
  372.                     number.
  373.         Advantages: Allows some programs that will not start unless
  374.                     they detect a prerequisite DOS version to run in
  375.                     DOS Emulation.
  376.         Default:    20
  377.         Settable:   Before application initiation.
  378.         Examples:   Lotus  1-2-3  R3+ will run in DOS Emulation if it
  379.                     is "fooled"  into thinking that it is running
  380.                     under DOS 3.3 by putting the following lines into
  381.                     the DOS_Version list box:
  382.                     -   123DOS.EXE,3,30,255
  383.                     -   123.EXE,3,30,255
  384.                     -   LOTUS.EXE,3,30,255
  385.  
  386.       DPMI_DOS_API
  387.         Function:   Determines  whether  DOS  API  translation is
  388.                     enabled for the specified VDM.
  389.         Default:    AUTO (API translation is enabled if required).
  390.         Settable    At VDM creation only.
  391.         Examples:   None.
  392.  
  393.       DPMI_MEMORY_LIMIT
  394.         Function:   Specifies  the  maximum  amount  of protected
  395.                     mode memory (in megabytes) available to DPMI
  396.                     applications running in the VDM.
  397.        Advantages:  For applications which require large amounts of
  398.                     DPMI  memory, this setting may be used to increase
  399.                     the amount of available memory up to 512MB.
  400.         Default:    2MB.
  401.  
  402.         Settable    At VDM creation only.
  403.         Examples:   None.
  404.  
  405.       DPMI_NETWORK_BUFF_SIZE
  406.         Function:   Specifies  the  size,  in  kilobytes  (KB),  of
  407.                     the network translation buffer for DPMI programs
  408.                     in this session. The range is from 1 to 64 KB.
  409.         Default:    8KB.
  410.  
  411.         Settable    At VDM creation only.
  412.         Examples:   This setting  allows  you  to  configure  the
  413.                     size of the translation buffer for Windows
  414.                     programs that transfer data over  a network.
  415.                     If a network-specific Windows program does
  416.                     not run correctly under OS/2  V2.X  increase
  417.                     this  setting, then restart  the session.
  418.  
  419.       EMS_FRAME_LOCATION
  420.         Function:    This DOS setting allows you to change the
  421.                     location of the LIM EMS  region.   LIM EMS uses a
  422.                     64KB address region known as an  EMS page frame,
  423.  
  424.  
  425.  
  426.  
  427.                     through which programs  can  access  expanded
  428.                     memory. (This  allows  programs  to use more than
  429.                     640KB of  memory.)
  430.         Advantages: If a user has problems when running a program
  431.                     that uses  both a hardware  device  and LIM EMS
  432.                     expanded memory, the problem  may be due to
  433.                     conflicting use of addresses by LIM EMS and the
  434.                     hardware device.  If this occurs, the user should
  435.                     first  use  the  EMS_HIGH_OS_MAP_REGION  setting
  436.                     to set the extra address region used by EMS to 0.
  437.                     This may solve the problem.  If the  problem
  438.                     persists, the EMS_FRAME_LOCATION setting can be
  439.                     used to select 64KB region that does not conflict
  440.                     with hardware. The  user  can choose where to
  441.                     place the frame from a list of choices or can
  442.                     choose to have no EMS frame for programs which
  443.                     do not require a frame.   The user can also
  444.                     reduce  the  DOS Memory Size setting and place
  445.                     the frame below 640KB.
  446.      Drawbacks:     The  best  solution,  when problems due to
  447.                     hardware conflicts occur, is to use the
  448.                     MEM_EXCLUDE_REGIONS and MEM_INCLUDE_REGIONS
  449.                     settings  to  specify the addresses that
  450.                     the hardware uses rather than using this setting.
  451.       Default:      The default AUTO setting will lead to correct
  452.                     choices of LIM EMS addresses. Most  users will
  453.                     never need to change his setting.
  454.         Settable:   At VDM creation time only.
  455.         Examples:   In some cases the default choice may conflict
  456.                     with  addresses used  by  hardware  on the
  457.                     machine.  This can happen only for devices that
  458.                     are not supported by a virtual device driver.
  459.  
  460.       EMS_HIGH_OS_MAP_REGION
  461.         Function:   In  addition  to  the  EMS  page frame, some
  462.                     programs can use additional addresses to access
  463.                     expanded memory.  This setting gives advanced
  464.                     users the capability to adjust the size of the
  465.                     additional EMS region.
  466.                     See also "EMS_FRAME_LOCATION".
  467.        Advantages:  An  advanced  user  can  use  the
  468.                     MEM_EXCLUDE_REGIONS and MEM_INCLUDE_REGIONS
  469.                     settings to specify the addresses used by
  470.                     devices that do not have virtual device drivers,
  471.                     and can then set the size of the
  472.                     EMS_HIGH_OS_MAP_REGION appropriately for
  473.                     their program.  This helps avoiding conflicts with
  474.                     addresses used by devices and programs.
  475.         Default:    The  value  set  is the size of the region in
  476.                     kilobytes. The  default is 32KB.
  477.         Settable:   At VDM creation only.
  478.         Examples:   None.
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.       EMS_LOW_OS_MAP_REGION
  488.         Function:   Some programs can use remappable conventional
  489.                     memory. Others do  not use this feature.  This
  490.                     setting allows advanced users to  set  the  size
  491.                     of  the  remappable  conventional  memory
  492.                     available in a VDM.
  493.         Default:    The  value  set  is the size of the region in
  494.                     kilobytes.  The default is 384KB.
  495.         Settable:   At VDM creation only.
  496.         Examples:   None.
  497.  
  498.       EMS_MEMORY_LIMIT
  499.         Function:   This setting controls the amount of EMS memory
  500.                     available to a VDM.
  501.        Advantages:  The  user can set this to a higher value for
  502.                     running programs that require a large amount of
  503.                     EMS memory.  Other programs do not use EMS at
  504.                     all.  The size can be set to 0 in such  cases,
  505.                     to disable  EMS  support  for that VDM.   Programs
  506.                     generally state whether they use EMS on the box or
  507.                     in their manuals.
  508.         Default:    The value set is the size of the region in
  509.                     kilobytes. The default size is 2MB.
  510.         Settable:   At VDM creation time only.
  511.         Examples:   If a spreadsheet runs out of memory, the amount
  512.                     of EMS memory can be increased and the VDM
  513.                     restarted.
  514.  
  515.       HW_NOSOUND
  516.         Function:   Enables or disables sound started by a DOS
  517.                     program.
  518.        Advantage:   Any  sound from a program is heard unless sounds
  519.                     is disabled. An "x" in the check box indicates
  520.                     that the  sound  is  to  be  heard.
  521.        Drawbacks:   No error sound will be heard if HW_NOSOUND is
  522.                     turned on.
  523.         Default:    OFF.
  524.         Settable:   At any time, including while a program is running
  525.                     in a VDM.
  526.        Examples:    Output  from  a  music  program may be
  527.                     disabled when the user wishes to hear another
  528.                     music program, or switch to another session.
  529.  
  530.       HW_ROM_TO_RAM
  531.         Function:   Enabling  HW_ROM_TO_RAM  causes  the operating
  532.                     system to copy read-only memory (ROM) and run
  533.                     the  copy  in  32-bit  random  access  memory
  534.                     (RAM).    With  this  setting  enabled,  BIOS
  535.                     operations run faster and system utilities may
  536.                     patch BIOS.
  537.         Default:    OFF.
  538.         Settable:   At VDM creation only.
  539.         Examples:   This setting is useful if debugging the kernel.
  540.                     The  change would  allow  normal  breakpoints  to
  541.                     be set in ROM and allow stepping over calls and
  542.                     loops.
  543.  
  544.  
  545.  
  546.  
  547.         Warning:    If an application writes to a memory address used
  548.                     by the  ROM  while  this setting is enabled,  it
  549.                     may  cause  unpredictable results  for  that
  550.                     application  and for every application run
  551.                     thereafter in the VDM.
  552.  
  553.       HW_TIMER
  554.         Function:   When  enabled, allows an application to have
  555.                     direct access to the 8253 timer ports and
  556.                     prevents the operating system from trapping,
  557.                     or intercepting, the timer request and emulating a
  558.                     timer.
  559.        Advantages:  Certain timing-critical applications will not
  560.                     run  (or  will run  much  slower) if accesses to
  561.                     timer ports are trapped and virtualized.   In
  562.                     addition,  the  values  they  read  do  not
  563.                     accurately  reflect the amount of time passed
  564.                     because they do not take trapping  overhead  into
  565.                     account. Enabling this setting  allows  certain
  566.                     timing-dependent  code  to run more effectively.
  567.        Drawbacks:   Applications that change the divisor before this
  568.                     setting is enabled  and  then read the timer
  569.                     ports after the setting has been enabled may not
  570.                     function properly. If the setting is enabled
  571.                     first, the VDM will not detect changes to the
  572.                     divisor correctly,  and  the  simulated  interrupt
  573.                     frequency will be incorrect.  Also, multiple
  574.                     applications  using this  setting may interfere
  575.                     with one another.
  576.         Default:    Off.    Most  applications  will  operate
  577.                     normally with timer virtualization.
  578.        Settable:    At any time.  It is useful to alter this setting
  579.                     dynamically and watch for changes in application
  580.                     performance.
  581.        Examples:    The  ROMs  on  some  machines implement very brief
  582.                     delays by polling the timer ports.   These delays
  583.                     become  unacceptably long unless direct timer port
  584.                     access is allowed.
  585.  
  586.       IDLE_SECONDS
  587.         Function:   When  programs  appear  to  be  doing nothing but
  588.                     waiting for input, the operating system gives
  589.                     them  less  time  to  run. This  is  done  to
  590.                     give preference to programs that are doing
  591.                     useful work.  Some programs periodically appear to
  592.                     be waiting for input, but then change their
  593.                     behavior and continue after a time. This  setting
  594.                     disables  the "IDLE_SENSITIVITY" function for a
  595.                     period of time  after  useful  work  has  been
  596.                     detected.
  597.                     Also  see "IDLE_SENSITIVITY".
  598.                     below for more details on idle detection.
  599.        Advantages:  If a program appears to run slowly when there  is
  600.                     an  option for  the  user  to  provide  input,
  601.                     this  value  should  be increased.
  602.  
  603.  
  604.  
  605.  
  606.  
  607.        Drawbacks:   Setting the  value  too  high  gives  the  DOS
  608.                     program  more resources than it needs.
  609.        Default:     This  value  is  in  seconds.    The  default is
  610.                     no idle time allowed.
  611.         Settable:   The setting can be changed while the program  is
  612.                     running to tune it to the proper value.
  613.         Examples:
  614.                     -   A  game  may pause, for instance, to wait for
  615.                     the user to  make a choice, but then continues
  616.                     if the  user  does  not react.
  617.  
  618.                     -   When DOS 5 is run in a virtual machine boot
  619.                     session, the DOS shell may fail to complete
  620.                     displaying the directory of the C: drive if
  621.                     IDLE_SENSITIVITY is set too low.  IDLE_SECONDS
  622.                     should then be raised.
  623.  
  624.       IDLE_SENSITIVITY
  625.         Function:   The  idle sensitivity level sets a threshold for
  626.                     judging when applications will be considered
  627.                      idle. The value is the percentage   of
  628.                     the maximum possible  polling  rate  the
  629.                     application can perform.  If an application polls
  630.                     at  a  rate  higher than this value, it is
  631.                     considered "idle."
  632.  
  633.                     DOS programs often "poll" for input when they are
  634.                     waiting for a  user  response. For  instance, a
  635.                     program may wait for a response by repeatedly
  636.                     checking to see if the user has hit a key.  In a
  637.                     multitasking environment such as OS/2 Version 2.X,
  638.                     this  wastes  time  when  other  programs  could
  639.                     be running instead.   The  operating  system
  640.                     detects  idle programs  by looking  for a high
  641.                     rate of polling for input. When programs  are
  642.                     judged to be waiting for input, they are given
  643.                     less time to run.
  644.  
  645.                     For  example,  if  idle  sensitivity  is  set to
  646.                     75%, then an application repeatedly checking to
  647.                     see if input is  available would  have  to  do
  648.                     this  checking  at  more than 75% of the maximum
  649.                     possible rate before it would be judged idle.
  650.                     Idle detection is a "best  guess"  of  what  the
  651.                     program  is doing.    It  could  be that the
  652.                     program is polling at a very high  rate,  but  is
  653.                     still  doing  useful  work  in  between checking.
  654.                     It may be that the application checks at a fairly
  655.                     slow rate but still is doing nothing but waiting.
  656.                     The  idle sensitivity  threshold allows adjustment
  657.                     of the threshold for a  particular application.
  658.                     Also see "IDLE_SECONDS" in topic.
  659.        Advantages:  If an application receives input while running and
  660.                     seems to  run  slower than expected, the idle
  661.                     sensitivity should be set  to a higher value.
  662.                     This lets  the  application  poll  at  a
  663.  
  664.  
  665.  
  666.  
  667.                     higher rate without being judged idle.  Setting
  668.                     the level to  100 turns idle detection off
  669.                     altogether. The application will be allowed to
  670.                     poll for input as often as it likes.
  671.                     If an application is waiting for input and other
  672.                     applications do  not  appear to be running, the
  673.                     idle sensitivity should be  adjusted downward.
  674.                     This lowers the threshold for judging the
  675.                     application idle.
  676.         Default:    The default is 75%.
  677.         Settable:   The setting can be changed while the program  is
  678.                     running to tune it to the proper value.
  679.         Examples:   Overall system performance can usually be
  680.                     improved when there are  multiple DOS
  681.                     applications running if IDLE_SENSITIVITY is
  682.                     turned down.
  683.                     Also see "DOS_BACKGROUND_EXECUTION"
  684.  
  685.      *INT_DURING_IO
  686.        Function:    When set on, this creates a second thread for the
  687.                     application to use for interrupt handling when
  688.                     the primary thread is busy with I/O operations.
  689.        Advantage:   Very useful in multimedia applications, MSCDEX
  690.                     applications, and many  games.
  691.        Disadvantages:  This does create extra overhead on the system
  692.                     for processing  and memory requirements and can
  693.                     cause degradation of performance for other
  694.                     applications.
  695.         Default:    Off.
  696.        Settable:    At VDM creation only.
  697.         Example:    Unless your application is interrupt sensitive,
  698.                     leave this setting OFF.
  699.  
  700.       KBD_ALTHOME_BYPASS
  701.         Function:   When   enabled,  prevents  the  Alt+Home  key
  702.                     sequence from switching the VDM between full
  703.                     screen and windowed mode.
  704.        Advantages:  Enabling this setting allows normal behavior for
  705.                     applications which themselves make use of the
  706.                     Alt+Home key sequence.
  707.         Drawbacks:  When enabled, the user must  use  the  Ctrl+Esc
  708.                     sequence to switch to Presentation Manager from a
  709.                     full screen VDM, then  use the context menu of
  710.                     the class to switch  the VDM to windowed mode.
  711.         Default:    Off  (Alt+Home  will  cause  a switch between
  712.                     full screen and windowed mode).
  713.         Settable:   At any time.
  714.  
  715.       KBD_BUFFER_EXTEND
  716.        Function:    Increases a VDM's keyboard type-ahead buffer
  717.                     size.
  718.        Advantages:  Provides  greater  keystroke  buffering,
  719.                     consistent with the level available in VIO
  720.                     windows. Note that  Ctrl-Break will flush  the
  721.                     entire  buffer, just as it does with the standard
  722.                     buffer.
  723.  
  724.  
  725.  
  726.  
  727.        Drawbacks:   Applications which bypass the ROM BIOS  input
  728.                     buffer  and/or INT  16h  may not benefit from
  729.                     this feature.  There is also a small amount of
  730.                     additional memory overhead for every VDM.
  731.        Default:     On.
  732.                     Most applications will benefit, and those  that
  733.                     do  not  should not be adversely affected.
  734.        Settable:    At  any  time.   This facilitates easy
  735.                     experimentation by the user in the (rare) event
  736.                     that a problem does arise.
  737.  
  738.  
  739.       KBD_CTRL_BYPASS
  740.         Function:   When  enabled, inhibits  one  or more control
  741.                     key sequences, allowing an application in the VDM
  742.                     to use these sequences for its own purposes.
  743.        Advantages:  Enabling this setting allows normal behavior for
  744.                     applications  which make use of control key
  745.                     sequences normally used by OS/2
  746.        Drawbacks:   Enabling this setting may  prevent  certain
  747.                     operations  from being  performed  with  OS/2
  748.                     Version  2.X  and the Workplace  Shell.
  749.        Default:     NONE (All control key sequences behave in the
  750.                     normal manner).
  751.        Settable:    At any time.
  752.  
  753.       KBD_RATE_LOCK
  754.         Function:   Prevents  a DOS application in a VDM from
  755.                     changing the system keyboard repeat rate.
  756.        Advantages:  Insulates machine from applications that  modify
  757.                     the repeat rate in an uncontrolled or
  758.                     undesirable way.
  759.        Drawbacks:   Prevents  the  application's repeat  rate from
  760.                     taking effect even when the application is the
  761.                     focus session.
  762.        Default:     Off.  Most applications do not modify the  repeat
  763.                     rate, and those  that  do  are  generally in
  764.                     accordance with the user's wishes.
  765.        Settable:    At any time.
  766.  
  767.       MEM_EXCLUDE_REGIONS
  768.         Function:   This  setting  is used to specify address ranges
  769.                     which should be protected  from  use  by  EMS/XMS
  770.                     and  direct  access by applications.  This
  771.                     setting is intended for experienced users who
  772.                     understand the hardware.
  773.        Advantages:  This  setting  restricts the use of EMS/XMS on
  774.                     certain ranges in the region between RMSIZE and
  775.                     1MB.  It also protects these ranges from being
  776.                     touched by user applications by  portraying
  777.                     ROM there.
  778.        Drawbacks:   Some  hardware  adapters  stop functioning if
  779.                     their addresses are touched in random fashion.
  780.                     If these ranges  are  defined  excessively,  they
  781.                     will  adversely  impact  the function and
  782.                     performance of EMS and XMS services.
  783.  
  784.  
  785.  
  786.        Default:     By default, this setting is void.  Each address
  787.                     is specified in  hex  and if there is no range
  788.                     specified, the length taken is a page (4KB).
  789.        Settable:    At VDM creation only.
  790.  
  791.       MEM_INCLUDE_REGIONS
  792.         Function:   Specify  regions  which  should be made available
  793.                     to EMS/XMS. This setting is used to specify some
  794.                     address  ranges  between RMSIZE and 1MB for use
  795.                     by EMS and XMS.
  796.        Advantages:  If  there  is a hardware adapter in this range
  797.                     which the user knows is not going to be used by a
  798.                     particular  VDM  session, then  the  address
  799.                     range used by this adapter should be made
  800.                     available to EMS and XMS.  This will improve the
  801.                     performance of  EMS  and XMS services.   Only
  802.                     advanced users who now the addresses used by a
  803.                     card should use this setting.
  804.        Default:     By default, this setting is void.
  805.        Settable:    At VDM creation only.
  806.  
  807.       MOUSE_EXCLUSIVE_ACCESS
  808.         Function:   This  setting  allows VDMs to run applications
  809.                     which maintain  their own mouse pointers.  Some
  810.                     DOS applications manage their own  mouse
  811.                     positions  and  movements;  in  many  cases,  the
  812.                     application's  values  for  mouse  sensitivity
  813.                     and/or double speed threshold are  different  from
  814.                     those  of Presentation  Manager. As a result, a
  815.                     Presentation Manager mouse pointer may be outside
  816.                     the VDM  window while the application  pointer
  817.                     is somewhere  in  the window not receiving any
  818.                     mouse events. This means having two  asynchronous
  819.                     mouse  pointers  on the  screen.
  820.        Advantages:  The  user forces the physical mouse driver to
  821.                     send its events  directly to the virtual mouse
  822.                     driver  without  going  through  Presentation
  823.                     Manager. Only one mouse pointer appears when
  824.                     the particular VDM window has the focus.
  825.        Default:     OFF.
  826.        Settable:    At any time.
  827.  
  828.                     However, this only marks the VDM window and does
  829.                     not actually  activate the setting.  In order to
  830.                     activate it, the user must press a mouse button
  831.                     within the VDM window.  The Presentation
  832.                     Manager pointer  disappears,  leaving  only  the
  833.                     application pointer. In  order  to  regain  the
  834.                     Presentation  Manager pointer, the user  must
  835.                     press  any of the hot-keys  (Alt, Ctrl+Esc,
  836.                     Shift+Esc).
  837.        Examples:    WordPerfect 5.1 has its own block-shaped mouse
  838.                     pointer, which will  appear  together with the
  839.                     system mouse pointer when the window  has  the
  840.                     focus.  Turning  MOUSE_EXCLUSIVE_ACCESS  on
  841.                     allows  the  user  to remove the system mouse
  842.                     pointer when in  WordPerfect.
  843.  
  844.  
  845.  
  846.  
  847.       PRINT_TIMEOUT
  848.         Function:   Use  this  setting  to adjust the amount of time,
  849.                     in seconds, that the OS/2 V2.X print subsystem
  850.                     waits before forcing a print  job  to  the
  851.                     printer. In DOS, information sent by a program
  852.                     for printing goes directly to a  printer.
  853.                     However, the OS/2 V2.X print subsystem assembles
  854.                     print information in a spool file.   After a
  855.                     specified period of time, during which  the  spool
  856.                     file does not grow larger, OS/2 V2.X print
  857.                     subsystem sends the information to the printer  as
  858.                     a single print job.
  859.        Advantage:   There is no need to exit the DOS program before
  860.                     the print job is released by the OS/2 V2.X print
  861.                     subsystem. This is useful for applications
  862.                     which  do not explicitly close their print jobs.
  863.        Default:     15 seconds, configurable from 0 to 3600 seconds
  864.                     (0 seconds is no timeout).
  865.        Settable:    At any time.
  866.        Examples:    A timeout of 1 or 2 seconds is  sufficient  for
  867.                     small print jobs,  such  as copying the contents
  868.                     of the screen. However, when printing large
  869.                     files, formatting documents,  or  running
  870.                     calculations,  the value must be set high enough
  871.                     to allow all print results to reach the  spooler
  872.                     before  the  time limit expires. If  not,  results
  873.                     go  in two or  more spool files instead  of  one,
  874.                     and the resulting output may be unsatisfactory.
  875.  
  876.       VIDEO_FASTPASTE
  877.        Function:    Speeds up input from other sources than the
  878.                     keyboard.
  879.        Advantages:  Improves  the speed of paste operations
  880.                     from the clipboard to a DOS application.
  881.        Drawbacks:   Does not work with  all  applications  (in
  882.                     particular, some applications  which  monitor
  883.                     keyboard interrupts directly may experience
  884.                     errors).
  885.        Default:     Off.
  886.        Settable:    At any time.  This facilitates easy
  887.                     experimentation  by  the  user.
  888.        Examples:    Pasting into the DOS command prompt, or any
  889.                     application using DOS Console I/O functions, will
  890.                     generally work.  However, the Microsoft  Editor
  891.                     (M)  and  its  successor,  Programmer's Workbench
  892.                     (PWB), can fail when  using  fast  pasting
  893.                     because they  rebuffer  keystrokes  in  an
  894.                     internal buffer, which can overflow.
  895.  
  896.       VIDEO_MODE_RESTRICTION
  897.         Function:   Extends  the  640KB  DOS address space by
  898.                     limiting video mode support.
  899.        Advantages:  For text-based or CGA graphics based
  900.                     applications, the video memory normally reserved
  901.                     just above 640KB for high-resolution graphics
  902.                     modes  can  be  remapped  to  conventional
  903.  
  904.  
  905.  
  906.  
  907.                     memory, providing an additional 64KB (or 96KB,
  908.                     depending on  graphics mode)  for  DOS
  909.                     applications, TSRs, and other programs.  This
  910.                     is valuable for applications that do not take
  911.                     advantage of EMS or XMS memory extenders.
  912.        Drawbacks:   It is not possible to completely hide the fact
  913.                     that the video adapter is  high-resolution
  914.                     graphics-capable; some applications may
  915.                     attempt to enable those modes  and  use  the
  916.                     memory  above 640KB as video memory, inadvertently
  917.                     corrupting application data.  Care must therefore
  918.                     be  taken  when using this feature.
  919.        Default:     NONE.  The complete list of settings is:
  920.                     -   None
  921.                     -   CGA modes only (adds 96KB)
  922.                     -   MONO modes only (adds 64KB).
  923.        Settable:    At VDM creation only.
  924.  
  925.       VIDEO_ONDEMAND_MEMORY
  926.        Function:    Reduces swap space requirements for fullscreen
  927.                     VDMs.
  928.        Advantages:  Allows  a  full-screen  VDM  to  run
  929.                     without pre-allocating a virtual  video  buffer
  930.                     for the worst-case  video  modes high-resolution
  931.                     graphics modes).  Using this setting does
  932.                     not prevent execution of  graphics  applications;
  933.                     it simply means  that  allocation  of the buffer
  934.                     is delayed until it is needed.  This can save a
  935.                     substantial  amount  of  memory/swap space,
  936.                     which  might  be  important  under certain
  937.                     low-memory  conditions.  It also enables you to
  938.                     start a program quickly.
  939.        Drawbacks:   If allocation of a virtual video buffer for a
  940.                     full-screen VDM fails at the time the application
  941.                     changes video modes, the session  must  be
  942.                     frozen  and  switched  back  to the shell.
  943.                     Unless the user is able to free memory from
  944.                     another  session, he may  be  unable to get the
  945.                     DOS application running again.
  946.                     This is a concern if the application contains
  947.                     unsaved data.
  948.        Default:     Off.
  949.        Settable:    At any time.  This allows the user to save
  950.                     memory the next time the session is switched to
  951.                     full-screen.
  952.  
  953.       VIDEO_RETRACE_EMULATION
  954.         Function:   Simulates  the  video  retrace  status port to
  955.                     provide faster access.
  956.        Advantages:  DOS applications that poll  the  video  retrace
  957.                     status port often  write  to the screen only
  958.                     during the retrace interval, even though it is
  959.                     safe (on EGA and VGA adapters) to  draw  at
  960.                     any time without causing interference (also known
  961.                     as "snow").
  962.  
  963.  
  964.  
  965.  
  966.  
  967.                     This  feature causes most applications to write to
  968.                     the screen more often, and compensates for the
  969.                     performance drag imposed by monitoring the port
  970.                     in the first place.
  971.  
  972.        Drawbacks:   Some applications may poll the  port  in  such a
  973.                     way that overall performance is  worse;  this  is
  974.                     sometimes true of applications  that draw only
  975.                     during vertical (not horizontal)
  976.                     retrace.  Unfortunately, while turning  off  trace
  977.                     emulation will restore   performance,   there
  978.                     is a risk that screen-switching will not be
  979.                     as reliable.
  980.        Default:     On.  Reliable screen-switching has higher
  981.                     priority  over the minority  of  applications
  982.                     that will experience some drag in  performance.
  983.         Settable:   At any time.  This  allows  the  user  to
  984.                     experiment  with different settings in the event
  985.                     of a performance problem.
  986.  
  987.       VIDEO_ROM_EMULATION
  988.         Function:   Emulates selected INT 10h ROM Video functions.
  989.        Advantages:  Provides  faster output for selected video
  990.                     functions than ROM services typically provide.
  991.                     This also has a dramatic  effect on the
  992.                     performance of those functions in a window.
  993.        Drawbacks:   Some  ROMs  may offer enhanced services that are
  994.                     not included in the  emulation.    Applications
  995.                     which  rely  upon  these services may not execute
  996.                     correctly.
  997.         Default:    On. Because   the   INT   10h  ROM  Video
  998.                     services are well-documented,  incompatibilities
  999.                     are  unlikely and the performance   benefits
  1000.                     of  using  the  emulation  are  quite
  1001.                     significant.
  1002.        Settable:    At any time.  This allows the user to experiment
  1003.                     in the event of a compatibility problem.
  1004.  
  1005.       VIDEO_SWITCH_NOTIFICATION
  1006.         Function:   Notifies  a  DOS  application of a switch to/from
  1007.                     full-screen mode.
  1008.        Advantages:  Allows applications that monitor this
  1009.                     notification to redraw their  screens  as
  1010.                     needed. This may be necessary for some video
  1011.                     adapters that provide modes (and applications that
  1012.                     use those  modes) which are not fully supported
  1013.                     by the OS/2 video driver or which  are  slightly
  1014.                     incompatible. It is also valuable  in
  1015.                     situations  where  an OS/2 video driver has not
  1016.                     allocated a virtual video buffer (see "
  1017.                     "VIDEO_8514_XGA_IOTRAP" Use this setting  if  you
  1018.                     use  the  VIDEO_ONDEMAND_MEMORY  DOS setting,
  1019.                     because concurrent buffer allocation and screen
  1020.                     switching can make a screen go black.
  1021.        Drawbacks:   When used indiscriminately,   this   feature   may
  1022.                     cause innecessary   and   time-consuming  screen
  1023.                     redrawing.  For standard MONO/CGA/EGA/VGA video
  1024.                     modes, the OS/2 video driver should   be  able  to
  1025.                     restore application screens without assistance.
  1026.        Default:     Off.  For standard hardware and standard  video
  1027.                     modes,  this feature is not necessary.
  1028.        Settable:    At any time.  This allows the user to experiment
  1029.                     in the event of a compatibility problem.
  1030.        Examples:    Windows  2.x  and  3.x  understand this
  1031.                     notification and will redraw themselves
  1032.                     accordingly. For WIN-OS/2  sessions,  set this
  1033.                     setting on.
  1034.  
  1035.       VIDEO_WINDOW_REFRESH
  1036.         Function:   Adjusts the window update frequency for a given
  1037.                     VDM.
  1038.        Advantages:  For applications (particularly graphics)   that
  1039.                     write frequently to video memory, this value can
  1040.                     be increased to reduce time  spent  updating  the
  1041.                     window  and  provide more processor time for the
  1042.                     application.
  1043.  
  1044.  
  1045.  
  1046.  
  1047.                     Note:  This has no effect on updates based  on
  1048.                     other  events such   as  keyboard  input
  1049.                     or synchronous  scrolling operations or
  1050.                     any video events other than refresh.
  1051.        Drawbacks:   A large refresh period can make an application  u
  1052.                     unusable  (or at least, very hard to use).
  1053.        Default:     0.1  seconds.   This has been found to yield the
  1054.                     best overall performance.
  1055.        Settable:    At any time, in increments of 0.1 seconds.   This
  1056.                     allows for experimentation.  The range is from
  1057.                     0.1 to 60.0 seconds.
  1058.        Examples:    This  setting affects normal TTY-style output.
  1059.                     Compare a DIR or TYPE operation before and after
  1060.                     altering this setting.
  1061.  
  1062.       VIDEO_8514_XGA_IOTRAP
  1063.         Function:   When  set  OFF, unrestricted access to 8514/A
  1064.                     display adapter hardware.   Note that this
  1065.                     setting  is  only  available  for systems with
  1066.                     8514/A display adapters installed.
  1067.        Advantages:  Achieves higher  performance  for  8514/A
  1068.                     applications  and  eliminates the overhead  of
  1069.                     the  1MB  8514/A  virtual  video  buffer normally
  1070.                     allocated for each VDM when set OFF.
  1071.        Drawbacks:   Screen-switching  away  from  the  application
  1072.                     will result in immediate freezing of the
  1073.                     application, and the system may not be able to
  1074.                     reliably switch back; that is,  the  screen  image
  1075.                     may not be  correct.    This  may  be  overcome
  1076.                     by setting VIDEO_SWITCH_NOTIFICATION on, which
  1077.                     notifies applications to redraw  their  own screen
  1078.                     images. Note however, that not all applications
  1079.                     will take advantage of the notification.
  1080.                     Note:  An application with this setting enabled
  1081.                     may  not  be run  in  windowed  mode,  or
  1082.                     copied to the clipboard, because there is
  1083.                     no  complete  information  about  its state.
  1084.         Default:    Off.
  1085.         Settable:   At VDM creation only.
  1086.         Examples:   When  executing  Windows  3.0 with the 8514/A
  1087.                     display driver, certain operations such as
  1088.                     painting dithered backgrounds will run
  1089.                     significantly faster.
  1090.  
  1091.  
  1092.       WIN_CLIBOARD
  1093.         Function:   When set on, this will allow the session to share
  1094.                     clipboard information among OS/2, DOS (window),
  1095.                     and Windows programs. While this setting is on
  1096.                     the clipboard is public.
  1097.  
  1098.                     Windows programs can share data with other DOS,
  1099.                     Windows, and OS/2 programs, as long as you select
  1100.                     public clipboard on the Data exchange page from
  1101.                     WIN-OS/2  setup object, in the sytem folder.
  1102.                     Otherwise, you can share information only with
  1103.                     other Windows programs in that session. When that
  1104.                     setting is set to off, the clipboard is privateand
  1105.                     Windows programs cannot share clipboard
  1106.                     information with other DOS, Windows, and OS/2
  1107.                     programs.
  1108.         Default:    On (Public).
  1109.         Settable:   At any time.
  1110.  
  1111.       WIN_DDE
  1112.         Function:   When set on, this will enable sharing of data
  1113.                     among other OS/2 and Windows programs.  While
  1114.                     enabled the dynamic data exchange (DDE) is public.
  1115.                     Windows programs that support DDE automaticly
  1116.                     update identical data in other Windows and OS/2
  1117.                     programs.
  1118.  
  1119.                     If you select public DDE on the Data Exchange page
  1120.                     from the WIN-OS2 Setup object, in the system setup
  1121.                     folder. Otherwise, you can share information only
  1122.                     with other Windows programs. When this setting is
  1123.                     set to off, DDE private and Windows programs
  1124.                     cannot share DDE information with
  1125.                     other windows and OS/2 programs.
  1126.  
  1127.                     Note: If you are running multiple Windows programs
  1128.                     in a single WIN-OS/2 session and the program
  1129.                     supports the DDE feature, it is possible to share
  1130.                     DDE information between these programs even when
  1131.                     this setting is off (Private).
  1132.         Default:    On (Public).
  1133.         Settable:   At any time.
  1134.  
  1135.       WIN_RUN_MODE
  1136.         Function:   This setting is only listed in the WIN-OS/2
  1137.                     setting window and does not apply to DOS window or
  1138.                     DOS full-screen sessions.
  1139.  
  1140.                     OS/2 can use two modes to run Windows programs:
  1141.  
  1142.                     -  3.1 Standard
  1143.                     -  3.1 Enhanced
  1144.        Default:     3.1 Standard.
  1145.  
  1146.       XMS_HANDLES
  1147.         Function:   Specifies  the  number  of  XMS  extended  memory
  1148.                     block (EMB) handles.  A handle is used with each
  1149.                     XMS EMB. This number is required because XMS
  1150.                     pre-allocates all the handle space to be
  1151.                     compatible with XMS specifications.  This setting
  1152.                     should be used only if an application uses a large
  1153.                     number of handles.
  1154.        Advantages:  This  setting  restricts the number of block
  1155.                     handles, thereby reducing memory consumption.
  1156.        Drawbacks:   Specifying a large number of  handles  will
  1157.                     increase  memory consumption and adversely impact
  1158.                     system performance.
  1159.  
  1160.        Default:     The default value of this setting is 32.
  1161.        Settable:    At VDM creation only.
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.       XMS_MEMORY_LIMIT
  1168.         Function:   Specifies  the per VDM XMS memory limit.  This
  1169.                     setting should be used under the  same
  1170.                     guidelines  as  described  above  in "XMS_HANDLES"
  1171.                     The global limit is the overall maximum XMS memory
  1172.                     consumption, and the per-VDM limit is the  maximum
  1173.                     allowed for each VDM. See also "Initialization"
  1174.                     for defining global and per-VDM limit in the
  1175.                     CONFIG.SYS.
  1176.         Drawbacks:  Specifying  a  large  number  may  adversely
  1177.                     affect system performance.
  1178.         Default:    The default value is 2MB per-VDM.
  1179.         Settable:   At VDM creation only.
  1180.  
  1181.       XMS_MINIMUM_HMA
  1182.         Function:   Specifies  the  minimum  HMA  memory  request
  1183.                     allowed. This setting allows the user  to  fine
  1184.                     tune the XMS. HMA is slightly  less  than
  1185.                     64KB in size. Only one request can be fulfilled
  1186.                     from this area at a time.
  1187.        Advantages:  If a TSR takes a very small allocation, then  it
  1188.                     will waste this  area for other applications.
  1189.                     In such cases a limit can be specified.
  1190.        Default:     The default value is zero, which means all the
  1191.                     requests will be allowed.
  1192.        Settable:    At VDM creation only.
  1193.        Examples:    2048; this sets a limit of 2KB.
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.        Report by:  OS/2 Dosap Analyst Team - 06/94
  1201.                    IBM - Boca Raton, Florida
  1202. 12/31/99
  1203.