&Zn= - Store Telephone Number
Description
This command is used to store up to four dialing strings. These stored
dial strings are non-volatile (survive power outages). Refer to the D command
and to the Dial Modifiers to determine valid dial strings. If no dial string
is used, then the referenced stored number is cleared.
&Z syntax AT [cmds] &Z[[n]=] [dial_string]<CR>
Where:
a. All characters that follow the &Zn= command until the carriage
return are treated as dial_string entry.
b. If the = token is present in the next position after the &Z,
then string 0 is assumed.
c. If the = token is present in the second position after the &Z,
then the first position after the &Z must be a valid phone string address
(n). Valid values for n are 0, 1, 2, or 3. If the character is not a valid
(n), then an ERROR results.
d. If no = token is found in either the first or second position
after the &Z, then location 0 is assumed, and the remainder of the command
line is the candidate dial string for location 0.
e. If the dial_string is missing, the memory is cleared.
f. The following characters are storable in dial_strings;
0123456789ABCD#*,"$TPRW";
The letters: A,B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, R, S, T, U,
V, W, X, and Y are stored if enclosed in quotes.
g. Other characters are ignored, and not stored.
Further, disposition of characters following a ; (semicolon) dial modifier
in an &Z entry are not specified. If characters are not stored, they are
ignored.
h. Lowercase letters entered are converted into upper case for storage.
i. Available space is the storage area being used by the pre-existing
string in the target location, plus any phone number space not currently
in use by the other three phone strings. It is assumed that the present
phone number space consisting of 4x36=144 characters continues to be the
total size of the non-volatile memory phone number area.
Note: Modems that do not support dynamic allocation of available
space allocate 36 characters per stored number.
j. If the string of "storable"characters does not fit
into the available space, then no change to the pre-existing stored string
occurs. The command produces ERROR.
For example, assume String 0 uses 20 characters; String 1 uses 30 characters;
String 2 uses 50 characters; and String 3 uses no characters. There are
44 characters free. Attempts to store 64 storable characters in String 0
would produce an OK result code, but 65 characters would produce an ERROR
result code.
Suffix Values
0 through 3
Default
N/A
Stored by &Wn
N/A
Displayed by &V
yes
Execution Time
500 ms maximum
Cross Reference
Commands: S=n, &V -
View Configuration Profiles
Click here to return to the Contents page.