Collector for qRFC Queue Details

The technical name of the Collector for qRFC Queue Details is /DVD/MON_CL_COL_QRFC.This collector collects statistical KPIs and details about qRFC queues. It is intended to identify erroneous queues and capture the initial statuses of the specific queues.

NOTE In the case of any issue in the queue, the initial status is mainly an error.

The collector also has qRFC parameter extraction support for SCM systems. For more information, see the chapter SCM System qRFC Queue Details.

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	Total number of entries for inbound qRFC queues	Number	Yes
QRFC_OUT	Total number of 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

The collector uses the input table /DVD/MON_QRFC, where you can specify what details will be extracted into the detail table /DVD/MON_S_QUEUE_DETAIL. All rows in the input table will also be 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 want to monitor: O: Outbound I: Inbound B: Both
QNAME	Queue Name	Name of the RFC queue
DEST	Destination	Destination of the RFC queue

Technical name

Column name

Description

QDIR

qRFC Direction

Direction of the queue you want to monitor:

O: Outbound
I: Inbound
B: Both

QNAME

Queue Name

Name of the RFC queue

DEST

Destination

Destination of the RFC queue

NOTE You can also define input values with the wildcard *. Wildcards are only supported for the fields Queue Name and Destination.

If you define a record with a wildcard, this record will be only processed in the detail table /DVD/MON_S_QUEUE_DETAIL, not in the detail table /DVD/MON_S_QUEUE_ERROR. If you want to successfully extract parameters that will be added to the detail table /DVD/MON_S_QUEUE_ERROR, you must specify the exact queue details.

Parameters

The following parameters are used for this collector:

Parameter name	Description
TOP_N_QIN_ERROR_QUEUES	Defines how many inbound qRFC queues in an erroneous state are reported into the detail table Erroneous queues details. By default, the top 25 inbound queues are reported. The list is sorted from the oldest to the newest record.
TOP_N_QOUT_ERROR_QUEUES	Defines how many outbound qRFC queues in an erroneous state are reported into the detail table Erroneous queues details. By default, the 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 and has the technical name /DVD/MON_S_QUEUE_DETAIL. It collects details about the oldest record (initial status) for each queue based on the criteria defined in the above-described input table /DVD/MON_QRFC.

The detail table Queue specific statistics contains the following fields:

Technical name	Description
TIMESTAMP	Timestamp
SID	System ID
CLIENT_CODE	Client ID
USER_EXPERIENCE	This field checks if any error occurred in this queue. Possible values: NORMAL = no error occurred; ERROR = error occurred
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 transaction ID
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 and has the technical name /DVD/MON_S_QUEUE_ERROR. By default, it extracts the parameters from the queues that have failed (in the state SYSFAIL). In addition, 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

SCM System qRFC Queue Details

The technical name of the collector SCM System qRFC Queue Details is /DVD/MON_CL_COL_QRFC. It has integrated monitoring for /SAPAPO/ function modules for SCM systems. Because these function modules have a large number of parameters, a separate input table is needed.

NOTE This part of the collector and its input table are only for SAP SCM systems.

Input Table

The input table for SCM System qRFC Queue Details, /DVD/MON_APO_CF, is slightly different from the input table for standard qRFC queue monitoring, /DVD/MON_QRFC. It contains the following fields:

Queue name	Description
Destination	Destination of the RFC queue. If you leave this field empty, it will be considered as an inbound queue.
Parameter Path	Path to a parameter whose value you want to monitor. There are three types of parameters: Single parameter: Extracting the single value of the parameter – defined as IV_PARAMETER. Struct parameter: Extracting a field value from a structure – defined as IS_STRUCT-FIELD. Table parameter: Extracting a field value from a table – defined as IT_TABLE-FIELD. You can use the F4 help to display SCM function modules and their parameters to choose from.
Custom Field	Defines where the parameter value will be stored in the already existing CrystalBridge® Monitoring detail table /DVD/MON_S_QUEUE_ERROR. CUSVAL1-CUSVAL6: Suitable for single parameter or struct parameter values CUSLVAL1-CUSLVAL2: Long values. These values are good for storing table field parameters that are represented in a single field, for example VALUE1;VALUE2;VALUE3;VALUE4. Note that when a table has multiple rows, the values are separated by semicolons in one field.

NOTE You can also define input values with the wildcard * for the fields Queue Name and Destination. Other field values must be fully specified.

Detail Table

The output of the SCM extraction will be appended to the existing detail table /DVD/MON_S_QUEUE_ERROR under the user-defined CUSVAL fields in the input table.