Previous Topic: Toolset GenerationNext Topic: .NET Proxy


CSE Generation

The following steps describe how to generate a proxy from a Windows CSE. You can use CSE Construction Client Menu navigation to designate diagrams and dialogs. Other navigation techniques can also be used to achieve the same result.

Note: Proxy clients may only be generated from a Windows CSE and is not supported from a UNIX CSE.

Follow these steps:

  1. Start the CA Gen CSE Construction Client.

    Encyclopedia Construction Client

  2. Click Model, Actions, List.

    The Model List dialog opens.

  3. Select the model name as shown in the following example:

    Model List

  4. Click Open to open the model that contains the Server Manager for which a proxy is to be generated.

    The Construction Model Selection window opens.

  5. To open the model to generate Cooperative Code, click Code, Generate, Cooperative.

    Construction Model Selection Window

    The Cooperative Code Generation window opens.

  6. To add the Server Manager, click Edit, Select New Objects.

    Cooperative Code Generation Window

    The Cooperative Generation Object Type List dialog opens.

  7. Select Server Manager, and click List.

    Cooperative Generation Object Type List Dialog Window

    The Generation Object Occurrence List opens. A list of server managers is displayed.

  8. Select a Server Manager, click Add, Continue.

    This adds the Server Manager to the Cooperative Application Generation, closes the Generation Object Occurrence List, and returns to Cooperative Generation Object Type List.

    Generation Object Occurence List Window

  9. Click Cancel on the Cooperative Generation Object Type List dialog.

    This closes the dialog and returns back to Cooperative Code Generation.

    Cooperative Generation Object Type List

  10. Select the Server Manager on the Cooperative Code Generation window and click Detail, Configuration.

    Cooperative Code Generation

    The Server Manager Environment Parameters dialog is displayed for the selected Server Manager.

    Server Manager Environment Parameters

  11. Specify the environment for the selected server by setting each parameter. Click OK to accept the specified Server Manager Environment Parameters and exit back to the Cooperative Application Generation dialog.
  12. In the Construction Model Selection window, click Code, Generate, Proxy to open the model for Proxy Code Generation.

    Construction Model Selection

    The Proxy Code Generation dialog opens.

  13. Select the Server Manager for which you want to generate a proxy.

    Proxy Code Generation Dialog

    1. From the Component Type list, select either CBD 96 or Server Load Module to generate proxies for models that are not formatted according to CBD component standards. For components that conform to CBD 3.0 standards, select Component. Select Custom Proxies to generate custom proxies designed using CA Gen Studio.

      Note: When a model contains no CBD or CBD 96 components but does contain cooperative server load modules, the Server Load Module component type is automatically selected.

    2. From the Component list, select one or more components you want to generate. When multiple components are defined for a single model, you can select one or more of these components for generation. If you have selected Custom Proxies in the previous step, a list of custom proxies that were defined in CA Gen Studio are displayed in this list. For more information about defining custom proxies, see Gen Studio Overview Guide.

      Note: The Generation process always generates all interfaces and methods associated with the selected component.

    3. From the Operating System list, select WINDOWS, JVM, UNIX, or CLR.

      Note: The Java proxy generates only for the JVM operating system. The Windows Build Tool builds the generated code and you can deploy it to any Java-compliant environment.

      From the Target Proxy Type list, select the type of generated code you want for the proxy.

      The following table lists the Target Proxy Type options for a given operating system:

Operating System

Target proxy type

Windows

ActiveX/COM, C

JVM

Java

UNIX

C

CLR

.NET

  1. A CSE only generates Remote install packages. For a Remote install, generated files are packaged into one installation file that you can manually transfer to any target system.
  2. Under Additional Programming Interfaces, select any of the optional APIs that need to be generated into the proxy. These include:

    Note: The Additional Programming Interfaces option is disabled when generating C Proxies. The C proxy is a generated C language header file. The C proxy runtime provides the supported programming Interfaces. The Override Source Path option specifies whether to override the default destination source path with the value specified in the entry field.

    If Override source path is selected, the value you enter in the entry field is used as the destination source path in the target environment.

  3. If Override source path is not selected, the path assigned in the proxy generation is used.

    Select Install after generation to automatically package the generated files into a remote file.

    Note: The Install after generation option is disabled when generating C proxies. The C proxy is a generated C language header file. The C proxy does not need the Build Tool, as the generated source code is compiled by the user.

The Proxy Generation dialog opens. After the generation completes, it displays a Generation Complete message.

Proxy Generation Dialog

The Proxy Generation Report opens in a new window. The status of proxy generation can be verified from this.

Proxy Generation Report

The Proxy Generation produces a list of generated source files. If the option Install after generation is selected on the Proxy Generation dialog, a remote file is also generated.

You can find the source files in the server directory specified in the Override source path on the Proxy Generation dialog. If the source path is not specified, the source is generated in the CSE directory under the userid initiating the generation. Proxy Generation always produces a proxy directory and a subdirectory for the Target Proxy Type.

For the previous example, you can find the source code in: \CA\CSE\ENCY\proxy\com\src.

More information:

C Proxy