• In the upper left-hand corner of the log-in screen, click the Settings drop-down menu. You can select the following three options; the settings take effect immediately:In the upper right-hand corner of the Oracle TSAM Console page, click Accessibility; the Accessibility Preferences page appears. It has the same three user accessibility options as the log-in screen.When you have selected your options, click OK; the settings take effect immediately.Policy: Define and manage system policies.Tuxedo Metrics: Query Oracle Tuxedo monitoring metrics.Tuxedo Application Runtime Metrics: Query Oracle Tuxedo Application Runtime monitoring metrics.Management: Define user management, data management and global parameter settings.Alert: Define and query alerts.Help: On-line help page.On the menu bar, click Policy and select Tuxedo Monitoring Policy from the drop-down menu; the Monitoring Policy List page appears. It displays the existing defined policies and allows you to view, add, edit, or delete policies. This section contains the following topics:Table 1‑8 lists the Monitoring Policy List button bar functions.
Table 1‑1 Monitoring Policy List Button Bar Exports selected policies in an .xml file to a user-specified location. Table 1‑8 describes the Policy List table columns.
• Select: Allows you to select all or individual policies.
• Name: Displays the current policy names.
• Status: Displays the policy status.
• enabled: The corresponding request is sent to Oracle Tuxedo.
• disabled: The corresponding request is not sent to Oracle Tuxedo.
Note:
• Domain ID: Displays the domain identifier attached to the policy as follows: DOMAINID:Master:IPCKEY.
• Tuxedo Components: String that represents policy impact scope of Tuxedo resources in selected domain. It is FML32 boolean expression compliant. For example: (TA_PMID%%'.*BOXBANK*') indicates using an FML32 boolean expression for machine selection.
• Domain: Required.
• Machine: Optional.
• Group: Optional.
• Server: Optional.To use the listed tab options, click the Enable check box. If enable is not selected, all tab options are disabled. One monitoring policy can contain multiple monitoring categories.Table 1‑2 lists the Call Path tab options.
Table 1‑2 Call Path Tab Options
• Ratio: Accepts a value range of 1-65535. It indicates that monitoring starts for a certain number of requests. The default value is “1” (indicating each request is monitored).
• Interval: Accepts a value range of 1-65535. It indicates a period of time (in seconds) that monitoring can be started. It is exclusive of ratio settings. The default value is “1”. The ratio/interval control only applies to the call path initiator. Dynamic filter conditions are independent of each other. If multiple conditions are configured, the evaluation is true for all conditions and the monitoring can be initiated.For single condition items by default, if one of the item evaluations is true, then the condition is true. This applies to other monitoring policy definitions unless there is a special comment. Table 1‑3 lists the Service tab options.
Table 1‑3 Service Tab Options
• Ratio: Accepts a value range of 1-65535. It indicates that monitoring is started among how many requests. The default value is “1” (indicating each request is monitored).
• Interval: Accepts a value range of 1-65535. It indicates a period of time (in seconds) that monitoring can be started and is exclusive of ratio settings. The default value is “1”. Table 1‑4 lists the XA Transaction tab options.
Table 1‑4 XA Transaction Tab Options It accepts a value range of 1-65535. It indicates that monitoring is started among how many requests. The default value is “1” (indicating each request is monitored). Table 1‑5 lists the Domain Gateway tab options.
Table 1‑5 Domain Gateway Tab Options It indicates a period of time (in seconds) that monitoring can be started. It accepts a value range of 1-65535. The default value is 300. Table 1‑6 lists the Bridge tab options.
Table 1‑6 Sub Controls of BRIDGE Panel It indicates a period of time (in seconds) that monitoring can be started. It accepts a value range of 1-65535. The default value is “300”. Table 1‑7 lists the GWWS tab options.
Table 1‑7 GWWS Panel Tab Options It indicates a period of time (in seconds) that monitoring can be started. It accepts a value range of 1-65535. The default value is “300”. It possible for a policy to be to modified simultaneously by multiple users. The final changes may not be seen by other users depending on the console refresh interval.On the menu bar, click Policy and select Tuxedo Application Runtime Monitoring Policy from the drop-down menu.The Monitoring Policy List page appears. It displays existing defined Tuxedo Application Runtime monitoring policies and allows you to view, add, edit, or delete policies.Table 1‑8 list the button bar functions.
Table 1‑8 Button Bar Exports selected policies in an .xml file to a user-specified location.
• Select: Allows you to select all or individual policies.
• Name: Displays the current policy names.
• Status: Displays the policy status.
• enabled: The corresponding request is sent to Oracle Tuxedo.
• disabled: The corresponding request is not sent to Oracle Tuxedo.
Note:
• Region ID: Displays the region identifier (region name) attached to the policy.
• Name: Policy name input text box. Required.
• Region: Selection of region that the current policy attaches to. Required.To use the options listed in each tab, click the Enable check box. If enable is not selected, all options in the tab are disabled.Table 1‑9 lists the CICS Transaction tab options.
Table 1‑9 CICS Transaction Tab Options
• Ratio: Accepts a value range of 1-65535. It indicates that monitoring is started among how many requests. The default value is “1” (indicating each request is monitored).
• Table 1‑4 lists the CICS Terminal tab options.
Table 1‑10 CICS Terminals Tab Options Indicates a period of time (in seconds) that monitoring can be started. It accepts a value range of 1-65535. The default value is 300. It possible for a policy to be modified simultaneously by multiple users. The final changes may not be seen by other users depending on the console refresh interval.Oracle Tuxedo Metrics collection is driven by policy monitoring. Once metrics are collected, you can view them on the related metric pages. Click Tuxedo Metrics on the menu bar; the Tuxedo Metrics page appears. From the drop-down menu you can select the following:
•
•
• Table 1‑11 lists the Call Path Query by Filter panel options. Results are displayed in the Call Path Results List panel.
Table 1‑11 Call Path Query By Filter Options
•
–
•
•
•
Note: "Application Failure" indicates tperrno is TPESVCFAIL. Other errors situations belong to "System Failure"
•
•
•
• A counter in range of 1..99999999 (starting from 1)Table 1‑12 lists the Call Path Results List panel options.
Table 1‑12 Call Path Results List Panel
• Start Time
The time stamp for the start of the call path query in the following format: mmmdd,yyyy,hh:mm:ss:ms GMT
•
•
•
• TPEXXX/tperrno
TPEXXX is the error code string format and tperrno is the corresponding numeric value, for example, TPESVCFAIL/11.
• Table 1‑13 lists the Call Path Details panel options.
Table 1‑13 Call Path Details Panel Options
•
–
Note: If an Oracle Tuxedo server has invoked tpcall/tpacall/tpforward, the content is displayed in parentheses. For example, BROKER (tpcall DEPOSIT).
• Duration: Time span T(n) - T(n-1) (in seconds)
• Call Flag: The tpcall/tpacall call flags.
• The Export to Excel button allows you to place the table contents into an MS Excel compatible file.
Notes: If multiple async calls are made in one process (for example in a service, two tpacalls are made), the order is based on the service invocation sequence for the reply instead of the timestamp. This allows you to easily correlate requests and reply in an "ordered" manner.Table 1‑14 lists the Call Pattern Query by Filter panel options.
Table 1‑14 Call Pattern Filter Panel Table 1‑15 lists the Call Pattern Results List panel options.
Table 1‑15 Call Pattern Results List Panel Options
• Total call pattern in this collection. The Export to Excel button allows you to place the table contents into an MS Excel compatible file.Click any row in the Call Pattern list, the selected Call Pattern details are displayed. Table 1‑16 lists the Call Pattern Details panel options.
Table 1‑16 Call Pattern Details Panel
– The Export to Excel button allows you to place the table contents into an MS Excel compatible file.Service Monitoring allows you to monitor Oracle Tuxedo services. Click Tuxedo Metrics and select Service from the drop-down menu; the Service page appears.The filtering options panel allows you to specify supply information to the services you want monitored. On the left, there are drop-down lists of Domain, Machine, Group and Server. There are two modes for the service selection, select the most active services or particular services on the right. Table 1‑17 lists the Service Selection options.
Table 1‑17 Service Selection Options
• Click Query; the query results are displayed in the Service Monitoring Results panel. Table 1‑18 lists the Service Monitoring Results panel options.
Table 1‑18 Service Monitoring Results Panel Options The Pause/Resume button allows you to stop the data refresh temporarily. The default is Pause (which indicates that a current refresh is in progress). Clicking it will Resume and refresh stops. Clicking it again restores the status. In table view, the Export to Excel button allows you to place the table contents into an MS Excel compatible file.There are two ways to initiate XA Transaction queries: you can specify an XA Transaction identifier, or you can query using filtering parameters. These two ways are exclusive. Table 1‑19 lists the XA Transaction Query by Scope filtering options.
Table 1‑19 “XA Transaction Query by Scope Panel Options
– The default value is "All" and the second monitoring scenario must use the default setting.
•
• Query an XA transaction by using an XA transaction identifier. For example x0 x46524a28 x1. For more information, see How the System Tracks Distributed Transaction Processing in the Oracle Tuxedo User Documentation.The Exact Match checkbox is under the text field. If checked, the whole identifier string must be matched, otherwise all the XA transaction IDs that contain the specified string are listed.Table 1‑20 lists the XA Transaction Results List panel options.
Table 1‑20 XA Transaction Results List Panel Options Table 1‑21 lists the XA Transaction Detail panel options.
Table 1‑21 XA Transaction Detail Panel Options
•
•
•
•
•
• tms_msg_xxx (for GWTDOMAIN XA Transaction activities)
• xa_msg_xxx (for GWTDOMAIN XA Transaction activities) A monitoring project may contain multiple domain gateways; however, one monitoring chart can only monitor one local domain gateway (due to data source consistency). Click Tuxedo Metrics and select Domain Gateway from the drop-down menu; the Domain Gateway Metrics page appears. The Domain Gateway page contains two panels:Table 1‑22 lists the Domain Gateway Selection panel options.
Table 1‑22 Domain Gateway Selection Panel Options
• Table 1‑23 lists the Domain Gateway Monitoring panel options.
Table 1‑23 Domain Gateway Monitoring Panel Options In table view, the Export to Excel button allows you to place the table contents into an MS Excel compatible file.Click Tuxedo Metrics and select GWWS from the drop-down menu; the GWWS Metric page appears. The GWWS Metric page contains two panels:Table 1‑23 lists the GWWS Query by Filter options.
Table 1‑24 GWWS Query by Filter Panel Options
• Table 1‑25 lists the GWWS Live/History Monitoring options:
Table 1‑25 GWWS Live/History Monitoring Panel Options To access the Tuxedo Application Runtime Metrics page, click Tuxedo Application Runtime Metrics on the menu bar. From the drop-down menu you can select the following:Table 1‑26 lists the CICS Transaction Query by Filter options.
Table 1‑26 CICS Transaction Query By Filter Options
• Table 1‑27 lists the CICS Transaction Live/History Monitoring Graph tab metrics.
• In table view, the Export to Excel button allows you to place the table contents into an MS Excel compatible file.Table 1‑28 lists the CICS Terminals Query by Filter options.
Table 1‑28 CICS Terminals Query By Filter Options
• Table 1‑29 lists the CICS Terminals Live/History Monitoring panel options.
In table view, the Export to Excel button allows you to place the table contents into an MS Excel compatible file.Click Management and select the following from the drop-down list:Table 1‑30 lists the User List Menu Bar options.
Table 1‑30 User List Menu Bar The Administrator user can change users passwords from the User Management window. Select the user whose password you want to change and click the Change Password button.Click Change Password to change the password. Click Back to cancel the operation and return to the User Management window.
Note: The Create User button is enabled only when the current login user is TSAM administrator.
•
• The information of all online users is displayed in Online Users window. The available information of users includes Name, IP Address, Login Time and Session ID.
Note: The Purge button is enabled when the login user is an administrator user.
3. Click the Purge button to delete monitoring data from the database.Tuxedo components can be changed to "INValid" status due to management operations at Tuxedo application side. By default, the "INValid" Tuxedo components are not deleted from the database.Customers can purge all "INValid" Tuxedo components in the Data management window.
Note: Currently, only the purging all "INValid" Tuxedo components on the data management page is supported. Invalid components can be purged in the component tree.
• Table 1‑31 lists the Global Parameter properties for each panel.
Table 1‑31 Global Parameter Properties Note: If you check or uncheck Tuxedo Application Runtime Feature Enabled, you must restart the Oracle TSAM application for the change to take effect. Denotes the sleep interval (in milliseconds) in case the MAX_INQUEUE_RUNNER_NUM value is crossed. The default value is 5000. Log level control. The default value is Info. (Trace, Debug, Info, Warn, Error). Click Alert and select one of the following:Click Alert and select Tuxedo Alert Definition from the drop-down list; the Tuxedo Alert Definition List Panel appears. This panel lists available alert definitions and allows you to create, edit, and manage alert definitions.Table 1‑32 and Table 1‑33 list the Tuxedo Alert Definition Menu Bar and Tuxedo Alert Column options respectively.
Table 1‑32 Tuxedo Alert Definition Menu Bar Options
Table 1‑33 Tuxedo Alert Columns
•
•
• Click the Add, Edit or Clone button on the Alert Definition List Menu bar; the Define New Alert page appears. It allows you to define a concrete Oracle Tuxedo alert definition.Table 1‑34 lists the Alert Properties options.
Table 1‑34 Alert Properties Options
•
•
•
•
•
• If this alert evaluation is true, the request message is dropped and the call fails (TPESYSTEM). This only applies to Call Path and Service type alerts.You can also input FML Boolean expressions directly. For more information, see Alert Metrics Tables. For call path alerts, if the elapsed time only is evaluated in the evaluation expression, the alert is triggered once along the entire call path. Other metrics combined with elapse time do not have this effect.Click Alert and select Tuxedo Application Runtime Alert Definition from the drop-down list; the Tuxedo Application Runtime Alert Definition List panel appears. This panel lists available Tuxedo Application Runtime alert definitions and allows you to create, edit, and manage alert definitions.Table 1‑35 and Table 1‑36 list the Tuxedo Application Runtime Alert Definition List menu bar options and columns respectively.
Table 1‑36 Alert Definition List Columns Click Add or Clone on the menu bar; the Define New Alert panel appears. This panel allows you to define concrete Tuxedo Application Runtime alert definitions.Table 1‑37 lists the Alert Properties options.
Table 1‑37 Alert Properties Options
•
•
• You can select the metric, operator and threshold to compose one expression. The logic for the expression can be "and" or "or".You can also input FML Boolean expressions directly. For more information, see Alert Metrics Tables.Click Alerts and select Alert Query from the drop-down menu; the Alert Query page appears.can The Alert Query page contains two tabs:
• Unread Alerts Tab: Displays all unread alerts.
• Historical Alerts Tab Provides historical alert query information.Table 1‑38 lists the Alert Query filtering condition options.
Table 1‑38 Alert Query Filtering Conditions
•
•
•
•
•
•
•
•
• Table 1‑39 lists the Alert Query columns.
Table 1‑39 Alert Query Columns
•
•
•
•
•
•
• "Process [%s:%d] evaluates alert [%s] with true, metrics[key=value,key=value...]"Click Clear to clear all the selected alerts on current page.Click Delete to delete all the selected events on current page.Click Detail, a popup window with the following detailed Alert information appears:Click the Reset button to reset filter conditions and list all "unread" alerts.Table 1‑40 lists the Historical Alert Query Conditions panel options.
Table 1‑40 Historical Alerts Query Conditions Options "Any" and supported severity levels. If Include Lower Level is checked, all alerts at this level or below are queried. The sequence is Fatal, Critical, Warn and Info. The exact time of the previous day to the exact same time of the current day. For example: 7:45 Wednesday-to-7:45 Thursday.Table 1‑41 lists the supported system alerts.
Table 1‑41 System Alerts Supported
Table 1‑42 Call Path Alert Metrics Table >, >= ==, != ==, != >, >=
Table 1‑43 Service Alert Metrics Table >, >= ==, != >, >= >, >= ==, != >, >= >, >=
Table 1‑44 GWTDOMAIN/BRIDGE Alert Metrics Table Lost, Reconnect >, >=
Table 1‑45 GWWS Alert Metrics Table >, >= >, >= >, >= >, >= >, >= >, >=
Table 1‑46 XA Transaction Alert Metrics Table
Table 1‑47 CICS Transaction Alert Metrics Table >, >= >, >=
Table 1‑48 CICS Terminals Alert Metrics Table >, >= >, >=