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  

Example Configuration Files

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:

BMP Configuration

The following sections contain examples for running eLink TCP for IMS as a BMP.

System Configuration

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.

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?

Single Inbound Session

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.

Multiple Inbound Sessions

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.

Multiple Outbound Sessions

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.


 OTMA Configuration



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














       



TABLE OF CONTENTS  
|  

PREVIOUS TOPIC  
|  

NEXT TOPIC   
|  

GLOSSARY 
|  
 
INDEX