BEA Home | Events | Solutions | Partners | Products | Services | Download | Developer Center | WebSUPPORT
eLink Adapter for Mainframe Documentation | eLink Adapter for Mainframe CRM Administration Guide | Previous Topic | Next Topic | Contents | Index

Sample JCL for an MVS Platform

Job Control Language (JCL) is used on a z/OS or OS/390 Multiple Virtual Storage (MVS) platform to set the environment and invoke CRM commands. The following sections provide samples of JCL that may be used for your MVS operating system. The sample SET commands may not reflect the configuration of your system. You must customize the SET commands for your environment. Refer to your System Administrator for more information about your particular setup. Refer to Command Reference Pages, for more information about the CRM, CRMLKON, CRMLKOFF, CRMDOWN, and CRMLOGS commands.

This section discusses the following topics:

- Sample JCL for the CRM Command

- Sample JCL for the crmlkon Command

- Sample JCL for the crmlkoff Command

- Sample JCL for the CRMDOWN Command

- Sample JCL for the CRMLOGS Command

Sample JCL for the CRM Command

This section provides an explanation of the SET commands and an example of JCL that can be used when you run the CRM command.

SET STARTCMD

Sets the CRM command line parameters. Refer to CRM for more information about the command line parameters.

SET OBJLIB

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

SET DATA

Indicates the dataset 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 and should not be changed.

SET CEE

Specifies the high-level qualifier for the LE runtime library. CEE should be set to the prefix of the IBM Language Environment data sets. Language Environment is required to run the CRM.

SET CBC

Specifies the high-level qualifier for the C/C++ runtime library. CBC should be set to the prefix of the IBM C++ data sets.

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

Listing B-1 Sample JCL for CRM Command

>     //***************************************************************
>     //*  THIS JOB IS USED TO RUN THE CRM PROCESS.                   *
>     //*                                                             *
>     //* @(#)$Id: crmstart.jcl,v 1.3 2001/05/07 23:41:27 crount Exp $*
>     //* Copyright (c)2000 BEA Systems, Inc., all rights reserved.   *
>     //***************************************************************
>     //*  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 SNACRM 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='"//<address>:<port>" <group>'
>     //  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

Sample JCL for the crmlkon Command

This section provides an explanation of the SET commands and an example of JCL that can be used when you run the crmlkon command. The sample SET commands may not reflect the configuration of your system. You must customize the SET commands for your environment. Refer to your System Administrator for more information about your particular setup.

SET LINKCMD

Sets the crmlkon command line parameters. Refer to crmlkon for more information about the command line parameters.

SET OBJLIB

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

SET DATA

Indicates the dataset containing the ENVFILE.

SET ENVFILE

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

SET SIZE

Defines the region size for the running crmlkon task.

SET ENV

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

SET CEE

Specifies the high-level qualifier for the LE runtime library. CEE should be set to the prefix of the IBM Language Environment data sets. Language Environment is required to run crmlkon.

SET CBC

Specifies the high-level qualifier for the C/C++ runtime library. CBC should be set to the prefix of the IBM C++ data sets.

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

Listing B-2 Sample JCL for crmlkon Command

