CALL:SMService

CALL:SMService

Last updated: May 11, 2011

GPIB Command Conventions

CALL:SMService:ARM[:IMMediate]

Function

Sets (arms) the SMS status change detector. Arming this detector allows the control program to tell the test set that it is expecting a change in the state of an SMS processing, prior to initiating the state change. See SMS Status Change Detector for details.

This is an overlapped command, and therefore has a Pending Operation Flag (POF) associated with it. See Call Processing Event Synchronization for more information about the behavior of overlapped commands.

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:ARM"
!Arms the SMS status change detector.

CALL:SMService:ARM:STATe?

Function

Queries the arm state of the SMS status change detector. This command never hangs and immediately returns a one if the detector is armed, or a zero if the detector is not armed. See SMS Status Change Detector .

Query

Range:  1|0

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:ARM:STATe?"
!Query the arm state of the SMS status change detector.

CALL:SMService:ARM:TIMeout

Function

Sets/queries the amount of time that the test set will wait for an SMS status change detector to become disarmed. See SMS Status Change Detector Timeout for details.

Default setting units are seconds. To set timeout time in units other than seconds, include an optional unit specifier in the command string.

Setting

Range: 0 to 100 seconds
Resolution: 0.1 seconds

Query

Same as setting

*RST Setting

10 seconds

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:ARM:TIMeout 3" 
!Sets the SMS staus change detector timeout time to 3 seconds.

OUTPUT 714;"CALL:SMService:ARM:TIMeout 500 MS" 
!Sets the SMS staus change detector timeout time to 500 milliseconds.

CALL:SMService:BSENt[:STATe]?

Function

Queries whether or not the SMS processing is in the 'Broadcast Sent' terminal state (see SMS Status Description ).

The query will hang as long as the SMS processing is in a transitory state. See SMS (Short Message Service) State Synchronization for details.

Query

Range: 0 |1

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:BSENt?" 
!Query whether or not the SMS processing in the Broadcast Sent state.

CALL:SMService:CLEar

Function

Clears the last received SMS message from the mobile station (MS), as well as the SMS processing status and the MS acknowledgment information. See Clearing the SMS Info/Status .

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:CLEar" 
!Clear the SMS information received from the MS,
!and the current SMS processing status.

CALL:SMService:END

Function

This command causes the test set to end the SMS Send ( CALL:SMService:SEND ) currently in process. See methods 1 and 3 described in Sending an SMS Message to the Mobile Station .

This command does not apply to the SMS message sent via Originate Call ( CALL:ORIGinate ). See method 2 described in Sending an SMS Message to the Mobile Station .

If the test set receives an SMS End command while processing an SMS Send (an SMS message is being transmitted on the traffic channel or control channel), the test set will immediately discontinue the SMS signaling. Any SMS Message or Acknowledgments that were in transit may be lost.

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:END" 
!End the SMS Send command currently in process.

CALL:SMService:HTTProtocol:INPut

Function

Enable/Disenble the HTTP input interface for MT SMS

Setting

Range: 0|OFF |1|ON

Query

Range: 0 |1

*RST Setting

OFF

Requirements

Lab Application Revision: B.04 and above

Test Application Revision: B.14 and above

Programming Example

OUTPUT 714;"CALL:SMService:HTTProtocol:INPut ON" !Enables the HTTP input interface for mobile terminated SMS

CALL:SMService:HTTProtocol:OUTPut

Function

Enable/Disenble the HTTP output interface for MO SMS

Setting

Range: 0|OFF |1|ON

Query

Range: 0 |1

*RST Setting

OFF

Requirements

Lab Application Revision: B.04 and above

Test Application Revision: B.14 and above

Programming Example

OUTPUT 714;"CALL:SMService:HTTProtocol:OUTPut ON" !Enables the HTTP output interface for mobile originated SMS

CALL:SMService:IDLE[:STATe]?

Function

Queries whether or not the SMS processing is in the 'idle' terminal state (see SMS Status Description ).

The query will hang as long as the SMS processing is in a transitory state. See SMS (Short Message Service) State Synchronization for details.

