Table of Contents (exploded view)
Edition notice
Abstract for ISPF Edit and Edit Macros
Where to find more information
Summary of changes
Summary of changes for z/OS Version 2 Release 2 (V2R2)
Summary of changes for z/OS Version 2 Release 1 (V2R1)
The ISPF editor
Introducing the ISPF editor
What is ISPF?
What the ISPF editor does
Distributed editing
Double-byte character set support
How to use the ISPF editor
Beginning an edit session
Edit entry panel action bar
Edit entry panel fields
Creating a new data set
Editing an existing data set
Primary Edit panel action bar choices
Editing the data set
Using the ISPF editor basic functions
Ending an edit session
Edit commands
Line commands
Primary commands
Edit commands and PF key processing
Edit macros
Primary command macros
Line command macros
Editing data in SCLM-controlled libraries
Packing data
Specifying z/OS UNIX pathnames with edit primary and macro commands
Controlling the edit environment
What is an edit profile?
Using edit profile types
Displaying or defining an edit profile
Modifying an edit profile
Locking an edit profile
Edit modes
Edit profile modes
Edit mode defaults
Site-wide Edit Profile Initialization
Creating a ZDEFAULT edit profile
Flagged lines
Changed lines
Error lines
Special lines
Edit boundaries
Initial macros
Application-wide macros
Statistics for PDS members
Effect of Stats mode when beginning an edit session
Effect of Stats mode when saving data
Version and modification level numbers
Sequence numbers
Sequence number format and modification level
Sequence number display
Initialization of number mode
Enhanced and language-sensitive edit coloring
Language support
Automatic language selection
Language processing limitations and idiosyncracies
Recognized special symbols
Assembler
BookMaster
C
COBOL
DTL, HTML, and XML
Panels and skeletons
JCL
PL/I
REXX
SuperC
Other
The HILITE command and dialog
The HILITE dialog
HILITE initial panel action bar
Set Uvertype, Find String, Cursor Phrase Color action bars
Edit Color Settings action bar
Language Keyword List action bar
Highlighting status and the edit profile
Edit recovery
Managing data
Creating and replacing data
Copying and moving data
Shifting data
Column shift
Column shifting in lines that contain DBCS strings
Data shift
Finding, seeking, changing, and excluding data
Specifying the search string
Simple and delimited strings
Character strings
Picture strings (string, string1)
Picture string examples
Picture strings (string2)
Picture string examples
Regular expressions (string, string1)
Effect of CHANGE command on column-dependent data
Using the CHANGE command with EBCDIC and DBCS data
Working with ASCII data
Restructuring data based on the linefeed character
Working with UTF-8 data
Restructuring data based on the linefeed character
Controlling the search
Extent of the search
Starting point and direction of the search
Qualifying the search string
Limiting the search to specified columns
Split screen limitations
Limiting the search to excluded or non-excluded lines
Using the X (Exclude) line command with FIND and CHANGE
Repeating the FIND, CHANGE, and EXCLUDE commands
Examples
FIND command example
CHANGE command example
EXCLUDE command example
Excluding lines
Hiding excluded lines
Redisplaying excluded lines
Redisplaying a range of lines
Labels and line ranges
Editor-assigned labels
Specifying a range
Using labels and line ranges
Word processing
Formatting paragraphs
Using text flow on a DBCS terminal
Splitting lines
Splitting lines within a DBCS string
Entering text (power typing)
Entering text on a DBCS terminal
Using tabs
Types of tabs
Software and hardware tabs
Logical tabs
Effect of TABS commands on tab types
Defining and controlling tabs
Defining software tab positions
Defining hardware tab positions
Limiting the size of hardware tab columns
Using attribute bytes
Undoing edit interactions
UNDO processing
Understanding differences in SETUNDO processing
Using edit models
What is an edit model?
How models are organized
How to use edit models
Adding, finding, changing, and deleting models
Adding models
Finding models
Changing models
Deleting models
Edit macros
Using edit macros
What are edit macros?
Performing repeated tasks
Simplifying complex tasks
Passing parameters, and retrieving and returning information
Working with an edit line command table
Creating edit macros
CLIST and REXX edit macros
Edit macro commands and assignment statements
Using the REXX ADDRESS instruction
Command procedure statements
ISPF and PDF dialog service requests
TSO commands
Program macros
Differences between program macros, CLISTs, and REXX EXECs
Passing parameters in a program macro
Program macro examples
Writing program macros
Running program macros
Using commands in edit macros
Naming edit macros
Variables
Variable substitution
Character conversion
Edit assignment statements
Value
Keyphrase
Keyphrase syntax
Overlays and templates
Using edit assignment statements
Passing values
Manipulating data with edit assignment statements
Differences between edit, CLIST, and REXX assignment statements
Performing line command functions
Parameters
Passing parameters to a macro
Using edit macros in batch
Edit macro messages
Macro levels
Labels in edit macros
Using labels
Referring to labels
Passing labels
Referring to data lines
Referring to column positions
Defining macros
Defining an alias
Resetting definitions
Replacing built-in commands
Implicit definitions
Using the PROCESS command and operand
Using the PROCESS command with edit line macros
Specifying NOPROCESS in the macro statement
Specifying a destination
Specifying a range
Example
Recovery macros
Return codes from user-written edit macros
Return codes from PDF edit macro commands
Selecting control for errors
Testing edit macros
Handling errors
Edit command errors
Dialog service errors
Using CLIST WRITE statements and REXX SAY statements
Using CLIST CONTROL and REXX TRACE statements
Experimenting with macro commands
Debugging edit macros with ISREMSPY
Sample edit macros
ISRBOX macro
ISRIMBED macro
ISRMBRS macro
ISRCHGS macro
ISRMASK macro
Command reference
Edit line commands
Rules for entering line commands
Line command summary
(—Column Shift Left
)—Column Shift Right
<—Data Shift Left
>—Data Shift Right
A, AK—Specify an After destination
B, BK—Specify a Before destination
BOUNDS—Define Boundary Columns
C—Copy Lines
COLS—Identify Columns
D—Delete Lines
F—Show the First Line
HX—Show data in hexadecimal format
I—Insert Lines
L—Show the Last Line(s)
LC—Convert Characters to Lowercase
M—Move Lines
MASK—Define Masks
MD—Make Dataline
O, OK—Overlay Lines
R—Repeat Lines
S—Show Lines
TABS—Control Tabs
TE—Text Entry
TF—Text Flow
TS—Text Split
UC—Convert Characters to Uppercase
X—Exclude Lines
Edit primary commands
Edit primary command summary
AUTOLIST—Create a Source Listing Automatically
AUTONUM—Number Lines Automatically
AUTOSAVE—Save Data Automatically
BOUNDS—Control the Edit Boundaries
BROWSE—Browse from within an Edit Session
BUILTIN—Process a Built-In Command
CANCEL—Cancel Edit Changes
CAPS—Control Automatic Character Conversion
CHANGE—Change a Data String
COLS—Display Fixed Columns Line
COMPARE—Edit Compare
COPY—Copy Data
CREATE—Create Data
CUT—Cut and Save Lines
DEFINE—Define a Name
DELETE—Delete Lines
EDIT—Edit from within an Edit Session
EDITSET—Display the Editor Settings Dialog
END—End the Edit Session
EXCLUDE—Exclude Lines from the Display
FIND—Find a Data String
FLIP—Reverse Exclude Status of Lines
HEX—Display Hexadecimal Characters
HIDE—Hide Excluded Lines Message
HILITE—Enhanced Edit Coloring
IMACRO—Specify an Initial Macro
LEVEL—Specify the Modification Level Number
LF—realign data on the ASCII linefeed character
LOCATE—Locate a Line
MODEL—Copy a Model into the Current Data Set
MOVE—Move Data
NONUMBER—Turn Off Number Mode
NOTES—Display Model Notes
NULLS—Control Null Spaces
NUMBER—Generate Sequence Numbers
PACK—Compress Data
PASTE—Move or Copy Lines from Clipboard
PRESERVE—Enable Saving of Trailing Blanks
PROFILE—Control and Display Your Profile
RCHANGE—Repeat a Change
RECOVERY—Control Edit Recovery
RENUM—Renumber Data Set Lines
REPLACE—Replace Data
RESET—Reset the Data Display
RFIND—Repeat Find
RMACRO—Specify a Recovery Macro
SAVE—Save the Current Data
SETUNDO—Set the UNDO Mode
SORT—Sort Data
SOURCE—describe format of data
STATS—Generate Library Statistics
SUBMIT—Submit Data for Batch Processing
TABS—Define Tabs
UNDO—Reverse Last Edit Interaction
UNNUMBER—Remove Sequence Numbers
VERSION—Control the Version Number
VIEW—View from within an Edit Session
Edit macro commands and assignment statements
Edit macro command summary
AUTOLIST—Set or Query Autolist Mode
AUTONUM—Set or Query Autonum Mode
AUTOSAVE—Set or Query Autosave Mode
BLKSIZE—Query the Block Size
BOUNDS—Set or Query the Edit Boundaries
BROWSE—Browse from within an Edit Session
BUILTIN—Process a Built-In Command
CANCEL—Cancel Edit Changes
CAPS—Set or Query Caps Mode
CHANGE—Change a Search String
CHANGE_COUNTS—Query Change Counts
COMPARE—Edit Compare
COPY—Copy Data
CREATE—Create a Data Set or a Data Set Member
CURSOR—Set or Query the Cursor Position
CUT—Cut and Save Lines
DATA_CHANGED—Query the Data Changed Status
DATA_WIDTH—Query Data Width
DATAID—Query Data ID
DATASET—Query the Current and Original Data Set Names
DEFINE—Define a Name
DELETE—Delete Lines
DISPLAY_COLS—Query Display Columns
DISPLAY_LINES—Query Display Lines
DOWN—Scroll Down
EDIT—Edit from within an Edit Session
END—End the Edit Session
EXCLUDE—Exclude Lines from the Display
EXCLUDE_COUNTS—Query Exclude Counts
FIND—Find a Search String
FIND_COUNTS—Query Find Counts
FLIP—Reverse Exclude Status of Lines
FLOW_COUNTS—Query Flow Counts
HEX—Set or Query Hexadecimal Mode
HIDE—Hide Excluded Lines Message
HILITE—Enhanced Edit Coloring
IMACRO—Set or Query an Initial Macro
INSERT—Prepare Display for Data Insertion
LF—realign the data based on the ASCII linefeed character
LABEL—Set or Query a Line Label
LEFT—Scroll Left
LEVEL—Set or Query the Modification Level Number
LINE—Set or Query a Line from the Data Set
LINE_AFTER—Add a Line to the Current Data Set
LINE_BEFORE—Add a Line to the Current Data Set
LINE_STATUS—Query Source and Change Information for a Line in a Data Set
LINENUM—Query the Line Number of a Labeled Line
LOCATE—Locate a Line
LRECL—Query the Logical Record Length
MACRO—Identify an Edit Macro
MACRO_LEVEL—Query the Macro Nesting Level
MACRO_MSG—Set or Query the Macro Message switch
MASKLINE—Set or Query the Mask Line
MEMBER—Query the Current Member Name
MEND—End a Macro in the Batch Environment
MODEL—Copy a Model into the Current Data Set
MOVE— Move a Data Set or a Data Set Member
NONUMBER—Turn Off Number Mode
NOTES—Set or Query Note Mode
NULLS—Set or Query Nulls Mode
NUMBER—Set or Query Number Mode
PACK—Set or Query Pack Mode
PASTE—Move or Copy Lines from Clipboard
PRESERVE—Enable Saving of Trailing Blanks
PROCESS—Process Line Commands
PROFILE—Set or Query the Current Profile
RANGE_CMD—Query a Command That You Entered
RCHANGE—Repeat a Change
RECFM—Query the Record Format
RECOVERY—Set or Query Recovery Mode
RENUM—Renumber Data Set Lines
REPLACE—Replace a Data Set or Data Set Member
RESET—Reset the Data Display
RFIND—Repeat Find
RIGHT—Scroll Right
RMACRO—Set or Query the Recovery Macro
SAVE—Save the Current Data
SAVE_LENGTH—Set or Query Length for Variable-Length Data
SCAN—Set Command Scan Mode
SEEK—Seek a Data String, Positioning the Cursor
SEEK_COUNTS—Query Seek Counts
SESSION—Query Session Type
SETUNDO—Set UNDO Mode
SHIFT (—Shift Columns Left
SHIFT )—Shift Columns Right
SHIFT <—Shift Data Left
SHIFT >—Shift Data Right
SORT—Sort Data
SOURCE—describe format of data
STATS—Set or Query Stats Mode
SUBMIT—Submit Data for Batch Processing
TABS—Set or Query Tabs Mode
TABSLINE—Set or Query Tabs Line
TENTER—Set Up Panel for Text Entry
TFLOW—Text Flow a Paragraph
TSPLIT—Text Split a Line
UNNUMBER—Remove Sequence Numbers
UP—Scroll Up
USER_STATE—Save or Restore User State
VERSION—Set or Query Version Number
VIEW—View from within an Edit Session
VOLUME—Query Volume Information
XSTATUS—Set or Query Exclude Status of a Line
Abbreviations for Commands and Other Values
Edit line commands
Edit primary commands
Parameters
Keywords/Operands
Scroll amounts
Edit-related sample macros
Index