TCP/IP Interactive Playback (MF User)


Introducing TCP/IP interactive playback

Use interactive playback to:

  • Play back scripts — execute the commands found in the script.
  • Analyze scripts — process the script without executing the commands to report information on the script’s contents.

In order to play back a Performance Test for Mainframe Servers script, you must have created a script using the Create Scripts panels, (See TCP/IP Scripts and Subset Repositories for information on how to create a script.) The concept behind playback is to recreate the traffic you captured to your script using the Global Record tool. Entering information on these playback screens will generate batch JCL that can either be saved or submitted for execution.

  1. On the Performance Test for Mainframe Servers Main Menu, select option 8 Playback TCP/IP Scripts. The TCP/IP Playback - Selection screen is displayed.
    TCP/IP Playback - Selection screen

       ------------------------ TCP/IP Playback - Selection  -------- Row 1 to 1 of 1
      Command ===>

       Primary commands:  C)reate Playback, G)enerate Playback from Script Log
       Playback DSN    :  'PMIJSS0.TCPPLAY'
       Line commands...:  S)elect, P)lay or D)elete

       S  Name     Playback Description                                   Date
       -  -------- ------------------------------------------------------ ----------
          TEST303   TESTING TCP PLAYBACK FOR CWE-125303                    04/05/18
       ******************************* Bottom of data ********************************


  2. Select what you want to do:
Warning

When you perform a Global Recording capture of Db2 Connect and make a script, you must use the same version of Db2 Connect when you play back the script. If you use different versions of Db2 Connect for capture and playback, an error will occur.

Creating a new interactive playback

  1. On the TCP/IP Playback - Selection screen, type C (create) on the command line and press Enter. The TCP/IP Playback - Datasets screen is displayed.
    TCP/IP Playback - Datasets screen

    ------------------------- TCP/IP Playback - Datasets  ------------------------
    Command ===> __________________________________________________________________

     Script Dataset:
        Project . . .  USER2312
        Group . . . .  TCPIP
        Type  . . . .  SCRIPT
     Other Partitioned Dataset:
        Dataset Name. . . .  _______________________________________________________
        Define more than one Script Dataset(/)

      Specify locations of playback outputs

      Reporting Database(optional)      Generate Reporting Job ==>
        Dataset Name. . . . ________________________________________________________

      Playback Error Log(if not SYSOUT=*):
        Dataset Name. . . . ________________________________________________________

                      Press ENTER to continue,  END to cancel setup.
  2. Enter the Script Dataset name of the script you want to play back. If your data set name does not conform to ISPF naming standards, enter the data set name, in single quotes, in the Other Partitioned Dataset field. Either Script Dataset or Other Partitioned Dataset is required.
    1. To play back multiple script data sets, type a slash in the Define More than one Script Dataset field and press Enter. The TCP/IP Script Dataset List screen will be displayed.TCP/IP Script Dataset List screen

      -------------------------- TCP/IP Script Dataset List -------------------------
       Command ===>

         Please supply the dataset(s) containing the scripts
         to be used in this playback.

       Additional Script Dataset Names:
       __________________________________________________________
       __________________________________________________________
       __________________________________________________________
       __________________________________________________________
       __________________________________________________________
       __________________________________________________________

       Enter End to return to the previous menu.

      You can enter up to six script data set names. If the first character is a single quote (‘), a fully qualified data set name is expected. If the first character is not a single quote, then the user ID is attached as a prefix or high-level qualifier. After you enter all of the desired data set names, press Enter to return to the TCP/IP Playback - Datasets screen. Continue with Step 3.

    2. If you will be playing back a single script, continue with Step 3.
  3. To report on the playback, enter a name for the Reporting Database. Data from the playback will be collected to this database and used in a future reporting job. This field is required only if you selected the Generate Reporting Job field. Selecting Generate Reporting Job provides reporting panels after the playback panels are completed.
  4. The playback error log is a report that describes any errors that occurred during playback. If you leave this field blank, the report will go to SYSOUT=*. You can enter a data set name or an hfs path to specify an alternate location.
  5. Press Enter to continue. The TCP/IP Playback - Script Member List screen will be displayed.
    TCP/IP Playback - Script Member List screen

    MEMBER LIST -- USER2312.TCPIP.SCRIPT ---------------------- ROW 00001 OF 00002
     COMMAND ===>                                                  SCROLL ===> PAGE

        END     End and process selection
        CANcel  End without processing

        Line Cmds:  S Select member    B Browse member

        Name     Prompt          Size    Created           Changed            ID
       LOG00000                    23   2007/07/27   2007/07/27 16:10:00    USER2312
       SCR00000                  1508   2007/07/27   2007/07/27 16:10:00    USER2312
       **End**
  6. Select a member from the list and use END to process your selection. The TCP/IP Playback - Setup screen is displayed.
    TCP/IP Playback - Setup screen

    ------------------- TCP/IP Playback - Setup  ---------------- Row 1 to 1 of 1
     Command ===>                                                  Scroll ===> PAGE

     Enter script, and modify desired options using /.
     Type OK and press ENTER when ready.

     Note: Use multiple Sockets to test parallel connections to your application.
           Scripts under each Socket will run sequentially.

        Environment Options(apply to all Sockets except when overridden)

     Socket and script line commands are: (D)elete,(R)epeat,(A)dd,(/)Options

     S  Socket       S  Script
     ** *******      ** ********
          1             SCR00000
  7. The name of the member you selected on the previous screen is prefilled in the Script field. To add another script to play back, use the Add line command, and select another member from the list. All scripts for this playback must be contained within the data set that you named on the TCP/IP Playback - Datasets screen.
  8. If you do not need to change any options, type OK on the Command line. The TCP/IP Playback - Submit screen is displayed. See Submitting Your Playback for Execution to submit your playback for processing.

