Using the InputAccel Wizard

The InputAccel Wizard helps you create a resource testing the InputAccel server connections to InputAccel modules and capture process exceptions on the InputAccel server.  To use the InputAccel wizard to add a resource to a monitor, complete the following steps:

1. From the Resource Functions Setup Wizards window, select InputAccel Wizard, and click OK.  The Reveille InputAccel Wizard window appears.
2. Click Next.  The next wizard page appears.
3. Select ScaleServer Support to be able to configure settings for an InputAccel ScaleServer environment.  It is not selected by default.
4. Select Write Errors to Event Log to have Reveille write InputAccel errors to the NT® Event Log.  It is not selected by default.
5. Click Next.  The next wizard page appears.
6. In Web Server, enter the Reveille server name. This Reveille™ server must have the InputAccel objects installed so they can be accessed by Reveille.
7. In InputAccel Server, enter the name of the InputAccel server being monitored.
8. In Domain, enter the domain name, if applicable.
9. In User Name, enter your user name to log on to the selected InputAccel server, this is the server listed in InputAccel Server.
10. In Password, enter your password for the selected InputAccel server.
11. Select Encrypt User Name/Password to encrypt this data in the Windows registry.
    This prevents the data from appearing in scripts or other windows in Reveille.
12. Select Next.  The next wizard page appears.
13. On the General tab, under Create Network Diagram using, select Module Name/Machine Name if you want the resource boxes in the application diagram to list the module and machine name.
    
    Select Machine Name Only if you want the resource boxes in the application diagram to list the machine name only.

The steps to finish this procedure are different depending on whether you want to use the Auto Discover feature or set the values manually.  Auto Discover enables you to generate the resource functions, or Tests, automatically for the InputAccel Monitor. It instructs Reveille to retrieve the connection list from the InputAccel server and build the resource functions accordingly. Using Auto Discover, you do not have to input setting values manually.

Using Auto Discover

If you chose to set the resource functions automatically, complete the following steps:

1. Under Auto Discover Tests, select the types of tests you want to include in this InputAccel resource function:

Test	Description
Connection	Creates a sequence for the resource function, testing the connection between the client and the InputAccel server.
Hung Batch	Creates a sequence for the resource function, comparing the previous batch list with the current batch list, and identifies if any of the batches are still running. If a batch is still running, it is considered a hung batch. The batch lists are generated at least five minutes apart to ensure that the batches have sufficient time to execute completely.
Batch Aging	Creates a sequence for the resource function, monitoring batch age for a batch within a process.
Batch Priority	Creates a sequence for the resource function, checking for processes with batches having more than a set number of zero priorities.
Maximum/Minimum Tasks	Creates a sequence for the resource function, checking for InputAccel modules with more or less than a set number of queued tasks, active tasks, or both.
Batch Zero Tasks	Creates a sequence for the resource function, checking for the number of batches with zero tasks within a process ID.
Batch Lock	Creates a sequence for the resource function, checking for the number of batches with persistent locks.

 

2. Click the Auto Discover button.  The next window is displayed. Select one or more InputAccel modules to monitor.
3. Click Next.  If you selected to auto discover Batch Priority, the next wizard page appears.  

From this page, complete the following steps:

4. Select the processes with batches that you want to monitor for zero priorities.
5. In Number of Batches at Zero, enter the minimum number of instances of zero priority having to occur for each selected process before you are alerted.
6. Click Set Value .
7. Click Next.  If you selected to auto discover Maximum/Minimum Tasks, the next wizard page appears.

From this page, complete the following steps:

8. Select modules for which you want to monitor queued tasks, active tasks, or both.
9. In Number of Tasks, enter the maximum/minimum number of queued tasks, active tasks, or both having to occur within each selected InputAccel module before you are alerted.
10. Next to Type of Task, select the task is queued, active, or both.
11. Click Set Value.
12. Click Next. If you selected to auto discover Batch Aging, the next wizard page appears.

From this page, complete the following steps:

13. Select the processes for which you want to monitor batch aging.
14. If you want Reveille to ignore batch priority levels, select Process Level Only, and go to step 15.
15. If you want to check for batch priority levels, select a process and click Set Values .  The Set Priority window appears.  From this window, complete the following steps:

16. Enter the specific value or a range of values for batch priority. Select either Hour(s) or Minute(s) for the aging interval.
17. In Batch Age Interval, enter the limit for the number of hours a batch should be in the system.  Reveille generates an alert when batches at the selected priority are in the system beyond the desired interval.
18. Click Save.
19. If you want to add a new process to the list, click Add New. The Add New Process Priority Value window appears.
20. Complete the settings for the new process and click Add.
21. Click Next.  If you selected to auto discover Batch Zero Tasks, the next wizard page appears.

From this page, complete the following steps:

