IBM Support

How to start Edit from the ISPF command line.

How To


Summary

If you want to edit a data set without leaving the panel you are working on, you can use the EPDF primary command.

Steps

Member ISREPDF in the 'ISP.SISPEXEC' library gives you a command line interface to Edit, View, and Browse. The ISPF command table, ISPCMDS, is shipped with the following entry:

Verb      T  Action                                               
EPDF      0  SELECT CMD(%ISREPDF &ZPARM) NEWAPPL(ISR) SUSPEND

With the command table in use, you can use the following syntax to invoke ISREPDF from any ISPF command line:

EPDF dataset-name <options>

Options include:

Browse Invoke Browse instead of Edit
View Invoke View instead of Edit
Macro xxx  Invoke the editor with the initial macro specified by xxx.
Profile yyy  Invoke the editor with the edit profile specified by yyy.
PAnel nnn Use alternate panel name specified by nnn.
Recover  If a recovery is pending, perform the edit recovery. If recovery is pending, the dataset-name and the macro option are ignored. If no edit recovery session is pending, then the data set is edited as usual.
Format zzz  Invoke the editor with the format table specified by zzz.
MIxed Yes|No Yes to edit unformatted mixed data, which contains both EBCDIC (one-byte) characters and Double Byte Character Set (DBCS or two-byte) characters on terminals that support double byte characters
PREserve Preserve original record length as the minimum length for the record
Confirm Yes|No Yes to confirm Cancel, Move, or Replace commands

Parameters can be abbreviated to the characters in capital letters.

Here are some examples:

  • To edit member TESTMEM in the PDS 'TESTPDS.CLIST', on the ISPF command line, type

EPDF 'TESTPDS.CLIST(TESTMEM)'

  • To edit a vb (variable blocked) sequential data set called prefix.AMB.INPUT, on the ISPF command line, type:

EPDF AMB.INPUT PRESERVE CONFIRM YES    

The preserve option ensures that the record length is preserved. If CANCEL, MOVE, or REPLACE are entered in the edit session, the confirm option ensures a confirmation panel displays. The same command can be abbreviated to:

EPDF AMB.INPUT PRE C Y    

  • To view a data set called 'prefix.ISPPNL.TRACE' with an initial edit macro called IMAC, on the ISPF command line, type:

EPDF ISPPNL.TRACE VIEW MACRO IMAC   

  • To view a UNIX file /u/mydir/execute.c, on the ISPF command line, type:

epdf /u/mydir/execute.c v

ISPF translates the command line to uppercase. EPDF first attempts to edit the UNIX file with the name in uppercase.  If that name is not found, then ISPF tries it in lowercase. If the file doesn't exist, it is created with the lowercase name.

  • To run ISPF edit from TSO READY, if 'ISP.SISPEXEC' is allocated to ddname SYSEXEC, you can use the ISREPDF command. To to edit member A in prefix.PRIVATE.JCL, from the TSO READY prompt, type:

ISREPDF PRIVATE.JCL(A)

Additional Information

UNIX is a registered trademark of The Open Group in the United States and other countries.

Document Location

Worldwide

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSBLLD","label":"ISPF for z\/OS"},"Component":"ISPF","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
28 January 2020

UID

ibm11142614

Page Feedback