Class: Net_SMPP_Command_Deliver_Sm

Net_SMPP_PDU
   |
   --Net_SMPP_Command
      |
      --Net_SMPP_Command_Deliver_Sm

[line 56]
deliver_sm class

The deliver_sm is issued by the SMSC to send a message to an ESME. Using this command, the SMSC may route a short message to the ESME for delivery. In addition the SMSC uses the deliver_sm operation to transfer the following types of short messages to the ESME:-

• SMSC Delivery Receipt. A delivery receipt relating to a a message which had been previously submitted with the submit_sm operation and the ESME had requested a delivery receipt via the registered_delivery parameter. The delivery receipt data relating to the original short message will be included in the short_message field of the deliver_sm. (Reference Appendix B for an example Delivery Receipt format.)
• SME Delivery Acknowledgement. The user data of the SME delivery acknowledgement is included in the short_message field of the deliver_sm
• SME Manual/User Acknowledgement. The user data of the SME delivery acknowledgement is included in the short_message field of the deliver_sm
• Intermediate Notification.

$alert_on_msg_delivery =

[line 288]

$callback_num =

[line 277]

$callback_num_atag =

[line 279]

$callback_num_pres_ind =

[line 278]

$data_coding =  NET_SMPP_ENCODING_DEFAULT

[line 227]

Defines the encoding scheme of the short message user data.

$destination_addr =

[line 156]

Destination address of this short message.

For mobile terminated messages, this is the directory number of the recipient MS.

$destination_port =

[line 268]

$dest_addr_npi =  NET_SMPP_NPI_UNK

[line 146]

Numbering Plan Indicator for destination.

$dest_addr_subunit =

[line 269]

$dest_addr_ton =  NET_SMPP_TON_UNK

[line 139]

Type of Number for destination.

$dest_subaddress =

[line 281]

$display_time =

[line 283]

$esm_class =  NET_SMPP_MSGMODE_DEFAULT

[line 170]

Indicates Message Mode & Message Type.

This is a bitwise field to specify the message mode, type, and GSM features. See the NET_SMPP_MSGMODE_*, NET_SMPP_MSGTYPE_*, and NET_SMPP_GSMFEAT_* constants for possible values.

You will need to set this if your message has a User Data Header (UDH), for example if you are sending WAP Push messages via SMPP.

$its_reply_type =

[line 290]

$its_session_info =

[line 291]

$language_indicator =

[line 289]

$message_payload =

[line 275]

$more_messages_to_send =

[line 273]

$ms_msg_wait_facilities =

[line 286]

$ms_validity =

[line 285]

$number_of_messages =

[line 287]

$payload_type =

[line 274]

$priority_flag =

[line 186]

Designates the priority level of the message.

$privacy_indicator =

[line 276]

$protocol_id =

[line 179]

Protocol Identifier.

Network specific field.

$registered_delivery =

[line 212]

Indicator to signify if an SMSC delivery receipt or an SME acknowledgement is required.

$replace_if_present_flag =  0

[line 220]

Flag indicating if submitted message should replace an existing message.

$sar_msg_ref_num =

[line 270]

$sar_segment_seqnum =

[line 272]

$sar_total_segments =

[line 271]

$schedule_delivery_time =  null

[line 195]

The short message is to be scheduled by the SMSC for delivery.

Set to NULL for immediate delivery

$service_type =  null

[line 80]

SMS application associated with this message

Specifying the service_type allows the ESME to

• avail of enhanced messaging services such as “replace by service” type
• to control the teleservice used on the air interface.

The following generic service_types are defined:

““ (NULL) Default “CMT” Cellular Messaging “CPT” Cellular Paging “VMN” Voice Mail Notification “VMA” Voice Mail Alerting “WAP” Wireless Application Protocol “USSD” Unstructured Supplementary Services Data

Set to NULL for default SMSC settings.

$short_message =  null

[line 262]

Up to 254 octets of short message user data.

The exact physical limit for short_message size may vary according to the underlying network.

Applications which need to send messages longer than 254 octets should use the message_payload parameter. In this case the sm_length field should be set to zero.

Note: The short message data should be inserted in either the short_message or message_payload fields. Both fields must not be used simultaneously.

$sms_signal =

[line 284]

