The following table lists
the hardware and software requirements for installing and running the CICS
Enterprise Connector.
Component | Requirement |
Computer and Operating System | One of the following systems:
• Intel Pentium microprocessor running Microsoft Windows NT version 4.0 with Service Pack 5 • Sun SPARC running Solaris 2.6 or Solaris 8. |
Memory | Per CPU: 256 MB minimum; 512 MB recommended. |
Available disk space | Total disk space: 200 MB on NT, 400 MB on Solaris. |
CD-ROM drive | CD-ROM drive. |
Network software | TCP/IP or SNA/APPC for NT. |
Browser software | One of the following web
browsers:
• Netscape Communicator 4.5 • Microsoft Internet Explorer 4.0 (NT only) |
CICS System | IBM CICS running on OS/390.
The required releases are MVS 5.2.2 and CICS ESA 4.1 and above with current
APARS.
iPlanet Application Server Enterprise Connector for CICS includes installation and configuration for both TCP/IP and SNA (APPC) protocols. |
Other software | • iPlanet Application Server
6.0 SP1
• Unified Integration Framework 6.0 SP1 The iPlanet Application Server and Unified Integration Framework must be installed prior to installing the CICS Enterprise Connector. |
You also received a second CD containing the open source ICU libraries, used for character set translation.
1. ICU libraries
Installation of ICU is as follows:
For NT:
Uncompress the icu-NT.zip under the
<iAS InstallDir>\ias\APPS\bin directory.
This places the following files/directories
under the <iAS InstallDir>\ias\APPS\bin directory:
Uncompress the icu-SOLARIS.tar under
the <iAS InstallDir>/ias/APPS/bin directory.
This places the following files/directories
under the <iAS InstallDir>/ias/APPS/bin directory:
The following UIF User Mapping Patch must be applied:
For NT:
Due to changes in the repository structure to support internationalization (I18N), you need to recreate all the CICS datasources after installing the UIF and the CICS connector. You also need to perform datamining after you recreate the datasources. All user mapping information is overwritten, however, you may backup user mapping information for a given datasource from the previous version and use it in this release.
The procedure for backing up and re-using user mapping information is as follows:
The
Sample Application must be modified to run in i18n mode.
For
example, modify PhoneBookServlet.java by adding the following code:
com.kivasoft.util.GX.SetCharset("Shift_JIS");
Refer
to iPlanet Application Server Guides for i18n Application Development .
http://docs.iplanet.com/docs/manuals/ias.html
Adobe Acrobat 4.0 and PostScript printer with PS level 2 fonts are required to print the PDF version.
The following lists corrections to the documentation posted on the web site.
3. Click Yes to generate a hints file
for the compiler or No.
The hints file lists the structure
that will be used in the input and output nodes in the the repository.
If you select Yes, the selected file is displayed in the Management Console
Hints Generator Window.
4.Go to the Linkage Section
in the file and highlight the structure you want as input.
In the example above, inputoutput-sec
represents the structure of the input and output structures with
the respective fields. The input and output structures may be in different
sections.
5. Select Tools and then
select Add Input Parameter as shown in the following display.
The name of the structure
you selected is displayed in the Input Parameters box at the bottom left
of the display.
6. Go to the Linkage Section in the file and highlight the structure you want as output.
In the example above, inputoutput-sec represents the structure of the input and output structures with the respective fields. The input and output structures may be in different sections.
7. Select Tools and then
select Add Output Parameter as shown in the following display.
The name of the structure
you selected is displayed in the Output Parameters box at the bottom right
of the display.
8. Select File and then select
Generate Hints.
An Information Box is displayed
indicating that the hints file was generated successfully.
9. Click OK.
The Choose Data Source Window
is displayed.
10. Select a data source and click OK
The COBOL file is converted
to XML and loaded into the repository.
Summary |
Exceptions now contain the backend error code. |
An entity can not be deleted if there are mapped users. |
Internationalization (I18N) support. CICS National Language Support is included in the iPlanet Application Server Enterprise Connector for CICS SP1. |
A screen has been added at the end of the procedure for creating a new data source using the Management Console. The new screen will alert the user if there is an existing data source with the same name and ask, Yes or No, if the existing data source should be over-written. If you choose the Yes option, the data source will be over-written; if you choose No, the data source that you created will be deleted. |
You do not have to restart the Management Console after editing a data source. |
A Refresh button was added to the Repository Browser that allows the user to refresh the repository without closing the repository and re-activating. |
Support for long data type has been added. |
1. Uninstall the connector. Refer to Chapter 2 in the Administrator's Guide.
During the uninstallation procedure
the connector files shown in the right panel, as seen in the screen capture
below, are removed from the iPlanet/iAS6/ias directory and moved to the
UIFbackup/console directory. The connector files need to be copied back
to their original location.
2. Copy the console specific directories,
the top level directory and the connector specific directories to the ias/Apps/console
for the following folders:
4. Copy the following connector files to the console directory: Appltab and ldobuffer.dll.
1. Uninstall the connector. Refer to Chapter 2 in the Administrator's Guide.
During the uninstallation procedure the connector files are removed from the iPlanet/iAS6/ias directory and moved to the UIFbackup/console directory. The connector files need to be copied back to their original loacation.
2. Copy the console specific directories, the top level directory and the connector specific directories to the ias/APPS/console for the following folders:
LRECL=80, RECFM=FM, DSORG=PS,BLKSIZE=3120
Name it 'IAS.PHONBOOJ'
2. Perform a binary FTP of the attached file to IAS.PHONBOOJ .
3. Issue the following TSO command:
RECEIVE INDATASET('IAS.PHONBOOJ')
The following prompt is displayed:
INMR901I Dataset IAS.I4C.REL600.CICS.LOAD
from MIKE on NODENAME
INMR902I Members: PHONBOOJ
INMR906A Enter restore parameters
or 'DELETE' or 'END' +
4. Enter:
DATASET(IAS.CICS.LOAD)
where IAS.CICS.LOAD is the name of the CICS load library for iAS