The RPC Online Maintenance Facility - the CICS transaction ERXM
-
enables you to monitor server activity, start and stop the RPC Server for CICS 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 RPC Broker Parameters
Start the CICS transaction
ERXM [MEM=erxmain-control-block
]
where
is the name of the erxmain-control-block
ERXMAIN
control block.
See ERXMAIN
Control Block under Customizing the RPC Server.
The RPC Broker Parameter map is displayed:
11:56:56 --- ERX CICS Online utility V960.0 --- 12/11/2015 RPC Broker Parameter Broker parameter Broker name = ETB001:SVC045:NET Class name = RPC Server name = SRV2 Service name = CALLNAT User ID = ERXSRV1 Logon = Yes Code page = Server timeout = 60 Compress level = N ETBLNK = BKIMC 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 return to the RPC Broker Parameter map.To display the RPC Server Parameters
Press
from any map and the RPC Server Parameters will be displayed:12:03:05 --- ERX CICS Online utility V960.0 --- 06/02/2014 RPC Server Parameter Server parameter # Min. Workers = 2 Trace Level = 0 # Max. Workers = 2 Trace Dest.(TD)= CSSL Ending Workers = Never Impersonation = No Deployment = Yes Restart Cycles = 3 Server options = SVM AutoSYNC Marshal options= CICS parameter Mapping file = ERXSVM (Prefered) Memory name = ERXMAIN (V900) Dsn(ENTIREX.SVMDEV.KSDS) 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 the RPC Server Control map
Press
.12:07:18 --- ERX CICS Online utility V960.0 --- 06/02/2014 RPC Server Control MAIN Task Status Running WORKER Tasks Registered 2 Busy 0 Maximum busy 2 USER Tasks Active 0 Max. active 0 BrokerId in use: ETB001:SVC045:NET 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
To display help for the RPC Online Maintenance Facility
Enter Help
or press .
To stop the RPC Online Maintenance Facility
Enter Exit
or press .
To start the RPC Server for CICS using the RPC Online Maintenance Facility
Start the CICS transaction ERXM
to call the
RPC Online Maintenance Facility.
See also Monitoring the RPC Server for CICS.
Start the server with the 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 RPC Server for CICS 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 .
Alternatively, you can use the start
command from the console. See Console Commands for the RPC Server for CICS.
To ping the RPC Server for CICS using the RPC Online Maintenance Facility
Start the CICS transaction ERXM
to call the EntireX RPC Online Maintenance Facility.
See Monitoring the RPC Server for CICS.
Issue the command ping
or use .
Alternatively you can use the ping
command from the console. See Console Commands for the RPC Server for CICS.
To stop the RPC Server for CICS using the RPC Online Maintenance Facility
Start the CICS transaction ERXM
to call the RPC Online Maintenance Facility.
See Monitoring the RPC Server for CICS.
Issue the stop
command or use .
This ensures correct deregistration from broker and all worker threads are shut down.
Alternatively, you can use the stop
command from the console. See Console Commands for the RPC Server for CICS.
With RPC Online Maintenance Facility commands, RPC Server for CICS 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 RPC Server for CICS,
reassemble the ERXMAIN
Control Block
using the ERXMAIN
Macro.
To modify the RPC Server for CICS parameters using the RPC Online Maintenance Facility
Start the CICS transaction ERXM
to call the RPC Online Maintenance Facility.
See Monitoring the RPC Server for CICS.
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 RPC Server for CICS 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 RPC Online Maintenance Facility.
See Monitoring the RPC Server for CICS.
Temporarily change the trace level with the command tracelevel=
, where tracelevel
is one of tracelevel
None
, Standard
, Advanced
or Support
.
See ERXMAIN
macro parameter TRLV
.
Example: tracelevel=Standard
To evaluate RPC Server for CICS return codes, see EntireX RPC Server Return Codes.
Alternatively, you can issue the command from the console. See Console Commands for the RPC Server for CICS.
The RPC Online Maintenance Facility ERXM
can be used directly from a z/VSE
console using the syntax below:
task_id
is the name of the CICS task ID
is the name of the erxmain-control-block
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 RPC Server for CICS from a z/VSE console
Use the following z/VSE command:
task_id
ERXM [MEM=erxmain-control-block
,]CMD=START
To ping the RPC Server for CICS from a z/VSE console
Use the following z/VSE command:
task_id
ERXM [MEM=erxmain-control-block
,]CMD=PING
To stop the RPC Server for CICS from a z/VSE console
Use the following z/VSE command:
task_id
ERXM [MEM=erxmain-control-block
,]CMD=STOP
To switch on tracing for the RPC Server for CICS from a z/VSE console
Use the following z/VSE command:
task_id
ERXM [MEM=erxmain-control-block
,]CMD=TRACELEVEL=tracelevel
For
, see Activating Tracing for the RPC Server for CICS.
tracelevel