Salesforce

MSMQ Quick Send Message (Magic xpa 3.x)

Printable View
« Go Back

Information

 
Created ByKnowledge Migration User
Approval Process StatusPublished
Objective
Description

MSMQ Quick Send Message (Magic xpa 3.x)

The MSMQ Quick Send Message program opens a message queue, sends a message, and then closes the message queue. This program provides the programmer with simplicity and saves overhead, but is not efficient when you want to send a large amount of messages.

This program calls the MSMQ Open Queue, MSMQ Message Setup, MSMQ Send Message, or MSMQ Close Destination programs as needed.

The parameters and return value for the Quick Send program are:

Parameter

Description

Queue Format Name

Numeric (1). Input. A number representing the QueueInfo FormatName. The valid values are:

  • 0 (Direct=OS)

  • 1 (Direct=TCP)

  • 2 (Public)

  • 3 (Private)

Computer Name

Alpha (250). Input. The IP address, FormatName type 1, or the host name, FormatName type 0, of the host computer, or the Queue Number, FormatName type 3. The Address parameter can only be blank when the Format Name 2 (Public) is used.

Queue Name

Alpha (250). Input. A string specifying the name of the queue to open. Can also be:

  • For FormatName – Public – QueueGUID

  • For Format Name – Private – Queue Number

Message

BLOB. Input. Contains the message data.

Data Type

Alpha (1). The valid values are:

  • A: Alpha

  • N: Numeric

  • D: Date – This is really DateTime, which must be in the format of date space time; for example, 31/12/2002 14:39:46

  • L: Logical

  • V: Vector, array of bytes. A Magic xpa vector defined as having a numeric cell of 3

  • B: BLOB, broken down and sent as an array of bytes

  • O: Object, sent as-is

Picture

Alpha (30). Input optional. The Magic xpa picture of the variable. This parameter is only valid when Data type is Numeric, and in this case is mandatory.

Message Setup BLOB

BLOB. Input. This is a BLOB that holds the Memory Table explained in the Message Setup Table topic.

Transaction Mode

Alpha (1). Input. Valid values are:

  • N: No transaction

  • S: Single message transaction

  • T: Within a defined transaction

Transaction Handle

Numeric (18). Input optional. The numeric value that was returned from the MSMQ Begin Transaction program, which is mandatory when sent within a defined transaction.

Correlation Id

Vector (array of bytes). Input optional. For Send / Reply implementations. A Magic xpa vector that is defined as having a numeric cell of 3 and must be a vector of 20 cells.

Message Id

Vector (array of bytes). Output. A Magic xpa vector defined as having a numeric cell of 3, which results in a vector of 20 cells.


Return value

Numeric. 0 for success and a negative value for failure.

Reference
Attachment 
Attachment