TS/MP 2.5 Management Programming Manual

Tokens in Response Buffer
For ALTER SC, common error values for ZSPI-TKN-RETCODE are:
DescriptionError TokenError Number
The value specified in ZPWY-DDL-DEF-PATHWAY
for ZMAXSERVERPROCESSES was reached.
ZPWY-ERR-PM-TOOMANYSCPROCESS1103
The current working directory cannot be changed
because other OSS pathnames were defined as
relative pathnames.
ZPWY-ERR-SPI-CWDCANTBERESETNOW4023
An attribute valid only for Guardian server
processes was specified for an OSS server
process.
ZPWY-ERR-SPI-GUARDIANATTRUSED4024
An attribute valid only for OSS server processes
was specified for a Guardian server process.
ZPWY-ERR-SPI-OSSATTRUSED4025
The value specified for an OSS attribute exceeds
the maximum length.
ZPWY-ERR-SPI-OSSATTRTOOBIG4026
An OSS pathname in the command is invalid.ZPWY-ERR-SPI-INVALIDPATHNAME4027
The combined length of the values defined for
ZPWY-TKN-DEF-SCARGLIST and
ZPWY-ERR-SPI-ARGENVEXCEEDMAX4027
ZPWY-TKN-DEF-SCENV exceeds the
24,000-character maximum.
A relative OSS pathname, when resolved using
the OSS directory specified for
ZPWY-ERR-SPI-RESOLVEDTOOBIG4029
ZPWY-TKN-DEF-SCCWD, results in an absolute
pathname that exceeds the maximum 1024 bytes
allowed.
The value specified for ZPWY-TKN-DEF-SCCWD
is not an absolute pathname.
ZPWY-ERR-SPI-NAMENOTABSOLUTE4030
For descriptions of all error-token values and their associated error lists, see “Event Management”
(page 163).
Considerations
• For ALTER commands, the values for tokens and fields omitted from the command buffer
remain unchanged.
Reset values for each field are predefined. These values are described in “SPI Programming
Considerations” (page 29).
To reset ZDEFAULTVOLUME, ZGUARDIANLIB, ZHOMETERM, ZIN, ZOUT, or ZPROGRAM
with the TACL program, you must use the #SETBYTES built-in function. For more information,
see the SPI Programming Manual.
• The tokens and fields included in the command buffer must be valid for the process type
defined for the server class.
• To specify node independence for server class attributes, specify \* for node names or omit
node names and set ZNODEINDEPENDENT to ON in the START PATHWAY command.
• If you have added the maximum number of server class entries supported by the PATHMON
process (that is, 4096) and issue an ALTER SC command, the command fails with the error:
*1102* TOO MANY SERVER ENTRIES
The command fails because the PATHMON process executes the ALTER SC command by
creating a new server class entry with the altered values before deleting the existing server
class entry. When the server class entries have reached the maximum number, the PATHMON
process cannot create additional server classes. To prevent the error, define and add the
maximum number of server class entries allowed minus one (that is, 4094 server classes).
140 Server Class Commands