Agents Administration - Tests
 

Default Parameters for PepPrsStatusTest

This test 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.

This page depicts the default parameters that need to be configured for the PepPrsStatusTest.

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

  • 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.

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

When changing default configurations of tests, the values with “$” indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to “xyz” and $port will be changed to “80” when configuring a test.