Interactive System Productivity Facility (ISPF)

ISPF Hidden Treasures

and New Features

SHARE 116
Sessions 8674 & 8675

Peter Van Dyke

IBM Australia
SHARE 116, Winter 2011
[email protected]
© 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Hidden Treasures and New Features in ISPF

ƒData Set List
•DSLIST Command
•Recent Enhancements

ƒMember List
•Recent Enhancements

ƒEdit
•COMPARE Command
•Recent Enhancements

ƒConnect Without GUI

ƒz/OS UNIX Support

•Directory List Utility
•Edit and Browse
•ASCII Edit
•UDLIST Command

2 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 1
 Interactive Program Development Facility (ISPF)

Hidden Treasures and New Features in ISPF…

ƒMultiple Screen Support
•SWAPBAR

ƒDisplay System & User Id

ƒISPF Client Gateway – ISPF from the Internet

ƒISRDDN Utility

ƒUser Command Tables

•ISPF Table Utility

ƒAutotype Function

ƒISRDTLCV macro

ƒCalendar with Notebook

3 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

DSLIST
ƒDSLIST personal_list_name | pattern
• If a list name exists by that name, a data set list will be built based on
the entries in the list
• If a list name does not exist, the parameter is treated as a pattern

ƒAPPEND command from within Data Set List

• Adds entries to the displayed list
• specify a personal list name or a pattern

ƒREFRESH command from within Data Set List

• Refreshes display to original list filter criteria

ƒEXCLUDE command and X line command from within Data Set List
• Excludes data sets displayed in list
• Shadow line displayed

4 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 2
 Interactive Program Development Facility (ISPF)

New Data Set List Commands - z/OS 1.2

ƒMEMBER command
• allows the partitioned data sets in the list to be searched for a
specific member name or pattern
• Syntax: Member string [X|EX|NX][RECALL1|RECALL2]
• Message field identifies data sets containing the member(s)

ƒSRCHFOR command
• Invokes SuperC to search the listed data sets for strings
• Syntax: SRCHFOR [string]
• Displays panel used to specifying options for SuperC
• Message field identifies data sets containing the string
• SuperC output written to data set
(default: userid.SRCHDSL.LIST)

5 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Data Set List Enhancements

ƒEnhanced SORT command (z/OS 1.7)
• Provides ability to sort a data set list in ascending or descending
order
• Syntax: SORT major-field [A|D] [minor-field] [A|D]

ƒDisplay Total Tracks Value (z/OS 1.9)

• New Display Total Tracks option added to the Data Set List Utility
entry panel
• If selected, an additional header line showing the total tracks used by
the data sets is displayed with the Space and Total views
• Pop-up window showing data collection progress displayed when
calculating total tracks for a list of 50 or more data sets

6 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 3
 Interactive Program Development Facility (ISPF)

Data Set List Enhancements. . .

