org.apache.tools.ant.taskdefs.optional.clearcase

Class CCLock

  • All Implemented Interfaces:
    java.lang.Cloneable


    public class CCLock
    extends ClearCase
    Performs a ClearCase Lock command.

    The following attributes are interpreted:

    Task attributes
    Attribute Values Required
    replace Specifies replacing an existing lock No
    nusers Specifies user(s) who can still modify the object/pname No
    obsolete Specifies that the object/pname should be marked obsolete No
    comment Specifies how to populate comments fields No
    pname Specifies the pathname to be locked. No
    objselect This variable is obsolete. Should use objsel instead. No
    objsel Specifies the object(s) to be unlocked. No
    failonerr Throw an exception if the command fails. Default is true No
    • Field Detail

      • FLAG_REPLACE

        public static final java.lang.String FLAG_REPLACE
        -replace flag -- replace existing lock on object(s)
        See Also:
        Constant Field Values
      • FLAG_NUSERS

        public static final java.lang.String FLAG_NUSERS
        -nusers flag -- list of users to exclude from lock
        See Also:
        Constant Field Values
      • FLAG_OBSOLETE

        public static final java.lang.String FLAG_OBSOLETE
        -obsolete flag -- mark locked object as obsolete
        See Also:
        Constant Field Values
      • FLAG_COMMENT

        public static final java.lang.String FLAG_COMMENT
        -comment flag -- method to use for commenting events
        See Also:
        Constant Field Values
      • FLAG_PNAME

        public static final java.lang.String FLAG_PNAME
        -pname flag -- pathname to lock
        See Also:
        Constant Field Values
    • Constructor Detail

      • CCLock

        public CCLock()
    • Method Detail

      • execute

        public void execute()
                     throws BuildException
        Executes the task.

        Builds a command line to execute cleartool and then calls Exec's run method to execute the command line.

        Overrides:
        execute in class Task
        Throws:
        BuildException - if the command fails and failonerr is set to true
      • setReplace

        public void setReplace(boolean replace)
        If true, replace an existing lock.
        Parameters:
        replace - the status to set the flag to
      • getReplace

        public boolean getReplace()
        Get replace flag status
        Returns:
        boolean containing status of replace flag
      • setObsolete

        public void setObsolete(boolean obsolete)
        If true, mark object as obsolete.
        Parameters:
        obsolete - the status to set the flag to
      • getObsolete

        public boolean getObsolete()
        Get obsolete flag status
        Returns:
        boolean containing status of obsolete flag
      • setNusers

        public void setNusers(java.lang.String nusers)
        Sets the users who may continue to edit the object while it is locked.
        Parameters:
        nusers - users excluded from lock
      • getNusers

        public java.lang.String getNusers()
        Get nusers list
        Returns:
        String containing the list of users excluded from lock
      • setComment

        public void setComment(java.lang.String comment)
        Sets how comments should be written for the event record(s)
        Parameters:
        comment - comment method to use
      • getComment

        public java.lang.String getComment()
        Get comment method
        Returns:
        String containing the desired comment method
      • setPname

        public void setPname(java.lang.String pname)
        Sets the pathname to be locked
        Parameters:
        pname - pathname to be locked
      • getPname

        public java.lang.String getPname()
        Get the pathname to be locked
        Returns:
        String containing the pathname to be locked
      • setObjSel

        public void setObjSel(java.lang.String objsel)
        Sets the object(s) to be locked
        Parameters:
        objsel - objects to be locked
        Since:
        ant 1.6.1
      • setObjselect

        public void setObjselect(java.lang.String objselect)
        Sets the object(s) to be locked
        Parameters:
        objselect - objects to be locked
      • getObjselect

        public java.lang.String getObjselect()
        Get list of objects to be locked
        Returns:
        String containing the objects to be locked