Struct AlertNotification 

pub struct AlertNotification {
    pub sequence_number: u32,
    pub source_addr_ton: Ton,
    pub source_addr_npi: Npi,
    pub source_addr: String,
    pub esme_addr_ton: Ton,
    pub esme_addr_npi: Npi,
    pub esme_addr: String,
    pub optional_params: Vec<Tlv>,
}

Represents an Alert Notification PDU.

Sent by the SMSC to the ESME to provide information about a message state (e.g., delivered).

Fields

sequence_number: u32

source_addr_ton: Ton

source_addr_npi: Npi

source_addr: String

esme_addr_ton: Ton

esme_addr_npi: Npi

esme_addr: String

optional_params: Vec<Tlv>

Implementations

impl AlertNotification

pub fn new(sequence_number: u32, source_addr: String, esme_addr: String) -> Self

Create a new Alert Notification.

Examples

use smpp_codec::pdus::AlertNotification;

let sequence_number: u32 = 1;
let alert = AlertNotification::new(
    sequence_number,
    "source_addr".to_string(),
    "esme_addr".to_string()
);

Examples found in repository

examples/alert_notification.rs (lines 9-13)

fn main() {
    println!("=== SMPP Alert Notification Example ===");

    // 1. Create Alert Notification
    let mut alert = AlertNotification::new(
        200, // Sequence number
        "source_addr".to_string(),
        "esme_addr".to_string(),
    )
    .with_source_addr(Ton::International, Npi::Isdn, "123".to_string())
    .with_esme_addr(Ton::National, Npi::Telex, "456".to_string());

    // 2. Add optional TLV (e.g., ms_availability_status)
    // Tag 0x0402 is ms_availability_status
    let tlv = Tlv::new_u8(0x0402, 1); // 1 = Available
    alert.add_tlv(tlv);

    println!("Alert Notification: {:?}", alert);

    // 3. Encode
    let mut buf = Vec::new();
    alert.encode(&mut buf).unwrap();
    println!("Encoded {} bytes", buf.len());
}

pub fn with_source_addr(self, ton: Ton, npi: Npi, addr: String) -> Self

Examples found in repository

examples/alert_notification.rs (line 14)

fn main() {
    println!("=== SMPP Alert Notification Example ===");

    // 1. Create Alert Notification
    let mut alert = AlertNotification::new(
        200, // Sequence number
        "source_addr".to_string(),
        "esme_addr".to_string(),
    )
    .with_source_addr(Ton::International, Npi::Isdn, "123".to_string())
    .with_esme_addr(Ton::National, Npi::Telex, "456".to_string());

    // 2. Add optional TLV (e.g., ms_availability_status)
    // Tag 0x0402 is ms_availability_status
    let tlv = Tlv::new_u8(0x0402, 1); // 1 = Available
    alert.add_tlv(tlv);

    println!("Alert Notification: {:?}", alert);

    // 3. Encode
    let mut buf = Vec::new();
    alert.encode(&mut buf).unwrap();
    println!("Encoded {} bytes", buf.len());
}

pub fn with_esme_addr(self, ton: Ton, npi: Npi, addr: String) -> Self

Examples found in repository

examples/alert_notification.rs (line 15)

fn main() {
    println!("=== SMPP Alert Notification Example ===");

    // 1. Create Alert Notification
    let mut alert = AlertNotification::new(
        200, // Sequence number
        "source_addr".to_string(),
        "esme_addr".to_string(),
    )
    .with_source_addr(Ton::International, Npi::Isdn, "123".to_string())
    .with_esme_addr(Ton::National, Npi::Telex, "456".to_string());

    // 2. Add optional TLV (e.g., ms_availability_status)
    // Tag 0x0402 is ms_availability_status
    let tlv = Tlv::new_u8(0x0402, 1); // 1 = Available
    alert.add_tlv(tlv);

    println!("Alert Notification: {:?}", alert);

    // 3. Encode
    let mut buf = Vec::new();
    alert.encode(&mut buf).unwrap();
    println!("Encoded {} bytes", buf.len());
}

pub fn add_tlv(&mut self, tlv: Tlv)

Add a generic TLV

Examples found in repository

examples/alert_notification.rs (line 20)

fn main() {
    println!("=== SMPP Alert Notification Example ===");

    // 1. Create Alert Notification
    let mut alert = AlertNotification::new(
        200, // Sequence number
        "source_addr".to_string(),
        "esme_addr".to_string(),
    )
    .with_source_addr(Ton::International, Npi::Isdn, "123".to_string())
    .with_esme_addr(Ton::National, Npi::Telex, "456".to_string());

    // 2. Add optional TLV (e.g., ms_availability_status)
    // Tag 0x0402 is ms_availability_status
    let tlv = Tlv::new_u8(0x0402, 1); // 1 = Available
    alert.add_tlv(tlv);

    println!("Alert Notification: {:?}", alert);

    // 3. Encode
    let mut buf = Vec::new();
    alert.encode(&mut buf).unwrap();
    println!("Encoded {} bytes", buf.len());
}

pub fn encode(&self, writer: &mut impl Write) -> Result<(), PduError>

Encode the struct into raw bytes for the network.

Errors

Returns a PduError if:

• source_addr exceeds 65 characters.
• esme_addr exceeds 65 characters.
• An I/O error occurs while writing.

Examples

let mut buffer = Vec::new();
alert.encode(&mut buffer).expect("Encoding failed");

Examples found in repository

examples/alert_notification.rs (line 26)

fn main() {
    println!("=== SMPP Alert Notification Example ===");

    // 1. Create Alert Notification
    let mut alert = AlertNotification::new(
        200, // Sequence number
        "source_addr".to_string(),
        "esme_addr".to_string(),
    )
    .with_source_addr(Ton::International, Npi::Isdn, "123".to_string())
    .with_esme_addr(Ton::National, Npi::Telex, "456".to_string());

    // 2. Add optional TLV (e.g., ms_availability_status)
    // Tag 0x0402 is ms_availability_status
    let tlv = Tlv::new_u8(0x0402, 1); // 1 = Available
    alert.add_tlv(tlv);

    println!("Alert Notification: {:?}", alert);

    // 3. Encode
    let mut buf = Vec::new();
    alert.encode(&mut buf).unwrap();
    println!("Encoded {} bytes", buf.len());
}

pub fn decode(buffer: &[u8]) -> Result<Self, PduError>

Decode raw bytes from the network into the struct.

Errors

Returns a PduError if:

• The buffer is too short.
• The buffer data is malformed.

Examples

let decoded = AlertNotification::decode(&buffer).expect("Decoding failed");
assert_eq!(decoded.source_addr, "src");

Trait Implementations

impl Clone for AlertNotification

fn clone(&self) -> AlertNotification

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AlertNotification

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.