HELPLIB.HLB  —  CMS  SHOW  ACL
    Displays the access control list (ACL) associated with the
    specified object or objects.

       Format:

          SHOW ACL  object-expression /OBJECT_TYPE=type

1  –  Command Parameters

 object-expression

    Specifies the CMS library object whose ACL is to be displayed.
    Wildcards and a comma list are allowed.

    The object name depends on the object type (see the /OBJECT_TYPE
    qualifier). For example, if the object type is CLASS, the object
    name is the name of a class in the CMS library. The same principle
    applies to elements and groups. If the object type is LIBRARY, the
    object expression must be a list of one or more of the following
    keywords:

       ELEMENT_LIST
       CLASS_LIST
       GROUP_LIST
       HISTORY
       LIBRARY_ATTRIBUTES

    These keywords are called object subtypes. You can abbreviate
    object subtypes. Wildcards are not allowed.

    The object name can also be the name of a CMS command. If /OBJECT_
    TYPE is specified as COMMAND, SHOW ACL displays the ACL for the
    given command.

2  –  Description

    The SHOW ACL command displays the ACL associated with the
    specified object or objects.

3  –  Qualifiers

3.1    /APPEND

    Controls whether CMS appends the command output to an existing
    file, or creates a new file. If you specify /APPEND and the output
    file does not exist, CMS creates a new file. If you do not provide
    a file specification (see the description for /OUTPUT), the output
    is appended to SYS$OUTPUT.

3.2    /OBJECT_TYPE=type

    Specifies the type of the object whose ACL is to be displayed.
    There is no default object type; therefore, this qualifier is
    required. The object type can be one of the following keywords:

       ELEMENT
       CLASS
       GROUP
       LIBRARY
       COMMAND

3.3    /OCCLUDE[=option,...]

    Controls whether CMS selects the first instance of the specified
    object, or all instances of the specified object in the library
    search list. The options field contains one or more keywords
    associated with the name of the object. The options field can
    contain the following keywords:

       ALL--equivalent to (ELEMENT, GROUP, CLASS, OTHER)
       ELEMENT (D)
       NOELEMENT
       GROUP (D)
       NOGROUP
       CLASS (D)
       NOCLASS
       OTHER (D)
       NOOTHER
       NONE--equivalent to (NOELEMENT, NOGROUP, NOCLASS, NOOTHER)

    You can specify either ALL or NONE, or any combination of the
    [NO]ELEMENT, [NO]GROUP, [NO]CLASS, and [NO]OTHER keywords.

    By default, CMS performs occlusion for all objects; that is, CMS
    selects only the first occurrence of a specified object.

3.4    /OUTPUT[=file-specification]

    Directs CMS to write output to the specified file, except for any
    warning and error messages, which are written to SYS$OUTPUT and
    SYS$ERROR. CMS creates a new file if you do not specify /APPEND.
    If you omit the /OUTPUT qualifier (or if you specify /OUTPUT
    but do not provide a file specification), CMS directs output to
    the default output device (SYS$OUTPUT). If you omit either the
    file name or the file type component, CMS supplies the missing
    component from the default specification.

4  –  Example

    CMS> SHOW ACL/OBJECT=ELEMENT SAMPLE.PAS

    ACLs in CMS Library DISKX:[PROJECT.CMSLIB]

    SAMPLE.PAS
             (IDENTIFIER=[PROJECT,WALLEN],ACCESS=FETCH)

      This command displays the ACE on element SAMPLE.PAS.
Close Help