PI65406: ERRORS IN A SNAPSHOT VIEW UPDATE STARTED BY SETCS ARE NOT SETTING THE 'ERRORLEVEL' IF 'SETCS' IS RUN IN WINDOWS BATCH FILES

Rational ClearCase Fix Pack 2 (9.0.2.2) for 9.0.2
Rational ClearCase Fix Pack 10 (9.0.1.10) for 9.0.1
Rational ClearCase Fix Pack 3 (9.0.2.3) for 9.0.2
Rational ClearCase Fix Pack 11 (9.0.1.11) for 9.0.1

APAR status

• Closed as program error.

Error description

• In ClearCase when using a snpashot view, if you run 'cleartool
  setcs' in a batch file and the update of the view (implicitly
  started by the 'setcs') results in errors, the 'errorlevel'
  variable is not set. This happen when you run the setcs in a
  Windows batch file. This makes it difficult to act on a faulty
  'setcs' operation.
  An explicit 'cleartool update' will properly set the errorlevel
  variable if an error occurs .
  
  Workaround:
  Run an additional 'update' after a 'setcs' to detect a view an
  error. For large views this is not a practical solution and is
  too expensive in time.
  
  Reproduction
  Run the following from the root of a new snapshot view. The
  config spec contains a deliberate error (loading unknown VOB)
  
  cleartool mkvob -tag \thevob -stgloc -auto -nc
  echo element * CHECKEDOUT >cs.txt
  echo element * /main/LATEST >>cs.txt
  echo load \notthevob >> cs.txt
  echo @cleartool setcs cs.txt > batsetcs.bat
  echo @if errorlevel 1 echo ERROR! >> batsetcs.bat
  echo @cleartool update > batupdate.bat
  echo @if errorlevel 1 echo ERROR! >> batupdate.bat
  
  Result:
  batsetcs
  cleartool: Error: Unable to determine version for VOB root
  directory element.
  cleartool: Error: Unable to access "\notthevob": No such file or
  directory.
  cleartool: Error: 1 config spec load rule problems encountered.
  Summary:
  Loaded Objects: 0 (0 skipped)
  Total size: 0 KB
  Log has been written to
  "[...]\update.2016-07-04T140456+0200.udt".
  
  batupdate
  cleartool: Error: Unable to determine version for VOB root
  directory element.
  cleartool: Error: Unable to access "\notthevob": No such file or
  directory.
  cleartool: Error: 1 config spec load rule problems encountered.
  Summary:
  Loaded Objects: 0 (0 skipped)
  Total size: 0 KB
  Log has been written to
  "[...]\update.2016-07-04T140508+0200.udt".
  ERROR!
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of ClearCase  'cleartool setcs' in a batch file.       *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * When running 'cleartool setcs' in a batch file with loading  *
  * nonexisting vob in config spec, the 'update' of the view     *
  * (implicitly started by the 'setcs') results in errors but    *
  * the 'errorlevel' always returns 0 - executed successfully.   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• A fix is available in ClearCase versions 9.0.1.10 and 9.0.2.2
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  CC&CC MSITE WIN

• Fixed component ID

  5724G3300

Applicable component levels

• R901 PSY

     UP