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.