Rules actions that are specific to the Rules Management application
The Rules Management application supports Rules that perform actions which the classic Rules do not support. The Rule actions are:
- Send Email action
- Collect diagnostics
- Send SNMP trap action
To use these Rules, you must perform customize tasks not only within MainView AutoOPERATOR but also in IBM agents. For more information, you can also view this quick course video: Email and SNMP rule actions.
Send Email action customization
You must customize the USS SENDMAIL client for each LPAR to be able to use the Rule action to send Emails. The client (/bin/sendmail) is spawned as a shell (/bin/sh). The user ID assigned to the MainView AutoOPERATOR PAS is used for the spawned process. You must ensure that the user ID is authorized to spawn a process, and should have access to the paths /bin/sendmail and /bin/sh.
In addition, the SENDMAIL client must be configured in the USS environment. You can test the sendmail command by using the TSO OMVS command to see if it is operating as expected. For more information about the SENDMAIL client, see the IBM document z/OS Communications Server: IP Configuration Guide.
Collect diagnostics action
To enable Rules to collect diagnostic information, you must perform customization in the the following items:
- The USS SENDMAIL client for each LPAR
Perform the customization that is described in Send Email action customization. - The IMFEXEC MVX Host Server from the EZAOSOL view
The following examples show the EZAOSOL view and the dialog you must customize.
ddmmmyyyy 12:19:16 --------------------------------- MAINVIEW WINDOW INTERFACE (
COMMAND ===>
CURR WIN ===> 1 ALT WIN ===>
W1 =EZAO=====EZAOSOL==JO82=====*========ddmmmyyyy==12:19:07====MVAO=====D====1==
Solutions
Solution Setup Utility
.Email from EXECs +---------------------+ .List of Views
.SNMP Traps | Place cursor on | .List of User Views
.zAware | choice and press | .List of Screens
.IMFEXEC MVX Host Server | ENTER |
+---------------------+ .Quit/Disconnect
.Quit Click on the IMFEXEC MVX Host Server hyperlink and the IMFEXEC MVX Host Server Solution Setup dialog is displayed:
+------------------ IMFEXEC MVX Host Server Solution Setup -------------------+
| COMMAND ===> SCROLL ===> PAGE |
| |
| IMFEXEC MVX Host Server Identification |
| Server: |
| Port..: |
| |
| Usage Information |
| For an example of how to use IMFEXEC MVX commands, see the supplied EXECs |
| named QAOMVXGT and QAOMVXIN found in BBPROC. |
| |
| This dialog will create variables in the local AutoOPERATOR PROFILE pool |
| that can be used by IMFEXEC MVX commands in this PAS. The variables are: |
| |
| BMC_SOLUTION_MVHS_SERVER |
| BMC_SOLUTION_MVHS_PORT |
| |
| Additional documentation can be found in the MainView AutoOPERATOR |
| Solutions Guide. |
| |
| |
| END to exit and save changes |
| CANCEL to exit and discard changes |
| HELP to view related help |
| |
| |
+-----------------------------------------------------------------------------+Press PF1/Help for more information about the fields and what values you need to enter.
SNMP trap action customization
To customize for the SNMP trap action, use the EZAOSOL view to specify the values. The following figure shows an example of the EZAOSOL view:
DDMMMYYYY 12:19:16 --------------------------------- MAINVIEW WINDOW INTERFACE (
COMMAND ===>
CURR WIN ===> 1 ALT WIN ===>
W1 =EZAO=====EZAOSOL==JO82=====*========DDMMMYYYY==12:19:07====MVAO=====D====1==
Solutions
Solution Setup Utility
.Email from EXECs +---------------------+ .List of Views
.SNMP Traps | Place cursor on | .List of User Views
.zAware | choice and press | .List of Screens
.IMFEXEC MVX Host Server | ENTER |
+---------------------+ .Quit/Disconnect
.Quit To customize for the send SNMP trap action, select SNMP Traps option. The following dialog is displayed:
+------------------------- SNMP Traps Solution Setup -------------------------+
| COMMAND ===> SCROLL ===> PAGE |
| |
| SNMP Manager Identification for EXECs |
| Name/ID...: |
| Port......: |
| Community.: |
| Enterprise: |
| |
| SNMP Manager Identification via Rule Action |
| Name/ID...: |
| Community.: |
| Audit.....: S No Yes Long |
| Debug.....: |
| |
| Usage Information |
| To see an example of how to use SNMP Traps in an EXEC, refer to the |
| supplied EXECs named QAOSNMP1 and QAOSNMP3 found in the BBSAMP library. |
| |
| This dialog will create variables in the local AutoOPERATOR PROFILE pool |
| that can be used in SNMP-related EXECs in this PAS. The variables are: |
| |
| BMC_SOLUTION_SNMP_MANAGER |
| BMC_SOLUTION_SNMP_PORT |
| BMC_SOLUTION_SNMP_COMMUNITY |
| BMC_SOLUTION_SNMP_ENTERPRISE |
| |
| Additional documentation can be found in the MainView AutoOPERATOR |
| Solutions Guide. |
| |
| This dialog also creates profile pool variables for use when creating |
| an SNMP trap via a rule action. The variables are: |
| |
| BMC_SOLUTION_SNMP_RULE_MANAGER |
| BMC_SOLUTION_SNMP_RULE_COMMUNITY |
| BMC_SOLUTION_SNMP_RULE_AUDIT |
| BMC_SOLUTION_SNMP_RULE_DEBUG |
| |
| |
| END to exit and save changes |
| CANCEL to exit and discard changes |
| HELP to view related help |
+-----------------------------------------------------------------------------+
Enter values for the Name/ID and Community fields in the section of the view that is titled SNMP Manager Identification via Rule Action.
- The value for the Name/ID field is the FQDN (or IP Address) of the IBM SNMP Agent running on z/OS that the MainView AutoOPERATOR SNMP subagent connects to, and is responsible for sending the MainView AutoOPERATOR traps to the Event Management System/Network Management System (EMS/NMS). Usually this value will be LocalHost.
- The value for Community field is the name defined in the IBM z/OS SNMP Agent that the MainView AutoOPERATOR SNMP Distributed Program Interface (DPI) subagent uses to connect to the IBM SNMP agent. The community name might (or might not) be the same as the community name used between the IBM SNMP Agent and the EMS/NMS.
Configure the IBM SNMP agent
In addition to the SNMP Traps Solution Setup dialog, you must edit and compile the MainView AutoOPERATOR SNMP Management Information Base (MIB).
The MainView AutoOPERATOR version of the MIB file is distributed in the BBSAMP member QAOMIB. The QAOMIB member defines the SNMP trap information generated by the MainView AutoOPERATOR Rules SNMP trap feature, and defines the default SNMP traps generated by the default QAOSNMP1 and QAOSNMP3 REXX EXECs (also distributed in BBSAMP), You can compile this MIB using your EMS/NMS to define the incoming MainView AutoOPERATOR traps.
MV AO trap object identifier (OID):
The MainView AutoOPERATOR Rules generated trap uses the OID:
1.3.6.1.4.1.1074.1.1.2.0.1
Use this OID value to configure the NOTIFY_FILTER parameter.
For more information about configuring the IBM SNMP Agent, see the IBM documentation z/OS Communications Server: IP Configuration Reference.
Comments
Log in or register to comment.