$sm_default_msg_id =  null

[line 237]

Indicates the short message to send from a list of predefined (‘canned’) short messages stored on the SMSC.

If not using an SMSC canned message, set to NULL.

$sm_length =  0

[line 244]

Length in octets of the short_message user data.

$source_addr =  null

[line 132]

Address of SME which originated this message.

If not known, set to NULL

$source_addr_npi =  NET_SMPP_NPI_UNK

[line 125]

Numbering Plan Indicator for source address

These fields define the Numeric Plan Indicator (NPI) to be used in the SME address parameters. The following NPI values are defined:

NPI Value Unknown 00000000 ISDN (E163/E164) 00000001 Data (X.121) 00000011 Telex (F.69) 00000100 Land Mobile (E.212) 00000110 National 00001000 Private 00001001 ERMES 00001010 Internet (IP) 00001110 WAP Client Id (to be 00010010 defined by WAP Forum)

If not known, set to NULL.

$source_addr_subunit =

[line 267]

$source_addr_ton =  NET_SMPP_TON_UNK

[line 100]

Type of Number for source address

These fields define the Type of Number (TON) to be used in the SME address parameters. The following TON values are defined: TON Value Unknown 00000000 (0x00) International 00000001 (0x01) National 00000010 (0x02) Network Specific 00000011 (0x03) Subscriber Number 00000100 (0x04) Alphanumeric 00000101 (0x05) Abbreviated 00000110 (0x06)

If not known, set to NULL.

$source_port =

[line 266]

$source_subaddress =

[line 280]

$user_message_reference =

[line 265]

$user_response_code =

[line 282]

$ussd_service_op =

[line 292]

$validity_period =  null

[line 204]

The validity period of this message.

Set to NULL to request the SMSC default validity period.

$_defs = array(
        'service_type' => array(
            'type' => 'string',
            'max' => 6
        ),'source_addr_ton'=>array('type'=>'int','size'=>1,),'source_addr_npi'=>array('type'=>'int','size'=>1),'source_addr'=>array('type'=>'string','max'=>21,),'dest_addr_ton'=>array('type'=>'int','size'=>1,),'dest_addr_npi'=>array('type'=>'int','size'=>1,),'destination_addr'=>array('type'=>'string','max'=>21),'esm_class'=>array('type'=>'int','size'=>1),'protocol_id'=>array('type'=>'int','size'=>1),'priority_flag'=>array('type'=>'int','size'=>1),'schedule_delivery_time'=>array('type'=>'string','max'=>17),'validity_period'=>array('type'=>'string','max'=>17,),'registered_delivery'=>array('type'=>'int','size'=>1,),'replace_if_present_flag'=>array('type'=>'int','size'=>1),'data_coding'=>array('type'=>'int','size'=>1),'sm_default_msg_id'=>array('type'=>'int','size'=>1),'sm_length'=>array('type'=>'int','size'=>1),'short_message'=>array('type'=>'ostring','max'=>254,'lenField'=>'sm_length'),// Optional params
'user_message_reference'=>array('type'=>'int','size'=>2),'source_port'=>array('type'=>'int','size'=>2),'destination_port'=>array('type'=>'int','size'=>2),'sar_msg_ref_num'=>array('type'=>'int','size'=>2),'sar_total_segments'=>array('type'=>'int','size'=>1),'sar_segment_seqnum'=>array('type'=>'int','size'=>1),'payload_type'=>array('type'=>'int','size'=>1),'message_payload'=>array('type'=>'ostring','max'=>260),'privacy_indicator'=>array('type'=>'int','size'=>1),'callback_num'=>array('type'=>'sting','min'=>4,'max'=>19),'source_subaddress'=>array('type'=>'string','min'=>2,'max'=>23),'dest_subaddress'=>array('type'=>'string','min'=>2,'max'=>23),'user_response_code'=>array('type'=>'int','size'=>1),'language_indicator'=>array('type'=>'int','size'=>1),'its_session_info'=>array('type'=>'string','size'=>2),'network_error_code'=>array('type'=>'string','size'=>3),'message_state'=>array('type'=>'int','size'=>1),'receipted_message_id'=>array('type'=>'string','min'=>1,'max'=>65))

[line 301]

Paramater definitions for this command