Demonstrating Scripts with Session Demo (VTAM)

The session demo function lets you structure end-user training sessions and presentations without running your application. With session demo, you can demonstrate any previously recorded Performance Test for VTAM script (except for input only scripts) without changing the script or interacting with the domain destination used to record it. This allows you to implement effective training without interfering with your production or test environment.

Accessing Session Demo

1. Select option 3 Session Demo from the Performance Test for VTAM Main Menu to run session demo. The Demonstration Setup screen appears.
   Demonstration Setup screen

      ----------------------------- Demonstration Setup -----------------------------
      OPTION  ===>
   
      Select the Recording and press ENTER  to start the Demo.
   
      RECORDING FILE NAME:
         PROJECT ===>
         GROUP   ===>
         TYPE    ===>
         MEMBER  ===>                  (Blank or pattern for member selection list)
   
      OTHER PARTITIONED DATA SET:
         DATA SET NAME  ===> 'PMIJSS0.HIPER.VTAM.SCRIPTS(SAMP0000)'
   
      "ZOOM" key ===> PF23
      Begin demo in ZOOM mode ==> N (Y/N)     Begin demo in POP-UP mode ==> N (Y/N)
   
      DEMO/THINK TIME OPTION ===> 1
      1 Demo interactively
      2 Demo at full speed
      3 Demo at Think Time recorded on script
      4 Demo at Think Time specified below
      Time(ss th) => 01 50 Percent ===> 100

   From this screen, you can set up your demonstration options.

2. Specify the recording file name (PROJECT, GROUP, and TYPE or OTHER PARTITIONED DATASET NAME). This must be an existing script.
   The MEMBER is the name of the script. You can use any valid member name. If you leave the member name blank or enter a pattern member name, an ISPF member selection list appears. This member selection list accepts the following line commands:

   • B: Browse the member
   • E: Edit the member
   • S: Select the member for playback.

   The member selection list also accepts all standard selection list primary commands, such as LOCATE and SORT.

   Warning

   Important

   Remember that you cannot use input only scripts in Session Demo.

   You can use OTHER PARTITIONED DATASET NAME, including the MEMBER, if your dataset name does not conform to ISPF naming standards.

3. Accept the default Zoom Key, or specify another PF key to toggle a session between Zoom and ISPF (interactive) display modes. See Product-Conventions-VTAM for display mode information.
4. Specify Begin demo in ZOOM mode (Yes or No).
5. Specify Begin demo in POP-UP mode (Yes or No).

6. Specify DEMO/THINK TIME OPTION. Your choices include options that determine how the demo session will proceed.

   • 1: Demo interactively: The demonstration proceeds each time you press Enter.
   • 2: Demo at full speed: The transactions play back as quickly as the system can run them.
   • 3: Demo at the think time recorded on the script: Think time is simulated using the think time recorded on the script.
   • 4: Demo at the think time chosen below: Indicates that the think time for all transactions is the amount of time set in the Time(ss th) field (the think time for each transaction). Time is measured in seconds and hundredths of a second. For example, 00 75 is three-fourths of a second think time.

   Warning

   Important

   Percent allows a percentage figure to be applied to the think time when the THINK TIME OPTION is set to 3 or 4. For example, to play back a script with half of the original think time, set THINK TIME OPTION = 3 and Percent = 50.

Starting the Demonstration

To start the demonstration, specify the desired options on the Demonstration Setup screen and press Enter. The first screen of the demonstration appears (see the Session Demo screen).

The SessionDemo screen consists of three information lines followed by the display window.

Session Demo screen

The top, or title line, shows the Zoom key setting and the current scroll position.

The second line is a standard ISPF command line where you can enter both ISPF and Session Demo commands.

The third line, the status line, shows the status of the Session Demo options:

For each transaction, two screen images are generated. The first screen image shows the KEY field on line three followed by the AID key the user pressed (such as Enter, PF1, or CLEAR).

The second screen image shows the output from the application. The output images are distinguished by the <OUTPUT> identifier in the KEY field.

Pop-Up windows

You can manually add pop-up windows to a script to:

• Explain fields on the screen
• Describe the next series of keystrokes
• Emphasize a particular area of the screen.

1. To turn on pop-up window mode, type POP on the Command line and press Enter.
   The pop-up window mode in the Status line changes to ON, and any pop-up window defined for this screen appears.
2. To remove pop-up windows, type POP on the Command line and press Enter. The Pop-Up mode in the Status line changes to OFF.

Pop-Up window guidelines

• You can add pop-up windows manually to any output screen in the script.
• The pop-up window definition starts with a <POP> record and ends with a </POP> record. See the Pop-Up Window Definition screen.
• The lines of text between the opening and closing markers are considered the pop-up window text. The window is placed on the screen according to the row and column set on the <POP> record.
• The pop-up window definition must be contained within an <OUTPUT> - </OUTPUT> group.
• An output screen can contain multiple pop-up windows.
• A box is drawn around the text, and the pop-up window is highlighted.
• The upper left corner of the pop-up window will be drawn at an offset of two columns to the right of the coordinates specified in the <POP> tag. This will allow for DBCS fields and an attribute byte for the window.
• The script shows the Pop-Up window definition.

Pop-Up Window Definition

Session demo commands

Auto

Automatically moves the display forward one screen every nn seconds. You can end auto display mode by pressing the ATTENTION or PA1 key, depending on the type of controller attached to your terminal. For example, entering A5 updates the display every five seconds.

AZ

The Auto Zoom command moves the display forward one screen every n seconds, and the display is transferred to Zoom mode. For example, A05 moves the display forward one screen every five seconds. To terminate zoom mode, press the ATTENTION or PA1 key depending on the type of controller attached to your terminal.

END

Terminates the Session Demo.

Find

Locates text strings in the recorded screen images. If the string contains embedded spaces or blanks, you must enclose it in quotes. For example, the command: F ‘ISPF MODE’ PREV finds the characters ISPF MODE in previous displays.

Locate nnn

Moves the display to a particular screen image. ‘nnn’ is the number of the screen image to display. For example, to move the display to the first screen image, enter: L 1. To move the display to the last screen image (not necessarily 999), enter: L 999.

Next 1|nnn

Moves the display to the screen image that follows the currently displayed image. ‘nnn’ is the number of images to move forward. For example, to move the display forward twelve screen images, enter: N 12. You can also use PF8 (Forward) to move forward one screen.

The default is 1, which moves the display to the next screen. This is equivalent to pressing Enter with no command entered on the command line.

Turns on the pop-up window mode.

Prev 1|nnn

Moves the display to the screen image that precedes the currently displayed image. ‘nnn’ is the number of images to move back. For example, to move the display back twelve screen images, enter: P 12. You can also use PF7 (Backward) to move back one screen.

The default is 1, which moves the display to the previous screen.

Screen Cut places one or more screen images on an ISPF clipboard for later use by the SPASTE command.

‘nn’ indicates the number of screen images to place on the clipboard. The default is 1. When more than one screen is cut, they are gathered from the previous screens to the one currently displayed. For example, SCUT 5 places five screen images on the clipboard. If you are currently displaying screen number 17 and enter SCUT 3, screens 15, 16, and 17 are cut. BOX draws a box around the screen image.

SPASTE

Screen Paste copies one or more screen images from the ISPF clipboard and places them in the current Edit session. The screen images are then deleted from the clipboard.

DELETE

Deletes the screens from the clipboard after they are copied. The default is DELETE.

KEEP

Keeps the screens on the clipboard after they are copied.