11.21 RunKS

Use this Knowledge Script to run up to three other Knowledge Scripts. You can also specify parameter settings for the Knowledge Scripts if you do not want to use the default settings.

This script uses the login credentials of the NetIQmc service (the AppManager agent) on the management server computer.

11.21.1 Prerequisite

NetIQ Object Linking and Embedding (NetIQOLE) must be registered on the computer on which this script runs. NetIQOLE is an automation object that allows AppManager to be run from a command-line. For more information, see the Administrator Guide for AppManager at the NetIQ AppManager Documentation Web site.

11.21.2 Setting Parameter Values

Set the following parameters as needed:

Parameter	How to Set It
Event Notification
Event severity -- Action failure	Set the event severity level, from 1 to 40, to indicate the importance of an event in which the RunKS job fails. The default is 5 (red event indicator).
Severity Configuration
Minimum event severity for Action	Set the minimum severity level, from 1 to 40, for an event that triggers this Action. The default is 1.
Maximum event severity for Action	Set the maximum severity level, from 1 to 40, for an event that triggers this Action. The default is 40.
Action
Knowledge Script Configurations
View name to use for Knowledge Script filter	Select an Operator Console view and computer by which you can filter the list of available Knowledge Scripts. The default is Master. Selecting an Operator Console view limits the list of available Knowledge Scripts to those visible in that view. Selecting a computer further limits the list of available Knowledge Scripts to ones that can run on that computer.
Show Report scripts?	Select Yes to include Report scripts in the list of available Knowledge Scripts. The default is unselected.
Show Discovery scripts?	Select Yes to include Discovery scripts in the list of available Knowledge Scripts. The default is unselected.
Show Administrator scripts?	Select Yes to include all Administrator scripts (for example, AMAdmin scripts), in the list of available Knowledge Scripts. The default is unselected.
First Knowledge Script to run	Select the first Knowledge Script run by this Action script.
Parameters to pass	Select the parameters whose default settings you want to change (for example, a different threshold value). To change the parameters you selected, select CLEAR SELECTION in the Select a Parameter dialog box, then click Finish. Once AppManager clears the previous parameters, click Browse [...] again and select new parameters for which you want to change the default settings. The browser for selecting parameters lists both the parameter name as it appears in the code for the script (for example, TH_Physical) and the description of the parameter as it appears in the Values tab of the Knowledge Script Properties dialog box (for example, Maximum physical memory threshold).
Values for parameters	Provide a comma-separated list of the values for the parameters you have selected in an order that mirrors the parameter selection. For example, if you selected the following threshold parameters from NT_MemUtil for monitoring memory use: TH_Physical,TH_Virtual,TH_Paging then you would enter their values as follows: 95,95,95 NOTE:The value you enter must be in the format expected by the Knowledge Script. For example: If the possible values for a parameter are numbers from 0-100, you must enter a number in that range. If the possible values are y or n, then you must enter y or n. One exception to this is where a Knowledge Script uses a selected check box to specify a Yes value and a cleared check box to specify a No value. In this case, the underlying values are y or n, and you must enter y or n.
Second Knowledge Script to run	Select a second Knowledge Script run by this Action script.
Parameters to pass (comma- separated)	Select the parameters whose default settings you want to change (for example, a different threshold value). To change the parameters you selected, select CLEAR SELECTION in the Select a Parameter dialog box, then click Finish. Once AppManager clears the previous parameters, click Browse [...] again and select new parameters for which you want to change the default settings. The browser for selecting parameters lists both the parameter name as it appears in the code for the script (for example, TH_Physical) and the description of the parameter as it appears in the Values tab of the Knowledge Script Properties dialog box (for example, Maximum physical memory threshold).
Values for parameters	Provide a comma-separated list of the values for the parameters you have selected in an order that mirrors the parameter selection. For example, if you selected the following threshold parameters from NT_MemUtil for monitoring memory use: TH_Physical,TH_Virtual,TH_Paging then you would enter their values as follows: 95,95,95 NOTE:The value you enter must be in the format expected by the Knowledge Script. For example: If the possible values for a parameter are numbers from 0-100, you must enter a number in that range. If the possible values are y or n, then you must enter y or n. One exception to this is where a Knowledge Script uses a selected check box to specify a Yes value and a cleared check box to specify a No value. In this case, the underlying values are y or n, and you must enter y or n.
Third Knowledge Script to run	Select a third Knowledge Script run by this Action script.
Parameters to pass	Select the parameters whose default settings you want to change (for example, a different threshold value). To change the parameters you selected, select CLEAR SELECTION in the Select A Parameter dialog box, then click Finish. Once AppManager clears the previous parameters, click Browse [...] again and select new parameters for which you want to change the default settings. The browser for selecting parameters lists both the parameter name as it appears in the code for the script (for example, TH_Physical) and the description of the parameter as it appears on the Values tab of the Knowledge Script Properties dialog box (for example, Maximum physical memory threshold).
Values for parameters	Provide a comma-separated list of the values for the parameters you have selected in an order that mirrors the parameter selection. For example, if you selected the following threshold parameters from NT_MemUtil for monitoring memory use: TH_Physical,TH_Virtual,TH_Paging then you would enter their values as follows: 95,95,95 NOTE:The value you enter must be in the format expected by the Knowledge Script. For example: If the possible values for a parameter are numbers from 0-100, you must enter a number in that range. If the possible values are y or n, then you must enter y or n. One exception to this is where a Knowledge Script uses a selected check box to specify a Yes value and a cleared check box to specify a No value. In this case, the underlying values are y or n, and you must enter y or n.
Run this Knowledge Script once?	Select Yes to run the specified Knowledge Scripts only once regardless of their default schedules. The default is Yes.
Computer to run Knowledge Script	Specify the name of the computer on which the Knowledge Scripts will run, or click Browse [...] to select a computer in the Computer Browser dialog box. If you leave this parameter blank, the scripts will run on the same computer as the Knowledge Script that initiated the Action.
AppManager Repository Configuration
Use trusted connection?	Select Yes to use a trusted connection when running the Knowledge Scripts. The default is Yes. If you use a trusted connection, the Knowledge Scripts run under the logon account used by the netiqmc service on the computer running the Knowledge Script that initiated the Action. If you do not use a trusted connection, the Knowledge Scripts run with the username and password specified in the parameters below.a
Repository server	Provide the name of the SQL Server used for the AppManager repository that will manage the Knowledge Script jobs. If you leave this value blank, the local computer name is used (the local computer is the one running the Knowledge Script that initiated the Action).
Repository database	Provide the name of the AppManager repository that will manage the Knowledge Script jobs. If you leave this value blank, the default repository name, QDB, is used.
User ID (non-trusted connection)	Provide the username for the account under which the Knowledge Scripts will run (if you disabled the Use trusted connection? parameter).
Password (non-trusted connection)	Provide the password for the account under which the Knowledge Scripts will run (if you disabled the Use trusted connection? parameter).