ISPF Programmer's Guide

Franz Lanz

• Publisher: De Gruyter Oldenbourg
• Year: 2015
• eBook ISBN: 9783110407655
• Edition: 1
• Topic: Computer Science
• Subtopic: Programming Algorithms
• Index: Computer Science

This book is intended to support ISPF application programmers to become professional in the smart programming of ISPF applications using the REXX language. The contents are presented in a modular manner to suit reading with heterogeneous ISPF programming knowledge. The following topics are covered: Introduction to the programming language REXX as well as to ISPF programming, data processing in ISPF applications, use of messages, panels, skeletons, tables, ISPF variables and an introduction to creating and applying edit macros. Each theme is vividly illustrated by programming examples. The Smart ISPF Utilities contain some very useful programming aids that are often useful when programming ISPF applications. The book serves as a textbook as well as a manual for daily work. Many cross-references are included as well as an extensive index. Moreover, the author gives many helpful hints and tips on smart ISPF programming practices. The Smart ISPF Utilities contain many useful programming aids.

1Introduction

1.1Users of this book

This book has been comprised for ISPF users with programming skills. You will learn how to insert and use your own functions in the ISPF using the procedure language REXX together with ISPF programming facilities.

1.2The significance of the REXX programming language in z/OS

Michael Cowlishaw and his team developed REXX in 1979 at the IBM laboratory in Hursley GB for the mainframe operating system MVS. Since this time many z/OS applications using the programming language REXX have been developed in IBM labs worldwide. Almost all of these applications run under the control of ISPF. This shows that IBM to the programming language REXX attaches great importance.

Other REXX implementations:

REXX is now available on all major computer platforms. I would particularly like to mention The REXX Language Association here. This association develops and maintains the object-oriented REXX version OOREXX. Use the internet link www.rexxla.org to get more information. I use OOREXX on my own Windows PC for many tasks, e.g., control of backups, printing of a list for all my stored movies.

1.3Brochures for programming ISPF applications

The following subchapters describe which brochures are needed for programming ISPF applications.

The required books are divided into following groups.

–Books that describe the REXX language.

–Books that describe the ISPF programming facility enhancements.

–One book that describes the TSO/E commands usable in REXX programs.

1.3.1The REXX programming literature

There are many books on the market describing the REXX language. Now there are several implementations of the REXX language in a variety of computer systems available. For the use of REXX under TSO-E and ISPF, the official brochure of IBM is the most important one. I use for my REXX programming in ISPF the following two books:

1.3.1.1TSO-E REXX Reference

IBM form number SA22-7790.

This book is the official REXX language publication of IBM. It contains descriptions of all aspects how REXX can be in the TSO-E environment used. First, this brochure contains the description of the REXX commands. In addition, the following topics are discussed in detail:

–Debug aids.

–TSO/E REXX programming services

–TSO/E REXX customizing services

–Language Processor Environments

–Initialization and termination routines

–Replaceable routines and exits

These chapters are only of interest to programmers who want to use REXX programs under special conditions as there are:

–Calling subroutines written in Assembler language.

–Calling REXX programs by programs that are written in other languages.

–Writing REXX execs to perform MVS operator activities.

1.3.1.2The REXX Language

Published 1990 by Prentice-Hall Inc. ISBN 0-13-780651-5.

The father of the REXX programming language Michael Cowlishaw wrote this book. It contains descriptions of all elements of the language without describing implementations in single carrier systems. I use this book often for creating REXX programs, because it is also helpful to create REXX programs under MS Windows just because it only contains the description of the REXX language and nothing else.

1.3.2ISPF reference books

Of course, for such a big subsystem as the ISPF many reference books are available. You can find these books free of charge in IBMs internet book libraries. They are available in two types:

1.As PDF books for downloading to your PC.

2.For direct display with an internet browser.

In the following chapter, I will show you where you can find all information to develop ISPF applications. Unfortunately, IBM changes methods from time to time to find a certain type of reference book. You can use the following steps:

1.With the following URL you reach the general z/OS literature frame:

2.http://www-03.ibm.com/systems/z/os/zos/library/bkserv/

3.You can click on the line z/OS V2R1 documentation in PDF format. This action leads you to z/OS V2R1 Elements and Features selection menu. When a new release of z/OS appears, the text V2R1 may change.

4.Now press Cntrl+F and enter the search text ISPF. The browser positions the cursor on z/OS ISPF.

5.Click on this line and see the group of available ISPF publications.

6.Click on the book you want and the book is opened in your PDF reader. You can now save it on your PC for later use.

There is a direct link to the ISPF Library
http://www-01.ibm.com/software/awdtools/ispf/library/

Under this link, you will find ONLY ISPF reference books. However, also earlier releases are listed.

The IBM form number:

All books within the IBM z/OS library have a dedicated Form Number. The IBM form number consists of three blocks of information each separated by a hyphen:

1.The first part is a four-character item: two alpha characters and a two-digit number. e.g., SC19 stands for all ISPF books.

2.The second part is a four-digit number defining the book within its group.

3.The third part is a two-digit number continuously counted upward for this book.

Table 1.1 on page 4 shows the ISPF reference books designed for ISPF programming purposes and their form numbers for z/OS release V2R1:

Table 1.1: Reference books for the programming of ISPF applications

Title	Form number
z/OS ISPF Dialog Developer’s Guide and Reference	SC19-3619-00
z/OS ISPF Dialog Tag Language Guide and Reference	SC19-3620-00
z/OS ISPF Edit and Edit Macros	SC19-3621-00
z/OS ISPF Messages and Codes	SC19-3622-00
z/OS ISPF Reference Summary	SC19-3624-00
z/OS ISPF Services Guide	SC19-3626-00

Hint:
If you are searching for a book using the form number, then you should use only the basic number without the release appendix. The system then shows all available titles and you can choose the proper exemplar.

The following listing shows such manuals you shou...

Table of contents

• Cover
• Title
• Copyright
• Preface
• Table of Contents
• 1 Introduction
• 2 Introduction to the REXX programming language
• 3 The REXX commands
• 4 The REXX functions
• 5 The TSO/E REXX commands
• 6 Execute REXX programs
• 7 Introduction to ISPF programming
• 8 Data set processing using ISPF
• 9 Messages – Definition, setting, output
• 10 Panels – create and use
• 11 Skeletons – Design and use
• 12 Tables – Create and edit
• 13 Variables – Definition and using
• 14 Edit macros – Create and apply
• 15 The SMART ISPF utilities
• List of programs
• List of tables
• List of screens
• Bibliography
• Index