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
HPSSlog 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
printingdebug information. HPSS_DEBUG, if set to a non-zero value, will enable debug messages.
By default, these messages will go to the standard output stream. IfHPSS_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 andstderr, which will use the standard output or
standard error I/O streams, respectively.
TheHPSS_NUMRETRIES environment variable is used to control the number of retries to attempt
when an operation fails. Currently this class of operation includes library initialization and
communicationsfailures. 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 is4.
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 is3.
TheHPSS_BUSY_DELAY environment variable is used to control the number of seconds to delay
betweenretry attempts. Note that this value is used both for retrying initialization operations (see
HPSS_NUMRETRIES) and Bitfile Server requests (SeeHPSS_BUSY_RETRIES). The default
value is 15.
The HPSS_RETRY_STAGE_INPenvironment variables is used to control whether retries are
attemptedon 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
previousparagraph), 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
writerequests. A non-zero value will cause the Mover(s) to use the port range, while a value of zero
willcause 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
continueretrying requests. A value of zero indicates that no there is no time limit. The default value
is zero.