Corporate Info | News | Solutions | Products | Partners | Services | Events | Download | How To Buy
BEA eLink JAM Doc Home | BEA eLink Java Adapter for Mainframe WLS Edition User Guide | Previous Topic | Next Topic | Contents | Index

Configuration Checker Utility

The Java Communications Resource Manager Gateway (JCRMGW) is a Java application that manages sessions providing access into and out of the Java environment. It is configured using a text file named jcrmgw.cfg that resides in the WebLogic server directory. This configuration file is processed every time the gateway starts.Requests coming from the mainframe are mapped to an EJB that services the request while requests going to the mainframe are mapped to a mainframe program which can be executed using a CICS DPL. The JCRMGW also supports IMS operations.

When making changes to this file, you can verify the contents by invoking the gateway's configuration processor directly from the command line. This verification process allows you to discover and correct any errors prior to starting the gateway.

This topic consists of the following sub-topics:

- bea.sna.jcrmgw.jcrmConfigurator

  This topic describes the configuration file checker utility.

- GWBOOT

  This topic describes the gwboot startup class and its options.

bea.sna.jcrmgw.jcrmConfigurator

Java Communications Resource Manager Gateway configuration (jcrmgw.cfg) checker class.

Synopsis

bea.sna.jcrmgw.jcrmConfigurator

Description

The bea.sna.jcrmgw.jcrmConfigurator is used to check the jcrmgw.cfg file prior to starting the jcrmgw. It is recommended to place it into a script file and run it with standard output redirected to a file. The resulting output will be either diagnostic messages indicating syntax errors in the configuration file or a formatted listing of the definitions as they will be used by the gateway.

There are no options and the only file which can be processed is the ./jcrmgw.cfg file in the current directory.

GWBOOT

JCRMGW bootstrap command. This gwboot startup class launches the gateway when the server is started.

Synopsis

bea.sna.jcrmgw.gwboot [[-r] [-t] [-u] <userid> ]

Description

gwboot is used in the weblogic.properties file to start an instance of the jcrmgw and optionally spawn a CRM to listen on the address specified in the jcrmgw.cfg file if required.

The following options can be specified:

-r

  specifies a remote SNACRM and suppresses the spawning of a CRM process. The CRM is assumed to already be running and listening at the address specified in the SNACRMADDR entry of the jcrmgw.cfg file.

  This would be required when the CRM is running on a machine other than the gateway, or if the CRM was started in its own window for purposes of testing a configuration.

-t

  specifies tracing CRM. Turns on level 3 CRM tracing. This can only be used if the gateway is spawning a new CRM. If the CRM is running remotely and tracing is required, use the -t option on the command line which started the CRM.

-u<userid>

  specifies <userid>. This is the default userid to be used by the gateway for all APPC requests. This is useful for IDENTITY type security when the gateway clients do not set a userid.

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