If you need to change Environment, Socket, and/or Script options, see Changing Playback Options for complete information. Then continue with Submitting Your Playback for Execution to submit your playback for processing.

Important

To explain the relationship between Sockets and Scripts, a Socket represents a single connection to your application. When there are multiple sockets in a playback, they run in parallel to each other, unless the socket start time is modified in the environment options. Within a socket, there are one or more scripts that run sequentially in the order they appear.

Lines commands can be applied to either the Socket or the Script. The Add, Repeat, and Delete line commands will add, repeat, or delete a socket. When applied to a script, they will add, repeat, or delete a script from that socket. When deleting, keep in mind that at least one script and socket are required for a playback.

Generating a playback from a script log

The Generate command allows you to create a playback from a log data set that was created in a script create job. The script data set and names will be extracted from the log allowing a playback to be instantly created for a particular log.

  1. On the TCP/IP Playback - Selection screen, type G (generate) on the command line and press Enter. The TCP/IP Playback - Log File screen is displayed.TCP/IP Playback - Log File screen

    ---------------------Generate TCP/IP Playback - Log File ---------------------
    Command ===>

       Enter log file member to generate playback:

        Log Dataset:
            Project . . . ________
            Group . . . . ________
            Type  . . . . ________
            Member  . . . ________    (Blank or pattern for member selection list)
        Other Partitioned Dataset:
            Dataset Name. . . . ____________________________________________________

                      Press ENTER to continue,  END to cancel setup.
  2. Specify the log file you wish to use for playback. If you did not enter a member name when you specified the log data set, a list of members will be displayed allowing you to select the desired member.
  3. Type S next to the desired member and press Enter. The TCP/IP Playback - Datasets screen is displayed. If your data set name does not conform to ISPF naming standards, the name including the member name must be entered in the Other Partitioned Dataset Name field.

The remainder of the steps are the same as those you performed in Creating a New Interactive Playback. Continue with 2.

Changing playback options

Environment options

