Telenetics 56 User Manual

Page 37

Advertising
background image

AT Commands

Page 29

Action Commands

Action Execution Command Syntax

There are two general types of action commands: those that have associated sub
parameter values that affect only that invocation of the command, and those that have no
sub parameters.

If sub parameters are associated with a command, the definition of the action command
indicates, for each sub parameter, whether the specification of a value for that sub
parameter is mandatory or optional. For optional sub parameters, the definition indicates
the assumed (default) value for the sub parameter if no value is specified for that sub
parameter; the assumed value may be either a previous value (i.e., the value of an omitted
sub parameter remains the same as the previous invocation of the same command, or is
determined by a separate parameter or other mechanism), or a fixed value (e.g., the value
of an omitted sub parameter is assumed to be zero). Generally, the default value for
numeric subparameters is 0, and the default value for string subparameters is "" (empty
string).

The following syntax is used for actions that have no subparameters:

+<name>

The following syntax is used for actions that have one subparameter:

+<name>[=<value>]

The following syntax is used for actions that have two or more subparameters:

+<name>[=<compound_value>]

For actions that accept subparameters, if all subparameters are defined as being optional,
and the default values for all subparameters are satisfactory, the data terminal equipment
(DTE) may use the first syntax above (i.e., omit the "=" from the action execution
command as well as all of the subparameter value string).

If all other relevant criteria are met (e.g., the modem is in the proper state), the command
is executed with any indicated subparameters. If <name> is not recognized, the modem
issues the ERROR result code and terminates processing of the command line. An
ERROR is also generated if a subparameter is specified for an action that does not
accept subparameters, if too many subparameters are specified, if a mandatory
subparameter is not specified, if a value is specified of the wrong type, or if a value is
specified that is not within the supported range.

Advertising