A fix is available
APAR status
Closed as program error.
Error description
AON Doc needs clarification. Examples from the v5r4 Administration Reference: 1) Sections 4.2 ACTMON, 4.29 MONIT, and 4.35 RECOVERY all show the statement applies to IP Management and AON/TCP, but does not show that it also applies to SNA. 2) Section 4.29 MONIT does not fully explain what the YF and NF mean (The 'F' means 'Forever') in the INTVL subsection. 3) Section 4.39 TCP390 - Defining tcpip-stack is confusing, not sure what to use - FORMAT only shows STACK, but PING and SNMP are also valid options. Also explain which option does not use SNMP. - Some of the DEFAULTS are not defined: DEBUG, RPLENGTH and VERBOSE - The PARMS are not in alphabetical order, but seem to be in the order shown with statement options. Makes it difficult to find a specific parm. 4) Need to expand explaination of how ACTMON and RECOVERY worked and what causes them to be involked. Explaination of what role MONIT and THRESHOLDS play in RECOVERY also needs to be expanded.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All Tivoli NetView for z/OS users with the * * AON.TCP or IPMGT tower enabled. * **************************************************************** * PROBLEM DESCRIPTION: The CNMPOLCY TCP390 ACTMON processing * * requires SNMP to check stack status. * * Also the ACTMON, MONIT, TCP390, and * * RECOVERY statement descriptions in the * * Administration Reference manual are * * unclear. * **************************************************************** * RECOMMENDATION: * **************************************************************** AON and IPMGT do not support stack status collection without the use of SNMP. Also, the descriptions of some policy statements in the NetView Administration Reference are unclear.
Problem conclusion
AON/IPMGT ACTMON processing is being changed to use the PING command to collect stack status for stacks defined on TCP390 statements if the style sheet DISCOVERY.SNMP variable is set to 'NO'. The CNMPOLCY sample is being changed in the following ways: - the uncommented TCP390 DEFAULTS statement MAXCONN parameter is being replaced with PINGCNT=3. - the commented TCP390 DEFAULTS statement MAXCONN, DEBUG, and VERBOSE parameters are being removed. Also, the Tivoli NetView for z/OS Administration Reference manual (SC27-2869-02) in the Policy File Definitions chapter should be changed as follows: - Under the ACTMON policy statement, near the end of the first sentence, "AON/TCP" should be changed to "AON". The second paragraph should be changed to read as follows: "The ACTMON control file entry defines active monitoring policy for critical resources in the network. When a resource is being actively monitored, the NetView program sets a timer to check the status of the resource. If the resource is not active, the NetView program initiates failure processing (also known as recovery monitoring) and suspends active monitoring in favor of recovery monitoring. Once the resource becomes active, the NetView program will resume active monitoring." - Under the ACTMON policy statement, the SP keyword definition, add the following to the end of the first sentence, "or IP management". - Under the MONIT policy statement, the INTVL keyword explanation for the value "Y", add the following sentence: "Recovery monitoring will cease after the last interval specified." - Under the MONIT policy statement, the INTVL keyword explanation for the value "N", add the following sentence: "Recovery monitoring will cease after the last interval specified." - Under the MONIT policy statement, the INTVL keyword, explanation for the value "YF", change the explanation to read as follows: "Notify operators based on your NOMOMONS Notification Policy. Recovery monitoring will continue until the resource recovers or the control file is reloaded, using the last interval specified." - Under the MONIT policy statement, the INTVL keyword, explanation for the value "NF", change the explanation to read as follows: "Repeat recovery monitoring at the last interval specified until the resource recovers or the control file is reloaded, but do not call Notification Policy." - Under the TCP390 policy statement, the keywords should be alphabetized. - Under the TCP390 policy statement, the DEBUG keyword and values explanations should be added alphabetically as follows: "DEBUG= N | Y Only applies to AON/TCP option 2.5 (Issue SNMP Commands). This determines whether or not additional diagnostic information is provided when issuing SNMP commands. The default setting is N. N Indicates that no additional diagnostic information is provided. Y Indicates that additional diagnostic information is provided." - Under the TCP390 policy statement, the VERBOSE keyword and values explanations should be added alphabetically as follows: "VERBOSE= -Ovalue Only applies to AON/TCP option 2.5 (Issue SNMP Commands). Allows a user to specify output options for the SNMP commands. -Ovalue See the SNMP command help for the -O output option syntax and values." - Under the TCP390 policy statement, the MAXCONN keyword is obsolete and should be deleted. - Under the RECOVERY policy statement, the following paragraph should be inserted before the last paragragh preceding the RECOVERY syntax diagram: "RECOVERY monitoring is invoked by message automation and by active monitoring when it has been determined that a resource is not active. The processing completes when the NetView program determines that the resource has recovered. Before completion, recovery monitoring will check for ACTMON definitions and resume active monitoring when appropriate."
Temporary fix
Comments
APAR Information
APAR number
OA41593
Reported component name
NETVIEW FOR Z/O
Reported component ID
5697NV600
Reported release
10B
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-03-01
Closed date
2013-07-12
Last modified date
2013-09-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA69866
Modules/Macros
CNMPOLCY FKXEACTT
SC27286902 |
Fix information
Fixed component name
NETVIEW FOR Z/O
Fixed component ID
5697NV600
Applicable component levels
R10B PSY UA69866
UP13/08/15 P F308
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZJDU","label":"IBM Z NetView"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10B","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10B","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
04 September 2013