Hitman Version 9.0
release notes

patches

Current Revision: Hitman V9.0.5-0502

Download
This page contains links for everything necessary to download and install/upgrade to Hitman V9.0. The links are all ftp links and you should be able to use the save as ... or save link as ... options from within your browser to save the files locally.

COMMON20.ZIP a library of routines used by all the products in the Cohort Suite. You do not install this product but it must be present for the Hitman installation to work correctly.

HIT90.ZIP the actual Hitman Version 9 software distribution. This files contains both the VAX and AXP versions of Hitman.

Note: If your system MAXPROCESSCNT (max process count) is higher than 2,000 you can download a copy of Hitman V9 that supports 5,000 processes here: hit90big.zip. A 10,000 process copy can be downloaded here: hit9010k.zip.

INSTLGD3.PDF the Cohort V3 installation guide with complete instructions for installing Hitman. The guide also includes a sample Hitman installation. The manual is in the Adobe Acrobat Public Document Format; most browsers can read these files and free viewers for many platforms are available from www.adobe.com; no official .pdf viewer is available for OpenVMS, however, we do plan to publish our documentation to .html as well for the final Cohort V3 release. It is possible to print documentation from within the Acrobat reader.

HIT90U.PDF is the complete Hitman Version 9 user manual. It includes release notes for V9 under the chapter "New Features in Version 9". This document is also in the .PDF format.

A 30 day demo license is available for Hitman or Cohort by contacting Saiga Systems directly. Current users should note that the license key used for previous version(s) of Hitman or Cohort will need to be replaced by a current license which must be loaded before running Hitman V9; your existing license will not work. Please contact us to obtain a license for this version if you don't already have one. However, this license will not interfere with your existing license(s) if you plan to run a mixture of Cohort V2 and Cohort V3 modules.

*NEW* The Hitman V9 User Manual and the Cohort V3 Installation Guide are now on-line in .html format. They can also be downloaded in a zip file for extracting under Windows: h9usehtm.zip, c3inhtm.zip.

Special Versions for product support

Traceback
If you are requested by our Technical Support Team to download the full traceback version of Hitman to help track down an error please download it from these links. This version is identical to the shipping version, however, full traceback information does make the executables larger so we recommend not downloading this version unless you are asked to. You will need two files; com20trc.zip and hit90trc.zip. After installing this version using the normal Hitman installation procedure you must relink the product with traceback enabled following the instructions in "How to relink a Saiga product."

Compiled under OpenVMS 7.3
If you are requested by our Technical Support Team to download the OpenVMS 7.3 compiled version of Hitman please download it from these links. You will need both the common and hitman files to proceed.
COM20-73.ZIP and HIT90-73.ZIP the actual Hitman Version 9 software distribution. These files contain ONLY AXP files do not attempt to install this kit on a VAX!

Compiled under OpenVMS V7.3 with module tracing (AXP only)
This copy of Hitman includes logging of entering and returning from every subroutine in the product. It is meant to be used for diagnosing problems by helping track down which routine they are occurring in. Download both COM20-tm.ZIP and HIT90-tm.ZIP, unzip them and install using VMSINSTAL. To turn tracing on define a system logical HITMAN$TRACE_MODULES to be true.

$ define/system hitman$trace_modules true

Tracing information will be written to hitman_dat:hitman_trace_detached.node (detached process), hitman_dat:hitman_trace_dcl (DCL level commands) or hitman_dat:hitman_trace_menu (menu subsystem). If this logical is not defined Hitman will run normally but no tracing information will be output.

 Release Notes for Hitman Version 9.0

