display smscell

Purpose

Displays status and statistics of the Short Message Service (SMS) feature.

Required permissions

For Digi products with two or more users, set permissions to set permissions display=execute to use this command. See set permissions for details on setting user permissions for commands.

Syntax

display smscell [general]
[users]
[scl]
[recvlog]
[recvlog=tail]
[sentlog]
[sentlog=tail]
[statistics]
[all]

Options

Note For the recvlog and sentlog options, the log is displayed.
If you specify the tail keyword, the command waits for new messages to be added to the log. As new messages are added to the log, they are displayed. Enter Ctrl-C to end the command.

The received and sent message logs contain only the most recent messages, not a full history of messages.

general

Display SMS general status.

users

Display SMS user information.

scl

Display the SMS sender control list.

recvlog

Display the received message log, reporting the most recent 10 messages received.

recvlog=tail

Display and “tail” the received message log.

sentlog

Display the sent message log, reporting the most recent 10 messages sent.

sentlog=tail

Display and “tail” the sent message log}.

statistics

Display SMS general statistics and counters.

all

Display all the above SMS status categories.

Examples

#> display smscell general

Cellular SMS General Status Information:

  SMS feature enabled: yes
  Password configured: no
  Default actions for received command messages:
    ACK all accepted received command messages: no
    NAK messages if password validation fails:  no
  Extended detail (verbose) SMS event logging:  no
  Default message receiver: 0x80000001 (logonly)

#>
#> display smscell users

Cellular SMS User (Command) Information:

  Number of user entries: 5
                                          Requires  Read  Read Hold   Ref
    User ID   Flags      User Name        Password  QLen  (Seconds)  Count
    --------  ---------  ---------------  --------  ----  ---------  -----
    80000001  0000 0111  _default_           no       0       600      1
    80000002  0000 0111  _builtincmd_        no       0       600      1
    80000003  0000 0011  _alarms_            no       0       600      1
    80000004  0000 1111  python              no       0       600      1
    80000005  0000 0111  cli                 no       0       600      1 
    80000006  0000 0111  dcloud_msgsrv       no       0       600      1

    Flag descriptions:     If flag is set (1):
    ENABLED   .... ...1    This user entry is enabled.
    SEND      .... ..1.    This user can send messages.
    RECEIVE   .... .1..    This user can receive messages.
    READHOLD  .... 1...    Received messages are being held.
    RELEASED  .1.. ....    This user entry is released.
#> display smscell statistics

Cellular SMS General Statistics/Counters:

  Message send counters:
    User send requests                    : 37
    Send request successes                : 37
    Send request failures                 : 0
    Send request bytes (unencoded)        : 962
    Messages using multiple SM blocks     : 2
    SM blocks queued (current)            : 0
    SM blocks queued (maximum)            : 2
    SM block submit requests              : 39
    SM block submit in progress           : 0
    SM block submit successes             : 39
    SM block submit failures              : 0
    SM block submit retries               : 0

  Message receive counters:
    Received short message (SM) blocks    : 52
    Received SM octets (decoded)          : 5401
    Received complete messages            : 37
    Messages requiring reassembly         : 15
    SM blocks in reassembly               : 0
    Duplicate SM blocks discarded         : 0
    SM blocks discarded in reassembly     : 0
    Messages discarded: SMS disabled      : 0
    Messages discarded: SCL rejection     : 0
    Messages discarded: password fail     : 0
    Messages discarded: read queue full   : 0
    Messages discarded: read hold timeout : 0

See also