• Command-line Options

• Example: Generating an RPC Client

• Example: Generating an RPC Server

• Further Examples

---

Command-line Options

This section provides the command-line options for the following tasks:

• Generating a Natural RPC Client from an IDL File

• Generating a Natural RPC Server from an IDL File

See Using EntireX in the Designer Command-line Mode for the general command-line syntax.

Generating a Natural RPC Client from an IDL File

To generate a Natural RPC client from the specified IDL file, use the following command with options in table below:

-natural:client

Option	Description
-brokerpassword	Password used for broker authentication.
-brokeruser	User used for broker authentication.
-environment	Name of the environment or an RPC server description.
-help	Display this usage message.
-operationtype	The operation type. Valid values are: SAVE Generate Natural interface objects remotely on the server side GET Generate Natural interface objects locally using Software AG Designer
-overwrite	Overwrite existing Natural interface objects on the server side (SAVE command only).
-targetlibrary	The target library for the Natural interface objects on the server side (SAVE command only).
-rpcpassword	Password used for RPC server authentication.
-rpcuser	User used for RPC server authentication.

Generating a Natural RPC Server from an IDL File

To generate a Natural RPC server from the specified IDL file, use the following command with options in table below:

-natural:server

Option	Description
-brokerpassword	Password used for broker authentication.
-brokeruser	User used for broker authentication.
-environment	Name of the environment or an RPC server description.
-help	Display this usage message.
-operationtype	The operation type. Valid values are: SAVE Generate Natural interface objects remotely on the server side. GET Generate Natural interface objects locally using Software AG Designer.
-overwrite	Overwrite existing Natural interface objects on the server side (SAVE command only).
-targetlibrary	The target library for the Natural interface objects on the server side (SAVE command only).
-rpcpassword	Password used for RPC server authentication.
-rpcuser	User used for RPC server authentication.

Example: Generating an RPC Client

<workbench> -natural:client /Demo/Example.idl -environment localhost:1971@SRV1 -operationtype SAVE -targetlibrary MYLIB

where <workbench> is a placeholder for the actual EntireX design-time starter as described under Using EntireX in the Designer Command-line Mode.

The name of the IDL file includes the project name. In the example, the project Demo is used. If the IDL file name describes a file inside the Eclipse workspace, the name is case-sensitive.

If the first part of the IDL file name is not a project name in the current workspace, the IDL file name is used as a relative (based on the IDL file) or absolute file name in the file system. Thus, the IDL files do not need to be part of an Eclipse project.

Example: Generating an RPC Server

<workbench> -natural:server /Demo/Example.idl -environment localhost:1971@SRV1 -operationtype SAVE -targetlibrary MYLIB

where <workbench> is a placeholder for the actual EntireX design-time starter as described under Using EntireX in the Designer Command-line Mode.

Further Examples

Example 1

<workbench> -natural:client /Demo/example.idl -environment localhost:1971@SRV1 -operationtype GET

Uses the IDL file /Demo/example.idl and generates the Natural source files in parallel to the IDL file of the project /Demo. Output to standard output:

Using workspace file:/C:/myWorkspace/.
Processing IDL file C:/myWorkspace/Demo/example.idl to get the Natural interface objects via RPC environment localhost:1971@SRV1
Store Natural Source file C:\myWorkspace\Demo/CALC.NSN
Exit value: 0

Example 2

<workbench> -natural:client /Demo/example.idl -environment localhost:1971@SRV1 -operationtype SAVE -targetlibrary TEST

Uses the IDL file /Demo/example.idl and generates the Natural source files on the server side into the library TEST. Output to standard output:

Using workspace file:/C:/myWorkspace/.
Processing IDL file C:/myWorkspace/Demo/example.idl to stow the Natural interface objects via RPC environment localhost:1971@SRV1
Exit value: 0