IMACRO—Set or Query an Initial Macro

The IMACRO macro command saves the name of an initial macro in the current edit profile.

The IMACRO assignment statement sets or retrieves the value for the initial macro in the current profile, and places it in a variable.

See Initial macros for more information on creating and using initial macros.

Syntax

Macro command syntax

Read syntax diagramSkip visual syntax diagramISREDITIMACROnameNONE
name
Identifies the initial macro to be run when editing the data set type that matches this profile. This macro is run before any data is displayed.
NONE
Shows that no macro is to be run at the beginning of each edit session. The editor returns a value of NONE when no initial macro has been specified.

Assignment statement syntax

Read syntax diagramSkip visual syntax diagramISREDIT ( varname) = IMACRO
Read syntax diagramSkip visual syntax diagramISREDITIMACRO = name
varname
The name of a variable to contain the name of the initial macro.
name
Same as macro command syntax.

Return codes

0
Normal completion
4
IMACRO set not accepted; profile is locked
12
Invalid name specified
20
Severe error

Examples

To set the initial macro name to ISCRIPT: 
ISREDIT IMACRO ISCRIPT
To set no initial macro: 
ISREDIT IMACRO NONE
To store the name of the initial macro in the variable &IMACNAM: 
ISREDIT (IMACNAM) = IMACRO