% VAX-11 Librarian V04-00ݡjĊ5PROJECTjĊ 1 PROJECTH Allows a project administrator to grant a project identifier to orH revoke a project identifier from any VMS username, thus allowing orH denying that username access to the project. PROJECT also allowsH anyone to list the current holders of a project's identifier and- determine who the project administrator is. Format:( PROJECT [option identifier [user]] 2 Parameters optionH Specifies an action to be performed. If  you do not specify anyH parameters on the command line, PROJECT will prompt for multiple commands. identifier8 Specifies the identifier that represents the project. userA Specifies a username to be added to or removed from a project.2 ADD> ADD is a synonym for GRANT. See GRANT for more information.2 EXITH The EXIT option terminates PROJECT. Typing CTRL/Z or F10 will also terminate PROJECT.2 GRANTH Assigns a project identifier to a username, th us allowing the user to access the project's files. Format: GRANT identifier user 3 Parameters identifierF The identifier that represents the project and which owns all ofF the project's files. Only project administrators are allowed toF grant identifiers. A project administrator is someone who holds anF identifier starting with the project identifier and ending with theF characters "_ADMIN". For example, the project identifier for LaTeXF support i s TEX_SUPPORT. The project administrator for this projectF will hold the identifier TEX_SUPPORT_ADMIN. If you believe youF need access to a project, you will need to contact someone holdingF the "_ADMIN" identifier for that project, who can then grant you access to the project files.F If you are the administrator for a project and don't know theF project's identifier, you can display the identifiers you hold withF the SHOW PROCESS/RIGHTS command. The identifie rs you see that endF in "_ADMIN" will indicate the projects you administer. You canF 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. userF Specifies a username to which the project identifier is to beF granted. Granting an identifier to a username enables that( username to access a project's files.3 Command_qualifiers/FILE /FILEF Used in conjunction with the user parameter, where it mustF immediately follow the user parameter, this qualifier indicates thatF the parameter is not a username, but is instead a file containing aF list of usernames. This file must be formatted in a fashion similarF to a VMS Mail distribution list. It must contain one username perF line. Comment lines are allowed, using an exclamation mark as the4 comment delimiter. The default file type is .DIS.2 HELPH Displays information about the various commands and qualifiers for PROJECT. Format: HELP [topic...] 3 Parameters topicF The topic on which help is to be displayed. If no topic is2 specified, PROJECT will prompt you for a topic.2 LISTH Displays the list of usernames that currently have access to aH project. Anyone may list the people holding a project identifier.H LIST can also be used to determine the administrators for a project byH listing the identifier formed by concatenating the letters "_ADMIN" toH the project identifier. For example, the administrators of theH TEX_SUPPORT project can be found by listing the holders of the TEX_SUPPORT_ADMIN identifier. Format: LIST identifier 3 Parameters identifierF Specifies the identifier representing the project. Wild cards are not allowed.3 Command_qualifiers/OUTPUT /OUTPUT[=filespec]F Controls where the output of the LIST comman d is to be sent. If youF include a file specification, the output is written to that file.F The default file type for the output file is .DIS. If you do notF enter this qualifier or you enter it without a file specification, output is sent to SYS$OUTPUT.2 QUIT< QUIT is a synonym of EXIT. See EXIT for more information.2 REMOVEB REMOVE is a synonym of REVOKE. See REVOKE for more information.2 REVOKEH Takes a project identifer away from a username, thus preventing access& to the project files for a username. Format: REVOKE identifier user 3 Parameters identifierF The identifier that represents the project and which owns all ofF the project's files. Only project administrators are allowed toF revoke identifiers. A project administrator is someone who holdsF an identifier starting with the project identifier and ending withF the characters "_ADMIN". For example, the project identifier forF LaTeX support is TEX_ SUPPORT. The project administrator for thisF project will hold the identifier TEX_SUPPORT_ADMIN. Once you areF no longer going to work on a particular project, you will need toF contact someone holding the "_ADMIN" identifier for that project,8 who can then revoke your access to the project files.F If you are the administrator for a project and don't know theF project's identifier, you can display the identifiers you hold withF the SHOW PROCESS/RIGHTS command. The identifiers you see that endF in "_ADMIN" will indicate the projects you administer. You canF 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. userF Specifies a username from which the project identifier is to beF revoked. Revoking an identifier from a username prevents that- username from accessing a project's files.3 Command_qualifiers/FIL E /FILEF Used in conjunction with the user parameter, where it mustF immediately follow the user parameter, this qualifier indicates thatF the parameter is not a username, but is instead a file containing aF list of usernames. This file must be formatted in a fashion similarF to a VMS Mail distribution list. It must contain one username perF line. Comment lines are allowed, using an exclamation mark as the4 comment delimiter. The default file type is .DIS.2 SHOW< SHOW is a synonym of LIST. See LIST for more information. 2 Examples# 1. $ PROJECT LIST TEX_SUPPORTH This command lists all of the holders of the TEX_SUPPORTH identifier; that is, all those working on the LaTeX/TeX support project.0 2. $ PROJECT LIST/OUTPUT=maids MAIDS_ADMINH This command lists all of the project administrators for theH MAIDS project, placing the result in the file MAIDS.DIS. ThisH file ca n then be used in a VMS Mail message to the project administrators." 3. $ PROJECT GRANT SQA JONESH This command, which can be entered only by one of the SQAH project administrators, grants the user named JONES access to the SQA project files.0 4. $ PROJECT REVOKE TRAINING USERLIST/FILEH This command, which can be entered only by one of the TRAININGH project administrators, revokes access to the TRAINING projectH files to all of the users whose names are contained in the file USERLIST.DIS. 5. $ PROJECTH This command causes PROJECT to begin to prompt for commands.H You may enter as many commands at this point as you choose, like this:+ PROJECT> GRANT SFDR_SW MYLIST/FILE PROJECT> LIST SFDR_SW& PROJECT> REVOKE SFDR_SW SMITH PROJECT> EXITH In this example, the SFDR_SW project administrator grant s theH project identifier to all of the usernames contained within theH distribution list file MYLIST.DIS. The administrator thenH reviews the list of people who currently have access to theH SFDR_SW project files and discovers that there is one person inH the list who should not have access. The adminstrator removes3 that access and exits the PROJECT program.ww