Using the AUTHLIST Command

Another way to find out information on authorizations for a file or directory is by using PF keys on the DIRLIST and FILELIST screen to enter the AUTHLIST command. As discussed in Navigating Through Your Directories, you can display the FILELIST STATS screen and then press PF10 to display the SHARE screen, or you can specify the SHARE option of FILELIST to display the SHARE screen directly.

For example, assume that you had previously granted authority for the COOKIES SCRIPT file in your .PARTY.TREATS directory (accessed as E) to MAINT and to RALPHW. To determine whether you gave each user READ or WRITE authority to the file, you could use the AUTHLIST command.

For example, enter the following command:

filelist cookies script e (share

Figure 1 displays what your screen should look like.

Figure 1. Using the PF Keys on the FILELIST SHARE Screen

yourid   FILELIST A0  V 149  1 Line=1 Col=1 Alt=0
Directory = VMSYSU:yourid.PARTY.
Cmd   Filename Filetype Fm Owner    Type    R W
 _    COOKIES  SCRIPT   E1 yourid   BASE    X X
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1= Help       2= Refresh  3= Quit   4= Cancel      5= Sort(dir)   6= Auth
7= Backward   8= Forward  9= Alias 10= Stats      11= XEDIT/LIST 12= Cursor
 
====>
                                                            X E D I T  1 File

Positioning your cursor on the line for the COOKIES SCRIPT file and pressing PF6, would result in:

Figure 2. Entering the AUTHLIST Command

yourid   AUTHLIST A0  V 165  3 Line=1 Col=1 Alt=0
File = COOKIES SCRIPT VMSYSU:yourid.PARTY.TREATS
Grantee  R  W
yourid   X  X
MAINT    X  -
RALPHW   X  X
 
 
 
 
 
 
 
 
 
 
 
 
 
1= Help       2= Refresh  3= Return 4= S(Grantee)  5= Sort(W)     6=
7= Backward   8= Forward  9=       10=            11=            12=
 
====> _
                                                            X E D I T  1 File

The information you receive is similar to the information you received when entering the QUERY AUTHORITY command.

Note: Remember that the file pool administrator will also have authority to your files and directories. However, his or her user ID will not appear in the output of the QUERY AUTHORITY or AUTHLIST commands.

Table 1 lists the following PF keys on the AUTHLIST screen that you can use to sort the information displayed on your screen:

Table 1. AUTHLIST PF Keys
Key	Meaning	Usage
PF4	S(Grantee)	Sorts the files displayed alphabetically by grantee.
PF5	Sort(W)	Grantees with WRITE authority to the file are listed alphabetically, then other grantees are listed alphabetically.

When you enter an AUTHLIST command for a directory, you will see additional columns on the AUTHLIST screen. For FILECONTROL directories, these columns indicate whether a user has NEWREAD or NEWWRITE authority. For DIRCONTROL directories, the columns indicate DIRREAD or DIRWRITE authority. For more information on the AUTHLIST command, see z/VM: CMS Commands and Utilities Reference.

Note: If the QUERY AUTHORITY or AUTHLIST command output shows XP or -P in the Read or Write column, the file shown is protected by an external security manager that is active on your system. Here, you will need to enter special ESM commands to determine who has authority to the file. Contact your system administrator to obtain these commands.