smpp_codec::pdus::session_pdus::generic_nack

Struct GenericNack

pub struct GenericNack {
    pub sequence_number: u32,
    pub command_status: u32,
    pub status_name: String,
}

Expand description

Represents a Generic NACK PDU.

Sent when a PDU cannot be identified or is malformed (e.g., invalid Command ID).

Fields§

§sequence_number: u32§command_status: u32§status_name: String

Implementations§

Source §

impl GenericNack

Source

pub fn new(status_name: &str, sequence_number: u32) -> Self

Create a new Generic NACK.

§Examples

use smpp_codec::pdus::GenericNack;

let sequence_number: u32 = 1;
let nack = GenericNack::new("ESME_RINVCMDID", sequence_number);

Examples found in repository ?

examples/generic_nack.rs (lines 8-11)

3fn main() {
4    println!("=== SMPP Generic Nack Example ===");
5
6    // 1. Create Generic Nack
7    // Used when an invalid command_id is received (header decoding fails or unknown command)
8    let nack = GenericNack::new(
9        "ESME_RINVCMDID", // Status Name
10        500,              // Sequence Number of the failed request
11    );
12
13    println!("Generic Nack: {:?}", nack);
14
15    // 2. Encode
16    let mut buf = Vec::new();
17    nack.encode(&mut buf).unwrap();
18    println!("Encoded {} bytes", buf.len());
19
20    // 3. Decode verification
21    let decoded = GenericNack::decode(&buf).unwrap();
22    println!("Decoded Command Status: 0x{:08X}", decoded.command_status);
23}

Source

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

Encode the struct into raw bytes for the network.

§Errors

Returns a PduError if an I/O error occurs while writing.

§Examples

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

Examples found in repository ?

examples/generic_nack.rs (line 17)

3fn main() {
4    println!("=== SMPP Generic Nack Example ===");
5
6    // 1. Create Generic Nack
7    // Used when an invalid command_id is received (header decoding fails or unknown command)
8    let nack = GenericNack::new(
9        "ESME_RINVCMDID", // Status Name
10        500,              // Sequence Number of the failed request
11    );
12
13    println!("Generic Nack: {:?}", nack);
14
15    // 2. Encode
16    let mut buf = Vec::new();
17    nack.encode(&mut buf).unwrap();
18    println!("Encoded {} bytes", buf.len());
19
20    // 3. Decode verification
21    let decoded = GenericNack::decode(&buf).unwrap();
22    println!("Decoded Command Status: 0x{:08X}", decoded.command_status);
23}

Source

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.

§Examples

let decoded = GenericNack::decode(&buffer).expect("Decoding failed");
assert_eq!(decoded.status_name, "ESME_RINVCMDID");

Examples found in repository ?

examples/generic_nack.rs (line 21)

3fn main() {
4    println!("=== SMPP Generic Nack Example ===");
5
6    // 1. Create Generic Nack
7    // Used when an invalid command_id is received (header decoding fails or unknown command)
8    let nack = GenericNack::new(
9        "ESME_RINVCMDID", // Status Name
10        500,              // Sequence Number of the failed request
11    );
12
13    println!("Generic Nack: {:?}", nack);
14
15    // 2. Encode
16    let mut buf = Vec::new();
17    nack.encode(&mut buf).unwrap();
18    println!("Encoded {} bytes", buf.len());
19
20    // 3. Decode verification
21    let decoded = GenericNack::decode(&buf).unwrap();
22    println!("Decoded Command Status: 0x{:08X}", decoded.command_status);
23}