CICS for OS/2 Previous Service Status
CICS for OS/2 Version 3.1 - README
----------------------------------
Welcome to CICS for OS/2 Version 3.1.
This README file describes updates to the CICS for OS/2 Version 3.1 product
and books:
Please read README.FP2 for updates relating to Fixpak 2
- Planning to install the CICS for OS/2 Server
- Installing CICS for OS/2 Server
- Installing CICS for OS/2 Version 3.1 with Version 3.0, 2.0 (or 2.0.1)
- Migrating from CICS for OS/2 Version 3.0
- Installing CICS for OS/2 Server with the CICS Client
- File Manager settings.
- CICS startup problems
- HTML books
- Printing PDF books
- Connecting CICS Clients to CICS for OS/2 server using SNA
- Deleting CICS for OS/2 Server
- Japanese, Korean and Simplified Chinese Windows clients
- iFOR/LS
- Dynamic install of remote files
- CICS Telnet Daemon
- Exit 32 - APPC Inbound request routing
- MicroFocus Cobol support
- CICS Family: Front End Programming Interface book
- Using CICS for OS/2 with DB2 Universal Database v5
- Known problem running the CICS supplied translators
Planning to install the CICS for OS/2 Server
--------------------------------------------
Software requirements:
IBM Operating System/2 (OS/2) Warp 3, 4, or OS/2 Warp Server.
Hardware requirements:
A personal computer that runs OS/2 Warp 3, 4, or OS/2 Warp Server.
Disk space requirements:
14.8 MB for the run-time system
22.3 MB for the full system
7.1 MB for the clients.
Random access memory requirements:
4 MB of memory in addition to that required for the rest of the system.
Installing CICS for OS/2 Server
-------------------------------
There are two books describing installation:
- IBM Transaction Server Quick Beginnings
This book comes with the product and is also provided as an IPF (.INF)
book, HTML (\HTML\US\FAAEAI\FAAEAI00.HTM), and a PDF file
file (\PSBOOKS\FAAEAI00.PDF) on the CD-ROM. It describes how to
install a CICS for OS/2 Server, CICS Clients for OS/2 and CICS
Clients for Windows NT, and how to connect the clients to the server
using TCP/IP or NetBIOS. The procedure uses default settings
where possible and requires OS/2 Warp Server to be installed. For
different system configurations, see CICS for OS/2 Installation.
- CICS for OS/2 Version 3.1 Installation
This book does not come with the product but is provided as an IPF
(.INF) book, HTML (\HTML\US\FAAEAA\FAAEAA00.HTM), and a
PDF file (\PSBOOKS\FAAEAA00.PDF), on the CD-ROM. It
describes, in more detail, how to install the CICS for OS/2
server, installation verification procedures, and migrating
resources from previous versions of CICS for OS/2.
Installing CICS for OS/2 Version 3.1 with Version 3.0, 2.0 (or 2.0.1)
---------------------------------------------------------------------
The installation program places the Version 3.1 directories ahead of
those for Version 3.0, 2.0 (or 2.0.1) in the LIBPATH statement in your
CONFIG.SYS. This is required to successfully use Version 3.1.
However, we advise you to remove older versions of CICS for OS/2 before
installing Version 3.1 (remembering to keep any resource control files
that you want to migrate to the new level), or remove references to older
versions from your PATH and LIBPATH.
Migrating from CICS for OS/2 Version 3.0
----------------------------------------
Users migrating from CICS for OS/2 version 3.0 wishing to use their
existing resource control file (FAACTFTB.BTR), must use the Migration
Utility (CICSMIGR) to migrate the control file to the version 3.1 level.
This is required to convert any CVT records to a new version 3.1 level
format.
Installing CICS for OS/2 Server with the CICS Client
----------------------------------------------------
If you have both CICS for OS/2 and the CICS Client installed, then you
should ensure that the Client BIN directory appears before the server
RUNTIME directory in the LIBPATH. Applications using the ECI and EPI
will connect either to the CICS Client or directly to the server,
depending on which one appears first in the LIBPATH.
File Manager Settings
---------------------
The internal file manager of CICS for OS/2 Version 3.1 is the Btrieve
Microkernel Database Engine (OS2MKDE) Version 6.20.430 supplied
by Pervasive Software Inc. Note that the Version of Btrieve supplied
with CICS for OS/2 Version 3.0 was Version 6.20.925. Despite appearances
this is actually an earlier release than Version 6.20.430.
The default value for Record Locks is insufficient if you plan to use
the supplied CICSLOAD and CICSREAD batch facility to load and unload
CICS resource definitions, it is necessary to update the File
Manager settings.
To do this, shut down CICS and double click on the icon for the File
Manager. When the program runs, select the main menu Settings option
followed by 'MicroKernel Settings' from the drop down menu.
Select the category 'File Settings' and the setting 'Record Locks per
Client'. Enter a number in the data entry field; 300 is recommended.
When you have completed all the changes select 'Save', followed by 'Exit'.
and Close the File Manager. The changes will take effect when the File
Manager is next restarted.
In addition, if you plan to run multiple CICS systems concurrently you need
to review your File Manager settings. Information on this is contained
in the CICS for OS/2 Operation book.
To avoid a known problem within the OS2MKDE engine, please ensure the
setting for Transaction Log Buffer is set to 64 if Transaction Durability
is turned on. This can be set by updating the appropriate field within
the Memory settings, page 2 of 2.
CICS Startup Problems
---------------------
If when restarting CICS for OS/2 the message log shows
FAA1606E Error creating file FAATDFP1, RC = 1025
for any of the TS and TD files, the problem can be resolved by shutting
down CICS, manually terminating OS2MKDE, and restarting CICS.
HTML books
----------
The English books are available in HTML format on the CD-ROM, point your
Web browser to the \HTML\US directory and select INDEX.HTM.
You can also link to the HTML books on our Web site:
http://www.software.ibm.com/ts/cics/library/
Printing PDF books
------------------
The books are available in PDF format on the CD-ROM for viewing
with the Adobe Acrobat Reader.
The English Adobe Acrobat Reader is included in the \PSBOOKS directory
Run the file "aro2e30.exe" to install the reader.
Go to the Adobe Web site for updates and language versions:
http://www.adobe.com/prodindex/acrobat/readstep.html
The US-English PDF books in the \PSBOOKS directory will print on
an IBM 3916 Page Printer with 16 MB of memory. They should also print on
equivalent printers but you may have problems if there is less than 16 MB
of memory.
The file names and number of pages in each book are:
*
Quick Beginnings FAAEAI00 110
Installation FAAEAA00 125
Customization FAAEAB00 350
Operation FAAEAC00 260
Reference Summary FAAEAD00 60
Intercommunication FAAEAE00 210
Problem Determination FAAEAF00 280
Performance FAAEAJ00 110
Application Programming FAAEAG00 700
Messages and Codes FAAEAH00 200
Clients Administration CCLDAA00 300
Clients Messages CCLDAB00 80
Clients Gateways CCLCAC00 40
CICS Family: API Structure DFHZAC02 337
CICS Family: Client/Server Programming DFHZAD11 179
CICS Family: Intercommunication DFHZAF05 110
CICS Family: FEPI on Workstations DFHZAH00 363
Note: The fifth character (*) in the file name is a language code:
A=US-English B=Brazilian Portuguese Z=Simplified Chinese
F=French G=German T=Traditional Chinese
I=Italian S=Spanish J=Japanese
K=Korean D=Danish 1=Czech
0=Hungarian Y=Polish
For example, FAAEFA00 would be the French Installation book.
Connecting CICS Clients to CICS for OS/2 server using SNA
---------------------------------------------------------
The IBM CICS Clients now send PIP data on CICS function shipping flows,
a typical example of which is an ECI flow.
The Communications Server used by CICS for OS/2 must be configured to
allow the Transaction Program CPMI to accept inbound PIP data from a SNA
client. For example, if using a response file to configure the
Communication Server, set PIP_ALLOWED = 1 for TP CPMI.
ECI calls between CICS Clients and CICS for OS/2 over SNA.
The CICS for OS/2 server requires a valid userid and password on all ECI
calls. For a SNA link this userid and password must also be defined
to the Communications Server used by CICS for OS/2.
See the Communications Server documentation for more information.
Deleting CICS for OS/2 Server
-----------------------------
A known problem exists when deleting the CICS for OS/2 Server from a
machine. If the error message EPFIE116 occurs indicating a package file
error then the remaining CICS310 directory will need to be deleted
manually.
Japanese, Korean and Simplified Chinese Windows clients
-------------------------------------------------------
Users of Japanese CICS Clients for Windows connecting to a CICS for OS/2
server should be aware that codepage 932 on Windows supports a new
Japanese Industry Standard (JIS) sequence for a certain 28 Kanji
characters, whereas codepage 932 on OS/2 supports the old JIS sequence.
Hence, these special characters may appear differently.
Users of Korean or Simplified Chinese CICS Clients for Windows connecting
to a CICS for OS/2 server should be aware that codepages 949 and 1381 on
Windows support an extended character set that is not supported by OS/2.
iFOR/LS
-------
CICS for OS/2 version 3.1 installs the iFOR/LS License Use Runtime
product. If an earlier version of iFOR/LS has already been installed by
another product the Nodelock Administration Tool may display some
incorrect characters.
Dynamic Install of Remote Files
-------------------------------
It is not possible to use CEDA dynamic resource install to update the
definitions of files that are defined as remote. If you attempt to
do so you may receive the error message FAA5245W or FAA5285W.
CICS Telnet Daemon
------------------
The CICS Telnet Daemon (CICSTELD) allows you to use a 3270 Telnet client
to connect to a CICS for OS/2 server.
CICSTELD accepts the following parameters:
-p (port) - the TCP/IP port number used by CICSTELD
(default is 1436)
-c (client codepage) - the EBCDIC codepage used by the 3270 Telnet client
(default codepage is 37)
-s (server codepage) - the ASCII codepage used by the CICSTELD server
(default codepage is 437)
-t (initial transid) - the transaction started on the server when a
client connects (default is CLOG)
-nt - do not start any transaction when a client
connects to the server
-n (number) - to limit the number of 3270 Telnet clients
(default 20)
CICSTELD supports a maximum of 20 3270 Telnet clients at any time.
You may experience problems with CICSTELD if the number of 3270 Telnet
clients connected exceeds the number of free tasks on the CICS for OS/2
server. You should ensure that there are sufficient free tasks on the
server to handle the expected number of 3270 Telnet clients.
Exit 32 - APPC Inbound request routing
--------------------------------------
To activate user exit 32, you must place the file FAAEXP32.DLL in a
directory that is in your LIBPATH. Unlike the other user exits, it
cannot be loaded from CICSWRK.
Micro Focus Cobol Support
-------------------------
To support COBOL applications built with the Micro Focus COBOL compiler
the appropriate run time libraries must be available to the system. These
are supplied as part of the Micro Focus compiler. To enable run unit
support the file FAASRSMF.MF, in the RUNTIME directory, should be renamed
to FAASRSMF.DLL. In addition, the environment variable COBPATH should
include the \CICS310\RUNTIME directory.
WARNING:
If CICS for OS/2 V3.0 is installed on the same system as V3.1 then the
.DLLs prefixed MF*, in the V3.0 runtime directory, must NOT be on either
LIBPATH or the path specified by the CICSWRK environment variable.
CICS Family: Front End Programming Interface book
-------------------------------------------------
In the appendix titled "Installing the samples for CICS for OS/2 and
VisualAge CICS AD", the section "CICS front-end samples" refers to the
CICS300 directory. This should refer to the installation directory chosen
for CICS for OS/2, which is CICS310 by default.
Using CICS for OS/2 with the DB2 Universal Database v5
------------------------------------------------------
In order to use the CICS supplied samples with DB2 Universal Database
(UDB) it is required that UDB Fixpak 1 is installed prior to generating
the sample database.
In addition, to use IBM COBOL with UDB v5, it is necessary to apply
UDB apar JR11651, which should ship in UDB Fixpak 3. Be aware that it
is also necessary to change the COBCPY environment variable in the
CONFIG.SYS to point to x:\SQLLIB\INCLUDE\COBOL_A (where x is the drive
that UDB is installed on).
Known problem running the CICS supplied translators
---------------------------------------------------
There is a known problem with the CICS supplied translators trapping
immediately on execution when they are run on a machine with old versions
of both IBM Visual Age COBOL and IBM Visual Age C installed.
This problem is still being investigated, but a workaround is to
remove the Visual Age C from the LIBPATH prior to executing the
translator.
Trademarks
----------
CICS, IBM, OS/2, and VisualAge are trademarks of the IBM Corporation
in the United States and other countries, or both.
Adobe, Acrobat Reader, the Acrobat logo, and Adobe Type Manager are
trademarks of Adobe Systems Incorporated.
Btrieve and Microkernel Database Engine are trademarks of Pervasive
Software Inc.
Windows and Windows NT are trademarks of Microsoft Corporation.
To order this PTF please contact your local IBM representative quoting the PTF number.
|