22. Set the Number of Batches with Zero Tasks and select a Process ID from the list.
    
    -OR-
    
    Set the Number of Batches with Zero Tasks and select Apply to all Processes.
23. Click Next.  If you selected to auto discover Batch Lock, the next wizard page appears.

From this page, complete the following steps:

24. In Number of Batches with Locks, set the number of batches with locks and select a Process ID from the list.
    
    -OR-
    
    Set the Number of Batches with Locks, and select Apply to all Processes.
25. Click Next.  A page appears confirming the completion of the wizard for the InputAccel server. If you need to add another InputAccel server to the Monitor, click Continue and the wizard starts again.
26. When you are done adding InputAccel servers to the Monitor, click Next. A page appears confirming you have added the Monitor.
27. Click Finish.  The application diagram for the Monitor appears.

Setting Values Manually

If you chose to set the resource functions manually, complete the following steps:

1. From the Reveille InputAccel Wizard window, select the Add Connection tab.  From this tab; you can create a sequence for the resource function testing the connection between the client and the InputAccel server.

To complete the settings under this tab, follow these steps:

2. In IA Module Name, enter the name of the module you want to test.
3. In Machine Name, enter the name of the machine running the module.
4. Click Add Connection button.
5. Select the Add Hung Batch tab. From this tab, you create a sequence for the resource function that compares the previous batch list with the current batch list and identifies if any of the batches are still running. If a batch is still running, it is considered a hung batch. The batch lists are generated at least five minutes apart to ensure that the batches have sufficient time to execute completely.

To complete the settings under this tab, follow these steps:

6. In IA Module Name, enter the name of the module on which you want to check for hung batches.
7. In Machine Name, enter the name of the machine running the module.
8. In Time Limit for Hung Batches, enter the number of minutes required for a batch to complete. If the batch does not complete by the set number of minutes, it is defined as a hung batch.
9. If you want Reveille to reset a hung batch, select Reset Hung Batches. The Value option appears.
10. Enter the priority value you want to assign to the hung batch.
11. Click Add Batch.
12. Select the Add Batch Zero Priority tab. From this tab, you create a sequence for the resource function that alerts you when processes with batches have more than the selected number of zero priorities.

To complete the settings under this tab, follow these steps:

13. In IA Process ID, enter the name of the InputAccel process you want to monitor.
14. In Batches with Zero Priority Maximum, enter the minimum number of instances of zero priority having to occur for each selected process before you are alerted.
15. Click Add Priority.
16. Select the Add Max Tasks tab. From this tab; you create a sequence for the resource function monitoring queued tasks within InputAccel modules.  

To complete the settings under this tab, complete the following steps:

17. In IA Module Name, enter the InputAccel module to monitor.
18. In Machine Name, enter the machine for the module.
19. In Maximum/Minimum Module Tasks, enter the maximum/minimum number of queued tasks, active tasks, or both having to occur within each selected module before you are alerted.
20. Click Add Tasks .
21. Select the Add Batch Aging tab. From this tab; you create a sequence for the resource function monitoring batch age for a batch within a process.

To complete the settings under this tab, complete the following steps:

22. In IA Process ID, enter the name of the InputAccel process you want to monitor for batch aging.
23. Click Set . The Set Priority window appears. Enter the specific value or a range of values for batch priority.
24. In Batch Age Interval, enter the limit for the number of hours a batch should be in the system.  Select either Hour(s) or Minute(s) for the aging interval.  Reveille generates an alert when batches at the selected priority are in the system beyond the desired interval.
25. Click Save.
26. In Batch Age Interval, enter the minimum number of hours that a process has to be active before you are alerted.
27. Click Add Aging.
28. Select the Add Batch Zero Tasks tab. From this tab, you create a sequence checking for the number of batches with zero tasks by process ID.

To complete the settings under this tab, follow these steps:

29. In IA Process ID, enter the name of the InputAccel process you want to monitor for batch zero tasks.
    
    -OR-
    
    Select Apply to all Processes, if you want the test to apply to all processes.
30. In Batches with Zero Tasks Maximum, enter the minimum number of batches with zero tasks having to occur within the selected process or processes before you are alerted.
31. Select the Add Batch Lock tab. From this tab, you create a sequence checking batches with locks by process function.

From this tab, do the following:

32. In IA Process ID, enter the name of the InputAccel process you want to monitor for batches in a locked state.
    
    -OR-
    
    Select Apply to all Processes, if you want the test to monitor all processes.
33. In Batches in Lock State Maximum, enter the minimum number batches in a locked state having to occur within a process or processes before you are alerted.
34. Click Next. A page appears confirming the completion of the wizard for the InputAccel server. If you need to add another InputAccel server to the Monitor, click Continue and the wizard starts again.
35. Click Next. The next wizard page appears.
36. Click Finish.  The application diagram for the Monitor appears.