1
The new /command qualifier can be used to create a DCL command procedure that will recreate your parameter file. This makes distributing a parameter file to multiple nodes that aren’t clustered easy and possible by e-mail. It also makes it possible to use a normal text editor to make significant changes to your parameter file by updating the command procedure and then recreating your parameter file.
2
The new /summary qualifier can be used to generate a summary of any HITMAN log file. The summary breaks down the contents of the log file by event type and, where appropriate, username.
3
V9.0 also includes all patches made to V8 since it was released in February 1997 and the enhancements that were added to V8.1.
4
V9.0 includes an html copy of the on-line help file.
5
V7.x of OpenVMS includes a new DecWindows user interface. Some code changes have been made to support pausing or killing these sessions.
6
It is now possible to use Hitman to monitor remote nodes to ensure they are available. Both the absent process and present process events can now be configured with a remote node name. Adding an absent process event on a system critical process, such as SWAPPER, for a remote node will cause Hitman to take action anytime that node goes down. There is some setup involved for these events on the remote node; the monitor remote nodes chapter of this manual documents how to take advantage of this new feature.
7
A few sites that run a shared copy of Hitman on multiple nodes in a cluster have experienced a problem where Hitman has failed to start because it cannot access the permanent data file. The data file is locked by other copies of Hitman starting up and, in this case, Hitman is not waiting long enough or trying enough times to read the data file before it fails. Hitman will now try 5 times instead of 10 and will wait a few seconds between each try to allow other copies of Hitman to read and then close the file. This change is incorporated into V9.0.1 and can be obtained by downloading the V9.0.1 patch below.
8
V9.0.4-0402 adds a new process debugging feature to Hitman. To turn this feature on you must define a system logical:

$ define/system hitman$debug_termination TRUE

Later log reports will include additional information from the process termination cycle:

1. a log record will be written each time a forced exit is sent
2. a different log record will be written depending on whether a process was terminated at the DCL level or while still in an image which could indicate a problem responding to the forced exit

A new command procedure was also written that sorts a log file by PID making the log report much easier to use and understand. This procedure is called sort_log_by_pid.com and it is in the hitman_com directory.
9
During testing of the code added in item 8 above it was discovered that the scheduling code for the process termination loop to make each loop take 1 second was not working properly in later versions of OpenVMS. This code was updated and tested successfully under OpenVMS for VAX 5.5 and 6.1 and OpenVMS for AXP 1.5 and 7.3a. The process termination cycle:

1. loop through all processes to see if any should be killed. For any that are eligible at the DCL level kill them. For any that are eligible that are not at DCL send a forced exit.
2. If step 1 took less than 1 second wait until a full second has elapsed.
3. loop through all processes to see if any remain that haven't yet been killed. If they are at the DCL level now kill them. If any remain in an image send another forced exit (a total of 2 forced exits by default or up to the number specified by the logical hitman$max_force_exits).
4. Repeat steps 2 and 3 until all the eligible processes have been terminated or /force_wait number of loops completed.
5. If any processes remain after /force_wait loops have been completed they will be terminated regardless of whether they are at the DCL level or in an image.
10
V9.0.5
Support for setting idle and warning times or connect time limits as been added for process names. Wildcarded process names may be specified. For example:

$ Hitman /process="HR*" /first_warn=20 /second_warn=25 /wait=30

In this example any process, whose name begins with HR, will be warned at 20 and 25 minutes of idle time and terminated after 30 minutes of being idle.

$ hitman /connect /process="HR*" /first_warn=60 /second_warn=90 /wait =120

In this example an process, whose name begins with HR, will be warned after they've been connected for 60 and 90 minutes and kicked off after 2 hours regardless of activity.

Note: Process names are case sensitive and the DCL interpreter always converts lowercase to uppercase; therefore process names should always be enclosed in quotes and must be enclosed in quotes if they include any special characters such as spaces. This also requires that process names that include lowercase letters not added with the /file=both qualifier; to preserve case enter the command twice with /file=prime and /file=nonprime.

Protection takes precedence over all other items and processes that are protected for any reason will never be terminated by Hitman even if these qualifiers are used to set idle time or connect time limits.

 Patches
The patches below are current as of April 16, 2002,to upgrade any previously installed version of Hitman 9 to 9.0.4-0402. The current release of V9.0.5 involved signficant code changes; the scope of these changes would make patch files quite large so they have not been created. It is recommended that users download Hitman V9 using the links at the top of this page (approximately 2.5 Megabytes) and reinstall it (which should take less than 10 minutes).

For VAX patches download h904vax.zip.
For AXP patches download h904axp.zip.