Pin (Command Line)
Marks file(s) at a specific version number in a specified project, or in the current project. For definitions of the command options, see Command Options in this Help system.
Syntax
ss Pin <items> [-G] [-H] [-N] [-V] [-W] [-Y] [-?]
Project Rights
You must have the Check Out/Check In project right in the project you are pinning to use this command.
Remarks
You can use the Pin command for file sharing at a specific version. It will have an effect similar to sharing the files with the Share command, with the -V option.
If the file that you want to pin is currently pinned to another version, the Pin command unpins the file and re-pins it to the version specified on the command line. If the file is already pinned to the version you specify on the command line, Pin takes no action.
The Pin command acts on the version you specify depending on the state of the initialization variable Force_Dir. Setting Force_Dir to Yes pins files to the working folder. Setting Force_Dir to No pins files to the current folder.
Examples
Pins the file Justify.cpp in $/WORD/CODE to version 2:
ss Pin $/WORD/CODE/JUSTIFY.CPP -V2
Pins all the files in the $/EXCEL/PIVOTTBL project to the label "beta4." In this example, "beta4" is assumed to be a project label:
ss Pin $/EXCEL/PIVOTTBL/*.* -Vlbeta4
Pins all header files in the SPECS project to version 2.
ss Pin *.H -V2
See Also
Reference
-V Option (Command Line)
Force_Dir Initialization Variable
Share (Command Line)