logicalLink

The class logicalLink defines the fields that apply to logical link objects.

A logical link provides a connection between two logically adjacent nodes. The nodes can be any of the following types:
  • Type 1 nodes
  • Type 2.0 nodes
  • Type 2.1 nodes:
    • APPN network nodes
    • APPN end nodes
    • LEN nodes
  • Type 4 nodes
  • Type 5 nodes

Each logical link between two nodes is uniquely identified within a node by a link name. Both nodes can have their own link name for the logical link, or just one of the nodes can have a link name for the logical link. The link name is used when activating or deactivating a logical link.

The state of a logical link is unidirectional as seen from each of the two adjacent nodes. Under normal conditions, the state of a logical link is the same in both nodes. During link activation and deactivation or when certain errors occur, the state of a logical link can be different in the two nodes.

A logical link can be configured such that APPN automatically can activate it on demand in order to activate a session that uses the logical link. When all the sessions using the logical link are ended, APPN might automatically deactivate the logical link.
RODM Class Name
1.3.18.0.0.2085
MyName Field
Object name of logicalLink 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.2133=linkName
  • Example:
    • 1.3.18.0.2.4.6=APPNNET;
    • 1.3.18.0.0.2032=NT81I056;
    • 1.3.18.0.0.2133=PAMUT4
If the logicalLink object can be multiply owned (more than one agent can report on the same object), then 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 accomplishes this requirement. For more information, refer to the IBM® Tivoli® NetView® for z/OS® SNA Topology Manager Implementation Guide.
The logicalLink's that can be multiply owned are:
  • logicalLink objects that are part of the NCP definitionGroup at a VTAM® node.
  • logicalLink objects that are part of the SWITCHED 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.2133=linkName
  • Example:
    • 1.3.18.0.2.4.6=SNANET;
    • 1.3.18.0.0.2133=PU4

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 logicalLink 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 logicalLink
Field Type Valid Values Mod O/R Default
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
adjacentLinkStationAddress T Address of adjacent link station Yes Opt Null
adjacentLinkStationAddress2 T Address of adjacent link station used by the correlation function when the value is a MAC address Yes Opt Null
adjacentNodeType T One of the following:
0
type unknown
1
low-entry networking
2
network node
3
end node
7
type 1 node
8
type 2.0 node
9
type 4 node
10
type-5 node
11
type 2.1 node
 Init Opt 0
aIndMACAddress T 12-byte MAC Address of LAN adapter. Yes Opt Null
attachedCircuitList T Zero or one appnTransmissionGroupCircuit (if this logicalLink represents physical NTRI-like resource) Yes Opt Null
CommandIndicator A Either:
  • 32768
  • 32769
 Yes Opt 32769
ContainsLogical P SELFDEFINING containing the following values: 2.9.3.5.7.14 (underlyingConnectionNames) Add Opt Valid values
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 logicalLink object. Specification: snaNetID.snaNodeName.linkName or snaNetID.linkName for multiply owned resource Example: 'SNANET.NT81I056.PU4' or 'SNANET.PU4' 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 (see note 1):
  • "Port ID=portId"
  • "Adjacent Link Station Address=adjacentLinkStationAddress"
  • "Adjacent Node Type=adjacentNodeType"
  • "Adjacent Node Name=adj_snaNetID.adj_snaNodeName"
  • "DLC Name=dlcName"
  • "DLUR Name=dlurName"
  • "dlurLocalLSAdr==dlur Local Link Station Address"
  • "Last Port=snaNetID.snaNodeName.portID" or "Last Port=snaNetID.portID" for multiply owned resource
  • "Last Partner Logical Link=snaNetID.snaNodeName.linkName" or "Last Partner Logical Link=snaNetID.linkName" for multiply owned resource
  • "Reporting SSCPs=(names of SSCPs)" (for multiply owned resources)
  • "Def Group Type=major node type"
 Init Opt Null
