QUEUE_SETPROP

QUEUE_SETPROP

Set queue properties.

Syntax
QUEUE_SETPROP Example

Syntax

CALL QUEUE_SETPROP(queueId, rc, dlvrmode, maxdepth, maxmsgl);

Where... Is type... And represents...

queueId N queue identifier

rc N return code

dlvrmode C message delivery mode

maxdepth N queue maximum depth allowed

maxmsgl N queue maximum message length allowed

Where...	Is type...	And represents...
queueId	N	queue identifier
rc	N	return code
dlvrmode	C	message delivery mode
maxdepth	N	queue maximum depth allowed
maxmsgl	N	queue maximum message length allowed

The QUEUE_SETPROP routine allows you to set certain queue properties. In particular, you may set message delivery mode if there are no active (open) fetch or browse queue instances. You may also set the maximum queue depth as well as the maximum message length.

If an error or a warning condition is encountered, a non-zero return code is returned in the rc parameter. Use the SYSMSG() function to print the message that is associated with the non-zero rc.

The dlvrmode parameter indicates the queue's message delivery mode:

DEFAULT: A query on the queue retrieves the message header information as well as the actual message.
NOTICE: A query on the queue retrieves the message header information only.

The maxdepth parameter indicates the maximum number of messages that can be held by the queue (-1 is unlimited).

The maxmsgl parameter indicates the maximum length of a message for the queue (-1 is unlimited).

QUEUE_SETPROP Example

This example re-sets the message delivery mode to NOTICE as well as sets the maximum depth and maximum message length. If you do not want to set a particular queue property, set its value to an empty string if its type is character, or set its value to missing if its type is numeric.

length dlvrmode $20;
length maxdepth maxmsgl 8;

dlvrmode="notice";
maxdepth=50;
maxmsgl=4096;
call queue_setprop(qid, rc, dlvrmode, 
                   missing, missing);

if rc ^= 0 then do;
   msg = sysmsg();
   put msg;
end;
else put 'Setprop was successful';

Chapter Contents
Previous
Next
Top of Page