9 76 GET_AUTHORITIES

You are here:

9.76 GET_AUTHORITIES

Note: Built-In Function Rules Usage Options

Retrieves a list of authorities to LANSA objects and returns it to the calling RDML function in a variable length working list.

Special Note: This Built-In Function provides access to very advanced facilities that basically allow RDML functions to construct new RDML applications.

This is a very specialized area that requires very good knowledge of the LANSA product. Use of this Built-In Function in a "commercial" application (e.g. Order Entry) is not normal and should not be attempted.

Arguments

No	Type	Req/ Opt	Description	Min Len	Max Len	Min Dec	Max Dec
1	A	Req	Object name.	1	10
2	A	Req	Object extension.	1	10
3	A	Req	Object type. Valid types are: AT - Application template DF - Field FD - File PD - Process PF - Function P# - Partition SV - System variable MT - Multilingual variable	2	2
4	A	Opt	User name.	1	10

Dependencies

If any of Object type, Object name or Object extension are specified, then all three must be specified according to the following table.

Object Type	Object Name	Object Extension
AT	template name	*blank
DF	field name	*blank
FD	file name	blank, LIBL, library name
PD	process name	*blank
PF	process name	function name
P#	partition name	*blank
SV	positions 1-10 of system variable name	positions 11-20 of system variable name
MT	positions 1-10 of multilingual variable name	positions 11-20 of multilingual variable name

Return Values

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

Req

Return code

OK = list returned partially or completely filled. No more authorities that match the arguments exist

OV = list returned completely filled, but more authorities that match the arguments than could fit in the list exist.

NR = No authorities that match the arguments exist. Last entry in the list is returned as null.

ER = Error in the arguments passed. Last entry in the list is returned as null.

Req

Working list of authorities.

If Object type, name and extension are specified but not User, then as many authorities of users to the object as fit in the list will be returned.

If User is specified but not Object type, name and extension, then as many authorities of the user to different objects as fit in the list will be returned.

If Object type, name, extension and User are specified, and the user is specifically authorized to the object then the authority of the user to the object will be returned in the list.

If the user is not specifically authorized to the object no authorities will be returned.

The calling RDML function must provide a working list with an aggregate entry length of exactly 70 bytes.

List cannot be more than:
32767 entries in Windows
9999 entries on IBM i.

From - To Description

1 - 10 Object name

11 - 20 Object extension

21 - 22 Object type (see above for object type explanation)

23 - 32 User name

33 - 52 Access rights
This is a string of 2 character codes representing the different access rights that the user has to the object.

The individual access rights are:

UD - Use Definition
MD - Manage Definition
DD - Existence of Definition
DS - Data - Display
AD - Data - Add
CH - Data - Change
DL - Data - Delete

If the entire string is blank then the user has had their access rights to the object revoked.

53 - 70 <<future expansion>>