Manuals / IBM / Computer Equipment / Personal Computer

IBM SC34-4499-03 manual Working with component and release processes

Models: SC34-4499-03

1 356

Download 356 pages 55.74 Kb

Page 119

workAreaName	1208
releaseName	robot_control
predecessor	1208:2
hasSuccessor	yes
releaseVersion	no
addDate	1995/01/14 11:13:25
freezeDate	1995/01/15 09:01:35
name	1208:4
workAreaName	1208
releaseName	robot_control
predecessor	1208:3
hasSuccessor	no
releaseVersion	no
addDate	1995/01/16 08:10:15
freezeDate	1995/01/16 10:05:11

So what does it all mean?

vname is the name of the version in the work area.

vworkAreaName is the name of the work area that owns the version.

vReleaseName is the name of the release that owns the version.

vPredecessor is the name of the version that precedes, or is the parent of, this version.

vhasSuccessor has a value of yes if the version has a successor, no if it does not.

vreleaseVersion has a value of yes if the version is part of the release's main version history; the value is no if the version belongs to a work area.

vaddDate is the date and time the version was created.

vfreezeDate is the date the version was frozen.

This report seems erroneous. TeamConnection returned four versions in the report even though Alex has executed the freeze command against his work area only three times. The fourth version, 1208:4, is the unfrozen version in which Alex is currently making his changes.

Another concern might be the predecessor of the ®rst version returned in the report. Why is its predecessor robot_control:5? At some point Alex began his work by making modi®cations to the latest code in the release. The ®rst version of Alex's changes is based on the release version robot_control:5.

After reviewing the report, Alex thinks that his last working copy of optics.c was saved when he created version 1208:2. However, to make sure, he wants to see the parts modi®ed in version 1208:2. He issues the following command:

teamc report -view partView -version 1208:2 -release robot_control -where "currentVersion=©1208:2©" -stanza

This report returns a list of parts visible to version 1208:2 that have a currentVersion (or version ID) of 1208:2. If a part has such a version ID, the part was modi®ed in the version 1208:2.

Chapter 6. Working with component and release processes 99

Image 119

IBM SC34-4499-03 manual Working with component and release processes

Contents

