Configuring an IMS Region

In this section:

Configuring an IMS region is a process that requires you to work closely with your system administrator and establish the actual connection. IMS/TM uses the APPC/MVS to provide APPC support for client connections. APPC/MVS is a resource manager that manages conversations between transaction programs using SNA as the underlying communications protocol. In order for the CRM gateway to connect to IMS, APPC/MVS must be installed and started, and APPC/MVS must be configured with a logical unit that points to the IMS region. Then you must gather this connection information and use it as input for the IMS adapter CRM gateway connection.
Top of page
x
Parameters and Steps for Connecting to an IMS Region

A system administrator will most likely configure the IMS region. This section details how to configure VTAM, APPC/MVS and an IMS region to allow the CRM to connect to the IMS region via APPC.

To establish IMS region connectivity you must:

  1. Create a logical unit for an IMS region and add it to APPC/MVS.
  2. Add APPC to your IMS region.
x
Step 1: Create a Logical Unit for an IMS Region and Add it to APPC/MVS

You must create a logical unit for the IMS region. In addition to each IMS region having its own logical unit, sessions must be defined that allow the CRM to allocate sessions between its logical unit and the logical unit of the IMS region.

The following syntax provides a sample VTAM definition of a logical unit for an IMS region and its application major node:

IMS VBUILD TYPE=APPL                APPLICATION MAJOR NODE 
IMSAPPL1 APPL   ACBNAME=IMSAPPL1,        ACBNAME FOR APPC 
               APPC=YES,
               DLOGMOD=SMSNA100,
               PARSESS=YES,
               SRBEXIT=YES,
               DSESLIM=10,
               DMINWNL=5,
               SECACPT=NONE,
               SYNCLVL=SYNCPT
               ATTNLOSS=ALL

The following parameters represent the minimum requirements for creating a VTAM APPLID for an IMS region.

Application Program Major Node Name

This tag identifies the node to the network.

TYPE=APPL

A major node should be an Application Major Node.

ACBNAME=LU Name

Logical unit name. This can be identical to the Application Major Node name. This is the name used for the IMS logical unit.

APPC=YES

Defines an APPC logical unit.

DLOGMOD=xxx

This is the VTAM LOGMODE name used for these sessions. An example is SMSNA100, which is the default recommended for iWay CRM.

PARSESS=YES

Allows multiple sessions between session partners.

SECACPT=[NONE | ALREADYV | CONV]

This parameter sets the level of security and must match a corresponding value for the CRM.

NONE means no security credentials are provided with requests sent on the link.

ALREADYV means that the application processing the request needs to identify the user making the request for access control to application resources. A user ID is provided with the request.

CONV means that full security credentials are required for any requests sent on the link. A user ID and password are required for each request.

SYNCLVL=[CONFIRM | SYNCPT]

Determines level of transactional support. CONFIRM supports non-transactional DPL and APPC service requests only, while SYNCPT will in addition, support transactional service requests.

DSESLIM=n

Defines the total number of sessions for this connection, and the number that are established by the IMS region.

DMINWNL=n

Defines the sessions that are established by the IMS region. It is recommended that you set the WINNER numbers to be the remainder of the MAXIMUM SESSIONS after you define the number of WINNER numbers needed by the CRM.

ATTNLOSS=ALL

The value ALL specifies that the ATTN exit is to be scheduled for all session deactivations. ALL is required for transactional support if SYNCLVL=SYNCPT.

After you create an IMS logical unit (VTAM APPLID), you must add it to APPC/MVS. The following syntax shows a sample for adding the IMS logical unit to APPC/MVS. 

LUADD ACBNAME(IMSAPPL1) BASE SCHED(IMSREG) TPDATA(SYS1.APPCTP)
SIDEINFO DATASET(SYS1.APPCSI)

The following parameters represent the minimum requirements for adding a logical unit to APPC/MVS.

ACBNAME(xxx)

This should match the ACBNAME of the IMS logical unit's VTAM APPLID.

SCHED(xxx)

This specifies that the IMS region is the scheduler for all requests on this logical unit.
x
Step 2: Add APPC to Your IMS Region

Once APPC/MVS has been set up to schedule requests to your IMS region, IMS must also be configured to activate APPC within IMS. To activate APPC in IMS you must specify APPC=Y in the IMS start-up procedure or in IMS.PROCLIB member DFSPBxxx where xxx is your RGSUF= parameter.

The following syntax shows an example of the DFSPBxxx member.

APPC=Y, RES=Y,
FRE=00030,
QBUF=0005,

The following syntax shows an example of the IMS PROC member..

//       PROC RGN=2000K,SOUT=A,DPTY='(14,15)',
//            SYS=,SYS1=,SYS2=,
//            RGSUF=IV1,PARM1=APPC=Y,PARM2=,APPLID1=IMS61CR1,AOIS=R
//IEFPROC EXEC PGM=DFSMVRC0,DPRTY=&DPTY,
//            REGION=&RGN,
//            PARM='CTL,&RGSUF,&PARM1,&PARM2,&APPLID1,&AOIS'
iWay Software