DISPLAY PROCEDURE command: Access privileges

From m204wiki
Revision as of 19:51, 11 November 2014 by JAL (talk | contribs) (typos)
Jump to navigation Jump to search

Summary

Privileges
Any user (only the file manager can display other users' classes)
Function
Displays the procedure access privileges for one or more user classes

Syntax

DISPLAY [PROCEDURE] (PRIVILEGES [,NOUSE]) [ALL | UCLASS=uclass [,uclass]...]

Where uclass is the identification number of an existing user class whose users have access to procedures; the number must be in the range 1 to 255.

Syntax notes

  • Parentheses and commas are required.
  • NOUSE displays access privileges on your terminal even if a USE command precedes the DISPLAY command. Any alternate device is not used, but remains open.

Example

The following example displays privileges to all user classes:

DISPLAY PROC (PRIVILEGES) ALL

The following example displays privileges for user classes 20 and 30 on your terminal:

D PROC (PRIVILEGES,NOUSE) UCLASS=20, 30 DISPLAYING PRIVILEGES FROM FILE SALESBIZ UCLASS = 20 PCLASS = 10,x'80' PCLASS = 20,x'20' PCLASS = 30,x'80' UCLASS = 30 PCLASS = 10,x'80'

Usage notes

  • If ALL is specified, Model 204 displays privilege information for all user classes. If UCLASS is specified, Model 204 displays privilege information only for the specified user classes. If neither ALL nor UCLASS is specified, Model 204 displays your class (the value of the CURCLASS parameter) and privileges. Note that only the file manager can request information on other users' classes.
  • The DISPLAY PROCEDURE command displays the privilege information stored in the Access Control Table (ACT). Entries in this table are constructed by the SECURE command. The following example depicts output for each user class:

    UCLASS=u PCLASS=pc,X'nn' . . . PCLASS=pc,X'nn'

    Where:

    u is the user class.
    pc is a procedure class with access privileges defined for that user class.
    X'nn' is an access privilege.

    Access privileges can have the settings (shown in hexadecimal) in the table below.

    Procedure access privileges

    Setting

    Meaning

    X'80'

    USE – Using the procedure (INCLUDE) allowed

    X'40'

    DISPLAY – Displaying the procedure allowed

    X'20'

    CHANGE – Changing the procedure allowed

    X'10'

    DEFINE – Defining the procedure allowed

    X'08'

    DELETE – Deleting the procedure allowed

    The access privileges can be combined in any way.