Stopping the CRM Gateway

The CRMDOWN command shuts down a CRM gateway. You must explicitly shut down the CRM if the iWay CRM Gateway is stopped and the CRM needs to be stopped. To stop the CRM, you must determine the required arguments for the CRMDOWN command as shown in the following table.

Keyword	Default	Optional/Required	Description
-n<hostname>: <port>	None	Required	The machine name or dotted-IP address and port number (//hostname:port) of the machine where the CRM is running.
-v	Off	Optional	Specifies verbose. Normally the command will not produce extraneous messages, facilitating use in a script.
-i	Off	Optional	Ignores errors.

Stopping the CRM Gateway in an MVS Environment

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

Top of page

Procedure: How to Stop the CRM Gateway in an MVS Environment

To stop the CRM gateway:

Use the SET commands shown in the following table to customize the sample JCL script.

Command Name

Description

SET STOPCMD

Sets the CRMDOWN command line parameters.

SET OBJLIB

Indicates the name of the PDSE library where the crmdown 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 CRMDOWN. A sample member, ENV, is delivered with your product.

SET SIZE

Defines the region size for the running crmdown task.

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 to use these options.

SET ENV

Indicates the ENVFILE DD name.

SET CEE

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

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.

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

Command Name	Description
SET STOPCMD	Sets the CRMDOWN command line parameters.
SET OBJLIB	Indicates the name of the PDSE library where the crmdown 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 CRMDOWN. A sample member, ENV, is delivered with your product.
SET SIZE	Defines the region size for the running crmdown task.
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 to use these options.
SET ENV	Indicates the ENVFILE DD name.
SET CEE	Specifies the high-level qualifier for the LE runtime library. Language Environment is required to run the CRM. 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. Uncomment the SET CBC line and tailor the STEPLIB concatenation if these libraries are not in your system link library concatenation.

Stop the CRM using a JCL script that is written for your system.

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

//***************************************************************
//*  THIS JOB IS USED FOR THE STAND-ALONE COMMAND USED            *
//*  TO SHUTDOWN THE CRM PROCESS.                                *
//***************************************************************
//*  YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMDOWN     *
//***************************************************************
//*****************************************************************
//*  STOPCMD INDICATES THE COMMAND LINE FOR CRMDOWN               *
//*  OBJLIB IS THE LOAD LIBRARY CONTAINING THE PROGRAM EXECUTABLES*
//*  RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS (OPTIONAL)       *
//*  DATA IS THE DATASET THAT CONTAINS THE ENVIRONMENT VARIABLES  *
//*  ENVFILE NAMES THE MEMBER THAT CONTAINS THE ENVIRONMENT VARS  *
//*  SIZE SETS THE REGION SIZE FOR THE CRM PROCESS                *
//*                                                               *
//*  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 STOPCMD='-n<host name>:<port>'
//  SET OBJLIB=
//  SET RUNOPTS=
//  SET DATA=
//  SET ENVFILE=ENV
//  SET SIZE=1M
//  SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
//* SET CEE=CEE,CBC=CBC
//CRMDOWN  EXEC  PGM=CRMDOWN,REGION=&SIZE,
//  PARM='POSIX(ON) &ENV &RUNOPTS/&STOPCMD'
//STEPLIB  DD  DSN=&OBJLIB,DISP=SHR
//*        DD  DSN=&CEE..SCEERUN,DISP=SHR
//*        DD  DSN=&CBC..SCLBDLL,DISP=SHR
//ENV      DD  DSN=&DATA(&ENVFILE),DISP=SHR
//MSGFILE  DD  SYSOUT=*
//SYSPRINT DD  SYSOUT=*
//