Interactive System Productivity Facility (ISPF)

Edit and Edit Macros z/OS Version 1 Release 8.0

SC34-4820-05

Interactive System Productivity Facility (ISPF)

Edit and Edit Macros z/OS Version 1 Release 8.0

SC34-4820-05

Note Before using this document, read the general information under Notices on page 417.

Sixth Edition (September 2006)

This edition applies to ISPF for Version 1 Release 8.0 of the licensed program z/OS (program number 5694-A01) and to all subsequent releases and modifications until otherwise indicated in new editions.

IBM welcomes your comments. A form for comments appears at the back of this publication. If the form has been removed and you have ISPF-specific comments, address your comments to:

IBM Corporation Reader Comments DTX/E269 555 Bailey Avenue San Jose, CA 95141-1003 U.S.A.

Internet: comments@us.ibm.com

If you would like a reply, be sure to include your name and your address, telephone number, e-mail address, or FAX number.

Make sure to include the following in your comment or note: v Title and order number of this document v Page number or topic related to your commentWhen you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

The ISPF development team maintains a site on the World Wide Web. The URL for the site is: http://www.ibm.com/software/awdtools/ispf/

Copyright International Business Machines Corporation 1984, 2006. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

http://www.ibm.com/software/awdtools/ispf/

Contents

Figures . . . . . . . . . . . . . . vii

Preface . . . . . . . . . . . . . . . ix About this document . . . . . . . . . . . ix Who should use this document . . . . . . . . ix How to read the syntax diagrams . . . . . . . ix Using LookAt to look up message explanations . . . x Using IBM Health Checker for z/OS . . . . . . xi

Whats in the z/OS V1R8.0 ISPF library? . . . . . . . . . . . . . . xiii

The ISPF user interface . . . . . . . xv Some terms you should know . . . . . . . . xv How to navigate in ISPF using the action bar interface . . . . . . . . . . . . . . . xvi

Action bars . . . . . . . . . . . . . xvi Command nesting . . . . . . . . . . xviii Action bar choices . . . . . . . . . . . xix Point-and-shoot text fields . . . . . . . . xx Function keys . . . . . . . . . . . . xx Selection fields . . . . . . . . . . . . xxi

Part 1. The ISPF Editor . . . . . . . 1

Chapter 1. Introducing the ISPF Editor . 3 What is ISPF? . . . . . . . . . . . . . . 3 What the ISPF editor does . . . . . . . . . . 3

Distributed editing . . . . . . . . . . . 4 Double-byte character set support . . . . . . 4

How to use the ISPF editor . . . . . . . . . 4 Beginning an edit session . . . . . . . . . 4 Using the ISPF editor basic functions . . . . . 12 Ending an edit session . . . . . . . . . . 12

Edit commands . . . . . . . . . . . . . 13 Line Commands . . . . . . . . . . . . 13 Primary commands . . . . . . . . . . . 14 Edit commands and PF key processing . . . . 14

Edit macros . . . . . . . . . . . . . . 15 Editing data in SCLM-controlled libraries . . . 16 Packing data . . . . . . . . . . . . . 16

Chapter 2. Controlling the Edit environment . . . . . . . . . . . . 17 What is an edit profile? . . . . . . . . . . 17

Using edit profile types . . . . . . . . . 17 Displaying or defining an edit profile . . . . . 17 Modifying an edit profile . . . . . . . . . 19 Locking an edit profile . . . . . . . . . 19

Edit modes . . . . . . . . . . . . . . 19 Edit profile modes . . . . . . . . . . . 20 Edit mode defaults . . . . . . . . . . . 21

Flagged lines . . . . . . . . . . . . . . 22

Changed Lines . . . . . . . . . . . . 22 Error Lines . . . . . . . . . . . . . 22 Special lines . . . . . . . . . . . . . 23

Edit boundaries . . . . . . . . . . . . . 23 Initial macros . . . . . . . . . . . . . . 25 Application-wide macros . . . . . . . . . . 26 Statistics for PDS members . . . . . . . . . 26

Effect of Stats mode when beginning an edit session . . . . . . . . . . . . . . . 26 Effect of Stats mode when saving data . . . . 26

Version and modification level numbers . . . . . 27 Sequence numbers . . . . . . . . . . . . 27

Sequence number format and modification level 27 Sequence number display . . . . . . . . . 28 Initialization of number mode . . . . . . . 28

Enhanced and language-sensitive edit coloring . . 29 Language support . . . . . . . . . . . 29 The HILITE command and dialog . . . . . . 34 Highlighting status and the edit profile . . . . 38

Edit recovery . . . . . . . . . . . . . . 39

Chapter 3. Managing Data . . . . . . 41 Creating and Replacing Data . . . . . . . . 41 Copying and Moving Data . . . . . . . . . 42 Shifting Data . . . . . . . . . . . . . . 42