>     //***************************************************************
>     //*  THIS JOB IS USED FOR THE STAND-ALONE LINK COMMAND            *
>     //*  TO ACTIVATE A REMOTE LINK. SEE USER GUIDE FOR MORE INFO      *
>     //*                                                               *
>     //* @(#)$Id: crmlkon.jcl,v 1.10 2001/05/07 23:41:27 crount Exp $ *
>     //* Copyright (c)2000 BEA Systems, Inc., all rights reserved.     *
>     //***************************************************************
>     //*  YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMLKON     *
>     //***************************************************************
>     //***************************************************************
>     //*  LINKCMD INDICATES THE DISTRIBUTED SNACRM ADDRESS AND LINKNAME*
>     //*  OBJLIB IS THE LOAD LIBRARY CONTAINING THE ELINK ADAPTER FOR  *
>     //*  MAINFRAME PROGRAM OBJECTS                                   *
>     //*  RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS                  *
>     //*  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 SNACRM 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 LINKCMD='-n<host name>:<port> <linkname>'
>     //  SET OBJLIB=
>     //  SET RUNOPTS=
>     //  SET DATA=
>     //  SET ENVFILE=ENV
>     //  SET SIZE=1M
>     //  SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
>     //* SET CEE=CEE,CBC=CBC
>     //CRMLKON  EXEC  PGM=CRMLKON,REGION=&SIZE,
>     //  PARM='POSIX(ON) &ENV &RUNOPTS/&LINKCMD'
>     //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=*
>     //

Sample JCL for the crmlkoff Command

This section provides an explanation of the SET commands and an example of JCL that can be used when you run the crmlkoff command. The sample SET commands may not reflect the configuration of your system. You must customize the SET commands for your environment. Refer to your System Administrator for more information about your particular setup.

SET LINKCMD

Sets the crmlkoff command line parameters. Refer to crmlkoff for more information about the command line parameters.

SET OBJLIB

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

SET DATA

Indicates the dataset containing the ENVFILE.

SET ENVFILE

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

SET SIZE

Defines the region size for the running crmlkoff task.

SET ENV

Indicates the ENVFILE DD name.

SET CEE

Specifies the high-level qualifier for the Language Environment (LE) runtime library. CEE should be set to the prefix of the IBM LE data sets. Language Environment is required to run crmlkoff.

SET CBC

Specifies the high-level qualifier for the C/C++ runtime library. CBC should be set to the prefix of the IBM C++ data sets.

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

Listing B-3 Sample JCL for crmlkoff Command

>     //***************************************************************
>     //*  THIS JOB IS USED FOR THE STAND-ALONE LINK COMMAND            *
>     //*  TO DEACTIVATE A REMOTE LINK. SEE USER GUIDE FOR MORE INFO    *
>     //*                                                               *
>     //* @(#)$Id: crmlkoff.jcl,v 1.10 2001/05/07 23:41:27 crount Exp $ *
>     //* Copyright (c)2000 BEA Systems, Inc., all rights reserved.     *
>     //***************************************************************
>     //*  YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMLKOFF    *
>     //***************************************************************
>     //***************************************************************
>     //*  LINKCMD INDICATES THE DISTRIBUTED SNACRM ADDRESS AND LINKNAME*
>     //*  OBJLIB IS THE LOAD LIBRARY CONTAINING THE ELINK ADAPTER FOR  *
>     //*  MAINFRAME PROGRAM OBJECTS                                   *
>     //*  RUNOPTS SETS ANY DESIRED LE RUNTIME OPTIONS                  *
>     //*  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 SNACRM 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 LINKCMD='-n<host name>:<port> <linkname>'
>     //  SET OBJLIB=
>     //  SET RUNOPTS=
>     //  SET DATA=
>     //  SET ENVFILE=ENV
>     //  SET SIZE=1M
>     //  SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
>     //* SET CEE=CEE,CBC=CBC
>     //CRMLKOFF EXEC  PGM=CRMLKOFF,REGION=&SIZE,
>     //  PARM='POSIX(ON) &ENV &RUNOPTS/&LINKCMD'
>     //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=*
>     //

Sample JCL for the CRMDOWN Command

This section provides an explanation of the SET commands and an example of JCL that can be used when you run the crmdown command.

SET STOPCMD

Sets the crmdown command line parameters. Refer to crmdown for more information about the command line parameters.

SET OBJLIB

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

SET DATA

Indicates the dataset 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 ENV

Indicates the ENVFILE DD name.

SET CEE

Specifies the high-level qualifier for the LE runtime library. CEE should be set to the prefix of the IBM Language Environment data sets. Language Environment is required to run crmdown.

