*******************************************************************************
* How to use the IBM 3270 Emulation Credit Card Adapter Enablers *
*******************************************************************************
-------------------------------------------------------------------------------
Table of Contents
-------------------------------------------------------------------------------
1. About the IBM 3270 Emulation Credit Card Adapter Enablers
1-1. Introduction
Support for Personal Communications/3270
1-2. Enabler Software
1-3. Which Enabler Should You Use?
2. About the Card-Services Interface and Enabler
2-1. Card-Services Interface
2-2. Card-Services Enabler
3. Installing an Enabler
4. Executing an Enabler
4-1. Card-Services Enabler - CS3270.EXE
4-1-1. Software Requirements
4-1-2. To execute the Enabler from CONFIG.SYS
4-1-3. To execute the Enabler at the DOS prompt
4-1-4. Optional Parameters
4-1-5. Memory Requirements
4-2. PNT3270.EXE, SHRP3270.EXE, TOSH3270.EXE
4-2-1. To execute the Enabler from CONFIG.SYS
4-2-2. To execute the Enabler at the DOS prompt
4-2-3. Optional Parameters
4-2-4. Memory Requirements
4-3. Descriptions of Optional Parameters
4-4. If you are using EMM386.EXE
4-5. Using Resource Map Utility
5. Error Messages
6. Using IBM Personal Communications/3270 (PC/3270)
6-1. Changing the Shared-RAM Buffer Address
6-1-1. Full-Function DOS Mode
6-1-2. Entry-Level DOS mode
6-1-3. Windows Mode
6-2. Other
6-2-1. Supported Hardware
6-2-2. Using the IBM ThinkPad 720/720C Suspend Mode
6-2-3. Functional restrictions
7. Trademarks
-------------------------------------------------------------------------------
1. About the IBM 3270 Emulation Credit Card Adapter Enablers
-------------------------------------------------------------------------------
1-1. Introduction
-----------------
This file describes the installation and configuration of the enabler
programs for the IBM 3270 Emulation Credit Card Adapter (3270 CCA). These
enablers are used to configure the Personal Computer Memory Card
International Association (PCMCIA) slot-hardware and the adapter.
Having executed the necessary Enabler, you can use 3270-emulation software
with a DFT or CUT connection.
IBM Personal Communications/3270 v3 (PC/3270) is supported by the 3270 CCA
in all its modes - Full-Function DOS, Entry-Level DOS and Windows. Please
refer to section 6 for full information.
1-2. Enabler Software
---------------------
Four different Enablers are included on the diskette; their names and
versions are:
- CS3270.EXE Version 2.00
- PNT3270.EXE Version 2.00
- SHRP3270.EXE Version 1.10
- TOSH3270.EXE Version 1.10
1. CS3270.EXE is an Enabler that uses the Card-Services Interface,
release 2.00.
Once CS3270 has run, it stays in system memory and handles 3270 CCA
status changes, such as removal and insertion. CS3270 needs about 4kb
of memory and can be loaded high.
2. PNT3270.EXE is a Point Enabler that communicates directly with the
PCMCIA-interface LSI. It can be used to configure the 3270 CCA in IBM
computers or in computers which have an Intel 82365SL chip; this chip is
a PCMCIA-interface LSI that is common to many systems. PNT3270.EXE
should be used when Card-Services software does not exist in the
computer or when the version of Card Services in the computer does not
communicate correctly with CS3270.EXE.
3. The computers from Sharp and Toshiba use their own PCMCIA-interface LSI,
not the Intel 82365SL, so we have provided the following Point Enablers:
SHRP3270.EXE for Sharp computers, such as the 6781
TOSH3270.EXE for Toshiba computers, such as the T3300SL
Once PNT3270.EXE, SHRP3270.EXE or TOSH3270.EXE has run and has
configured the hardware successfully, it is removed from system memory.
Note: To configure the 3270 CCA, one - and only one - of the above Enablers
must be used.
As soon as the Enabler has configured the hardware successfully, the
3270 CCA can be used in the same way as the IBM 3278/79 Emulation Adapter
or IBM 3270 Connection.
An Enabler assigns system resources to the 3270 CCA as follows:
------------------------------------------------
Shared-RAM range : CE000H - CFFFFH (changeable)
Shared-RAM size : 8K bytes (fixed)
I/O-port range : 2D0H - 2DFH (fixed *1)
I/O-port size : 16 bytes (fixed)
Interrupt level : IRQ 9 (fixed *2)
------------------------------------------------
*1: CS3270.EXE and PNT3270.EXE can change this range.
*2: IRQ 9 is redirected to IRQ 2.
1-3. Which Enabler Should You Use?
----------------------------------
This depends on several factors: how much memory you can afford; what
interface your PC provides; what interface your applications can use; and
how much flexibility you want.
Some computers do not have the Card-Services interface and therefore
cannot use CS3270.EXE, so you are forced to use a Point Enabler; the
Sharp 6781 and the Toshiba T3300SL are examples of such computers.
The PNT, SHRP and TOSH enablers (which are Point Enablers) do not need
the Socket-Services or Card-Services interfaces and remove themselves from
memory when they have loaded, so they do not consume any memory
permanently.
The CS3270 Card-Services enabler needs the Socket-Services and Card-
Services interfaces and remains in memory; these three drivers need 34kb
of memory, though they can often be loaded high.
However, Card Services provides some significant advantages:
- you can remove and insert cards without switching off the PC
- you can put a card into any slot; CS3270 will find and configure it.
If you use the Point Enablers, you must specify the slot number, which
means that you really have to use the same slot each time.
- Card Services can manage the use of system resources, thus avoiding
conflicts between clients. PNT, SHRP and TOSH cannot prevent such
conflicts; the enabler that is loaded last will take over the
resources it needs, even if they are being used by another card.
-------------------------------------------------------------------------------
2. About the Card-Services Interface and Enabler
-------------------------------------------------------------------------------
2-1. Card-Services Interface
----------------------------
The Card-Services interface is defined in the PCMCIA Card-Services-
Interface Specification and is a standard; it is provided by Card-Services
software.
Card-Services software gains access to hardware through another standard
interface called Socket Services; this is provided by Socket Services
software, which accesses the hardware directly.
Card-Services software manages credit-card adapters, slots and system
resources and coordinates the use of them by multiple clients. CS3270.EXE
is such a client and is used to configure the IBM 3270 Credit Card Adapter.
Card-Services software can detect status changes such as the insertion,
removal, etc of the card and can notify clients of these changes.
The Socket-Services and Card-Services software is provided on the optional
diskette for the PC, together with an installation program which inserts
the drivers into CONFIG.SYS.
2-2. Card-Services Enabler
--------------------------
While the CS3270.EXE Card-Services Enabler is resident in memory, it can
handle two status-change events - Card Insertion and Card Removal.
If any credit-card adapter is inserted, the card-services software
generates a Card-Insertion event and notifies CS3270, which checks whether
the card is a 3270 CCA. If it is, CS3270 attempts to configure the card.
If a credit-card adapter is removed, a Card-Removal event is generated. If
CS3270 is notified of the removal of a 3270 CCA which it has configured, it
disables the use of the card.
Note: One instance of CS3270.EXE can handle only one 3270 CCA.
-------------------------------------------------------------------------------
3. Installing an Enabler
-------------------------------------------------------------------------------
No special installation process is needed; just copy the Enabler to the
hard disk or diskette from which you want it to run.
-------------------------------------------------------------------------------
4. Executing an Enabler
-------------------------------------------------------------------------------
The Enablers can be executed from CONFIG.SYS or at the DOS prompt.
4-1. Card-Services Enabler - CS3270.EXE
---------------------------------------
4-1-1. Software Requirements
----------------------------
The following software must be loaded before CS3270.EXE is executed:
- Socket-Services software (IBMDSSxx.SYS *) which conforms to PCMCIA
Socket Services release 2.00.
* xx depends on your PC type.
- Card-Services software (IBMDOSCS.SYS) which conforms to PCMCIA Card
Services release 2.00.
Note: Socket Services and Card-Services software is shipped on the
optional diskette for the computer.
4-1-2. To execute the Enabler from CONFIG.SYS
---------------------------------------------
1) Add the following line to your CONFIG.SYS file after the lines which
load the Socket-Services and Card-Services software:
DEVICE=drive:\path\CS3270.EXE [optional parameters]
2) Reboot your computer
3) During CONFIG.SYS processing, the Enabler is loaded and, if a usable
3270 CCA is found, CS3270 attempts to configure it. If configuration
succeeds, a message is displayed:
IBM 3270 Credit Card Adapter Configured Successfully
This is followed by information about the assigned system resources
(shared-RAM address, I/O-port address and interrupt level).
If the Enabler cannot configure the 3270 CCA because there is no
usable 3270 CCA or the requested system resources are not available,
the Enabler is nevertheless loaded into memory and the following
message is displayed:
3270 Card-Services Enabler is loaded
In this case, the 3270 CCA will be configured automatically when it is
next inserted.
If the Enabler fails to load, an appropriate error message is
displayed. Please refer to Chapter 5, 'Error Messages', for an
explanation.
Here is an example of a CONFIG.SYS file, using IBM DOS 5.02
in the IBM ThinkPad 720/720C
BREAK=ON
BUFFERS=20
FILES=30
LASTDRIVE=Z
FCBS=16,8
SHELL=C:\DOS\COMMAND.COM /P /E:512
STACKS=9,256
DEVICE=C:\DOS\SETVER.EXE
DEVICE=C:\DOS\HIMEM.SYS
DOS=HIGH
DEVICE=C:\DOS\POWER.EXE
DEVICE=C:\IBMDSS02.SYS <--- Socket Services
DEVICE=C:\IBMDOSCS.SYS <--- Card Services
DEVICE=C:\DICRMU02.SYS
DEVICE=C:\$ICPMDOS.SYS
DEVICE=C:\CC3270\CS3270.EXE <--- Enabler
4-1-3. To execute the Enabler at the DOS prompt
-----------------------------------------------
1) Ensure that the Socket-Services and Card-Services device drivers are
specified in CONFIG.SYS as shown above.
2) If the Enabler is on a diskette, insert the diskette into drive A
and change the current drive to A:
If the Enabler is on the hard disk, make its directory current
3) At the DOS prompt, enter
CS3270 [optional parameters]
4) If a usable 3270 CCA is found, the Enabler attempts to configure it.
If configuration succeeds, a message is displayed:
IBM 3270 Credit Card Adapter Configured Successfully
This is followed by information about the assigned system resources
(shared-RAM address, I/O-port address and interrupt level).
If the Enabler cannot configure the 3270 CCA because there is no
usable 3270 CCA or the requested system resources are not available,
the Enabler is nevertheless loaded into memory and the following
message is displayed:
3270 Card-Services Enabler is loaded
In this case, the 3270 CCA will be configured automatically when it
is next inserted.
If the Enabler fails to load, an appropriate error message is
displayed. Please refer to Chapter 5, 'Error Messages', for an
explanation.
4-1-4. Optional Parameters
--------------------------
The following optional parameters are available:
/? - Displays a brief help screen
/B=hhhh - Shared-RAM Address
/P=hhh - I/O-Port Address
(h = hexadecimal digit)
Default: CS3270 /B=CE00 /P=2D0
For more details about optional parameters, please refer to Chapter 4-3,
'Descriptions of Optional Parameters'.
4-1-5. Memory Requirements
--------------------------
The memory requirements of the IBM device drivers are as follows:
Load high?
IBMDSS0n.SYS Socket Services 5kb Y
IBMDOSCS.SYS Card Services 25kb Y*
CS3270.EXE Enabler 4kb Y
* This may be difficult to load high because of its size
4-2. PNT3270.EXE, SHRP3270.EXE, TOSH3270.EXE
--------------------------------------------
The following example shows how to execute the PNT3270 Enabler. If you
have a Sharp or Toshiba computer, you must use SHRP3270 or TOSH3270
instead of PNT3270.
4-2-1. To execute the Enabler from CONFIG.SYS
---------------------------------------------
1) Add the following line to your CONFIG.SYS file:
DEVICE=drive:\path\PNT3270.EXE [optional parameters]
2) Make sure that the 3270 CCA is inserted in the slot
3) Reboot your computer
4) During CONFIG.SYS processing, the Enabler is loaded and attempts to
configure the 3270 CCA. If it succeeds, a message is displayed:
IBM 3270 Credit Card Adapter Configured Successfully
This is followed by information about the assigned system resources
(shared-RAM address, I/O-port address and interrupt level).
If the Enabler fails to configure the 3270 CCA correctly, an approp-
riate error message is displayed. Please refer to Chapter 5, 'Error
Messages', for an explanation.
Here is an example of a CONFIG.SYS file, using IBM DOS 5.02
in the IBM ThinkPad 720/720C
BREAK=ON
BUFFERS=20
FILES=30
LASTDRIVE=Z
FCBS=16,8
SHELL=C:\DOS\COMMAND.COM /P /E:512
STACKS=9,256
DEVICE=C:\DOS\SETVER.EXE
DEVICE=C:\DOS\HIMEM.SYS
DOS=HIGH
DEVICE=C:\DOS\POWER.EXE
DEVICE=C:\CC3270\PNT3270.EXE <--- Enabler
4-2-2. To execute the Enabler at the DOS prompt
-----------------------------------------------
1) Make sure that the 3270 CCA is inserted in the slot
2) If the Enabler is on a diskette, insert the diskette into drive A
and change the current drive to A:.
If the Enabler is on the hard disk, make its directory current
3) At the DOS prompt, enter
CS3270 [optional parameters]
4) The Enabler attempts to configure the 3270 CCA. If it succeeds, a
message is displayed:
IBM 3270 Credit Card Adapter Configured Successfully
This is followed by information about the assigned system resources
(shared-RAM address, I/O-port address and interrupt level).
If the Enabler fails to configure the 3270 CCA correctly, an approp-
riate error message is displayed. Please refer to Chapter 5, 'Error
Messages' for an explanation.
4-2-3. Optional Parameters
--------------------------
The following optional parameters are available.
/? - Displays a brief help screen
/S=n - PCMCIA-slot Number
/B=hhhh - Shared-RAM Address
/P=hhh - I/O-Port Address
(n = decimal digit)
(h = hexadecimal digit)
Default: PNT3270 /S=1 /B=CE00 /P=2D0
Note: /S and /P are not available for SHRP3270.EXE and TOSH3270.EXE
For more details about optional parameters, please refer to Chapter 4-3,
'Descriptions of Optional Parameters'.
4-2-4. Memory Requirements
--------------------------
Since PNT3270, SHRP3270 and TOSH3270.EXE are removed from memory after they
have been loaded, they have no permanent memory requirement.
4-3. Descriptions of Optional Parameters
----------------------------------------
/B=hhhh Default: /B=CE00
This option is available for all the Enablers. It specifies
the starting-segment address in system memory at which the
shared RAM of the 3270 CCA will be located. This address must
be in an available memory area between C0000h and DFFFFh and
must be on an 8kb boundary. Therefore, valid values of hhhh
are:
C000, C200, C400, ......DC00, DE00
The shared-RAM address set by this option must match the
address specified by the communication software which
uses the 3270 CCA. Generally, the software uses the default
value (CE00); this should not be changed unless there is a
reason that the default address cannot be used.
/P=hhh Default: /P=2D0
This option is available for CS3270.EXE and PNT3270.EXE. It
specifies the address in the I/O-port range that a 3270 CCA
will use. If only one Card is to be used, the default value
(2D0) must be set; if multiple Cards (up to 4) are to be
used, the addresses for the 2nd, 3rd or 4th Cards must be
changed.
Valid values of hhh are:
2D0 ... First adapter
6D0 ... Second adapter
AD0 ... Third adapter
ED0 ... Fourth adapter
/S=n Default: /S=1
This option is available for PNT3270.EXE only. It specifies
the number of the slot in which the 3270 CCA is inserted.
This option is needed when the Card is inserted in a slot
other than no. 1.
Valid values of n are 1 to 4.
Here is an example of the statements required if there are 2 IBM 3270 CCAs
in a computer:
DEVICE=C:\CC3270\CS3270.EXE /B=CE00 /P=2D0
DEVICE=C:\CC3270\CS3270.EXE /B=CC00 /P=6D0
4-4. If you are using EMM386.EXE
--------------------------------
If you are using EMM386.EXE (which is usually specified in CONFIG.SYS),
a conflict of shared-RAM usage can occur between the Enabler and EMM386.
To prevent this, you should use the 'X' option of EMM386 to exclude the
shared-RAM address of the Enabler.
Here is an example of the necessary statement:
:
DEVICE=C:\DOS\EMM386.EXE ..... X=C000-CFFF
:
DEVICE=C:\CC3270\CS3270.EXE (or PNT3270.EXE)
4-5. Using Resource Map Utility
-------------------------------
To prevent a conflict of Shared-RAM usage between the Card-Services
Enabler and EMM386 or others, you can use the Resource Map Utility.
Resource Map Utility (DICRMUxx.SYS; xx depends on your computer) is a
device driver, which is shipped with PCMCIA device drivers(Card-Services
software, etc) on the optional diskette for the IBM computer, and is
automatically installed into the CONFIG.SYS with Socket-Services and
Card-Services drivers by the installation program.
Resource Map Utility program has '/MA' optional parameter which specifies
Shared-RAM range to be kept for the Card-Services usage. The Card-Services
Enabler CS3270.EXE can request Shared-RAM within its range to the Card-
Services.
Note: Before the Resource Map Utility is loaded, the Card-Services
software must be loaded.
If you are using EMM386.EXE with Resource Map Utility, the same range
specified by the '/MA' option of the utility should be excluded by using
the 'X' option of EMM386.
Here is an example of the necessary statement:
:
DEVICE=C:\DOS\EMM386.EXE ..... X=C000-CFFF
:
DEVICE=C:\IBMDSS02.SYS <--- Socket Services
DEVICE=C:\IBMDOSCS.SYS <--- Card Services
DEVICE=C:\DICRMU02.SYS /MA=C000-CFFF <--- Resource Map Utility
:
DEVICE=C:\CC3270\CS3270.EXE <--- Card-Services Enabler
-------------------------------------------------------------------------------
5. Error Messages
-------------------------------------------------------------------------------
Defined error messages and their possible causes are listed below:
Message: An invalid parameter has been specified.
Cause : An undefined optional parameter has been specified or the format
of a defined parameter is wrong.
Message: Card Services cannot be found.
Cause : Card-Services software has not been loaded or the loaded Card-
Services software does not conform to PCMCIA Card Services
release 2.00.
Message: This level of Card Services is not supported.
Cause : The Card-Services software which has been loaded does not conform
to PCMCIA Card Services release 2.00.
Message: The 3270 Card-Services Enabler cannot be loaded.
Cause : A specified optional parameter is invalid or valid Card-Services
software has not been loaded. The Enabler has not remained in
memory.
Message: A usable IBM 3270 Credit Card Adapter cannot be found.
Cause : An IBM 3270 Emulation Credit Card Adapter has not been inserted in
any slot correctly or there may be a hardware problem with the
inserted 3270 CCA.
Message: The specified shared-RAM or port address is invalid.
Cause : The address specified by the '/B=' or '/P=' option is invalid.
Message: No PCMCIA slot.
Cause : This computer does not have a PCMCIA slot.
Message: Unable to configure the IBM 3270 Credit Card Adapter.
Cause : The Enabler cannot access the 3270 Credit Card Adapter correctly
because the 3270 CCA cannot be turned on.
Message: Invalid slot-number requested.
Cause : The slot-number specified by the '/S=' option is invalid.
-------------------------------------------------------------------------------
6. Using IBM Personal Communications/3270 (PC/3270)
-------------------------------------------------------------------------------
The IBM Personal Communications/3270 Version 3.0 family (Full-Function DOS
mode, Entry-Level DOS mode and Windows mode) is supported for use with the
IBM 3270 Credit Card Adapter.
Using PC/3270 with the 3270 CCA is, in general, the same as using it with
an IBM 3278/79 or 3270 Connection adapter. However, additional settings
are needed in the following cases:
- If you must change the shared-RAM address which the 3270 CCA uses
- If you use multiple 3270 CCAs
NOTE: In these cases, the following levels of PC/3270 are required:
Full-Function DOS mode ... Version 3.0 CSD 1
Windows mode ... Version 3.0 CSD 2
6-1. Changing the Shared-RAM Buffer Address
-------------------------------------------
If the Enabler has set the shared-RAM address to a value other than the
default, CE000h, (with the '/B=' option), you must specify an address in
the PC/3270 configuration file. The value must match the address set by
the Enabler.
6-1-1. Full-Function DOS Mode
-----------------------------
To change the buffer address, 'CCA' and 'B=' parameters must be added to
the DFT-program line in your start-up batch file (PCSSDFT for SNA or
PCSDFT for Non SNA). For example:
:
C:\PC3270\PCSSDFT LT=*,* A=0 CCA B=D2 n=.......
:
CCA means that a 3270 Credit Card Adapter is to be used
The shared-RAM address of the 3270 CCA has been relocated to D2000h;
before you start PC/3270 with this batch file, the 3270 CCA must be
configured by the Enabler with a '/B=D200' option.
The value of 'B=' is the first two hexadecimal digits of the buffer
address (the eight most-significant bits).
6-1-2. Entry-Level DOS mode
---------------------------
PC/3270 Entry-Level DOS mode cannot support changing the default buffer
address(CE000h).
6-1-3. Windows Mode
-------------------
If the Enabler has configured the shared-RAM buffer address at the
default, you can use the default WorkStation icon to start a session; if
you have created a WorkStation Profile (*.WS file), you need not change
it.
However, if the Enabler has configured an address other than the default,
you cannot use the default WorkStation icon; you must use a WorkStation
Profile and must add two parameters to the coax-attachment section
- [CSDFT] for SNA DFT, [CNDFT] for non-SNA DFT, [CUT] for CUT, as in the
following example:
[CSDFT]
:
CCA=Y <-- add
BufferAddress=D2 <-- add
CCA=Y means that the 3270 CCA will be used.
BufferAddress= indicates the shared-RAM address of the 3270 CCA -
in this case, D2000h. The example assumes that the Enabler has
configured the 3270 CCA with a /B=D200 option.
6-2. Other
----------
6-2-1. Supported Hardware
-------------------------
The following PCs are supported by PC/3270 (at the appropriate CSD-level)
with the IBM 3270 Credit Card Adapter:
- IBM ThinkPad 720
- IBM ThinkPad 720C
- Sharp 6781 (*)
- Toshiba T3300SL (*)
* If you use PC/3270 Version 3.0 Entry-Level DOS mode on these
computers(Sharp 6781 and Toshiba T3300SL), applying a patch file of
APAR IR99508 is needed. To do so, please obtain the information
about the patch file from the IBM Support Center.
6-2-2. Using the IBM ThinkPad 720/720C Suspend Mode
---------------------------------------------------
When these computers are powered by their battery pack and the 3270 CCA is
enabled, the computer automatically turns off the power to the PCMCIA slot
before entering system-suspend mode; at this time, the 3270 CCA is
disabled. When the computer resumes operation, the 3270 CCA will be
re-enabled only if the Card-Services enabler is being used; if any of the
other enablers is being used, you must reboot the computer or run the
enabler again.
Note: If you want to use this ability of the Card-Services enabler, the
PC Card Power-Management Driver ($ICPMDOS.SYS) must be active. This
driver is shipped on the optional diskette for the IBM computer and
is automatically installed with Socket-Services and Card-Services
drivers by the installation program.
6-2-3. Functional restrictions
------------------------------
There are the following restrictions to the use of PC/3270 in Toshiba
T3300SL and Sharp 6781 computers:
PC/3270 Toshiba T3300SL Sharp 6781
(w/o Ultra Font)
-------------------------- ---------------- ----------
Entry DOS: PCLK on CRT NG NG
(w/ IR99508)
-------------------------- ---------------- ----------
Full DOS: Model 5 on LCD NG NG
PCLK on CRT NG OK
ECF OK NG
-------------------------- ---------------- ----------
Note: CRT means an external CRT display
OK = works correctly
NG = does not work or works with problem(s)
------------------------------------------------------------------------------
7. Trademarks
------------------------------------------------------------------------------
Intel is a trademark of Intel Corp.
Sharp is a trademark of Sharp Corp.
Toshiba is a trademark of Toshiba America, Inc.