This chapter contains the following sections:
To effectively and correctly use the Oracle TSAM Plus Agent, please note the following prerequisites:
The following APIs are used in conjunction with Oracle TSAM Plus:
User applications can take advantage of the monitoring attributes by using
tpgetcallinfo is designed for call path monitoring. Using
tpgetcallinfo, allows applications to make dynamic decisions based on application performance metrics.
For more information, see
) in the Oracle TSAM Plus Reference Guide.
Local Monitor Server (LMS) is a component of Oracle TSAM Plus Agent. It performs the following tasks:
For more information, see Reference Guide.in the Oracle TSAM Plus
To use Oracle Tuxedo Application Runtime for CICS monitoring, an additional configuration file (
Region-Group.mapping)is required. The file must be put in the directory specified by the
KIXCONFIG environment variable. For more information, see .
Listing 2-1 shows a
Region-Group.mapping file format example.
Each region has a section in this file. The CICS region is called "name". The
tuxgroups parameter is followed by the Oracle Tuxedo group name. The
resources_group parameter is the CICS resource group in this region.
For more information, see the
|Note:||For Oracle Tuxedo Application Runtime for CICS running on Linux, the ARTMON server must be configured in order to enable TSAM Plus monitoring.|
If you need to monitor Oracle Tuxedo Application Runtime for Batch ARTJES component, set the JESMONITOR environment variable to yes before you start the LMS server.
To monitor Oracle PeopleSoft Applications, you need to create a configuration file which is used to add necessary configurations required by TSAM Plus in the PeopleSoft ubx file. Listing 2-2 shows the file format.
Table 2-1 lists the keywords in the configuration file.
A label for PeopleSoft domains. The default value is PS_DOMAIN. It can be used to identify multiple PeopleSoft domains. It is Optional.
After the configuration file is created, run the tsamadmin command to execute the file. For example, if the configuration file name is template_file, run the following command:
Make sure tsamadmin is added to your PATH environment variable.
Particularly, if you want to start tlisten, run the command with the -t option:
tsamadmin template_file -t
Execute the PeopleSoft command psadmin in the Shell interface ( make sure it has been added to your PATH environment variable), then follow the prompt on the screen to configure the desired domain. After the domain is shut down, select “Load config as shown“ in the command line to create the new configuration. Finally, boot your PeopleSoft domain.
|Note:||After the monitoring policy is automatically generated, you need to enable the policy in TSAM Plus Manager 12.2.2 console.|
Oracle TSAM Plus Agent provides a
tmadmin command to turn on/off. If you want to turn off Oracle TSAM Plus temporally, this command can be used. The format is as follows:
changemonitor (chmo) [-m machine] on|off
-m parameter specifies the logic machine name where the Oracle TSAM Plus collection is disabled. Without this option, monitoring on all machines is disabled. By default, monitoring is turned on. If monitoring is turned off, all data collection is stopped even if there is a monitoring policy defined.
TSAM Plus accounting and chargeback feature is used to collect data of all users and transactions during online processing and make offline analysis. For more information, seein the Oracle TSAM Plus Reference Guide.