IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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 number

    PI65406

  • Reported component name

    CC&CC MSITE WIN

  • Reported component ID

    5724G3300

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-07-06

  • Closed date

    2020-06-26

  • Last modified date

    2020-06-26

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSH3S","label":"Rational ClearCase MultiSite"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
27 June 2020