MSMQ Call Routines

MSMQSETPARMS

Creates a data descriptor that describes the actual SAS variables along with an associated data mapping. This data descriptor can then be used on a subsequent MSMQSENDMSG call.

Syntax
Arguments
Example

Syntax

CALL MSMQQSETPARMS(hData, hMap, rc, parm1 <,parm2, parm3, ...>);

Arguments

hData

Numeric, output

Returns the SAS internal data descriptor handle that is generated.

hMap

Numeric, input

Specifies the SAS internal map descriptor handle that is obtained from a previous MSMQMAP function call. If set to zero, then no external defined mapping is assumed and therefore, all data is mapped according to SAS internal representations. That is, all numerics are mapped as doubles and all strings are mapped as character data of the current string length.

rc

Numeric, output

Provides the return code from the CALL routine. If an error occurs, then the return code is nonzero. You can use the SAS function SYSMSG() to obtain a textual description of the return code.

parms

Numeric or character, input

Specifies one or more parameters that are used to define the values of SAS variables in a message.

Example

This example sets values of SAS variables into a message.

hData=0;
rc=0;
parm1=100;
parm2=9999;
parm3=9999.9999;
parm4="This is a test.";
CALL MSMQSETPARMS(hData, hMap, rc, parm1, parm2, parm3, parm4);

Top of Page