.set paragraph 0 .autoparagraph .nonumber .left margin 0 1 PROJECT .left margin 2 Allows a project administrator to grant a project identifier to or revoke a project identifier from any VMS username, thus allowing or denying that username access to the project. PROJECT also allows anyone to list the current holders of a project's identifier and determine who the project administrator is. Format: .literal PROJECT [option identifier [user]] .end literal .left margin 0 2 Parameters .left margin 2 option .left margin 3 Specifies an action to be performed. If you do not specify any parameters on the command line, PROJECT will prompt for multiple commands. .left margin 2 identifier .left margin 3 Specifies the identifier that represents the project. .left margin 2 user .left margin 3 Specifies a username to be added to or removed from a project. .left margin 0 2 ADD .left margin 2 ADD is a synonym for GRANT. See GRANT for more information. .left margin 0 2 EXIT .left margin 2 The EXIT option terminates PROJECT. Typing CTRL/Z or F10 will also terminate PROJECT. .left margin 0 2 GRANT .left margin 2 Assigns a project identifier to a username, thus allowing the user to access the project's files. Format: .literal GRANT identifier user .end literal .left margin 0 .right margin -2 3 Parameters .left margin 2 identifier .left margin 3 The identifier that represents the project and which owns all of the project's files. Only project administrators are allowed to grant identifiers. A project administrator is someone who holds an identifier starting with the project identifier and ending with the characters "__ADMIN". For example, the project identifier for LaTeX support is TEX__SUPPORT. The project administrator for this project will hold the identifier TEX__SUPPORT__ADMIN. If you believe you need access to a project, you will need to contact someone holding the "__ADMIN" identifier for that project, who can then grant you access to the project files. If you are the administrator for a project and don't know the project's identifier, you can display the identifiers you hold with the SHOW#PROCESS/RIGHTS command. The identifiers you see that end in "__ADMIN" will indicate the projects you administer. You can also determine the identifier for a project by using the DIRECTORY/OWNER command on any file in the project directory. Wild cards are not allowed. .left margin 2 user .left margin 3 Specifies a username to which the project identifier is to be granted. Granting an identifier to a username enables that username to access a project's files. .left margin 0 3 Command__qualifiers .break /FILE .left margin 2 /FILE Used in conjunction with the user parameter, where it must immediately follow the user parameter, this qualifier indicates that the parameter is not a username, but is instead a file containing a list of usernames. This file must be formatted in a fashion similar to a VMS Mail distribution list. It must contain one username per line. Comment lines are allowed, using an exclamation mark as the comment delimiter. The default file type is .DIS. .right margin +2 .left margin 0 2 HELP .left margin 2 Displays information about the various commands and qualifiers for PROJECT. Format: .literal HELP [topic...] .end literal .left margin 0 3 Parameters .left margin 2 .right margin -2 topic .left margin 3 The topic on which help is to be displayed. If no topic is specified, PROJECT will prompt you for a topic. .right margin +2 .left margin 0 2 LIST .left margin 2 Displays the list of usernames that currently have access to a project. Anyone may list the people holding a project identifier. LIST can also be used to determine the administrators for a project by listing the identifier formed by concatenating the letters "__ADMIN" to the project identifier. For example, the administrators of the TEX__SUPPORT project can be found by listing the holders of the TEX__SUPPORT__ADMIN identifier. Format: .literal LIST identifier .end literal .left margin 0 3 Parameters .left margin 2 .right margin -2 identifier .left margin 3 Specifies the identifier representing the project. Wild cards are not allowed. .left margin 0 3 Command__qualifiers .break /OUTPUT .left margin 2 /OUTPUT[=filespec] Controls where the output of the LIST command is to be sent. If you include a file specification, the output is written to that file. The default file type for the output file is .DIS. If you do not enter this qualifier or you enter it without a file specification, output is sent to SYS$OUTPUT. .right margin +2 .left margin 0 2 QUIT .left margin 2 QUIT is a synonym of EXIT. See EXIT for more information. .left margin 0 2 REMOVE .left margin 2 REMOVE is a synonym of REVOKE. See REVOKE for more information. .left margin 0 2 REVOKE .left margin 2 Takes a project identifer away from a username, thus preventing access to the project files for a username. Format: .literal REVOKE identifier user .end literal .left margin 0 .right margin -2 3 Parameters .left margin 2 identifier .left margin 3 The identifier that represents the project and which owns all of the project's files. Only project administrators are allowed to revoke identifiers. A project administrator is someone who holds an identifier starting with the project identifier and ending with the characters "__ADMIN". For example, the project identifier for LaTeX support is TEX__SUPPORT. The project administrator for this project will hold the identifier TEX__SUPPORT__ADMIN. Once you are no longer going to work on a particular project, you will need to contact someone holding the "__ADMIN" identifier for that project, who can then revoke your access to the project files. If you are the administrator for a project and don't know the project's identifier, you can display the identifiers you hold with the SHOW#PROCESS/RIGHTS command. The identifiers you see that end in "__ADMIN" will indicate the projects you administer. You can also determine the identifier for a project by using the DIRECTORY/OWNER command on any file in the project directory. Wild cards are not allowed. .left margin 2 user .left margin 3 Specifies a username from which the project identifier is to be revoked. Revoking an identifier from a username prevents that username from accessing a project's files. .left margin 0 3 Command__qualifiers .break /FILE .left margin 2 /FILE Used in conjunction with the user parameter, where it must immediately follow the user parameter, this qualifier indicates that the parameter is not a username, but is instead a file containing a list of usernames. This file must be formatted in a fashion similar to a VMS Mail distribution list. It must contain one username per line. Comment lines are allowed, using an exclamation mark as the comment delimiter. The default file type is .DIS. .right margin +2 .left margin 0 2 SHOW .left margin 2 SHOW is a synonym of LIST. See LIST for more information. .left margin 0 2 Examples .list .list element;$ PROJECT LIST TEX__SUPPORT This command lists all of the holders of the TEX__SUPPORT identifier; that is, all those working on the LaTeX/TeX support project. .list element;$ PROJECT LIST/OUTPUT=maids MAIDS__ADMIN This command lists all of the project administrators for the MAIDS project, placing the result in the file MAIDS.DIS. This file can then be used in a VMS Mail message to the project administrators. .list element;$ PROJECT GRANT SQA JONES This command, which can be entered only by one of the SQA project administrators, grants the user named JONES access to the SQA project files. .list element;$ PROJECT REVOKE TRAINING USERLIST/FILE This command, which can be entered only by one of the TRAINING project administrators, revokes access to the TRAINING project files to all of the users whose names are contained in the file USERLIST.DIS. .list element;$ PROJECT This command causes PROJECT to begin to prompt for commands. You may enter as many commands at this point as you choose, like this: PROJECT> GRANT SFDR__SW MYLIST/FILE .break PROJECT> LIST SFDR__SW .break PROJECT> REVOKE SFDR__SW SMITH .break PROJECT> EXIT In this example, the SFDR__SW project administrator grants the project identifier to all of the usernames contained within the distribution list file MYLIST.DIS. The administrator then reviews the list of people who currently have access to the SFDR__SW project files and discovers that there is one person in the list who should not have access. The adminstrator removes that access and exits the PROJECT program. .end list .! VAX/DEC CMS REPLACEMENT HISTORY, Element PROJECT.RNH .! *1 31-MAR-1994 12:10:42 TILLMAN "DCL-level help for PROJECT" .! VAX/DEC CMS REPLACEMENT HISTORY, Element PROJECT.RNH