Running a sample ISPF session

This topic provides an example of an ISPF session. For new users, it is a quick introduction to ISPF. For users with previous ISPF experience, it is a quick review. It can also be used to demonstrate that ISPF has been properly installed and is operational.

The scenario requires the installation of a data set named ISP.SISPSAMP. This data set is included on the ISPF basic distribution tape and should contain these four members:

ISRASM: Sample assembler source
ISRCOBOL: Sample COBOL source
ISRFORT: Sample FORTRAN source
ISRPLI: Sample PL/I source.

During this scenario, member ISRASM is copied from ISP.SISPSAMP to a user data set. The other three members are not used.

Table 1. A sample ISPF session
Action	Result
1. Log on to TSO.	READY is displayed on your screen.
2. Type `ISPF` (or the appropriate alias) and press Enter.	The ISPF Primary Option Menu is displayed.
3. On the Option line, type `3` to select the Utilities option. Then press Enter.	The Utility Selection Panel is displayed.
4. On the Option line, type `2` to select the Data Set utility. Then press Enter.	The Data Set Utility panel is displayed.
5. On the Option line, type `A` to allocate a new data set. Specify an ISPF library by typing this information, but substitute your first name in the Group field: `Project . . your_user_id Group . . . name Type . . . . ASM` Now press Enter.	The Allocate New Data Set panel is displayed. Note: The Project name must be defined as a valid high-level identifier on your installation. Generally, user-ids are defined as such. If this is not true for your installation, ask your system programmer what project names are valid for your system.
6. Type the information shown. Note: Leave ALL fields blank except: `Space units . . . . . . TRKS Primary quantity. . . . 2 Secondary quantity. . . 1 Directory blocks. . . . 1 Record format . . . . . FB Record length . . . . . 80 Block size . . . . . . 3120` Now press Enter.	Data set your_user_id.name.ASM is allocated on scratch volume. The Data Set Utility panel is displayed.
7. Select option A again and specify this ISPF library, again substituting your first name in the Group field: `Project . . your_user_id Group . . . name Type . . . . OBJ` Press Enter.	The Allocate New Data Set panel is displayed.
8. Leave everything the same. Just press Enter.	Data set your_user_id.name.OBJ is allocated. The Data Set Utility panel is displayed.
9. Press F3.	The Utility Selection Panel is displayed.
10. Press F3 again.	The ISPF Primary Option Menu is displayed.
11. Type `3.3` to select the Move/Copy utility, bypassing the Utility Selection Menu. Press Enter.	The Move/Copy Utility panel is displayed.
12. Now you will copy a data set. On the Option line, type `C` to select `Copy data set or member(s)`. Then, under From Other Partitioned or Sequential Data Set:, enter this data set name: `Data Set Name . . . 'ISP.SISPSAMP(ISRASM)'` Press Enter.	A panel titled COPY FROM ISP.SISPSAMP(ISRASM) is displayed.
13. Under To ISPF Library:, type these values: `Project . . your_user_id Group . . . name Type . . . . ASM` Press Enter.	Member ISRASM is copied from data set ISP.SISPSAMP to ISPF library your_user_id.name.ASM. Then, the Move/Copy Utility panel is displayed.
14. Press F3.	The ISPF Primary Option Menu is displayed.
15. Now you will browse member ISRASM. On the Option line, type `1` to select View and press Enter.	The View Entry Panel is displayed. Select Browse Mode.
16. Type these details under ISPF LIBRARY: `Project . . your_user_id Group . . . name Type . . . . ASM` Note: Leave the Member field blank. Press Enter.	A member list is displayed, showing ISRASM as the only member in the your_user_id.name.ASM library.
17. Move the cursor to the left of ISRASM. Then type `S` to select ISRASM and press Enter.	A panel titled BROWSE your_user_id.name.ASM (ISRASM) is displayed. This is the first page of member ISRASM.
18. Press F8 to scroll ahead one page.	The second page of ISRASM is displayed.
19. Press F7 to scroll backward one page.	The first page of ISRASM is displayed.
20. Type `FIND COMMENT` on the Command line and press Enter.	The cursor moves to the first occurrence of the character string `COMMENT` and the string is intensified. Also, the message `CHARS 'COMMENT' FOUND` is displayed in the upper-right corner of the screen.
21. To find the next occurrence of `COMMENT`, press F5, the RFIND command.	The cursor moves to the second occurrence of `COMMENT` and once again the string is intensified.
22. Press F3.	The member list is displayed.
23. Press F3 again.	The View Entry Panel is displayed.
24. Press F3 one more time.	The ISPF Primary Option Menu is displayed.
25. Now you will edit member ISRASM. On the Option line, type `2` to select Edit and press Enter.	The Edit Entry Panel is displayed.
26. Type `ISRASM` in the Member field and press Enter.	A panel titled EDIT your_user_id.name.ASM(ISRASM) is displayed. This is the first page of member ISRASM.
27. On the Command line, type `FIND COMMENT` and press Enter to find the line containing the character string `COMMENT`.	The cursor moves to the first occurrence of the character string and the line number is intensified.
28. Delete `COMMENT` by pressing the Erase EOF key.	`COMMENT` is erased. Any characters to the right of `COMMENT` are erased, also.
29. Press F5 to find the next occurrence of `COMMENT`.	The cursor moves to the second occurrence of `COMMENT` and the line number is intensified.
30. Move the cursor to the sequence number of the line below `COMMENT`, then move the cursor up one line. Repeat the `COMMENT` line by typing `R` over the first digit of the line number and pressing Enter.	The line is repeated.
31. On the Command line, type `AUTOLIST ON`, and press Enter.	Sets autolist mode on for automatic source listings.
32. Try out more Edit commands if you like, but remember: this program will be assembled later.	HAVE FUN!
33. Press F3.	Member ISRASM is saved in data set your_user_id.name.ASM and a listing of the member is placed in the ISPF list data set. The Edit Entry Panel is displayed.
34. Press F3 again.	The ISPF Primary Option Menu is displayed.
35. Move the cursor to Help on the action bar. Press Enter. On the resulting pop-up window, select 18.	The beginning of the ISPF tutorial is displayed. Follow the directions to learn more about ISPF. When you have finished, press F3 to return to the ISPF Primary Option Menu.

If you have followed this scenario, you should have an Assembler listing in a data set named either prefix.userid.ASMTEST1.LIST or userid.ASMTEST1.LIST. Also, when the job that you submitted has finished, you will have another listing in a data set named either prefix.userid.ASMTEST2.LIST or userid.ASMTEST2.LIST. Try the Browse option to review the listings and try experimenting with other ISPF options. hen you have finished, return to the ISPF Primary Option Menu.

Table 2. Finishing the sample session
Action	Result
50. With the ISPF Primary Option Menu on the screen, press F3.	The ISPF Specify Disposition of Log and List Data Sets panel is displayed.
51. Select the process option to print and delete both the log and list data sets, and fill in the job statement information as required by your installation. Press Enter.	Data sets will be printed, then deleted through batch jobs submitted by ISPF. The job name is displayed at the bottom of the screen.
52. You are now out of ISPF. To leave TSO, type `LOGOFF` and press Enter.	This is the end of this usage scenario.