Range of values, Compound range of values – Longshine LCS-8056C2 User Manual

Page 21

Advertising
background image

Commands for Host-Processed Modems Reference Manual

100498E

Conexant

2-11

Fax Modes. If a single value is to be reported, the form of the result code is:

<value> or (<value>)

2.7.3

+<name>: <compound_value>Information Text Formats for Test Commands

In general, the format of information text returned by extended syntax commands is described
in the definition of the command.

The modem may insert intermediate <CR> characters in very long information text responses
in order to avoid overrunning DTE receive buffers. If intermediate <CR> characters are
included, the modem does not include the character sequences "0 <CR>"or "OK<CR>", so
that DTE can avoid false detection of the end of these information text responses.

Range of Values

When the action accepts a single numeric subparameter, or the parameter accepts only one
numeric value, the set of supported values may be presented in the information text as an
ordered list of values. The list is preceded by a left parenthesis (() , and is followed by a right
parenthesis ()). If only a single value is supported, it appears between the parentheses. If more
than one value is supported, then the values may be listed individually, separated by comma
characters, or, when a continuous range of values is supported, by the first value in the range,
followed by a hyphen character (-), followed by the last value in the range. The specification
of single values and ranges of values may be intermixed within a single information text. In
all cases, the supported values are indicated in ascending order.

For example, the following are some examples of value range indications:

(0)

Only the value 0 is supported.

(1,2,3)

The values 1, 2, and 3 are supported.

(1-3)

The values 1 through 3 are supported.

(0,4,5,6,9,11,12) The

several

listed values are supported.

(0,4-6,9,11-12)

An alternative expression of the above list.

Compound Range of Values

When the action accepts more than one subparameter, or the parameter accepts more than one
value, the set of supported values is presented as a list of the parenthetically-enclosed value
range strings described above, separated by commas. For example, the information text in
response to testing an action that accepts three subparameters, and supports various ranges for
each of them, could appear as follows:

(0),(1-3),(0,4-6,9,11-12)

This indicates that the first subparameter accepts only the value 0, the second accepts any
value from 1 through 3 inclusive, and the third subparameter accepts any of the values 0, 4, 5,
6, 9, 11, or 12.

Advertising