PAM Management Programming Manual

Commands and Responses
PAM Management Programming Manual—142481
5-13
ALTER PORT Command
Operational Notes
There are several things you should remember when using the ALTER command:
•
The PORT object type requires that you specify an object subtype in the ZPAM-
TKN-OBJ-SUBTYPE token. The object subtype values are
ZPAM-VAL-PORT-TYPE-ENET
ZPAM-VAL-PORT-TYPE-LLC1
•
You can use the ZCOM-TKN-SEL-SUMSTATE token to alter only objects in a
specified summary state.
•
The MSAP object is also required to be in the STOPPED summary state when the
ALTER command is issued; otherwise, an error message is returned.
•
The ZMAX-REQ-SIZE, ZDATA-FWD-TIME, and ZDATA-FWD-CNT attributes of
PORT objects can be altered while the PORT is in the STARTED summary state.
The PORT must be in the STOPPED summary state to alter other attributes.
•
There is no summary state transition associated with the ALTER command. Objects
that are stopped must be started again after they are altered.
•
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 ALTER 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 this field. A
validation of the parameter values is made before changing an object’s
attributes. If any of the values are incorrect, the ALTER command is rejected
without any of the object’s attributes being changed.
ZCOM-ERR-MAX-LIMIT-EXCEEDED
is returned if the value in a field exceeds a previously configured maximum.
ZPAM-TKN-ERR-DETL contains an enumerated value, ZPAM-VAL-MAX-
LIMIT-xxxx, which specifies what kind of limit was exceeded. You must specify
an acceptable value or reconfigure the maximum limit.