book

ISPF Programmer’s Guide

Name: ISPF Programmer’s Guide
Author: Franz Lanz
ISBN: 9783110407655

by Franz Lanz

November 2015

Intermediate to advanced

320 pages

6h 16m

English

De Gruyter Oldenbourg

Read now

Unlock full access

Cover
Title
Copyright
Preface
1 Introduction
1.1 Users of this book1.2 The significance of the REXX programming language in z/OS1.3 Brochures for programming ISPF applications1.3.1 The REXX programming literature1.3.2 ISPF reference books1.3.3 TSO reference books1.3.4 The ISPF services
2 Introduction to the REXX programming language
2.1 What is REXX?2.2 Overview of REXX under TSO2.2.1 Recognizing a REXX procedure by the TSO2.2.2 Running REXX procedures in the TSO2.3 Compile REXX procedures2.4 Performance of REXX procedures2.5 The syntax of the REXX language2.6 Variables in REXX2.7 Data types of REXX variables2.8 Operators of the REXX language2.8.1 String operators2.8.2 Arithmetic Operators2.8.3 Compare operators2.8.4 Logical operators2.9 Stems in REXX2.9.1 Initialize stems with null string2.9.2 File processing in connection with stems2.9.3 Multi-unit Stems
3 The REXX commands
3.1 ADDRESS – Connection to the subsystems3.1.1 The host command environments3.1.2 The active host command environment3.1.3 The temporary addressing of external commands3.1.4 Special case ISPEXEC and ISREDIT3.1.5 The main host command environments3.2 ARG – Retrieve the parameter string3.3 CALL – Call other programs3.4 DO groups and DO loops3.4.1 The DO group3.4.2 The DO loop3.5 EXIT and RETURN – leaving the REXX procedure3.6 IF and WHEN – check conditions3.7 INTERPRET – generate REXX commands dynamically3.8 NUMERIC – set computing options3.9 PARSE – text fragmentation3.9.1 PARSE ARG3.9.2 PARSE VALUE WITH3.9.3 PARSE VAR3.9.4 PARSE SOURCE3.10 PROCEDURE – Option for internal subroutines3.10.1 Internal subroutines with PROCEDURE statement3.10.2 Internal subroutines without PROCEDURE statement3.11 QUEUE – Working with the TSO stack3.11.1 The TSO/E data stack3.11.2 Use options for the TSO/E Data Stack3.12 SAY – Print texts3.13 SELECT – Conditionally call alternative instructions3.14 NOP – No operation3.15 PULL – Enter data on the screen3.16 TRACE – The strong debugging aid3.17 SIGNAL – Jumping when errors
4 The REXX functions
4.1 General functions4.1.1 ADDRESS – Get the active host command environment4.1.2 ARG – Input parameter test or take4.1.3 DATE – Date functions4.1.4 TIME – Time functions4.1.5 QEUED – Number of records in the data stack4.1.6 SOURCELINE – Return a program line4.1.7 USERID – Return the TSO user ID4.1.8 VALUE – Create variable names dynamically4.2 Arithmetic functions4.2.1 ABS – absolute value of a number4.2.2 DIGITS, FORM, FUZZ – Query options for arithmetic operations4.2.3 MIN, MAX – Minimum and maximum value4.2.4 RANDOM – Generate random numbers4.2.5 SIGN – Return of the sign4.3 Comparison Functions4.3.1 COMPARE – Compare texts4.3.2 DATATYPE – Determine data type4.4 Conversion functions4.4.1 C2D – Character to decimal4.4.2 C2X – Character to Hexadecimal4.4.3 D2C – Decimal to Character4.4.4 D2X – Decimal to Hexadecimal4.4.5 X2B – Hexadecimal to Binary4.4.6 X2C – Hexadecimal to Character4.4.7 X2D – Hexadecimal to Decimal4.5 Formatting functions4.5.1 CENTER – Centering a string4.5.2 COPIES – Reproduce texts4.5.3 FORMAT – Format numbers4.5.4 JUSTIFY – Formatting a string4.5.5 LEFT – Rearrange text left-justified4.5.6 RIGHT – Arrange text right- justified4.6 String functions4.6.1 DELSTR – Delete substrings4.6.2 INSERT – Insert text4.6.3 SCHANGE – Change of texts4.6.4 LENGTH – Length of a text4.6.5 OVERLAY – Superimpose text4.6.6 POS – Search for text4.6.7 STRIP – remove border characters4.6.8 SUBSTR – Extract part of a text4.6.9 TRANSLATE – translate characters4.6.10 VERIFY – verify text4.7 Word functions4.7.1 WORD – return of a word4.7.2 WORDINDEX – return the starting position of a word4.7.3 WORDLENGTH – return the length of a word4.7.4 WORDPOS – search for a word4.7.5 WORDS – number of words in a string4.8 System functions4.8.1 LISTDSI – List data set information4.8.2 MSG – control of the TSO messages4.8.3 MVSVAR – Return z/OS system information4.8.4 OUTTRAP – take TSO messages4.8.5 SYSDSN – check data set status4.8.6 SYSVAR – get system Information4.8.7 STORAGE – read and write memory contents
5 The TSO/E REXX commands
5.1 EXECIO – Read and write data sets5.2 DELSTACK – delete data stack contents5.3 DROPBUF – Delete data stack buffers5.4 TSO Commands
6 Execute REXX programs
6.1 Execution of programs in a TSO/ISPF environment6.1.1 Online execution6.1.2 Batch execution

