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. |
The following environment variables must also be configured on your system to start the CRM gateway:
SNA_STACKTYPE=VTAM28
SNA_LOCALLU=<crm_applid>
where:
Is the name of the CRM application.
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.
To start the CRM gateway:
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>
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. |
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 |