    
    
    
                             CLAIM User's Guide
    
                              Matthew Madison
                  Center for Interactive Computer Graphics
                      Rensselaer Polytechnic Institute
                               Troy, New York
    
    
    Introduction
    
    The VAX/VMS file system allows users to protect their directories so 
    that others can create files in those directories.  Since the 
    creator of a file (for most users) is the owner of the file, a user 
    can wind up with a directory full of files that he or she cannot do 
    anything with.  This can be very confusing, especially to novice 
    users.
    
    CLAIM is a utility that allows a user to claim ownership of any file 
    that resides in a directory that belongs to that user.  It accepts 
    file and directory wildcard patterns, so users can easily claim 
    ownership of several files at once.
    
    Installing CLAIM
    
    CLAIM is a single executable file which should be installed in 
    SYS$SYSTEM or some other directory in which you store command 
    images.  CLAIM comes with a CLD file that is used to make it 
    available as a command.  You can either modify the system 
    DCLTABLES.EXE or include a SET COMMAND command in SYS$SYLOGIN to 
    make CLAIM available to users.  Note that if you install CLAIM.EXE 
    in a directory other than SYS$SYSTEM, you should modify 
    CLAIM_CLD.CLD to reflect the image's location.
    
    A help file is included with CLAIM that can be added to your help 
    library.
    
    CLAIM must installed with SYSPRV privilege to work properly.
    
    
    The CLAIM command
    
    The CLAIM command has the following form:
    
         CLAIM file-spec[,...]
               /LOG
    
    The file-spec may include file and/or directory wildcards.  Multiple 
    file-specs may be entered, separated by commas.  DECnet node names 
    are not allowed in file specifications.
    
    For each file, CLAIM verifies that the UIC of the current process 
    matches the UIC of the owner of the directory in which the file 
    resides.  If the UIC's match, the owner UIC of the file is changed 
    to match the current process UIC.  The /LOG qualifier causes a 
    message to be generated for each successful claim operation.
    
    
    Contacting the Author
    
    Comments, suggestions, and questions about CLAIM can be directed to 
    the author via electronic mail at one of the following addresses:
    
    Internet: madison@cicgj.rpi.edu
    BITNET:   madison@rpicicge
    
    
    Copyright Notice
    
    COPYRIGHT © 1988, RENSSELAER POLYTECHNIC INSTITUTE.  ALL RIGHTS 
    RESERVED.  Permission is given to redistribute this software for 
    non-commercial purposes provided no there is no charge for the 
    distribution beyond handling and materials costs.
    
    DISCLAIMER: This software is provided "as is".  Neither the author 
    nor Rensselaer Polytechnic Institute makes any guarantee as to the 
    suitability, usefulness, performance, or security of the software.
    
