APPC Reporting (MF User)


Performance Test for Mainframe Servers offers the following reports:

  • APPC Summary Report provides performance statistics and comparison results.
  • REXX Log reports the text from the REXX SAY statements.

Performance Test for Mainframe Servers generates requested reports during playback if your playback job ALLOCATE/ACCEPT statement includes the appropriate keywords.

This section explains how to generate each report and describes the fields on the reports.

Summary report

Include the SUMMARY keyword on your ALLOCATE/ACCEPT statement to produce a summary report (refer to the syntax diagram in the ALLOCATE and ACCEPT Statements discussion). The APPC summary report details performance and comparison check information from the execution of scripts using unattended playback.

SUMMARY(class|dsn)

Tells Performance Test for Mainframe Servers to generate a summary report for the group. If the value is a single character, Performance Test for Mainframe Servers allocates the summary report to SYSOUT in the class set by that single character. If the value is more than one character, Performance Test for Mainframe Servers allocates the summary report to a permanent file. By default, no summary report is produced.

The data set value can be either a data set name by itself or a data set name with a member name:

SUMMARY(dataset)
SUMMARY(dataset(member))
To allocate a PDSE at the same time, use the format:

SUMMARY(dataset*(member*))The data set must be either a sequential file or a PDSE. You cannot use a PDS as a summary report file because playback can write multiple members at the same time, a function not supported by PDSs.

The data set or member or both can contain wildcard characters (* or ?).

If a data set name is supplied with no wildcards, no suffix is added to the data set name.

APPC Summary Report example

HIPERSTATION-
SUMMARY REPORT   TERMINAL ID: ** NA ** TPF NAME: H01APPCI  TIME: 15:35:37  DATE: 06/06/27  PAGE: 000  

              -------------OUTBOUND----------------     ---------------- INBOUND ---------------
SCRIPT   PORT  NUMBER  MINIMUM    AVERAGE   MAXIMUM     NUMBER  MINIMUM     AVERAGE     MAXIMUM           ELAPS
ED
---------------------------------------------------------------------------------------------------------------
---
SCR1003    3     1    00:00.298  00:00.298  00:00.298        1   00:00.095   00:00.095   00:00.095    00:00:06.
007
SCR1003    3     1    00:00.007  00:00.007  00:00.007        1   00:00.017   00:00.017   00:00.017    00:00:06.
692

General information

Script

The script being run. Two special script names, *SCR-TOT and *GRP-TOT, denote script and group totals, respectively.

Port

Each terminal is assigned a port ID that is associated with the script.

Outbound performance information

Number

Number of SENDs or ALLOCATEs processed by the terminal for the script.

Minimum

Minimum response time for the SENDs or ALLOCATEs processed by the terminal for the script.

Average

Outbound average is calculated from the sum of all response times for the port, divided by the number of outbound transactions for that port.

Maximum

Maximum response time for the SENDs and ALLOCATEs processed by the terminal for the script.

Inbound performance information

Number

Number of RECEIVEs or ACCEPTs processed by the terminal for the script.

Minimum

Minimum response time for the Receives or ACCEPTs processed by the terminal for the script.

Average

Inbound average is calculated from the sum of all think times for the port, divided by the number of inbound transactions for that port.

Maximum

Maximum response time for the RECEIVEs and ACCEPTs processed by the terminal for that script.

Elapsed time

Elapsed

Elapsed time is calculated based on the total amount of time it took the port and the application to process the total number of transactions. For *SCR-TOT, this is the maximum elapsed time of the individual scripts. For *GRP-TOT, this is the sum of the *SCR-TOT elapsed times.

REXX log

Include the RLOG keyword on your ALLOCATE/ACCEPT statements to produce a REXX Log (refer to the syntax diagram in the ALLOCATE and ACCEPT Statements). The REXX log reports the text of REXX SAY statements, which are most often used to track the progress of a script.

RLOG(class|dsn)

Indicates that Performance Test for Mainframe Servers allocates a REXX log for each APPC conversation in the group. If the value is a single character, Performance Test for Mainframe Servers allocates the REXX log to SYSOUT in the class set by that single character. If the value is more than one character, Performance Test for Mainframe Servers allocates the REXX log to a permanent file. By default, the REXX output is directed to the SYSPRINT data set.

The data set value can be either a data set name by itself or a data set name with a member name:

RLOG(dataset)
RLOG(dataset(member))
The data set or member or both can contain wildcard characters (* or ?).

If a data set name is supplied with no member and no wildcards, a data set is created with the name dsn.Pnnnn, where nnnn is the port number assigned to the conversation.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*