Chapter 7 HPSS User Interface Configuration
414 September 2002 HPSS Installation Guide
Release 4.5, Revision 2
The HPSS_SERVER_NAME environment variable is used to specify the server name to be used
when initializing the HPSS security services. The default value is /.:/hpss/client. This variable is
primarily intended for use by HPSS servers that use the Client API.
The HPSS_DESC_NAME environment variable is used to control the descriptive name used in
HPSS log messages if the logging feature of the Client API is enabled. The default value is “Client
Application”.
The Client API, if compiled with debugging enabled, uses two environment variables to control
printing debug information.HPSS_DEBUG, if set to a non-zero value, willenable debug messages.
By default, these messages will go to the standard output stream. If HPSS_DEBUGPATH is set,
however, these messages will be directed to the file indicated by this environment variable. Two
special cases for the debug path exist: stdout and stderr, which will use the standard output or
standard error I/O streams, respectively.
The HPSS_NUMRETRIES environment variable isused to control the numberof retries to attempt
when an operation fails. Currently this class of operation includes library initialization and
communications failures. A value of zero indicates that no retries are to be performed, and value of
-1 indicates that the operation will be retried until successful. The default value is 4.
The HPSS_BUSY_RETRIES environment variable is used to control the number of retries to be
performed when a request fails because the Bitfile Server does not currently have an available
thread to handle that request. A value of zero indicates that no retries are to be performed, and a
value of -1 indicates that retries should be attempted until either the request succeeds or fails for
another reason. The default value is 3.
The HPSS_BUSY_DELAY environment variable is used to control the number of seconds to delay
between retry attempts. Note that this value is used both for retrying initialization operations (see
HPSS_NUMRETRIES) and Bitfile Server requests (See HPSS_BUSY_RETRIES). The default
value is 15.
The HPSS_RETRY_STAGE_INP environment variables is used to control whether retries are
attempted on attempts to open files in a Class of Service that is configured for background staging
on open. A non-zero value indicates that opens which would return -EINPROGRESS to indicate
that the file is being staged will be retried (using the same control mechanisms described in the
previous paragraph), while a value of zero indicates that the -EINPROGRESS return code will be
returned to the client. The default value is non-zero.
The HPSS_REUSE_CONNECTIONS environment variable is used to control whether TCP/IP
connections are to be left open as long as a file is open or are to be closed after each read or write
request. A non-zero value will cause connections to remain open, while a value of zero will cause
connections to be close. The default value is zero.
The HPSS_USE_PORT_RANGE environment variable is used to control whether the HPSS
Mover(s) should use the configured port range when making TCP/IP connections for read and
write requests. A non-zero value will cause the Mover(s) to use the port range, while a value of zero
will cause the Mover(s) to allow the operating system to select the port number. The default value
is zero.
The HPSS_TOTAL_DELAY environment variable is used to control the number of seconds to
continue retrying requests. A value of zero indicates that no there is no time limit. The default value
is zero.
