PAM Management Programming Manual

Commands and Responses
PAM Management Programming Manual—142481
5-6
ADD Command
Tokens in Command Buffer
Most of the tokens present in the command buffer for the ADD PORT command are
described in Section 4, Common Definitions
. However, ZPAM-MAP-ADD-PORT is an
extensible structured token that contains attribute information for the specified port. The
ZPAM-MAP-ADD-PORT token has the token number ZPAM-TNM-ADD-PORT and
the DDL definition ZPAM-DDL-ADD-PORT, and it must be present in every ADD
PORT command. ZPAM-MAP-ADD-PORT contains the following fields:
ZADDR
is the address for all traffic through the port. For Ethernet-type ports, this is the
PROTOCOL_TYPE field of the raw Ethernet header. For LLC1 ports, this is the
DSAP found in inbound frames and the SSAP found in outbound frames. The value
specified can have up to four hexadecimal digits.
ZMAC-ADDR
is an optional 6-byte group MAC address, which makes this port a group port. The
adapter listens for frames that contain this group address at the MAC level instead of
frames that contain the individual station MAC address. Note that several adapters
can have the same group MAC address and all of them will receive any frames sent
to that address. Note that this group address overrides the adapter’s’ default
individual station MAC address only as far as this particular port is concerned. The
group MAC address specified can have up to 12 hexadecimal digits. The default for
MAC_Address is that defined for the adapter’s MAC address. This attribute is not
supported for token-ring LLC1 ports.
DELIV-MODE
determines how read requests are queued. If ZPAM-VAL-DELIV-MODE-SRL
(serial mode, which is the default mode) is selected, all read requests are placed in a
single queue and are serviced in FIFO (first in first out) order. If ZPAM-VAL-
DELIV-MODE-PLLEL (parallel mode) is selected, all read requests are placed in
separate queues, one for each opener of the port. Inbound messages are delivered to
Tokens in Response Buffer
ZSPI-TKN-DATALIST token-type ZSPI-TYP-LIST.
ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING. !r
ZCOM-TKN-OBJTYPE token-type ZSPI-TYP-ENUM. !r
ZPAM-TKN-OBJ-SUBTYPE token-type ZSPI-TYP-ENUM. !r
ZSPI-TKN-RETCODE token-type ZSPI-TYP-ENUM. !r
ZSPI-TKN-ERRLIST token-type ZSPI-TYP-LIST.
ZSPI-TKN-ERROR token-type ZSPI-TYP-ENUM.
ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING.
ZCOM-TKN-OBJTYPE token-type ZSPI-TYP-ENUM.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
ZSPI-TKN-ENDLIST token-type ZSPI-TYP-SSCTL.
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING.