home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.ib.com
/
2003-04-09_ftp.ibm.com-os2.zip
/
videopak
/
xga
/
readme.txt
next >
Wrap
Text File
|
1998-05-14
|
20KB
|
684 lines
OS/2 DEVICE DRIVER FOR IBM XGA
This package contains the following:
o An OS/2* graphics device driver supporting the
IBM XGA, and XGA-2 chip sets from IBM, Corp.
o This README file, which is formatted for viewing
on your screen. You can:
- Use the Table of Contents and section numbers
to help you locate specific topics.
- Use the Find option in the Edit menu of the
OS/2 System Editor to help you locate
specific information.
- Print the file.
IMPORTANT
PLEASE READ THE FOLLOWING TERMS AND CONDITIONS. YOUR
USE OF THE OS/2 DEVICE DRIVER FOR THE XGA / XGA-2
INDICATES YOUR ACCEPTANCE OF THE FOLLOWING TERMS AND
CONDITIONS:
o YOU MUST BE, AND YOU AGREE THAT YOU ARE, A PRIOR
LICENSEE OF OS/2.
o YOU MAY MAKE COPIES OF THE OS/2 DEVICE DRIVER FOR
THE XGA, XGA-2 EQUAL TO THE NUMBER OF LICENSED
COPIES OF OS/2 YOU POSSESS.
o ALL OTHER TERMS AND CONDITIONS OF YOUR OS/2
LICENSE AGREEMENT APPLY TO THIS OS/2 DEVICE
DRIVER FOR THE XGA, XGA-2; HOWEVER, THIS DOES
NOT EXTEND ANY WARRANTY OUTLINED IN SUCH
AGREEMENT.
CONTENTS
________
Section
Supported Features . . . . . . . . . . . . . . . 1
Supported Resolutions . . . . . . . . . . . . . 1
Supported Adapters . . . . . . . . . . . . . . 1
Supported Columns and Rows . . . . . . . . . . 1
Compatibility . . . . . . . . . . . . . . . . . . 2
Preliminary Steps . . . . . . . . . . . . . . . . 3
Installation from Diskette . . . . . . . . . . . 4
Installation in a CID Environment . . . . . . . . 5
Functional Restrictions . . . . . . . . . . . . 6
Setting Your Display to VGA Mode . . . . . . . 7
APAR Fixes Included in This Driver 8
Trademarks . . . . . . . . . . . . . . . . . . 9
1.0 SUPPORTED FEATURES
_______________________
The XGA / XGA-2 device driver provides seamless
support for display graphics and advanced color
resolutions when used with the minimum required
video memory. It conforms to the OS/2 32-bit flat
memory model and is designed to function as a 32-bit
Presentation Manager* graphics display driver under
the OS/2 32-bit graphics engine. This driver has
been enabled for use with the IBM* Display Console
Access Facility (DCAF) product.
SUPPORTED RESOLUTIONS
This video driver supports these resolutions and
color depths:
Number of Video Memory
Resolutions Colors Required
640 x 480 16 512k
1024 x 768 16 512k
1280 x 960 16 1 MB
1280 x 1024 16 1 MB
1360 x 1024 16 1 MB
640 x 480 256 1 MB
800 x 600 256 XGA-2 only
1024 x 768 256 1 MB
640 x 480 65536 XGA-2 only
800 x 600 65536 XGA-2 only
SUPPORTED ADAPTERS
IBM has tested systems containing the XGA, XGA-2
chip sets with the specified amount of memory.
IBM XGA
IBM XGA-2
SUPPORTED COLUMNS AND ROWS
This XGA, XGA-2 device driver supports the
following number of columns and rows in an OS/2
full-screen session:
Columns Rows
132 25
132 43
2.0 COMPATIBILITY
__________________
This graphics driver is compatible with
OS/2 Warp versions 3 and 4.
3.0 PRELIMINARY STEPS
______________________
The following steps prepare your computer for the
XGA, XGA-2 device driver:
1. You must have OS/2 DOS Support installed in order
to install this driver.
2. The OS/2 ATTRIB command is used during
installation of the device driver. If you
elected not to install the OS/2 Optional System
Utilities or you have deleted the ATTRIB command,
use Selective Install and select Change File
Attributes to restore the ATTRIB command before
continuing.
3. If you previously installed XGA support, return
to VGA resolution using the procedures in
"Setting Your Display to VGA Mode" later in this
README before you install this driver.
4.0 INSTALLATION FROM DISKETTE
_______________________________
To install the XGA, XGA-2 device driver from
diskette, do the following:
1. Insert the XGA, XGA-2 diskette into drive A (or
any other diskette drive).
2. Open an OS/2 full-screen or OS/2 window session.
3. At the OS/2 command prompt, type the following
command to copy all necessary files to the OS/2
drive:
A:SETUP A: C:
(where A: is the diskette drive, and C: is the
drive where OS/2 is installed.)
Then press Enter.
4. When prompted to do so, remove the diskette from
drive A, perform a shutdown, and then restart
your computer.
5. Open the OS/2 System folder.
6. Open the System Setup folder.
7. Open the Display Driver Install object.
When the Display Driver Install window appears,
"XGA, XGA-2 (BBS)"
should be the default choice. If not, select it.
Then select OK.
8. When the Monitor Configuration/Selection Utility
window appears, the "Install Using Defaults for
Monitor Type" choice is preselected. You can
accept this choice or select "Install Using
Display Adapter Utility Program" to choose a
different refresh rate. Then select OK.
If you select the "Install Using Display Adapter
Utility Program" choice, you must have a DOS
monitor utility that came with your display
adapter. Contact the display adapter
manufacturer's technical support for information
on how to use the monitor utility under OS/2.
9. When the Source Directory pop-up window appears,
insert the XGA, XGA-2 diskette into drive A.
Then select Install.
10. When the installation is complete, do the
following:
a. Open the OS/2 System folder.
b. Open the System Setup folder.
c. Open the System object.
d. When the Settings notebook appears, select
the Screen tab. Then go to Screen Page 2.
e. On Screen Page 2, select your display from
the display list. If your display does not
appear in the list, select Default.
f. Return to Screen Page 1 and select a
resolution and a screen refresh rate.
g. Close the Settings notebook.
h. Perform a shutdown and restart your computer.
Note that during the installation of this driver,
DISPLAY.LOG and DSPINSTL.LOG files are created in the
OS2\INSTALL directory. These files identify the OS/2
system files that were updated and indicate whether
the installation was successful. The contents of
these files might be useful if you need to report an
installation problem to IBM.
5.0 INSTALLATION IN A CID ENVIRONMENT
______________________________________
NOTES:
1. The server must contain a directory named TS_DRVS
on the same drive where the OS/2 diskettes
reside. The XGA_DRVS directory must contain all
of the files from the XGA, XGA-2 device driver
diskette.
2. OS/2 must have been successfully installed on the
client using the CID (Configuration Installation
Distribution) method.
To install the XGA, XGA-2 device driver using CID,
use the following information to modify your LCU
command file.
NOTE: The following information is meant as a guide.
Your LCU command file might be different.
/*****************************************************/
/* LCU PRODUCT DATA SECTION */
/*****************************************************/
.
.
.
x.xgavideo = 15
x.15.name='XGA Video'
x.15.statevar = 'CAS_' || x.15.name
x.15.instprog = 'x:\img\xga_drvs\SETUP.CMD',
' x:\img\xga_drvs ' || bootdrive || ' CID'
x.15.rspdir = ''
x.15.default = ''
x.xgadspinstl = 16
x.16.name='XGA CID Dspinstl'
x.16.statevar = 'CAS_' || x.16.name
x.16.instprog = bootdrive || '\os2\install\DSPINSTL.EXE',
' /pd:' || bootdrive || '\os2\install\bbsxga.dsc',
' /s:x:\img\xga_drvs',
' /t:' || bootdrive,
' /res:640x480x256'
' /u'
x.16.rspdir = ''
x.16.default = ''
/*---------------------------------------------------*/
/* NUMBER OF PROGRAMS SET UP IN THE */
/* PRODUCT DATA SECTION */
/*---------------------------------------------------*/
NUM_INSTALL_PROGS = 16
/*****************************************************/
/* INSTALLATION SECTION */
/*****************************************************/
.
.
.
when OVERALL_STATE = 2 then do
if RunInstall(x.xgavideo) == BAD_RC then exit
Call RebootAndGotoState(3)
end
when OVERALL_STATE = 3 then do
if RunInstall(x.xgadspinstl) == BAD_RC then exit
Call CheckBoot
end
.
.
.
/******************************************************/
/* ROUTINE SECTION */
/* The following information should already exist in */
/* the LCU command file. */
/******************************************************/
.
.
.
RebootAndGotoState:
parse arg new_state, other
rc2 = SetState(new_state, 'RebootAndGotoState', 1) /* Set the state */
/* to go to in */
/* OVERALL_STATE */
Call SaveStates /* Save the environment vars */
Call Reboot /* Reboot the machine */
return
.
.
.
/*****************************************************/
END OF LCU INFORMATION TO BE ADDED
/*****************************************************/
Following is an explanation of the line that is
executed in the LCU command file:
C:\OS2\INSTALL\DSPINSTL /pd:c:\os2\install\bbsxga.dsc
/S:X:\img\xga_drvs /T:C: /res:640x480x256 /u
/pd:c:\os2\install\bbsxga.dsc
is the dsc laid down during setup phase.
/S:X:\img\xga_drvs
where X:\img\xga_drvs is the redirected source path.
/T:C:
where C: is the drive where OS/2 is installed.
/res:640x480x256
is a resolution/color depth from the list of "Supported
Resolutions" that appears earlier in this README.
/u
means Unattended installation.
NOTES:
1. Be sure you have the stated video memory
required, as listed in "Supported Resolutions"
earlier in this README. A safe choice is
640x480x256. Any of the listed resolutions can
be selected, but your display might be damaged if
you select a resolution that your display does
not support.
2. After the XGA, XGA-2 device driver has been
successfully installed on the client machine
using the CID method and the client machine is
restarted, the resolution will be as specified by
command line argument.
6.0 FUNCTIONAL RESTRICTIONS
____________________________
o Users of the software motion video feature of
MMPM/2* should expect satisfactory results in
256-color modes. However, in 64K-color modes,
users of the feature will experience unusual
results. An OS/2 pervasive fix package will be
available electronically. The software motion
video feature is not supported in 16-million
color modes.
o CorelDRAW** 2.0 will not run in a WIN-OS/2*
window session. It must be run in a WIN-OS/2
full-screen session.
o Micrografx** Charisma 2.1 will not run in a
WIN-OS/2 window session. It must be run in a
WIN-OS/2 full-screen session.
o Display Console Access Facility (DCAF) is
supported in 256-color modes only.
7.0 SETTING YOUR DISPLAY TO VGA MODE
_____________________________________
Use the following procedures to return to VGA mode.
NOTE: If your display is out of sync, start OS/2
using the OS/2 Installation Diskette, insert
Diskette 1 when prompted, then press F3 to
display a command prompt. Use the following
instructions to reset your display mode:
o If you are installing this driver on OS/2 Warp,
returning to VGA mode has been simplified. Do
the following:
1. Turn on your computer. If your computer is
already on, press Ctrl+Alt+Del to restart it.
2. When a small white box appears in the upper
left-hand corner of your screen, press
Alt+F1.
3. When the Recovery Choices screen appears,
press V.
Your display adapter is restored and can work in
VGA mode. If you want to install a new display
adapter or video device driver, refer to Chapter
16, "Video Procedures," in the User's Guide to
OS/2 Warp.
o If you are installing this driver on OS/2 2.11,
or OS/2 for Windows, and you installed from
diskettes, do the following:
1. Be sure RSPDSPI.EXE is in the \OS2\INSTALL
directory. If it is, go to step 2. If it is
not, insert Diskette 8 into drive A and
unpack RSPDSPI.EXE with the following
command:
C:\OS2\UNPACK A:\INSTAID C: /N:RSPDSPI.EXE
(where A: is the drive containing Diskette 8,
and C: is the drive where OS/2 is installed.)
2. Type C: and then press Enter.
3. Type CD C:\OS2\INSTALL and then press Enter.
4. Type the following:
RSPDSPI /PK:VGA /SK:NONE /S:A:\ /T:C:
(In /T:C:, C: is the drive where OS/2 is
installed. In /S:A:, A: is the diskette
drive you use to install OS/2.)
Then press Enter.
o If you are installing this driver on OS/2 2.11,
or OS/2 for Windows, and you installed from
CD-ROM or a LAN, do the following:
1. Be sure RSPDSPI.EXE is in the \OS2\INSTALL
directory. If it is, go to step 2. If it is
not, unpack RSPDSPI.EXE with the following
command:
C:\OS2\UNPACK E:\DISK_8\INSTAID C: /N:RSPDSPI.EXE
(where C: is the drive where OS/2 is
installed, and E: is the CD-ROM or LAN
drive.)
2. Type C: and then press Enter.
3. Type CD C:\OS2\INSTALL and then press Enter.
4. Type the following:
RSPDSPI /PK:VGA /SK:NONE /S:E:\OS2SE21\ /T:C:
(In /T:C:, C: is the drive where OS/2 is
installed. In /S:E:, E: is the CD-ROM or LAN
drive.)
Then press Enter.
8.0 APAR FIXES INCLUDED IN THIS DRIVER
_______________________________________
Some fixed APARs may not be listed. If you received this
driver through the IBM OS/2 support channel and your requested
APAR is not listed, please install the driver, as your
requested APAR is included.
************************
APARS FIXED DRIVER D.036
************************
APAR= PJ16327
TRAP AT VDHFREEZEMEM+9 WITH XGA LOADED 0160: FFF70990 REV 8.162
APAR= PJ16610
IMAGE REDRAW AND SCALE VERY SLOW USING IMAGE KEY BY SCS AND
XGA-2 DEVICE DRIVER IBMXGA32.DLL IN WARP.
APAR= PJ16627
TRAP 000D IN VIDEOCFG.DLL WHEN FILLING THE LIST BOX ON 2ND PAGE
OF SYSTEM ICON/SCREEN TAB IN WARP RUNNING XGA.
APAR= PJ17027
USER TESTCASE DISPLAYS A BLACK LINE IN WINDOW AS EXPECTED IN VGA
BUT DISPLAYS AS BLUE LINE IN XGA UNDER WARP.
APAR= PJ18372
UNABLE TO RUN DOS F/S ON A MONOCHROME CARD AS SECONDARY DISPLAY
UNDER WARP
APAR= PJ18513
1 DOT LINE COLUD NOT DISPLAY AT THE CASE OF XGA, S3
APAR= PJ18786
CUT & PASTE OPERATION DOES NOT DRAW LINE IN PC3270 FOR OS/2 V4.0
UNDER XGA WITH V2.11 AND IBMXGA32.DLL FROM ANY FIXPAK 80 THRU 95
APAR= PJ19438
TRAP000E IN OS2KRNL VDHFREEZEVDM LOGGING OFF RESTRICTED
WORKPLACE SHELL USING XGA 2 WITH FULL SCREEN WINOS2 SESSION
APAR= PJ20987
SYS3175 IN IBMXGA32.DLL 0003:0001B739 WHEN MAXIMIZING A 3270
CM/2 SESSION FROM THE DESKTOP
APAR= PJ21220
AFTER APPLYING FIXPACK 14 ON AN XGA SYSTEM, LOTUS 123 R4 FOR
WINDOWS NO LONGER ACCEPTS KEYBOARD INPUT.
************************
APARS FIXED DRIVER F.041
************************
APAR= PJ19332
A TRAP OCCURS WHEN CALLING GPICORRELATECHAIN() IN WM_CREATE'S
ROUTINE.
APAR= PJ22534
GREEK CODEPAGE VECTOR LOST WHEN CHANGING FONTS
APAR= PJ22854
WITH FP 21 APPLIED FONTS IN LOTUS NOTES EVENTUALLY BECOME
CORRUPTED AND MACHINE HANGS
************************
APARS FIXED DRIVER F.046
************************
APAR= PJ22229
WHEN USER PASTE THE BITMAP ONTO WORD AND PRE-VIEW, THEY GOT GPF
APAR= PJ22360
FONT CORRUPTION USING PCOM 4.0 FOR DOS UNDER WARP
APAR= PJ22656
TRAP IN PMGPI WHEN MOVING A BITMAP OUTSIDE A FRAME IN LOTUS
WORDPRO.
APAR= PJ22695
SCREEN PAGE IS MISSING IN SYSTEM NOTEBOOK BBS XGA DRV.
APAR= PJ22872
CAN NOT FORMAT DISKETTE FROM WIN-OS2 FILE MANAGER FULL SCREEN .
ON 5551-LXX .
APAR= PJ23156
WITH XGA, SOME WINDOWS TAKE UP MORE AREA, DEPENDING ON MONITOR
TYPE
APAR= PJ23345
VIDEO CORRUPTION WITH XGA AND LOTUS NOTES 4.1 .
************************
APARS FIXED DRIVER 0.050
************************
APAR= PJ23457
CHANGE IN VPIC.SYS PROHIBITS ANY DEVICE FROM USING IRQ 2/9 IN A
VDM
************************
APARS FIXED DRIVER A.054
************************
APAR= JR10816
WINOS2 SESSION HANGS ON EXIT WHEN WARPCENTER IS UPDATING TIME OR
DISK MONITOR USING XGA DRIVER.
APAR= PJ24336
PS-56/57 XGA.. WHEN LOW ON RESOURCES OPENING A VDM
CAUSES THE SYSTEM TO HANG
APAR= PJ24385
GPIBITBLT PRODUCES DITHERED OUTPUT WHEN IT SHOULD BE SOLID
APAR= PJ24646
XGA DRIVER SEMAPHORE STILL HELD AFTER A THREAD TERMINATES
APAR= PJ24775
LEFT BORDER LINE OF MINI ICON IS NOT DRAWN IN XGA MODE.
************************
APARS FIXED DRIVER A.072
************************
APAR= JR10389
DOTTED-LINE SHOW/HIDE LEAVING VIS. GARBAGE, 648X480, MULT. VID.
APAR= JR10694
XGA ON 9577 HANGS WHEN TRYING TO OPEN DOS FULLSCREEN
SESSION WITH CGA VIDEO_MODE_RESTRICTION
9.0 TRADEMARKS
_______________
The following terms, denoted by an asterisk (*) in
this file, are trademarks or registered trademarks of
IBM Corporation in the United States and/or other
countries:
IBM
MMPM/2
OS/2
Presentation Manager
PS/ValuePoint
WIN-OS/2
The following terms, denoted by a double asterisk
(**) in this file, are trademarks or registered
trademarks of other companies as follows:
TRADEMARK OWNER
After Dark Berkely Systems, Inc.
CorelDRAW Corel Corporation
Dell Dell Computer Corporation
Diamond Stealth Diamond Computer Systems,
Inc.
Lotus Lotus Development
Corporation
Micrografx Micrografx Incorporated
Ventura Publisher Ventura Software, Inc.
Windows Microsoft Corporation
WordPerfect WordPerfect Corporation
1-2-3 Lotus Development
Corporation
IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR
IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND
MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN
THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM
GRANTS NO LICENSES TO ANY RELATED PATENTS OR
COPYRIGHTS.
THIS DRIVER IS COPYRIGHTED BY INTERNATIONAL BUSINESS
MACHINES CORPORATION. ALL APPROPRIATE RESTRICTIONS
APPLY.
(End of Document)