BEA Home | Events | Solutions | Partners | Products | Services | Download | Developer Center | WebSUPPORT
eLink for Mainframe TCP Documentation | eLink TCP for IMS User Guide | Previous Topic | Next Topic | Contents | 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. Member 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.

Listing C-1 is a sample configuration for running eLink TCP for IMS. 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-1 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=(REMOTE,IMS)      # REMOTE IMS GATEWAY DEFINITION
>      LMID=IMSR,                    # 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

>     GATEWAY,TYPE=(REMOTE,CICS,BEAH), # REMOTE CICS GATEWAY DEFINITION
>      LMID=CICS1,                   # LOGICAL MACHINE ID
>      HOSTADDR=111.111.111.111,     # IP ADDRESS (STANDARD DOTTED-DECIMAL)
>      PORT=4444,                    # 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

>     #---------------------------------------------------------------------#
>     #       IMS HOST SYSTEMS TO BE USED BY CONNECT FOR IMS                #
>     #---------------------------------------------------------------------#

>     HOST,TYPE=IMS,                 # IMS HOST DEFINITION
>      IMSID=IMS1,                   # LOGICAL IMS IDENTIFIER
>      OTMANAME=IMS61CR1,            # XCF GROUP MEMBER NAME OF TARGET IMS
>      OTMAINPIPE=BEAI,              # TPIPE BASE NAME FOR REQUESTS OF IMS
>                                    # AS A SERVER
>      OTMAOUTPIPE=BEAOPIPE,         # TPIPE NAME FOR REQUESTS OF IMS AS A
>                                    # CLIENT
>      NUMTPIPES=5                   # NUMBER OF INBOUND TPIPES

>     #---------------------------------------------------------------------#
>     #       REMOTE SERVICES (CAN BE REQUESTED BY IMS CLIENTS)             #
>     #---------------------------------------------------------------------#

>     SERVICE,TYPE=REMOTE,           # REMOTE SERVICE DEFINITION
>      LMID=TUX1,                    # LOGICAL MACHINE ID
>      NAME=(ECHO,ECHO),             # LOCAL SERVICE NAME, REMOTE SERVICE NAME
>      TIMEOUT=60                    # PROCESSING TIME LIMIT (SECONDS)

>     SERVICE,TYPE=REMOTE,           # REMOTE SERVICE DEFINITION
>      LMID=TUX1,                    # LOGICAL MACHINE ID
>      NAME=(TOUPPER,TOUPPER),       # LOCAL SERVICE NAME, REMOTE SERVICE NAME
>      TIMEOUT=60                    # PROCESSING TIME LIMIT (SECONDS)

>     SERVICE,TYPE=REMOTE,           # REMOTE SERVICE DEFINITION
>      LMID=TUX1,                    # LOGICAL MACHINE ID
>      NAME=(ANSWERBACL,DATALOG)     # LOCAL SERVICE NAME, REMOTE SERVICE NAME
>      TIMEOUT=10                    # PROCESSING TIME LIMIT (SECONDS)

>     SERVICE,TYPE=REMOTE,           # REMOTE SERVICE DEFINITION
>      LMID=IMSR,                    # LOGICAL MACHINE ID
>      NAME=(TOUPPER,TOUPPER),       # LOCAL SERVICE NAME, REMOTE SERVICE NAME
>      TIMEOUT=60                    # PROCESSING TIME LIMIT (SECONDS)

>     SERVICE,TYPE=REMOTE,           # REMOTE SERVICE DEFINITION
>      LMID=CICS1,                   # LOGICAL MACHINE ID
>      NAME=(TOUPPER,TOUPPER),       # LOCAL SERVICE NAME, REMOTE SERVICE NAME
>      TIMEOUT=60                    # PROCESSING TIME LIMIT (SECONDS)

>     #---------------------------------------------------------------------#
>     #       LOCAL SERVICES (CAN BE REQUESTED BY REMOTE CLIENTS)           #
>     #---------------------------------------------------------------------#

>     SERVICE,TYPE=LOCAL,            # LOCAL SERVICE DEFINITION
>      IMSID=IMS1,                   # LOGICAL IMS ID
>      NAME=(BEASVR01,ECHO),         # LOCAL SERVICE NAME, REMOTE SERVICE NAME
>      SECURITY=NO,                  # SERVICE LEVEL SECURITY SETTING
>      FASTPATH=NO,                  # NOT A FASTPATH TRANSACTION
>      V21COMPAT=YES                 # MESSAGE FORMAT IS VERSION 2.1 AND
>                                    # EARLIER COMPATIBLE
>     SERVICE,TYPE=LOCAL,            # LOCAL SERVICE DEFINITION
>      IMSID=IMS1,                   # LOGICAL IMS ID
>      NAME=(BEASVR02,REDIRECT)      # LOCAL SERVICE NAME, REMOTE SERVICE NAME
>      SECURITY=YES,                 # SERVICE LEVEL SECURITY SETTING
>      FASTPATH=NO,                  # NOT A FASTPATH TRANSACTION
>      V21COMPAT=NO,                 # MESSAGE FORMAT IS VERSION 2.1 AND
>                                    # EARLIER COMPATIBLE
>      RESPONSE=ANSWERBACK           # REROUTE RESPONSE TO THIS REMOTE
>                                    # IF THE REQUEST WAS REQUEST NO REPLY

Copyright © 2001 BEA Systems, Inc. All rights reserved. Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.