Environment options are applied to the entire playback with the exception of certain parameters that can be overridden on the SOCKET or SCRIPT level. The current settings for the options are displayed next to each option category.

  1. You can access the Environment Options screen, by typing a slash next to the Environment Options field on the TCP/IP Playback - Setup screen.
    Environment Options screen

    ----------------------------- Environment Options -----------------------------
     Command ===>

       Select the type of options to view/modify using  / .


     _  Processing Options:      Rexx Disabled, No live transactions executed
                                 Internal Hiperstation REXX variables OFF

     _  Timing Options:          Play at Full Speed,Groups start simultaneously,
                                 Wait 15 seconds for I/O to complete

     _  Connection Options:      Use Protocol From Script
                                 Use Server Port From Script
                                 Use Server Address From Script

     _  Data Replacement Options:   Use Userid From Script


          Enter END command to return to the previous panel

    This screen allows you to view or modify processing, timing, connection, and data replacement options.

  2. Type a slash (/) next to the Processing Options field and press Enter. The Environment - Processing Options screen is displayed.
    Environment - Processing Options screen

    ----------------------- Environment - Processing Options ----------------------
     Command ===>

      Review current option settings and modify if required:

      Enable REXX to be used in TCP scripts?  ==>  _

      Use internal Rexx Stream Variables?     ==>  _

      Rexx Log Dataset name

      TCP Playback play as:           Client  ==>  /   Server  ==>  _

      Do live I/O during playback?            ==>  _

      Error Handling:
      Suppress Error Messages?                ==>  _
      When error occurs:    Continue playback ==>  _
                            Stop connection   ==>  _
                            Stop script       ==>  _
                            Stop socket       ==>  _
                            Stop playback     ==>  _

           Press ENTER  to continue, END to exit

    The options on this panel correspond to keywords that are placed in control cards for the playback JCL.

    • Enable REXX to be used in TCP scripts? enables REXX to be used in scripts. The keyword is REXXON.
    • Use Internal REXX stream variables? enables the use of the Enterprise Servers’ predefined REXX variables during playback. The variables return information about the playback and incorporate them into REXX logic that you add to your scripts to control the way the scripts play back. The keyword is SET REXX STREAM VARIABLES.
    • Rexx Log Dataset name specifies the data set name to be used for your log file.
    • TCP Playback play as Client or Server tells the playback program to function as a client or server. The default is to function as a client, testing the server application.
    • Do Live I/O during playback? permits Performance Test to play back scripts without performing any I/O allowing you to generate reports for analyzing script content. The keyword is OFFLINE.
    • Suppress Error Messages? suppresses warning and socket I/O error messages.
    • When error occurs stops the playback at the level specified when an error occurs. The default is Continue playback. Choices include:
      • Continue playback
      • Stop connection
      • Stop script
      • Stop Socket
      • Stop playback.After making your changes, enter END to return to the previous screen.
  3. Type a slash (/) next to the Timing Options field and press Enter. The Environment - Timing Options screen is displayed.
    Environment - Timing Options screen

    ------------------------- Environment - Timing Options ------------------------
     Command ===>

      Review current option settings and modify if required:

      Use start times to control dispatching of each Socket?          ==>  _

      Number of seconds to wait for I/O to complete before timing out ==>  15

      Number of seconds to listen for connection attempt(server only) ==>  __

      Select an option for playback think time:
       1 1 Play at full speed
         2 Play at think time recorded on script
         3 Play at user specified think time

      If you have selected options 2 or 3, you may alter the rate of the playback
      by altering the Think Time (For option 3 only) or the percentage.

      User Think Time (HH:MM:SS) . . ________
      Percentage . . . . . . . . . . 100

           Press ENTER  to continue, END to exit
  4. Use start times to control dispatching of each Socket? controls the playback initiation time for each socket statement supplied in the job. If USESTIME is specified, Performance Test initiates playback of each socket relative to the start time values supplied in the socket statement. When this option is selected, Start Time for each socket is displayed on the main setup panel. Enter a slash (/) to select this option.
  5. Enter a Number of seconds to wait for I/O completion before timing out.
  6. Enter a Number of seconds to listen for connection attempt (server only).
  7. Select an option for playback think time:
    • 1 Play at full speed — no think time.
    • 2 Play at think time recorded in the script.
    • 3 Play at user-specified think time.
  8. If you selected option 2 or 3, you can change the User Think Time and/or Percentage if desired. User think time sets the amount of time to wait after receiving a server message before sending the next client message. Seconds is the only required value. Percentage is the percentage of think time to use for playback. With Option 2, it is the think time recorded in the script. With Option 3, it is the user-specified think time.
  9. Press Enter to continue and return to the Environment Options screen.
  10. Type a slash (/) next to the Connection Options field and press Enter. The Environment - Connection Options screen is displayed.
    Environment - Connection Options screen

    ----------------------- Environment - Connection Options ----------------------
     Command ===>

       Review current option settings and modify if required:

      Protocol        ==>  _____

      Server Port     ==>  ____

      Server Address  ==>  _______________

      Number of Connection Attempts before error ==>  __

      Pipelining - Send multiple client messages before receiving response ==>  _


           Press ENTER  to continue, END to exit
  11. Protocol — enter the desired protocol in this field.
  12. Change the Server Port and Server Address if desired. These fields override the default server port and address for the playback.
  13. Enter the number of times you want playback to try to connect to a server before giving an error message.
  14. Select Pipelining if you want playback to send multiple client messages to the server before waiting for a response.
  15. Press Enter to continue and return to the Environment Options screen.
  16. Type a slash (/) next to the Data Replacement Options field and press Enter. The Environment - Data Replacement Options screen is displayed.
    Environment - Data Replacement Options screen

    -------------------- Environment - Data Replacement Options -------------------
     Command ===>

      Values entered on this screen will replace corresponding content data in the
      script. To encrypt password type it in the "password" field and press Enter.

      DB2C   Userid    ==> ________
             Password  ==>                Confirm Password:

      IMSC   Userid    ==> ________
             Password  ==>                Confirm Password:

      ECI    Userid    ==> __________
             Password  ==>                Confirm Password:


               Press ENTER  to continue, END to exit

    On this screen you can replace data in the script during playback for the DB2C, IMSC, and ECI protocols.

  17. Enter information you want to override the User ID and password in the Db2 Connect CONTENT. You must enter the password a second time for confirmation.
  18. Enter information you want to override the User ID and password in the IMS Connect CONTENT. You must enter the password a second time for confirmation.
  19. Enter information you want to override the User ID and password in the ECI Connect CONTENT. You must enter the password a second time for confirmation.
  20. Press Enter to continue and return to the Environment Options screen.


