QUEUE_GETSEC

QUEUE_GETSEC

Set queue security.

Syntax
QUEUE_GETSEC Example

Syntax

CALL QUEUE_GETSEC(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_GETSEC routine allows you to obtain information about the permissions or privileges that are associated with a particular 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 returned in the form

'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_GETSEC Example

This example obtains a list of user privileges for a specific queue.

length security $200;
security="";
call queue_getsec(qid, rc, security);

if rc ne 0 then do;
   msg = sysmsg();
   put msg;
end;
else do;
   put 'User Access Rights:';
   put security;
end;

Chapter Contents
Previous
Next
Top of Page