Creating customized production databases | IBM SC34-4499-03 instruction

Creating customized production databases

Now that you have initialized the Integrated Notes Database feature and performed a preliminary setup of the database template for your organization, you can proceed to customize the initialized database.

See ªUsing the Customization setup facilityº on page 122 for additional details on the customization options.

Note: A Customization Wizard is available from the Setup window action bar to assist you in customizing your database.

Perform the following steps to customize your database and make it available at a production level:

1.From the main database window, select Setup.

2.Use the Customization setup facility to customize the database design. Using Customization, you can modify the default values that are provided.

Note: If your customization will extend to subforms, you will need some familiarity with the Lotus Notes environment.

You can adjust or refresh values are for the following:

vNotes document names, titles, and subtitles.

vStructure of the Notes document hierarchy.

vStates each Notes document may progress through.

vTeamConnection family, component, and con®gurable ®eld information.

vTeamConnection feature and defect attributes to store in Notes documents.

vReconciliation of Notes and TeamConnection data. See ªPerforming reconciliationº on page 118 for details.

Make any design changes that are necessary for your particular application and organization's work¯ow. This process is detailed in ªChapter 9. Database Design Strategies and Advanced Customizationº on page 121 and within the Customization setup facility itself.

3.When the setup is complete, you will return to the main window. Select Proceed to Database. Your new, but empty database is available. You can now test that it is working to your satisfaction.

In the most basic terms, testing would include the following activities:

vCreate documents.

vUpdate documents. This should include testing the state system, which would involve moving a document's state to Approved.

vReopen documents.

vSelect Feature and Defect push buttons.

116User's Guide

Image 136

IBM SC34-4499-03 manual Creating customized production databases

Contents

