Checkin (Command Line)

See Also

Updates VSS with changes made to a checked-out file, and unlocks the VSS master copy. You can also use the command name Update (for backward compatibility).

Syntax

ss Checkin VSS files [-C] [-H] [-I-] [-K] [-N] [-O] [-P[project]] [-R] [-W] [-Y] [-?]

Examples

Checks in your changes to the file TEST.C:

ss Checkin TEST.C

Checks in all files that you have checked out from the current project:

ss Checkin * -P

The following table describes the command-line options available with this command.

Option Description
-C Use the same comment for all checked-in files.
-K Keep the file checked out after checking it in.
-G Set options for the retrieved local file.
-W Make the retrieved local copy writable.
-R Check in an entire project list recursively.
-P Check in only files checked out from the current or specified project.
-O Paginate or redirect the command output.
-I- Ignore: Do not ask for input under any circumstances.
-N Change between long and short file name mode.
-Y Specify a username and/or password.
-?, -H Request online Help on a command.

Access Rights

You must have the Check Out access right to use this command.

Remarks

If you check in many files at once, VSS asks for a comment for each file individually: If you want them all to have the same comment, use the -C option.

It is possible to check in a file and create a new version while leaving the file checked out. To keep a file checked out, use the -K option. You can also make this behavior the default by setting the Keep_Checkedout initialization variable in the SS.INI file. Use the -K- option to indicate that you do not want to keep the file checked out.

Sometimes you check in a file that has not changed and create a new version. VSS displays a message asking if you actually want to perform a Check In; if you say No, VSS performs an Undo Check Out, so that the file is unlocked, but no new version is logged. You can avoid this prompt by setting the Update_No_Change initialization variable in your SS.INI file.

The -P option acts only on items that are checked out from the specified project. If you do not specify a particular project after the -P, the current project is assumed.