Socket options

  1. Type a slash (/) next to the desired Socket on the TCP/IP Playback - Setup screen and press Enter. The Socket Options screen is displayed.Socket Options screen

    ------------------------------ Socket  1  Options -----------------------------
     Command ===>

       Select the type of options to view/modify using  / . To copy options to
      all Sockets in playback, type save all from any Socket options panel  .

     _  Processing Options:     Repeat(1),Count(1)


     _  Timing Options:         No start delay


     _  Connection Options:     Use Protocol From Script
                                Use Server Port From Script
                                Use Server Address From Script

     _  Data Replacement Options:  Use Userid From Script


          Enter END command to return to the previous panel

    From this screen, you can choose to change Processing, Timing, Connection, and Data Replacement options for the selected socket.

  2. Type a slash (/) next to the Processing Options field and press Enter. The Socket - Processing Options screen is displayed.
    Socket - Processing Options screen

    ----------------------- Socket  1  - Processing Options -----------------------
     Command ===>

       Review current option settings and modify if required:

       Number of Repeats                       ==>  1__

       Number of instances of this Socket      ==>  1__

       Error Handling:

       Suppress Error Messages                 ==>  _
       When error occurs:    Continue playback ==>  _
                             Stop connection   ==>  _
                             Stop script       ==>  _
                             Stop socket       ==>  _
                             Stop playback     ==>  _


           Press ENTER  to continue, END to exit
  3. Enter the number of times to repeat playback of scripts in the Socket and the number of instances of this Socket to play back concurrently.
  4. Suppress Error Messages suppresses warning and socket I/O error messages.
  5. When error occurs stops the playback at the level specified when an error occurs. The default is Continue playback. Choices include:
    • Continue playback
    • Stop connection
    • Stop script
    • Stop Socket
    • Stop playback.
  6. After making your changes, enter END to return to the Socket Options screen.
  7. Type a slash (/) next to the Timing Options field and press Enter. The Socket Timing Options screen is displayed.
    Socket Timing Options screen

    ------------------------- Socket 001 - Timing Options -------------------------
     Command ===>

       Review current option settings and modify if required:


       Number of seconds to delay start of this Socket  ==>  0__



          Press ENTER  to continue, END to exit
  8. Enter a number of seconds to delay the start of this Socket. This tells playback how long to wait between the start of a socket and commencement of playback.
  9. Type a slash (/) next to the Connection Options field and press Enter. The Socket - Connection Options screen is displayed.
     Socket - Connection Options screen

    TCPGRPC --------------- Socket  1  - Connection Options -----------------------
     Command ===> _____________________________________________

      Review current option settings and modify if required:

      Protocol                                          ==>  _____

      New Server Port                                   ==>  _____

      New Server Address                                ==>

      Number of Connection Attempts before error        ==>  __

      Send multiple client messages(pipelining)         ==>  _



           Press ENTER  to continue, END to exit
  10. Protocol — enter the desired protocol in this field.
  11. Change the Server Port and Server Address if desired. These fields override the default server port and address for the playback.
  12. Enter the number of times you want playback to try to connect to a server before giving an error message.
  13. Select Pipelining if you want playback to send multiple client messages to the server before waiting for a response.
  14. Press Enter to continue and return to the Socket Options screen.
  15. Type a slash (/) next to the Data Replacement Options field and press Enter. The Socket - Data Replacement Options screen is displayed.
    Socket - Data Replacement Options screen

    -------------------- Socket  1  - Data Replacement Options --------------------
     Command ===> _____________________________________________

      Values entered on this screen will replace corresponding content data in the
      script. To encrypt password type it in the "password" field and press Enter.

      DB2C   Userid    ==> ________
             Password  ==>               Confirm Password:
             Rdbname   ==> ________________

      IMSC   Userid    ==> ________
             Password  ==>               Confirm Password:
             Datastore ==> ________
             TranCode  ==> __________

      ECI    Userid    ==> __________
             Password  ==>               Confirm Password:

      CTG    Applid    ==> __________
             Progid    ==> __________


           Press ENTER  to continue, END to exit
  16. Enter information you want to override the User ID, password, and Rdbname in the Db2 Connect CONTENT.
  17. Enter information you want to override the User ID, password, Datastore, and TranCode in the IMS Connect CONTENT.
  18. Enter information you want to override the User ID and password in the ECI Connect CONTENT.
  19. Enter information you want to override the application ID and program ID in the CTG CONTENT.
  20. Press Enter to continue and return to the Socket Options screen.

