9 213 SET_AUTHORITY

LANSA Technical

9.213 SET_AUTHORITY

Þ Note: Built-In Function Rules.

Sets the authority of a user to a LANSA object. The caller of this Built-In Function must have management rights (MD) to the LANSA object.

Special Notes: 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

Changes to a user's access rights to LANSA objects may not take effect until the next time the user starts to use LANSA. If the user is currently using LANSA they should exit from LANSA and then re-invoke LANSA to ensure that the changed object access rights take effect.

This condition also applies to the caller of SET_AUTHORITY changing their own authorities to objects.

Changes to authority will have no impact if security checking is disabled for the type of object (process, function, or file). To determine your security settings on IBM i refer to Execution and Security Settings in the Review System Settings facility described in the LANSA for i User Guide. To determine your security settings on Windows, or applications deployed to Linux, refer to the x_defppp.h file that you compiled your processes and forms with. You can find out more about this file in The X_DEFppp.H Definition Header File.

For use with

LANSA for i

YES

Not available for RDMLX.

Visual LANSA for Windows

YES*

Object Types P# (Partition) and AT (Application Template) have no meaning to Visual LANSA. If passed to this Built-In Function an error is returned.

Visual LANSA for Linux

YES

 

 

 

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.

*Do not use with Visual LANSA.

2

2

 

 

4

A

Req

User name.

1

10

 

 

5

A

Req

Access rights

This is a string of 2 character codes representing the different access rights that the user is to have.

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 is to have their access rights to the object revoked.

If the string has the special value '*DELETE' then the user's authority is to be deleted, thus causing their rights to revert back to their associated group profile or *PUBLIC.

1

20

 

 

 

 

Dependencies

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

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Req

Return code

OK = The authority of the user to the LANSA object has been set.
ER = Error occurred in setting the authority of the user to the object.

2

2