macros Definition/General, macros Definition/General

macros

Command macros Definition/General
Applicable release versions: AP
Category General (155)
Description executes one or more TCL commands.

Macros are stored in the master dictionary with the name of the macro as the item-id.

When the macro name is entered at TCL, it may be followed with any number of parameters. These parameters are added to the end of the first TCL command in attribute 2 as additional language elements and then passed for processing.

The macro functionality is provided for a simple TCL procedure language. In general, a complex procedure should be written as a Pick/BASIC program.

The first line of a macro must contain the character m (modify mode) or n (non-stop mode). Each subsequent line is considered a TCL command to be executed.

If the "m" code is used in the first attribute of the macro, the TCL command is displayed so that changes can be made to the TCL command. If "n" is used, the macro runs immediately.

Macro "comments" can be added preceded by a blank after the macro code on attribute 1. Comments on following lines can be added by using the REM statement.

Additional values stored in an attribute are used as stacked input to the TCL command in the first value.

Macro's may be created by using the Update processor or the "create-macro" verb. The "create-macro" verb takes the last statement entered at TCL and converts it to a macro.
Syntax
Options
Example
Purpose
Related line.continuation.character
tcl.introduction
access.options
tcl.!.apdos
tcl.prompt
tcl.!.unix
proc.logon
tcl.dm
tcl.display
tcl.list-abs
account
tcl.create-macro
tcl.list-macros
paragraph.introduction
tcl.rem

macros

Command macros Definition/General
Applicable release versions: AP
Category General (155)
Description executes one or more TCL commands.

Macros are stored in the master dictionary with the name of the macro as the item-id.

When the macro name is entered at TCL, it may be followed with any number of parameters. These parameters are added to the end of the first TCL command in attribute 2 as additional language elements and then passed for processing.

The macro functionality is provided for a simple TCL procedure language. In general, a complex procedure should be written as a Pick/BASIC program.

The first line of a macro must contain the character m (modify mode) or n (non-stop mode). Each subsequent line is considered a TCL command to be executed.

If the "m" code is used in the first attribute of the macro, the TCL command is displayed so that changes can be made to the TCL command. If "n" is used, the macro runs immediately.

Macro "comments" can be added preceded by a blank after the macro code on attribute 1. Comments on following lines can be added by using the REM statement.

Additional values stored in an attribute are used as stacked input to the TCL command in the first value.

Macro's may be created by using the Update processor or the "create-macro" verb. The "create-macro" verb takes the last statement entered at TCL and converts it to a macro.
Syntax
Options
Example
Purpose
Related line.continuation.character
tcl.introduction
access.options
tcl.!.apdos
tcl.prompt
tcl.!.unix
proc.logon
tcl.dm
tcl.display
tcl.list-abs
account
tcl.create-macro
tcl.list-macros
paragraph.introduction
tcl.rem