Difference: 0LASubrRbsUpdateSecacl (2 vs. 3)

Revision 32018-11-16 - JeanNeron

Line: 1 to 1

META TOPICPARENT	name="FullAPIList"

.RBS UPDATE SECACL

Line: 8 to 8

Usage:

      PASS         <action>                   FIELD            SHARE? N
      PASS     0AD SECACL                     RECORD           SHARE? N

Added:

>
>

PASS <Child App Id Hint> FIELD SHARE? N

GOSUB --- .RBS UPDATE SECACL

- Check for errors IF --- .RBS UPDATE SECACL NE

Line: 18 to 19

<action> is ADD, CHG, DEL (case insensitive).

Added:

>
>

<Child App Id Hint> helps identify which parent / child combination you are referring to (Optional, see below).

You have to fill in the fields in SECACL depending what you want to do:

Add, Change or Delete a Process level SECACL record

Line: 37 to 40

There are many possible return codes in — .RBS UPDATE SECACL, most are pretty self explanatory but a few need more detail:

SECACL file not found - Couldn’t open SECACL, could be because it needs restructuring or hasn't been created for the application.
Prnt/Chld Not Found - The specified parent/child doesn’t exist in 0SA XREF. You might need to regenerate your applications. See .RBS REGEN.
SECACL Not Found - The specified SECACL record does not exist (change/delete)
Invalid Fld Acc/Chg - You have specified SECACL FIELD ACCESS = N and SECACL FIELD CHANGE = Y, which doesn’t make sense

Added:

>
>

<Child App Id Hint> is used when there is more than one child of the same name for the given parent. The SECACL file is maintained in the Child's application, so the API needs to know which Application to open. The Child's Applicaiton Id is not specified in the SECACL record, so it is extrapolated from the 0SA XREF file. However, if there is more than one child with the same name for that parent, the API won't know which one you are referring to and will simply pick the first one it finds. If you pass this Application Id, then the API will know which child you are referring to. For example, consider a main system menu with options for G/L, A/R, A/P, etc. There is a good chance that all the main menus in those applications are called MAIN MENU (or similar). In that case, we have one parent (the main system menu) with several children all with the same name (MAIN MENU). You can pass the <Child Ap Id Hint> to indicate which child you are referring to.

Comments:

Read what other users have said about this page or add your own comments.

View topic | History: r4 < r3 < r2 < r1 | More topic actions...