[Top] [Previous] [Next] [End of Book]

# Appendix C . Example Configuration File

This appendix illustrates several BEA Connect TCP for IMS configurations, from a simple, server-only configuration to a fully-functional, bi-directional configuration. Member CONFIG in the CONTROL Distribution Library contains a sample configuration file, which you can use as a starting point for developing a configuration file tailored to your installation's configuration.

## Single Inbound Session

The most basic configuration consists of a single IMS gateway (one IP address and port number) with no remote gateways or remote services defined.

>     #-----------------------------------------------------------#
>     #     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.

>     #---------------------------------------------------------------#

>     #    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 may 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/Password, so a remote gateway attempting to connect via a specific port must be configured to supply the correct Account ID and Password.\Q

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.

>     #----------------------------------------------------------#
>     #       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, TPS), # 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,ACCOUNT1), # Local Service Name, Remote Service Name
>     TIMEOUT=60                 # Processing Time Limit (seconds)

>     SERVICE,TYPE=REMOTE,     # Remote Service Definition
>     LMID=CICS1,              # Logical Machine ID
>     NAME=(ACCTBAL,ACCOUNT2), # Local Service Name, Remote Service
>     TIMEOUT=60                 # Processing Time Limit (seconds)

>     SERVICE,TYPE=REMOTE,     # Remote Service Definition
>     LMID=IMS2,               # Logical Machine ID
>     NAME=(ACCTBAL,ACCOUNT3)  # Local Service Name, Remote Service
>     TIMEOUT=90                 # Processing Time Limit (seconds)

>     SERVICE,TYPE=REMOTE,        # Remote Service Definition
>     LMID=TUX1,                  # Logical Machine ID
>     NAME=(INVENTORY,INVENTORY), # Local Service Name, Remote Service
>     TIMEOUT=30                    # Processing Time Limit (seconds)

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. BEA Connect TCP for IMS will attempt 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.

[Top] [Previous] [Next] [End of Book]