RPC Server Configuration and Start

This document covers the following topics:

General Information

The monitoring of an Adabas or Natural asset type requires that one or more Natural RPC servers have been set up. The products and product components monitored by the Adabas and Natural asset types are listed in Product-Specific Environment Configuration.

It is recommended that these RPC servers are used for Optimize only.

If the RPC server is running under Natural Security, the library SYSEDM must be defined in Natural Security.

CICS

  1. The RPC server configuration under CICS assumes that you use the RPC server front-end. For the installation of the RPC server front-end, refer to Installing the Natural CICS Interface which is part of the installation documentation that is provided with Natural for Mainframes.

  2. Create the Natural profile rpc-profile using SYSPARM with the following parameters: 

    RPC=(
RPCSIZE=64,
MAXBUFF=30,
ACIVERS=9,
SERVER=ON,
SRVNAME=name-of-RPC-server,
SRVNODE=broker-ID,
SRVUSER=user-ID-for-RPC-server-registry,
TRACE=(2,E),
),
PRINT=((10),AM=CICS,TYPE=TD,DEST=CICS-destination-for-RPC-server-trace),
TTYPE=ASYL,INTENS=1,EJ=OFF,TMODEL=5,
SENDER=CICS-destination-for-primary-output,
RCA=BROKER,RCALIAS=(BROKER,CICS-broker-stub),
RDCSIZE=0,
STACK=(LOGON SYSEDM)

  3. If the Natural Optimize Monitor Buffer Pool is not supported by the used Natural version and Natural Development Server or Natural Web I/O Interface is to be monitored, add parameters to support the REQUEST DOCUMENT statement: 

    XML=(ON,RDOC=ON,PARSE=ON,...

    For further information, see the description of the Natural profile parameter XML in the Parameter Reference which is part of the Natural for Mainframes documentation.

  4. Define CICS-destination-for-RPC-server-trace and CICS-destination-for-primary-output as extrapartitioned TD queues to CICS using CEDA.

    Recommended extra partition parameter settings:

    RECORDSize = 136
BLOCKSize = 140
RECORDFormat = Variable
BLOCKFormat = Unblocked
Printcontrol = blank

  5. Define CICS-broker-stub:

    • Under z/OS, set CICS-broker-stub to "CICSETB".

    • Under z/VSE, set CICS-broker-stub to "BKIMC".

  6. Alternative 1 - Start the RPC server from an online Natural session: 

    LOGON SYSRPC
    GLOBALS IA=$
    STARTSFE SFE-transaction-ID NCI-interface-nucleus-name PROFILE=rpc-profile

  7. Alternative 2 - Start the RPC server from PLTPI:

    • Create the copy rpcfrnp of XNCIFRNP and add the following Natural profile parameters to DYNPARMS: 

      TTYPE=ASYL,INTENS=1,IA=$,STACK=(LOGON SYSRPC;
STARTSFE transaction-ID NCI-interface-nucleus-name PROFILE=rpc-profile;FIN)

    • Assemble and link rpcfrnp with ENTRY XNCIFRNP.

    • Define rpcfrnp to CICS using CEDA.

    • Add rpcfrnp to the PLTPI.

    • Assemble and link the PLTPI.

    • Restart CICS.

Mainframe Batch

  1. Create a Natural profile using SYSPARM or a CMPRMIN data set with the following parameters: 

    RPC=(
RPCSIZE=64,
MAXBUFF=30,
ACIVERS=9,
SERVER=ON,
SRVNAME=name-of-RPC-server,
SRVNODE=broker-ID,
SRVUSER=user-ID-for-RPC-server-registry,
TRACE=(2,E),
),
PRINT=((10),AM=STD,DEST=CMPRT10),EJ=OFF,
RCA=BROKER,RCALIAS=(BROKER,BKIMBTSO),
RDCSIZE=0,
STACK=(LOGON SYSEDM)

  2. If the Natural Optimize Monitor Buffer Pool is not supported by the used Natural version and Natural Development Server or Natural Web I/O Interface is to be monitored, add parameters to support the REQUEST DOCUMENT statement: 

    XML=(ON,RDOC=ON,PARSE=ON,...

    For further information, see the description of the Natural profile parameter XML in the Parameter Reference which is part of the Natural for Mainframes documentation.

  3. Submit a standard Natural batch session and assign CMPRMIN, CMPRINT and CMPRT10.

UNIX and Windows

  1. Create the Natural parameter file rpc-parm using the Configuration Utility with the following profile parameters:

    • Client/Server > Remote Procedure Call > RPC (General)
      Set MAXBUFF to 30.

      Set ACIVERS to 9.

    • Client/Server > Remote Procedure Call > RPC (Server)
      Set SERVER to ON.

      Set SRVNAME to name-of-RPC-server.

      Set SRVNODE to broker-ID.

      Set SRVUSER to user-ID-for-RPC-server-registry.

      Set TRACE to the following values: Trace level to 2 and Trace on error to ON.

    • Natural Execution Configuration > Program Loading and Deletion
      Set STACK to LOGON SYSEDM.

    • Natural Execution Configuration > Device/Report Assignments > Report Assignments
      Assign report 10 to LPT10.

    • Natural Execution Configuration > Device/Report Assignments > Device Assignments
      Assign the RPC server trace file to LPT10.

  2. Start a Natural session:

    natural batchmode parm=rpc-parm cmprint=primary-output-file &