Query

Range: 0 |1

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:IDLE?" 
!Query whether or not the SMS processing in the Idle state.

CALL:SMService:MSACk[:STATe]?

Function

Queries whether or not the SMS processing is in the 'MS Ack' terminal state (see SMS Status Description ).

The query will hang as long as the SMS processing is in a transitory state. See SMS (Short Message Service) State Synchronization for details.

Query

Range: 0 |1

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MSACk?" 
!Query whether or not the SMS processing in the MS Ack state.

CALL:SMService:MSNack[:STATe]?

Function

Queries whether or not the SMS processing is in the 'MS Nack' terminal state (see SMS Status Description ).

The query will hang as long as the SMS processing is in a transitory state. See SMS (Short Message Service) State Synchronization for details.

Query

Range: 0 |1

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MSNack?" 
!Query whether or not the SMS processing in the MS Nack state.

CALL:SMService:RECeived[:STATe]?

Function

Queries whether or not the SMS processing is in the 'Received' terminal state (see SMS Status Description ).

The query will hang as long as the SMS processing is in a transitory state. See SMS (Short Message Service) State Synchronization for details.

Query

Range: 0 |1

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:RECeived?" 
!Query whether or not the SMS processing in the Received state.

CALL:SMService:SEND

Function

This command causes the test set to send an SMS message to the mobile station. It's used by the methods 1 and 2 ( Sending an SMS Message to the Mobile Station ).

This is an overlapped command, and therefore has a Pending Operation Flag (POF) associated with it. See Call Processing Event Synchronization for more information about the behavior of overlapped commands.

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:SEND"
!Sends a short message to the mobile station.

CALL:SMService:STATus[:STATe]?

Function

Queries the current status of the SMS processing. See SMS Status Description for details.

Query

Range: IDLE|SEND|WAIT|MSAC|MSN|BSEN|PAG|ORIG|REC

*RST Setting

IDLE

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:STATus?"
!Query the status of SMS processing.

CALL:SMService:MORiginated:CBNumber:ASCii?

Function

Queries the call-back number of the received SMS message from the mobile station. The returned string is represented in ASCII format.

This result is also available on the Mobile-Originated SMS Info .

Query

Range: returns a string containing up to 255 characters and each character is

*RST Setting

"" (null string)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:CBNumber:ASCii?"
!Returns the call-back number of the received SMS message in ASCII format.

CALL:SMService:MORiginated:CBNumber:ENCoding?

Function

Queries the encoding of the call-back number of the received SMS message sent from the mobile station. This result determines how the call-back number is interpreted (see CALL:SMService:MORiginated:CBNumber:ASCii? and CALL:SMService:MORiginated:CBNumber:HEX? ).

This result is also available on the Mobile-Originated SMS Info .

Query

Range:  DTMF|ASC8|NDEF

*RST Setting

NDEF

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:CBNumber:ENCoding?"
!Returns the encoding of the call-back number of the received SMS message.

CALL:SMService:MORiginated:CBNumber:HEX?

Function

Queries the call-back number of the SMS message received from the mobile station. The returned string is represented in Hex format.

This result is also available on the Mobile-Originated SMS Info .

Query

Range: returns a string containing up to 511 hex characters

  • If the Call-Back Number Encoding is DTMF (queried by CALL:SMService:MORiginated:CBNumber:ENCoding? ), the returned string will contain the hex representation of symbols from the set of 0123456789*#; "0" will be represented as hex A, "*" will be represented as hex B and "#" will be represented as hex C; for all other symbols, the hex character is the same as the DTMF symbol.
  • If the Call-Back Number Encoding is ASC8 (queried by CALL:SMService:MORiginated:CBNumber:ENCoding? ), the returned string will contain hex representation of symbols from the ASCII character set, two hex characters for each ASCII symbol.

*RST Setting

"" (null string)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:CBNumber:HEX?"
!Returns the call-back number of the received SMS message in Hex format.

CALL:SMService:MORiginated:COUNt?

Function