7 Introduction to ISPF programming
7.1 Programming languages useable in ISPF7.2 ISPF programming objects7.3 Some typical examples7.3.1 Example for use of ISPF panels7.3.2 Example for use of skeletons7.3.3 Example for use of tables7.3.4 Example for use of ISPF variables7.3.5 Example for data processing with TSO and ISPF7.3.6 Output of messages with ISPF7.4 LIBDEF – Dynamic linking of ISPF libraries7.5 ALTLIB – Dynamic linking of EXEC libraries7.5.1 Search sequence in the procedures libraries7.5.2 The ALTLIB command in ISPF7.5.3 Stacking of the APPLICATION level ALTLIBs7.5.4 The QUIET operand of the ALTLIB DISPLAY command
8 Data set processing using ISPF
8.1 The LM services8.1.1 Grouping of LM services8.1.2 LMINIT – Start of the data set processing8.1.3 LMFREE – Free a data set8.1.4 LMOPEN – Open a data set for processing8.1.5 LMCLOSE – Close a data set8.1.6 LMMFIND – Localize a member8.1.7 LMMREP – Replace a member8.1.8 LMMADD – Add a member8.1.9 LMGET – Read a data records8.1.10 LMPUT – Output data records8.1.11 LMCOPY – Copy data8.1.12 LMMOVE – Move data8.1.13 LMMDEL – Delete members8.1.14 LMMREN – Rename members8.1.15 LMMSTATS – Display or change member statistics8.1.16 LMCOMP – Compress a PDS8.1.17 LMMLIST – Display a member list8.1.18 LMMDISP – Display and edit a member list8.1.19 LMDINIT – Initialize the LMDDISP service8.1.20 LMDDISP – Data set list service8.1.21 LMDLIST – List of data sets8.1.22 LMDFREE – Free a LISTID8.1.23 MEMLIST – member list dialog service8.2 Data set query services8.2.1 LMDLIST – Data set list service8.2.2 DSINFO – ISPF service which provides data set information8.2.3 LISTDSI – REXX function to list data set information8.2.4 QBASELIB – Query DSN information8.2.5 QLIBDEF – Query LIBDEF Information8.2.6 QUERYENQ – ENQs determination
9 Messages – Definition, setting, output
9.1 Error handling in ISPF9.1.1 Returning error messages9.1.2 Output of error messages9.1.3 SETMSG – Set next message9.1.4 Definition of ISPF messages9.1.5 Naming convention of the ISPF message IDs9.1.6 Definition of messages9.1.7 The standard message member ISRZ00
10 Panels – create and use
10.1 The Dynamic Tag Language (DTL)10.2 Panel types in ISPF10.3 Definition of panels10.3.1 The structure of a panel10.3.2 Creation of panels and their call10.3.3 The panel definition sections10.3.4 Variables in panel definitions10.3.5 Panel processing10.3.6 Help panels10.3.7 Panels to display ISPF tables
11 Skeletons – Design and use
11.1 Creating skeletons11.2 Steps to use the file-tailoring service
12 Tables – Create and edit
12.1 Locations for tables12.2 Reading ISPF tables12.3 Writing ISPF tables12.4 Commands of the table services12.5 Example of working with tables
13 Variables – Definition and using
13.1 Variables pools13.1.1 Function pool13.1.2 Shared pool13.1.3 Profile pool13.2 Saving the profile members13.3 Creating profile members13.4 Display of actually used profile member13.5 The System Profile Pool13.5.1 Frequently used ISPF variables13.5.2 Process ISPF variables
14 Edit macros – Create and apply
14.1 What is an edit macro?14.1.1 Naming conventions for edit macros14.1.2 Example of two very useful edit macros14.2 Table of edit macro commands14.3 Operands and abbreviations used in the edit macro commands14.4 Test aids in the creating macros14.4.1 Prototyping14.4.2 The REXX TRACE command as developing aid14.4.3 The program ISREMSPY14.5 System variables of the ISPF editor14.6 Passing parameters to macros14.7 Examples for editing and SUBMIT batch jobs14.8 Mnemonics for macro programming
15 The SMART ISPF utilities
15.1 Naming conventions15.2 The dynamic panel concept15.3 List of executable programs15.4 Program descriptions15.4.1 Edit macro ## – Execute a currently edited REXX procedure15.4.2 Edit macro #ALTXT – Realign line parts15.4.3 Edit macro #EDMEM – Edit of a member15.4.4 Edit macro #IMACROA – General ISPF edit macro15.4.5 Edit macro #IMACRO1 – Initial edit macro15.4.6 Edit macro #IMACRO2 – Edit session end macro15.4.7 Edit macro #ISPFB – Submit an ISPF batch job15.4.8 Edit macro #LCH – Perform long edit change commands15.4.9 Edit macro #SPLJ – SPLIT and JOIN lines15.4.10 Edit macro #SSS – Clear SCHFOR lists15.4.11 Edit macro #SSSCH – Mass update of members15.4.12 Edit macro #SU – Submit JCL without a JOB statement15.4.13 Edit macro #TSOB – Submit a TSO batch job15.4.14 Edit macro #VERASE – Erase ISPF profile variables15.4.15 Program SCURSOR – Calling a data set from an ISPF screen15.4.16 Program SDOC – Produce documentation members15.4.17 Program SLE – Display last edited data sets15.4.18 SLOGDSN – Data member containing DSNs for logon15.4.19 Program SLOGON – Personal logon procedure15.4.20 Program SPROFEDT – Store users ISPF profile variables15.4.21 SPROFVAR – Load user ISPF variables15.4.22 Program SSC – Super clone for data sets15.4.23 Program SSS – Perform a Super-Search15.5 Programming aids15.5.1 Edit macro #C – Compile and execute a REXX program15.5.2 Edit macro #RO – Online compile of a REXX program15.5.3 Edit macro #RC – Compile a REXX procedure with a batch job15.5.4 Edit macro #RCLOAD – Produce a load or a call module15.5.5 Edit macro #IE – Insert a call to ISPF_ERROR15.5.6 Subroutine ISPF_ERROR – Display ISPF error messages15.5.7 Edit macro #PAN – Execute a panel source code15.5.8 Subroutine DAYDIFF – Calculate number of days15.5.9 Subroutine ENDDAY – Calculate a target date15.5.10 Subroutine JULDATE – Translate a date to Julian and vise versa15.5.11 Subroutine LEAPYEAR – Return the leap year information15.5.12 REXX subroutine SCHANGE – REXX change function15.5.13 Program SDYNPAN – Convert a panel source code15.6 Installation of SMART ISPF utilities15.6.1 Download and unzip15.6.2 Installation15.6.3 ALTLIB command15.6.4 Make the SMART ISPF utilities ready to run
List of programs
List of tables
List of screens
Bibliography
Index

Content preview from ISPF Programmer’s Guide

5The TSO/E REXX commands

In addition to the normal TSO commands, there are some commands that execute the TSO/E specifically for REXX. These commands are like all TSO commands, using literals to send them to the TSO. Some of these commands are only executable when called up from a REXX procedure. I would like to present the most important commands here.

Note

In REXX on other platforms, these commands are not available. For example, the EXECIO command is not available in OOREXX. This is really a deficit of OOREXX!

5.1EXECIO – Read and write data sets

This is the most widely used TSO/E REXX command. EXECIO uses the QSAM method of z/OS. This means ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 9783110407655

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

ISPF Programmer’s Guide

by Franz Lanz