QUEUE_SETSEC

QUEUE_SETSEC

Set queue security.

Syntax
QUEUE_SETSEC Example

Syntax

CALL QUEUE_SETSEC(queueId, rc, security);

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

queueId N queue identifier

rc N return code

security C security permissions string

Where...	Is type...	And represents...
queueId	N	queue identifier
rc	N	return code
security	C	security permissions string

The QUEUE_SETSEC routine allows you to set the permissions or privileges that are associated with a specific queue.

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 security parameter is the access control list for the queue. This parameter is sent in the form of

'user1:permissions,user2:permissions,...'
where permissions is one or more of the following separated by a plus sign (+):

DELIVER|D: Deliver privileges.
FETCH|F: Fetch privileges.
BROWSE|B: Browse privileges.
GETPROP|GP: Get properties privileges.
SETPROP|SP: Set properties privileges.
GETSEC|GS: Get security privileges.
SETSEC|SS: Set security privileges.
ALL: Full privileges.

QUEUE_SETSEC Example

This example sets two user privileges for a specific queue. The first user (USER1) is defined to have all or full privileges. Full privileges consist of the following: deliver, fetch, browse, get properties, set properties, get security, and set security. The second user (USER2) is defined to have only browse, get properties, and get security privileges.

length security $200;
security="user1:all,user2:b+gp+gs";
call queue_setsec(qid, rc, security);

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

Chapter Contents
Previous
Next
Top of Page