ACTION(snapshot) request

Similar to other operations, the ACTION(snapshot) request is sent to an object instance. It differs from other operations in that the number of object classes that support the ACTION(snapshot) operation is small. The classes that do support ACTION(snapshot) represent collections of objects.

The following object classes support the ACTION(snapshot):

Object class

Description

snaLocalTopo

Represents the graph object that contains all of the resources owned by a local VTAM®. An ACTION request to this object is asking for the following data:

Local VTAM data
Lines
PUs
Link stations
Owned NCP data
Contacted adjacent node data
APPN and subarea TGs

snaNetwork

Represents the graph object that contains all of the network information known at a VTAM node.

luCollection

Represents the collection object that contains all of the LU information associated with a specific PU or the VTAM host.

logicalUnitIndex

Represents the collection object that contains the instances of a given LU name known at a VTAM node or throughout the network. Note that an ACTION on the logicalUnitIndex object is not considered a monitoring function. It more closely resembles the function of the GET operation and is discussed in detail with the GET operation instead of with the various ACTION monitors.

In addition to the object class and object instance, the ACTION request includes a segment called the actionInfoArg. This segment is a sequence of three possible fields, of which any specific ACTION request can include a maximum of two of the following fields:

start

Indicates that the ACTION request is to start a new snapshot operation. If this field is present in the request, an additional token of information is included in this field that is one of the following:

oneTimeOnly: Indicates that the snapshot is requesting only initial data, that is, the monitoring of future changes to resource data is not being requested.
ongoing: Indicates that both initial data and update data are being requested; this includes the current resource information and future changes to this data.

stop

Indicates that the ACTION request is to stop a previous start ACTION request. The start and stop fields are mutually exclusive; however, one of these two fields must appear in a valid ACTION(snapshot) request. If the stop field is present, an additional mandatory token is included after the stop token that provides the invoke identifier of the start request that is to be terminated.

additional info (addlInfo)

Optionally specifies data that is specific to the target object. For example, both snapshots for snaLocalTopo and snaNetwork might contain the appnPlusSubareaParm parameter, which has an information value representing either appnOnly or appnPlusSubarea. This field applies only if the start field is included.