ƒBlock Line Commands (z/OS 1.10)
• Allows Data Set List line commands to be entered in blocks
• A block of line commands is marked by entering two forward slash
characters (//) at the start and end of the block
• The required line command is entered on the first or last line of the
block, immediately following the two forward slash characters
• All line commands, including TSO commands, Clists and REXX
execs can be executed as block commands

ƒInclude PREFIX in Dsname Level (z/OS 1.11)

• New Prefix Dsname Level option added to the Data Set List Utility
entry panel
• If selected, ISPF will add the TSO prefix (if the user’s TSO profile has
PREFIX defined) as the first qualifier if the Dsname Level entered is
not enclosed in quotes

7 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

New Member List Commands - z/OS 1.5

ƒSRCHFOR command
• Invokes SuperC to search the listed members for strings
• Syntax: SRCHFOR [string]
• Displays panel used to specifying options for SuperC
• PROMPT column identifies members containing the string
• SuperC output written to data set
(default: userid.SRCHML.LIST)

ƒSORT PROMPT command

• Sorts members with messages in the PROMPT column to the top of
the member list
• Use after SRCHFOR command to group all members containing
string at the top of the member list

8 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 4
 Interactive Program Development Facility (ISPF)

Member List Enhancements

ƒEnhanced SORT command (z/OS 1.7)
• Provides ability to sort a data set list in ascending or descending
order
• Syntax: SORT major-field [A|D] [minor-field] [A|D]

ƒNew FILTER command (z/OS 1.8)

• Used to display only those members having an attribute matching a
specified value
• Syntax: FILTER [field operator value]
field member list column name
operator EQ, NE, LE, LT, GE, or GT
value the comparison value
• Member List SRCHFOR command also enhanced to optionally
display only those members containing the SRCHFOR string

9 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Edit COMPARE Command

ƒSyntax: COMPARE [member|data_set_name|NEXT|* [X] [SYSIN]]
ƒUses SuperC APIs to compare to data sets or members
ƒChanges are highlighted depending on if the change is new to the source (member
or data set where COMPARE command was issued), only in the target, or common
ƒNEXT compares next member in hierarchy of ISPF library
ƒX excludes common lines except for a few around differences
ƒSYSIN DD has additional SuperC Process Statements
only in "target"
(NEXT in this case)
MD to "make data"

new in "source"

common

common lines
excluded by X
parameter

10 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 5
 Interactive Program Development Facility (ISPF)

Edit COMPARE Enhancement (z/OS 1.11)

ƒThe SYSIN keyword on the COMPARE command is enhanced to support
a sub-parameter

• User can specify the SuperC process statements data set name as a
sub-parameter of the SYSIN keyword

Syntax: SYSIN(dsn)

• Alternatively, the user can request the display of a pop-up panel

where the SuperC process statements data set name can be entered

Syntax: SYSIN(/)

11 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

New Edit Primary Commands - z/OS 1.6

ƒHIDE command
• Removes excluded line messages from the Edit/View display
• Line number underscored to indicate "hidden" line(s)
• Syntax: HIDE X
• RESET primary command has HIDE option to allow redisplay of
excluded line messages
–Syntax: RESET HIDE

ƒCOLS command
• Causes a columns line to be displayed at the top of each Edit/View
data screen (i.e. stays with the Edit/View display)
• Syntax: COLS [ON|OFF]

12 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 6
 Interactive Program Development Facility (ISPF)

Other Edit Enhancements

ƒUNDO after SAVE (z/OS 1.9)
• Allows reversal of edit changes made prior to SAVE commands during the current
edit session

• New KEEP option added to the edit SETUNDO command

•Syntax:

+-STORAGE-+
>>----SETUNDO----+---------+---------------><
+-SETU----+ +-RECOVER-|
+-ON------|
+-OFF-----|
+-KEEP----+

•Where:

KEEP Has the same effect as STORAGE and also prevents the
SAVE command from clearing the UNDO buffers in
storage

13 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Other Edit Enhancements. . .

ƒMultiple Targets for MOVE/COPY (z/OS 1.10)
• Suffix of K (keep) can now be used with MOVE/COPY destination line commands A,
B, O and OO

–Enter AK, BK, OK, or OOK line commands to indicate a multiple target
MOVE/COPY command

–Enter ‘final’ destination line command (A, B, O or OO) to initiate the ‘multiple
target’ MOVE/COPY

–‘Final’ destination must be after the line where the AK, BK, OK, or OOK
command was entered

14 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 7
 Interactive Program Development Facility (ISPF)

Other Edit Enhancements. . .

ƒNew Edit Line Commands for HEX Display (z/OS 1.11)
• New edit line commands to display selected lines in hexadecimal format:

HX display a single line in hexadecimal format

HXX display a block of lines in hexadecimal format

• The HX and HXX line commands act as a toggle by switching a line’s display
format between normal and hexadecimal format

15 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Connect Without GUI

ƒSETTINGS
• Workstation pulldown (or GUIINIT)
–Workstation connection
–Without GUI display

• Allows workstation commands

–FILEXFER
–Edit on workstation
–SELECT WSCMD

16 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 8
 Interactive Program Development Facility (ISPF)

z/OS UNIX Directory List Utility (z/OS 1.8)

ƒAvailable as ISPF option 3.17
ƒProvides most of the functions supported by the ISHELL utility

17 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

z/OS UNIX Directory List Utility. . .

ƒHorizontal scrolling via the RIGHT and LEFT primary commands
ƒColumn order and size can be customized via Options pull-down

18 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 9
 Interactive Program Development Facility (ISPF)

z/OS UNIX Directory List Utility. . .

ƒ Primary commands available:

• EDIT - edit a file in the current directory
• FIND - find a string within a filename
• LEFT - scroll the directory list columns to the left
• LOCATE - locate a directory list entry based on the sort order
• REFRESH - redisplay directory list with any changes that have occurred
• RESET - redisplay list removing line commands and messages
• RIGHT - scroll the directory list columns to the right
• SAVE - write the directory list data to a data set
• SORT - sort the directory list by the specified fields

19 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

z/OS UNIX Directory List Utility. . .

ƒ Line commands available:

ƒ E - edit a file ƒ CO - copy data out
ƒ B - browse a file ƒ CI - copy data in
ƒ N - create a new file ƒ I - display attributes
ƒ L - list a directory ƒ MM - modify mode fields
ƒ D - delete a file ƒ MX - modify extended attributes
ƒ R - rename a file ƒ X - execute a command
ƒ V - view a file (z/OS 1.9) ƒ MO - Modify Owner (z/OS 1.11)
ƒ EA - ASCII edit (z/OS 1.9) ƒ MG - Modify Group (z/OS 1.11)
ƒ VA - ASCII view (z/OS 1.9) ƒ MF - Modify Format (z/OS 1.11)
ƒ RA - REFLIST Add (z/OS 1.10) ƒ UA - User Auditing (z/OS 1.11)
ƒ FS - File System (z/OS 1.11) ƒ AA - Auditor Auditing (z/OS 1.11)

20 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 10
 Interactive Program Development Facility (ISPF)

z/OS UNIX Support Enhancements. . .

ƒUse ISPF Edit and Browse for z/OS UNIX Files (z/OS 1.9)
• Edit/View/Browse “Other” Data Set Name fields support entry of z/OS UNIX
pathnames
•z/OS UNIX Directory List displayed when pathname for directory entered in the
“Other” Data Set Name field
• z/OS UNIX pathname can be specified as an operand with the following edit primary
and macro commands
–COMPARE
–COPY
–CREATE
–MOVE
–REPLACE
• BROWSE, EDIT, and VIEW services enhanced to support processing of z/OS UNIX
files
• FILEXFER service enhanced to support the upload and download of z/OS UNIX
regular files
• Personal data set lists enhanced to support the saving and retrieval of z/OS UNIX
pathnames

21 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

z/OS UNIX Support Enhancements. . .

ƒSupport for Editing ASCII Data (z/OS 1.9)
• ASCII edit automatically invoked for z/OS UNIX files tagged with CCSID 819 (US
ASCII)

• ASCII edit can be selected for z/OS UNIX files not tagged by either:
–Selecting the Edit ASCII data option on the Edit/View Entry panel
–Using the z/OS UNIX Directory List Utility (option 3.17) EA line command

• File tagged with CCSID of 819 when saved

• ASCII edit available with the EDIT and VIEW services by using the new ASCII
keyword parameter

22 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 11
 Interactive Program Development Facility (ISPF)

New UDLIST Command – z/OS 1.10

ƒUsed to display a z/OS UNIX Directory List (option 3.17) from any command
line
Syntax: UDLIST [personal_list_name | pathname]
• If a personal list name is provided, a directory list will be built based on the
pathname entries in the list
• Alternatively, the pathname for a directory can be specified
–but most command lines are CAPS(ON) – cannot enter mixed-case
pathnames
• If no parameter is specified with the UDLIST command a popup displays:

• Popup allows user to:

–enter a mixed-case pathname
–select a personal list

23 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Directory List Enhancements – z/OS 1.11

ƒz/OS UNIX commands can be entered in the command field on the z/OS UNIX
Directory List panel
• Requires option “Enter z/OS UNIX commands in Command field” to be
selected on the directory list options panel
• Entering a / (forward slash) in the command field displays a panel with a
command field 255 characters in length

ƒDefault line commands can be defined for different file types

• Default line command is processed when the cursor is placed in the line
command field and the ENTER key is pressed
• IBM-supplied default line commands:
Directory L (List)
Regular file B (Browse)
Character special I
FIFO I
Symbolic link I
• User can change default line commands on the “z/OS UNIX Directory
List Default Line Commands” panel available from the Options pull-
down

24 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 12
 Interactive Program Development Facility (ISPF)

Using Multiple Screens

ƒISPF allows up to 32 synchronously multi-tasking screens under one
ISPF session

ƒCreate new logical screens using:

• SPLIT [NEW] command
–reposition horizontal line separating 2 screens on 3270 display
–new logical screen created when NEW specified
• START command
–creates new logical screen with different "initial dialog"
START PANEL(panel)|PGM(program)|CMD(command)
[select_parameters]
| ISPF_command
| primary_option_menu_option

ƒNavigate screens using:

• SWAP [LIST | PREV | NEXT | screen name | n]
command
• ISPF Task List panel (invoked using SWAP LIST command)

25 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

ISPF Task List - Swap List Command

Screen names Panelid and Applid

"Other"
screen

Current
screen

26 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 13
 Interactive Program Development Facility (ISPF)

SWAPBAR – z/OS 1.10

ƒ Simplifies the task of swapping between ISPF logical screens

ƒ Displays at the bottom of the physical screen point-and-shoot fields

associated with each logical screen for the session
• Use the point-and-shoot field to invoke the associated logical
screen
Tip: Customize your terminal emulator to make the action of
clicking the mouse to simulate:
1) placing the cursor
2) Pressing the ENTER key

