OPS/REXX Built-in Functions › OPSMTRAP Function

OPSMTRAP Function

The OPSMTRAP function causes the generation of an SNMP trap by the SNMP subagent component of the product to support the display of System State Manager (SSM) resources on a workstation running CA NSM with the CA NSM SSM CA OPS/MVS Option. The cold start trap causes a complete rediscovery of the SSM resources by the workstation.

Note: In a large network, a cold start trap can generate a significant amount of network traffic.

A warm start trap initiates a verification of the current SSM resources by the workstation. OPSMTRAP can be used to resynchronize the workstation regularly using a TOD rule or on demand when an SNMP communication failure is suspected. An enterprise trap performs a specific action against an SSM-monitored table or resource.

The OPSMTRAP function can be used in OPS/REXX, AOF rules, TSO/E REXX, or CLIST.

OPSMTRAP has the following format:

var = OPSMTRAP(type,func,table,resource)

type

Specifies the type of SNMP trap to be sent. You can specify one of the following values for type:

C

Specifies a cold start trap.

E

Specifies an enterprise trap (requires all four arguments to be specified).

W

(Default) Specifies a warm start trap.

func

Use the func argument with the E value specified for the type argument to perform one of the following actions:

A

Adds a table or resource.

D

Deletes a table or resource.

S

(Default) Sets existing table or resource values.

table

Defines the name of an RDF table with a column structure that is known to CA NSM SSM CA OPS/MVS Option. Use the table argument with the E value specified for the type argument to specify the SSM-controlled RDF table that is intended to have the action, specified by the func argument, performed against it.

resource

Identifies the resource name of the row in the RDF table (primary key). Use the resource argument with the E value specified on the func argument and the table argument to specify the name of the SSM-monitored resource that is intended to have the action, specified by the func argument, performed against it.

Example: OPSMTRAP

Issue a warm start trap every night at midnight to ensure that the System State Manager resource data display of the CA Event Manager is synchronized with the current states and values of the SSM resources.

)TOD 00:00:00,,,,,CATCHUPYES

 )PROC
   rc = OPSMTRAP('W')
   return
 )END

Note: When a single workstation monitors many systems, we recommend that each system generates the warm start trap at a different time to avoid overloading the workstation and the network.