The macro is used to check changes into the current workspace while adding a comment to the change set. By default, changes are added to the current change set of the component.

Attributes

The macro supports the SCM Macro Common Attributes, as well as, its own macro specific attributes. Click on the link for more information on the common attributes.

The following table describes the macro specific attributes for the macro:

Notes

• This macro specifies the following options on the SCM command:

  • --comment <arg>
  • --directory <arg>

  The following options can be added to the command using the additionalArgs element:

  • --change-set <arg>
  • --checkin-deleted
  • --complete
  • --current-merge
  • --delim-consistent
  • --delim-none
  • --ignore-local-conflicts
  • --json
  • --max-changes <arg>
  • --no-local-refresh
  • --skip-deleted
  • --verbose
  • --workitem <arg>

Examples

• Load a workspace, accept all incoming changes, create a change and check it in:
  

  <?xml version="1.0" encoding="UTF-8"?>
  <!--
      Licensed Materials - Property of IBM
      (c) Copyright IBM Corporation 2020. All Rights Reserved.
      
      Note to U.S. Government Users Restricted Rights:
      Use, duplication or disclosure restricted by GSA ADP Schedule
      Contract with IBM Corp.
  -->
  <project
      basedir="."
      default="all"
      name="Example"
      xmlns:xt="antlib:com.ibm.team.build.extensions.toolkit">
      <description>Example</description>
      
      <!-- Load build extensions -->
      <xt:loadBuildExtensions/>
      <xt:getJarLocation property="jarPath"/>
      
      <!-- Load common resources -->
      <import>
          <javaresource name="scripts/smpe/imports/$common.xml">
              <classpath location="${jarPath}"/>
          </javaresource>
      </import>
      <import>
          <javaresource name="scripts/smpe/imports/$scmcmd.xml">
              <classpath location="${jarPath}"/>
          </javaresource>
      </import>
      
      <xt:setPassword password="${password}" property="passwd"/>
      <property name="userId" value="ADMIN"/>
      <property name="conf" value="/var/MacroTestingScm/.jazz-scm"/>
      <property name="root" value="/var/MacroTestingScm/root"/>
      <property name="scmd" value="/var/MacroTestingScm/zips/scmtools/eclipse"/>
      
      <!-- - - - - - - - - - - - - - - - - - - *
      *  Example                               *
      *- - - - - - - - - - - - - - - - - - - -->
      <target name="main" description="main">
          
          <!-- Scm -->
          <ScmProperties
              authenticate="Password"
              repository="repositoryAddress"
              password="passwd"
              userid="userId"
              cfg="conf"
              dir="root"
              scm="scmd"
          />
          
          <!-- Load -->
          <ScmLoadWorkspace workspace="${workspace}"/>
          
          <!-- Accept -->
          <ScmAccept source="${stream}" target="${workspace}"/>
          
          <!-- Change -->
          <echo file="${root}${file.separator}test.txt">test</echo>
          
          <!-- Checkin -->
          <ScmCheckinComment path="${root}" comment="This is a comment"/>
          
      </target>
      
      <target depends="main" description="all" name="all"/>
  </project>