Action request

A snapshot action request is used to request local topology data from a VTAM® topology agent host. The action request is sent as an m-Action-Confirmed operation.

The manager application program can request that any future updates to the snaLocalTopo object be returned, as they occur. The local topology data is requested without updates by specifying the oneTimeOnly value in the actionInfoArg portion of the request. The local topology data and future updates can be requested by specifying the ongoing value in the actionInfoArg portion of the request.

The target object of the request is the only object instance in the snaLocalTopo object class. Therefore, a single object instance name must be specified as the baseManagedObjectInstance in the request.

Optionally, the manager application program can specify the appnPlusSubareaParm parameter that indicates whether the requested data is appnOnly or appnPlusSubarea. An appnOnly request does not result in only APPN objects being reported. However, it does result in no NCP objects being reported. Instead, an NCP is considered part of a composite node with the VTAM topology agent host. The appnPlusSubarea request results in NCPs being reported as type 4 nodes. If the appnPlusSubareaParm is not specified in the request, the default value is appnOnly.

The following example shows a start request for snaLocalTopo data:

           msg CMIP-1.ROIVapdu (invokeID 196612,
 operation-value 7, argument (baseManagedObjectCl
 ass 1.3.18.0.0.2152, baseManagedObjectInstance (
 distinguishedName (RelativeDistinguishedName (At
 tributeValueAssertion (attributeType 1.3.18.0.2.
 4.6, attributeValue "NETA")), RelativeDistinguis
 hedName (AttributeValueAssertion (attributeType
 1.3.18.0.0.2032, attributeValue "SSCP1A")), Rela
 tiveDistinguishedName (AttributeValueAssertion (
 attributeType 1.3.18.0.0.2216, attributeValue (s
 tring "SnaLocalTopology"))))), actionInfo (actio
 nType 1.3.18.0.0.2222, actionInfoArg (start ongo
 ing, addlInfo (ManagementExtension (identifier 1
 .3.18.0.0.2164, significance TRUE, information 1
 ))))))

Note from the example that the snaLocalTopo object name is composed of the network identifier and node name of the VTAM topology agent host, followed by the graphId (1.3.18.0.0.2216) naming attribute, which is required to have a value of (string "SnaLocalTopology"). The actionType is a snapshot, and the actionInfoArg indicates that this request is to start an ongoing snapshot. Also in this example the appnPlusSubareaParm (1.3.18.0.0.2164) is specified with information value of 1, which means appnPlusSubarea. An information value of 0 means appnOnly. The significance value of TRUE means that if the VTAM topology agent finds an error associated with the specification of this appnPlusSubareaParm parameter, then the manager application program needs to receive an error response (ROER). A FALSE value tells the VTAM topology agent to ignore the parameter if an error is found.

This is a typical example of a snaLocalTopo snapshot request that can be used simply by supplying the appropriate network ID and SSCP or CP name of the VTAM topology agent host.