9 Example Configuration Files

This document illustrates several Oracle Tuxedo Mainframe Adapter for TCP (IMS) (hereafter referenced as TMA 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.

The listing below is a sample configuration for running TMA 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

#---------------------------------------------------------------------#
# #
# TMA 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
KEYRINGFILE= SYSSTC/RING101, # KEYRING FILE NAME, SPECIFY IF USER ID ALSO IF OTHER USER
KEYLABEL=LABEL101, # KEYLABEL NAME 
SSLFLAG=SSL_ONE_WAY # SPECIFY FLAG AS APPLICABLE EITHER TCP OR SSL_ONE_WAY

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
KEYRINGFILE= SYSSTC/RING101, # KEYRING FILE NAME, SPECIFY IF USER ID ALSO IF OTHER USER
KEYLABEL=LABEL101, # KEYLABEL NAME 
SSLFLAG=SSL_ONE_WAY # SPECIFY FLAG AS APPLICABLE EITHER TCP OR SSL_ONE_WAY

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
KEYRINGFILE= SYSSTC/RING101, # KEYRING FILE NAME, SPECIFY IF USER ID ALSO IF OTHER USER
KEYLABEL=LABEL101, # KEYLABEL NAME 
SSLFLAG=SSL_ONE_WAY # SPECIFY FLAG AS APPLICABLE EITHER TCP OR SSL_ONE_WAY

#---------------------------------------------------------------------#
# 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
KEYRINGFILE= SYSSTC/RING101, # KEYRING FILE NAME, SPECIFY IF USER ID ALSO IF OTHER USER
KEYLABEL=LABEL101, # KEYLABEL NAME 
SSLFLAG=SSL_ONE_WAY # SPECIFY FLAG AS APPLICABLE EITHER TCP OR SSL_ONE_WAY

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
KEYRINGFILE= SYSSTC/RING101, # KEYRING FILE NAME, SPECIFY IF USER ID ALSO IF OTHER USER
KEYLABEL=LABEL101, # KEYLABEL NAME 
SSLFLAG=SSL_ONE_WAY # SPECIFY FLAG AS APPLICABLE EITHER TCP OR SSL_ONE_WAY

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
KEYRINGFILE= SYSSTC/RING101, # KEYRING FILE NAME, SPECIFY IF USER ID ALSO IF OTHER USER
KEYLABEL=LABEL101, # KEYLABEL NAME 
SSLFLAG=SSL_ONE_WAY # SPECIFY FLAG AS APPLICABLE EITHER TCP OR SSL_ONE_WAY

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

HOST,TYPE=IMS, # IMS HOST DEFINITION
IMSID=IMS1, # LOGICAL IMS IDENTIFIER
OTMANAME=IMS71CR1, # 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