HCI command removes multiple reserved files in directory - CA Harvest Software Change Manager
Article ID: 448287
Updated On:
Products
Issue/Introduction
When executing the Check In (hci) command with the -ro (read-only/undo checkout) option to target a specific file, multiple or all other reserved files within the same directory are incorrectly removed. This behavior is typically observed after upgrading to version 14.5.
Environment
- Product: CA Harvest Software Change Manager (SCM)
- Release: 14.5
- Operating System: All supported platforms
Cause
The issue is generally caused by command-line syntax errors where parameter values containing spaces, backslashes, or special characters are not properly encapsulated in double quotes. This leads to the Harvest broker misinterpreting the target file or directory path, potentially broadening the scope of the undo checkout process.
Resolution
To resolve this behavior, ensure all parameter values in the hci command line are enclosed in double quotes. This forces the interface to parse each argument as a single, literal string.
Follow these steps to refactor the command:
- Identify all flags in the command string (e.g.,
-b,-en,-st,-vp,-pn). - Enclose the value following each flag in double quotes.
- Pay particular attention to the View Path (
-vp) and Process Name (-pn) if they contain spaces or backslashes.
Example:
- Incorrect:
hci file.docx -vp \Documentation\Project A\ -pn Check In -ro - Correct:
hci "file.docx" -vp "\Documentation\Project A\" -pn "Check In" -ro
Verify the corrected syntax by running the command with the -oa flag to generate an output log. Review the log to confirm that only the intended file is processed.
Additional Information
For more information on the hci command: hci Command-Check-in
Feedback
