Agents Administration - Tests
 

Configuration of PepPrsStatusTest

This tesr periodically checks the status of transactions on a configured Process Scheduler domain, and reports how many transactions are in which state presently. This can reveal the number of active transactions on the domain, based on which the current load on the domain can be determined. In addition, the test also warns administrators of transactional errors that may cause transactions to abort, thus enabling administrators to take pre-emptive steps in this regard.

The default parameters associated with this test are:

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • Specify the the host name of the server for which the test is to be configured in the HOST text box.

  • Specify the port on which the cluster is listening in the PORT text box.

  • Specify the database server type in the DBTYPE text box, which stores the Process table. The options are: MsSql, Oracle, Sybase, DB2, and Informix.

  • Specify the IP address/host name of the database server with which this test should connect.

  • Specify the port at which the database server listens in the DBPORT text box.

  • Provide the credentials such as USER and PASSWORD, of a user with SELECT privileges to the PSPRCSRQST and PSXLATITEM tables of the PeopleSoft database.

  • Confirm the PASSWORD by retyping it in the CONFIRM PASSWORD box.

  • INSTANCE parameter will appear only if the DBTYPE chosen is MsSql. In this text box, enter the name of the specific Microsoft SQL instance that the test should connect to.

  • The SSL parameter will appear only if DBTYPE chosen is MsSql. If the target Microsoft SQL server is SSL-enabled, then set this flag to Yes.

  • The ISNTLMV2 parameter will appear only if DBTYPE chosen is MsSql. In some Windows networks, NTLM (NT LAN Manager) may be enabled. NTLM is a suite of Microsoft security protocols that provides authentication, integrity, and confidentiality to users. NTLM version 2 (“NTLMv2”) was concocted to address the security issues present in NTLM. By default, the ISNTLMV2 flag is set to No, indicating that NTLMv2 is not enabled by default on the Microsoft SQL server, with which this test connects. Set this flag to Yes if NTLMv2 is enabled on the Microsoft SQL server.

  • The DOMAIN parameter will appear only if DBTYPE chosen is MsSql. By default, none is displayed in the DOMAIN text box. If the ‘SQL server and Windows’ authentication has been enabled for the Microsoft SQL server with which this test should connect, then the DOMAIN can continue to be none. On the other hand, if ‘Windows only’ authentication has been enabled, then, in the DOMAIN text box, specify the Windows domain in which the target Microsoft SQL server exists. In this case, the USER name and PASSWORD that you provide should be that of a DOMAIN user, who is allowed to access the Microsoft SQL server and run SELECT queries on the PSPRCSRQST and PSXLATITEM tables.

  • The ORACLE SID parameter will appear only if the DBTYPE chosen is Oracle. Here, specify the SID of the Oracle database server with which this test should connect.

  • The DATABASE parameter will appear only if the DBTYPE chosen is DB2. In this case, specify the name of the database in the DB2 server that hosts the PSPRCSRQST and PSXLATITEM tables.

  • The DBLOCALE parameter will appear only if the DBTYPE chosen is Informix. Specify the language/locale in which the PeopleSoft database is installed. This will allow you to return the query in the language supported by that database. By default this attribute is set to “none”, which means that by default, queries are returned in the English locale.

  • The CLIENTLOCALE parameter will appear only if the DBTYPE chosen is Informix. Specify the language/locale in which the eG agent is running. Normally, if the Process Scheduler and the PeopleSoft database server are running on the same host, the CLIENTLOCALE and DBLOCALE will be same. However, the CLIENTLOCALE may differ when you want this test to connect to a database server in a remote location.

    By default, the CLIENTLOCALE is set to “none”, indicating that the eG agent runs in the English locale, by default.

  • To make diagnosis more efficient and accurate, the eG Enterprise suite embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the DETAILED DIAGNOSIS capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

    The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

    • The eG manager license should allow the detailed diagnosis capability
    • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

  • If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

  • Once the necessary values have been provided, clicking on the UPDATE button will register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.