Check In Files: ci

Use ci to check files into a StarTeam repository (or vault) from a working folder using the command line.

You can simultaneously link the new file revisions to a process item. All the files successfully added using this command will be linked and pinned to the tip revision of the process item. Use the -active option to specify the currently active process item (previously set using a StarTeam client on your workstation).

If no item is active or you prefer to use another item, use the option that indicates the type of the process item (-cr, -req, or -task), followed by the complete path from the root folder of the StarTeam project view to the item, using the forward slash (/) as a delimiter between folder names. For out-of-view process items, specify the project name and view name in front of the complete folder path. Separate the view path with a colon (:). For example, -cr MyProject/RootView:ChildView/SourceCode/37 specifies change request 37 in the SourceCode folder of the ChildView view in the MyProject project. During execution, the process first assumes that the process item is in the current view, and it checks the current view to determine whether the full path corresponds to a folder path within that view. If the process item is not found in the current view, it is treated as an out-of-view process item, and the search for the process item begins from the project and view.

Use the -mark option to simultaneously mark the process item as fixed, finished, or complete, depending on its type.

Syntax

The syntax for this command is:

stcmd{Ex} ci [[-p "projectSpecifier"] [-epwdfile "filePath"] [-cmp] [-csf] 
[-encrypt encryptionType]][-rp "folderPath" | -fp "folderPath"] 
[-filter "fileStatus"] [-l | -u | -nel] [-is] [-ro | -rw]] [-vl "labelName"] 
[-nomove] [-f NCI] [-o] [-d|-r "comment" | -rf " fileName "][[ -active | 
[-cr | -req | -task ] processItemPath] [-mark]] [-q|-pf "filterName"] 
[-ofp "resultsOutputFilePath] [-cp "names"] -pi typename:"path" [files...]

Parameters

For information about the command parameters, refer to Operation Parameters.

Example

The following example uses ci to check in .bmp files to Online Help, a child of the root folder StarDraw (in the StarDraw view of the StarDraw project). The command unlocks the files, makes the working copy read only, and gives the files a revision comment (usually a reason for checking in the files).

Use the -p with ci or the stateful set command to set the context of the project/view/parent folder.

stcmd ci -rp "1024/StarDraw/StarDraw/SourceCode/Online Help" -u -ro -r "revised for beta" "*.bmp"