(DI-2311) Collector for qRFC Queue Details
- SNP
- Tomas Hnojcik
The technical name of the Collector for qRFC queue statistics is /DVD/MON_CL_COL_QRFC.
This collector collects statistical KPIs and details about qRFC queues. It is intended to identify the erroneous queues and also to capture the initial statuses of the specific queues (in the case of any issue in the queue, the initial status is mainly an error).
Collector has also qRFC parameters extraction support for SCM Systems. More information can be found in the chapter SCM system qRFC queue details.
In this section:
Default KPIs delivered with this collector
The following default KPIs are delivered with this collector:
KPI name | Description | Unit | Detail table |
|---|---|---|---|
QRFC_ERR_IN | Number of erroneous inbound qRFC queues | Number | Yes |
QRFC_ERR_OUT | Number of erroneous outbound qRFC queues | Number | Yes |
QRFC_IN | Number of all entries for inbound qRFC queues | Number | Yes |
QRFC_OUT | Number of all entries for outbound qRFC queues | Number | Yes |
QRFC_QIN_COUNT | Number of Inbound qRFC queues | Number | No |
QRFC_QOUT_COUNT | Number of Outbound qRFC queues | Number | No |
Input Table
Collector uses input table /DVD/MON_QRFC where the user can specify what details will be extracted into detail table /DVD/MON_S_QUEUE_DETAIL. All rows in the input table will be also applied for extracting parameters into the detail table /DVD/MON_S_QUEUE_ERROR.
Technical name | Column name | Description |
|---|---|---|
QDIR | qRFC Direction | Direction of the queue you wish to monitor. I: Inbound B: Both |
QNAME | Queue Name | Name of RFC queue. |
DEST | Destination | Destination of RFC queue. |
You might also define input values with wildcard *. Wildcards are only supported for fields Queue Name and Destination.
If you define a record with wildcard, this record will be only processed into detail table /DVD/MON_S_QUEUE_DETAIL, not into detail table /DVD/MON_S_QUEUE_ERROR. If you wish to successfully extract parameters that will be added to the detail table /DVD/MON_S_QUEUE_ERROR you have to specify the exact queue details.
Parameters
The following parameters are used for this collector:
Parameter name | Description |
|---|---|
TOP_N_QIN_ERROR_QUEUES | Parameter defines how many inbound qRFC queues in error state are reported into detail table Erroneous queues details. By default, top 25 inbound queues are reported. The list is sorted from the oldest to the newest record. |
TOP_N_QOUT_ERROR_QUEUES | Parameter defines how many outbound qRFC queues in error state are reported into detail table Erroneous queues details. By default, top 25 outbound queues are reported. The list is sorted from the oldest to the newest record. |
Detail Tables
The collector provides two detail tables that contain useful information about qRFC queues.
The first detail table is Queue specific statistics with its technical name /DVD/MON_S_QUEUE_DETAIL. It collects the details about the oldest record (initial status) for each queue based on the criteria defined in the above described input table with name /DVD/MON_QRFC.
Detail table Queue specific statistics provides the following fields:
Technical name | Description |
|---|---|
TIMESTAMP | Timestamp |
SID | System ID |
CLIENT_CODE | Client ID |
USER_EXPERIENCE | User experience |
QDIR | Queue direction |
QNAME | Queue name |
DEST | Queue destination |
QSTATE | Queue status |
QRFCUSER | Username |
QRFCFNAM | Function module name |
QRFCDATUM | Queue date |
QRFCUZEIT | Queue time |
ORGTID | Original TID |
RETRYNR | Number of attempts |
ERRMESS | Error message text |
QLENGHT | Queue length |
CUSVAL1-CUSVAL6 | Custom values |
CUSLVAL1, CUSLVAL2 | Custom values (Long) |
CUSNUM1, CUSNUM2 | Custom numbers |
The second detail table is Erroneous queues details with its technical name /DVD/MON_S_QUEUE_ERROR. By default, it extracts the parameters from the queues that have failed (are in the SYSFAIL state). Additionally, it can also extract the parameters from the queues that are defined in the input table.
Technical name | Description |
|---|---|
TIMESTAMP | Timestamp |
SID | System ID |
MANDT | Client ID |
USER_EXPERIENCE | User experience |
QDIR | Queue direction |
QNAME | Queue name |
DEST | Queue destination |
QSTATE | Queue status |
QRFCUSER | Username |
QRFCFNAM | Function module name |
QRFCDATUM | Queue date |
QRFCUZEIT | Queue time |
ORGTID | Original TID |
RETRYNR | Number of attempts |
ERRMESS | Error message text |
QLENGHT | Queue length |
CUSVAL1-CUSVAL6 | Custom values |
CUSLVAL1, CUSLVAL2 | Custom values (Long) |
CUSNUM1, CUSNUM2 | Custom numbers |