Hvrtestlistener, hvrtestlocation, hvrtestscheduler

Last updated on Dec 23, 2020



hvrtestlistener - Test listening on TCP/IP port for HVR remote connection

hvrtestlocation - Test connection to HVR location

hvrtestscheduler - Test (ping) that the HVR Scheduler is running.


hvrtestlistener [-Cpubcert] [-Kpair] [-Llogin/pwd] [-tNnode port

hvrtestlocation [-hclass] [-lloc]... [-tN] [-uuserhubdb chn

hvrtestscheduler [-nnode][-tNhubdb


Command hvrtestlistener tests that an HVR process is listening on a TCP/IP port for a HVR remote connection. If option -L is supplied then it also tests the authentication for that login and password.

Command hvrtestlocation tests a connection to an HVR location.

Command hvrtestscheduler checks if the HVR scheduler is running.

The argument hubdb specifies the connection to the hub database. For more information about supported hub databases and the syntax for using this argument, see Calling HVR on the Command Line.


This section describes the options available for command hvrtestlistener.




Remote public certificate for testing encrypted SSL connection.


Location class of the hub database. Valid values for class are db2db2iingresmysqloraclepostgresqlsqlserver, or teradata. For more information, see Calling HVR on the Command Line.


SSL public certificate and private key of local machine. If pair is relative, then it is found in directory $HVR_HOME/lib/cert. Value pair specifies two files; the names of these files are calculated by removing any extension from pair and then adding extensions .pub_cert and .priv_key. For example, option -Khvr refers to files $HVR_HOME/lib/cert/hvr.pub_cert and $HVR_HOME/lib/cert/hvr.priv_key.


Test locations specified by x. If this option is not supplied, then hvrtestlocation will test all locations within the channel. Values of x may be one of the following:

  • loc : Only test location loc.
  • l1-l2 : Test all locations that fall alphabetically between l1 and l2 inclusive.
  • !loc : Test all locations except loc.
  • !l1-l2 : Test all locations except for those that fall alphabetically between l1 and l2 inclusive.

Several -lx instructions can be supplied together to hvrtestlocation.


Test authentication of login/password on remote machine.


Connect to HVR Scheduler running on node.


Connect to node as a proxy. This option can be supplied multiple time for a chain of proxies. For more information, see section Hvrproxy.


Time-out after N seconds if network is hanging or HVR Scheduler takes too long to reply.


Connect to hub database using DBMS account user. For some databases (e.g. SQL Server) a password must also be supplied.