January 1999 This purpose of this document is to provide updated information on how to setup and run RA on an OS/2 machine. There are several changes that must be made to an OS/2 machine to run RA properly. The affected areas are discussed below: ----------------------------------------------------- OS/2 SIO (POSSDOS) device channel interrupt conflicts ----------------------------------------------------- On an OS/2 machine, the parallel printer port usually owns interrupt 7. The default interrupt for the SIO device channel is also IRQ 7 and there will be conflicts if both the printer port and the SIO device channel try to share IRQ 7. The solution is to change the IRQ used by the SIO device channel from IRQ 7 to IRQ 11. This change can be made in the following way: 4694 - 1. Use the hardware setup utility by pressing F2 at bootup or by pressing CTRL-ALT-S depending on the 4694 model. 2. Change the setting for the SIO channel from IRQ 7 to IRQ 11. Note that some versions of the 4694 setup program will state IRQ 9 as the alternative IRQ. Actually, the setup program is displaying the incorrect IRQ number. It is fine to select IRQ 9 in this case, but keep in mind that you are really using IRQ 11 since this may be significant if you add other cards or devices to the 4694. PC with 7497 (Yaupon, POS attachment kit) - Manually change the dip switch setting on the 7497 card to IRQ 11 by following the 7497 product documentation. ------------------------------------------ OS/2 DOS alphanumeric POS keyboard support ------------------------------------------ If you are using the IBM alphanumeric POS keyboard then you must install replacement OS/2 keyboard drivers. These drivers are available in the POSSDOS package. Please refer to the POSSDOS package readme file OS2KEY.TXT for further information. The OS2KEY.TXT readme file describes two different activities: 1. Replacing the OS/2 keyboard drivers KBDBASE.SYS and VKBD.SYS with the OS/2 keyboard drivers supplied with the POSSDOS package and modifying the OS/2 CONFIG.SYS. This change will then allow the POSSDOS driver NKY-BIOS.SYS to function properly when it is loaded as a DOS device driver for a particular DOS session (see below). 2. Setup and use of the AIPANPOS.EXE utility. This OS/2 keyboard utility is only required if you are planning on creating a double key on the alphanumeric POS keyboard. If you are not creating a double key then you do not need to setup this program. All double keys on the alphanumeric POS keyboard can be setup with the RA keyboard personalization program EXCEPT for the double key. The key must be doubled only using AIPANPOS.EXE and you must ensure that you do not attempt to double the key via the RA keyboard personalization program. If you need to use the AIPANPOS.EXE program to create a double key on the alphanumeric POS keyboard then follow the instructions from the OS2KEY.TXT file. After you have completed the setup instructions for AIPANPOS.EXE from OS2KEY.TXT, you can modify the AIPSYS.RES to include the following line for the double key: aipanpos.system.doubleKey02:109,108 After you reboot the OS/2 machine, the key should be doubled when the STARTUP.CMD is complete. ------------------------- OS/2 DOS session settings ------------------------- The purpose of this section is to provide the most recent update to the OS/2 DOS session settings as documented in Section 6.2.5 in the IBM Retail Application/DOS LAN Guidelines redbook publication (SG24-4343-01). This document overrides all previous documents describing the proper OS/2 DOS session settings for RA. If a specific DOS session setting is not listed here, then the setting should be left as default unless there is a reason to change it for specific customer requirements. DOS_DEVICE - If you are using a 4694 or a PC with a 7497 POS attachment kit then this section should contain all POSSDOS device drivers. The format of the device driver statements will be the same as the statements in a pure DOS CONFIG.SYS except that the DEVICE= portion of the statement is not specified in this section. DOS_FILES - 100 DOS_HIGH - ON to provide more memory for RA, but this setting is not required. DOS_SHELL - If you want to increase your environment space for environment variables, then you can add the following statement to the end of the default shell statement: /e:2000 Note that this is the same way you increase your environment space in a pure DOS CONFIG.SYS shell statement. DOS_UMB - OFF (this may be the default) DPMI_DOS_API - ENABLED (This change is required for compiling and linking RA user exits. It is not required for running RA.) EMS_MEMORY_LIMIT - 4096 HW_TIMER - ON IDLE_SECONDS - 0 IDLE_SENSITIVITY - 1 MEM_EXCLUDE_REGIONS - If you are using a 4694, then you should add the device channel exclude region as follows: D8000-DAFFF Note that this statement is similar to the exclude range specified with EMM386.EXE in a pure DOS CONFIG.SYS. However, under an OS/2 DOS session, the memory offsets are specified with 5 characters instead of 4 characters. XMS_MEMORY_LIMIT - 4096