Running an edit macro

Before you start

1. Open the Menu Manager New Action Wizard as described in Creating menu actions.
2. Complete the wizard pages until you reach the Run Options page. The following instructions begin on the Run Options page.

Creating an edit macro command

To create a menu command that runs an ISPF edit macro:

1. On the Basic tab of the Run Options page, enter a command string that follows this format in the Command field.

   There are five parts of the command, each is separated with an exclamation character.

   
   EDIT ! 
   $userid.STAGING.DATASET($name) ! 
   Allocation Parameters + Additional Allocation Parameters ! 
   REXX.DATASET.NAME ! 
   EDIT.MACRO.DATASET(EDTMACRO) ! 
   MACROMBR

   The command and parameters are described in this list:

   EDIT

   Indicates whether to open the data set member in the editor if it is not already open when the action is selected from the menu.

   $userid.STAGING.DATASET($name)

   Represents the name of a temporary data set that contains the results of the processing of the input data set or data set member by the edit macro. The $userid substitution variable supplies the logon ID of the remote connection as a high-level qualifier. The $name variable supplies the name of the selected data set or data set member that is the input to the command.

   Allocation Parameters

   Represents optional allocation parameters to override the defaults used during the editing of the work data set.

   Additional Allocation Parameters

   Represents additional, non-standard, parameters to pass to the REXX program during the allocation step. This group of parameters must be preceded by the plus sign (+) when used.

   REXX.DATASET.NAME

   Represents the ISPF Edit Macro action interacts with a REXX program on the host.

   REXX.DATASET.NAME(EDTMACRO)

   Represents the name of the edit macro REXX or CLIST program that is to be started to process the input data set or data set member.

   EDIT.MACRO.DATASET(EDTMACRO)

   Represents the name of the ISPF Edit Macro that is to be invoked along with the name of the data which contains it.

   EDIT.MACRO.DATASET MACROMBR

   Represents the parameter that is to be passed to the edit macro REXX or CLIST program. Typically, it is the data set and member for the ISPF edit macro.

   MACROMBR

   Represents edit macro parameters that are to be passed to the ISPF Edit Macro.

   If the menu action starts REXX, use this format for the command string instead:

   
   EXEC 'REXX.DATASET.NAME(EDTMACRO)' 'SELECTED.DATASET.NAME SELCTMBR STAGING.DATASET.NAME STAGEMBR EDIT.MACRO.DATASET MACROMBR'
   

2. In the Action Properties group box, select Use existing action and then click Select and choose com.ibm.ftt.ui.menumanager > com.ibm.ftt.ui.menumanager.edit.macro.action from the Action Selection window.
3. Choose any additional action properties that you want, complete the remaining pages of the wizard, and click Finish.