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:
The parameters in the following screens are described under Configuring the RPC Server.
To call the RPC Online Maintenance Facility and display the Control parameters
Start the CICS transaction
ERXM [MEM=<erxmain-control-block>]
where <erxmain-control-block> is the name of the ERXMAIN control block.
See ERXMAIN Control Block under Customizing the RPC Server.
The control parameter map is displayed:
12:29:28 --- ERX CICS Online utility Vvrs.p --- 06/07/2012
RPC Server Control
MAIN Task
Status Running
WORKER Tasks
Registered 1
Busy 0
Maximum busy 2
USER Tasks
Active 0
Max. active 0
BrokerId in use: ETB001
Class in use: RPC
Server Name in use: SRV1
Service in use: CALLNAT
COMMAND ===>
===============================================================================
PF01=Help 03=Exit 04=Control 05=Broker parms 06=Server parms
08=Start server 09=Ping server 10=Stop server
Press from any map to reenter the control parameter map.
To display the Broker parameters
Press from any map and the broker parameters will be displayed:
12:31:26 --- ERX CICS Online utility Vvrs.p --- 06/07/2009
RPC Broker Parameter
Broker parameter
Broker name = ETB001
Class name = RPC
Server name = SRV1
Service name = CALLNAT
User ID = ERXSRV1
Codepage =
Logon = Yes Server timeout = 60
LDAP file = Encryptionlevel= 0
SSL file = Compression lvl=
ETBLNK = CICSETB API version = 0
COMMAND ===>
===============================================================================
PF01=Help 03=Exit 04=Control 05=Broker parms 06=Server parms
08=Start server 09=Ping server 10=Stop server
To display the Server parameters,
Press from any map and the server parameters will be displayed:
12:31:50 --- ERX CICS Online utility Vvrs.p --- 06/07/2009
RPC Server Parameter
Server parameter
# Min. Workers = 1 Trace Level = NONE
# Max. Workers = 3 Trace Dest.(TD)=
Ending Workers = Immediately
Impersonation = No
Deployment = Yes
Restart Cycles = 15
SMH Port =
Server options = Commarea SVM
Parameter opts =
CICS parameter Mapping file = ERXSVM (Prefered)
Memory name = ERXMAIN (V800) Dsn(ENTIREX.CICS.SVM)
Transaction ID = ESRV Opn Add Rea Upd Del
COMMAND ===>
===============================================================================
PF01=Help 03=Exit 04=Control 05=Broker parms 06=Server parms
08=Start server 09=Ping server 10=Stop server
To display help for the RPC Online Maintenance Facility
Enter Help or use .
To stop the RPC Online Maintenance Facility
Enter Exit or use .
To start the CICS RPC Server using the RPC Online Maintenance Facility
Start the CICS transaction ERXM to call the
RPC Online Maintenance Facility.
See also Monitoring the RPC Server.
Start the server with the key or with the command start.
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:
Check with CICS command CEMT INQUIRE TASK whether server instances are already running. If yes, stop them using native CICS commands.
Verify the server parameters matching your system requirements. See column 2 of table under Configuring the RPC Server.
Then issue command start or use .
Automatically during CICS startup. See Autostart/Stop during CICS Start/Shutdown.
With the start command from the console.
See Console Commands for the RPC Server.
To ping the CICS RPC Server using the RPC Online Maintenance Facility
Start the CICS transaction ERXM to call the EntireX
RPC Online Maintenance Facility. See Monitoring the RPC Server.
Issue the command ping or use .
Use the ping command from the console.
See Console Commands for the RPC Server.
To stop the CICS RPC Server using the RPC Online Maintenance Facility
Start the CICS transaction ERXM to call the RPC Online Maintenance Facility.
See Monitoring the RPC Server.
Issue the stop command or use .
This ensures correct deregistration from broker and all worker tasks are shut down.
Automatically during CICS shutdown. See Autostart/Stop during CICS Start/Shutdown.
With the stop command from the console.
See Console Commands for 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.
To modify the CICS RPC Server parameters using the RPC Online Maintenance Facility
Start the CICS transaction ERXM to call the EntireX RPC Online Maintenance Facility.
See Monitoring the RPC Server.
Use the appropriate RPC Online Maintenance Facility command to modify the parameters. See the column 2 of table under Configuring the RPC Server.
To 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.
Start the CICS transaction ERXM to call the EntireX RPC Online Maintenance Facility. See Monitoring the RPC Server.
Use the command tracelevel=<tracelevel>, where <tracelevel> is one of None, Standard, Advanced or Support.
See TRLV under Configuring the RPC Server.
Example: tracelevel=Standard
To evaluate CICS RPC Server return codes, see EntireX RPC Server Return Codes.
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:
<cics-name> is the name of the CICS job
<erxmain-control-block> is the name of the ERXMAIN Control Block.
It can be omitted if the default name ERXMAIN is used.
No blanks are allowed in the string provided to ERXM, for example MEM=<erxmain-control-block>,CMD=...
To start the CICS RPC Server from a z/OS console
Use the following z/OS modify command:
F <cics-name>,ERXM [MEM=<erxmain-control-block>,]CMD=START
To ping the CICS RPC Server from a z/OS console
Use the following z/OS modify command:
F <cics-name>,ERXM [MEM=<erxmain-control-block>,]CMD=PING
To stop the CICS RPC Server from a z/OS console
Use the following z/OS modify command:
F <cics-name>,ERXM [MEM=<erxmain-control-block>,]CMD=STOP
To switch on tracing for the CICS RPC Server from a z/OS console
Use the following z/OS modify command:
F <cics-name>,ERXM [MEM=<erxmain-control-block>,]CMD=TRACELEVEl=<tracelevel>
For <tracelevel>, see Activating Tracing for the RPC Server.