DisplayResourceType P DUIXC_RTN_LOGICAL_LINK_PU Yes Opt Null
DisplayStatus P See DisplayStatus Yes Req 132
dlcName T Name of data link control for port Init Opt Null
dlurLocalLsAddress T dlur Local link station address Yes 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 the perspective of each reporting SSCP. Init Opt See page individualStatus
iPAddress A Internet Protocol address. Yes Opt Null
linkName T A copy of the DisplayResourceName field value. Init Req Null
LocateName P Locate the name of the logicalLink object, Specification: linkName Example: 'PAMUT4' Init Opt Null
logicalPort T Zero or more port objects No — Null
memberOfDefinitionGroup T Zero or more definitionGroup objects No — Null
monitoringLuCollection A Either:
0
Set of LUs is not being monitored
1
Set of LUs is in transition for continuous monitor of the luCollection
2
Set of LUs is complete for continuous monitor of the luCollection
3
Set of LUs is in transition for a timed monitor of the luCollection
4
Set of LUs is complete for a timed monitor of the luCollection
 Yes Opt 0
mySubordinates.appnTrans- missionGroup T Zero or more appnTransmissionGroup objects when this logicalLink is NTRI-type. No — Null
mySubordinates.CDRSC T Zero or more crossDomainResource objects No — Null
mySubordinates.LU T Zero or more logicalUnit objects No — Null
mySuperior T One or more objects of the following classes:
  • appnBrNN
  • appnEN
  • appnNN
  • interchangeNode
  • migrationDataHost
  • t4Node
  • t5Node
 No — Null
mySuperior.gatewayT4Node T Zero or one *t4NodeGateway objects No — Null
mySuperior.switchedOwner T One or more objects of the following classes:
  • appnEN
  • appnNN
  • interchangeNode
  • migrationDataHost
  • t5Node
 No — Null
objectClass T 1.3.18.0.0.2085 (logicalLink) No — 1.3.18.0.0.2085
packages T 1.3.18.0.0.2098 (logicalLinkPkg) 1.3.18.0.0.2154 (appnLogicalLinkPkg) 1.3.18.0.0.2060 (activateWithParametersPkg) 1.3.18.0.0.2061 (deactivateWithParametersPkg) 1.3.18.0.0.2062 (deactivateWhenNoUsersPkg) 1.3.18.0.0.2066 (nativeInfoPkg) No — 1.3.18.0.0.2098 1.3.18.0.0.2154 1.3.18.0.0.2060 1.3.18.0.0.2061 1.3.18.0.0.2062 1.3.18.0.0.2066
partnerConnection T Zero or one logicalLink objects No — Null
portId T The port identifier Init Opt Null
states T
  • administrativeState
    • X'01' (unlocked)
  • availabilityStatus
    • Either:
      X'00'
      (empty set) The resource is available for use.
      X'10'
      (offline)
  • nativeStatus
    • One of the following:
      X'00'
      (active)
      X'02'
      (inactive)
      X'03'
      (neverActive)
      X'04'
      (pendingActive)
      X'05'
      (pendingInactive)
      X'06'
      (connectable)
      X'07'
      (routable)
      X'09'
      (congestive)
      X'0A'
      (released)
      X'0B'
      (reset)
      X'0D'
      (pendingActiveOrInactive)
      X'0E'
      (releasedOrReset)
      X'FF'
      (is not currently set)
  • operationalState
    • Either:
      X'00'
      (disabled) A logical link is inactive or pending active.
      X'01'
      (enabled) A logical link is active or pending inactive.
  • proceduralStatus
    • One of the following:
      X'00'
      (empty set) Fully initialized
      X'80'
      (initialization required) Has not been active and must be initialized by the manager
      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
 Yes Opt See page states
states (continued) T
  • unknownStatus
    • Either:
      X'00'
      Logical link status is known.
      X'01'
      Logical link status is not known.
  • usageState
    • Either:
      X'00'
      (idle) Is not operational.
      X'01'
      (active) Is operational.
      X'02'
      (busy) Is in use and does not have any additional capacity.
 Yes Opt See page states
supportedConnectionNames T Zero or more objects of the following classes:
  • appnTransmissionGroup object
  • *ntriTypeAppnTgCircuit
  • subareaTransmissionGroupCircuit
 No — Null
ToposnaLucolMontime A -1 to n Yes Req 10
underlyingConnectionNames T Zero or more port objects Init Req Null
Note:
  1. The complete specification is shown. The Adjacent Node Name is present only when known.
  2. Refer to the full field description.