Version 9.6
 —  EntireX z/OS CICS® RPC Server  —

RPC Online Maintenance Facility

The RPC Online Maintenance Facility - the CICS transaction ERXM - enables you to monitor server activity, start and stop the CICS RPC Server manually and to modify various aspects of its behavior. This document covers the following topics:


Monitoring the RPC Server

The parameters in the following screens are described under Configuring the RPC Server.

Start of instruction setTo call the RPC Online Maintenance Facility and display the RPC Broker Parameters

Start of instruction setTo display the RPC Server Parameters

Start of instruction setTo display the RPC Server Control map

Start of instruction setTo display help for the RPC Online Maintenance Facility

Start of instruction setTo stop the RPC Online Maintenance Facility

Top of page

Starting the RPC Server

Start of instruction setTo start the CICS RPC Server using the RPC Online Maintenance Facility

  1. Start the CICS transaction ERXM to call the RPC Online Maintenance Facility. See also Monitoring the RPC Server.

  2. Start the server with the PF08 key or with the command start.

    The status of the MAIN task (see RPC server control panel) changes to "is running". The defined number (see ERXMAIN macro parameter MINW) of worker tasks that are registered is displayed.

If an error occurred and the CICS RPC Server is not correctly registered in the broker, but the number of currently active worker tasks is not zero:

Top of page

Pinging the RPC Server

Start of instruction setTo ping the CICS RPC Server using the RPC Online Maintenance Facility

  1. Start the CICS transaction ERXM to call the EntireX RPC Online Maintenance Facility. See Monitoring the RPC Server.

  2. Issue the command ping or use PF09.

Alternative Method

Top of page

Stopping the RPC Server

Start of instruction setTo stop the CICS RPC Server using the RPC Online Maintenance Facility

  1. Start the CICS transaction ERXM to call the RPC Online Maintenance Facility. See Monitoring the RPC Server.

  2. Issue the stop command or use PF10. This ensures correct deregistration from broker and all worker tasks are shut down.

Top of page

Modifying Parameters of the RPC Server

With RPC Online Maintenance Facility commands, CICS RPC Server parameters can be temporarily modified. Modifications are lost if CICS is restarted. The purpose of the commands is to try out easily new configurations. For persistent modifications (setup) of the CICS RPC Server, reassemble the ERXMAIN Control Block using the ERXMAIN Macro.

Start of instruction setTo modify the CICS RPC Server parameters using the RPC Online Maintenance Facility

  1. Start the CICS transaction ERXM to call the EntireX RPC Online Maintenance Facility. See Monitoring the RPC Server.

  2. Use the appropriate RPC Online Maintenance Facility command to modify the parameters. See the column 2 of table under Configuring the RPC Server.

Top of page

Activating Tracing for the RPC Server

Start of instruction setTo switch on tracing for the CICS RPC Server using the RPC Online Maintenance Facility

A prerequisite to switch on tracing is a valid defined trace destination. We recommend defining it permanently, see ERXMAIN macro parameter TRC1.

  1. Start the CICS transaction ERXM to call the EntireX RPC Online Maintenance Facility. See Monitoring the RPC Server.

  2. Use the command tracelevel=tracelevel, where tracelevel is one of None, Standard, Advanced or Support. See ERXMAIN macro parameter TRLV.

    Example: tracelevel=Standard

    To evaluate CICS RPC Server return codes, see EntireX RPC Server Return Codes.

Top of page

Console Commands for the RPC Server

The RPC Online Maintenance Facility ERXM can be used directly from a z/OS console using the z/OS command MODIFY /F. In the command syntax below:

Start of instruction setTo start the CICS RPC Server from a z/OS console

Start of instruction setTo ping the CICS RPC Server from a z/OS console

Start of instruction setTo stop the CICS RPC Server from a z/OS console

Start of instruction setTo switch on tracing for the CICS RPC Server from a z/OS console

Top of page