Optimize for Infrastructure Version 9.8
 —  Guide for Enterprise Transaction Systems  —

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.

Top of page

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:

  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:

Top of page

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.

Top of page

UNIX and Windows

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

  2. Start a Natural session:

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

Top of page