SET CBC

Specifies the high-level qualifier for the C/C++ runtime library. CBC should be set to the prefix of the IBM C++ data sets.

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

Listing B-4 Sample JCL for CRMDOWN Command

>     //***************************************************************
>     //*  THIS JOB IS USED FOR THE STAND-ALONE COMMAND USED            *
>     //*  TO SHUTDOWN THE SNACRM PROCESS. SEE USER GUIDE FOR MORE INFO *
>     //*                                                               *
>     //* @(#)$Id: crmdown.jcl,v 1.5 2001/05/07 23:41:27 crount Exp $  *
>     //* Copyright (c)2000 BEA Systems, Inc., all rights reserved.     *
>     //***************************************************************
>     //*  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 SNACRM 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=*

>     //

Sample JCL for the CRMLOGS Command

The following section is an explanation of the SET commands and an example of JCL that can be used when you run the CRMLOGS command.

SET LOGSCMD

Sets the CRMLOGS command line parameters. Refer to CRMLOGS for more information about the command line parameters.

SET OBJLIB

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

SET DATA

Indicates the dataset containing the ENVFILE.

SET ENVFILE

Indicates the dataset containing the ENVFILE.

SET SIZE

Defines the region size for the running CRMLOGS task.

SET ENV

Indicates the ENVFILE DD name.

SET CEE

Specifies the high-level qualifier for the LE runtime library. CEE should be set to the prefix of the IBM Language Environment data sets. Language Environment is required to run CRMLOGS.

SET CBC

Specifies the high-level qualifier for the C/C++ runtime library. CBC should be set to the prefix of the IBM C++ data sets.

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

Listing B-5 Sample JCL for CRMLOGS Command

>     //***************************************************************
>     //*  THIS JOB IS USED TO CHECK THE RECOVERY LOGS FOR              *
>     //*  OUTSTANDING TRANSACTION DATA. SEE USER GUIDE FOR MORE INFO   *
>     //*                                                               *
>     //* @(#)$Id: crmlogs.jcl,v 1.6 2001/05/07 23:41:27 crount Exp $  *
>     //* Copyright (c)2000 BEA Systems, Inc., all rights reserved.     *
>     //***************************************************************
>     //*  YOU MUST SET THE ENVIRONMENT VARIABLES NEEDED BY CRMLOGS     *
>     //***************************************************************
>     //***************************************************************
>     //*  SNACMD IS USED TO SET THE DESIRED SNACRM GROUP NAME          *
>     //*  OBJLIB IS THE LOAD LIBRARY CONTAINING THE EAM PROGRAM OBJECTS*
>     //*  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 SNACRM PROCESS             *
>     //*  ENV SETS THE ENVIRONMENT VARIABLES DD NAME                  *
>     //*  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 LOGSCMD=<group>
>     //  SET OBJLIB=
>     //  SET DATA=
>     //  SET ENVFILE=ENV
>     //  SET RUNOPTS=
>     //  SET SIZE=10M
>     //  SET ENV='ENVAR("_CEE_ENVFILE=DD:ENV")'
>     //* SET CEE=CEE,CBC=CBC
>     //CRMLOGS  EXEC  PGM=CRMLOGS,REGION=&SIZE,
>     //  PARM='POSIX(ON) &ENV &RUNOPTS/&LOGSCMD'
>     //STEPLIB  DD  DSN=&OBJLIB,DISP=SHR
>     //*        DD  DSN=&CEE..SCEERUN,DISP=SHR
>     //*        DD  DSN=&CBC..SCLBDLL,DISP=SHR
>     //MSGFILE  DD  SYSOUT=*
>     //SYSPRINT DD  SYSOUT=*
>     //ENV      DD  DSN=&DATA(&ENVFILE),DISP=SHR
>     //

Copyright © 2001 BEA Systems, Inc. All rights reserved. Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.