IBM Page IBM Fourth Edition March Contents Working with component and release processes States of TeamConnection objectsWorking with no component or release processes Creating and Maintaining Integrated Notes Databases Part 3. Using TeamConnection Notes Integrated DatabasesPart 4. Using TeamConnection to build applications Introduction to TeamConnection Integrated Notes DatabasesWorking with parsers Creating a parser Installing, starting, and stopping build serversWorking with build scripts and builders Working with MVS build scripts and buildersPart 5. Using TeamConnection to package products Appendix J. Sample Rexx execs, build scripts, and parsers Appendix G. Source Code Control Users GuideAppendix H. Supported expandable keywords Readers Comments Ð Wed Like to Hear from You Users Guide Figures Xii Users Guide Xiii Xiv Users Guide Trademarks Xvi Users Guide Xvii About this bookHow this book is organized ConventionsTell us what you think Part 1. Introducing TeamConnection Users Guide An introduction to TeamConnection TeamConnections client/server architecture TeamConnection denitionsInterfaces TeamConnection databaseParts FamiliesUsers and host lists Check ComponentsCheck out Work areas ReleasesDrivers Processes Defects and featuresApproval BuildRoles people play System administratorFamily administrator PackagingEnd user Build administratorUsers Guide Part 2. Developing a product using TeamConnection Working with component and release processes Getting familiar with the TeamConnection client interfaces Using the GUITasks window Starting the GUIPerforming tasks with the GUI Stopping the GUIOn the GUI Using the Settings notebookOnline help information Using the command line interfaceUsing the TeamConnection web client Getting familiar with the TeamConnection client interfaces Users Guide Laying the groundwork Basics of using TeamConnectionComponents window Authority to perform tasksFinding parts Finding objects within TeamConnectionPartFull Using work areasBuildView Creating parts Naming your work areasPreparing to build your parts Naming your partsDependent Working in serial or concurrent development modeWorking with parts Working with common parts Your workstations current working directory Getting parts from TeamConnectionChecking parts in to TeamConnection Versioning releases Finding different versions of TeamConnection objectsVersioning work areas Versioning drivers Versioning parts Working with defects and featuresAnalyzing defects and features Designing the resolutionReviewing the design and resource estimates Testing and verifying part changesResolving defects and implementing features Verifying the resolution of the defect or featureUsers Guide Open state States of TeamConnection objectsComponent subprocesses Release subprocessesSize state Canceled stateReturned state Design stateVerify state Review stateWorking state Closed state Fix state States of work areasApprove state Integrate state Test state States of driversRestrict state Commit stateRestrict state Verication and test records Users Guide Working in serial development Working with no component or release processesFor information about this task Go to this Accepting a defectResult CommandCreating a work area Create Work Areas window Checking out a partCheck Out Parts window Searching for a partPart Filter window Selects Save to Task ListEdit Task List window Checking in a part Teamc part -checkin optics.c -release robotcontrol -workarea Thus, work area 310 contains the following parts Verifying and testing part updatesBuild Parts window Extract Parts window Extracting a partCheck Out Parts Checking out the part one more timeChecking the part back Now the work area contains the following parts Freezing the work areaRefreshing the work area Refresh Work Areas window Building the applicationIntegrating the work area Integrate Work Areas window Closing a defectVerify Defects window Working in concurrent developmentFollowing tasks are required Refreshing the work area from the driverFrom a command line, she issues the following command Reconciling differences GUI Reconcile Collision Record window Result Working with component and release processes Moving through design, size, and review Results Changing defect ownershipAccepting a defect Approving Accept Approval Records window \robot\src in the Destination directory eld\robot\src in the Source directory eld Checking in the changesNow the work area contains the following part versions Teamc workarea -freeze 456 -release robotcontrol Building the application Complete Fix Records window Accepting x recordsAdding a driver member Integrating changed parts into a releaseReturning the work area to the x state Reconciling the differencesActivate Fix Records window Reactivating the x recordRefreshing the driver Refresh Drivers window Building the driverRestricting the driver Restrict Drivers window Integrating the partsComplete Drivers window Completing the driverAccept Test Records window Testing the built applicationRetrieving a past version of a part Using a congured processTeamc workarea -freeze 1208 -release robotcontrol Working with component and release processes TeamConnection system returns the following report 101 Part 3. Using TeamConnection Notes Integrated DatabasesUsers Guide 103 Introduction to TeamConnection Integrated Notes DatabasesGetting started Sources of user information Using TeamConnection with Lotus NotesPrerequisites and dependencies Database types User Dened Forms and subformsTest Case Management and Tracking GenericRequirements ViewsAll documents Document archiving ReviewsUsers Guide 111 Important notice to administratorsCreating and Maintaining Integrated Notes Databases Initializing the original template and creating a database Select Access Control Users Guide Select File-Save Select Administration-Document ControlCreating customized production databases Select Administration-Document Control Performing reconciliation From the File menu, select Database-Replace Design Database maintenance refreshing design from a templateImportant notice to administrators 121 Rules of thumb and general adviceDatabase Design Strategies and Advanced Customization Using the Customization setup facility Modify the document hierarchy Modify Database Optional InformationCommon Database Options Database-specic OptionsReconciliation of Notes and TeamConnection Data Modify TeamConnection AccessLog Document Options Activate Reconcile Defects and FeaturesAdvanced customization Users Guide Working with parsers Part 4. Using TeamConnection to build applications127 Basic build conceptsBuilding an application an example 129 Basic build conceptsPhysical structure of the build function Builder Build object modelTeamConnection part Build eventOutput parts Parent-child relationships in a build treeBuild script Input partsUsers Guide Sample build object model for msgcat.exe Working with a build treeBuild tree for the hello application For more information about this task Go to this Putting the pieces togetherFor more information about this task Go to this 137 Installing, starting, and stopping build serversInstalling the build function Creating a build server on MVSCd JCL data set for load module Cd data set for teamproc jcl Creating a build server on MVS/OEStarting build servers using teamcbld Starting an MVS build server Runpgm Exec PGM=TEAMCBLD Starting the MVS/OE build server Creating build startup les for non-MVS environments Stopping an MVS build server Stopping the build serversUsers Guide 147 Working with build scripts and buildersCreating a builder Release Fromscriptfilespec -scriptnameEnvironment Parameters TimeoutWriting a build script Comparison operator and RC valueAs attributes of a builder Passing parameters to a build scriptAs attributes of a part in the build tree As parameters of the part -build commandWriting an executable le for a build script Writing a simple build scriptTesting a build script Putting a builder to work Modifying the contents of a build scriptModify Part Properties window Removing a builder from a partWorking with VisualAge C++ and Templates Users Guide 159 Working with MVS build scripts and buildersCreating a builder for MVS builds Builder File type none Script null Script, File type, and Source leFile type none Script fhbc Comparison operator are as follows ± EQ or == Equals Fhbmpli.jcl Writing an MVS build scriptFhbmasm.jcl Fhbcobm.jclPassing parameters to an MVS build script File name conversions for MVSTcbldusr TeamConnection syntax for MVS build scriptsKeyword parameters Supported JCL syntaxExec statement Positional parametersDD Statement Example of a build script for a C compile WELLSK.TEAMC.ERRORWorking with MVS build scripts and builders UNIT=SYSDA,SPACE=TRK,10,5 Example of a build script for a Cobol compileDCB=RECFM=FB,LRECL=80,BLKSIZE=3200 Example of a build script for a linkSysmod DD TCEXT=LOAD,DISP=NEW,DELETE Working with MVS build scripts and builders Users Guide 175 Working with parsersCreating a parser Create Parser window IncludeWriting a parser command le Putting a parser to work Removing a parser from a part From a command line, type the following 181 Building an application an exampleSample build tree Starting the build servers Mvspool Creating builders and parsersCreating the build tree for the application Create Parts window Create Parts window Modify Part Properties window Connect Parts window Build tree display Starting the build on the clientBuild pool Build modeBuild target Work areaDetail le name Putting the build scripts to workUnconditional Monitoring the progress of a build Finishing the job and reporting the results to the userBuilding all parts, regardless of build times Running a build in spite of errorsFinding out which parts will be built Canceling a buildDening multiple outputs from a single build event More sample build treesHe creates the collector part Synchronizing the build of unrelated partsBuilding an application an example Users Guide Chapter Part 5. Using TeamConnection to package productsChapter Using TeamConnection to package a product 199Users Guide 201 Using TeamConnection to package a productSetting up a build tree for the gather tool Setting up your build tree for packagingShe also connects a readme le for the application Adding the gather step to the build tree 205 Using the Gather toolUsing the teamcpak command for the Gather tool Inputles Command line ¯agsString Using the Gather tool Syntax rules for a Gather package le Examples of the teamcpak gather commandWriting a package le for the Gather tool Targetroot targetrootpath Keywords for a Gather package lePackageformat gather Source list of le specications Target Targetpath EXITPRIOR, EXITPOST, and Exitreplace String Using exit keywords in the Data clauseUsing exit keywords in the Rule clause Package le looks like this Using exit keywords an exampleUsers Guide 215 Using the Tivoli Software Distribution packaging toolInputFile Syntax rules for a Tivoli Software Distribution package le Example of the teamcpak softdist commandWriting a package le for Tivoli Software Distribution Packageformat softdist Keywords for a Tivoli Software Distribution package leExample Nodes Installpgm Trace facility Sample package leLog le OptionProfile Using the Tivoli Software Distribution packaging tool Exit # end of file 225 Part 6. AppendixesUsers Guide 227 Appendix A. Environment VariablesNlspath Tcbuildpool Tccasesense Tcmakeimportverbose Tcrelease TeamConnection dynamically set build environment variables Setting environment variables 235 Appendix B. Importing makele information into TeamConnectionConnect le Modied makeleCreate le Connect ContentCreating a rules le Le maskComponent 239 Appendix C. TeamConnection MergeParameter Description 241 Creating a TeamConnection-enabled Workframe projectSetting up your project options Project actions Using your TeamConnection Workframe projectShow parts Part actionsView part information Edit partUsing your project a simple scenario Tcuser 245Tcbecome TC Build Part TC View Part ContentsTC Extract Part TC View Part InformationUsers Guide 249 Overview of the ENVY/Manager-TeamConnection BridgeScope of this documentation Preparing to use the ENVY/Manager-TeamConnection Bridge How the bridge communicates with TeamConnectionEnvironment variables Setting up the bridge environmentPrerequisites Loading the ENVY/Manager-TeamConnection Bridge Testing the ENVY/Manager-TeamConnection Bridge Defaults Using the ENVY/Manager-TeamConnection BridgeSetting default properties Locking ContextOperations Import Storage in TeamConnection ExportExporting Envy components to TeamConnection Replace existing lesExporting conguration maps and applications Importing Envy components from TeamConnection Exporting lesScenario assumptions VisualAge Generator Developer TeamConnectionEnvy Build generation Object mapping in TeamConnectionTeamConnection build function TeamConnection change control Making a change to a memberTeamConnection change control 267 Appendix G. Source Code Control Users GuideProjects vs Families Installing the TeamConnection source code control DLL Before you start Connecting TeamConnection to an IDEUsing TeamConnection as your source code control provider Removing the TeamConnection Source Code Control DLLOpening a project Integrated featuresUncheck-out Full features of TeamConnectionCheck-in Check-outMigrating project data bases Starting a new project Users Guide 275 Appendix H. Supported expandable keywordsThen the expanded keywords will look like 277 Associated release ApprovalReject Approval record owner Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page New test record owner, subscribers Page Page Page Users Guide 301 Appendix J. Sample Rexx execs, build scripts, and parsersSample Rexx execs Script name Function Inputs DrvrMem Lists the defect and feature members of a DriverName Script name Function Inputs Sample build scripts Sample package les Sample parsersInternet Customer support307 IBM TalklinkDB2 service maintenance and technical library 309 BibliographyIBM VisualAge TeamConnection Enterprise Server library TeamConnection technical reports Glossary Related publicationsUsers Guide Contrast with Glossary313 Compare toUsers Guide Glossary End user. See user See also build dependentHPFS. See high-performance le system Users Guide Pool. See build pool Users Guide TeamConnection superuser. See superuser Users Guide 323 IndexBuilder Debug GUI Exitpost Parts nding Releases Tcmakeimportrules 227, 235 Work area Automatic creation Users Guide How satised are you that the information in this book is Readers Comments Ð Wed Like to Hear from YouReaders Comments Ð Wed Like to Hear from You IbmrPage Ibmr