Rules Structure

The following tables describe the structures of the Direct Access to NetView solution rules, as well as the following KOA scripts:

• Manage a Preset NetView Environment
• Log On to NetView
• Get Value of NetView Variable
• Set Value of NetView Variable
• Enter NCCF Command and Get Response
• Enter a GENALERT Command to NetView
• Calculate Line Length in a NetView Screen
• Perform NetView GETSCREEN Commands

  Table 136 Save Reply ID of NCCFRule Structure

  Item	Description
  Title	Save Reply ID of NCCF
  Name	DSI802I
  Table	NETVIEW
  Message	Either of the following messages: DSI802I domainid REPLY WITH VALID NCCF SYSTEM OPERATOR COMMAND DSI803I domainid REPLY INVALID. REPLY WITH VALID NCCF TERMINAL OPERATOR COMMAND
  Message Description	A constant operator reply that prompts for a NetView command.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	%%NCCF_REPLY_netviewname NCCF reply number, where netviewname is the name of the NetView job or started task.
  Rule Logic	When one of the above messages appears on the console, the message reply number is updated in a Control-O Global variable. This variable is later accessed by another Control-O rule that issues reply commands to NetView.
  Rule Actions	Assigns the message reply number (system variable %%REPLY) to Global variable %%NCCF_REPLY_netviewname.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 1—little or no customization is required.

  Table 137 Send a Command to NCCF Rule Structure

  Item	Description
  Title	Send a Command to NCCF
  Name	NCCFCMD
  Table	NETVIEW
  Command	NCCFCMD
  Command Description	A user-defined command to issue a NetView command through the NetView open reply message (WTOR).
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	%%NCCF_REPLY_netviewname NCCF reply number, where netviewname is the name of the NetView job or started task.
  Rule Logic	This command uses the NetView reply number, which is stored in a Global variable, to issue a NetView command. It waits for a reply from NetView and notifies the operator in case of an invalid command. The command is especially useful when a NetView command is to be issued from a source other than the console itself. For example, batch jobs, started tasks or CLISTs can use this command to issue NetView commands without having to determine the currently open NetView reply number.
  Rule Actions	Using the NetView reply number (Global variable %%NCCF_REPLY_netviewname), issues the appropriate reply command. Waits for NetView’s reply and, if it announces an invalid command, notifies user U-SHFTOPER.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 1—little or no customization is required.

  Table 138 Set a Global Variable in NetView Rule Structure

  Item	Description
  Title	Set a Global Variable in NetView
  Name	SETNTVAR
  Table	NETVIEW
  Command	SETNTVAR variable-name variable-value
  Command Description	A user-defined command to set a Global variable in NetView.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	None.
  Rule Logic	This command invokes KOA script SETNVAR that sets a NetView Global variable. The command is very useful for integrating procedures of NetView and of Control-O.
  Rule Actions	Invokes KOA SETNVAR with the same parameters as the command. Issues messages to INCONTROL user U-SHFTOPER according to the KOA’s return code.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 1—little or no customization is required.

  Table 139 Get the Value of a Global Variable From NetView Rule Structure

  Item	Description
  Title	Get the Value of a Global Variable From NetView
  Name	GETNTVAR
  Table	NETVIEW
  Command	GETNTVAR netview-variable Control-O-variable
  Command Description	A user-defined command to get the value of a Global variable from NetView.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	The Global variable name is specified as the third word of the command.
  Rule Logic	This command invokes KOA script GETNVAR that extracts the value of a NetView Global variable and assigns it to a Global variable in Control-O. The command is very useful for integrating procedures between NetView and Control-O.
  Rule Actions	Parses command text to extract required data. Performs KOA script GETNVAR that uses the same variables as the command. Issues messages to INCONTROL user U-SHFTOPER according to the KOA’s return code.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 1—little or no customization is required.

  Table 140 Set a Global Variable in Control-O Rule Structure

  Item	Description
  Title	Set a Global Variable in Control-O
  Name	SETGLVAR
  Table	NETVIEW
  Command	SETGLVAR variable-name variable-value
  Command Description	A user-defined command to set a Global variable in Control-O.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	The Global variable name is passed as the second word of the command.
  Rule Logic	This command sets a Global variable whose name is given by the first parameter and assigns the second parameter as its value. The command is very useful for integrating NetView with Control-O. It enables NetView CLISTs or NetView exits to set Global variables in Control-O using a simple operator command.
  Rule Actions	Assigns the value of the second command parameter to a Global variable named by the first command parameter.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 1—little or no customization is required.

  Table 141 Record NPDA Alerts to the IOA Log Rule Structure

  Item	Description
  Title	Record NPDA Alerts to the IOA Log
  Name	BNJ030I
  Table	NETVIEW
  Message	BNJ030I operatorid time type ALERT RECEIVED FROM THE FOLLOWING RESOURCE: resource
  Message Description	An alert was generated in NetView.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	None.
  Rule Logic	As soon as an alert is generated in NetView, a message is issued to the console. This message triggers this rule that sends it to IOA.
  Rule Actions	Sends a message to user U-NETVALRT with the text of the alert.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 1—little or no customization is required.
  Customization	CLIST CTONVINI (supplied in the SOLVKOA library) issues a series of NPDA Set Recording Filter (SRFILTER) commands to enable alert generation and to allow Control-O to receive NetView alert information. The CLIST must be adapted to site conventions and copied to one of the libraries specified in DD statement DSICLD of the NetView procedure. The NetView startup CLIST used at the site must be modified to issue command CTONVINI that sets the NPDA SRF filters.

  Table 142 Send Alert to NPDA Rule Structure

  Item	Description
  Title	Send Alert to NPDA
  Name	IEF450I
  Table	NETVIEW
  Message	IEF450I jjj {ppp} sss - ABEND {Scde|Ucde} REASON=xxxxxxxx TIME=hh.mm.ss
  Message Description	Step sss of job jjj abended.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	%%NETVIEW_ALERT_JOB_jobname where jobname is the name of the abending job. Such a variable must be defined for each job that must be monitored by this rule.
  Rule Logic	When a job abend message is intercepted, the rule checks if the job name appears in a predefined list of jobs. If the job’s name appears on the list, an alert is sent to NetView about the abend.
  Rule Actions	Checks if there exists a Global variable called %%NETVIEW_ALERT_JOB_jobname. If such a variable exists, KOA script GENALRT is invoked to generate an alert in NetView.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 2—some customization is required before implementation.
  Customization	The rule looks for a Global variable called %%NETVIEW_ALERT_JOB_jobname. To maintain a list of jobs that require generating an alert in NetView when they abend, the appropriate Global variables must be set by a rule that is activated during system or NetView startup. For additional information, see the Customization item in Table 148.

  Table 143 Manage a Preset NetView Environment Script Structure

  Item	Description
  Title	Manage a Preset NetView Environment
  Name	NETVUE
  KOA Script Description	This script manages the preset NetView environment that is used by the other KOA scripts and Control-O rules in this solution.
  Activating the KOA Script	Script NETVUE is activated automatically by a Control-O server in response to requests for the preset NetView environment.
  Parameters	Functions: INIT, TERM, RESET.
  Global Variables	None.
  KOA Script Logic	When the function is INIT, the KOA logs on to NETVIEW, types the userid and password and receives the main entry panel. The NetView screens are received by KOA script SCRNWAIT, which handles the special way in which NetView sends its screens (each part of the screen is sent separately). When the function is RESET, the KOA returns to the main NetView entry panel. When the function is TERM, the KOA logs off from NetView.
  Recommended Category	The SolveWare category for this KOA script is 3—the script is provided as an example. Some customization is needed if the script is to be implemented.
  Customization	The user ID, password and NetView VTAM application ID entered by this script must be modified according to site requirements. An alternative is to keep the user ID and password in a protected dataset and to extract them by using KOA file functions ALLOC, OPENFILE and GETFILE.

  Table 144 Log On to NetView Script Structure

  Item	Description
  Title	Log On to NetView
  Name	LOGNET
  KOA Script Description	This script is called by other scripts in order to log on to handle the online session with NetView. The script performs logon and logoff actions.
  Activating the KOA Script	The KOA script is called using a CALLMEM statement from other KOA scripts (GETNTVAR, SETNTVAR, GENALERT).
  Parameters	Functions: INIT, TERM, RESET
  Global Variables	None.
  KOA Script Logic	When the function is INIT, the KOA logs on to NETVIEW, types the userid and password and receives the main entry panel. The NetView screens are received by KOA script SCRNWAIT, which handles the special way in which NetView sends its screens (each part of the screen is sent separately). When the function is RESET, the KOA returns to the main NetView entry panel. When the function is TERM, the KOA logs off from NetView.
  Recommended Category	The SolveWare category for this KIOA script is 3—the script is provided as an example. Some customization is needed if the script is to be implemented.
  Customization	The user ID, password, and NetView VTAM application ID entered by this script must be modified according to site requirements. An alternative is to keep the user ID and password in a protected dataset and to extract them by using KOA file functions ALLOC, OPENFILE, and GETFILE.

  Table 145 Get Value of a NetView Variable Script Structure

  Item	Description
  Title	Get Value of a NetView Variable
  Name	GETNVAR
  KOA Script Description	This KOA script retrieves the value of a given NetView variable and sets a Control-O Global variable to the obtained value.
  Activating the KOA Script	The KOA script is activated by rule GETNTVAR in this solution.
  Parameters	netview-variable Control-O-variable.
  Global Variables	Control-O-variable specifies the name of the Global variable.
  KOA Script Logic	The KOA script enters the NCCF facility and issues the supplied NetView CLIST GETCG using script NCCFCMD to display the value of the Netview variable. The Control-O Global variable is set to the obtained value.
  Recommended Category	The SolveWare category for this KOA script is 3—the script is provided as an example. Some customization is needed if the script is to be implemented.
  Customization	CLIST GETCG (provided in the SOLVKOA library) must be copied to one of the NetView CLIST libraries specified in the DD statement DSICLD in the NetView procedure.

  Table 146 Set Value of a NetView Variable Script Structure

  Item	Description
  Title	Set Value of a NetView Variable
  Name	SETNVAR
  KOA Script Description	This KOA script sets the value of a given NetView variable to the desired value.
  Activating the KOA Script	The KOA script is activated by rule SETNTVAR in this solution.
  Parameters	%A1 NetView variable to be set by the script %A2 New value for the NetView variable
  Global Variables	None.
  KOA Script Logic	The KOA script enters the NCCF facility and issues the NetView command SETCGLOB using script NCCFCMD to set the value of the Netview variable.
  Recommended Category	The SolveWare category for this KOA script is 1—little or no customization is needed.

  Table 147 Enter NCCF Command and Get Response Script Structure

  Item	Description
  Title	Enter NCCF Command and Get Response
  Name	NCCFCMD
  KOA Script Description	This KOA script enters a given NCCF command and loads the response into Control-O AutoEdit variables.
  Activating the KOA Script	The KOA script is called using CALLMEM statements by other scripts in this solution.
  Parameters	nccf-command.
  Global Variables	None.
  KOA Script Logic	The KOA script enters the NCCF facility, and issues command nccf-command, which is passed as a parameter. The responses are analyzed using script NEXTLINE and stored in Control-O AutoEdit variables %%LINE1, %%LINE2,.....%%LINEn.
  Recommended Category	The SolveWare category for this KOA script is 1—little or no customization is needed.

  Table 148 Enter a GENALERT Command to NetView Script Structure

  Item	Description
  Title	Enter a GENALERT Command to NetView
  Name	GENALRT
  KOA Script Description	This KOA script enters an alert to NetView using command GENALERT.
  Activating the KOA Script	The KOA script is invoked by rule IEF450I in this solution.
  Parameters	%A1 System ID %A2 Job name
  Global Variables	None.
  KOA Script Logic	The KOA script enters the NCCF facility and issues NetView command GENALERT to enter an alert to Netview.
  Recommended Category	The SolveWare category for this KOA script is 3—the script is provided as an example. Some customization is needed if the script is to be implemented.
  Customization	The resource hierarchy specified in the GENALERT command can be adapted to site conventions. The supplied hierarchy is CPU (smf ID), PROD (CTO) and PROG (jobname). CLIST CTONVINI (supplied in the SOLVKOA Library) issues a series of NPDA set recording filter (SRFILTER) commands to allow alert generation and to allow Control-O to receive NetView alert information. The CLIST must be adapted to site conventions and copied to one of the libraries specified in DD statement DSICLD of the NetView procedure. The NetView startup CLIST used at the site must be modified to issue command CTONVINI, which sets the NPDA SRF filters.

  Table 149 Calculate Line Length in a NetView Screen Script Structure

  Item	Description
  Title	Calculate Line Length in a NetView Screen
  Name	NEXTLINE
  KOA Script Description	This KOA script returns the number of the next line containing information on the NetView screen.
  Activating the KOA Script	This script is activated automatically by another script that receives the NetView screen.
  Parameters	%A1 The number of the current line. %A2 The number of the first line containing information on the NetView screen. %A3 The number of the last line on the screen that contains information.
  Global Variables	None.
  KOA Script Logic	The next line to be processed is returned to the script that invoked script NEXTLINE using variable %%nextline.
  Recommended Category	SolveWare Category for this script is 1—minimal or no customization is required.

  Table 150 Perform NetView GETSREEN Commands Script Structure

  Item	Description
  Title	Perform NetView GETSREEN Commands
  Name	SCRNWAIT
  KOA Script Description	Handles receipt of screens from NetView.
  Activating the KOA Script	This script is called by other scripts that require access to a NetView screen.
  Parameters	%A1 Maximum number of seconds to attempt to receive the screen. %A2 Number of seconds after which, if the screen did not change, to consider the screen complete.
  Global Variables	None.
  KOA Script Logic	NetView screens are normally sent in several pieces. Script SCRNWAIT performs a NetView GETSCREEN command once per second and determines that the screen is complete when either no new screen data is received for a specified number of seconds (variable %A2), or a maximum number of seconds elapsed (variable %A1). One of the following return codes is returned by the script: 0 – A complete screen was received. 4 – Nothing was received. 8 – A VTAM error occurred.
  Recommended Category	SolveWare Category for this script is 1—minimal or no customization is required.