Queries the number of SMS messages received by the test set from the mobile station. This result increments by one each time an SMS message is successfully received from the MS and wraps around to 0 (zero) when the maximum value is reached. It can also be cleared to 0 (zero) by CALL:SMService:CLEar .

This result is also available on the Mobile-Originated SMS Info .

Query

Range: 0 to 65535

Resolution: 1

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:COUNt?"
!Returns the number of the SMS messages received from the mobile station.

CALL:SMService:MORiginated:DADDress:ASCii?

Function

Queries the destination address of the SMS message received from the mobile station. The returned string is represented in ASCII format.

This result is also available on the Mobile-Originated SMS Info .

Query

Range: returns a string containing up to 255 characters and each character is:

*RST Setting

""(null string)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:DADDresss:ASCii?"
!Returns the destination address of the received SMS message in ASCII format.

CALL:SMService:MORiginated:DADDress:ENCoding?

Function

Queries the encoding of the destination address of the received SMS message sent from the mobile station. This result determines how the Destination Address is interpreted (see CALL:SMService:MORiginated:DADDress:ASCii? and CALL:SMService:MORiginated:DADDress:HEX? ).

See also Mobile-Originated SMS Info .

Query

Range:  DTMF|ASC8|NDEF

*RST Setting

NDEF

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:DADDress:ENCoding?"
!Returns the encoding of the destination address of the received SMS message.

CALL:SMService:MORiginated:DADDress:HEX?

Function

Queries the destination address of the SMS message received from the mobile station. The returned string is represented in Hex format.

This result is also available on the Mobile-Originated SMS Info .

Query

Range: returns a string containing up to 511 hex characters.

  • If the Destination Address Encoding is DTMF (queried by CALL:SMService:MORiginated:DADDress:ENCoding? ), the returned string will contain the hex representation of symbols from the set of 0123456789*#; "0" will be represented as hex A, "*" will be represented as hex B and "#" will be represented as hex C; for all other symbols, the hex character is the same as the DTMF symbol.
  • If the Destination Address Encoding is ASC8 (queried by CALL:SMService:MORiginated:DADDress:ENCoding? ), the returned string will contain hex representation of symbols from the ASCII character set, two hex characters for each ASCII symbol.

*RST Setting

"" (null string)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:DADDress:HEX?"
!Returns the destination address of the received SMS message in Hex format.

CALL:SMService:MORiginated:DROP:TIMer[:STATe]

Function

Sets/queries the state of SMS call drop timer. This timer determines whether the test set will disconnect a call in service option SO6 or SO14 if an SMS message or MS disconnect is not received after a fixed amount of time (~ 5 seconds) since the call was established or an SMS message was received. See SMS Call Drop Timer Control for details.

Setting

Range: 1|ON|0|OFF

Query

Range: 1|0

*RST Setting

ON

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:DROP:TIMer 0"
!Disable the SMS Call Drop Timer.

CALL:SMService:MORiginated:ECLass

Function

Sets/queries the SMS Support Error Class .

Setting

Range: TEMPorary|PERManent

Query

Range: TEMPorary|PERM

*RST Setting

PERManent

Requirements

Test Application Revision: B.18.00 and above
Lab Application Revision: D.01.00 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:ECLass PERManent"
!Set the SMS Support Error Class to Permanent.

CALL:SMService:MORiginated:MESSage:ASCii?

Function

Queries the contents of the received SMS message from the mobile station. This result is also available on the Mobile-Originated Message .

The returned string is represented in ASCII format and impacted by the value of the Message Encoding ( CALL:SMService:MORiginated:MESSage:ENCoding? ).

  • If the Message Encoding is ASC7, IA5, or GSM7, this string will contain ASCII characters.
  • If the Message Encoding is any value other than ASC7, IA5, and GSM7, all characters are either 8 or 16 bits. 16-bit characters will be interpreted as two-8 bit characters. The 8-bit characters with the first (most significant) bit set will be treated like non-printable ASCII characters and represented as '*' characters.

Query

Range: Returns a string containing up to 255 characters from the ASCII character set.