ƒ Enabled using the new SWAPBAR system command

Syntax: SWAPBAR [ON|OFF]

27 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Display System and User Id – z/OS 1.7

ƒNew ISPF command provided which allow the system name and/or user
ID to be displayed on all ISPF panels

• SYSNAME [ON|OFF] - Display | Remove system name

• USERID [ON|OFF] - Display | Remove user ID

28 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 14
 Interactive Program Development Facility (ISPF)

ISPF Client Gateway - ISPF from the Internet

ƒThe Gateway provides an interface for client (and z/OS UNIX)
applications to run TSO and ISPF commands and services

ƒRuns in z/OS UNIX and is invoked upon a request for a TSO or ISPF
command
• TSO address space established
• If an ISPF command is requested
–ISPF data sets are allocated and an ISPF session is established

ƒCommand requests and command output in XML format

ƒGateway IVP provides a web page for entering TSO and ISPF commands
–/usr/lpp/ispf/bin/ISPZIVP.html
–/usr/lpp/ispf/bin/ISPZIVP.cgi

ƒShipped with z/OS 1.10

• Backfitted to z/OS 1.8 and 1.9 (APAR OA27190)

29 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

ISRDDN Utility
ƒFullscreen display of DD allocations
ƒBuild a member list based on a DD
ƒInvocation: SELECT PGM(ISRDDN) - DDLIST command

