config.gml

开放源码的编译器open watcom 1.6.0版的源代码

.* (c) Portions Copyright 1990, 1995 by Tenberry Software, Inc.
.*
.chap Configuring &dos4gprd
.*
.np
This chapter explains various options that can be specified with the
.ev DOS4G
environment variable including how to suppress the banner that is
displayed by &dos4g at startup.
.ix 'extended memory'
It also explains how to use the
.ev DOS16M
environment variable to select the switch mode setting, if necessary,
and to specify the range of extended memory in which &dos4g will
operate.
&dos4g is based on Tenberry Software's DOS/16M 16-bit Protected-Mode
support;
hence the
.ev DOS16M
environment variable name remains unchanged.
.*
.section The DOS4G Environment Variable
.*
.np
A number of options can be selected by setting the
.ev DOS4G
environment variable.
The syntax for setting options is:
.millust begin
set DOS4G=option1,option2,...
.millust end
.np
Do not insert a space between
.ev DOS4G
and the equal sign.
A space to the right of the equal sign is optional.
.begnote Options:
.note QUIET
.ix 'DOS4G' 'QUIET option'
.ix 'QUIET'
Use this option to suppress the &dos4g banner.
.np
The banner that is displayed by &dos4g at startup can be suppressed by
issuing the following command:
.millust begin
set DOS4G=quiet
.millust end
.np
.bi Note:
Use of the quiet switch is only permitted pursuant to the terms and
conditions of the WATCOM Software License Agreement and the additional
redistribution rights described in the
.book Getting Started
manual.
Under these terms, suppression of the copyright by using the quiet
switch is not permitted for applications which you distribute to
others.
.note VERBOSE
.ix 'DOS4G' 'VERBOSE option'
.ix 'VERBOSE'
Use this option to maximize the information available for postmortem
debugging.
.np
Before running your application, issue the following command:
.millust begin
set DOS4G=verbose
.millust end
.np
Reproduce the crash and record the output.
.note NULLP
.ix 'DOS4G' 'NULLP option'
.ix 'NULLP'
Use this option to trap references to the first sixteen bytes of
physical memory.
.np
Before running your application, issue the following command:
.millust begin
set DOS4G=nullp
.millust end
.endnote
.np
To select a combination of options, list them with commas as
separators.
.exam begin
set DOS4G=nullp,verbose
.exam end
.*
.section Changing the Switch Mode Setting
.*
.np
.ix '&dos4gprd' 'switch mode setting'
In almost all cases, &dos4g programs can detect the type of machine
that is running and automatically choose an appropriate real- to
protected-mode switch technique.
For the few cases in which this default setting does not work we
provide the
.ev DOS16M
DOS environment variable, which overrides the default setting.
.np
Change the switch mode settings by issuing the following command:
.millust begin
set DOS16M=value
.millust end
.pc
Do not insert a space between
.ev DOS16M
and the equal sign.
A space to the right of the equal sign is optional.
.np
The table below lists the machines and the settings you would use with
them.
Many settings have mnemonics, listed in the column "Alternate Name",
that you can use instead of the number.
Settings that you must set with the
.ev DOS16M
variable have the notation
.us req'd
in the first column.
Settings you may use are marked
.us option,
and settings that will automatically be set are marked
.us auto.
.np
.ix 'NEC 98-series switch mode setting'
.ix 'PS/2 switch mode setting'
.ix 'Fujitsu FMR-70 switch mode setting'
.ix 'Hitachi B32 switch mode setting'
.ix 'OKI if800 switch mode setting'
.ix 'IBM PS/55 switch mode setting'
.ix 'switch mode setting' 'NEC 98-series'
.ix 'switch mode setting' 'PS/2'
.ix 'switch mode setting' 'Fujitsu FMR-70'
.ix 'switch mode setting' 'Hitachi B32'
.ix 'switch mode setting' 'OKI if800'
.ix 'switch mode setting' 'IBM PS/55'
.cp 18
.in 0
.if '&format' eq '8.5x11a' .do begin
.se c0=1+1
.se c1=&c0.+8
.se c2=&c1.+16
.se c3=&c2.+8
.se c4=&c3.+11
.se c5=&c4.+36
.do end
.el .do begin
.se c0=1+1
.se c1=1+6
.se c2=1+19
.se c3=1+28
.se c4=1+36
.se c5=1+60
.do end
.tb set $
.tb &c0 &c1 &c2 &c3 &c4 &c5
.se c0=&c0.-1
.se c1=&c1.-1
.se c2=&c2.-1
.se c3=&c3.-1
.se c4=&c4.-1
.se c5=&c5.-1
.bx on &c0 &c1 &c2 &c3 &c4 &c5
$      $               $       $Alternate
$Status$Machine        $Setting$Name      $Comment
.bx
$auto  $386/486 w/ DPMI$0      $None      $Set automatically if DPMI is active$
$req'd $NEC 98-series  $1      $9801      $Must be set for NEC 98-series$
$auto  $PS/2           $2      $None      $Set automatically for PS/2$
$auto  $386/486        $3      $386, 80386$Set automatically for 386 or 486$
$auto  $386            $INBOARD$None      $386 with Intel Inboard$
$req'd $Fujitsu FMR-70 $5      $None      $Must be set for Fujitsu FMR-70$
$auto  $386/486 w/ VCPI$11     $None      $Set automatically if VCPI detected$
$req'd $Hitachi B32    $14     $None      $Must be set for Hitachi B32$
$req'd $OKI if800      $15     $None      $Must be set for OKI if800$
$option$IBM PS/55      $16     $None      $May be needed for some PS/55s$
.bx off
.tb set
.tb
.in &INDlvl
.np
The following procedure shows you how to test the switch mode setting.
.autonote
.note
If you have one of the machines listed below, set the
.ev DOS16M
environment variable to the value shown for that machine and specify a
range of extended memory.
For example, if your machine is a NEC 98-series, set
.mono DOS16M=1 @2M-4M.
See the section entitled :HDREF refid='rsicfgf'. in this chapter for
more information about setting the memory range.
.np
.if '&format' eq '8.5x11a' .do begin
.se c0=&INDlvl+2+8
.se c1=&INDlvl+2+29
.se c2=&INDlvl+2+39
.do end
.el .do begin
.se c0=&INDlvl+2+8
.se c1=&INDlvl+2+23
.se c2=&INDlvl+2+30
.do end
.tb set $
.tb &c0 &c1
.se c0=&c0.-2
.se c1=&c1.-2
.se c2=&c2.-2
.bx &c0 &c1 &c2
$Machine$Setting
.bx
$NEC 98-series       $1
$Fujitsu FMR-60,-70  $5
$Hitachi B32         $14
$OKI if800           $15
.bx off
.tb set
.tb
.np
Before running &dos4g applications, check the switch mode setting by
following this procedure:
.note
.ix 'PMINFO'
Run PMINFO and note the switch setting reported on the last line of
the display.
(PMINFO, which reports on the protected-mode resources available
to your programs, is described in more detail in the
chapter entitled :HDREF refid='rsiutls'.)
.np
If PMINFO runs, the setting is usable on your machine.
.note
If you changed the switch setting, add the new setting to your
AUTOEXEC.BAT file.
.endnote
.np
.bd Note:
PMINFO will run successfully on 286 machines.
If your &dos4g application does not run, and PMINFO does, check the
CPU type reported on the first line of the display.
.np
You are authorized (and encouraged) to distribute PMINFO to your
customers.
You may also include a copy of this section in your documentation.
.*
.section *refid=rsicfgf Fine Control of Memory Usage
.*
.np
.ix '&dos4gprd' 'memory control'
In addition to setting the switch mode as described above, the
.ev DOS16M
environment variable enables you to specify which portion of extended
memory &dos4g will use.
The variable also allows you to instruct &dos4g to search for extra
memory and use it if it is present.
.*
.beglevel
.*
.section Specifying a Range of Extended Memory
.*
.np
.ix '&dos4gprd' 'memory range'
Normally, you don't need to specify a range of memory with the
.ev DOS16M
variable.
You must use the variable, however, in the following cases:
.begbull
.bull
You are running on a Fujitsu FMR-series, NEC 98-series, OKI
if800-series or Hitachi B-series machine.
.bull
You have older programs that use extended memory but don't follow one
of the standard disciplines.
.bull
You want to shell out of &dos4g to use another program that requires
extended memory.
.endbull
.np
If none of these conditions applies to you, you can skip this section.
.np
The general syntax is:
.code begin