Try OpenEdge Now
skip to main content
Open Client Introduction and Programming
Generating Proxies and Web Service Definitions : Specifying generation settings : General settings for proxy generation

General settings for proxy generation

The general settings displayed in the fixed region for all Open Client types include:
*AppService Name — This field allows you to specify an application service name that relies on an OpenEdge NameServer to locate an appropriate AppServer.
AppService Name can contain the name of an application service known to the NameServer or AppServer being accessed through the interface. To use the name of the AppObject in the AppService Name field, select the Use Default check box.
*Output Directory — This field specifies an output directory where ProxyGen places the generated output files, including the proxy executable files (.class and .dll), .NET runtime assemblies (.dll, for .NET only), SOAP Web service definition files (.wsm and .wsdl), and the activity log (AppObject.log). If you select the Leave Proxy Files check box, ProxyGen also saves proxy source files in this directory.
You must enter a valid directory path or ProxyGen displays a message prompting for the path before it generates any output files.
To make the output directory more portable, you can use dot (.) or some other relative path as your Output Directory setting for all application development.
Note: ProxyGen does not clean the output directory before generation. If there are existing files in the directory with the same name as a generated file, ProxyGen overwrites the existing files. Similarly, ProxyGen ignores any obsolete client proxy or log files, which you can remove manually from the directory.
*Author and Version — Use these free-form fields to enter any comments you want to include in the Open Client interface definition. These are included as "Author�? and "Version�? source comments in the Open Client proxies and SOAP Web service definition.
*Return ABL RETURN-VALUE on Connect — Use this option to control whether or not you want values from the Connect procedure RETURN statement passed back to the client by way of the Web Services Adapter or the OpenEdge Adapter for Sonic ESB. When selected, it provides the ability to return a value from the AppServer connect procedure to the Web Service or Sonic ESB client. The Return Connect Procedure RETURN-VALUE option is only available when you use a managed session model.
This option does not affect the normal process of returning SOAP faults when a connection attempt fails from a client using a Web Services Adapter or the OpenEdge Adapter for Sonic ESB. That is, when the Connect procedure fails and returns a string value, then that string value is sent to the client in the <faultstring> element of a SOAP fault. If the Connect procedure does not return a string, then the normal SOAP fault is returned to the client.
Note: This option is ignored when generating proxies for .NET and Java.
*Session Model — You must set this field according to the operating mode of all AppServers that support this service interface:
*Free — The AppServers are configured for the state-free operating mode. This is the default.
*Managed — The AppServers are configured for the stateless, state-aware, or state-reset operating mode.
Note: This option is ignored when generating proxies for .NET and Java. For these two Open Clients, the session model is determined by settings in the client code. For more information, see OpenEdge Development: .NET Open Clients and OpenEdge Development: Java Open Clients.
*Verbose Logging — Select this check box to have detailed information output to the log file.
*Leave Proxy Files — If you select this check box, ProxyGen writes the generated proxy source files (.cs files for .NET and .java files for Java clients), as well as the proxy executable files, to the directory specified in the Output Directory field.