< Previous  | TOC | Index | Next  >

Building a custom agent on Windows

The following sections describe different ways to build an agent, using the "FileOnOff" resource as an example. For test purposes, instructions for installing the agent on a single system are also provided.

The examples use the keyword VCS_HOME to denote the VCS installation directory. Substitute VCS_HOME with the actual directory name when entering commands.

The examples assume:

• You have created a FileOnOff type definition file.

  See Creating the type definition file for a custom agent.

Topics in this section include:

• Recommendations for building custom agents on Windows.
• Implementing entry points using scripts.
• Implementing entry points using C++.
• Example: Using script entry points on Windows.
• Example: Using VCSAgStartup() and script entry points on Windows.
• Example: Using C++ and script entry points on Windows.
• Example: Using C++ entry points on Windows.

Note the following about the FileOnOff agent entry points. A FileOnOff resource represents a regular file.

• The FileOnOff online entry point creates the file if it does not already exist.
• The FileOnOff offline entry point deletes the file.
• The FileOnOff monitor entry point returns online and confidence level 100 if the file exists; otherwise, it returns offline.