Starting the CRM Gateway

In this section:

The CRM command must be specified in the JCL script to start the Communications Resource Manager (CRM) gateway. A sample JCL script is included with your iWay CRM installation. In addition, you must determine the required arguments for the CRM command as shown in the following table.

Keyword

Default

Optional/Required

Description

<hostname>: 
<port>

None

Required

The machine name or dotted-IP address and port number (//hostname:port) of the machine where the CRM is running.

<crm name>

None

Required

The name of the CRM configured in the iWay CRM configuration.

Note: The referenced CRM gateway must be configured to identify itself as CRM1. This is specified in the JCL script that starts the CRM gateway.

-t [0|1|2|3]

0

Optional

Sets the level of tracing.

0=No tracing.

Setting this level effectively disables CRM tracing.

1=Minimum tracing.

At this level, the CRM traces only major events and is sufficient only to determine the sequence of application conversations.

2=Medium tracing.

At this level, the CRM also traces all APPC verbs and the communication between the iWay CRM Gateway and the CRM.

3=Maximum tracing.

At this level, the CRM also traces all I/O buffers.

-s

disabled (If not present)

Optional

Turns on APPC Stack API traces.

-p <nbr>

100 threads

Optional

Turns on the performance option and indicates the number of threads used to service requests.

This value should correspond to the load of SNA requests that will be made concurrently across a CRM and all of its links. If the number of requests exceeds the number of threads, the request is still executed; however, the completion time could be affected.

Do not exceed 200 threads. The CRM is tuned for a maximum of 200 threads. Lower the threads value if you have a restriction on the number of threads that can be active in your system.



x
Required Environment Variables

The following environment variables must also be configured on your system to start the CRM gateway:

SNA_STACKTYPE=VTAM28
SNA_LOCALLU=<crm_applid> 

where:

<crm_applid>

Is the name of the CRM application.


Top of page

x
Starting the CRM Gateway in an MVS Environment

To start the CRM gateway in an MVS environment, you must use a JCL script. A sample JCL script is included with your iWay CRM gateway installation in member CRMSTART.



x
Procedure: How to Start the CRM Gateway in an MVS Environment

To start the CRM gateway:

  1. Set the following environment variable in the environment where the CRM is started.

    For each running CRM, you must have a unique APPDIR set. For MVS, the APPDIR is the high-level qualifier for the data sets created by the CRM. A sample ENV file is delivered in the DATA library. For each concurrently running CRM, you must have a unique ENV file.

    APPDIR=<High level qualifier for data sets to be created in APPDIR>
  2. Use the SET commands shown in the following table to customize the sample JCL script.

    Command Name

    Description

    SET STARTCMD 

    Sets the CRM command line parameters. For example:

    '-t3 "//<hostname>:<port>" <crm name>'

    SET OBJLIB 

    Indicates the name of the PDSE library where the CRM executable is installed.

    SET DATA 

    Indicates the data set containing the ENVFILE.

    SET ENVFILE 

    Indicates the name of the PDS member that contains the environment variables for the CRM. A sample member, ENV, is delivered with your product.

    SET SIZE 

    Defines the region size for the running CRM task. The recommended setting for this option is 0M to allow the CRM to start up and level out to the size it requires.

    SET ENV 

    Indicates the ENVFILE DD name. This value is pre-set.

    SET RUNOPTS 

    Specifies the optional runtime operands for the Language Environment (LE). This is usually used for debugging. See your system administrator for more information if this option is used.

    SET CEE 

    Specifies the high-level qualifier for the LE runtime library. Language Environment is required to run the CRM.

    Note: Uncomment the SET CEE line and tailor the STEPLIB concatenation if these libraries are not in your system link library concatenation.

    SET CBC 

    Specifies the high-level qualifier for the C/C++ runtime library.

    Note: Uncomment the SET CBC line and tailor the STEPLIB concatenation if these libraries are not in your system link library concatenation.

  3. Run the crmstart job using a JCL script that is written for your system.

    The following syntax shows a JCL script for the crmstart command.

    //***************************************************************
    //* THIS JOB IS USED TO RUN THE CRM PROCESS.                     *
    //***************************************************************
    //*  YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRM         *
    //***************************************************************
    //***************************************************************
    //*  USE THE SET STATEMENTS TO SET THE APPROPRIATE VALUES         *
    //*  STARTCMD IS THE CRM COMMAND LINE                             *
    //*  OBJLIB IS THE LOAD LIBRARY CONTAINING THE PROGRAM EXECUTABLES*
    //*  DATA IS THE DATASET THAT CONTAINS THE ENVIRONMENT VARIABLES  *
    //*  ENVFILE NAMES THE MEMBER THAT CONTAINS THE ENVIRONMENT VARS  *
    //*  RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS (OPTIONAL)       *
    //*  SIZE SETS THE REGION SIZE FOR THE CRM PROCESS. 0M SETS NO   *
    //*       LIMITS ON THE REGION SIZE                               *
    //*  TAILOR YOUR JCL FOR THE BELOW IF THESE LIBRARIES ARE NOT     *
    //*  IN YOUR SYSTEM LINK LOAD LIBRARY CONCATENATION               *
    //*  CEE IS THE HLQ FOR THE LE RUNTIME LIBRARY                    *
    //*  CBC IS THE HLQ FOR THE C/C++ RUNTIME LIBRARY                 *
    //***************************************************************
    //  SET STARTCMD='"//<hostname>:<port>" <crm name>'
    //  SET OBJLIB=
    //  SET DATA=
    //  SET ENVFILE=ENV
    //  SET RUNOPTS=
    //  SET SIZE=0M
    //  SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
    //* SET CEE=CEE,CBC=CBC
    //CRM      EXEC  PGM=CRM,REGION=&SIZE,
    //  PARM='POSIX(ON) &ENV &RUNOPTS/&STARTCMD'
    //STEPLIB  DD  DSN=&OBJLIB,DISP=SHR
    //*        DD  DSN=&CEE..SCEERUN,DISP=SHR
    //*        DD  DSN=&CBC..SCLBDLL,DISP=SHR
    //MSGFILE  DD  SYSOUT=*
    //TRACE    DD  SYSOUT=*
    //SYSPRINT DD  SYSOUT=*
    //ENV      DD  DSN=&DATA(&ENVFILE),DISP=SHR
    //                                           

iWay Software