Using the IDL Extractor for Natural in Command-line Mode

This document covers the following topics:

Command-line Options
Example

Command-line Options

See Using EntireX in the Designer Command-line Mode for the general command-line syntax. The table below shows the command-line options for the IDL Extractor for Natural.

Task	Command	Option	Description
Extract the Natural objects from a Natural RPC server.	`-extract:natural`	`-brokerpassword`	Password used for broker authentication.
		`-brokeruser`	User used for broker authentication.
		`-environment`	Name of the environment or an RPC server description.
		`-filter`	Filter the Natural source objects. Show those objects which match the pattern.
		`-help`	Display this usage message.
		`-library`	The library defined within the Natural RPC Server.
		`-object`	A Natural object in the library.
		`-project`	Name of the project or subfolder where the IDL file is stored.
		`-rpcpassword`	Password used for RPC server authentication.
		`-rpcuser`	User used for RPC server authentication.
		`-timeout`	Timeout in seconds (default is 60).
List the Natural objects from a Natural RPC server.	`-list:natural`	`-brokerpassword`	Password used for broker authentication.
		`-brokeruser`	User used for broker authentication.
		`-environment`	Name of the environment or an RPC server description.
		`-filter`	Filter the Natural source objects. Show those objects which match the pattern.
		`-help`	Display this usage message.
		`-library`	The library defined within the Natural RPC Server.
		`-object`	A Natural object in the library.
		`-rpcpassword`	Password used for RPC server authentication.
		`-rpcuser`	User used for RPC server authentication.
		`-timeout`	Timeout in seconds (default is 60).

Example

<workbench> -extract:natural -environment natBroker:2006@RPC/NATSRV1/CALLNAT -project /Demo -library NATDEMO -object CALC

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

The extracted IDL file will be stored in the project Demo.

If the environment name is not a defined RPC Environment in the current workspace, the name will be interpreted as a Broker ID and RPC Server Address (brokerID@serverAddress).

The library specifies a library name and the optional object defines the program name. Wildcard notation with asterisk (*) can be used at the end of these names.

Status and processing messages are written to standard output (stdout), which is normally set to the executing shell window.