The general settings displayed in the fixed region for all Open Client types include:

  • AppService Name can contain the name of an application service. 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.
  • If more than one version of OpenEdge is installed on a system, the Output Directory for ProxyGen should have a different subdirectory structure for each version. For example, for the OpenEdge 12.2 installation, the directory structure can be C:\Temp\Dev\Proxies\122. When the MSBuild.exe process of ProxyGen copies the .dll files of the Open Client from the DLC, it searches the output directory appended by a unique subdirectory. From that branch, MSBuild.exe finds the required progress.message.dll.
  • 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 application server 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 application servers that support this service interface:
    • Free — The application servers are configured for the state-free operating mode. This is the default.
    • Managed — The application servers 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 .NET Open Clients and 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.