Home

StarTeam Command-line Tools Help

1. cceceeeeecceceeeceeeeeeeeeeeteeeeeaaaeaecaeeeeeeeeeeeeeesecsecccacaeseeeeeeeeeeeeeeeneees 27 COMMON OPIONS cease tein a a Meals Lt ede Emden dtnit ads taal dank Mit wiht 29 Special CHALACKELS aa ar as aecshann a E a a a aaaea a a a a anae Sa EEE aE eaa 37 SRE o lE E A A E A E S 38 AddiFiles Stemdiadd arasan e a a a a E a A s 39 Add Fold rs stemd add fold ET e a E dees aea viata a aoa N 41 Add Projects stemd add projact seioonieriiri ainnean AREE EEKE ISEE EKAA AKERE EERIE RAN 43 Add Views stemd add View ee aaa l a aa e a a a aaa aa a aaa adadan ea ei oaia 45 Apply Labels stemd apply label cecceceeeeeceeeccceccaecceeceeeeeeeeeeeeeeeseeeseceeccsaaaeaaecaeeeeeeeeeeeeees 47 Gheck ni Files Stemea 6li x sortet et te a Elie din te Pete asl 48 Check Out Files stemd CO ccccccccceccecceceeee eee eee tee eeaaeeaeeeeeeeeeeeeecgacaaeaaaeeaeceeeeeeeeeseeeeesensaneaeees 51 Compare Fil Revisions stemd diff a i eceevids atecuskddadeden cat hateaccetiedadadad aderatdgdaniiedieiacalegecss 54 Change File Descriptions stemd ASC cccceecceeneeeeeeeeeeeennee eee E EEA RA AARRE 57 Create Labels stemd la e annual heel etd aiden 58 Create Working Folders stemd local mkdir 0 0 0 2 eeeeeeceeeeeeeeeeeeeeeeeceeeeeeeeaeeeeeeeeaaeeeeeeeiaeeeeeeenaes 60 Delete Local Files stemd delete local ccccccceeeccceccaeceeeceeeeeeeeeeeeeeeee eta saaeeesacensensaneaeees 61 Display File History stema hist 0
2. For example suppose you are creating files in an application that makes automatic backup copies of each file with the extension bak every time you save a file Your working folder might contain several bak files but you have no reason to add them to the project view From the application it is annoying to see these bak files as possible candidates so you exclude them Excluding files is done on a per folder basis However exclude lists can be inherited from parent folders The full syntax is ex excludeTyp The types are inherit which indicates that this folder will inherit any exclude lists used by its parent folder and use the exclude list specified with either exfile or exlist if one is created This is the default local which indicates that this folder will use only the exclude list specified with either exfile or exlist none which indicates that this folder will use no exclude lists regardless of what you specify with either exfile or exlist exfile Specifies the path to the file that contains the local exclude list for this folder See exlist for a description of the exclude list s contents exlist Specifies the local exclude list for this folder Use a maximum of 254 characters Enter one or more file specifications using the standard and wild cards separated by commas spaces or semicolons To include a comma space or semicolon as part of the specification enclose the specification in double
3. If the password is omitted the user is prompted to enter the password The password in the example is password f the host name is omitted the default is localhost The host name in the example is orion The port number is required The default port number 49201 is used in the example Example The following example uses stcmd server mode to lock the server using port 1024 on Orion stcmd server mode s JMarsh password Orion 1024 mode lock 66 Related Reference Client Command line Operations 67 Remove Files stcmd remove Use stcmd remove to remove files from version control The specified files and their revision histories no longer appear in StarTeam unless you roll back the project view to a time before they were removed Syntax The syntax for this command is as follows stcmd remove p projectSpecifier pwdfile filePath cmp csf kencrype encerype ron ly Oe Silea i eel sale SieOo ial GomeerolcderPaie https AEO Ena CAS Sseikhecie Wissikasiecheuc l ar lires m Option Description d Deletes the user s working file Without this option the working file remains in the working folder on your workstation filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other whitespace in this string Only files that currently have the specified statuses will be removed You cannot remove files that are Not In View from version control
4. Export Exp lt VCM archive file gt FixFloatingChildShares True False IgnoreMergePoints IMP True False Include Inc lt change requests gt lt files gt lt folders gt lt process items gt lt requirements gt lt revision labels gt lt tasks gt lt topics gt LockMergeConflicts LMC None Source Target Both ManualMergeFiles MMF True False Match Folder lt folder path gt to lt folder path gt MergeType Type MT Compare Rebase Promote Replicate Name Na lt Change Package name gt PostCommitLabel PostCL lt label gt 96 lt match state gt PostCommitRevLabel PostRL lt label gt PreCommitLabel PreCL lt label gt PreCommitRevLabel PreRL lt label gt PreventDuplicateFilenames PDF True False Project Pro lt project gt ReportDiffs RD True False ReportUpdates RU True False Save lt VCM session file gt SourceLabel SrcLabel SL lt label gt SourceState Srestate SS lt srate gt SourceTime SrcTime ST lt timestamp gt Now SourceView Source SV lt view gt TargetLabel TgtLabel TL lt label gt TargetState igeState US k state TargetView Target TV lt view lt miscellaneous option gt NetMon NM True False Time T True False Verbose Vb V True False Other Syntax Elemen
5. cece eee eeeeeee eee A T R N 62 List Files Stem listy tic csvset a eta tele ath is arate teas adn dasd Mad ated 63 Lock and Unlock Files stemd ICK 2 ccccc cee ee cece eee e eee te ee ee eee e eee eee e ea aeeaeeeaeeaaaeaaaeaaeeaeesaeeaeeeaeeees 65 Lock and Unlock Server stemd Server MOde ccccccccceeceeeeeeeeeeececeaaeeeeceeeeeeeeeeeetetseesineaaaeees 66 Remove Files stemd remove 20 ccccccccccccceeceeeeeeeeeeeeeeeeeeeaeeaaaeaaecaeeaeeeeeeeeeeeeeeeeeeeseeseesecnennsasaeeas 68 Set Personal Options stemd set persomal Options cccccccccceeccececeeeceeeceeeeeeeeeeeeeeeeeteeeteeess 69 Update File Status stemd update status cccccceccecceceeceeeeeeeeeeececeaaecaeeeeeeeeeeeeeeteteneenenieaeees 70 VOM Command line Utility scc ttcscctectats coceechiesecetedhdaevtenaesd EE EERENS 72 Overview of the VCM Command line Utility VCMUtility 0 cn eeeeeeeeeeneeeeeeeeeeenaaaees 73 VCMUtility Commands osa a A R A CA eee Geis 77 VCMUtility Connection Options reessione araa EARRA A AE NA 80 VOMUUItY Session OPTIONS rec ie a eden ddan EE EA EEA E 82 VCMUtility Miscellaneous Options arrien i aAA ATEA EAEEREN 93 VCMUtility EXIDE oraa E iE a ie nea ih et EE 94 Cheat Sneetcsc c cheeks E E ET T A E E E iaareenaae eaavtouacacedennees 96 Syntax for VCMUtility C mpound Options essiersisiiiene iiiaae ninenin pi EEr ENKAR EEEE E RE 100 NiO aE EE E AAE E E EE TT 101 lt CheCk Out Options gt oaen a ie ee a
6. s working folder becomes C StarDraw Wizard Using the is option allows you to add a branch of folders to the project view s folder hierarchy When you use is use either rp or fp to specify the folder on your workstation whose child folders will become the new StarTeam folder s child folders Using fp is recommended as it specifies the path directly to the parent of those child folders In contrast rp which specifies the path to the working folder used for the view s root folder appends StarTeam folder names in the hierarchy from the root folder to the new folder to the path you specify Only when you use the is option do rp and fp have any effect on this command Syntax The syntax for this command is as follows stcmd add folder p projectSpecifier pwdfile filePath cmp csf encrypt encryptionType rsm i i stop Erp toldenPabhi a Epo toldeckathi mame WkolderName d description ex excludeType exlist fileMask exfile fileName Option Description d Specifies a description for the folder Use a maximum of 254 characters ex Indicates the exclude lists to be used by this new folder Exclude lists exclude certain files or types of files from visibility If a working file in this folder s working folder would have the status Not In View but it matches a file specification in one of the exclude lists the application does not display it at all It is as though the file did not exist
7. stcmd remove Describes the command to remove files from version control Set Personal Options stcmd set personal options Describes the command to set and list personal options Update File Status stcmd update status Describes the command to update the status of a file 28 Common Options Some options show up in all or almost all of these commands In each command they have exactly the same meaning so they are explained in this section and not repeated later Options that do not appear in all commands or vary in meaning from command to command are explained with the commands All command line syntax is interpreted as UNIX rather than Windows syntax All options can be written with either a hyphen or slash mark depending on what your operating system understands When this chapter indicates that an option requires quotations marks using them is recommended despite the fact that the option may be accepted by your operating system without them Adopting this policy is both consistent and safe Windows operating systems require quotation marks when a space is part of the option For example when a revision comment is several words it must be enclosed in quotation marks A one word comment does not require quotation marks although quotation marks can be used Be aware that commands sent via the Java command line fail when there are spaces in the names of working folders and files You cannot use spaces in UNIX names
8. Operations 60 Delete Local Files stcmd delete local Use stcmd delete local to delete files from a working folder You can delete files that are under version control as well as files that are not in StarTeam This action does not remove any files from version control It merely reduces the amount of data stored on your workstation in a working folder If you are deleting files based on their StarTeam status it is a good idea to use stcmd update status first Syntax The syntax for this command is as follows stemd delete local p projectSpecifier pwdfile filePath cmp csf F encrypt encuyptlLon ly pel sil al sali RSs op o eolderPatrh ro eolderPath pekecl Wikaicsilincvns ECE Vsicenecieime etga Yecicneperce e aer Mer eStatuss i Eres Option Description cigd Configures the view as of the specified date time Examples include 42 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday December 29 2001 10 52 00 AM PST cigl Configures the view using the specified label Without cfg1 cfgp or cfgd the view s current configuration is used cfgp Configures the view using the specified promotion state filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other whitespace in this string Only files that currently have the specified statuses will be deleted The letters used to represent the statuses are C f
9. The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown Example The following example uses stcmd remove to remove all hm files from SourceCode a child of the root folder StarDraw in the StarDraw view of the StarDraw project as well as all files in child folders of SourceCode It also deletes the working files stcmd remove p JMarsh password Orion 1024 StarDraw StarDraw SourceCode is df hm Related Reference Client Command line Operations 68 Set Personal Options stcmd set personal options Usestcmd set personal options to set and list personal options At this time the only personal options that can be set with this command are How file status information will be stored Where file status information will be stored when it is stored at a central location File status information is stored in the starteam client options xml file If no starteam client options xml file exists this command creates it in a default location The default location is the same as the default for the central status option see below Syntax The syntax for this command is as follows seemai set personal operons iii Saina RSOP cCentcall stabus perc roldenr sitatwsy central repository folderPath list Option Description central repository Enables you to specify a location for the central repository central status
10. add to add files to a project from the command line You can simultaneously link the added files 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 Forexample 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 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 For example a change
11. and 3 stcmd store password epwdfile stored in a file H filePath To include the encrypted password in the command as clear text Note that this action does not access the network with the clear value stcmd store password epwdfile filePath password password Once an encrypted password is stored other stcmd commands can specify epwdfile filePath as parameters For example stcmd delete local p JMarsh password Orion 1024 StarDraw StarDraw SourceCode epwdfil Hier West bnese ymy iler ieee filter YNY Yan f NCI Apply command to all files needing check in f NCI is ignored if filter is used files Specifies the files to be used in the command by name or by file name pattern specification such as c All options are interpreted using the semantic conventions of UNIX instead of Windows because UNIX conventions are more specific This means that rather than means all files The pattern means all files with file name extensions For example star finds starteam doc and starteam cpp but not starteam To find all of these you could use star Without this option the default is When used this option must always be the last option Any options after it are ignored If you use rather than to indicate all files a UNIX shell expands it into a series of items and passes this series as a group of options to the stcmd command This can cause problems fo
12. extra commands required to check each target item examined during the compare phase IgnoreMergePoints IMP IgnoreMergePoints True False 85 Specifies whether merge points should be ignored during the comparison phase If True items with merge conflicts use their branch point as the common ancestor instead of the source revision of the last merge point Include INC Include lt change requests gt lt files gt lt folders gt lt process items gt lt requirements gt lt revision labels lt tasks gt lt topics gt Includes the specified items in the source scope The Include option can be provided multiple times causing all selected items to be included Only one item selection type revision labels change requests and so on can be specified with each Include option The selection type keyword which is optional for files and folders can be singular or plural for example ProcessItem or ProcessItems Examples Include CRs ALL Include src com java tall jar 2 jpx Buildnumber h Include Folders docs api all Include ProcessItem CR 451 Include Reqs 4515 4516 Include RevLabel Beta Fix 12 413 Include Topic 14512 Include Task 413 LockMergeConflicts LMC LockMergeConflicts None Source Target Both Specifies that items with unresolved conflicts are to be locked exclusively in either the Source Target or Both views Locks are acquired in the compare phase None is th
13. items used in the compare phase Breaking a source or target item lock is only required when the lock is owned by another user Lock breaking requires a special permission and may not be successful BreakLocks is ignored for Compare sessions CaseSensitiveFilenames CSF CaseSensitiveFilenames True False If True considers file names different only by case as unequal for purposes of evaluating the PreventDuplicateFilenames option and for matching files between source and target views CheckoutPreview Checkout CP CheckoutPreview lt files gt lt check out options gt This option specifies that files within a merge preview are to be checked out to the client workspace A merge preview is a simulation of the target view updated with all changes in the VCM session The lt files gt syntax allows 82 file names and or patterns to be checked out from specified folders in the merge preview The optional lt check out options gt control options such as where files are to be checked out and what status of files should be checked out When Checkout Preview is specified files are checked out after the compare phase after auto and manual merging has occurred but before a commit occurs The check out occurs only if the VCM session has no file content merge conflicts If merge conflicts exist an error is displayed and no merge is performed regardless of the CommitMerge option If no merge conflicts exist and CommitMerge is True
14. labels Examples include 42 29 01 12 41 PM December 29 2001 12 41 21 PM Monday December 29 2001 12 41 avi Specifies the name of the label to be copied The name of the label is enclosed in double quotation marks The specified label must already exist in the application and must be the same type as the label you are creating If the specified label is a revision label that is attached to one or more items the new label will be attached to those same items Without the vn or vd or v1 option the current time is used for view labels If this is a revision label make sure that you have set r yp Specifies a promotion state whose label will be copied The name of the state is enclosed in double quotation marks The specified label must already exist in the application and you must be creating a view label for this option to be valid Without the vn or vd or v1 option the current time is used for view labels You can create a view label based on a promotion state ONLY when the promotion state is set to a label and not set to Current Syntax The syntax for this command is as follows stcmd label p username password host port project view folder pwdfile filePath cmp encrypt encryptionType q x stop nl labelName vl labelName vd asOfDate vp stateName d description b r f 58 Example The following example uses stcmd label to create a new build label named Beta for the
15. letters used to represent the statuses are C for Current M for Modified G for Merge 0 for Out of Date I for Missing and U for Unknown If you use C M G O or U you must also specify o to force the check out operation Without the o option specified BCO skips files with the statuses represented by C M G O or U but a warning is logged in the log file Overrides the working folder or working directory for the specified folder This is equivalent to setting an alternate working path for the folder While this enables you to use a different working folder than the one specified by the folder its critical importance is its use to provide cross platform compatibility For example UNIX and Windows systems specify drive and directory path names 11 S help ig netmon in incompatible ways Although the path D MYPRODUCT DEVELOPMENT SOURCE is understood on a Windows platform it is not understood on a UNIX platform Use this option to define the working path if your platform does not understand the path specified in the project A backslash is interpreted as an escape character when it precedes quotation marks As a result an error occurs in the following example bco p xxx fp MAN UEL which is interpreted as bco p xxx fp era mW To avoid a situation like this escape the final character in c as follows bco p xxx fp Woes m Or avoid it as follows when the fp pat
16. one of the characters enclosed by the left and right brackets A pair of characters separated by a hyphen specifies a range of characters to be matched If the first character following a left bracket is an exclamation point or a caret the rest of the characters are not matched Any character not enclosed in the brackets is matched A hyphen or right bracket may be matched by including it as the first or last character in a bracketed set For example x a d y matches xby but not xey while x a d y matches xey but not xby If you want to use an asterisk question mark or left bracket in a pattern you must precede it with the escape character that is a backslash tk If you use rather than to indicate all files a UNIX shell expands it into a series of items and passes this series as a group of options to the stcmd command This can cause problems for example when you are checking out missing files so it is best to use and avoid unwanted complications If you use a set of file patterns each pattern should be enclosed in its own set of quotation marks For example you can use bat c but you cannot use bat c These special characters also apply to the files option available in some commands Related Reference Client Command line Operations 37 Exit Codes The stcmd commands return exit codes if the x option is used in the command The c
17. request can be marked as fixed The item is not marked as fixed finished or complete unless all the files are successfully added Syntax The syntax for this command is as follows stcmd add p projectSpecifier pwdfile filePath cmp csf encrypt encryptionType Sas Sel e lesiecis arms itoilcleeiPerca Sito Mitoikelereretcla i sm Saul eee Siew d description v abeliNeme ico ont obi ils active l en requ task S procesislitemPath marki ili sion si ceadlesr er Option Description active The active process item er Complete path from the project view s root folder to the change request requirement or task number to be used sreg as a process item Use 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 task 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 process item and the search for the process item begins from the pro
18. the verification process Example starteamserver start MyServer autorecover dsn DataSourceName Use with new edit start and restart See also t p and u Specifies the database connection information Enter the existing ODBC data source name DSN In releases 5 1 and 5 2 Oracle databases were accessed using the Oracle net service name that is stored in SORACLE HOME network admin tnsnames ora This is no longer the case The value you specify for DBServerName is stored in the starteam serverconfigs xml file You can review or modify the database connection information by using The view and edit options from the command line Database tab of the StarTeam Server Configuration dialog box in StarTeam Administration Database tab of the lt Server configuration gt Properties dialog box in Server Administration Modifications take effect the next time you start the server configuration Example starteamserver edit MyServer dsn MyServerDSN edit ConfigurationName Use with name dsn u and p Edits the session options for the specified server configuration You can edit the following options name dsn u p If the server configuration is running you must shut it down before you can make any edits Example starteamserver edit MyServer name Portable dsn RemoteServer u StarTeamAdmin eval Number See also serial access and license Extends the evaluat
19. the computer named Orion Orion is running an instance of the StarTeam Server with a server configuration that uses port 1024 This command creates the view as a child of the existing StarDraw view and uses the StarDraw folder as its root folder The new view is based on the label used for the last build of the 5 1 product before it shipped Build 403 It has a working folder that is different from the parent s working folder All existing items in the view will have their behavior set to branch on change stcmd add view p JMarsh password Orion 1024 StarDraw StarDraw cmp encrypt RC4 name Maintenance 5 1 rp C StarDraw Maintenance 5 1 d Maintenance view for 5 1 release of our producta Cle oe mee Wewe Aes The following example uses stcmd add view to create a read write reference view named Rooted At Source Code on the computer named Orion This command creates the view as a child of the existing StarDraw view and uses the SourceCode folder as its root folder It has the same working folder as its parent Because a read write reference view must have the same configuration as its parent none of the cfg1 cfgp and cfgd options can be used stcmd add view p JMarsh password Orion 1024 StarDraw StarDraw Source Code cmp encrypt RC4 name Rooted At SourceCode d StarDraw main view but with SourceCode folder as the root of the hierarchy dr Related Reference Client Command line Operations 46 Apply Labe
20. the specified item types are included Recognized item types are CRs Files Folders Tasks Topics and Requirements singular or plural Examples Below are examples of lt folder gt usage H clade folders in the view include folders ALL all files in the folder src com acme alone include src com acme ali tales and tasks am sre and bellow include sire tall fades Gasks all CRs in the folder triage and all files in PR docs child folders two levels below it include trtage IRs 17 PR docs F2 By convention the root folder is represented by a single This means that the root folder name should not be provided in folder paths For example if the root folder is named StarDraw the folder path for the immediate child folder Source Code is simply Source Code 107 Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt match state gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 108 lt item type gt lt item type gt Specifies an item type Allowed values are ChangeRequest or CR File Folder Requirement or Req Task and Topic ltem type names are case insensitive and can be plural Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt
21. the view cfgp Configures the view using the specified promotion state cmp Compresses all the data sent between the workstation and the server and decompresses it when it arrives Without this option compression does not take happen Compression is most useful and appropriate when the client and server communicate over a slow connection To determine whether to use compression a small test case may be helpful You must consider whether the time spent compressing and uncompressing data is better than the longer transfer time of uncompressed data sent over the slow connection cwf Create the working folder for the base folder and if specifying the is option all subfolders of the base folder even if they do not have any files to check out during the run Only visible folders are created esf When the command maps the folder specified in the p option to the underlying StarTeam folder using cs causes the command to differentiate StarTeam folders based on the case sensitive spelling of their names This option does not apply to the case sensitivity of filenames in the folders For example with dryrun encrypt RC2_ CFB eol on erie exclud RCA RC2_ oie file gt files lt pattern gt cr ECB RC2 CBC Lf lt pattern csf StarTeam folders named doc and Doc are recognized as different folders Without this option either folder could be recognized as the doc folder
22. unless they are enclosed in double quotation marks Syntax conventions The syntax conventions for the command line are as follows Square brackets identify optional syntax A vertical bar separates mutually exclusive choices Select only one of the choices Lists the command s syntax and a description of each option also invokes help help and h are synonyms for works with each command although not shown in the syntax This information is sent to stderr rather than stdout To capture stderr information from the Windows command prompt use 2 gt rather than gt which captures stdout information active Indicates the active process item cmp Compresses all the data sent between the workstation and the server and decompresses it when it arrives Without this option no compression takes place Compression is most useful and appropriate when the client and server communicate over a slow connection To determine whether to use compression a small test case may be helpful You must consider whether the time spent compressing and uncompressing data is better than the longer transfer time of uncompressed data sent over the slow connection csf When the command maps the folder specified in the p option to the underlying StarTeam folder using cs f causes the command to differentiate StarTeam folders based on the case sensitive spelling of their names This option does 29 not apply to the case sensitivi
23. used is the Service Packs view which is a child of the Release 4 view and a grandchild of the StarDraw root view If the view name is omitted the root view is used If the view is the only view in that project with that name you can use only the view name Doing this is not recommended however because another view with that name could be created at a later date A folder hierarchy should be used to identify the folder Use the forward slash as a delimiter between folder names The folder hierarchy never includes the root folder Omit the folder hierarchy if the file is in the view s root folder For example if the root folder of the view is StarDraw and the hierarchy to your files is StarDraw SourceCode Client use only SourceCode Client If any of the variables used with this option contain characters that are used as delimiters use the percent sign followed by the hex code for each of those characters For example if appears as a character in a password you must replace it with 340 For use 33a For u use ig 6 f For e use ezg For 3 use 2 5 In UNIX and other operating systems some special characters must be preceded by a backslash or another escape character In the p option you can replace such characters with hex codes For example 33c could be used in UNIX instead of lt 34 For a space use 320 For lt use 33c For gt use 33e pwdfile Specif
24. Borland StarTeam 2009 StarTeam Command line Tools Help B i d Borland Software Corporation 8310 N Capital of Texas Hwy Bldg 2 Ste 100 Austin Texas 78731 USA www borland com Borland Software Corporation may have patents and or pending patent applications covering subject matter in this document Please refer to the product CD or the About dialog box for the list of applicable patents The furnishing of this document does not give you any license to these patents Copyright 1995 2009 Borland Software Corporation and or its subsidiaries All Borland brand and product names are trademarks or registered trademarks of Borland Software Corporation in the United States and other countries All other marks are the property of their respective owners June 2009 PDF Command Line Tools EEEIEI E SEEE eg eects hehe eee aceite ec eer are teat tens tee Mh athe A ce ease tees 7 Command line Operations si secs tavecceselsciptecchbidad T a dhia tl atcnlecad slebeueidalalectetiaad aE aa a a E iE 8 Bulk Check out Utility Command line Options 0 0 0 0 cee e eee ee eee e tienes eee eaeeeeeetaeeeeetee 9 starteamserver Command Parameters ccccccccceceeeeeeeeeee eee eeeeeeeeeee eee teeeeeeeeeeeeeeeeeeseeeeeeeeeees 16 Check out Trace Utility Command Line Operations 0 0 0 eee ceceee cece eeeccneeeeeeeeeeetaeeeeeeeeeeenaaaes 24 Vault Verify Command line Options nresep eee ieee serena EA EEEE R 25 Client Command line Operations
25. By default the utility does not filter by time Specifies the most recent date time of interest Only checkouts that occurred before this time will be output By default the utility does not filter by time Name of the project for which check out information is to be filtered Only checkouts from this project will be output By default the utility does not filter by project All projects are included in the output If both project and projectidare specified projectid takes precedence ID of the project for which check out information is to be filtered Only checkouts from this project will be output By default the utility does not filter by project ID All projects are included in the output This option takes precedence over project if both options are specified String used to separate values in the output file By default the utility uses Specify this flag to overwrite existing check out trace files If not specified check out trace binary files will be skipped if a trace dump file with the target name already exists 24 Vault Verify Command line Options This topic describes the command line options for the Vault Verify utility In general you can run Vault Verify from the command line as follows VaultVerify options configuration Based on the default or given check options integrity checks are performed on the vault archive files for the specified StarTeam server configuration If you specify the r
26. ChangeRequest ChangeRequests ChangeRequest 4277 and so on When you are not sure what can be used see the VCMUtility Cheat Sheet topic in the Reference CompareMerge section of the documentation The Cheat Sheet provides the full syntax for phrases like lt change requests gt Vertical bar Separates alternate elements Prefixed with an asterisk Indicates the following element can be repeated Note All options are case insensitive for example Server is the same as server VCMUtility Command VCMUtility lt options file gt options You can provide options in the specified lt options file gt as the first parameter command line arguments or both Command line arguments override any options found in the lt options file gt Inthe lt options file gt the option name should begin as the first character on a new line and exclude the leading 73 VCMUtility Options File You can specify VCMUtility options in an options file whose name is passed as the first parameter of the VCMUtility command Example VCMUtility c VCMconfig txt Each option in the file must begin on a new line Option names must begin in column 1 and be followed by at least one white space character An option s value can flow onto multiple lines by starting each continuation line with a blank or tab character Blank lines are ignored You provide comments by prefixing them with a double forward slash Example This is a c
27. December 29 2001 10 52 00 AM PST gfgl Configures the view using the specified label Without cfg1 cfgp or cfgd the view s current configuration is used cfgp Configures the view using the specified promotion state e01 When on calculates status of text file without using end of line eol markers When off which is the default the update status is computed on working file and tip revisions as they are with their current end of line markers With this option on a working file that has LF eol markers can be compared to a tip revision with CR LF eol markers and be considered Current if the only difference is the eol markers contents Sends file contents rather than MD5 checksum filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other whitespace in this string Only files that currently have the specified statuses will be updated c for Current M for Modified G for Merge O for Out of Date I for Missing and U for Unknown e Reports the status of every file in the specified folder s working folder unless its status is Not In View Without this option a file s status is displayed only if it has changed 70 Example The following example uses stcmd update status to verify that each file in the working folder for the StarTeam folder named SourceCode has an accurate status SourceCode is a child of the root folder StarDraw in the StarDraw view of the St
28. In a Rebase if a file is binary and has been modified in both the source and target overwrite the target with the source version DefaultAction MergeType Rebas items binaryfile source modified target modified Overwrite In a Promote if a CR has moved in both the source and target views to different folders move the target item to the matching folder as the source item but only if the CRs are on the same branch DefaultAction MergeType Promote ItemType CR source moved target moved items branched false Move DefaultAction is ignored for Compare sessions DefaultComment DC DefaultComment lt comment gt Specifies the default revision comment to be used for new item revisions created in the target view The lt comment gt is a free form text string Within the comment value all white space sequences including line breaks CRs and LFs blanks and tabs are converted into a single blank for each occurrence By default an auto generated comment is used as the default revision comment for new item revisions To disable the use of a default revision comment specify the DefaultComment option with an empty value DefaultComment is ignored for Compare sessions Exclude BXC Exclude lt folders gt Exclude the specified folders from the source scope Only folders explicitly specified in Include lt files gt or Include lt folders gt are excluded Consequently an Exclude lt folders gt option can be us
29. Indicates that the file status information will be stored at a central location for this user on this workstation This location can be set using the Windows or Cross Platform client or this command see the central repository option If you do not set this location it defaults to For Windows NT the folder in which the application has been installed For Windows XP C Documents and Settings username Local Settings Application Data Borland StarTeam For non Windows platforms user_ home directory starteam client per folder status Indicates that each working folder will contain file status information for its own files The information is stored in the sbas folder a child folder of the working folder If you move the working folder the file status information goes with it 15 St Displays a list of the personal options as currently set in the starteam client options xml that stores them Example The following example uses stcmd set personal options to indicate that file status information will be stored in a central location C JMarsh statusinfo stemd set personal options central status central repository C JMarsh statusinfo Related Reference Client Command line Operations 69 Update File Status stcmd update status When you update the status of a file StarTeam compares the working file with the revision you checked out and the tip revision For example your File list may say that the file is Current bu
30. MergeFiles is ignored for Compare sessions Match Match Folder lt folder path gt to lt folder path gt Specifies that for comparison purposes the folder specified in the first lt folder path gt which must reside in the source view should match the second lt folder path gt which must reside in the target view The Match option is sometimes needed to prevent ambiguous match conditions which can occur when one of the views is a non derived view Typically the Match option is only needed to match the source and target view root folders However other folders can be matched to resolve other ambiguous match conditions reported by the compare phase Both the source and target lt folder path gt must begin and end with a forward slash By convention the root folder is represented by a single This means that the root folder name should not be provided in folder paths For example if the root folder is named StarDraw the folder path for the immediate child folder Source Code is simply Source Code Examples Force the source and target root view folders to match Mateno Force the source view folder Source Code to match the target view folder Modules Materials src Match Source Code to Modules Materials src MergeType Type MT MergeType Compare Rebase Promote Replicate Specifies whether to perform a Compare session or a Rebase Promote or Replicate merge sess
31. OG Mes T Mice Ikil BOG dle sits sys Jen March ie O06 E S222 PMI PSTN gSaturcday Marchr inii AOOG Is sverq PM PESTA Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt match state gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt topics gt Cheat Sheet 116 lt topics gt Topics ALL lt Topic gt Includes the specified individual topics by topic number The keyword Topics can be singular Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt match state gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt Cheat Sheet 117 Index All 105 Bulk Check out utility command line options 9 Change Packages VCMUtility 76 check out Trace Utility command line operations 24 False 77 1 54 Status Ready 16 Vault Verify Command line 25 VCM Log Files VCMUtility 75 VCM Utility lt tasks gt 115 VCMUtility Overview 73 lt action gt 101 lt change requests gt 104 lt check out options gt 102 lt files gt 105 lt folders gt 107 lt item type gt 109 lt match state gt 110 lt process item gt 112 lt requirements gt 113 lt revision labels gt 114
32. Requirement 1 1 Task Tasks Leyak TOPi ders ChangeRequests CRs Req Requirements Reqs es lt match state gt Ac leemi condit Erone lt process items gt ProcessItems View lt view gt CR lt CR gt View lt view gt Req lt Req gt View lt view gt Task lt Task gt lt requirements gt Requirement Req Requirements Reqs ALL lt Req gt lt revision labels gt RevLabels lt label gt lt task gt Task Tasks ALL lt Task gt lt timestamp gt Example formats Wi Sy AAL 10 Lg SEMU Marma ZOTE ils S25 S PMI 20016 ibys ya ciel PM ESTI Mareh nn Woaturday March 117 20 0 6 mE S23 Sie TEMPEST 98 lt topics gt Topic ii Topicsh ALL p STOPIE gt lt VCM exchange file gt A vcms file name lt VCM session file gt A vcms file name Related Reference Overview of the VCM Command line Utility VCMUtility VCMUtility Commands VCMUtility Connection Options VCMUtility Session Options VCMUtility Miscellaneous Options VCMUtility Examples Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt 99 Syntax for VCMUtility Com
33. StarDraw view of the StarDraw project stcemd label p JMarsh password Orion 1024 StarDraw StarDraw nl Beta b Related Reference Client Command line Operations 59 Create Working Folders stcmd local mkdir Use stcmd local mkdir to create the working folder or working directory on your workstation for the specified StarTeam folder Use is to create working folders or working directories for the specified StarTeam folder s child folders as well Syntax The syntax for this command is as follows stcmd local mkdir p projectSpecifier pwdfile filePath cmp csf encrypt encryptionType cfgl labelName cfgp stateName cfgd asOfDate kasi tei A secos mas boliderPathti io W oleecan Option Description cfgd Configures the view as of the specified date time Examples include 12 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday December 29 2001 10 52 00 AM PST cfgl Configures the view using the specified label Without c g1 cfgp or cfgd the view s current configuration is used cfgp Configures the view using the specified promotion state Example The following example uses stcmd local mkdir to create the working folders for SourceCode a child of the root folder StarDraw in the StarDraw view of the StarDraw project and its child folders stcmd local mkdir p JMarsh password Orion 1024 StarDraw StarDraw SourceCode is Related Reference Client Command line
34. The default is that StarTeam folders are not differentiated based on the case of letters in their names With or without csf if folder names are ambiguous an error occurs For example when you use csf the names of two folders are ambiguous if both a Doc and doc folder exist When you do not use csf folder names are ambiguous if they are spelled identically Does not check out files but displays a list of the files that would be checked out if dryrun were not specified The paths are those for the working folders into which the files would have been copied When used with vb you get a complete picture of what would have happened Encrypts all the data sent between the workstation and the server and unencrypts it when it arrives Without this option encryption does not take place Encryption protects files and other project information from being read by unauthorized parties over unsecured network lines The full syntax is encrypt encryptionType BCO supports the following types of encryption RC4 RSA RC4 stream cipher fast RC2_ECB RSA RC2 block cipher Electronic Codebook RC2_CBC RSA RC2 block cipher Cipher Block Chaining RC2_CFB Windows platforms only RSA RC2 block cipher Cipher Feedback These encryption types are ordered from fastest to slowest Each of the slower encryption types is safer than the one preceding it Can automatically convert end of line markers When specified with the on option text file
35. Trace Utility Command Line Operations This topic describes the command line options for the Check out Trace utility Vault Verify Command line Options This topic describes the command line options for the Vault Verify utility Bulk Check out Utility Command line Options This topic contains the following information about BCO Syntax Command line Options BCO Usage Examples Syntax BCO uses the following syntax p projectSpecifier pwdfile filePath autoLogon cwf is rp folderPath fp folderPath cmp dryrun vb useCA encrypt encryptionType cfgl labelName cfgp stateName cfgd asOfDate filter fir lestatus o o ts fs 01 en GEf cr 1f crit exclude lt pattern gt lt pattern file gt netmon t h help files Options The table below describes options used with BCO Option Description autoLogon If a user name is not specified in the p option an attempt is made to logon using the user ID and password for the specified Server as stored by the Toolbar utility This is available only on Windows operating systems cfgd Configures the view as of the specified date time Examples include m 12 29 01 10 52 AM m December 29 2001 10 52 00 AM PST m Monday December 29 2001 10 52 00 AM PST fgl Configures the view using the specified label Without cfg1 cfgp or cfgd BCO uses the current configuration for
36. a given timestamp TargetTime can only be used for Compare sessions The keyword Now causes a snapshot of the current time to be used as configuration timestamp Only one of TargetLabel TargetState and TargetTime can be specified If none of these options is specified the option TargetTime Now is implicitly used TargetView Target PY TargetView lt view gt Specifies the target view to be used in the VCM session If more than one view within the project has the same lt view gt name a slash separated view path can be provided for example MainView ChildView GrandchildView If the view name contains embedded slashes it must be enclosed in quotes TargetView is optional for Promote merges if specified it must be the parent of the source view For Compare sessions the target view can be the same as the source view 91 Note View names are case insensitive Resumed Session Options So that the same options file can be specified for a Resume command all options allowed for new sessions can also be specified for resumed sessions However most options if re specified are ignored because they cannot be modified once the session has been started The only exceptions are the options specifically outlined below Connection options Since connection information server address and port userid and password are not persisted in the VCM session file connection information must be re specified for resumed sessions However a r
37. able to omit the quotation marks Mysterious failures of batch scripts on either platform may be due to this omission Several special characters can be used in the file specification Matches any string including the empty string For example matches any filename with or without an extension xyz will match xyz and xyz cpp and xyzutyfj Matches any single character For example a c will match abc but NOT ae Matches any one of the characters enclosed by the left and right brackets A pair of characters separated by a hyphen specifies a range of characters to be matched If the first character following the right bracket is an exclamation point or a caret the rest of the characters are not matched Any character not enclosed in the brackets is matched For example x a d y matches xby but not xey x a d y matches xey but not xby A hyphen or right bracket may be matched by including it as the first or last character in the bracketed set To use an asterisk question mark or left bracket in a pattern you must precede it with the escape character which is the backslash Specifies a string of one or more characters each of which represents a file status Never include spaces or other white space in this string Only files that currently have the specified statuses will be checked out You cannot check out files that are Not In View The
38. all Wiovenine xacl elencel yal S NEO cs eoil kein orn ermer Es aryr e allway spr rompt neverprompt conflictprompt mpxCacheAgent number useMPXCacheAgent host port autolocate serch n Option Description cfgd Configures the view as of the specified date time Examples include 12 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday December 29 2001 10 52 00 AM PST igl Configures the view using the specified label Without cfg1 cfgp or cfgd the view s current configuration is used cfgp Configures the view using the specified promotion state eoL Can automatically convert end of line markers When on text files are transferred from the Server s repository to the workstation s working folder with the end of line convention for the platform executing the command as determined by the Java VM When off the default no end of line conversion is performed Using off is the same as not using eol at all When you specify the end of line character cr If or crlf text files are transferred from the Server s repository to the workstation s working folder with the specified end of line convention For Windows clients the end of line marker is a carriage return line feed crlf combination for UNIX platforms it is a line feed If for MAC systems a carriage return cr You would set this option to on or If for example when you compare a file from the repository a
39. an automatically generated VCM session filename is used for an Import command Open Command Open lt Change Package name gt Resumes a VCM session previously saved as a change package with the given name This option is only available on servers that support change packages The specified name must be the default or user specified name of a saved uncommitted change package belonging to the specified Project and TargetView which are required Also the session must not be locked by another user which typically indicates that it has already been opened by that user For additional information see the Name Save Import and Resume commands Replay Command Replay lt Change Package name gt Creates a new VCM session by replaying a previously committed change package to a new target view This command is only available when the server supports change packages The named Change Package must belong to the project specified by the Project option and the view identified by the SourceView option Since committed change packages belong to the target view they update the target view of the change package to be replayed is always the source view for the new session When the Replay command is used the Target View should be specified allowing the MergeType of the new session to be chosen automatically based on the relationship between the two views Ifthe target view is a child of the source view a Rebase session is performed Ifthe ta
40. and SourceTime can be specified If none of these options is specified the option SourceTime Now is implicitly used SourceView Source SV SourceView lt view gt 90 Specifies the source view to be used in the VCM session If more than one view within the project has the same lt view gt name a slash separated view path can be provided for example MainView ChildView GrandchildView Ifa view name contains embedded slashes it must be enclosed in quotes SourceView is optional for Rebase merges if specified it must be the parent of the target view Note View names are case insensitive TargetLabel TgtLabel TL TargetLabel lt label gt Requests the target view to be used as of a given view label Target Label can only be used for Compare sessions Label names are case insensitive Only one of TargetLabel TargetState and TargetTime can be specified If none of these options is specified the option TargetTime Now is implicitly used TargetState Tgtstatve TS Targetstat e lt state gt Requests the target view to be used as of a given view promotion state Target State can only be used for Compare sessions Promotion state names are case insensitive Only one of TargetLabel TargetState and TargetTime can be specified If none of these options is specified the option TargetTime Now is implicitly used TargetTime TgtTime PE TargetTime lt timestamp gt Now Requests the target view to be used as of
41. and line Operations 57 Create Labels stcmd label Use stcmd label to create a view or revision label A view label can be designated as a build label By default view labels are automatically applied to every folder file change request requirement topic and task in the view By default revision labels are not applied to any items You can use stcmd apply label to apply labels created with stcmd label to specified files You can also use the label option v1 in stcmd ci to attach your new label to files as you check them in Option Description sp Specifies that the new label is a build label Without either b or r the label is a view label View labels and a build label is a special type of view label are immediately and automatically applied to every folder file change request task and topic in the view a Specifies the description of the label f Creates the new label as a frozen label n Specifies the new label s name Specifies that the new label is a revision label You can use the new label to label files that you check in This command does not attach the new label to any items unless you create the label by copying an existing revision label that is attached to one or more items See the v1 option below vd Specifies the as of date time for the label when you create a view label vd is ignored if you are creating a revision label Without the vn or vd or v1 option the current time is used for view
42. arDraw project stcmd update status p JMarsh password Orion 1024 StarDraw StarDraw SourceCode Related Reference Client Command line Operations 71 VCM Command line Utility The View Compare Merge Command line Utility vVcMUti1ity Compares a source StarTeam view to a target view and optionally merges the differences into the target view This section includes all the help topics associated with the VCMUtility View Compare Merge is only available in the StarTeam Cross Platform Client and the VCMUtility In This Section Overview of the VCM Command line Utility VCMUtilit Explains the View Compare Merge command line utility called vVcMUtility VCMUtility Commands Explains the View Compare Merge command line utility VCMUtility command types VCMUtility Connection Options Explains the View Compare Merge command line utility VCMUtility connection options VCMUtility Session Options This section describes the VCMUtility options that can be used in new sessions VCMUtility Miscellaneous Options Explains the View Compare Merge VCMUtility command line utility miscellaneous options VCMUtility Examples Shows examples of using the VCMUtility Cheat Sheet Lists the VCMUtility commands and options and their syntax Syntax for VCMUtility Compound Options Explains the details of the syntax requirements for each VCMUtility option 72 Overview of the VCM Command line Utility VCMUtility The vcMU
43. as CR LF f NCI Specifies the check in of any file whose status is Modified NCI stands for needs check in No other types of files are selected for check in 48 filter mark nel nomove pE O SEW vl Example f NCI is ignored if filteris used Specifies a string of one or more characters each of which represents a file status Never include spaces or other white space in this string Only files that currently have the specified statuses will be checked in You cannot check in files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown filter takes precedence over f NCI If you use G O or U you must also specify ior o Otherwise the G O or U is ignored Allows an interactive check in for files whose status would normally not allow them to be checked in You are asked about each file whose status is Merge Out of Date or Unknown You can force the file to be checked in with your response If you use the i option you cannot use the o option Locks each file after it has been checked in Without 1 u or ne1 the files lock status is unchanged Indicates that if all the files are successfully added the process item s status will be changed to fixed for a change request finished for a task or complete for a requirement The files are pinned to the revision with the n
44. ate and cause confusion The view name in the example is StarDraw Because this is the root view of the StarDraw project it could have been omitted Use a folder hierarchy to identify the folder Use the forward slash as a delimiter between folder names The folder hierarchy never includes the root folder Omit the folder hierarchy if the file is in the view s root folder For example if the root folder of the view is StarDraw and the hierarchy to your files is StarDraw SourceCode Client use only SourceCode Client If any of the parameters used with this option for example user names view names passwords project names or folder names contain characters that are used as delimiters use the percent sign followed by the hex code for each of those characters For example if appears as a character in a password you must replace it with 340 For use 33a For use S2 For use 340 For use 25 In UNIX and other operating systems some special characters must be preceded by a backslash or another escape character In the p option you can replace such characters with hex codes For example 3c could be used in UNIX instead of lt For a space use 320 For lt use 33c For gt use 33e Specifies the path to a file that stores the password for the user This option overrides the password used as part of the p option It prevents others from seeing the pass
45. ated by commas spaces or semicolons To include a comma space or semicolon as part of the specification enclose the specification in double quotation marks For example teze dli p 2 doci t test 4 i If you are using double quotation marks in your exclude list or have a lengthy exclude list we recommend that you use the exfile option With exlist each quotation mark in the exclude list needs to be preceded by the escape character for your system or shell For example the caret works on NT systems With exfile you do not need to use escape characters kw Specifies the file extensions with which you want to use keywords Use a maximum of 254 characters Enter one or more file specifications using the standard and wild cards separated by commas spaces or semicolons 43 kwfile name S Example To include a comma space or semicolon as part of the specification enclose the specification in double quotation marks For example cpp h p z doc t t test If you are using double quotation marks in your keyword list or have a lengthy list we recommend that you use the kwfile option With kwlist each quotation mark in the keyword list needs to be preceded by the escape character for your system or shell For example the caret works on NT systems With kwfile you do not need to use escape characters Specifies the path to the file containing the file extensions with which you want to
46. d only with merge Enables you to specify an alternate application other than that available with the application to perform the merge The value of the option should be the name of a program to run to perform the merge for example hook mymerge sh The merge application must return an exit code of 0 meaning that no conflicts were detected and an exit code of 1 meaning that conflicts were detected Any other value indicates an error The merge application cannot be a batch file on Windows platforms because when run via Java the result code is not returned properly For each file to be merged stcmd provides three arguments to the merge application The arguments are the fully qualified paths to the following three files in this order localFile The local working file commonFile The contents of the file revision in the repository which is the most recent common version between the file being modified locally and the specified revision in the repository otherFile The contents of the file revision being checked out The merge hook program must send the merge result to standard output stdout Allows an interactive check out for files whose status would normally not allow them to be checked out You are asked about each file whose status is Modified Merge or Unknown You can force the file to be checked out with your response If you use the i option you cannot use the o or merge option Locks each file after it has been checked o
47. database name is different than the ODBC DSN On Linux use this option only if dbinstance is not used and the Oracle service name is different than the TNS name dbinstance lt name gt This option is only meaningful on Windows When used it causes VaultVerify to open the database directly instead of via the ODBC DSN specified in the configuration file For SQL Server the lt name gt must be the instance name e g SSE2005_ST Note that the default Instance name for SQL Server is MSSQLSERVER and for SQL Server Express it is SQLEXPRESS For Oracle should be the service name e g ORCL dbinstance must be used with dbhost when the database server executes on a different host For SQL Server dbname should also be used if the database name is different than the ODBC DSN For Oracle dbname is ignored if dbinstance is specified dbpassword lt password gt Specifies the database logon password If not specified a blank password is used The password stored in the configuration is encrypted and cannot be used by Vault Verify On server 25 dbport lt pert gt dbuser lt user gt heilp er n gr S27 path lt folder path gt nosharereport repair sf lt folder path gt E useca lt host gt lt port gt verbose configuration configurations running against Oracle this option must be specified since the Oracle password is never empty Specifies the TCP IP port to use to conn
48. date and time in the local time zone ReportUpdates is ignored for Compare sessions Save Save lt VCM session file gt Specifies that the VCM session is to be saved By default uncommitted VCM sessions are automatically saved to a VCM session vcms file with a default name using the format lt user home gt VCMSession YYYY MM DD_ hh mm ss vcms where YYYY MM DD_hh mm ss is the date and time when the session is saved The folder lt user home gt is the user s home directory If the Save option is specified witha lt VCM session file gt name an uncommitted session is saved with the given file name instead of the default name If needed vcms is appended to the name If the given file name does not contain path information the session file is stored in the user home folder 89 A vcms file contains VCM session metadata but not the contents of merged files Merged file contents are stored in a user relative temporary folder referenced by elements in the session file Consequently a vcms file can only be used to resume the VCM session on the same workstation See the Resume command When the Save option is specified without a file name an attempt is made to save an uncommitted VCM session as an active change package in the target view The change package is saved with the default or user specified name see the Name option A VCM session saved as a change package can later be resumed on any workstation using the Open
49. de lists the application does not display it at all It is as though the file did not exist For example suppose you are creating files in an application that makes automatic backup copies of each file with the extension bak every time you save a file Your working folder might contain several bak files but you have no reason to add them to the project view From the application it is annoying to see these bak files as possible candidates so you exclude them Excluding files is done on a per folder basis However exclude lists can be inherited from parent folders The full syntax is ex excludeTyp The types are inherit Indicates that the root folder will inherit any exclude lists used by its parent folder and use the exclude list specified with either exfile or exlist if one is created This is the default even though the root folder has nothing to inherit local Indicates that the root folder will use only the exclude list specified with either exfile or exlist none Indicates that the root folder will use no exclude lists regardless of what you specify with either exfile or exlist exfile Specifies the path to the file that contains the local exclude list for the root folder See exlist for a description of the exclude list s contents exlist Specifies the local exclude list for the root folder Use a maximum of 254 characters Enter one or more file specifications using the standard and wild cards separ
50. difference An lt action gt is one of the following mnemonics Mnemonic Description Delete Delete the target item DeleteAndReverseShar Equivalent to a Delete followed by a ReverseShare Fail Synonym for NeedsReview see below Ignore Take no action arkResolved Create a merge point only that marks the source and target items as resolved erge Merge the source and target items ove Move the target item to the equivalent folder as the source item oveAndMerge Equivalent to a Move followed by a Merge oveAndOverwrite Equivalent to a Move followed by an Overwrite oveAndRepin Equivalent to a Move followed by a Repin NeedsReview Force a review before a commit That is do not allow commit while this action is selected Item differences with this action are conflicts therefore their action must be changed to something else Overwrite Overwrite the target with the contents of the source Repin Change the revision to which the target is pinned to match the source item ReverseShare Move the source item to the target view and share it back to the source view Share Share the source item to the target view Note Not every lt action gt is valid for every item difference For example Delete is not valid when the target item is already deleted Related Reference Syntax for VCMUtility Compound Options lt change requests gt lt check out options gt lt files gt lt folders gt lt match state gt lt process item g
51. e cfgl labelName cfgp stateName cfgd asOfDate e Sen se ecaa eas itoukclescierea S Miroiloleiezercla oea Witsilhasheciene Feot kei osz sel ae eria lly Bewes Soll am SaaS ie mael ec number n nd e vl labelName vd asOfDate vn revisionNumber files Option Description p When comparing two lines of text files ignores trailing whitespace and treats all other strings of whitespace as equal in length For example the following lines are equivalent hi mom hi mom Bpvcs When comparing two lines of text files ignores leading and trailing whitespace For example the following lines are equivalent because there is only one space between hi and mom hi mom hi mom but the next line is not equivalent hi mom sG Specifies the number of unchanged lines to display before and after a difference is found in text files Without this option all lines of the files are displayed For example c 2 places two unchanged lines before and after each line or set of lines that has changed gfgad Configures the view as of the specified date time Examples include 12 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday December 29 2001 10 52 00 AM PST cigl Configures the view using the specified label Without cfg1 cfgp or cfgd the view s current configuration is used cfgp Configures the view using the specified promotion state e Causes
52. e default which specifies that no locks are to be created for items with unresolved locks Note that locks are only applied to source and or target items for which differences are found Locks are not applied to items that are compared for which no differences are found Also note that this option is not affected by the Project option Require exclusive comment when files are checked in nor the client workstation option Exclusively lock files on check out Those options are properly handled by the VCM engine LockMergeConflicts is ignored for Compare sessions ManualMergeFiles MMF ManualMergeFiles True False If True this causes the file merge tool configured for the workstation to be launched for each source target file pair found in a content merge state The ManualMergeFiles option can be used in conjunction with AuttoMergeFiles If a merge conflict is detected and AutoMergeFiles is requested an auto merge attempt is made first If the conflict is resolved the merged result file is saved and a manual merge is not needed Ifthe auto merge is not successful or if AutoMergeFiles has not been requested then if ManualMergeFiles s True a manual file merge is performed 86 Note ManualMergeFiles is ignored and a warning is displayed if the workstation has no manual merge tool configured Also if the manual merge tool cannot be launched or returns an error condition the affected file remains in an unresolved conflict state Manual
53. e directory This options file is named starteam It contains a variable or shell variable called keyfile The keyfile variable specifies the location of the file that contains the public and private keys If you do not specify the keyfile variable an error occurs When you specify the keyfile variable but the file does not exist the StarTeam Client generates a random pair of keys creates the file and stores the keys in it Be sure to secure this file For example in UNIX only its owner should be able to read it eol on off Perform end of line conversion of text files epwdfile Store s a user s password as an encrypted value in a local file This feature supports automated build scripts which must run unattended The script would call st cmd with a specific user name and the filename containing the encrypted password for that user name The password is then internally decrypted and passed to the server without being transmitted across the network as clear text The epwdfile keyword specifies the path to the file that contains the encrypted password Like pwdfile epwdfile overrides the password being used as part of the p otion preventing others from seeing the user s password on the command line The full syntax is 30 epwdfile filePath The following table gives the syntax of the commands that can be used to store an encrypted password Action Syntax To be prompted for the password that will be encrypted
54. e fileName is the name of the file and x is the number of the revision being checked out If you do not specify merge files with the status Merge are ignored unless you specify o and force the check out operation nel Non exclusively locks the file after it has been checked out Forces the check out of files of any status If you use the o option you cannot use the i or merge option 26 Makes the working file read only after this operation Without this option the file remains as it was prior to the operation Usually you use ro to prevent yourself from editing a file that is not locked by you ro must be used with 1 or u or ne1 If you use ro you cannot use rw rw Makes the working file read write after this operation Without this option the file remains as it was prior to the operation rw must be used with 1 or u or ne1 If you use rw you cannot use ro ts Sets each working file s time stamp to the check out time Without this option the file is given the same time stamp as the checked in revision of the file u Unlocks the checked out files vd Specifies the as of date time used to identify the revisions to be checked out The last revision before the specified date time is the one checked out for each file See the date time examples for c fga above awl Specifies the revision or view label used to identify the revisions to be checked out Without the vn or vad or v1 option the tip revision of each
55. e full path name of the log file is written to the console window when the log file is started VCMUtility Support for Change Packages Beginning with the StarTeam 2009 release the vcMUtility supports change packages for any StarTeam configuration that has been upgraded to the 2009 release Because change packages are persistent objects stored at the server they offer many advantages and over VCM session vcms and VCM export vcmx files Therefore for StarTeam configurations that have been upgraded change packages are preferred over session and export files for saving and resuming sessions Correspondingly the Save option without a parameter and the Open command are preferred over the Save option with a parameter the Resume command the Export command and the Import command However for backward compatibility the 2009 vcmUtility still supports commands that use VCM session files See the Open command and the Save option for more information Related Reference VCMUtility Commands VCMUtility Connection Options VCMUtility Session Options VCMUtility Miscellaneous Options VCMUtility Examples Cheat Sheet 76 VCMUtility Commands This section defines VCMUtility functionality in terms of its utility execution commands Each vcMUtility execution performs one command For a description of syntax conventions see Overview of the VCM Command line Utility in the Related Reference links below VCMUtility Command VCMUt
56. ect to the database server This parameter is only used on non Windows platforms when a different port is used than the vendor s default database port e g 1521 for Oracle Specifies the logon ID used to connect to the database If specified this parameter overrides the user specified in the StarTeam lt configuration gt The only valid user to use with this option is the user that owns the StarTeam tables Displays this usage information Specifies the folder path of the starteam server configs xml file This file must exist and contain the specified lt server configuration gt By default this file is opened in the parent folder of the current working directory if it is not found in the current working directory Suppresses the reporting of share information Normally all share paths of each corrupt file is reported This option suppresses the share path information which can speed up application execution and substantially reduce the report size Specifies that an attempt should be made to correct archive file problems Corrupt archives are moved to the corrupt file folder see the c option If they correspond to valid file revisions they are then treated as missing Missing archive recovery is attempted from other vault files and if the useca option is specified from a Cache Agent Stray archives are moved to the stray file folder see the s option Note repair is ignored if the StarTeam lt configu
57. ed Promote by View Label Compare Only The options below perform a compare only promote of files and CRs as of a view label saving the session in a specific session filename Connection settings Server MyUserid ProdServer 4000 PwdFile MyPassword txt Merge type and view configuration Type Promote Project StarDraw Source Beta Release SrcLabel Build 4 0 142 Select all files and CRs as source items include all include fe Apel Gir 94 Compare only report and save with a specific session filename CommitMerge False save Build 4 0 142 Promote ReportDiffs Miscellaneous options m AutoMergeFiles rue AutoMergeProperties False leave these as conflicts and merge manually LockMergeConflicts Target Promote by View Label Merge The VCM utility command line below resumes the session saved in the previous example and commits it assuming no new conflicts have occurred VCMUtility resume Build 4 0 142 Promote CommitMerge ReportUpdates Related Reference Overview of the VCM Command line Utility VCMUtility VCMUtility Commands VCMUtility Connection Options VCMUtility Session Options VCMUtility Miscellaneous Options Cheat Sheet 95 Cheat Sheet VCMUtility command line syntax vcMUtility lt options file gt Within the lt options file gt each lt option gt must begin in column 1 but can continue on subsequent lines if those lines begin with a space or tab charac
58. ed to prune unwanted folders from the source scope For Example jinelude CRs and filles in all folders below a b Include a b ralli CRs Files But exclude CRs in folder a b c Exclude a b c CRs 84 Hpac whe ehis IR aks abo Ffolder 7a b e She aks Stili ineluded Include CR 12345 Regardless of declaration order Exclude options are processed after Include options Include and Exclude Semantics If no Include options are specified the default VCM session scope is implicitly all files in the source view This is equivalent to explicitly specifying include al11 If atleast one Include option is specified the scope is explicitly limited to those items selected by Include statements In both implicit and explicit scopes all selected source items are pruned by any Exclude options All Include and Exclude options must identify objects labels files CRs and so on in the source view Also selection type names can be singular or plural RevLabel CR and so on even if multiple values are provided Note Exclude options are always processed after Include options regardless of declaration order Therefore Exclude src foo bar followed by Include src foo all causes folder src foo bar to be excluded Export Exp Export lt VCM exchange file gt The Export option specifies that all the VCM session information including merged result files are to be combined and stored in the g
59. ed with add folder you can add an entire branch of folders to the Star Team folder hierarchy When it is used with add project you can create a project with more than just a root folder Locks a file mark Marks a change request as fixed a requirement as complete or a task as finished nel Non exclusively locks a file nologo Supresses the copyright notice nologo works with each command although not shown in the syntax 33 nomove Do not move labels if already attached O Forces check in p Indicates the view or folder to be used also provides the user name and password needed to access the server The full syntax is p userName password hostName endpoint projectName viewName folderHierarchy For example p bsmith rocketfive orion 49201 StarDraw StarDraw SourceCode Ifthe user name is omitted the current user name is used 4 Ifthe password is omitted the user is prompted to enter the password When the user types a password the characters are not displayed on the screen Ifthe host name is omitted the default is localhost Entering an endpoint port number is required The default is 1024 The project name is always required A view hierarchy should be used to identify the view Use the colon as a delimiter between view names The view hierarchy should always include the root view For example StarDraw Release 4 Service Packs indicates that the view to be
60. ell Consequently on systems where option values must be passed to the vcMUtility that require characters not expressible by the launching environment those options must be passed by way of the options file When the options file does not begin with a byte order mark BOM it is opened with the system default character set for example ANSI Windows 1252 on Windows UTF 8 on Linux If the options file begins with a BOM it is interpreted with the corresponding encoding UTF 8 and UTF 16 encodings allow the full set of Unicode characters to be provided in the options file For Reference the BOM sequences are 74 BOM Encoding OxEFBBBF UTF 8 OxFEFF UTF 16 BE big endian OxFFFE UTF 16 LE little endian Boolean Options The default for all Boolean options whose value can be True or False is False However specifying a Boolean option without an option value is the equivalent to specifying the value True Thus a Boolean option can be enabled by simply including it Example Set these options to True AutoLogon BreakLocks Abbreviations In addition to their long form shown in this document most command and option names have one or more short forms or abbreviations These alternate spellings help shorten VCMUtility command tails with lots of options The full lists of abbreviations can be achieved by using the command Help abbreviations Example abbreviations are Help Hor ActiveProcessItem ActivePI orAPI S
61. ember 29 2001 10 52 00 AM PST eigl Configures the view using the specified label Without cfg1 cfgp or cfgd the view s current configuration is used cfgp configures the view using the specified promotion state filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other white space in this string Only files that currently have the specified statuses will be listed You cannot list files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown short Provides a short and simple listing of local files and their statuses consisting of the abbreviation for the status and the relative path to the working file for example M starteam Server java N starteam Labellnfo java Without this option the listing consists of A line for each folder name followed by its working folder s path Within a folder a line for each file starting with the unabbreviated status and containing the rights time stamp and name of the file For example Folder Source working dir E Source Unknown rw 4 6 02 7 42 18 PM PST 230 req bmp Example The following example uses stcmd list to list all files in SourceCode a child of the root folder StarDraw in the StarDraw view of the StarDraw project as well as all the files in child folders of SourceCode stemd list p JMarsh pa
62. epair option Vault Verify attempts to correct problems found Vault Verify opens the database for the server configuration but does not modify it Valid options for Vault Verify are described in the following table Option Description check missing corrupt stray all Determines which integrity checks to perform missing Checks for missing files by comparing the database against archive files actually present corrupt Checks the integrity of existing archive files MD5 name folder and gz file format stray Checks for extraneous files based on the database This option cannot be used if the server configuration is in use all Performs all integrity checks Multiple check options can be specified Also see the repair option cf lt folder path gt Path name of the corrupt file folder where problem files found by the corrupt check are moved when repair is specified The default corrupt file folder is C Temp VVCorruptFiles dbhost lt host gt Specifies the host name of the database for the specified lt server configuration gt On Windows it is only meaningful when dbinstance is also provided On Windows and Linux use this option only when the database server executes on a different host than this one dbname lt name gt Specifies the database name for the specified lt configuration gt On Windows this parameter is only meaningful when dbinstance is also specified and it is only needed when the
63. er is locked only server administration commands are accepted When the server configuration is unlocked normal operations resume Note If the user name is StarTeam this command requests a password for the user even if one has already been provided or if the user has a blank password Syntax The syntax for this command is as follows stemd server mode pwdfile filePath cmp encrypt encryptionType q x stop s serverName mode lock exlock unlock Option Description exlock Exclusively locks the server so that no one else can access it lock Nonexclusively locks the server Only administrative commands can be performed mode Indicates whether the server is to be locked exclusively locked or unlocked If you use mode lock only server administration commands are accepted until the server is unlocked For example you might use this command while running a backup program If you use mode exlock only you can access the server until it is unlocked For example you might do this when creating a custom field Use mode unlock to make the server available to users again unlock Unlocks the server so that anyone with the appropriate access rights can access it 5 Specifies the server The full syntax is s userName password hostName portNumber For example s JMarsh password orion 49201 If the user name is omitted the current user name is used The user name in the example is JMarsh
64. es include 42 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday December 29 2001 10 52 00 AM PST This option must be used with one of the following combinations dr ro dr ba Of dr bn cfgl Configures the view using the specified label Without cfgl cfgp or cfgd the view s current configuration is used This option must be used with one of the following combinations dr ro dr ba or dr bn cfgp Configures the view using the specified promotion state This option must be used with one of the following combinations dr ro dr ba or dr bn d Specifies a description for the view Use a maximum of 254 characters dr Specifies a derived view All views except blank views are derived See also ba bn and ro When used without ba bn or ro a read write reference view is created The configuration of a read write reference view is the same configuration as its parent view Therefore using dr without ba bn or ro but with cfgl cfgp or cfgd results in an error message 45 When this option is not used a blank view is created For blank views the value of the view property named Set Items Shared Into View To Branch On Change is initially cleared name Specifies a name for the view Use a maximum of 254 characters ro When used with dr specifies a read only reference view Examples The following example uses stcmd add view to create a branching view named Maintenance 5 1 on
65. esumed session will fail if it is not reconnected to the same StarTeam server of if a different user is used that has permission conflicts with the views or items used in the VCM session CommitMerge This option will commonly be specified to True in a resumed session This allows the original VCM utility execution to be used as a compare only run and a second VCM utility execution to be used as a commit run ReportDiffs This option can be specified in a resumed session If true a difference report is created before the commit phase if any ReportUpdates This option can be specified in a resume session If true and the commit phase is successfully performed all changes made to the target view are reported CheckoutPreview Normally if CheckoutPreview was specified in the original VCM session the merge preview check out operation is performed in the resumed session with the same options as before However if Checkout Preview is specified in the resumed session it overrides the original option and causes files to be checked out in the resumed session according to the new settings Description If specified this option overrides the default or previously provided Change Package description text The new description text is used for the new Change Package revision created when the VCM session is saved or committed ManualMergeFiles Normally ifManualMergeFiles was specified in the original VCM session and the session is sa
66. ew status Non exclusively locks each file after it has been checked in Stops the application of the label specified by the vl option if the file which is being checked in already has a revision with that label Otherwise the label will be moved from the currently labeled revision to the newly checked in revision Forces check in for files whose status would normally not allow them to be checked in This option forces all files whose status is Merge Out of Date or Unknown to be checked in If you use the o option you cannot use the i option Provides a revision comment usually the reason for checking in the files If you use the r option you cannot use the rf option Provides the path to the file that contains the revision comment If you use the rf option you cannot use the r option Makes the working file read only after this operation Without this option the file remains as it was prior to the operation Usually you use ro to prevent yourself from editing a file that is not locked by you ro must be used with 1 or u or ne1 If you use ro you cannot use rw Makes the working file read write after this operation Without this option the file remains as it was prior to the operation rw must be used with 1 or u or nel If you use rw you cannot use ro Unlocks the newly checked in files Specifies a label created using stcmd label to be applied to the checked in files The label is enclosed in doub
67. file is checked out vn Specifies the revision number of the files to be checked out Examples The following example uses stcmd co to lock and check out doc files from User Manual a child of the root folder StarDraw in the StarDraw view of the StarDraw project stcmd co p JMarsh password Orion 1024 StarDraw StarDraw User Manual I doc The next example uses stcmd co to merge a readme file stemd co p NTesla 10 50 5 179 49201 WebDev WebDev encrypt RCA fp export home0 johnson working merge README Related Reference Client Command line Operations 53 Compare File Revisions stcmd diff Use stcmd diff to display differences between two revisions of a file The command can be applied to more than one file If you do not specify any revisions using vn vd or v1 the working copy of each specified file is compared to the tip revision in the repository or vault for this file If you specify a single revision the working copy of each specified file is compared to that revision If you specify two revisions those two revisions of each specified file are compared When comparing text files the differences can be displays When comparing binary files output results indicate whether the revisions of the file are the same or different Syntax The syntax for this command is as follows stemd ditt p proyectSpecrviver pwdtile MfalePath empi es encrypt encryptionTyp
68. folder is the folder specified with the p option In this command the rp option specifies the working folder for the root folder Use the following options to create the following types of views Use dr to create a read write reference view Use dr ro to create a read only reference view Use dr ba to create a branching view in which the behavior of existing items is set to branch on change Use dr bn to create a branching view in which the behavior of existing items is not set to branch on change Ifyou do not use dr a blank view is created Syntax The syntax for this command is as follows stema add view p projectSpecifier pwdfile filePath cmp encrypt encryptionType qi a sl stoply name nvvewName or pst toldercrabhw AEE Cri peron ide iio bai bn cfgl labelName cfgp stateName cfgd asOfDate Option Description ba When used with dr specifies a branching view in which the behavior of existing items is set to branch on change The value of the view property Set Items Shared Into View To Branch On Change is initially set This option must be used with dr bn When used with dr specifies a branching view in which the behavior of existing items is not set to branch on change The value of the view property Set Items Shared Into View To Branch On Change is initially cleared This option must be used with dr cfgd Configures the view as of the specified date time Exampl
69. 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 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 For example a change request can be marked as fixed The item is not marked as fixed finished or complete unless all the files are successfully added Syntax The syntax for this command is as follows SECC pe OuoVvechopectEren E potile flere thw E enp A es lil enerypits encryptionType ete lea ext step laa Solset Sep Molcer filter eilesraruc e 1 u nel ro rw vl labelName nomove f NCI o i r comment rf fileName Ol teow Forno eee h an maeme tera e equ lta sk alm proces olitemP ats him marak i earliest e g Option Description active The active process item G Complete path
70. from the project view s root folder to the change request requirement or task number to be used ome as a process item Use 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 task 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 process item and the search for the process item begins from the project and view 60l1 Automatically converts end of line markers to carriage return line feeds CR LF as working text files are transferred to the Server s repository When on the working file s current end of line marker is converted to a carriage return line feed CR LF combination When off the default no end of line conversion is performed For Windows clients the end of line marker is CR LF for UNIX platforms it is a line feed LF You would set this option to on for example when you check a working file into the repository from a computer running UNIX and the repository stores text files
71. gardless of the setting for p Wizard will be the parent of Source Spec and Doc StarDraw is the parent of Wizard stcemd add p JMarsh password Orion 1024 StarDraw StarDraw name Wizard d StarDraw setup wizard s fp We NWazard exist A paki Related Reference Client Command line Operations 42 Add Projects stcmd add project Use stcmd add project to add a project to a StarTeam Server configuration from the command line When a project is created its root view and the root folder for the root view are also created In this command the rp option specifies the working folder for that root folder Using is allows you to use the working folder s child folders as the root folder s child folders in the StarTeam folder hierarchy Syntax The syntax for this command is as follows SsucmdmaddSprov icce li owdiike ii kawen icmp Fencer enere only oll eia Ee stop s serverName name projectName rp folderPath d description kw fileMask kwfile fileName ex excludeType exlist fileMask exfile fileName Option Description d Specifies a description for the project Use a maximum of 254 characters ex Indicates the exclude lists to be used by the project s root folder Exclude lists exclude certain files or types of files from visibility If a working file in this folder s working folder would have the status Not In View but it matches a file specification in one of the exclu
72. h does not end with the root folder as in TOINVOELONY T beo p zxz Ep Cr orion mem Also note that UNC network paths require an additional escape character for example beo p xxx fp server path The full syntax is fp folderPath Folder is the Windows term and appears in the user interface Directory is the correct term for the UNIX platform Prevents file statuses from being remembered after the check out occurs Subsequent status values for these files will be incorrect and indeterminate Use this option where a file s status is irrelevant For example if you routinely delete the working folders before checking out files for a build there are no files and their statuses do not matter Be aware that the file statuses may never be known even if you use the update status command later You can do a force check out without the fs option to obtain current files with correct statuses Displays information about the command line options Applies the command recursively to all child folders Without this option the command applies only to the specified folder Outputs SDK NetMonitor information to the console window NetMonitor displays statistics for server commands See the examples for BCO in the next section of this topic Forces the check out of files whose status would normally not allow them to be checked out Those statuses are Modified Merge or Unknown Indicates what view or folder is to be u
73. hd Ate a aa 102 Schange requests na oar a a E RA A EATE EREN A 104 EE EE A T A E A E N 105 ake lo E K EEEE AA EEA A A T NT 107 HOM APET oona E E a cat ces A E EA eee eee ae 109 Ma Stale athe a tg ade th ate ates ede Oaa a A an 110 SPOCESS MOM EE E A A E E mad EE 112 STEQUIFCMENIS S aneen a E cane assent cade a a a te 113 S lt PeEVISION a ES r a eae oid he Nad uaa a r aaa 114 SLASKS EESE E AE E E E e T E A SN 115 SUIMESTAM Pe ee a aaa a a a a E O E EAEE 116 LIOPICS gt aaa a a a tina a A are x aban pets aa a A men a A 117 Command Line Tools This section documents the various Command Line Operation Tools In This Section Reference This section contains all reference topics Reference This section contains reference information In This Section Command line Operations This section contains reference topics related to command line operations Client Command line Operations This section contains reference topics related to client command line operations VCM Command line Utility Explains the View Compare Merge command line utility VCMUtility Command line Operations This section contains reference topics related to command line operations In This Section Bulk Check out Utility Command line Options This topic describes the command line options for the Bulk Check out utility starteamserver Command Parameters Describes and provides examples of the options used with the starteamserver command Check out
74. hen specifies a range of characters to be matched If the first character following the right bracket is an exclamation point or a caret the rest of the characters are not matched Any character not enclosed in the brackets is matched For example x a d y matches xby but not xey x a d y matches xey but not xby A hyphen or right bracket may be matched by including it as the first or last character in the bracketed set To use an asterisk question mark or left bracket in a pattern you must precede it with the escape character which is the backslash filter File status filter Statuses are C Current M Modified 0 Out of Date N Not in View I Missing G Merge and U Unknown For example using CM applies a command only to files with a status of Current or Modified filter takes precedence over f NCI If you use G O or U you must also specify i or o Otherwise the G O Or U is ignored filter also takes precedence over f NCO If you use G M O or U you must also specify merge or o to force the checkout operation Otherwise the G M O or U is ignored fp Overrides the specified StarTeam folder s working folder or working directory This is equivalent to setting an alternate working path for the folder While this option allows you to use a different working folder than the one specified by the StarTeam view its critical importance is to p
75. ich represents a file status Never include spaces or other whitespace in this string Only files that currently have the specified statuses will be reported You cannot review the history of files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown Example The following example uses stcmd hist to display the revision history of the file star h in SourceCode a child of the root folder StarDraw in the StarDraw view of the StarDraw project stemd hist p JMarsh password Orion 1024 StarDraw StarDraw SourceCode star h Related Reference Client Command line Operations 62 List Files stcmd list Usestcmd list to list all files in the folder specified by the p option The files are those that existed at a specific time or that have a specific label Syntax The syntax for this command is as follows stemd list p puoveckspecrever pwdtile trlePath empl est encrypt encryptionType cfgl labelName cfgp stateName cfgd asOfDate as en Si eeoa aiga iteulclerriecnela ager oleecan sesibisese Win ihasiectemie er pesa Option Description 6L Causes the names of the child folders within the folder to be added to the list cfgd Configures the view as of the specified date time Examples include 42 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday Dec
76. ies the path to a file that stores the user s password This option overrides the password used as part of the p option It prevents others from seeing the user s password on the command line The full syntax is pwdfile filePath q Suppresses progress reporting Without this option messages about each action appear on the screen as the action is performed r Reason for check in rf Precedes name of file that contains the reason for the check in rO Sets file as read only after operation rp Specifies or overrides the working folder or working directory for the Star Team view s root folder The stcmd add project command uses this option to specify the working folder for the new view s root folder Other commands use it to override the existing working folder While this option allows you to use a different working folder than the one specified by the StarTeam view its critical importance is to provide cross platform compatibility For example UNIX and Windows systems specify drive and directory path names in incompatible ways While the path D MYPRODUCT DE V ELOPM ENT SOURCI E is understood on a Windows platform it is not understood ona UNIX platform Use this option to define the working path if your platform does not understand the path specified in the StarTeam project The UNIX shell interprets a backslash as an escape character when it precedes certain characte
77. ified the default filter is 10 Missing and Out of date If Merge Merge or Unknown files are included without the o option a warning is generated for each such file and the file is not checked out O Specifies that in addition to Missing and Out of date files files whose status is Modified Merge or Unknown are included Furthermore all files are overwritten without warning If fi1ter is also specified only the specified files are checked out ro Sets each file to read only after check out By default checked out files are read write rp Specifies the root working folder of the merge preview Files are checked out to child working folders relative to lt work folder path gt 102 Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt files gt lt folders gt lt match state gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 103 lt change requests gt lt change requests gt CR CRs lt CR a gt ChangeRequests ALL Specifies all change requests in the view or individual change requests by change request number CRs and ChangeRequests are synonyms the singular form of each is also accepted Related Reference Syntax for VCMUtility Compound Options lt action gt lt check out options gt lt files gt lt folders gt lt match state gt lt pr
78. ility lt options file gt options You can provide options in the specified lt options file gt as the first parameter command line arguments or both Command line arguments override any options found in the lt options file gt Inthe lt options file gt start option names in column 1 and exclude the leading VCMUtility Command Types This section contains the VcMUtility command types The default command type is a new VCM session New Session Command By default each VCMUtility execution begins a new VCM session unless the Help OPEN Replay Resume Delete or Import command is explicitly given Help Command Help lt option gt Displays the vcMUtility Help If you provide an lt option gt help specific to that topic is displayed For example Help MMF would provide help on the ManualMergeFiles option Delete Command Delete lt VCM session file gt Specifies that the session stored in the specific lt VCM session file gt is to be deleted All intermediate files for example merged result files and the session file itself are deleted However if the session was previously saved as an uncommitted change package in the target view the change package object is not deleted Import Command Import lt VCM exchange file gt The Import command is identical to the Resume command except that the lt VCM exchange file gt passed to it must be a VCM exchange file vcmx previously created by an Export command The imp
79. ion If only a SourceView is specified MergeType defaults to Promote If only a Target View is specified MergeType defaults to Rebase If both SourceView and TargetView are specified MergeType must be specified For a Compare session the source and target views can be the same Name Na Name lt Change Package name gt Specifies the name of the change package associated with the VCM session For servers that support change packages a name is automatically chosen when a change package is created by saving or committing the session This option allows a specific name to be used instead of the default name However the name must be unique from all other change package names already saved or committed for the target view otherwise the save or commit action will fail When the Name option is used in conjunction with the Open command the opened change package is renamed to the given value 87 Also see the Save and CommitMerge options PostCommitLabel PostCL PostCommitLabel lt label gt Ifthe VCM session is committed the given view lt 1 abe1 gt is created in the target view after all updates are performed The label reflects the revisions of all target view items used during the compare phase modified by the changes made by the commit phase This means the label contains new items new item revisions and item moves but items deleted by the commit will be detached from the label The post commit label is essentially identical to
80. ion period for an evaluation copy of the Server The first time you start the Server you must register the application as either a licensed version or an evaluation copy If you need a serial number access key 17 combination or an evaluation key to extend your evaluation period contact http www borland com us company how to buy html Example starteamserver eval 01234567890 help Displays a message describing all of the command options Example starteamserver help licenses See also serial access and eval Displays license and registration information If you are running a evaluation copy of the application the system displays a message informing you of this Otherwise the system displays your serial number Example starteamserver licenses list Lists the server configurations defined in the starteam server configs xml file and the status of each one A server configuration can have one of the following statuses at any given point in time Ready Starting Running Disabled and Stopping Example starteamserver list The Server displays a message similar to the following Configuration Status MyServer Ready StarDrawRepository Running Portable Ready name ConfigurationName Use with edit start and restart Renames a server configuration This option is used in conjunction with the edit option The new server configuration name will take effect the next time you start the se
81. iven lt VCM exchange file gt The exchange file name is always suffixed with a vcmx extension A VCM exchange file allows the entire VCM session to be transported to another machine allowing that machine to perform an Import command which resumes the session See the Import command for more information If the lt VCM exchange file gt does not contain path information it is saved in the user s home directory what Java identifies as user home Note The Export option always causes the VCM exchange file to be created even when the session itself is not saved See the Save option for more information FixFloatingChildShares FFCS FixFloatingChildShares True False Specifies whether in Rebase and Replicate merge operations each target view item found that is a floating share of a source view item should be fixed by pinning it When a target view item is a floating child share of a source item which implies that the target item has not branched differences will not be detected between the source and target item during VCM sessions because changes to the source item immediately float to the child item VCM best practices suggest that child shares should always be pinned allowing changes to propagate from the source to target view in acontrolled manner This option allows floating child items found by VCM to be fixed by pinning them to the parent item revision Specifying this option has a performance cost due to the
82. ject and view ag Sets the description of the newly added files to the specified description The description is enclosed in double quotation marks 601 Automatically converts end of line markers to carriage return line feeds CR LF as working text files are transferred to the Server s repository When on the working file s current end of line marker is converted to a CR LF combination When off the default no end of line conversion is performed You would set this option to on for example when you add a working file to the repository from a computer running UNIX if you want the repository to store text files as CR LF l Locks each file after it has been added to the view Without 1 u or ne1 the files are unlocked by default 39 mark nel EG rw i Example Indicates that if all the files are successfully added the process item s status will be changed to fixed for a change request finished for a task or complete for a requirement The files are pinned to the revision with the new status Non exclusively locks each file after it has been added Makes the working file read only after this operation Without this option the file remains as it was prior to the operation Usually you use ro to prevent yourself from editing a file that is not locked by you ro must be used with 1 or u or nel If you use ro you cannot use rw Makes the working file read write after this operation Withou
83. l Betal wal Wieysicey2 Wes oA 55 Related Reference Client Command line Operations 56 Change File Descriptions stcmd dsc Use stcmd dsc to change a file description from the command line This command creates a new file revision with new description as one of its properties Syntax The syntax for this command is as follows SPeMGndsice piprEOvieceopeer item E pAr ke Seiler atht Mi cmpli csfls enemyots encryptionType Ss Sell I Faen aise Molles iger oleeca itaikinese Wstiikasiecieme el descriptrona celles Option Description a Provides a description for the files The description is enclosed in double quotation marks filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other whitespace in this string Only files that currently have the specified statuses will be given the description You cannot change the descriptions of files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown Example The following example uses stcmd dsc to change the description of stdafx cpp in User Manual a child of the root folder StarDraw in the StarDraw view of the StarDraw project stcmd dsc p JMarsh password Orion 1024 StarDraw StarDraw SourceCode d SourceCode for StarTeam stdafx cpp Related Reference Client Comm
84. le quotation marks This option can appear in the command more than once The label can be either a view or revision label but it must already exist in the application The following example uses stcmd 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 49 stcmd ci p JMarsh password Orion 1024 StarDraw StarDraw SourceCode Online Help u ro f revised for beta bmp Related Reference Client Command line Operations 50 Check Out Files stcmd co Use stcmd co to check out files from a StarTeam repository or vault to your working folder using the command line Unless you use o this command pauses at each file with a Modified Merge or Unknown status to let you know that the file will not be checked out With the merge option you can merge files as part of the check out process Merging is not part of the check in process Syntax The syntax for this command is as follows stemd co p project pwdfile filename epwdfile filename cmp encrypt RC4 REZ CECE REZ CBC REZ TCFB esei abel aea rome Tt Onmesicaizeu mle roc Weest ai Si CS lll d sal lk Siem Seo eclerecroryy os iC ce CEOmy eea eea i ea eeel Om T i anere hook executable 2b or Sse e Seal w
85. ls stcmd apply label Use stcmd apply label to label specified file revisions with view or revision labels The labels must already exist in StarTeam You can create the labels in StarTeam or with the stcmd label command Syntax The syntax for this command is as follows stemd apply label p projectSpecifier pwdfile filePath cmp csf enlezype encrcype romtype l i sala ails stop l no i kolkdexPath eo erolderrPath filter fileStatus vl labelName vd asOfDate vn revisionNumber IpI labelName files Option Description filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other whitespace in this string The label is applied only to the files that currently have the specified statuses You cannot apply labels to files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown 1b1 Specifies the label name to be added to the specified revisions This option can be used more than once The application attaches all the labels to the specified file or revisions vd Specifies the as of date time used to identify the revisions that get the new label Examples include 42 29 01 12 41 PM December 29 2001 12 41 21 PM Monday December 29 2001 12 41 Sag Specifies the revision or view label used to identify the revisions tha
86. ls gt RevLabels lt label gt Specifies all the items attached to each specified revision label lt labe1 gt The keyword RevLabels can be singular Revision labels are case insensitive Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt match state gt lt process item gt lt requirements gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 114 lt tasks gt Tasks ALL lt Task gt Includes the specified individual tasks by task number The keyword Tasks can be singular Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt match state gt lt process item gt lt requirements gt lt revision labels gt lt timestamp gt lt topics gt Cheat Sheet 115 lt timestamp gt A lt timestamp gt must have one of the Java recognized formats for date and time strings Date formats are interpreted with the local date formatting conventions for example 3 11 06 is interpreted as March 11 2006 in the United States Seconds are optional for example 1 32 and 1 32 00 are identical The AM P indicator is required The time zone indicator is optional if omitted the local time Zone is assumed The day of week if provided is ignored Examples Osi
87. lt check out options gt lt files gt lt folders gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 109 lt match state gt lt item condition gt Defines a set of conditions that apply to source target item differences A lt match state gt is the union of each lt item condition gt defined for it Each lt item condition gt has the form lt condition name gt lt condition value gt lt condition name gt The valid lt condition names gt and their meaning are lt condition name gt Meaning items binaryfile Indicates whether either of the items in question is a binary file items branched Indicates whether the source and target items are in different branches of the object version tree items samecontent Indicates whether the source and target items have the same user modifiable properties and for files data content source childshare Indicates whether the source item is a child share of the target item source deleted Indicates whether the item in question is deleted in the source view source floating Indicates whether the source item has a floating configuration source modified Indicates whether the item in question is modified in the source view source moved Indicates whether the item in question is moved in the source view source present Indicates whether the item in question is present in the source view s
88. lt timestamp gt 116 lt topics gt 117 abbreviations 75 AutoLogon 80 automatic Rebase 94 AutoMergeFiles 82 AutoMergeProperties 82 Boolean options 75 BreakLocks 82 CaseSensitiveFilenames 82 change package name 87 Cheat Sheet 96 CheckoutPreview 82 command 73 77 command types 77 command line parameters 74 commands 77 CommitMerge 83 connection options 80 DefaultAction 83 DefaultComment 84 Delete command type 77 Encryption 80 examples 94 Exclude 84 exit codes 75 Export 85 FixFloatingChildShares 85 Help command type 77 IgnoreMergePoints 85 Import command type 77 Include 86 input sources 74 LockMergeConflicts 86 ManualMergeFiles 86 Match 87 MergeType 87 miscellaneous options 93 NetMon 93 New Session command type 77 Open command type 78 options file 74 PostCommitLabel 88 PostCommitRevLabel 88 PreCommitLabel 88 PreCommitRevLabel 88 PreventDuplicateFilenames 88 Project 89 promote by view labe 95 promote by view label 94 PWDFile 80 Replay Command type 78 ReportDiffs 89 ReportUpdates 89 Resumed Session Options 92 Resurme command type 79 Save 89 Server 80 session options 82 SourceTime 90 SourceView 90 SourcState 90 SrcLabel 90 Syntax Conventions 73 TargetLabel 91 TargetState 91 TargetTime 91 TargetView 91 Time 93 Unicode option values 74 UseCA 81 81 Verbose 93
89. modify this information using the start or restart and tcpip options from the command line or in the application on the Protocol tab of the StarTeam Server Configuration tab Example starteamserver start MyServer tcpip 49201 starteamserver start MyServer tcpip up u DBUserName Use with new edit start P and restart See also t dsn and p Specifies the user name that the server configuration uses to access the database The value you specify for DBUserName is Stored in the starteam server configs xml file You can review or modify the database user name using the view or edit options from the command line Be sure to also specify the password for this user account Any modifications you make will take effect the next time you start the server configuration Ensure that the user name and password you specify using the starteamserver Command is a valid account in the database The server configuration will fail to start if the user account is missing in the database Example starteamserver edit MyServer u SuperUser p SuperUserPassword version Displays the version and build number for the Server Example starteamserver version The Server displays a message similar to the following StarTeam Server Version x x Build number x x xxx view ConfigurationName Lists the session properties of the specified server configuration Example starteamserver view StarDraw 22 Related Reference C
90. n Options VCMUtility Session Options VCMUtility Miscellaneous Options VCMUtility Examples Cheat Sheet 79 VCMUtility Connection Options This section defines VCMUtility functionality in terms of its connection options AutoLogon AL AutoLogon True False If a lt user gt is not specified in the Server option AutoLogon requests an attempt be made to log on using the userid password for the specified StarTeam server as stored by the StarTeamToolbar Utility Encryption Encrypt T an Encryption NONE RC4 RC2 ECB RC2 CBC RC2 CFB Specifies the encryption level of the server connection The default is NONE However due to SDK behavior if necessary the VCMUtility will automatically upgrade the encryption level to the minimum value required by the StarTeam server PwdFile PF PwdFile lt file name gt Specifies a file that contains the logon password PwdFile overrides the lt password gt if provided in the Server parameter Server S Server lt user gt lt password gt lt host gt lt port gt Specifies the StarTeam server to which the VCM Utility will connect If lt user gt and AutoLogon are not specified the logon lt user gt defaults to Administrator If lt password gt and PwdFile are not specified the VCMUtility prompts for the password Ifa lt user gt or lt password gt contains the characters or or a blank it must be enclosed in single or d
91. n period contact http www borland com us company how to buy html Example starteamserver serial 1234 access 5678 all Use with start stop and restart Used in conjunction with the start or restart or stop options The start a11 options start all server configurations that have a status of Ready in the starteam server configs xml file The stop and all options stop all server configurations that have a status of Running Example starteamserver stop all attach AttachmentsPath Use with start and restart Specifies the attachments path for a server configuration The first time you start a server configuration the system creates an Attachments child folder under the path you specify for RepositoryPath and stores the path to this folder in the database used by the server configuration If you change the location of the Attachments folder you can modify the attachments path in the database using the start or restart and attach options from the command line You can also modify the attachments path on the General tab of the StarTeam Server Configuration dialog The new attachments path will take effect the next time you start the server configuration Example starteamserver start MyServer attach c My Server Attachments 16 autorecover Use with start See also stoponerrors The autorecover option instructs the Server to attempt to make limited repairs where necessary during
92. nd a working file on a UNIX system if the repository stores text files as crlf f NCO Specifies the check out of any file whose status is Missing or Out of Date NCO stands for needs check out No other files are selected for check out f NCO is ignored if filter is used filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other whitespace in this string Only files that currently have the specified statuses will be checked out You cannot check out files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown 51 s hook merge filter takes precedence over f NCO If you use G M O or U you must also specify merge or o to force the check out operation Otherwise the G M O or U is ignored Prevents file statuses from being remembered after the check out occurs Subsequent status values for these files will be incorrect and indeterminate Use this option where a file s status is irrelevant For example if you routinely delete the working folders before checking out files for a build there are no files and their statuses do not matter Be aware that the file statuses may never be known even if you use the update status command later You can do a force check out without the fs option to obtain current files with correct statuses Use
93. ng example uses BCO to force check out all the files from Source Code a child of the root folder StarDraw in the StarDraw view of the StarDraw project bco p JMarsh password Orion 1024 StarDraw StarDraw Source Code is o The next example shows a BCO command that uses the netmon option and the output displayed by Net Monitor bco p Administrator Administrator 10 50 6 91 49201 StarDraw WebSite fp D Test netmon o htm Sample Output tarTeam BulkCheckOut Utility version 9 0 xxx opyright c 2006 Borland Software Corporation All rights reserved tart rev 100 SRVR_CMD GET PROJECT LIST Time 62 millis Sent 42 bytes ot 1834 bytes tart rev 100 SRVR CMD GI Gl U PROJECT VIEWS Time 47 millis Sent 46 bytes tart rev 100 SRVR CMD GI Ey T PROJECT VIEWS Time 15 millis Sent 46 bytes ot 186 bytes tart rev 100 SRVR_CMD PROJECT OPEN Time 188 millis Sent 70 bytes ot 120 bytes S D S G S Got 186 bytes S G S G S tart rev 100 PROJ CMD GET VIEW PROPERTIES Time 31 millis Sent 42 bytes Got 2556 bytes 14 Got Lak Carts Cart carc Carce Carts Lak carc Laks rev 100 1112 bytes rev 100 40 bytes rev 100 414 bytes rev 100 186 bytes rev 100 4797 bytes rev 100 108 bytes rev 100 1767 bytes rev 100 1140 byte
94. ntally remove the condition from the matching criteria without deleting the condition from an options file Note Some conditions are mutually exclusive if defined together they will never match any actual item differences For example a source item cannot be both present source present true and deleted source deleted true Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 111 lt process item gt ProcessItems View lt view gt CR lt CR gt View lt view gt Req lt Req gt View lt view gt Task lt Task gt Specifies a set of process items change requests tasks and or requirements to be included Specifying a process item causes items linked to it in the source view to be included as well The keyword ProcessItems can be singular The full names ChangeRequest and Requirement can be used in place of CR and Req respectively By default a process item specified must reside in the source view However the optional prefix View lt view gt can be used to select a process item in a view other than the source view When a non source view process item is included the process item is not included in the source scope but those items linked to it in the s
95. ntic conventions of UNIX instead of Windows because conventions for UNIX are more specific This means that rather than means all files The pattern means all files with filename extensions For 10 filter fp LolderPath example star finds starteam doc and starteam cpp but not starteam To find all of these you could use star Without this option the default is If you use rather than to indicate all files a UNIX shell expands it into a series of items and passes this series as a group of options to the bco command This can cause problems for example when you are checking out missing files so itis best to use to avoid unwanted complications If you use a set of file patterns each pattern should be enclosed in its own set of quotation marks For example you can use bat c but you cannot use bat sc Note Borland recommends that you enclose this option in quotation marks regardless of platform but for different reasons On Windows platforms file and folder names that contain spaces will not be interpreted correctly On UNIX platforms the shell will expand the option then pass the list of items produced by the expansion to the client Frequently this produces unintended results You can avoid both of these consequences by always enclosing this option in quotation marks Only if it is essential that the option be expanded by the UNIX shell is it advis
96. ocess item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 104 lt files gt File Files ALL lt file name pattern gt depth gt Specifies all files in the view or a set of specific files given as a list of file names and or patterns each with an optional folder lt depth gt The keyword File or Files is optional unless the keyword A11 is used A lt file name pattern gt can be a specific file name for example foo java a file name pattern for example j ava ora file name or pattern with a folder path for example src com acme foo java or src com acme java Usage Folder paths must use forward slashes a single slash is a synonym for the root folder Consistent with other StarTeam utilities the root folder name which typically matches the view name should not be provided in path names Ifa filename or pattern is provided without a folder path the implied folder is the same as the previous lt file name pattern gt parameter If the first lt file name pattern gt parameter does not contain a folder path the root folder is implied If provided the folder lt depth gt specifies the number of child folder levels below the specified folder to include it can be a number or the keyword All Ifa file or pattern name contains spaces it must be enclosed in quotes Examples Below are examples of lt files g
97. odes are 0 for success 1 for failure 101 if at least one of the specified file patterns did not match 102 if none of the specified file patterns matched The stcmd diff command has an additional option e that returns exit codes The e option has three exit codes 0 1 and 2 with meanings that are different from those listed above In addition the 1 might not be returned if you don t also use the x option For Windows platforms You can use ERRORLEVEL in a batch file to perform operations based on the result of a command For example after an stcmd command in a batch file you might use the following IF ERRORLEVEL int statement where int is 0 or 1 For example IF NOT ERRORLEVEL 1 GOTO OPOK ECHO ERROR OCCURRED AT STEP5S gt LOGFILE TXT OROK You can also use the pseudo environment variable ERRORLEVELS For example you might use the following in a shell or at the command line after an st cmd command T A STEPNUMBER 5 SET A THISERROR STEPNUNBER ERRORLEVEL SET A ERRORMASK THISERROR il 3 For UNIX Each shell has its own method of evaluating exit codes For example in the Bourne shell the following statement might come after an stcmd command if return then statement Related Reference Client Command line Operations 38 Add Files stcmd add Use stcmd
98. of line numbers in the two text files Suppresses the display of differences in two text files Comparisons of binary files do not display differences This option is useful with the e option Specifies the number of spaces to use for each tab stop when displaying the file differences for text files The default is four Use t 0 to suppress tab conversion Specifies the as of date time used to identify the revisions to be compared The last revision before the specified date time is the one used See the date time examples for cfgd above Specifies the revision or view label used to identify the revisions to be compared You can specify any combination of zero one or two of the vn vd or v1 options Use zero options to compare the working file to the tip revision one to compare the working file to the specified revision and two to compare two revisions Specifies the revision number to be compared Ignores all whitespace tabs and spaces when comparing two lines in text files For example the following lines would be equivalent a b 2 a b 2 The w Bpvcs and b options are mutually exclusive The following example uses stcmd diff to compare the Beta1 and Beta2 revisions of each of the cpp files in the folder SourceCode a child of the root folder StarDraw in the StarDraw view of the StarDraw project It ignores all white space stcmd diff p JMarsh password Orion 1024 StarDraw StarDraw SourceCode w v
99. ommand line Operations 23 Check out Trace Utility Command Line Operations This topic describes the command line options for the Check out Trace utility In general you can run the utility from the command line with default options as follows CheckoutTraceDump exe go Valid options for Check out Trace are described in the following table Option go path lt path gt outpath lt path gt file lt filespec gt ext lt extension gt start lt start time gt end lt end time gt project lt project name gt projectid lt project ID gt Separator lt separator gt overwrite Description Specify this flag to run with default settings Folder of the binary check out trace cot rc files Defaults to the current folder Folder for the output csv files Defaults to the same folder as the binary trace cot rc files Binary check out trace files to be used as input Supports standard file system wildcard values Defaults to cotrc all check out trace files in the folder You cannot use more than one path with the parameter and you cannot specify this parameter more than once per command The file extension used for check out trace files The extension is appended to the binary check out trace cot rc filename to create the output dump filename Defaults to csv Earliest date time of interest Only checkouts that occurred after this time will be output
100. omment server jsmith mypw somehost 49201 type Rebase include Cygnus StarTeam lt StarTeam Core gt Server Common h ALL CPD x rc Makefile long value continued on a second line The line above was blank save my rebase session value provided on a separate line Command line Parameters VCMUtility options can be passed as command line parameters by placing a dash in front of the option name For example the Server option can be provided as a command line parameter server If an option has secondary value tokens they must immediately follow the option name without a dash Mixing Input Sources VCMUtility options can be provided in an options file with command line parameters or with a mixture of both For example commonly used or static option values can be placed in the configuration file while dynamic values can be provided in command line parameters A command line parameter may specify the same option as defined in the configuration file When a command line argument specifies the same option as in the options file the command line option value overrides the configuration file option value For example if the configuration file specifies Source View1 but the command line specifies Source View2 then View2 is used as the source view Option Values with Unicode Characters The encoding of option values passed as command line arguments is controlled by the launching environment for instance command sh
101. on should not be specified Related Reference Overview of the VCM Command line Utility VCMUtility VCMUtility Commands VCMUtility Session Options VCMUtility Miscellaneous Options VCMUtility Examples Cheat Sheet 81 VCMUtility Session Options This section describes the VCMUtility options that can be used in new sessions Session Options are grouped into two sections New Session Options and Resumed Session Options New Session Options This section contains the VCMUtility session options AutoMergeFiles AMF AutoMergeFiles True False If True requests automatic merging of files found in the compare phase in a merge state When an auto merge is successful the result file is retained as part of the VCM session Otherwise the result file is discarded and the affected files remain in an unresolved merge state AutoMergeFiles is ignored for Compare sessions AutoMergeProperties AMP AutoMergeProperties True False If True requests automatic merging of properties for items found in the compare phase in a merge state If property auto merging is successful the merged item is retained as part of the VCM session Otherwise the merged item is discarded and the items are flagged as being in an unresolved property merge state AutoMergeProperties is ignored for Compare sessions BreakLocks BL BreakLocks True False If True requests that an attempt is made to break any lock found on
102. option However if the server does not support change packages or a server side save is unsuccessful the session is instead saved to a vcms file with a default file name as described above When a commit is successfully performed the Save option is ignored If the server supports change packages the committed session creates a Committed change package using the default or user specified name see the Name option If a vcms file was previously created it is deleted along with all merged result files created by the VCM session Also see the Export option SourceLabel SrcLabel SL SourceLabel lt label gt Requests the source view to be used as of a given view label Label names are case insensitive Only one of SourceLabel SourceState and SourceTime can be specified If none of these options is specified the option SourceTime Now is implicitly used SourceState SrcState SS sourcestate lt state gt Requests the source view to be used as of a given view promotion state Promotion state names are case insensitive Only one of SourceLabel SourceState and SourceTime can be specified If none of these options is specified the option SourceTime Now is implicitly used SourceTime SrcTime ST SourceTime lt timestamp gt Now Requests the source view to be used as of a given timestamp The keyword Now causes a snapshot of the current time to be used as configuration timestamp Only one of SourceLabel SourceState
103. or Current M for Modified G for Merge o for Out of Date I for Missing and U for Unknown Example The following example uses stcmd delete local to delete some files from the working folder for the StarTeam folder named SourceCode SourceCode is a child of the root folder StarDraw in the StarDraw view of the StarDraw project This example deletes all files that are not under version control Those files have the file status Not In View stcmd delete local p JMarsh password Orion 1024 StarDraw StarDraw SourceCode filter Ni we Related Reference Client Command line Operations 61 Display File History stcmd hist Use stcmd hist to display the revision history of files Syntax The syntax for this command is as follows stcemd hist p projectSpecifier pwdfile filePath cmp csf encrypt encryptionType cfgl labelName cfgp stateName cfgd asOfDate e Sel se ascos eign it ilkclerieeraa z Volele poitiiliceim Wie Seere Enesi Option Description cfgd Configures the view as of the specified date time Examples include 12 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday December 29 2001 10 52 00 AM PST cigt Configures the view using the specified label Without cfg1 cfgp or cfgd the view s current configuration is used cfgp Configures the view using the specified promotion state filter Specifies a string of one or more characters each of wh
104. orted VCM session is resumed where it left off The compare phase is performed if it has not yet successfully completed Manual merging is performed if ManualMergeFiles is specified and existing file merge conflicts exist The target view merge preview is checked out if CheckoutPreview is specified and commit has not yet been performed 77 The differences report is generated if ReportDiffs is specified and commit has not yet been performed The commit phase is performed if CommitMerge is True and commit has not yet been performed The update report is generated if ReportUpdates is specified and commit has been performed Export and Import can be used together to transport a VCM session from one workstation to another For example one user could create a new VCM session resolve all conflicts then Export the session The resulting archive file could then be transferred to a test machine where the Import command can be used with the Checkout Preview option with CommitMerge set to False to check out build and test the target merge preview If tests succeed the test machine could then execute a Resume command and set CommitMerge to True Note Sessions resumed by way of the Resume or Import command are automatically saved if they are not committed If the Save option is specified the session is saved in the specified lt VCM session file gt Otherwise the VCM session file specified by a Resume command is used
105. ot exist the system will create the appropriate folders the first time you start this server configuration The value you specify for RepositoryPath is stored in the starteam serverconfigs xml file You can review the repository path using the view option from the command line or in the application on the General tab of the StarTeam Server Configuration tool in the Server Administration Tool 19 Warning Do not use the Server home folder directory as a server configuration repository path because the server configuration will not start Example starteamserver new NewServerl r c new server t 1 dsn NewServerDSN u Admin p password remove ConfigurationName Deletes the specified server configuration from the starteam server configs xml file Example Stamecamsenver remove Mysenvier restart ConfigurationName Stops and restarts the specified server configuration Use this option after you make changes to a server configuration and want those changes to take effect If the server configuration fails to restart check the server log file for more information You can restart a server configuration and modify a number of its options at the same time The following options can be used with the restart option all attach dsn name p tcpip and u You cannot use both the a11 and the specific configuration name at the same time Example starteamserver restart MyServer tcpip StarTeamTCPIP u Supe
106. ote or Replicate IfMergeType is not specified the DefaultAction applies to the current VCM session Specifying a DefaultAction with a different lt merge type gt than that of the current session allows rules used by different VCM sessions to be specified in a single options file If temType is specified the DefaultAction applies only to items of the specified lt item type gt CRs Files Folders Requirements Tasks or Topics By default a DefaultAction applies to items of all types The lt match state gt determines the conditions that must be met by the source and or target items during comparison A lt match state gt consists of one or more source target lt item condition gt definitions each of which has a lt condition name gt for example source moved and a lt condition value gt True False or Unspecified The lt condition value gt is optional and defaults to True A lt match state gt is the union of all the conditions defined for it 83 The lt action gt determines how to handle source target item pairs whose differences match the lt match state gt The lt action gt merely defines the default action for matching items the actual action can be changed after compare in the StarTeam Cross Platform Client Some example DefaultAction definitions are shown below When a source item has moved but the target item has not ignore the move DefaultAction source moved target moved false Ignor
107. ouble quotes lfa lt user gt or lt password gt is quoted it can contain an embedded quote of the same type by escaping preceding it with a backslash Ifa quoted lt user gt or lt password gt contains an embedded backslash it must be escaped with another backslash For example a double backslash within a quoted token is interpreted as a single backslash The server lt host gt can bea hostname or IP address The lt host gt is required if the Server option is specified If the Server option is not specified the lt host gt defaults to localhost If not specified the lt port gt defaults to 49201 80 UseCA UCA UseCA lt host gt lt port gt AutoLocate Specifies that file check outs should attempt to use an MPX Cache Agent The Cache Agent can be explicitly provided with a host name or address lt host gt and port number lt port gt or the network nearest Cache Agent can be automatically located AutoLocate UseServerProfile USP UseServerProfile True False If true specifies that the lt host gt name specified in the Server option should be interpreted as a server profile name Server profiles are stored in the user s starteam servers xml file A server profile specifies a StarTeam server host name port number encryption level and compression setting Consequently when UseServerProfile is specified the Server option must be specified but should not contain a port number and the Encryption opti
108. ource rootbranch Indicates whether the source item is the root branch of its share tree target childshare Indicates whether the target item is a child share of the source item target deleted Indicates whether the item is question is deleted in the target view target floating Indicates whether the target item has a floating configuration target modified Indicates whether the item in question is modified in the target view target moved Indicates whether the item in question is moved in the target view target parentdeleted Indicates whether the target item s folder has been deleted target present Indicates whether the item in question is present in the target view target rootbranch Indicates whether the target item is the root branch of its share tree lt condition value gt The valid lt condition value gt s are lt condition value gt Meaning True The condition is true for the applicable item s False The condition is false for the applicable item s Unspecified The condition is unknown or not relevant for the applicable item s 110 The lt condition value gt is optional and defaults to True For any given lt match state gt all unspecified conditions are initially Unspecified An lt item condition gt can be defined as True or False to cause the corresponding condition to participate in matching the condition to actual item differences Acondition can be defined as Unspecified for example to experime
109. ource view are included The specific revision of each source view item linked to the process item is included Examples Include CR 451 in the source view and its linked items include ProcessItem CR 451 Include the items in the source view that are linked to Task 909 inclulde Requirement 518 both from view Triage include ProcessItem View Triage Task 909 View Triage Requirement 518 Note Ifthe view name contains spaces it must be quoted Release 4 3 If more than one view in the project has the same view name the view name can be a slash separated view path Apps Releases Releas 4 3 Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt match state gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 112 lt requirements gt Reqs Requirements ALL lt Req gt Specifies individual requirements by requirement number Reqs and Requirements are synonyms the singular form of each is also accepted Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt files gt lt folders gt lt match state gt lt process item gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 113 lt revision labe
110. ourceLabel SrcLabel or SL In most cases a syntactic item spelled with mixed case in this document can be abbreviated to its capitals only short form For example ManualMergeFiles can be MMF or AuttoMergeProperties can be AMP and so on Exit Codes The VCM utility will return the following exit codes to indicate the results of its execution Exit Code Description 0 No errors occurred 1 A fatal error occurred 2 Partial success This result is returned when the compare phase was performed but the commit could not be performed due to unresolvable conflicts VCMUtility Log Files During its execution the vCMUtility writes informational warning and error messages to the console window standard out For most operations the VcMUtility also creates a log file that summarizes its operation As with console window output the log file is more detailed when the Verbose option is enabled The log file is created for new VCM sessions and for the Import Open Replay and Resume commands However the log file is not started 75 unless command line parameters and the options file if used have been parsed without errors A log file is not created for the Help or Delete commands The VCMUtility log file is created in the user s home directory what Java identifies as user home with the following file name VEMUE lane YYYY MM DDIRN mm ssr Log YYYY MM DD and hh mm ss are the current date and time in the local time zone Th
111. pound Options The following compound syntax items are used in the VCMUtility options In This Section lt action gt Describes the syntax for the compound VCMUtility option lt action gt lt check out options gt Describes the syntax for the compound VCMUtility option lt check out options gt lt change requests gt Describes the syntax for compound VCMUtility option lt change requests gt lt files gt Describes the syntax for compound VCMUtility option lt files gt lt folders gt Describes the syntax for the compound VCMUtility option lt folders gt lt item type gt Describes the syntax for the compound VCMUtility option lt match state gt lt match state gt Describes the syntax for the compound VCMUtility option lt match state gt lt process item gt Describes the syntax for the compound VCMUtility option lt process item gt lt requirements gt Describes the syntax for the compound VCMUtility option lt requirements gt lt revision labels gt Describes the syntax for the compound VCMUtility option lt revision label gt lt tasks gt Describes the syntax for the compound VCMUtility option lt tasks gt lt timestamp gt Describes the syntax for the compound VCMUtility option lt timestamp gt lt topics gt Describes the syntax for the compound VCMUtility option lt topics gt 100 lt action gt Specifies the action to perform for a given source target item
112. quotation marks For example exe dll p z doc t t test 41 If you are using double quotation marks in your exclude list or have a lengthy exclude list we recommend that you use the exfile option With ex1list each quotation mark in the exclude list needs to be preceded by the escape character for your system or shell For example the caret works on NT systems With exfile you do not need to use escape characters name Specifies a name for the folder Use a maximum of 254 characters In a file if the exclude list contains double quotation marks the escape character is unnecessary Example The following example uses stcmd add folder to create a folder named Wizard as a child of the StarDraw folder the root folder of the StarDraw project view In addition it sets a local exclude list for Wizard By default Wizard inherits its parent folder s exclude lists and use the local one as well stcmd add folder p JMarsh password Orion 1024 StarDraw StarDraw name Wizard d StarDraw setup wizard exlist bak The next example creates the same folder as in the previous example However it includes child folders In this case the folder with the path C Wizard has child folders Source Spec and Doc all of which are added as StarTeam folders in addition to Wizard All of the new folders Wizard Source Spec and Doc will have the default working folders assigned to them automatically by the StarTeam server re
113. r example when you are checking out missing files so it is best to use to avoid unwanted complications If you use a set of file patterns each pattern should be enclosed in its own set of quotation marks For example you can use bat c but you cannot use bat c Note We recommend that you enclose this option in quotation marks regardless of platform but for different reasons On Windows platforms file and folder names that contain spaces will not be interpreted correctly unless you use quotation marks On UNIX platforms if you do not use quotation marks the shell will expand the option then pass the list of items produced by the expansion to the client Frequently this produces unintended results You can avoid both of these consequences by enclosing the option in quotation marks Only if it is essential that the option be expanded by the UNIX shell is it advisable to omit the quotation marks Mysterious failures of batch scripts on either platform may be due to this omission Several special characters can be used in the file specification 31 Matches any string including the empty string For example matches any file name with or without an extension xyz will match xyz and xyz cpp and xyzutyfj Matches any single character For example a c will match abc but NOT ac Pees Matches any one of the characters enclosed by the left and right brackets A pair of characters separated by a hyp
114. rUser p SuperUserPassword serial Number See also access license and eval Registers the Server as a licensed version Use this option with the access option The first time you start the Server you must register the application as either a licensed version or an evaluation copy If you need a serial number access key combination or an evaluation key to extend your evaluation period contact http www borland com us company how to buy html The serial and access numbers in the example below would be replaced with actual serial and access numbers Example starteamserver serial 1234567890 access 9999999 start ConfigurationName See also a11 and stop Starts the specified server configuration starteamserver updates the server configuration entry in the starteam server configs xml file to Status Running and PID nnn where nnn would be replaced with the actual PID number 20 You can start a server configuration and modify a number of its options at the same time The following options can be used with the start option attach dsn name p tcpip and u Example starteamserver start MyServer tcpip StarTeamTCPIP u SuperUser p SuperUserPassword stop ConfigurationName See also a11 and start Shuts down the specified server configuration After the server configuration stops running starteamserver updates the entry in the starteam server configs xml file to Status Ready and PID 0 E
115. ration gt is in use Path name of the stray file folder where extraneous files found by the stray check are moved when repair is specified The default stray file folder is C Temp VVStrayFiles Displays elapsed time information when the verification finishes If repair is specified this option enables attempts to recover missing files from the specified MPX Cache Agent The lt host gt and lt port gt must designate a remote Cache Agent because it maintains an independent cache Displays additional status information as the verification proceeds Specifies the configuration name The configuration name passed to Vault Verify is case sensitive and if it includes spaces you must pass the configuration name to Vault Verify in quotation marks 26 Client Command line Operations This section contains reference topics related to client command line operations In This Section Common Options Describes the options that show up in all or almost all commands Special Characters Describes the special characters that you can use to search for files Exit Codes Describes the exit codes returned by the stemd commands Add Files stemd add Describes the command to add files to a project Add Folders stcmd add folder Describes the command to add StarTeam folders to a view Add Projects stemd add project Describes the command to add a project to a StarTeam Server configuration Add Views stcmd add
116. rget view is the parent of the source view a Promote session is performed Otherwise a Replicate session is performed Alternatively you can specify a MergeType of Promote in which case the target view is not needed A replay VCM session attempts to make the same changes in the new target view that were made in the specified change package This means that the source scope of the new VCM session is automatically chosen Consequently the Include and Exclude options are not allowed In a replay session some changes made in the original change package might not be possible in the new target view such as when a new version is already present Some changes may need to be applied in a different way for example Move and Merge instead of Merge and new conflicts could appear Such as Merge instead of Repin The replay session can be committed only if no unresolved conflicts occur 78 Resume Command Resume lt VCM session file gt Specifies that the session saved in the given lt VCM session file gt is to be resumed instead of creating a new session This is typically used to perform the commit phase of a previous session for which only the compare phase was performed A session that has already been committed can also be resumed but only to generate a difference report For more information see the Export option and the Import command Related Reference Overview of the VCM Command line Utility VCMUtility VCMUtility Connectio
117. rovide cross platform compatibility For example UNIX and Windows systems specify drive and directory path names in incompatible ways While the path D MY PRODUCT DEVELOPMENT SOURCE is understood on a Windows platform it is not understood on a UNIX platform Use this option to define the working path if your platform does not understand the path specified in the StarTeam project A backslash is interpreted as an escape character when it precedes quotation marks As a result an error occurs in the following example secmd went p Weel Fp Wie i West which is interpreted as scema teak jor Wreoel E p Wen a To avoid a situation like this escape the final character in C as follows 32 icicle wa je Wesel ago Wee West Or avoid it as follows when the rp path doesn t end with the root folder as in C orion sirene eal o Sorsi ig WEIN Oien We The full syntax is rp folderName Folder is the Windows term and appears in the StarTeam user interface Directory is the correct term for the UNIX platform h Invokes help help works with each command although not shown in the syntax help Invokes help help works with each command although not shown in the syntax Prompts user to confirm check in when file status is Merge Out of Date or Unknown S Applies the command to all child folders Without this option the command applies only to the specified folder When this option is us
118. rs such as quotation marks As a result an error occurs in the following example secmd went Sj Vereen ago Weg yy eeu which is interpreted as 35 ggal wal jo Weed cis Woe ey To avoid a situation like this escape the final character in c as follows stemd at P Vee Sige Weg ye Week Or avoid it as follows when the rp path doesn t end with the root folder as in C orion scene Ci p Wast sia Meg yoron Wet The full syntax is rp folderName Folder is the Windows term and appears in the StarTeam user interface Directory is the correct term for the UNIX platform rW Sets file as read write after operation stop Often used with x Halts execution of the command line when the first error is encountered Without this option execution continues despite errors uU Unlocks a file V Version label X Switches between interactive and batch modes Without this option you must confirm error messages interactively and the exit codes may not be available With this option no error messages are displayed but exit codes are set The exit codes are 0 for success and 1 for failure Related Concepts Special Characters Related Reference Client Command line Operations 36 Special Characters Matches any string including an empty string For example x z will match xyz and xz Matches any single character For example a c will match abc but NOT ac Matches any
119. rver configuration Example 18 starteamserver edit MyServer name NewTeamServer new ConfigurationName Creates a hive named DefaultHive for the new server configuration with the specified name and settings This configuration uses a Native II vault This option produces the same result as selecting New on the Server Administration Tool menu and using the wizard to create a new configuration A number of options can only be specified with new These are c r and t Example starteamserver new NewServerl r c new server t 1 dsn NewServerDSN u Admin p password p DBUserPassword Use with new edit start and restart See also dsn p t and u Specifies the password used to access the database The value you specify for DBUserPassword is stored in the starteam server configs xml file Ensure that the password you specify is the correct one for the database user name You can review or modify the password and user name using the view and edit options from the command line Any modifications you make will take effect the next time you start the server configuration Example starteamserver edit MyServer u JodyK p password q Executes a command in quiet mode that is the system displays no screen output Example starteamserver stop alll g r RepositoryPath Use with new Specifies the repository path for a new server configuration If the repository path you specify does n
120. s rev 100 16 bytes t rev 100 16 bytes PROJ PROJ PROJ n FILE FILE FILE SRVR SRVR RVR_CM PROJ_CM DERS Time GET FO GET FO DER ITEMS Time 63 millis FRESH IT C I GI ic I L ECKOU Q ECKOU KOU PROJECT PROJECT VI T Time T Time T Time EMS Time EWS Time 3562 millis PROJECT PROPERTI ES Time CLOSE T Time REL EFASE 15 47 millis 31 millis 31 millis ENT Time 15 millis sent 16 millis 16 millis sent sent sent 31 millis 42 Sent 31 millis sent sent bytes 50 bytes 122 bytes 46 bytes Sent 42 bytes 78 bytes 78 bytes 78 by Sent Sent CES 62 bytes 42 bytes starteamserver Command Parameters This section describes the options for the starteamserver command in alphabetical order with examples of their uses access Key Use with serial See also serial license and eval Registers the Server as a licensed version Use this option with the serial option The first time you start the Server you must register the application as either a licensed version or an evaluation copy If you need a serial number access key combination or an evaluation key to extend your evaluatio
121. s are transferred from the Server s repository to the working folder on the workstation with the end of line convention for the platform executing the command as determined by the Java VM When you do not specify this option the default BCO does not perform end of line conversion Using the default is the same as not using eo1 at all When you specify the end of line character cr 1 or cr1 BCO transfers text files from the Server s repository to the working folder on the workstation with the specified end of line convention For Windows platforms the end of line marker is a carriage return line feed cr1 combination for UNIX platforms it is a line feed 1f You would set this option if for example when you compare a file from the repository and a working file on a UNIX system if the repository stores text files as crlf Excludes files whose name or parent folder matches a given pattern A pattern can be an exact file or folder name or it contain wildcard characters e g class To specify a folder name precede the pattern name with a forward slash e g bin A single pattern can be provided with each exclude which can be repeated Alternatively one or more patterns can be specified on separate lines of the given lt pattern file gt prefixed with Specifies the files to be used in the command by name or by filename pattern specification such as c All options are interpreted using the sema
122. s means that items to be added for example shared to the target view will not be attached but items to be deleted will be attached PreCommitRevLabel is ignored for Compare sessions By default a pre commit revision label is not created PreventDuplicateFilenames PDF 88 PreventDuplicateFilenames True False If True it specifies that sharing a new file to the target view is not allowed if it results in two identically named files to exist in the same folder Project PEG Project lt project gt Specifies the project to be used in the VCM session This option is required The source and target views must belong to the same lt project gt Project names are case insensitive ReportDiffs RD ReportDiffs True False If True causes a report to be generated listing item differences found in the compare phase The difference report is generated in the user s home directory what Java identifies as user home with the following title VCMDiffReport YYYY MM DD hh mm ss html where YYYY MM DD and hh mm ss are the current date and time in the local time zone ReportUpdates RU ReportUpdates True False If True causes a report to be generated listing all changes made to the target view in the commit phase The update report is generated in the user s home directory what Java identifies as user home with the following title VCMUpdateReport YYYY MM DD hh mm ss html where YYYY MM DD and hh mm ss are the current
123. sed as well as providing the user name and password needed to access the server The full syntax is p userName password hostName portNumber projectName viewName folderHierarchy For example p JMarsh password orion 49201 StarDraw StarDraw SourceCode If the user name is omitted the current user name is used The user name in the example is JMarsh 12 pwdfile SEG If the password is omitted the user is prompted to enter the password When the user types a password the characters are not displayed on the screen The password in the example is password If the host name is omitted the default is Localhost The host name in the example is orion The port number is required The default port number 49201 is used in the example The project name is always required The project name in the example is StarDraw Use a view hierarchy to identify the view Use the colon as a delimiter between view names The view hierarchy should always include the root view For example StarDraw Release 4 Service Packs indicates that the view to be used is the Service Packs view which is a child of the Release 4 view and a grandchild of the StarDraw root view If the view name is omitted the root default view is used If the view is the only view in that project with that name you can use only the view name This is not recommended because another view with that name could be created at a later d
124. sively locks the files PO Makes the working file read only after this operation Without this option the file remains as it was prior to the operation Usually you use ro to prevent yourself from editing a file that is not locked by you ro must be used with 1 or u or ne1 If you use ro you cannot use rw Ew Makes the working file read write after this operation Without this option the file remains as it was prior to the operation rw must be used with 1 or u or nel If you use rw you cannot use ro u Unlocks the files Syntax The syntax for this command is as follows stemd lek p projectSpectirer pwdtile fillePath i enol IF esf F encrcypte encryperonbype l ik asaan seo Rep urode rpa Eh Ep AORE nRa EN filter fileStatus break 1 u nel ro rw files Example The following example usesstcmd 1ck to unlock all files in SourceCode a child of the root folder StarDraw in the StarDraw view of the StarDraw project as well as all files in child folders of SourceCode secmda lck p JMarsh password Orion 1024 StarDraw StarDraw SourceCode is u Related Reference Client Command line Operations 65 Lock and Unlock Server stcmd server mode If you have appropriate access rights or privileges you can use stcmd server mode to lock and unlock a server configuration Locking a server configuration limits access to it while you perform backup or other procedures When the serv
125. ssword Orion 1024 StarDraw StarDraw SourceCode is 63 The short provides a short simple listing of local files and their statuses consisting of the abbreviation for the status and the relative path to the working file for example M starteam Server java N starteam LabeliInfo java Without the short option the listing consists of a line for each folder name followed by its working folder s path Within a folder the listing contains a line for each file starting with the unabbreviated status and containing the rights time stamp and name of the file For example Folder Source working dir E Source Unknown rw 4 6 02 7 42 18 PM PST 230 req bmp Related Reference Client Command line Operations 64 Lock and Unlock Files stcmd Ick Use stcmd 1ck to lock or unlock files from the command line Option Description break Breaks the current lock by another user if you have the access rights to break locks filter Specifies a string of one or more characters each of which represents a file status Never include spaces or other white space in this string Only files that currently have the specified statuses will be locked or unlocked You cannot lock or unlock files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date for Missing and U for Unknown aL Locks the files This is the default when 1 ne1 or u is not used nel Non exclu
126. t lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 101 lt check out options gt The following section describes the syntax used for the compound VCMUtility option lt check out options gt tcwf teol on off cr 1f crlf filter CGIMOU o tro trp lt work folder path gt Specifies non default check out options The available check out options are similar to those provided by the StarTeam command line stemd and bulk check out BCO utilities except that option names must be prefixed with a sign The available options are detailed below cwf Requests the creation of working folders for all specified folders even if they do not have files to be checked out by this run Only visible folders are created eol lt eol option gt Requests conversion of all end of line delimiters for text files to the specified format An lt eol option gt of on uses the client configured EOL format off prevents any EOL conversion cr 1f and crlf cause each EOL to be converted to a carriage return line feed or carriage return line feed pair respectively Note that text files with a fixed EOL format are always converted to the specified format filter filter CGIMOU Specifies the status of files to consider for check out Current merGe missing Modified Out of date or Unknown Multiple status flags can be combined If filter is not spec
127. t usage aie tales ain the view include Files ALL foo java and bar java in folder src com acme include src com acme foo java bar java all java files in folder src com acme and below include src com acme java tall ail Pex files in the cook folder all saip file any first leys child folders and a specific readme txt file include txt zip l docs acme readme txt 105 Related Reference Syntax for VCMUtility Compound Options lt action gt lt change requests gt lt check out options gt lt folders gt lt match state gt lt process item gt lt requirements gt lt revision labels gt lt tasks gt lt timestamp gt lt topics gt Cheat Sheet 106 lt folders gt Folder Folders ALL lt folder path gt lt depth gt lt item type gt Specifies all folders in the view or specific folder paths optionally indicating a folder depth and specific item types The keyword Folder or Folders is optional unless the keyword ALL is used Usage Avalid lt folder path gt must begin and end with a forward slash src com If provided the lt depth gt specifies the number of child folder levels below the specified folder to include it can be a number or the keyword A11 Ifa folder path contains spaces it must be inclosed in quotes lIfno lt item type gt parameters are provided only files are included in the specified folder s Otherwise all items of
128. t get the new label This label must already exist in the application Without the vn or vd or v1 option the tip revision of each file receives the label vn Specifies the revision number used to identify the revisions that get the new label Examples The following example uses stcmd apply label to apply the label Beta to files in User Manual a child of the root folder StarDraw in the StarDraw view of the StarDraw project StarTeam applies the label to the revisions of those files that were current at noon on July 7 2003 stcmd apply label p JMarsh password Orion 1024 StarDraw StarDraw User Manual vd HOUT POTMOS LZ 200 Iw ilioik Wists West Related Reference Client Command line Operations 47 Check In Files stcmd ci Use stcmd 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
129. t someone else has just checked in a copy of it so the status of your file is actually is Out Of Date Updating file statuses is not the same as updating files If a file is not in your working folder updating the status lets you know that the file s status is Missing but will not check out the file for you Normally you update file status to determine whether a file should be checked in checked out added or ignored For example you may want to Check in a file if its status is Out Of Date Missing or Merge Check out a file if its status is Modified or Merge Add a file to the application if its status is Not In View However the update status command never lists files that have the status Not In View because they are not stored in the repository Use stcmd update status to display the filename its status before the command and its status after the command A sample line of output might be x cpp status is Current was Unknown Syntax The syntax for this command is as follows stcmd update status p projectSpecifier pwdfile filePath cmp csf F encrypt encrype romtype l si ql i lt l stop np koldexPacrh ao eolderPath cfgl labelName cfgp stateName cfgd asOfDate filter fileStatus eol Rar I eors SNe Peskin 5 4 Option Description cigd Configures the view as of the specified date time Examples include 42 29 01 10 52 AM December 29 2001 10 52 00 AM PST Monday
130. t this option the file remains as it was prior to the operation rw must be used with 1 or u or ne1 If you use rw you cannot use ro Leaves the newly added files unlocked Specifies a label to be applied to the new files The label is enclosed in double quotation marks This option can appear in the command more than once The label can be either a view or revision label but it must already exist in the application The following example uses stcmd add to add all doc files with the status Not In View to User Manual a child of the root folder StarDraw in the StarDraw view of the StarDraw project It locks the files and gives them the description First draft of chapter stcmd add p JMarsh password Orion 1024 StarDraw StarDraw User Manual l d First draft OEP chapeer ses dOS i Related Reference Client Command line Operations 40 Add Folders stcmd add folder Use stcmd add folder to add StarTeam folders to a view from the command line You can add the folder to the root folder or any other folder in that view The working folder for your new StarTeam folder is created by default within StarTeam not on your workstation The working folder has the same name as the StarTeam folder It is a child folder of the working folder for the StarTeam folder s parent For example suppose you create a StarTeam folder named Wizard Wizard is a child of a StarTeam folder whose working folder is C StarDraw Therefore Wizard
131. ter When typing options in the command line each lt option gt must be preceded with a lt session option gt Options The table below lists all the vVcMUtility command line options and their syntax Command Option lt option gt lt command gt lt connection option gt lt command gt tHe oa Has er eea costes Delete lt VCM session file gt import lt VEM archive eiiie Open lt Change Package name gt Replay lt Change Package name gt Resume lt VCM session file gt lt connection option gt lt option gt lt miscellaneous option gt AutoLogon AL True False tEnerypEron Enemy pe Emp Nones REA REATh CE PREZ TERE PREZ CEE PwdFile PF lt file name gt Server S lt user gt lt password gt lt host gt lt port gt UseCA UCA lt host gt lt port gt AutoLocate UseServerProfile USP True False lt session option gt AutoMergeFiles AMF True False AutoMergeProperties AMP True False BreakLocks BL True False CaseSensitiveFilenames CSF True False CheckoutPreview check out CP faes lt check oursopotvons gt E CommitMerge Commit CM True False DefaultAction DA MergeType lt merge type gt ItemType lt item type gt Salil om gt i DefaultComment DC lt comment gt Description lt description gt Exclude BEC lt folders gt
132. the pre merge view PostCommitLabel is ignored for Compare sessions By default a post commit view label is created with a default name To disable the post commit view label specify PostCommitLabe1 with a blank value that is PostCommitRevLabel PostRL PostCommitRevLabel lt label gt If the VCM session is committed the given revision lt labe1 gt is created in the target view and all items modified by the VCM session except for deleted items are attached to it Consequently the label contains items that were added moved re pinned or updated in any other way except for deletion by the VCM session PostCommitRevLabel is ignored for Compare sessions By default a post commit revision label is not created PreCommitLabel PreCL PreCommitLabel lt label gt The given view lt labe1 gt is created in the target view reflecting the snapshot used in the compare phase The label reflects the revisions of all target items used during the compare phase PreCommitLabel is ignored for Compare sessions By default a pre comimt view label is not created PreCommitRevLabel PreRL PreCommitRevLabel lt label gt If the VCM session is committed the given revision lt 1 abe1 gt is created in the target view and all non ignored target view items are attached to it in their before state That is target view items to be modified by the session are attached to the revision label before they are modified Thi
133. the VCM session is committed after the check out is performed Example CheckoutPreview src com acme java cwf eol LF filter CGMIOU o ro TEPC BUT Nel Dalia CommitMerge Commit CM CommitMerge True False Specifies whether or not the results of VCM session should be committed False specifies that a commit will not be performed This option can be used to produce a compare report only session True specifies that the commit should occur only if there are no unresolved conflicts CommitMerge is ignored for Compare sessions DefaultAction DA DefaultAction MergeType lt merge type gt ItemType lt item type gt lt match state gt lt action gt Specifies a default lt action gt for items that are compared and meet the conditions specified in the given lt match state gt The VCM utility uses a rules based decision table to determine what action if any should be taken when it finds item differences between the source and target views The DefaultAction option allows the default rules to be overridden This option can be specified multiple times to change the default action for multiple differences However the order of definition is important if two overrides are both applicable to an item difference found in the compare phase the last override specified takes precedence over the prior one IfMergeType is specified the DefaultAction only applies to VCM sessions of the specified lt merge type gt Rebase Prom
134. the command to return the following exit codes 0 if all the compared files are equivalent 1 if an error condition occurs 2 if at least one file is different 54 eol filter vd v y Example Use e with either text or binary files This command is irrelevant at this point in time because diff currently ignores end of line markers If two lines are the same except for this they are reported to be identical Specifies a string of one or more characters each of which represents a file status Never include spaces or other white space in this string Only files that currently have the specified statuses will be compared You cannot compare revisions of files that are Not In View The letters used to represent the statuses are C for Current M for Modified G for Merge O for Out of Date I for Missing and U for Unknown Ignores the case of letters when comparing two text files For example A is equivalent to a When comparing two text files ignores the characters in certain columns as specified by one or more masks Each mask has the following syntax columnNumber columnNumber numeric For example 1 6 ignores the characters in the first six columns of each line and 1 6 numeric ignores the first six columns of each line if the character in column 1 is a digit in both files You can use a series of masks but they must be separated by commas The syntax is maski mask ss Suppresses the display
135. tility is a command line utility that compares a StarTeam source view to a target view and optionally merges the differences into the target view The VCMUtility documentation includes the following Commands Connection Options Session Options gt gt gt Miscellaneous Options not saved in sessions Note You can start a View Compare Merge session from the command line and finish it in the StarTeam Cross Platform Client in the View Compare Merge UI For example you can use the vcMUtility to create a VCM session perhaps using its DefaultAction option but do not let it commit It will automatically save the VCM session with any alternate name you choose if needed You can then open that VCM session in the StarTeam Cross Platform Client review and make adjustments then commit the changes to the repository Syntax Conventions The syntax for the command line uses the following conventions Convention Description Curly braces Encloses required syntax elements Square brackets Encloses optional elements Angle brackets lt gt Encloses a word or phrase that must be replaced with an appropriate value or set of values For example lt file name gt would be replaced by an actual filename or path and lt userid gt would be replaced by an actual user ID However many of the words or phrases in angle brackets can be expanded into more complicated syntax For example lt change requests gt can be replaced by CR CRs
136. ts The table below lists other syntax elements in alphabetical order Other Syntax Elements ACEON Delet DeleteAndReverseShar nenii i Tene Merge Move MoveAndMerg MoveAndRepin NeedsReview Overwrit Repin RepinAndMove ReverseShare Share lt change requests gt CR CRs ChangeRequests ALL lt CR gt lt Change Package name gt A name consisting of one or more characters lt check out options gt rewal reol emt jie er dae preibtrsr ACEO axe Frol trp lt work folder path gt lt condition name gt items binaryfile items branched items samecontent source childshare source deleted source floating source modified source moved source present source rootbranch target childshare target deleted target floating target modified target moved target present target parentdeleted target rootbranch 97 lt condition value gt True False Unspecified lt files gt File Files ALL lt file name pattern gt lt depth gt lt folder path gt A slash followed by an optional series of folder names each nding with a slash lt folders gt Folder Fol ders ALL lt folder path gt lt depth gt lt item type gt lt item condition gt lt condition name gt lt condition value gt lt item type gt ChangeRequest CR File Files Folder Fol
137. ty of filenames in the folders For example with cs StarTeam folders named doc and Doc are recognized as different folders Without this option either folder could be recognized as the doc folder The default is that StarTeam folders are not differentiated based on the case of letters in their names With or without cs if folder names are ambiguous an error occurs For example when you use csf the names of two folders are ambiguous if both a Doc and doc folder exist When you do not use csf folder names are ambiguous if they are spelled identically encrypt Encrypts all data sent between the workstation and the server and decrypts it when it arrives Without this option no encryption takes place Encryption protects files and other project information from being read by unauthorized parties over unsecured network lines The full syntax is encrypt encryptionType The types of encryption are RC4 RSA RC4 stream cipher fast RC2_ECB RSA RC2 block cipher Electronic Codebook RC2_CBC RSA RC2 block cipher Cipher Block Chaining RC2_CFB Windows platforms only RSA RC2 block cipher Cipher Feedback These encryption types are ordered from fastest to slowest Each of the slower encryption types is safer than the one preceding it Note For platforms other than Windows the public and private keys used in the encryption process are not created automatically They are stored in a file in the user s hom
138. use keywords Specifies a name for the project Use a maximum of 254 characters Identifies the Server The full syntax is s userName password host portNumber For example s JMarsh password orion 49201 If the user name is omitted the current user name is used The user name in the example is JMarsh If the password is omitted the user is prompted to enter the password The password in the example is password If the host name is omitted the default is localhost The host name in the example is orion The port number is required The default port number 49201 is used in the example The following example uses stcmd add project to create a project named Integrations on the computer named Orion Orion is running an instance of the StarTeam Server with a server configuration that uses port 1024 This command creates the project specifies that the data sent between workstations and the server should be compressed and encrypted and gives the project a description scema add project s JMarsh password Orion 1024 cmp encrypt RC4 name Integrations rp C integrations d integrations between our products and our partner s products Related Reference Client Command line Operations 44 Add Views stcmd add view Use stcmd add view to add a view to a StarTeam server configuration from the command line When the view is created its parent view is the view specified with the p option and its root
139. ut If 1 or u or ne1 is not used the files lock status remains unchanged Enables you to merge the working file with the revision being checked out and with the revision upon which both of these is based The working file must have the status Merge You can specify one of the following reporting options with merge dryrun Indicates whether the merged results file has conflicts or not the local working file is unchanged as nothing is checked out This provides a preview alwaysprompt Always prompts the user to save the merged result file in the working folder whether or not there were merge conflicts neverprompt Always saves the merged results file to the working folder conflictprompt Prompts the user to save the merged results file only if conflicts were detected The options dryrun alwaysprompt neverprompt and conflictprompt are mutually exclusive When none are specified the default behavior is conflictprompt You can specify an alternate application other than that available with the application to perform the merge If you use the merge option you cannot use the i or o option If you are not using hook and you save a merged file with conflicts each conflict is marked inside the working file as follows lt lt lt lt lt lt lt fileName local line as it appears in the local file line as it appears in the revision being checked out 52 gt gt gt gt gt gt gt fileName version x wher
140. ved with unresolved file merge conflicts the manual file merge phase will be performed again when the session is resumed However if ManualMergeFiles was not specified in the original VCM session it can be specified as True in the resumed session to invoke the manual merge phase Alternatively it can be specified as False in a resumed session to prevent the manual merge phase PostCommitLabel PostCommitRevLabel PreCommitLabel and PreCommitRevLabel If any of these label options are specified in a resumed option they override the previous value for the corresponding label When a label option is set to a blank the corresponding label option is disabled and will not be created in the commit phase Related Reference Overview of the VCM Command line Utility VCMUtility VCMUtility Commands VCMUtility Connection Options VCMUtility Miscellaneous Options VCMUtility Examples Cheat Sheet 92 VCMUtility Miscellaneous Options This section defines VCMUtility miscellaneous options that are not saved in view compare merge sessions NetMon NM NetMon True False Enables the SDK net monitor feature Each command issued by the vcMUtility to the StarTeam Server is logged to the console window but not the vcMUtility log file Time E Time True False Causes timing information to be displayed for each phase of the VCM session performed Timing information is written to both the console window and the vcMUtilit
141. view Describes the command to add a view to a StarTeam server configuration Apply Labels stemd apply label Describes the command used to label specified file revisions with view or revision labels Check In Files stemd ci Describes the command to check files into a StarTeam repository or vault from a working folder Check Out Files stemd co Describes the command to check out files from a StarTeam repository or vault to your working folder Compare File Revisions stemd diff Describes the command to display differences between two revisions of a file Change File Descriptions stemd dsc Describes the command to change a file description Create Labels stcmd label Describes the command to create a view or revision label Create Working Folders stemd local mkdir Describes the command to create the working folder or working directory on your workstation for the specified StarTeam folder Delete Local Files stcmd delete local Describes the command to delete files from a working folder Display File History stemd hist Describes the command to display the revision history of files List Files stemd list Describes the command to list all files in the folder specified by the p option Lock and Unlock Files stemd Ick Describes the command to lock or unlock files Lock and Unlock Server stemd server mode Describes the command to lock and unlock a server configuration 27 Remove Files
142. word for the user on the command line It must be saved in UTF 8 format The full syntax is pwdfile filePath Makes the working file read only after this operation Without this option the file remains as it was prior to the operation Usually you use ro to prevent yourself from editing a file that is not locked by you Without ro the files are read write 13 rp Specifies or overrides the working folder or working directory for the root folder of the view This is equivalent to setting an alternate working path for the view Refer to the description of the fp option in this table for additional information The full syntax is ro folderPath e Displays check out volume and timing statistics ts Sets the time stamp for each working file to the check out time Without this option the file is given the same time stamp as the checked in revision of the file useCA Attempts to check out files using a StarTeamMPX Cache Agent The full syntax is useCA host port autolocate The host port syntax specifies the host name or IP address and port number of the Cache Agent to be used Alternatively autolocate can be specified to automatically locate the nearest network Cache Agent autolocate requires that the StarTeam Server is MPX enabled vb Output is verbose Displays each file as it is checked out The folder path is the folder path rather than the working folder path BCO Usage Examples The followi
143. xample starteamserver stop MyServer Note For enterprise advantage users If you are running the Server as a service and Notification Agent as a dependent service you cannot shut down the Team Server unless the Notification Agent service is shut down first t DBType Use with new See also dsn p u Specifies the database type This option can be used only when you are creating a new server configuration Use one of the following numbered values to indicate the type of database 2 Microsoft SQL Server or SSE 3 Oracle The value you specify for DBType is stored in the starteam server configs xml file You can review the database type using The view option from the command line In StarTeam Administration Tool on the Database tab of the StarTeam Server Configuration tab In Server Administration on the Database tab of the lt server configuration gt Properties dialog box Example starteamserver new NewServerl r c new server t 1 dsn NewServerDSN u Admin p password tcpip Endpoint up Endpoint down Endpoint Use with start restart 21 Sets the endpoint for the TCP IP Sockets protocol Also enables or disables the protocol Use up to enable and down to disable You can both set the endpoint and enable or disable it using up or down followed by a colon and the endpoint The value you specify for the endpoint is stored in the database used by this server configuration You can
144. y log file Verbose vb V Verbose True False Causes additional diagnostic and progress information to be displayed to the console standard output and to the VCMUtility log file during execution Related Reference Overview of the VCM Command line Utility VCMUtility VCMUtility Commands VCMUtility Connection Options VCMUtility Session Options VCMUtility Examples Cheat Sheet 93 VCMUtility Examples This topic presents examples of using the VCMUtility for various types of merges Hello World Rebase Below are the options for the Hello World equivalent of a vcMUtility Rebase run Type Rebase Project Hello Target World Automatic Rebase The options file below performs the same Rebase as in the previous example but it commits if possible and provides detailed reporting on the results Type Rebase Project Hello Target World CommitMerge True LockMergeConflicts Both All of these options are set to True AutoMergeFiles BreakLocks ReportDiffs ReportUpdates All files are auto merged both in content and properties Files that are in conflict but cannot be resolved are locked in both the source and target views Existing lock conflicts are broken if possible If no unresolved conflicts are encountered the session is committed Details of both the compare phase differences and commit phase updates are reported If the commit is successful all VCM session temporary files are delet

StarTeam Command-line Tools Help

Contents

Download Pdf Manuals

Related Search

Related Contents