![]() |
![]() |
BEA eLink TCP for IMS 3.1 Information Center |
![]() HOME | SEARCH | CONTACT | PDF FILES | WHAT'S NEW |
||
![]() TABLE OF CONTENTS | PREVIOUS TOPIC | NEXT TOPIC | GLOSSARY | INDEX |
This document illustrates several BEA eLink for Mainframe TCP for IMS (hereafter referenced as eLink TCP for IMS) configurations, from a simple, server-only configuration to a fully-functional, bidirectional configuration. Members CONFIGBP and CONFIGOT in the CONTROL distribution library contain a sample configuration file, which you can use as a starting point for developing a configuration file tailored to your environment.
This document introduces the following sample configurations:
The following sections contain examples for running eLink TCP for IMS as a BMP.
Every configuration file must contain one SYSTEM statement that is the first statement in the file. Listing C-1 is a SYSTEM statement from a sample BMP configuration file.
BMP Configuration
System Configuration
Listing C-1
Sample SYSTEM Statement for a BMP Configuration
#----------------------------------------------------------#
# BEA Connect TCP for IMS Configuration File #
#---------------------------------------------------------------#SYSTEM # System Parameters
SleepTime=(150,750,5), # IMS polling interval
Allow Client Shutdown=Yes # Allow client-requested shutdown?
The most basic configuration, as shown in Listing C-2, consists of a single IMS gateway (one IP address and port number) with no remote gateways or remote services defined.
Listing C-2 Single Inbound Session Configuration
#-----------------------------------------------------------#
# BEA Connect TCP for IMS Configuration File #
#-----------------------------------------------------------#
#-----------------------------------------------------------#
# Inbound Sessions (from remote systems to IMS) #
#-----------------------------------------------------------#
GATEWAY TYPE=LOCAL, # Local IMS Gateway Definition
LMID=IMSGATE, # Logical Machine ID
HOSTADDR=123.209.183.079, # IP Address (standard dotted-decimal)
PORT=7777, # Port Number (decimal)
ACCOUNT=*, # Account ID
PASSWORD=* # Password
A remote gateway uses the IP address 123.209.183.079 and port number 7777 to establish a connection with the IMS gateway. No account ID or password is required.
Only a single connection can be established (the maximum number of inbound sessions defaults to 1). Consequently, this gateway can service only one remote gateway at a time, and can process only one request at a time.
Because no remote gateways or services are defined, this gateway can only process inbound (server) requests. IMS client transactions cannot issue requests for services offered by remote gateways.
By adding additional GATEWAY TYPE=LOCAL statements and increasing the maximum number of inbound sessions, greater connectivity is achieved. Listing C-3 is a sample configuration for multiple inbound sessions.
Listing C-3 Multiple Inbound Sessions Configuration
#---------------------------------------------------------------#
# BEA Connect TCP for IMS Configuration File #
#---------------------------------------------------------------#
#---------------------------------------------------------------#
# Inbound Sessions (form remote systems to IMS) #
#---------------------------------------------------------------#
GATEWAY TYPE=LOCAL, # Local IMS Gateway Definition
LMID=IMSGATE1, # Logical Machine ID
HOSTADDR=123.209.183.079, # IP Address (standard dotted-decimal)
PORT=4500, # Port Number (decimal)
ACCOUNT=ACCT101, # Account ID
PASSWORD=PSWD101, # Password
SESSIONS=5 # Maximum number of inbound sessions
# via this IP/port
GATEWAY TYPE=LOCAL, # Local IMS Gateway Definition
LMID=IMSGATE2, # Logical Machine ID
HOSTADDR=123.209.183.079, # IP Address (standard dotted-decimal)
PORT=4501, # Port Number (decimal)
ACCOUNT=ACCT102, # Account ID
PASSWORD=PSWD102, # Password
SESSIONS=5 # Maximum number of inbound sessions
# via this IP/port
GATEWAY TYPE=LOCAL, # Local IMS Gateway Definition
LMID=IMSGATE3, # Logical Machine ID
HOSTADDR=123.209.183.079, # IP Address (standard dotted-decimal)
PORT=4502, # Port Number (decimal)
ACCOUNT=ACCT103, # Account ID
PASSWORD=PSWD103, # Password
SESSIONS=5 # Maximum number of inbound sessions
# via this IP/port
Three different ports are defined (4500, 4501, and 4502), sharing a common IP address. A remote gateway can connect to the IMS gateway through any of these ports.
Each port can accept up to a maximum of 5 concurrent, inbound sessions, so the total number of concurrent, inbound sessions from remote gateways is 15. Consequently, this gateway can service up to 15 remote gateways at a time, and can process up to 15 requests at a time.
Each port specifies a different account ID and password, so a remote gateway attempting to connect via a specific port must be configured to supply the correct account ID and password.
Because no remote gateways or services are defined, this gateway can process only inbound (server) requests. IMS client transactions cannot issue requests for services offered by remote gateways.
By defining remote gateways and remote services, maximum bidirectional connectivity is achieved. Listing C-4 is a sample configuration for multiple outbound sessions.
Listing C-4 Multiple Outbound Sessions Configuration
#----------------------------------------------------------#
# BEA Connect TCP for IMS Configuration File #
#----------------------------------------------------------#
SYSTEM # System Parameters
SleepTime=(150,750,5), # IMS polling interval
Allow Client Shutdown=Yes # Allow client-requested shutdown?
#----------------------------------------------------------#
# Inbound Sessions (from remote systems to IMS) #
#----------------------------------------------------------#
GATEWAY TYPE=LOCAL, # Local IMS Gateway Definition
LMID=IMSGATE1, # Logical Machine ID
HOSTADDR=123.209.183.079, # IP Address (standard dotted-decimal)
PORT=4500, # Port Number (decimal)
ACCOUNT=ACCT101, # Account ID
PASSWORD=PSWD101, # Password
SESSIONS=5 # Maximum number of inbound sessions
# via this IP/port
GATEWAY TYPE=LOCAL, # Local IMS Gateway Definition
LMID=IMSGATE2, # Logical Machine ID
HOSTADDR=123.209.183.079, # IP Address (standard dotted-decimal)
PORT=4501, # Port Number (decimal)
ACCOUNT=ACCT102, # Account ID
PASSWORD=PSWD102, # Password
SESSIONS=5 # Maximum number of inbound sessions
# via this IP/port
GATEWAY TYPE=LOCAL, # Local IMS Gateway Definition
LMID=IMSGATE3, # Logical Machine ID
HOSTADDR=123.209.183.079, # IP Address (standard dotted-decimal)
PORT=4502, # Port Number (decimal)
ACCOUNT=ACCT103, # Account ID
PASSWORD=PSWD103, # Password
SESSIONS=5 # Maximum number of inbound sessions
# via this IP/port
#----------------------------------------------------------#
# Outbound Sessions (from IMS to remote systems) #
#----------------------------------------------------------#
GATEWAY TYPE=(REMOTE, TUX), # Remote IMS Gateway Definition
LMID=TUX1, # Logical Machine ID
HOSTADDR=101.123.234.099,# IP Address (standard dotted-decimal)
PORT=5000, # Port Number (decimal)
ACCOUNT=ACCT101, # Account ID
PASSWORD=PSWD101, # Password
MAXMSGLEN=8192, # Maximum gateway message size
SESSIONS=(5,10) # (Min,Max) number outbound sessions
# via this IP/port
GATEWAY TYPE=(REMOTE, CICS, OTP9)# Remote IMS Gateway Definition
LMID=CICS1, # Logical Machine ID
HOSTADDR=123.055.23.172 # IP Address (standard
# dotted-decimal)
PORT=5609, # Port Number (decimal)
ACCOUNT=ACCT102, # Account ID
PASSWORD=PSWD102, # Password
MAXMSGLEN=8192, # Maximum gateway message size
SESSIONS=(5,10) # (Min,Max) number outbound
# sessions via this IP/port
GATEWAY TYPE=(REMOTE, IMS),# Remote IMS Gateway Definition
LMID=IMS2, # Logical Machine ID
HOSTADDR=147.204.237.109 # IP Address (standard dotted-decimal)
PORT=4933, # Port Number (decimal)
ACCOUNT=ACCT103, # Account ID
PASSWORD=PSWD103, # Password
MAXMSGLEN=8192, # Maximum gateway message size
SESSIONS=(5,10) # (Min,Max) number outbound sessions
# via this IP/port
#----------------------------------------------------------#
# Remote Services (can be requested by IMS clients) #
#----------------------------------------------------------#
SERVICE TYPE=REMOTE, # Remote Service Definition
LMID=TUX1, # Logical Machine ID
NAME=(ACCTBAL,ACCO
The IMS gateway has access to three different remote gateways (TUX1, CICS1, and IMS2). The maximum message length has been increased to 8192 bytes (from the default value of 2048).
In additional to a maximum of 15 concurrent, inbound sessions, a maximum of 30 concurrent, outbound sessions are supported (10 outbound sessions with each of three remote gateways). This means that up to 30 concurrent outbound (client) requests can be serviced at a time by three remote gateways. The eLink TCP for IMS gateway attempts to establish 5 outbound sessions with each remote gateway during initialization.
A service named ACCTBAL is defined which is offered by each of the three remote gateways. An IMS client transaction requests this service using the name, ACCTBAL.
Note that the time limit for the service provided by IMS2 is 90 seconds, whereas it is 60 seconds for the other two remote gateways. This might be done to compensate for the fact that IMS2 is a very busy, heavily loaded system.
Another service, INVENTORY, has been defined which is offered only by remote gateway TUX1.
The SYSTEM statement has been added to set the polling interval to a minimum of 150 milliseconds and a maximum of 750 milliseconds, with a delta of 5 milliseconds. Also, client-requested shutdown of the IMS gateway is permitted.
Listing C-5 is a sample configuration for running eLink TCP for IMS as an OTMA client. Every configuration file must contain one SYSTEM statement that is the first statement in the file. The SYSTEM statement contains the OTMA-specific parameters including the definition for security. In this example, FASTPATH is not enabled.
Listing C-5 Sample OTMA Configuration
#---------------------------------------------------------------------#
# #
# BEA CONNECT TCP FOR IMS CONFIGURATION FILE #
# #
#---------------------------------------------------------------------#
SYSTEM, # SYSTEM PARAMETERS
SLEEPTIME=(150,500,5), # IMS POLLING INTERVAL (MIN,MAX,DELTA) MS
CLIENTSHUTDOWN=NO, # DO NOT ALLOW CLIENT-REQUESTED SHUTDOWN
MSGLEVEL=4, # MESSAGE LOGGING LEVEL
# 2 = ERROR MESSAGES (ONLY)
# 4 = ERROR & INFORMATIONAL MESSAGES
SPARESOCKETS=50, # SPARE SOCKETS USED TO DYNAMICALLY ADD
# OR MODIFY GATEWAYS
OTMACLIENT=BEAOTMA01, # XCF GROUP MEMBER NAME THAT CONNECT FOR
# IMS WILL USE
OTMAGROUP=BEAGROUP, # XCF GROUP NAME
DRUEXIT=DFSYBEA0, # DRU EXIT NAME USED BY CONNECT FOR IMS
OTMASECURITY=YES # ENABLE SECURITY
#---------------------------------------------------------------------#
# INBOUND SESSIONS (FROM REMOTE GATEWAYS TO IMS) #
#---------------------------------------------------------------------#
GATEWAY,TYPE=LOCAL, # LOCAL IMS GATEWAY DEFINITION
LMID=OS3901, # LOGICAL MACHINE ID
HOSTADDR=111.111.111.111, # IP ADDRESS (STANDARD DOTTED-DECIMAL)
PORT=4500, # PORT NUMBER (DECIMAL)
ACCOUNT=ACCT101, # ACCOUNT ID
PASSWORD=PSWD101, # PASSWORD
MAXMSGLEN=2048, # MAXIMUM GATEWAY MESSAGE SIZE
SESSIONS=1 # MAXIMUM NUMBER INBOUND SESSIONS
# VIA THIS IP/PORT
GATEWAY,TYPE=LOCAL, # LOCAL IMS GATEWAY DEFINITION
LMID=OS3902, # LOGICAL MACHINE ID
HOSTADDR=111.111.111.111, # IP ADDRESS (STANDARD DOTTED-DECIMAL)
PORT=4501, # PORT NUMBER (DECIMAL)
ACCOUNT=*, # CONNECTION SECURITY NOT USED
PASSWORD=*, # BY THIS LISTENER
MAXMSGLEN=32512, # MAXIMUM GATEWAY MESSAGE SIZE
SESSIONS=1, # MAXIMUM NUMBER OF INBOUND SESSIONS
MULTIPLEX=5 # MAXIMUM NUMBER OF SIMULTANEOUS
# REQUESTS PER SESSION
GATEWAY,TYPE=LOCAL, # LOCAL IMS GATEWAY DEFINITION
LMID=OS3903, # LOGICAL MACHINE ID
HOSTADDR=111.111.111.111, # IP ADDRESS (STANDARD DOTTED-DECIMAL)
PORT=4502, # PORT NUMBER (DECIMAL)
ACCOUNT=ACCT103, # ACCOUNT ID
PASSWORD=PSWD103, # PASSWORD
MAXMSGLEN=2048, # MAXIMUM GATEWAY MESSAGE SIZE
SESSIONS=5 # MAXIMUM NUMBER INBOUND SESSIONS
#---------------------------------------------------------------------#
# OUTBOUND SESSIONS (FROM IMS TO REMOTE GATEWAYS) #
#---------------------------------------------------------------------#
GATEWAY,TYPE=(REMOTE,TUX) # REMOTE TPS GATEWAY DEFINITION
LMID=TUX1, # LOGICAL MACHINE ID
HOSTADDR=111.111.111.111, # IP ADDRESS (STANDARD DOTTED-DECIMAL)
PORT=3333, # PORT NUMBER (DECIMAL)
ACCOUNT=*, # ACCOUNT ID (* MEANS "NOT USED")
PASSWORD=*, # PASSWORD (* MEANS "NOT USED")
MAXMSGLEN=2048, # MAXIMUM GATEWAY MESSAGE SIZE
SESSIONS=(0,5), # (MIN,MAX) NUMBER OUTBOUND SESSIONS
MULTIPLEX=5 # MAXIMUM NUMBER OF SIMULTANEOUS
# REQUESTS PER SESSION
GATEWAY,TYPE=(RE