APPC Unattended Processing (MF User)
Performance Test for Mainframe Servers offers unattended playback for batch testing applications that use APPC. This function requires unattended processing statements and JCL to run the unattended statements. Performance Test for Mainframe Servers also offers a facility that generates these statements and the necessary JCL for you. This section explains how to use Unattended Processing to generate:
- CONTROL statements
- ALLOCATE/ACCEPT statements
- SCRIPT statements
- COMPANY statements
- CACHE INCLUDE and CACHE EXCLUDE statements.
It also explains how to build the JCL necessary for running the unattended processing statements. Unattended-Playback-of-APPC-Scripts-MF-User explains how to run an unattended playback, describes unattended playback statements, and provides JCL examples for common unattended testing functions.
Starting Unattended Processing
Start Unattended Processing by selecting option 2 on the Performance Test Product Menu, and option 4 on the Performance Test for Mainframe Servers Main Menu. The Generate Unattended Statements screen is displayed.
Generate Unattended Statements screen
Command ===>
What to generate:
2 1. Generate Statements for Unattended 3270
2. Generate Statements for Unattended APPC
Enter "/" to select options
Add several script statements
Append new Log to end of an existing Log
(Add control cards generated in this execution to the end
of those created via a previous execution)
Enter END command to return to the Main Menu.
Use this screen to generate unattended processing statements for 3270 or APPC. You can also add script statements to the end of existing unattended playback statements or append unattended playback statements to an existing file by entering a slash (/) in the corresponding field. Use the Append feature to run APPC and 3270 playbacks in the same unattended processing run. For detailed information on generating 3270 statements, see the Performance Test for VTAM User Guide.
Generating APPC unattended processing statements
Select option 2 to access the Generate APPC Unattended Statements screen.
Generate APPC Unattended Statements screen
Command ===>
What to generate:
1. Select the APPC unattended statements you wish to generate
2. Generate APPC unattended statements for each
member in the script dataset
3. Generate APPC unattended statements using a
standard script profile
Enter END command to return to the previous panel
The following options let you access three primary functions from the Generate APPC Unattended Statements screen:
- Option 1 — Use this option to select which statements to generate. You can then navigate various screens and enter information Performance Test for Mainframe Servers uses to generate unattended playback statements. For more information, see Setting Unattended Statement Parameters.
- Option 2 — Use this option to choose a script data set and generate unattended processing statements for all scripts in that data set. Also use this option to do a mass generation. Based on your entries to option 1, Performance Test for Mainframe Servers generates unattended playback statements for all scripts in the data sets you choose. For more information, see Building-Unattended-Statements-and-JCL-VTAM.
- Option 3 — Use this option to restrict the generation of unattended playback statements to a subset of the scripts contained in a data set. Use this option to narrow the generation of statements based on either sender/receiver or script prefix. You can also use this option to include pre and postprocessing scripts, which lets you “sandwich” each of your scripts between two others, such as logon and logoff scripts. For more information, see Restrict Specified Script Datasets.
Setting unattended statement parameters
Select option 1 to display the APPC Statement Generation Parameters screen.
APPC Statement Generation Parameters screen
Command ===>
Select the APPC Statement Type you wish
to include in your unattended job
1. CONTROL Statement parameters
2. ALLOCATE/ACCEPT Statement parameters
3. SCRIPT Statement parameters
4. COMPANY Statement parameter
5. CACHINCL and CACHEXCL Statement parameters
Enter END command to return to previous panel
The APPC Statement Generation Parameters screen allows you to select the type of APPC unattended playback statement to define or modify.
After you select the type of statement you want to build, a screen is displayed where you can provide the necessary information. The information you enter is saved and used when you request generation of control cards and JCL.
You can also modify your unattended processing statements before generating control cards and JCL. For example, you might define CONTROL information first, and then ALLOCATE information or vice versa. The sequence in which the statements are defined has no effect on the generation of the unattended playback statements.
CONTROL Statement Parameters
Select option 1 to display the APPC CONTROL Statement Parameters screen.
APPC CONTROL Statement Parameters screen
Command ===>
Connection Information:
LU62 Prefix. . . .
LU62 Suffix. . . .
LU Alias==>
1. Uservar 2. Generic 3. None
Documentation Generation Options:
Trace. . . . . . .
Use MM/DD/YY?. . . Msgform . . . .
Timing Options:
No Resp Time-Out. Use Start Time.
No FMH5 Time-Out.
Processing Options:
Unit. . . . . . . Caching?. . . .
Volume. . . . . . Using REXX? . .
Enter END command to return to the previous panel
Use this screen to alter the default settings for APPC CONTROL statements. Modify or add a parameter by typing in the appropriate field. Press Enter without entering a command to validate the current entries without leaving this screen.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
ALLOCATE/ACCEPT Statement Parameters
Select option 2 to display the APPC ALLOCATE/ACCEPT Statement Parameters screen.
APPC ALLOCATE/ACCEPT Statement Parameters screen
Command ===>
Choose the ALLOCATE/ACCEPT parameters you wish to include
1. Connection information includes:
Application, Sender and Receiver definitions,
type of protocol, number of conversations,
synchronization level and the number of times
to repeat this request.
2. Documentation Generation includes:
Trace, Summary, VTAM Trace and REXX Log.
3. Timing Options includes:
Logon Delay, Start Delay, Think Time,
Think Time Percent, Synchronize,
All Sync and Time Sync.
4. Security/Unit of Work includes:
Logical Unit of Work Name, Logical Unit of
Work instance, Security Profile, Security Type,
User and Password.
Enter END command to return to the previous panel
Use this screen to access four other screens where you can alter default settings for APPC ALLOCATE/ACCEPT statements. Parameters for the ALLOCATE/ACCEPT statement are divided into four categories:
- Connection
- Documentation
- Timing
- Security and logical unit of work.
Enter the appropriate option for the category of parameters to be defined.
Parameter settings are saved in your profile and retained from session to session.
Connection ALLOCATE/ACCEPT Statement Parameters
Select option 1 on the APPC ALLOCATE/ACCEPT Statement Parameters screen, to alter default settings for APPC ALLOCATE/ACCEPT Connection Parameters.
APPC ALLOCATE/ACCEPT Connection Parameters screen
Command ===>
Request Type==>
1. Allocate 2. Accept
TP Name . Logmode. . . .
Receiver. Receiver Alias
Sender. . Sender Alias .
Repeat. . Count. . . . .
PIP . . .
Protocol Type==>
1. Mapped 2. Basic
3. Full Duplex Mapped 4. Full Duplex Basic
Sync Level==>
1. None 2. Confirm 3. Syncpt
Other ALLOCATE/ACCEPT Statement Parameters==>
1. Connection parameters 2. Documentation parameters
3. Timing parameters 4. Security/Unit of Work parameters
Modify or add a parameter by typing in the appropriate field. Press Enter without entering a command or typing an option in the Other ALLOCATE/ACCEPT Statement Parameters field to validate current entries without leaving this screen.
To transfer directly to one of the other ALLOCATE/ACCEPT parameters screens, type the number of the desired option in the Other ALLOCATE/ACCEPT Statement Parameters field and press Enter. Performance Test for Mainframe Servers validates the current entries and the selected screen is displayed.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
Documentation ALLOCATE/ACCEPT Statement Parameters
Select option 2 on the APPC ALLOCATE/ACCEPT Statement Parameters screen, to alter default settings for APPC ALLOCATE/ACCEPT Documentation Parameters.
APPC ALLOCATE/ACCEPT Documentation Parameters screen
Command ===>
Summary.
REXX Log
Trace. . VTAM?
Other ALLOCATE/ACCEPT Statement Parameters==>
1. Connection parameters
2. Documentation parameters
3. Timing parameters
4. Security/Unit of Work parameters
Enter END command to return to the previous panel
Modify or add a parameter by typing in the appropriate field. Press Enter without entering a command or typing an option in the Other ALLOCATE/ACCEPT Statement Parameters field to validate current entries without leaving this screen.
To transfer directly to one of the other ALLOCATE/ACCEPT parameters screens, type the number of the desired option in the Other ALLOCATE/ACCEPT Statement Parameters field and press Enter. Performance Test for Mainframe Servers validates the current entries and the selected screen is displayed.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
Timing ALLOCATE/ACCEPT Statement Parameters
Select option 3 on the APPC ALLOCATE/ACCEPT Statement Parameters screen, to alter default settings for the following APPC ALLOCATE/ACCEPT statement timing parameters.
APPC ALLOCATE/ACCEPT Timing Parameters screen
Command ===>
Logon Delay. . . . Time Sync. . . . . .
Start Delay. . . . Serialize? . . . . .
Start Time . . . .
Synchronization Options==>
1. None 2. Sync within Group 3. Sync across Groups
Think Time Option==>
1. Play at full speed 2. Think time recorded on script
3. User-specified think time
Think Time(mm,ss) ,
Think Time Percent
Other ALLOCATE/ACCEPT Statement Parameters==>
1. Connection parameters
2. Documentation parameters
3. Timing parameters
4. Security/Unit of Work parameters
Enter END command to return to the previous panel
Modify or add a parameter by typing in the appropriate field. Press Enter without entering a command or typing an option in the Other ALLOCATE/ACCEPT Statement Parameters field to validate current entries without leaving this screen.
To transfer directly to one of the other ALLOCATE/ACCEPT parameters screens, type the number of the desired option in the Other ALLOCATE/ACCEPT Statement Parameters field and press Enter. Performance Test for Mainframe Servers validates the current entries, and the selected screen is displayed.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
Security and LUW ALLOCATE/ACCEPT Statement Parameters
Select option 4 on the APPC ALLOCATE/ACCEPT Statement Parameters screen, to alter default settings for APPC ALLOCATE/ACCEPT statement security and logical unit of work (LUW) parameters.
APPC ALLOCATE/ACCEPT Security-LUW Parameters screen
Command ===>
Logical Unit of Work:
LUW Name . . . . . .
LUW Instance Number.
Security==>
1. None 2. Same 3. Pgm 4. Prst 5.Sameprst
Security Options:
Security Profile . .
User . . . . . . . .
Password . . . . . .
Other ALLOCATE/ACCEPT Statement Parameters==>
1. Connection parameters
2. Documentation parameters
3. Timing parameters
4. Security/Logical Unit of Work parameters
Enter END command to return to the previous panel
Also use this screen to alter LUW parameters. Modify or add a parameter by typing in the appropriate field. Press Enter without entering a command or typing an option in the Other ALLOCATE/ACCEPT Statement Parameters field to validate current entries without leaving this screen.
To transfer directly to one of the other ALLOCATE/ACCEPT parameters screens, type the number of the desired option in the Other ALLOCATE/ACCEPT Statement Parameters field and press Enter. Performance Test for Mainframe Servers validates the current entries and the selected screen is displayed.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
Performance Test for Mainframe Servers does not retain dubbing information from session to session.
SCRIPT Statement Parameters
Select option 3 on the APPC Statement Generation Parameters screen to display the SCRIPT Statement Parameters for APPC screen.
SCRIPT Statement Parameters for APPC screen
Command ===>
Repeat . . . . .
Stop On. . . . .
Enter END command to return to the previous panel
Use this screen to alter default settings for APPC SCRIPT statements. Modify or add a parameter by typing in the appropriate field. Press Enter without entering a command to validate current entries without leaving this screen.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
COMPANY Statement Parameters
Select option 4 on the APPC Statement Generation Parameters screen to display the Company Statement Parameters screen.
Company Statement Parameters screen
Command ===>
Company . .
Enter END command to return to previous panel
Enter your company’s name in the Company field. Enclose it in single quotes if it includes dashes or blanks. The name you define will print on your batch reports. If you do not specify a name, Performance Test for Mainframe Servers uses Compuware Corporation as the default.
Leave the Dub Title field blank as it does not apply to APPC statements.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
CACHE INCLUDE and EXCLUDE Statement parameters
Select option 5 on the APPC Statement Generation Parameters screen to display the following CACHE INCLUDE and EXCLUDE Statement Parameters screen.
CACHE INCLUDE and EXCLUDE Statement Parameters screen
Command ===>
CACHINCL Statement:
CACHEXCL Statement:
Enter END command to return to the previous panel
Use this screen to alter default settings for APPC CACHINCL and CACHEXCL statements. Modify or add a parameter by typing in the appropriate field. Press Enter without entering a command to validate current entries without leaving this screen.
For descriptions of the parameters and the commands you can use on this screen, see the online help.
Building Unattended Statements and JCL
Select option 2 on the Generate APPC Unattended Statements screen to display the Unattended Statement Build screen.
Unattended Statement Build screen
Command ===>
Please supply the name of the dataset containing the scripts, and the name of
the dataset and the member which will contain the generated statements.
Script Dataset:
Project . . .
Group . . . .
Type . . . .
Other Partitioned Dataset:
Dataset Name. . . . JAKEJAKE.TESTSCR
Enter a "/" above to define more than one Script Dataset
Unattended Statement Dataset Name:
Project . . .
Group . . . .
Type . . . .
Member. . . .
Other Partitioned Dataset:
Dataset Name. . . . JAKEJAKE.JCL(TEST)
Press ENTER to generate Unattended Playback statements END to exit.
Use the Unattended Statement Build screen to enter the name of the data set containing the scripts you want to generate unattended statements for.
Type the data set information in the Script Dataset fields or the Other Partitioned Dataset field.
You can define more than one data set (up to seven) by typing a / in the Dataset Name field. Performance Test processes any additional data sets after the data set defined on this screen. Specify at least one data set on this screen.
Performance Test examines each of the members in the selected data set and determines their domain destination or sender/receiver. Performance Test flags as 3270 those script members that Performance Test can identify a domain destination for. Performance Test excludes these members from APPC-type requests.
Use the Batch Statement Dataset Name fields to enter the name of the data set and member to store generated statements in. If the member exists, Performance Test for Mainframe Servers overwrites it unless you selected the Append option on the initial Generate Unattended Statements screen.
For descriptions of the commands you can use on this screen, see the online help.
When you press Enter without entering a command, Performance Test for Mainframe Servers validates the screen entries, generates unattended statements in the chosen data set member, and then displays that member on the following ISPF EDIT screen.
ISPF EDIT screen showing Generated Statements
-------------------------------------------------------------------------------
EDIT USER2312.UNATTND.CONTROL(APPCTEST) - 01.00 Columns 00001 00072
Command ===> Scroll ===> PAGE
****** ***************************** Top of Data ******************************
000001 CACHINCL -
000002 APPCINCL
000003 CONTROL -
000004 LU62PFX(HS62) -
000005 LU62SFX(4) -
000006 LUALIAS(NONE) -
000007 NORESPTO(45) -
000008 NOFMH5TO(300) -
000009 USDATE(YES)
000010 ALLOCATE -
000011 RECEIVER(A) -
000012 REPEAT(1) -
000013 COUNT(1) -
000014 THOPT(1)
000015 SCRIPT(RT000003) -
000016 REPEAT(1)
000017 SCRIPT(RT000002) -
000016 REPEAT(1)
000017 SCRIPT(RT000001)
After you make any changes, enter the END command to access Performance Test for Mainframe Servers Unattended JCL Build screen.
Building JCL
Use the Unattended JCL Build screen to create JCL for running the unattended statements just generated.
Use either the JCL Dataset Name fields or the Other Partitioned Dataset field to choose the data set and member where Performance Test for Mainframe Servers writes the generated JCL.
Enter your standard job statements in the Job Statement Information area.
When you press Enter, Performance Test for Mainframe Servers:
- Validates screen entries
- Generates JCL in the chosen data set member
- Displays the generated JCL on the following ISPF EDIT screen.
ISPF EDIT Screen Showing Generated JCL
-------------------------------------------------------------------------------
EDIT ACMJET0.TSO.JCL(APPCPB) - 01.00 Columns 00001 00072
Command ===> Scroll ===> PAGE
****** ***************************** Top of Data ******************************
000001 //ACMJET0G JOB (’OHPBAS5.2DSP’,84),’J.TESTER’,MSGCLASS=R,
000002 // REGION=2048K,CLASS=P,NOTIFY=ACMJET0
000003 //*
000004 //*
000005 //*
000006 //STEP1 EXEC PGM=EHSBATCH
000007 //SYSPRINT DD SYSOUT=*
000008 //STEPLIB DD DISP=SHR,DSN=ACMJET0.VP.R600.LOADLIB
000009 //SYSLIB DD DISP=SHR,DSN=ACMJET0.TEST.SCRIPTS
000010 //SYSIN DD DISP=SHR,DSN=ACMJET0.UNATTND.CONTROL(APPCTEST)
****** **************************** Bottom of Data ****************************
After you make any changes, either save the JCL for later use or enter the SUBMIT command to run the unattended playback job immediately.
Restrict specified script data sets
Select option 3 on the Generate APPC Unattended Statements screen to display the Unattended Statement Build screen.
Use this screen as described in Building-Unattended-Statements-and-JCL-VTAM. The only difference is that when you press Enter without entering a command, Performance Test for Mainframe Servers validates the screen entries, generates unattended statements in the chosen data set member, and then displays the following Generation Restrictions screen.
Generation Restrictions screen
Command ===>
Pre-process scripts - run these scripts prior to each of
the scripts selected below.
Restrict the generation of unattended statements to
script names beginning with the prefix, and/or scripts
for a particular application.
Script selection options:
Generate statements for scripts prefixed by . . . .
Generate statements for scripts for application . .
Post-process scripts - run these script after each of the
scripts selected above.
Press the ENTER key to continue, the END key to terminate
Use the Generation Restriction screen to narrow down the number of scripts to generate unattended statements for. If you enter a prefix, Performance Test for Mainframe Servers only includes script member names beginning with those characters. If you enter an application, Performance Test for Mainframe Servers only includes script members with that sender/receiver in unattended statement generation.
You can also choose scripts, such as logon and logoff scripts, to run before and/or after the generated statements.
For descriptions of the commands you can use on this screen, see the online help.
When you press Enter without entering a command, Performance Test for Mainframe Servers validates the screen entries, generates unattended statements in the dataset member entered on the Unattended Statement Build screen, and then displays that member on the following ISPF EDIT screen.
ISPF EDIT Screen Showing Restricted Generated Statements
-------------------------------------------------------------------------------
EDIT ACMJET0.UNATTND.CONTROL(APPCTEST) - 01.00 Columns 00001 00072
Command ===> Scroll ===> PAGE
****** ***************************** Top of Data ******************************
000001 CACHINCL -
000002 APPCINCL
000003 CONTROL -
000004 LU62PFX(HS62) -
000005 LU62SFX(4) -
000006 LUALIAS(NONE) -
000007 NORESPTO(45) -
000008 NOFMH5TO(300) -
000009 USDATE(YES)
000010 ALLOCATE -
000011 RECEIVER(A) -
000012 REPEAT(1) -
000013 COUNT(1) -
000014 THOPT(1)
000015 SCRIPT(APPCSTRT)
000016 SCRIPT(RT000002) -
000017 REPEAT(1)
After you make any changes, enter the END command to access Performance Test for Mainframe Servers’ Unattended JCL Build screen. Refer to Building JCL for information on using this screen to create JCL for running your generated unattended statements.