ƒBrowse (B), Edit (E), View (V), Free the entire DD (F), Compress a PDS
(C), Provide additional data set information (I), Display list of users of jobs
using a data set (Q)
30 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 15
 Interactive Program Development Facility (ISPF)

ISRDDN - Primary Commands

ƒ MEMBER name [string]
• scans allocations for a particular member
• string restricts the search to DDs with string in their name.
• Uses CSVQUERY to locate load modules

ƒ ONLY string | EXCLUDE string

• to show or exclude DDs with string in their name
31 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

ISRDDN - Primary Commands...

ƒ SEARCH name
• Same as MEMBER but does not search DD's

ƒ LOAD name
• Explicitly loads a module
• Uses ISPLLIB if available
• Browses result

ƒ APF, LINKLIST (LI), PARMLIB, LPA (LP)

• toggle commands to add/remove pseudo-DD names
• show the defined -
–APF data sets
–link-list data sets
–PARMLIB data sets
–LPA data sets

32 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 16
 Interactive Program Development Facility (ISPF)

ISRDDN - Primary Commands...

ƒ CLIST
• creates a allocation CLIST in 'prefix.ISRDDN.CLIST'

ƒ COUNT [string]
• counts the number of members in PDSs

ƒ DUP
• searches all the PDSs in the displayed list and LPA
• displays list of duplicate names

ƒ ENQ
• Enqueues on system

ƒ CON
• Enqueue contention

33 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

ISRDDN - Browse of Control Blocks

ƒBROWSE STORAGE
• SEQUENTIAL FILE
– Allocated to DDNAME ISRDDN
– Fixed or VB
– Max length of 230
Š First string on line is control block name
– Second string is locator string
– Everything else ignored

ASCB CVT?+C? Addr space control blk

CVT 10.? Comm Vector Table
TCB CVT?? Task Control Block

ƒDisassembly support available with z/OS 1.9

NOTE: ISRDDN is now documented in the ISPF User's Guide Volume I

34 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 17
 Interactive Program Development Facility (ISPF)

User Command Tables

ƒISPF supports up to 3 user command tables (z/OS 1.5)
• APPLID for User command tables are defined in the ISPF
configuration table
• Searched before Site and System command tables

ƒMany sites now define USER as the APPLID for a User command table
• Speak to your systems programmer if your site does not
• Allows users to define their own ISPF commands
• User command table saved in a personal table data set in the
ISPTLIB DD concatenation

ƒCreating and updating user command tables

• Option 3.9 can be used to create a user command table
–Requires table data set allocated to the ISPTABL DD
• Option 3.9 cannot update a user command table if it is open to your
ISPF session
–Copy table to another member; use option 3.9 to update new
member; copy updated member back
–With z/OS 1.9, use option 3.16 (ISPF Table Utility)

35 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

AUTOTYPE Function - z/OS 1.2

ƒAUTOTYPE function resolves a partial name in a panel Library or
Other Data Set Name field
• searches catalog or PDS directory to find names that match

ƒMost effective when assigned to a PF key

ƒRetrieves a maximum of 100 data set names and 700 member names

ƒOnly available on panels enabled for AUTOTYPE

• applications can use AUTOTYPE by making minor panel changes
• DTL provides AUTOTYPE support

36 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 18
 Interactive Program Development Facility (ISPF)

ISRDTLCV Macro
ƒShipped in SISPEXEC library

ƒConverts the non-displayable characters in panel output from the DTL

Conversion Utility (ISPDTLC) to editable characters

ƒIssue ISRDTLCV on edit command line of generated panel

37 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Interactive Program Development Facility (ISPF)

Calendar Notebook

ƒ&ZKIT = LO
• Set in Primary Menu

• Allows TBDISPL dialog for Calendar view

–Keeps 15 lines of data for day selected
–Day is hilighted to indicate note

38 Hidden Treasures/New Features | Sessions 8674 & 8675 © 2011 IBM Corporation

Page 19