Using an EntireX RPC Environment

EntireX is required if you want to develop Natural business services and RPC clients with NaturalONE. This is supported by the optional EntireX and Business Services components of NaturalONE. This is sufficient for testing RPC clients for Natural subprograms. Testing Natural Business Services clients, however, requires an additional Natural Business Services installation as described under Prerequisites in the Business Services documentation.

If you prefer to use a different EntireX RPC environment (Broker and Natural RPC server) instead of the one that is installed with NaturalONE, specify this as follows for those components for which you need a custom EntireX RPC environment:

  • RPC Environments Preferences
    On the RPC Environments page of the EntireX preferences, add your custom RPC environment to the list of predefined RPC environments (Window > Preferences > Software AG > EntireX > RPC Environments).

  • EntireX Natural Wrapper
    In the EntireX Natural Wrapper wizard (Generate Natural from Software AG IDL command in the context menu of an IDL file), choose either an RPC environment from the list defined on the RPC Environments preference page, or create a new RPC environment definition (which is then added to the list on the RPC Environments preference page).

  • EntireX IDL Extractor for Natural
    In the IDL Extractor for Natural wizard (which is started with New > Other > Software AG > EntireX > IDL Extractor for Natural), choose either an RPC environment from the list defined on the RPC Environments preference page, or create a new RPC environment definition (which is then added to the list on the RPC Environments preference page).

  • Natural Subprogram Tester
    If you run the Natural subprogram tester on a Natural subprogram (Testing > Test Subprogram command in the context menu of the NSN file), specify your Broker ID and server address on the Connection tab of the tester user interface.

  • EntireX IDL Tester
    If you run the IDL tester on an IDL file (Test Software AG IDL command in the context menu of the IDL file), specify your custom Broker ID and server address in the tester user interface.

  • General EntireX IDL Preferences
    On the EntireX preference page, define your custom Broker ID and RPC server address that is to be used as the default RPC environment with the EntireX wrappers (Window > Preferences > Software AG > EntireX).

  • IDL File Properties
    In the properties of an IDL file (Properties command in the context menu of the IDL file), specify your custom Broker ID and RPC server address that is to be used by the EntireX Wrappers for this IDL file. You do this in the general EntireX section and in the EntireX Web Service Wrapper section (on the Mapping tab).

  • WS-Stack Configuration Editor
    In the WS-stack configuration editor, configure an EntireX web service (AAR file) to use your custom Broker ID and RPC server. To do so, open the web service archive (.aar) and on the EntireX Settings tab, specify your custom Broker ID and RPC server address to be used. Save the modified .aar file and redeploy it.

See also EntireX Workbench which is part of the EntireX documentation.