Script options

  1. Type a slash (/) next to the desired Script on the TCP/IP Playback - Setup screen and press Enter. The Script Socket Options screen is displayed.
    Script Socket Options screen

    -------------------- Script  SCR00000   Socket  1   Options -------------------
     Command ===>

       Select the type of options to view/modify using  / . To copy options to
       all scripts in playback, type  save all  from any Script options panel.


     _  Processing Options:     Repeat(1)


     _  Connection Options:     Use Protocol From Script
                                Use Server Port From Script
                                Use Server Address From Script




          Enter END command to return to the previous panel

    On this screen, you can choose to modify Processing and Connection options for the selected script.

  2. Type a slash (/) next to the Processing Options field and press Enter. The Script Processing Options screen is displayed.Script Processing Options screen

    --------------------- Script  SCR00000 Processing Options  --------------------
     Command ===>

       Review current option settings and modify if required:

       Number of Repeats ==>  1___




           Press ENTER  to continue, END to exit
  3. Specify the number of times to repeat playback of the selected script.
  4. Press Enter to continue and return to the Script Socket Options screen.
  5. Type a slash (/) next to the Connection Options field and press Enter. The Script Connection Options screen is displayed.Script Connection Options screen

    TCPSCRC ------------- Script           Connection Options ---------------------
     Command ===>

      Review current option settings and modify if required:

      Protocol           ==>  _____

      New Server Port    ==>  ____

      New Server Address ==>  _______________




           Press ENTER  to continue, END to exit
  6. To override the protocol, server port and/or address, enter your changes in the appropriate field.
  7. Press Enter to continue and return to the Script Socket Options screen.
  8. After you have completed your modifications to the options, enter END to return to the TCP/IP Playback - Setup screen.
  9. Type OK on the command line and press Enter. The TCP/IP Playback - Submit screen is displayed. Continue with the next section, Submitting Your Playback for Execution.

Submitting your playback for execution

After creating your playback script, the TCP/IP Playback - Submit screen is displayed.

TCP/IP Playback - Submit screen