IBM Page IBM Fourth Edition March Contents Working with no component or release processes States of TeamConnection objectsWorking with component and release processes Part 3. Using TeamConnection Notes Integrated Databases Part 4. Using TeamConnection to build applicationsIntroduction to TeamConnection Integrated Notes Databases Creating and Maintaining Integrated Notes Databases Installing, starting, and stopping build servers Working with build scripts and buildersWorking with MVS build scripts and builders Working with parsers Creating a parser Part 5. Using TeamConnection to package products Appendix H. Supported expandable keywords Appendix G. Source Code Control Users GuideAppendix J. Sample Rexx execs, build scripts, and parsers Readers Comments Ð Wed Like to Hear from You Users Guide Figures Xii Users Guide Xiii Xiv Users Guide Trademarks Xvi Users Guide About this book How this book is organizedConventions Xvii Tell us what you think Part 1. Introducing TeamConnection Users Guide An introduction to TeamConnection TeamConnection denitions TeamConnections client/server architecture TeamConnection database Interfaces Users and host lists FamiliesParts Check out ComponentsCheck Releases Work areas Drivers Defects and features Processes Build Approval System administrator Family administratorPackaging Roles people play Build administrator End user Users Guide Part 2. Developing a product using TeamConnection Working with component and release processes Using the GUI Getting familiar with the TeamConnection client interfaces Starting the GUI Tasks window Stopping the GUI Performing tasks with the GUI Using the Settings notebook On the GUI Using the command line interface Online help information Using the TeamConnection web client Getting familiar with the TeamConnection client interfaces Users Guide Basics of using TeamConnection Laying the groundwork Authority to perform tasks Components window Finding objects within TeamConnection Finding parts BuildView Using work areasPartFull Naming your work areas Creating parts Naming your parts Preparing to build your parts Working with parts Working in serial or concurrent development modeDependent Working with common parts Getting parts from TeamConnection Your workstations current working directory Checking parts in to TeamConnection Finding different versions of TeamConnection objects Versioning releases Versioning work areas Versioning drivers Working with defects and features Analyzing defects and featuresDesigning the resolution Versioning parts Testing and verifying part changes Resolving defects and implementing featuresVerifying the resolution of the defect or feature Reviewing the design and resource estimates Users Guide States of TeamConnection objects Component subprocessesRelease subprocesses Open state Canceled state Returned stateDesign state Size state Working state Review stateVerify state Closed state Approve state States of work areasFix state Integrate state States of drivers Restrict stateCommit state Test state Restrict state Verication and test records Users Guide Working with no component or release processes Working in serial development Accepting a defect For information about this task Go to this Creating a work area CommandResult Checking out a part Create Work Areas window Searching for a part Check Out Parts window Selects Save to Task List Part Filter window Edit Task List window Checking in a part Teamc part -checkin optics.c -release robotcontrol -workarea Verifying and testing part updates Thus, work area 310 contains the following parts Build Parts window Extracting a part Extract Parts window Checking out the part one more time Check Out Parts Checking the part back Freezing the work area Now the work area contains the following parts Refreshing the work area Building the application Refresh Work Areas window Integrating the work area Closing a defect Integrate Work Areas window Working in concurrent development Verify Defects window Refreshing the work area from the driver Following tasks are required From 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 Changing defect ownership Results Accepting a defect Approving \robot\src in the Destination directory eld Accept Approval Records window Checking in the changes \robot\src in the Source directory eld Now the work area contains the following part versions Teamc workarea -freeze 456 -release robotcontrol Building the application Accepting x records Complete Fix Records window Integrating changed parts into a release Adding a driver member Reconciling the differences Returning the work area to the x state Reactivating the x record Activate Fix Records window Refreshing the driver Building the driver Refresh Drivers window Restricting the driver Integrating the parts Restrict Drivers window Completing the driver Complete Drivers window Testing the built application Accept Test Records window Using a congured process Retrieving a past version of a part Teamc workarea -freeze 1208 -release robotcontrol Working with component and release processes TeamConnection system returns the following report Part 3. Using TeamConnection Notes Integrated Databases 101 Users Guide Getting started Introduction to TeamConnection Integrated Notes Databases103 Prerequisites and dependencies Using TeamConnection with Lotus NotesSources of user information Database types Forms and subforms Test Case Management and TrackingGeneric User Dened Views Requirements All documents Reviews Document archiving Users Guide Creating and Maintaining Integrated Notes Databases Important notice to administrators111 Initializing the original template and creating a database Select Access Control Users Guide Select Administration-Document Control Select File-Save Creating customized production databases Select Administration-Document Control Performing reconciliation Database maintenance refreshing design from a template From the File menu, select Database-Replace Design Important notice to administrators Database Design Strategies and Advanced Customization Rules of thumb and general advice121 Using the Customization setup facility Modify Database Optional Information Common Database OptionsDatabase-specic Options Modify the document hierarchy Modify TeamConnection Access Reconciliation of Notes and TeamConnection Data Advanced customization Activate Reconcile Defects and FeaturesLog Document Options Users Guide Part 4. Using TeamConnection to build applications 127Basic build concepts Working with parsers Building an application an example Physical structure of the build function Basic build concepts129 Build object model TeamConnection partBuild event Builder Parent-child relationships in a build tree Build scriptInput parts Output parts Users Guide Working with a build tree Sample build object model for msgcat.exe Build tree for the hello application Putting the pieces together For more information about this task Go to this For more information about this task Go to this Installing, starting, and stopping build servers Installing the build functionCreating a build server on MVS 137 Cd JCL data set for load module Creating a build server on MVS/OE Cd data set for teamproc jcl Starting 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 the build servers Stopping an MVS build server Users Guide Creating a builder Working with build scripts and builders147 Fromscriptfilespec -scriptname Release Environment Timeout Writing a build scriptComparison operator and RC value Parameters Passing parameters to a build script As attributes of a builder As parameters of the part -build command As attributes of a part in the build tree Writing a simple build script Writing an executable le for a build script Testing a build script Modifying the contents of a build script Putting a builder to work Removing a builder from a part Modify Part Properties window Working with VisualAge C++ and Templates Users Guide Creating a builder for MVS builds Working with MVS build scripts and builders159 Builder File type none Script fhbc Script, File type, and Source leFile type none Script null Comparison operator are as follows ± EQ or == Equals Writing an MVS build script Fhbmasm.jclFhbcobm.jcl Fhbmpli.jcl File name conversions for MVS Passing parameters to an MVS build script TeamConnection syntax for MVS build scripts Tcbldusr Supported JCL syntax Exec statementPositional parameters Keyword parameters DD Statement WELLSK.TEAMC.ERROR Example of a build script for a C compile Working with MVS build scripts and builders Example of a build script for a Cobol compile UNIT=SYSDA,SPACE=TRK,10,5 Example of a build script for a link DCB=RECFM=FB,LRECL=80,BLKSIZE=3200 Sysmod DD TCEXT=LOAD,DISP=NEW,DELETE Working with MVS build scripts and builders Users Guide Creating a parser Working with parsers175 Include Create Parser window Writing a parser command le Putting a parser to work Removing a parser from a part From a command line, type the following Building an application an example 181 Sample build tree Starting the build servers Creating the build tree for the application Creating builders and parsersMvspool Create Parts window Create Parts window Modify Part Properties window Connect Parts window Starting the build on the client Build tree display Build mode Build targetWork area Build pool Unconditional Putting the build scripts to workDetail le name Finishing the job and reporting the results to the user Monitoring the progress of a build Running a build in spite of errors Building all parts, regardless of build times Canceling a build Finding out which parts will be built More sample build trees Dening multiple outputs from a single build event Synchronizing the build of unrelated parts He creates the collector part Building an application an example Users Guide Part 5. Using TeamConnection to package products Chapter Using TeamConnection to package a product199 Chapter Users Guide Using TeamConnection to package a product 201 Setting up your build tree for packaging Setting up a build tree for the gather tool She also connects a readme le for the application Adding the gather step to the build tree Using the teamcpak command for the Gather tool Using the Gather tool205 String Command line ¯agsInputles Using the Gather tool Writing a package le for the Gather tool Examples of the teamcpak gather commandSyntax rules for a Gather package le Packageformat gather Keywords for a Gather package leTargetroot targetrootpath Source list of le specications Target Targetpath Using exit keywords in the Rule clause Using exit keywords in the Data clauseEXITPRIOR, EXITPOST, and Exitreplace String Using exit keywords an example Package le looks like this Users Guide Using the Tivoli Software Distribution packaging tool 215 InputFile Writing a package le for Tivoli Software Distribution Example of the teamcpak softdist commandSyntax rules for a Tivoli Software Distribution package le Example Keywords for a Tivoli Software Distribution package lePackageformat softdist Nodes Installpgm Sample package le Log leOption Trace facility Profile Using the Tivoli Software Distribution packaging tool Exit # end of file Part 6. Appendixes 225 Users Guide Appendix A. Environment Variables 227 Nlspath Tcbuildpool Tccasesense Tcmakeimportverbose Tcrelease TeamConnection dynamically set build environment variables Setting environment variables Appendix B. Importing makele information into TeamConnection 235 Create le Modied makeleConnect le Content Creating a rules leLe mask Connect Component Appendix C. TeamConnection Merge 239 Parameter Description Setting up your project options Creating a TeamConnection-enabled Workframe project241 Using your TeamConnection Workframe project Project actions Part actions View part informationEdit part Show parts Using your project a simple scenario 245 Tcuser Tcbecome TC View Part Contents TC Extract PartTC View Part Information TC Build Part Users Guide Overview of the ENVY/Manager-TeamConnection Bridge 249 Scope of this documentation How the bridge communicates with TeamConnection Preparing to use the ENVY/Manager-TeamConnection Bridge Prerequisites Setting up the bridge environmentEnvironment variables Loading the ENVY/Manager-TeamConnection Bridge Testing the ENVY/Manager-TeamConnection Bridge Setting default properties Using the ENVY/Manager-TeamConnection BridgeDefaults Operations ContextLocking Import Export Exporting Envy components to TeamConnectionReplace existing les Storage in TeamConnection Exporting conguration maps and applications Exporting les Importing Envy components from TeamConnection Scenario assumptions Envy TeamConnectionVisualAge Generator Developer Object mapping in TeamConnection Build generation TeamConnection build function Making a change to a member TeamConnection change control TeamConnection change control Projects vs Families Appendix G. Source Code Control Users Guide267 Installing the TeamConnection source code control DLL Connecting TeamConnection to an IDE Using TeamConnection as your source code control providerRemoving the TeamConnection Source Code Control DLL Before you start Integrated features Opening a project Full features of TeamConnection Check-inCheck-out Uncheck-out Migrating project data bases Starting a new project Users Guide Appendix H. Supported expandable keywords 275 Then 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 Sample Rexx execs Appendix J. Sample Rexx execs, build scripts, and parsers301 Script name Function Inputs DrvrMem Lists the defect and feature members of a DriverName Script name Function Inputs Sample build scripts Sample parsers Sample package les Customer support 307IBM Talklink Internet DB2 service maintenance and technical library IBM VisualAge TeamConnection Enterprise Server library Bibliography309 TeamConnection technical reports Related publications Glossary Users Guide Glossary 313Compare to Contrast with Users Guide Glossary See also build dependent End user. See user HPFS. See high-performance le system Users Guide Pool. See build pool Users Guide TeamConnection superuser. See superuser Users Guide Index 323 Builder Debug GUI Exitpost Parts nding Releases Tcmakeimportrules 227, 235 Work area Automatic creation Users Guide Readers Comments Ð Wed Like to Hear from You How satised are you that the information in this book is Ibmr Readers Comments Ð Wed Like to Hear from YouPage Ibmr