port

The port class defines the fields that apply to port objects.

A port provides a data link control (DLC) connection point within a node for a logical link. A port such as, the IBM® token ring DLC, has an address. The address is used when making a connection, where the node initiating the connection uses the address of the other port to activate the connection.

In some personal computer systems the port is called an adapter. The adapter is specified locally using an adapter number in conjunction with the adapter DLC name. The DLC name and adapter number are used to form the portId. The portId is used when activating or deactivating a port.
RODM Class Name
1.3.18.0.0.2089
MyName Field
Object name of port object in the following form:
  • Specification:
    • 1.3.18.0.2.4.6=snaNetID;
    • 1.3.18.0.0.2032=snaNodeName;
    • 1.3.18.0.0.2142=portId
  • Example:
    • 1.3.18.0.2.4.6=APPNNET;
    • 1.3.18.0.0.2032=NT81I056;
    • 1.3.18.0.0.2142=IBMTRNET.0
If the port object can be multiply owned (more than one agent can report on the same object), the second relative distinguished name (RDN) is not used when naming this object in RODM. In this case, the name must be an agent-independent name. The removal of the second RDN, snaNodeName, accomplishes this requirement. For more information, refer to the IBM Tivoli® NetView® for z/OS® SNA Topology Manager Implementation Guide. The port objects that can be multiply owned are those port objects that are part of the NCP definitionGroup at a VTAM® node. The name will have the following form:
  • Specification:
    • 1.3.18.0.2.4.6=snaNetID;
    • 1.3.18.0.0.2142=portId
  • Example:
    • 1.3.18.0.2.4.6=SNANET;
    • 1.3.18.0.0.2142=LINE1

Using Object Class Fields

The following table contains the specific topology fields, the private management fields, and the specific presentation (graphical view) fields used by objects of the port object class. It includes the valid field value, the default value, the initialization rules, and the modification rules for each field.

Table 1. Fields for port Object Class
Field Type Valid Values Mod O/R Default
adapterAddresses T Adapter address associated with port Init Opt Null
adapterNumbers T Adapter number associated with port Init Opt Null
AggregationParent P Zero or more subareaTransmissionGroupCircuit objects Add Opt Null
AggregationPriorityValue P
0–9
Priority value (zero through nine)
-1
Suspended
-2
Use a value from the DRT object.
 Yes Opt -2
aIndMACAddress T 12-byte MAC Address of LAN adapter. Yes Opt Null
CommandIndicator A Either:
  • 32768
  • 32769
 Yes Opt 32769
connectionId T Adapter number associated with port Init Opt Null
Correlater A Value used for free-form correlation, for example: LondonEngland. Yes Opt Null
deleteIndicator A Enumerated value for delete processing Yes Opt 0
DisplayResourceName P Display the name of the port object. Specification: snaNetID.snaNodeName.portId or snaNetID.portId for multiply owned resource Examples: 'APPNNET.NT81I056.IBMTRNET.0' or 'SNANET.LINE1.' Note that the DisplayResourceName will be different if sample FLBTRDMG is loaded. See DisplayResourceName for more information. Init Opt Null
DisplayResourceOtherData P Any combination of the following separated by a comma:
  • DLC Name=dlcName
  • Adapter Numbers=(adapterNumbers)
  • Connection ID=(connectionId)
  • Adapter Addresses=(adapterAddresses)
  • Line Type=Switched/Non-Switched
  • Last Physical Logical Link=snaNetID.linkName
  • Reporting SSCPs=(names of SSCPs) (for multiply owned resources)
  • Def Group Type=major node type
 Init Opt Null
DisplayResourceType P DUIXC_RTN_PORT Yes Opt Null
DisplayStatus P See DisplayStatus Yes No —
dlcName T Name of data link control for port Init Opt Null
ExceptionViewList P Names of exception views Yes Opt Null
FLB_Creator A Any printable named string Yes Opt FLB
individualStatus T Status from each reporting SSCP perspective Init Opt See page individualStatus
iPAddress A Internet Protocol address. Yes Opt Null
lineType T Either:
1
Switched
2
Nonswitched
 Init Opt Null
LocateName P Locate the name of the port object. Specification: portId Example: 'IBMTRNET.0' or 'LINE1' Init Opt Null
memberOfDefinitionGroup T Zero or more definitionGroup object No — Null
mySuperior T One of the following objects:
  • appnBrNN
  • appnEN
  • appnNN
  • interchangeNode
  • migrationDataHost
  • t4Node
  • t5Node
 No — Null
mySuperior.gatewayT4Node T Zero or one *t4NodeGateway objects No — Null
mySuperior.node T Zero or one object of the following classes:
  • appnBrNN
  • appnEN
  • appnNN
  • interchangeNode
  • migrationDataHost
  • t5Node
 No — Null
objectClass T 1.3.18.0.0.2089 (port) No — 1.3.18.0.0.2089
packages T 1.3.18.0.0.2101 (portPkg) 1.3.18.0.0.2060 (activateWithParametersPkg) 1.3.18.0.0.2061 (deactivateWithParametersPkg) 1.3.18.0.0.2066 (nativeInfoPkg) 1.3.18.0.0.2243 (relatedAdapterPkg) No — 1.3.18.0.0.2101 1.3.18.0.0.2060 1.3.18.0.0.2061 1.3.18.0.0.2066 1.3.18.0.0.2243
portId T The port identifier Init Req Null
relatedAdapter T Zero or one logicalLink object No — Null
states T
  • administrativeState
    • X'01' (unlocked)
  • availabilityStatus
    • X'01' (unlocked)
  • nativeStatus
    • One of the following:
      X'00'
      (active)
      X'02'
      (inactive)
      X'03'
      (neverActive)
      X'04'
      (pendingActive)
      X'05'
      (pendingInactive)
      X'0A'
      (released)
      X'0B'
      (reset)
      X'0D'
      (pendingActiveOrInactive)
      X'0E'
      (releasedOrReset)
      X'FF'
      (is not currently set)
  • operationalState
    • Either:
      X'00'
      (disabled) Port is inactive — closed
      X'01'
      (enabled) Port is active — open
  • proceduralStatus
    • One of the following:
      X'00'
      (empty set) Fully initialized
      X'40'
      (not initialized) Has not been active and can be initialized by the resource, autonomously
      X'20'
      (initializing) Is pending active
      X'08'
      (terminating) Is pending inactive
  • unknownStatus
    • Either:
      X'00'
      Port status is known.
      X'01'
      Port status is not known.
 Yes Opt See page states
states (continued) T
  • usageState
    • Either:
      X'00'
      (idle) The port is not operational.
      X'01'
      (active) The port is operational.
 Yes Opt See page states
supportedConnectionNames T Zero or more objects of the following classes:
  • logicalLink
  • *ntriTypeAppnTgCircuit
  • subareaTransmissionGroupCircuit
 No — Null