6K V1.02 03-16-91
122
MACROS
CREATE NEW MACRO
Command Form:
(PW) 20 (macro name, command) *
Description:
This command is used to create a new macro. A new macro is a macro with
a name that has not been used before. This command places the name of
the new macro in a directory, then places the digits following the macro
name into a storage area in memory. The digits that are stored in memory
are shown above as
“command”. "Command" may be either a control
command, or the name of another macro. If you are storing a control
command, don
’t forget to include the control command's password. In other
words, the "command" stored into a macro must be a complete, executable
command or a macro.
Acknowledgement:
OK
Errors:
? ERR 1
too few digits entered
? NAME USED
macro name already exists in the directory
? DIR FULL
directory is filled with the maximum number of
macros
? TOO BIG
the command being entered for storage exceeds the
storage area allowed for a macro
Default Condition:
no macros exist
Examples:
Assume that we wish to create a macro that sends the time of day. The
control command would normally be (PW) 14 1 * for time-of-day in 12-hour
format. Since we do not wish to disclose control command information to
our users, we can simply put this command into a macro. Let's call the
macro 6A (assume that our users have 16-button DTMF Keyboards). Enter
the following command:
(PW) 20 006A (PW) 14 1 *
Users may now request the time of day by entering 6A*. Note that the
macro name is entered with leading zeros, since the name we chose is
fewer than 4 digits long. Also, note that the command following the macro
name is a complete command, including password!
If additional commands are to be executed by entering 6A, they can be
appended. See the Append to Macro command.
Note that the acknowledgement message OK simply indicates that the
Create New Macro command was entered correctly, and that the controller
created a new directory entry with some digits stored in memory. It does not
guarantee that the digits it stored represented an executable command. It is
possible to store garbage digits in a macro just as easily as legitimate
commands.