The hci command executes the check-in process specified on the command line or the first check-in process in the current context if no process name is specified. The process properties determine the default behavior for the process access and execution of linked processes. Other aspects of the process can be specified through command parameters read from the command line.
This command has the following format:
hci filename {-b name -en name -st name -p name -vp path} {-usr username -pw password} [-v] [-pn name] [-ur] [-uk] [-ro] [-d] [-nd] [-de string] [-s filename | pattern] [-op option] [-bo] [-ot | -ob] [-if option] [-dvp path] [-dcp path] [-cp path] [-rm name -rport portnumber] [-rusr username] [-rpw password] [-prompt] [-i inputfile.txt | -di inputfile.txt] [-eh filename] [-er filename] [-o filename | -oa filename] [-arg] [-wts] [-tr] [-h]
Specifies the name of the file to check in.
(Required) Specifies the CA Harvest SCM broker name.
(Required) Defines the CA Harvest SCM project context. If the project name contains spaces, enclose the name in quotation marks.
(Required) Specifies the name of the state in which the user is operating.
(Required) Specifies the CA Harvest SCM package name, read from the command line or a signature file.
(Required) Specifies the CA Harvest SCM view path that corresponds to the current working directory.
(Required, unless -prompt is specified) Defines the user name for login to the broker. If -usr is defined without -pw, the user is prompted for the password at runtime.
(Required, unless -prompt is specified) Defines the password for login to the broker. To hide the password from being exposed in plain text on the command line, use the ‑prompt option.
(Optional) Specifies a specific process name to invoke if more than one process of the same type exists in the state. If no process name is included in the command, the first process of that type in that state is invoked.
(Optional) Specifies that the item in the view is no longer reserved by the specified package after it is updated or created. This package cannot make any more changes until the item is checked out again. The file permission is set to read-only when this mode of check-in is used.
(Optional) Specifies that the item in the view is updated or created and the current package keeps it reserved so that more changes can be made.
(Optional) Specifies that no check-in is performed. The item is not updated, but the item is no longer marked as reserved for the current package. The file permission is set to read-only when this mode of check-in is used.
(Optional) Specifies that files be deleted from the client directory after they have been successfully checked in.
(Optional) Specifies to not delete files from the client directory after they have been checked in successfully.
(Optional) Specifies a comment to be associated with the new versions of items created during the process execution. If this option is not specified, you are prompted to enter a description. You can enter multiple lines of description in prompt mode.
UNIX or Linux: To terminate the description, enter a period (.) and a carriage return on an otherwise blank line, or use an end of file marker Ctrl+D.
Windows: To terminate the description, enter a period (.) and a carriage return on an otherwise blank line, or use an end of file marker Ctrl+Z on a blank line.
(Optional) Specifies that the check-in process should search every directory below the current one for files that match a file name or naming pattern. This option must be followed by a file name or naming pattern. To specify multiple file names or naming patterns, use the -s option before the first file name or pattern. -s will search for the patterns specified between it and the next option.
Naming patterns that include a wildcard must be enclosed in single or double quotes when used with the -s option. If no quotes are included on multiple naming patterns, hci searches recursively for the first file (the naming pattern immediately following the -s option) and searches only the current directory for the remaining files.
Examples: -s option
To recursively check in all files with the .c file extension, use the following command:
hci [options] -s "*.c"
To check in file.txt, one.h, two.h, three.h and all .c files, plus all .exe files recursively use the following command:
hci file.txt one.h two.h three.h *.c [options] -s *.exe
(Optional) Specifies where files or items should be placed in relationship to the specified view path or client directory structure.
Specify one of the following options:
Preserve directory structure-Checks in the selected files to repository view paths with names that correspond to their client directory location, if these view paths currently exist.
Preserve and create path structure-Checks in selected files to paths with names that correspond to their client directory location, and creates any view paths that do not currently exist.
All files to same view path-Checks in all selected files to the same path in the destination view, ignoring the client directory structure.
(Optional) Specifies that only the user who checked out an item is allowed to release the reserved version. This user is the owner of the lock or reservation. Setting this option at check-in (hci) prevents a user from releasing an item if that user did not initially reserve it.
(Optional) Specifies the item filter for check-in. Specify one of the following options:
New or Existing Items-When this option is selected, all selected files are checked in if they are reserved by the package or did not previously exist in the repository. This filter does not require the corresponding item to be in the current view. However, if it is in the current view, then it must have a reserved version in the current package.
New Items Only-This option limits the check-in to files that do not have corresponding items in the current view. If the item has been removed from the current view, then the file can be checked in using this filter.
If the corresponding item was renamed in the current project, then the file cannot be checked in. The file must be renamed before it can be checked in.
Existing Items Only-This option limits the check-in to files that have corresponding items reserved by the package. Any files without corresponding items are skipped. This filter can be used to prevent the existence of unwanted files, such as temporary files or templates, in your repository.
Limits the check-in to files that do not have corresponding items in the current view and places them on the project trunk.
Limits the check-in to files that do not have corresponding items in the current view and places them on a branch.
Note: The -ot (New Items on Trunk) and -ob (New Items on Branch options are disabled if the user selects Existing Items Only; otherwise, one or both can be selected. If the user only selects New Items on Trunk, then new items can only be checked in to the trunk. If the user only selects New Items On Branch, then new items can only be checked in to the branch. If the user selects both, then new items can be checked in to either the trunk or the branch.
(Optional) Specifies a default view path.
(Optional) Specifies a default client path.
(Optional) Specifies the client path that corresponds to current view path. The client path must be an absolute path. For items with reserved only tags, this option is required.
(Optional) Specifies the remote computer to check out from or check in to. Specify this option only if you want to check out from or check in to a remote computer.
(Optional) Specifies the port number of the remote computer to check out from or check in to. Specify this option only if you want to check out from or check in to a remote computer.
(Optional) Specifies the user name for the remote computer to check out from or check in to. Necessary only if you want to check out from or check in to a remote computer.
(Optional) Specifies the password for the remote computer to check out from or check in to. Necessary only if you want to check out from or check in to a remote computer.
(Optional) Specifies the encrypted CA Harvest SCM username-password file name. The file name used with this option contains encrypted username-password credentials and must be generated with the svrenc utility.
Note: -eh overrides -usr and -pw options. -prompt overrides -eh, -usr and -pw options.
(Optional) Specifies the encrypted remote username-password file name. The file name used with this option contains encrypted username-password credentials and must be generated with the svrenc utility. ‑er overrides -musr and -mpw options.
(Optional) Turns on the local agent network activity trace.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|