Testing connectivity with Harvest remote agents

Products

• CA Harvest Software Change Manager - OpenMake Meister
• CA Harvest Software Change Manager

Issue/Introduction

This document provides examples of command-line programs to test connectivity with Harvest remote agents.

 

Environment

Harvest Software Change Manager all versions

Resolution

Various Harvest command line programs are available to verify Harvest remote agent connectivity.

Some samples:

1. hexecp, this tool executes a program on the remote agent host via the remote agent.
   Sample syntax for hexecp:
   

   hexecp -m <Agent Host Name> -rport <port number> -prg <Program to be executed> -syn

   
   Note: If you omit the "-usr" and "-pw" options it will prompt you for remote agent login credentials.
   
   For example:
   

   C:\Users\Administrator>hexecp -m example-agent -rport 6000 -prg "cmd /c echo Hello World" -syn
   Please enter the username and password for example-agent.
   USERNAME:  Administrator
   PASSWORD:  ***********
   Attempting to log into remote agent...
   Connected to remote agent.
   Hello World
   Execution of program: cmd /c echo Hello World was successful.
   hexecp has been executed successfully.

2. hchdir, this tool prints out the contents of a directory on the remote agent via the remote agent).
   Sample syntax for hchdir:
   

    hchdir -m <Agent Host Name> -rport <port number -pth <Directory Path on Agent>

   Note: If you omit the "-usr" and "-pw" options it will prompt you for remote agent login credentials.

   For example:

   C:\Users\Administrator>hchdir -m example-agent -rport 6000 -pth C:\Test & type hchdir.log
   Please enter the username and password for example-agent.
   USERNAME:  Administrator
   PASSWORD:  ***********
   \       example-agent   WIN32
   F       filea.txt       2025/06/24 16:32:32     ve-
   F       fileb.txt       2025/06/24 16:32:54     ve-
   F       filec.txt       2025/06/24 16:33:04     ve-

.

Additional Information

See this link for more information about the hexecp command: hexecp Command-Execute Program

The "hchdir" command isn't included in the online documentation since it is used primarily by the "harweb" web interface.  However you can see more information about that command by executing the following from your command prompt window:

hchdir -h