(DI-2302) Collector for qRFC Queue Details

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

KPI name

Description

Unit

Detail table

QRFC_ERR_IN

Number of erroneous inbound qRFC queues

Count

Yes

QRFC_ERR_OUT

Number of erroneous outbound qRFC queues

Count

Yes

QRFC_IN

Number of all entries for inbound qRFC queues

Count

Yes

QRFC_OUT

Number of all entries for outbound qRFC queues

Count

Yes

QRFC_QIN_COUNT

Number of Inbound qRFC queues

Count

No

QRFC_QOUT_COUNT

Number of Outbound qRFC queues

Count

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

Technical name

Column name 

Description

QDIR

qRFC Direction

Direction of the queue you wish to monitor.
O: Outbound

I: Inbound

B: Both

QNAME

Queue Name

Name of RFC queue.

DEST

Destination

Destination of RFC queue.

QSTATE

Status

Fill out only if you wish to monitor parameters of the queue function that is in a specific state. If left empty, only SYSFAIL queues will be processed.

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

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 all details based on the records defined in the above-described input table /DVD/MON_QRFC. Detail table Queue-specific statistics provides the following fields:

Technical name

Description

Technical name

Description

TIMESTAMP

Timestamp

SYSID

System ID

MANDT

Client ID

QNAME

Queue Name

DEST

Queue Destination

QDIR

Queue Direction

QSTATE

Queue Status

QRFCUSER

User Name

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

Technical name

Description

TIMESTAMP

Timestamp

SYSID

System ID

MANDT

Client ID

QNAME

Queue Name

DEST

Queue Destination

QDIR

Queue Direction

QSTATE

Queue Status

QRFCUSER

User Name

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