*RST Setting

"" (null string)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:MESSage:ASCii?"
!Returns the contents of the received SMS message in ASCII format.

CALL:SMService:MORiginated:MESSage:ENCoding?

Function

Queries the encoding of the received SMS message sent from the mobile station. See Msg Encoding in the Mobile-Originated SMS Info for the encoding type.

The message encoding determines how the Message contents are interpreted (see CALL:SMService:MORiginated:MESSage:ASCii? and CALL:SMService:MORiginated:MESSage:HEX? ). It also impacts the Message Length ( CALL:SMService:MORiginated:MESSage:LENGth? ).

Query

Range: OCT|EPM|ASC7|IA5|UNIC|SJIS|KOR|KSC5601|LHEB|LAT|GSM7|OTH|NDEF

*RST Setting

NDEF

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:MESSage:ENCoding?"
!Query the encoding of the received SMS message sent from the mobile station.

CALL:SMService:MORiginated:MESSage:HEX?

Function

Queries the contents of the received SMS message from the mobile station. See also Mobile-Originated Message .

The returned string is represented in Hex format and impacted by the value of the Message Encoding ( CALL:SMService:MORiginated:MESSage:ENCoding? ).

  • If the Message Encoding is ASC7, IA5, or GSM7, each 7-bit character is converted to 8 bits by adding a padding "0" bit to the beginning (most-significant bit) of each character, then each 8-bit character is converted to 2 hex characters from the set of '0123456789ABCDEF'.
  • If the Message Encoding is any value other than ASC7, IA5, and GSM7, all characters are either 8 or 16 bits. Each character is then converted to 2 or 4 hex characters.

Query

Range: returns a string containing up to 511 hex characters from the set of 0123456789ABCDEF

*RST Setting

"" (null string)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:MESSage:HEX?"
!Returns the contents of the received SMS message in Hex format.

CALL:SMService:MORiginated:MESSage:LENGth?

Function

Queries the number of encoded characters in the last received SMS messages from the mobile station. This result depends upon the message encoding type (see CALL:SMService:MORiginated:MESSage:ENCoding? ).

See Mobile-Originated SMS Info for details.

Query

Range: 0 to 255, 9.91E+37

Resolution: 1.0

*RST Setting

9.91E+37 (NAN)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:MESSage:LENGth?"
!Returns the number of encoded characters in the last
!received SMS messages from the mobile station.

CALL:SMService:MORiginated:PRIority?

Function

Queries the priority level of received SMS message from the mobile station. NONE is returned if no priority field is included in the received SMS message.

See Mobile-Originated SMS Info for details.

Query

Range: NORM|INT|URG|EMER|NONE

*RST Setting

NONE

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:PRIority?
!Query the priority level of the received SMS message from the mobile station.

CALL:SMService:MORiginated:PROTocol

Function

Sets/queries how the test set responds to a received SMS message. See SMS Support Control for details.

Setting

Range: ENABled|DISabled|NSUPported|UDADdress|NFAilure

Query

Range: ENAB|DIS|NSUP|UDAD|NFA

*RST Setting

ENABled

Requirements

Lab Application Revision: B.00 and above
Test Application Revision: B.14 and above
Test Application Revision: B.18.00 and above, added NFAilure
Lab Application Revision: D.01.00 and above, added NFAilure

Programming Example

 
OUTPUT 714;"CALL:SMService:MORiginated:PROTocol NSUPported"
!Set the test set to indicate to the MS that SMS is not supported.

CALL:SMService:MORiginated:TELeservice[:ENUM]?

Function

Queries the teleservice type of the received SMS message from the mobile station. See also Mobile-Originated SMS Info .

Query

Range: EPES|WPAG|WMES|VMN|WAP|RCSP |OTH|NDEF|CATP

  • EPES - Extended Protocol Enhanced Service
  • WPAG - Wireless Paging Teleservice
  • WMES- Wireless Messaging Teleservice
  • VMN - Voice Mail Notification
  • WAP - Wireless Application Protocol
  • RCSP - Reserved for Carrier Specific Teleservices
  • OTH - Other (this value is returned for the teleservices specified in the standard but not supported by the test set, or indicated as "Reserved" in the standard)
  • NDEF - Undefined

