z/OS - Group home

Did You Know ISPF Lets You Start Edit From the Command Line?

  

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:

BrowseInvoke Browse instead of Edit
ViewInvoke View instead of Edit
Macro xxx Invoke the editor with the initial macro specified by xxx.
Profile yyy Invoke the editor using the edit profile specified by yyy.
PAnel nnnUse alternate panel name specified by nnn.
Recover Perform edit recovery if a recovery is pending. The file name on the command and the macro are ignored if edit recovery is used. If no edit recovery session is pending, then the file is edited as usual.
Format zzz Invoke the editor using the format table specified by zzz.
MIxed Yes|NoYes 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
PREservePreserve original record length as the minimum length for the record
Confirm Yes|NoYes 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 sequential data set called prefix.AMB.INPUT, on the ISPF command line, type:

EPDF AMB.INPUT PRESERVE CONFIRM YES    

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

EPDF AMB.INPUT PRE C Y    

  • To view 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 upper case. EPDF first attempts to edit the unix file with the name in upper case.  If that name is not found, then it will try it in lower case. If the file doesn't exist, it will be created with the lower case name.

  • If you want to run ISPF edit from TSO READY, you can use the ISREPDF command, as long as 'ISP.SISPEXEC' is allocated to ddname SYSEXEC. From the TSO READY prompt, type:

ISREPDF PRIVATE.JCL(A)

to edit member A in prefix.PRIVATE.JCL.