Column Shift . . . . . . . . . . . . . 43 Data Shift . . . . . . . . . . . . . . 44

Finding, Seeking, Changing, and Excluding Data . . 45 Specifying the Search String . . . . . . . . 45 Effect of CHANGE Command on Column-Dependent Data . . . . . . . . . 48 Using the CHANGE Command With EBCDIC and DBCS Data . . . . . . . . . . . . 48 Controlling the Search . . . . . . . . . . 49 Qualifying the Search String . . . . . . . . 50 Limiting the Search to Specified Columns . . . 51 Split Screen Limitations . . . . . . . . . 51 Limiting the Search to Excluded or Non-Excluded Lines . . . . . . . . . . 51 Using the X (Exclude) Line Command with FIND and CHANGE . . . . . . . . . . . . 51 Repeating the FIND, CHANGE, and EXCLUDE Commands . . . . . . . . . . . . . 52 Examples . . . . . . . . . . . . . . 52

Excluding Lines . . . . . . . . . . . . . 55 Hiding Excluded Lines . . . . . . . . . 55 Redisplaying Excluded Lines . . . . . . . 55 Redisplaying a Range of Lines . . . . . . . 56

Labels and Line Ranges . . . . . . . . . . 56 Editor-Assigned Labels . . . . . . . . . 57 Specifying a Range . . . . . . . . . . . 57 Using Labels and Line Ranges . . . . . . . 58

Word Processing . . . . . . . . . . . . . 58 Formatting Paragraphs . . . . . . . . . 58 Splitting Lines . . . . . . . . . . . . 60

Copyright IBM Corp. 1984, 2006 iii

Entering Text (Power Typing) . . . . . . . 60 Using Tabs . . . . . . . . . . . . . . 61

Types of Tabs . . . . . . . . . . . . . 61 Defining and Controlling Tabs . . . . . . . 62 Defining Software Tab Positions . . . . . . 62 Defining Hardware Tab Positions . . . . . . 63 Using Attribute Bytes . . . . . . . . . . 64

Undoing Edit Interactions . . . . . . . . . 64 UNDO Processing . . . . . . . . . . . 65 Understanding Differences in SETUNDO Processing . . . . . . . . . . . . . . 66

Chapter 4. Using Edit Models . . . . . 67 What Is an Edit Model? . . . . . . . . . . 67 How Models Are Organized . . . . . . . . . 67 How to Use Edit Models . . . . . . . . . . 69 Adding, Finding, Changing, and Deleting Models 70

Adding Models . . . . . . . . . . . . 70 Finding Models . . . . . . . . . . . . 73 Changing Models . . . . . . . . . . . 74 Deleting Models . . . . . . . . . . . . 74

Part 2. Edit Macros . . . . . . . . 75

Chapter 5. Using Edit Macros . . . . . 77 What Are Edit Macros? . . . . . . . . . . 77

Performing Repeated Tasks . . . . . . . . 77 Simplifying Complex Tasks . . . . . . . . 79 Passing Parameters, and Retrieving and Returning Information . . . . . . . . . . 80

Chapter 6. Creating Edit Macros . . . . 83 CLIST and REXX Edit Macros . . . . . . . . 83

Edit Macro Commands and Assignment Statements . . . . . . . . . . . . . . 84 Command Procedure Statements . . . . . . 84 ISPF and PDF Dialog Service Requests . . . . 85 TSO Commands . . . . . . . . . . . . 85

Program Macros . . . . . . . . . . . . . 85 Differences between Program Macros, CLISTs, and REXX EXECs . . . . . . . . . . . 86 Passing Parameters in a Program Macro . . . . 86 Program Macro Examples . . . . . . . . 86 Writing Program Macros . . . . . . . . . 87 Running Program Macros . . . . . . . . 90

Using Commands in Edit Macros . . . . . . . 91 Naming Edit Macros . . . . . . . . . . 91 Variables . . . . . . . . . . . . . . 91 Edit Assignment Statements . . . . . . . . 92 Performing Line Command Functions . . . . 96 Parameters . . . . . . . . . . . . . 97 Passing Parameters to a Macro . . . . . . . 97 Using Edit Macros in Batch . . . . . . . . 99 Edit Macro Messages . . . . . . . . . . 99 Macro Levels . . . . . . . . . . . . . 99 Labels in Edit Macros . . . . . . . . . 100 Referring to Data Lines . . . . . . . . . 102 Referring to Column Positions . . . . . . . 102 Defining Macros . . . . . . . . . . . 103 Using the PROCESS Command and Operand 104

Recovery Macros . . . . . . . . . . . 106 Return Codes from User-Written Edit Macros . .