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 displaying 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. In a large network, a cold start trap can generate a significant amount of network traffic. Therefore, cold start traps should not be sent out on a regular basis. A warm start trap will initiate a verification of the current SSM resources by the workstation. OPSMTRAP can be used to resynchronize the workstation on a regular basis 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.

This function 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 - Cold start trap
• E - Enterprise trap (requires all four arguments to be specified)
• W - (Default) 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 new table or resource
• D - Deletes a table or resource
• S - Sets existing table or resource values (this is the default)

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 large number of systems are being monitored by a single workstation, it is recommended to have each system generate its warm start trap at a different time to avoid overloading the workstation and the network.