--------------------- TCP/IP Playback - Submit --------------------------------
 Command ===>

 Select a processing option, or type SAVE on the command line to save
 playback JCL to a dataset.


 Select an option:
   _  1. Submit batch job
      2. Edit batch job
      3. Save playback
      X. Exit

 Job statement information for batch job:
 ===> //JOBNAME  JOB (ACCOUNT),'NAME'
 ===> //*
 ===> //*
 ===> //*

On this screen, you can submit, edit, or save a batch job, save your playback, and exit playback submission.

  1. To save your playback JCL to a data set, type SAVE on the command line. The TCP/IP Playback - Save JCL File screen is displayed.
    TCP/IP Playback - Save JCL File screen

    ------------------------ TCP/IP Playback - Save JCL File  ----------------------
     Command ===>

     Enter the name of the dataset where JCL will be saved, then press ENTER
     to continue.

       Playback JCL dataset:
       Project . . . ________
       Group . . . . ________
       Type  . . . . ________
       Member  . . . ________

     Other Data Set Name: _______________________________________________________
       Data Set Name . . .

     Save JCL Options: (Enter "/" to select)
       _ Replace existing members

    This will save all of the parameters you have selected on the previous screens to your Performance Test profile.

  2. Enter a JCL data set name. If your name does not conform to ISPF naming standards, enter the name in the Other Data Set Name field. The JCL file must be a partitioned data set (PDS) or sequential file with variable blocked (VB) or fixed blocked (FB) record format. The record length must be at least 72.
  3. Press Enter to save your JCL file and return to the TCP/IP Playback - Submit screen. If your data set does not already exist, an “Allocate JCL File Screen” will be displayed. Press Enter to allocate the data set.
  4. Select an option:
    • Option X exits the TCP/IP Playback - Submit screen without submitting the playback.
    • Option 1 submits a batch job that creates your scripts.
    • Option 2 puts you in an ISPF edit session for the JCL that can be submitted to create your scripts. To create scripts, you must enter the “SUBMIT” primary command from within the edit session. After finishing your edits, enter the END command to return to the TCP/IP Playback - Submit screen.

      Important

      If you select option 1 or 2, you need to enter job card information into the Job statement information for batch job.

    • Option 3 allows you to save your playback. The TCP/IP Playback - Save screen is displayed.

      TCP/IP Playback - Save screen

      -------------------------- TCP/IP Playback - Save ---------------------------
      Command ===> _________________________________________________________________

         Playback Name . PBTCPIP_
         Description . . TCP/IP playback___________________________________________

         Save Playback Dataset:
         Dataset Name. . USER2312.TCPIP.PLAYBACK’_____________________________________



                        Press ENTER to continue,  END to cancel save.


  5. Enter a name and optional description for the Playback and a playback data set name. Then press Enter to save your Playback and press END to return to the TCP/IP Playback - Submit screen.
  6. Press Enter to execute the option you selected on the TCP/IP Playback - Submit screen. A message is displayed stating that your job was submitted.

Selecting a previously saved playback to review

  1. On the TCP/IP Playback - Selection screen, type S (select) next to the playback you want to select and press Enter. The TCP/IP Playback - Datasets screen is displayed. 
    This will load a previously created playback. You can make changes and resave it using the same or another name.
  2. Continue pressing Enter to view the next screen.
  3. When finished, you can run your playback or press END to return to the Performance Test for Mainframe Servers main menu.

Deleting a playback

  1. On the TCP/IP Playback - Selection screen, type D (delete) next to the playback you want to delete from the list and press Enter. The Delete Confirmation screen is displayed.
  2. Accept the default Y and press enter to delete your playback. Change the default to N to keep the playback.

