PAM Management Programming Manual

Commands and Responses
PAM Management Programming Manual—142481
5-8
ADD Command
•
There is no summary state transition associated with the ADD PORT command.
PORT objects must be STARTED after they have been added. The ADD command
leaves the PORT in the STOPPED summary state.
•
The ZPAM-VAL-PORT-TYPE-ENET subtype is invalid for the Token-Ring
ServerNet adapter (TRSA).
Error-Handling Notes
ZSPI-TKN-RETCODE
is the standard SPI return-code token, whose value is a number identifying
successful completion (ZCOM-ERR-OK), an informational warning, or an error.
Errors or warnings that can occur in response to the ADD PORT command are as
follows:
ZCOM-ERR-TKN-REQ
is returned when a required token is missing. You must supply all required
tokens.
ZCOM-ERR-TKN-VAL-INV
is returned when a field in an extensible structured token (a specified token and
offset) has an incorrect value. You must supply a correct value for the field.
ZCOM-ERR-OBJ-ALRDY-DEF
is returned if the specified PORT object name (ZCOM-TKN-OBJNAME) has
already been defined by a previous ADD command. No action is required if you
want to use the existing PORT. If you want to add another PORT object, you
must specify a different object name.
ZCOM-ERR-MAX-LIMIT-EXCEEDED
is returned if the maximum number of ports has already been configured in this
particular line, or a value in a field exceeds a previously configured maximum.
ZPAM-TKN-ERR-DETL contains an enumerated value ZPAM-VAL-MAX-
LIMIT-xxxx, which specifies the limit that was exceeded. You must specify an
acceptable value or reconfigure the maximum limit.
ZPAM-ERR-ADDR-ALRDY-DEF
is returned from an ADD PORT command when the LSAP port address
specified is already in use by another port. You must specify another LSAP
address.
ZCOM-ERR-TKN-CNTXT-VAL-INV
is returned when the MAXREQUESTSIZE value specified in an ADD PORT
command is larger than the MAXREQUESTSIZE configured for the associated
LINE. You must increase the line’s MAXREQUESTSIZE or decrease the port’s
MAXREQUESTSIZE.