*RST Setting

NDEF

Requirements

Lab Application Revision: B.00 and above
Test Application Revision: B.14 and above
Test Application Revision: B.19.00 and Lab Application Revision E.00.00 and above, add the optional node [:ENUM]

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:TELeservice WPAG
!Sets the teleservice to Wireless Paging Teleservice.

CALL:SMService:MORiginated:TELeservice:NUMBer?

Function

Queries the current mobile originated user specified teleservice ID.

See also Teleservice .

Query

Range: 1 to 65535

Requirements

Test Application Revision: B.19.00 and Lab Application Revision E.00.00 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:TELeservice:NUMBer?"
!Queries the current MO User Specified Teleservice ID.

CALL:SMService:MTERminated:ALERt

Function

Sets/queries whether the mobile station will alert the user (for example, beep or vibrating depending upon the mobile station's behavior) when it receivers the message from the test set.

See MS Message Alert for details.

Setting

Range: NONE|MSDefault|LOW|MEDium|HIGH

Query

Range: NONE|MSD|LOW|MED|HIGH

*RST Setting

MSD

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:ALERt LOW"
!Set to alert the user with low level when the MS receives an SMS message.

CALL:SMService:MTERminated:CBNumber

Function

Sets/queries whether to include the Call-Back Number subparameter in the SMS message sent to the mobile station. See Call-Back Number for details.

Setting

Range: INCLude|EXCLude

Query

Range: INCL|EXCL

*RST Setting

EXCL

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:CBNumber INCLude"
!Set to include the Call-Back Number in the SMS message.

CALL:SMService:MTERminated:SOURce

Function

Sets/queries whether the ASCII short message (defined by CALL:SMService:MTERminated:MESSage:ASCii ) or the HEX short message (defined by CALL:SMService:MTERminated:MESSage:HEX ) will be included in the SMS message sent to the mobile station.

See also Set Message Source .

Setting

Range: ASCii|HEX

Query

Range: ASC|HEX

*RST Setting

ASC

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:SOURce HEX"
!Set the Hex SMS message to be sent to the mobile station.

CALL:SMService:MTERminated:MDMode

Function

Sets/queries the message display mode. Only when MDMI ( CALL:SMService:MTERminated:MDMode:INCLusion ) is set to "Include", this parameter will be included in the message sent to mobile. Otherwise, this parameter will not be transmitted OTA. See Message Dispaly Mode Indicator Values for each value of the Message Display Mode Indicator which show the most significant two bits of the eight bits. The setting range of the Message Display Mode can be the integer 0-255:

  • If the integer 0-63 is input, `00' is filled in the MSG_DISPLAY_MODE field.
  • If the integer 64-127 is input, `01' is filled in the MSG_DISPLAY_MODE field.
  • If the integer 128-191 is input, `10' is filled in the MSG_DISPLAY_MODE field.
  • The integer 192-255 is reserved.

Setting

Range: 0-255 integer value.

Query

Range: same as settings.

*RST Setting

0

Requirements

Lab Application Revision: B.04 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MDMode 64"
!Set the mobile station to display the received message based on a pre-defined mode in the mobile station".

CALL:SMService:MTERminated:MDMode:INCLusion

Function

Sets/queries whether to send the Message Display Mode sub-parameter for teleservice types (defined by CALL:SMService:MTERminated:TELeservice[:ENUM] ). See MDMI .

Setting

Range: INCLude|EXCLude

Query

Range: INCL|EXCL

*RST Setting

EXCL

Requirements

Lab Application Revision: B.04 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MDMode:INCLusion INCLude"
!Set to display the Message Display Mode.

CALL:SMService:MTERminated:MESSage:ASCii

Function

Sets/queries the Mobile-Terminated SMS ASCII message content. The ASCII message is included in the SMS message to be sent to the mobile station when the message source is ASCII (determined by the CALL:SMService:MTERminated:SOURce ) and the message content is included (determined by the CALL:SMService:MTERminated:MESSage:UDATa ). The message contents will be displayed in the Mobile-Terminated Message .

Setting

Range: 0-255 ASCII characters, enclosed by quotes.

Query

Range: same as settings.

*RST Setting

"ABCDEFGHIGKLMNOPQRSTUVWXYZ"

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MESSage:ASCii 'I Have arrived!'"
!Set the message content (in ASCII format) to "I have arrived!".

CALL:SMService:MTERminated:MESSage:ENCoding

Function

Sets/queries the encoding scheme used for the SMS message to be sent to the mobile station. See Message Encoding for details.

Setting

Range: OCTet|ASCii7|IA5|UNICode|SJIS|KSC5601|KORean|LHEBrew|LATin|GSM7

Query

Range: OCT|ASC7|IA5|UNIC|SJIS|KSC5601|KOR|LHEB|LAT|GSM7

*RST Setting

ASC7

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MESSage:ENCoding UNICode"
!Set the encoding type as UNICode, indicating 16 bits per encoded character.

CALL:SMService:MTERminated:MESSage:HEX

Function

Sets/queries the Mobile-Terminated SMS Hex message content. The Hex message is included in the SMS message to be sent to the mobile station when the message source is Hex (determined by the CALL:SMService:MTERminated:SOURce ) and the message content is included (determined by the CALL:SMService:MTERminated:MESSage:UDATa ). The contents will be displayed in the Mobile-Terminated Message .

Setting

Range: 0-511 hex characters, enclosed by quotes.

Query

Range: same as settings.

*RST Setting

"4142434445464748494A4B4C4D4E4F505152535455565758595A"

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MESSage:HEX '0123456789ABCEEF'"
!Set the message content (in Hex format) to "0123456789ABCEEF"

CALL:SMService:MTERminated:MESSage:LENGth?

Function

Queries the length of the desired message in encoded characters. It is based on the Message Encoding, Message Source, and Message Repeat. This result is available on the Mobile-Terminated SMS Info window.

See How Does the Test Set Build the Mobile-Terminated Message? for details.

Query

Range: 0 to 65025
Resolution: 1

*RST Setting

26

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MESSage:LENGth?
!Query the length of the desired message in encoded characters.

CALL:SMService:MTERminated:MESSage:REPeat

Function

Sets/queries the number of times the user entered message contents (plus any padding if necessary) will be repeated to make the desired message sent to the MS. See Set Message Repeat .

Setting

Range: 0 to 255

Resolution: 1

Query

Range: same as setting

*RST Setting

1

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MESSage:REPeat 5"
!Set the number of repeat times for the user input message to 5.

CALL:SMService:MTERminated:MESSage:UDATa

Function

Sets/queries whether the user entered message contents is included in the optional User Data subparameter of the SMS messages sent to the mobile station. The User Data subparameter is mandatory and always included when the teleservice is WAP regardless of this setting, but this setting controls whether or not the User Data is included when the teleservice is other than WAP ( CALL:SMService:MTERminated:TELeservice[:ENUM] ).

See Message (Optional User Data) for details.

Setting

Range: INCLude|EXCLude

Query

Range: INCL|EXCL

*RST Setting

INCL

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MESSage:UDATa INCL"
!Set to include the user entered message in the SMS message.

CALL:SMService:MTERminated:MSACk:CCODe[:INDex]?

Function

Queries the MS Ack cause code upon receipt of an SMS acknowledgment from the mobile station. 'NAN' is returned when the SMS Status is any value other than 'MS Ack'. See SMS Message Acknowledge Info for details.

Query

Range: 0 to 255 (see MS Ack Cause Code & String for description), NAN (9.91E+37)

*RST Setting

NAN

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MSACk:CCODe?"
!Query the SMS ACK cause code.

CALL:SMService:MTERminated:MSACk:CCODe:STRing?

Function

Queries the MS Ack cause string corresponding to the MS Ack cause code. See SMS Message Acknowledge Info for details.

Query

Range: see MS Ack Cause String column in MS Ack Cause Code & String

*RST Setting

"" (null string)

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:MSACk:CCODe:STRing?"
!Query the string of the SMS ACK cause code.

CALL:SMService:MTERminated:PRIority

Function

Sets/queries the priority level of the SMS messages. See Priority .

Setting

Range: NONE |NORMal |INTeractive |URGent |EMERgency

Query

Range: NONE |NORM |INT |URG |EMER

*RST Setting

NORM

Requirements

Lab Application Revision: B.00 and above
Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:PRIority EMERgency"
!Set the SMS priority level to Emergency.

CALL:SMService:MTERminated:PRIVacy

Function

Sets/queries the privacy level of the SMS messages. See Privacy .

Setting

Range: NONE|NORestriction|RESTrict|CONFidential|SECRet

Query

Range: NONE|NOR|REST|CONF|SECR

*RST Setting

NONE

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:PRIVacy CONFidential"
!Set the SMS privacy level to confidential.

CALL:SMService:MTERminated:SCATegory

Function

Sets/queries the service category of the Mobile-Terminated SMS message. It's useful when CALL:SMService:MTERminated:SERVice is set to BROadcast. See Service Category .

Setting

Range: 0- 31, 4096 to 4100 (see Service Category Settings for service category description)
Resolution: 1

Query

Same as settings

*RST Setting

1

Requirements

Lab Application Revision: B.00 and above
Test Application Revision: B.14 and above
Test Application Revision: B.19.00 and Lab Application Revision E.00.00 and above, add 4096 to 4100

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:SCATegory 3"
!Set the service category to General News - Local.

CALL:SMService:MTERminated:SERVice

Function

Sets/queries the Mobile-Terminated SMS message type, either point-to-point or broadcast. See Service for details.

Setting

Range: PTPoint|BROadcast

Query

Range: PTP|BRO

*RST Setting

PTP

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:SERVice PTP"
!Set the Mobile-Terminated SMS message type to point-to-point.

CALL:SMService:MTERminated:TELeservice[:ENUM]

Function

Sets/queries the teleservice that will send the SMS message. It's useful for the point-to-point message specified by the CALL:SMService:MTERminated:SERVice .

See also Teleservice .

Setting

Range: WPAGing|WMESsaging|WAP|VMNotify|CATPt|USPecified

Query

Range: WPAG|WMES|WAP|VMN|CATP|USP

*RST Setting

WMES

Requirements

Lab Application Revision: B.00 and above
Lab Application Revision: B.04 and above: support CATPT
Test Application Revision: B.14 and above
Test Application Revision: B.19.00 and Lab Application Revision E.00.00 and above, add the optional node [:ENUM], and the new option USPecified

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:TELeservice WPAG"
!Sets the teleservice to Wireless Paging Teleservice.

CALL:SMService:MTERminated:TELeservice:NUMBer

Function

Sets/queries the mobile terminated user specified teleservice ID. This setting is only applicable when the CALL:SMService:MTERminated:TELeservice[:ENUM] is USPecified.

See also Teleservice .

Setting

Range: 1 to 65535

Query

Range: 1 to 65535

*RST Setting

4098

Requirements

Test Application Revision: B.19.00 and Lab Application Revision E.00.00 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:TELeservice:NUMBer 4098"
!Sets the User Specified Teleservice ID to 4098.

CALL:SMService:MTERminated:VMNotify:COUNt

Function

Sets/queries the number of the voice mail messages sent to the mobile station. It is useful only when the VMN teleservice is selected by CALL:SMService:MTERminated:TELeservice[:ENUM] .

See also Voice Mail Count .

Setting

Range: 0 - 99

Resolution: 1

Query

Range: same as setting

*RST Setting

0

Requirements

Lab Application Revision: B.00 and above

Test Application Revision: B.14 and above

Programming Example

 
OUTPUT 714;"CALL:SMService:MTERminated:VMNotify:COUNt 5"
!Sets the voice mail message counts to 5.