Generating playback reports

  1. On the Performance Test for Mainframe Servers Main Menu, select option 9 TCP/IP Playback Reporting. The TCP/IP Playback - Selection screen is displayed.
    TCP/IP Reporting - Selection Screen

    ----------------------- TCP/IP Reporting - Selection  -----------------------
    Command ===> __________________________________________________________________

     Enter a database name , or select a database from the playback list below.
     Dataset Name. . . . ‘USER2312.PLAYBACK.REPORT_________________________________


     Playback DSN    :  ‘USER2312.TCPIP.PLAYBACK’
     Line commands...:  S)elect  or D)elete

     S  Name     Database Name
     -  -------- ------------------------------------------------------
        TEST1    USER2312.REPORT.DATABASE
  2. On this screen, select the desired report from the list, or type a data set name within single quotes in the Dataset Name field and press Enter. The TCP/IP Reporting screen is displayed.
    TCP/IP Reporting screen

    ------------------------------- TCP/IP Reporting ------------------------------
     Command ===>

       Select the type of report you wish to generate using  / .

     _ Basic Reports:          Fixed format reports include HTML Exception,
                               Script Timing and Response Time Summary


     _ Custom Reports:         Select member below that contains reporting process

        Project . . . ________
        Group . . . . ________
        Type  . . . . ________
        Member  . . . ________
     Other Partitioned Dataset:
        Dataset Name. . . .  _____________________________________________________

          Type  END command to return to the previous panel, ENTER to
          continue
  3. Specify whether to generate basic or custom reports and press Enter.
    • Basic reports include the response time summary, exception, and script timing reports.
    • Custom Reports are reports that your site has created that contain REPORT statements to be used in the report job. When you make this selection, you must enter a data set name in the Other Partitioned Dataset field. Use a member from a data set that contains report statements to be used in the report job.
  4. Continue with the next section, TCP/IP - Basic Reports or TCP/IP - Custom Reports.

TCP/IP - Basic reports

  1. You will have accessed this screen by typing a slash (/) next to the Basic Reports field on the TCP/IP Reporting screen and pressing Enter. The following TCP/IP - Basic Reports screen is displayed.
    TCP/IP - Basic Reports screen

    ---------------------------- TCP/IP - Basic Reports ---------------------------
     Command ===> _______________________________________________________________
      Select a report(s) to generate using / and enter location.

       _ HTML Exception Report (hfs path required):
       __________________________________________________________________________
       __________________________________________________________________________
       Optional Parameters:
         Number of mismatches to display before stopping ==>  ___
         Masking DSN   __________________________________________________________
         Compare to baseline database ==>  _
         Baseline DSN  __________________________________________________________

       _ Script Timing Summary (hfs path, DSN, or leave blank for SYSOUT=*):
       __________________________________________________________________________
       __________________________________________________________________________

       _ Response Time Summary (hfs path, DSN, or leave blank for SYSOUT=*):
       __________________________________________________________________________
       __________________________________________________________________________

          Enter END command to return to the previous panel


  2. On this screen, you can specify the locations of the basic reports that you want to generate. If you specify a location for a type of report, that type of report will be generated. You can generate multiple report types in the same reporting job. The types of reports available include:

    • HTML Exception Report: A standard exception report that compares actual response messages to expected response messages from a single data collection. You must specify an hfs path. (Example: u/compware/user/excp.htm.)
      • If desired, specify the number of mismatches to display before ending report generation.
      • You can use data masking to prevent comparison of specific data. Store your masking statements in a sequential data set or PDS member.
      • To perform a baseline comparison, type a slash (/) in the Compare to baseline database field and enter the name of the baseline dataset you wish to compare.
    • Script Timing Summary: A standard report that reports the time it took for each script to play back. It also provides additional timing statistics for the play back job. (Example: u/compware/user/scrp.htm.)
    • Response Time Summary: A standard report that reports the amount of time it took each group of related messages to occur. For example, this includes the time that elapsed from the first byte of the request to the last byte of the response. (Example: u/compware/user/resp.htm.)

TCP/IP - Custom Reports

