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