HSI Environment Variables

HSI and its support libraries use several environment variables to control the program behavior.  The method of setting these variables depends upon the shell that is in effect: 

For csh, environment variables are set by using the syntax:

            setenv environment_variable=value

For sh, ksh or bash, environment variables can be set by using the syntax:

            export environment_variable


For  ksh or bash the two lines can be combined into one:

            export environment_variable=value

The following environment variables are defined for the HSI package:

HPSS_PFTPC_PORT_RANGE=ncacn_ip_tcp[start-end] …… This variable is used to define a range of restricted ports that HSI will use when opening sockets for inbound connections from movers, or for authorization protocols such as kerberos.  Note: in HSI version 5.0.0 and beyond, the new and preferred syntax for a restricted  port range is:


  The older form is deprecated, but will continue to be supported for now.

HPSS_USE_NETRC_FILE .................   If this variable is defined, HSI will attempt to read a .netrc file to obtain the password to be used for either the local ("-A local" command line option) or combo ("-A combo" command line option) authentication method.

HPSS_API_DEBUG=debug_mask .........................   [HSI 3.4.3 and later] If this environment variable is set, debug_mask defines the logging bitmask for the HSI Gateway Library, which corresponds to the priority levels defined for syslog(1). This value is an integer value between 0 and 255, and may specified as a normal integer, or an octal value (with a leading 0), or a hexadecimal value (with a leading '0x').  The default value is 255 (0xFF).

Bit positions are as follows:

  2^0 : [LOG_EMERG] .... system is unusable

  2^1 : [LOG_ALERT] .... action must be taken immediately

  2^2 : [LOG_CRIT] ..... critical conditions

  2^3 : [LOG_ERR] ...... error conditions

  2^4 : [LOG_WARNING] .. warning conditions

  2^5 : [LOG_NOTICE] ... normal but significant condition

  2^6 : [LOG_INFO} ..... informational

  2^7 : [LOG_DEBUG] .... debug-level messages

HPSS_API_DEBUG_PATH=path   if set, contains the pathname used for the debug file.  This file is appended to unless the "overwrite" option is set in HPSS_API_DEBUG_FLAGS. If the pathname is "stdout" or "stderr", the log is written to stdout or stderr,
respectively.   This environment variable must be set in order to enable any debug logging.  Normally, this variable will be set and the default (255) will be used for HPSS_API_DEBUG.
HPSS_API_DEBUG_FLAGS: if set, contains a list of one-character flags used to
control the logging as follows:

  • w - if set, the log file is truncated to zero length or created for writing
  • a - (default) if set, the log file is created if it does not exist,
  •        or positioned to the end of the file, and all writes occur at the  end of the file.
  • f - if set, causes the log file to be flushed after each call.  Note that this happens automatically if writing to stderr or stdout.
  • m - trace inbound/outbound messages
  • p - if set, causes pid to be included in message prefix.
  • r - if set, cause realtime (hi-res) time to be included in message prefix
  • R - if set, disable hi-res time in message prefix
  • t - (default)if set, causes time from ctime(time()) to be included in msg prefix.
  • T - if set, disables "t" flag

- Unrecognized flags are silently ignored.
- If there are duplicated or conflicting flags, the last one encountered is used.