Custom reports allow you to use a member from a data set that contains REPORT statements that will be used in the report job.

  1. On the TCP/IP Reporting screen, type a slash (/) next to the Custom Reports field, enter a data set name and member and press Enter. The Custom Report Parameters screen is displayed.Custom Report Parameters screen

    --------------------------- Custom Report Parameters --------------------------
     Command ===> _____________________________________________

      Report Layout:      Table(columns)   ==> _
                          Form(rows)       ==> _

      Type:               Text             ==> _
                          Html             ==> _
                          CSV              ==> _

      Number of lines to print in a field before truncating data ==> ____

      Maximum Number of Lines to print on a page(30-9999)        ==> ____

      Break(only applicable to form reports)
             _ EJECT   begin each record on a new page
             _ NEXT    continue reporting on next line



          Type  END command to return to the previous panel, ENTER to
          continue
  2. Select the desired Report Layout. Table is the default.
    • Select Table to produce a row/column-oriented report. The following figure shows a Table report layout.Table Report Layout

      Hiperstation for Mainframe Servers - Message Report    Date: 07/28/06 07:48    Page:  1
      ---------------------------------------------------------------------------------------
      MessageID   SocketsNumber   MessageStartTime          MessageFinishTime
      ---------------------------------------------------------------------------------------
      4           1               2006/07/21_15:10:37.290   2006/07/21_15:10:38.052
      6           1               2006/07/21_15:10:39.409   2006/07/21_15:10:39.938
      9           1               2006/07/21_15:10:40.913   2006/07/21_15:10:42.170
      ******************************** BOTTOM OF DATA ***************************************


    • Select Form to produce a line-based report. The following figure shows a Form report layout.Form Report Layout

      Hiperstation for Mainframe Servers - Message Report    Date: 07/28/06 07:48    Page:  1
      ---------------------------------------------------------------------------------------
      MessageID                                 4
      ---------------------------------------------------------------------------------------
      SocketsNumber                             1
      ---------------------------------------------------------------------------------------
      MessageStartTime                          2010/07/21_15:10:37.290
      ---------------------------------------------------------------------------------------
      MessageFinishTime                         2010/07/21_15:10:38.052
      ---------------------------------------------------------------------------------------
      Hiperstation for Mainframe Servers - Message Report    Date: 07/28/06 07:48    Page:  2
      ---------------------------------------------------------------------------------------
      MessageID                                 6
      ---------------------------------------------------------------------------------------
      SocketsNumber                             1
      ---------------------------------------------------------------------------------------
      MessageStartTime                          2010/07/21_15:10:39.409
      ---------------------------------------------------------------------------------------
      MessageFinishTime                         2010/07/21_15:10:39.938
      ---------------------------------------------------------------------------------------
      Hiperstation for Mainframe Servers - Message Report    Date: 07/28/06 07:48    Page:  3
      ---------------------------------------------------------------------------------------
      MessageID                                 9
      ---------------------------------------------------------------------------------------
      SocketsNumber                             1
      ---------------------------------------------------------------------------------------
      MessageStartTime                          2010/07/21_15:10:40.913
      ---------------------------------------------------------------------------------------
      MessageFinishTime                         2010/07/21_15:10:42.170
      ---------------------------------------------------------------------------------------
  3. Select the type of report you want to produce. Choices include: Text (default), HTML, and CSV.
  4. Enter a number of lines to print in a field before truncating data. This applies only to Text and CSV reports and allows you to truncate the printing of large fields that may contain up to two gigabytes of data.
  5. Enter the maximum number of lines to print on a page. Enter between 30 and 9999. This applies only to Text reports. The default is 60.
  6. If you are using form reports in a Text or HTML format, select EJECT to begin each record on a new page or NEXT to continue the report on the next line. EJECT is the default.
  7. Press Enter to continue. The Custom Report Locations screen is displayed.
    Custom Report Locations Screen

    --------------------------- Custom Report Locations ---------------------------
     Command ===>

     Enter a location for the table(s) you are reporting on, if different than
     SYSOUT=*. The tables used by each report correspond to the INTO parameter.

     Playback      _______________________________________________________________
                   _______________________________________________________________
     Sockets       _______________________________________________________________
                   _______________________________________________________________
     Script        _______________________________________________________________
                   _______________________________________________________________
     Connection    _______________________________________________________________
                   _______________________________________________________________
     Message       _______________________________________________________________
                   _______________________________________________________________



          Type  END command to return to the previous panel, ENTER to
          continue
  8. If the tables you are reporting on are not located in SYSOUT=*, then specify the table locations.

    Important

    Use unique report locations. If you specify the same data set location for more than one report, the last report will be the only one shown because the previous ones will be overwritten.

  9. Press Enter to continue. TCP/IP Playback - Submit screen is displayed.

    Important

    You submit your playback report for execution in the same way you submitted your playback for execution. See Submitting Your Playback for Execution for information on submitting and saving your playback report.

 

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