Recording a TN3270 performance test

You can record a TN3270 test from a terminal emulation client. When you record, the recording wizard automatically starts the terminal emulation client and records all the screen and input activity that transits the socket connection.

Before you begin

Ensure that you have a TN3270 terminal emulation program installed on the local computer.

Tests are stored in performance test projects. If your workspace does not contain a performance test project, the test-creation wizard creates one with a name that you can change. To store a test in a specific project, verify that the project exists before you record the test.

Ensure that the session that you are recording is reproducible. This means that when the recorded actions are replayed by the test, the same responses from the server will be received.


To record a socket test:

  1. In the Performance Test perspective, click the New Test from Recording toolbar button New Test from Recording toolbar button or click File > New > Test from Recording.
  2. In the New Test from Recording wizard, click Create a test from a new recording, select TN3270 Test, and click Next. If you are recording sensitive data, you can select a Recording encryption level.
  3. On the Select Location page, select the project and folder where to save the new test, type a name for the test, and click Next. If necessary, click Create Parent Folder Create Parent Folder icon to create a new project or folder
  4. On the Select Client Application page, select the type of client program to use to record the test:
    • In most cases, select IBM Personal Communication or Attachmate EXTRA! X-treme, and click Next.

      If required, specify a session file to start the TN3270 session.

    • If you are using other TN3270 terminal emulation software, select Managed Application, and click Next.

      On the Managed Application Options page, click Browse to specify the program path. If necessary, specify the Working directory, and in Arguments, type the command-line arguments that the program requires.

      If the program requires user input from a command-line interface, select Open console for user input.

  5. If this is the first time you record a socket API performance test, read the Privacy Warning, and select Accept to proceed.
  6. Click Finish to start recording. A progress window opens while the TN3270 terminal program starts.
  7. Use the TN3270 terminal program to perform the actions to test. You can use the Recorder Test Annotations toolbar to add comments, record synchronizations, or take screen captures during the recording.
    • To add a comment to the recorded test, click the Insert comment icon Insert comment icon.
    • To add a screen capture to the recorded test, click the icon Capture screen icon Capture screen. Screen and window captures make your tests easier to read and help you visualize the recorded test. You can change the settings for screen captures and add a comment to the image.
    • To manually add a test synchronization to the recording, click the Insert synchronization icon Insert synchronization icon.
    • To manually add a transaction folder to the recording, click the Start Transaction icon Start Transaction icon and Stop Transaction icon Stop Transaction icon to start and stop the transaction.
    • To insert a split point into the recorded test, click the Split point icon Split point icon. With split points, you can generate multiple tests from a single recording, which you can replay in a different order with a schedule. See Splitting a test during recording for more information about splitting a test.
  8. When you have finished test actions in the program, stop the recorder. You can do this by closing the TN3270 terminal program or by clicking the Stop push button Stop icon in the Recorder Control view. A progress window opens while the test is generated. On completion, the Recorder Control view displays the Test generation completed message, the Test Navigator lists your test, and the test opens in the test editor.