TS/MP System Management Manual (H06.05+, J06.03+)

SERVER Commands
HP NonStop TS/MP System Management Manual—541819-007
12-21
SET SERVER Command
process, environment variables are available as an array of null-terminated strings,
ending with a null pointer, pointed to by the external variable environ [].
You can specify from 3 through 24,000 characters for the ENV attribute. (The
length is calculated as the number of bytes of storage needed, in other words, the
length after any quotes have been removed and a null byte added for each
environment variable.) However, the total length of the values set for all ARGLIST
and ENV values must not exceed 24,000 characters. The string value can be a
null value. If you omit this attribute, no environmental information is sent to the
server processes in this server class.
If a name or value includes blanks, quotes, commas, or semicolons, use the same
rules as those for presenting names and values in PATHCOM; in other words, the
entire list must be enclosed in quotes. However, PATHCOM does not use blanks
directly before or after the equal sign (=) if they are not enclosed in quotes. For
examples, see the description of the ARGLIST attribute.
In addition, environment variable names (name) cannot contain an equal sign (=).
(The first equal sign PATHCOM encounters is used as the delimiter for the
environment variable name.) However, an equal sign can be included in the value.
For example, to specify an environment variable named env1 having a value of
abc=cba, enter the command as follows:
SET SERVER ENV env1=abc=cba
For a discussion of when to use parentheses, see the subsection Command
Format.
This attribute is valid for OSS server processes only.
GUARDIAN-LIB file-name
specifies the name of the user library object file that contains additional server
code space and procedures that can be shared among servers. If you supply a
value for this attribute, the operating system uses this file name and the file named
in the PROGRAM attribute to access the server code. For example:
SET SERVER PROGRAM $DATA.WORK.SRVOBJ
SET SERVER GUARDIAN-LIB $DATA.WORK.SRVLIB
Caution. Neither PATHCOM nor the PATHMON process checks for escape sequences in an
environment list. If escape sequences or other nonprintable characters are included in an
environment list, they are passed as input to PATHCOM, and unexpected results might occur.
HP recommends that all characters specified for the ENV attribute be ASCII printable. To
specify escape sequences in an environment list, HP recommends that you use the SPI
management programming interface; see the TS/MP Management Programming Manual.
Note. Due to the extra characters required by PATHCOM to embed blanks, quotes, commas,
and semicolons, it is possible for the input buffer to be larger than the 24,000-character
maximum. In such cases, PATHCOM allows 500 additional bytes in the input buffer.