Go to main content

Developing Data Services

Exit Print View

Updated: August 2018

Reusing Code That You Create With Agent Builder

    Agent Builder enables you to reuse completed work in the following ways:

  • You can clone an existing resource type that you created with Agent Builder.

  • You can edit the source code that Agent Builder generates and recompile the code to create a new package.

How to Clone an Existing Resource Type

Follow this procedure to clone an existing resource type that is generated by Agent Builder.

  1. Load an existing resource type into Agent Builder.

      Use one of the following methods:

    • Start Agent Builder from the working directory for an existing resource type that you created with Agent Builder. Ensure that the working directory contains the rtconfig file. Agent Builder loads the values for that resource type in the Create and Configure screens.

    • Use the Load Resource Type option from the File drop-down menu.

  2. Change the working directory on the Create screen.

    You must use Browse to select a directory. Typing a new directory name is not sufficient. After you select a directory, Agent Builder re-enables the Create button.

  3. Make the changes that you want to the existing resource type.

    You might change the type of code that is generated for the resource type.

      For example, if you initially create a Korn shell version of a resource type but find over time that you require a C version, you can do the following:

    • Load the existing Korn shell resource type.

    • Change the language for the output to C.

    • Click Create to have Agent Builder build a C version of the resource type.

  4. Create the cloned resource type.
    1. Click Create to create the resource type.
    2. Click Next to display the Configure screen.
    3. Click Configure to configure the resource type, and click Cancel to finish.

Editing the Generated Source Code

To simplify the process of creating a resource type, Agent Builder limits the amount of information that you can specify, which necessarily limits the scope of the generated resource type. Therefore, to add more sophisticated features, you need to modify the generated source code or the RTR file. Examples of additional features include code that adds validation checks for additional properties or that tunes parameters that Agent Builder does not expose.

The source files are in the install-directory/rt-name/src directory. Agent Builder embeds comments in the source code where you can add code. These comments are of the form (for C code):

/* User added code -- BEGIN vvvvvvvvvvvvvvv */
/* User added code -- END   ^^^^^^^^^^^^^^^ */

Note - These comments are identical in Korn shell source code, except the comment mark (#) indicates the beginning of a comment.

For example, rt-name.h declares all the utility functions that the different programs use. At the end of the list of declarations are comments that enable you to declare additional functions that you might have added to your code.

Agent Builder also generates the makefile in the install-directory/rt-name/src directory with corresponding targets. Use the make command to recompile the source code. Use the make pkg command to regenerate the resource type package.

The RTR file is in the install-directory/rt-name/etc directory. You can edit the RTR file with a standard text editor. See Setting Resource and Resource Type Properties for more information about the RTR file. See Setting Standard Properties for information about properties.