Script, File type, and Source le | IBM SC34-4499-03 instruction

To use the builder from a previous release, you can link to a part that uses it in the previous release. This action copies the builder to the new release. Otherwise, you must create it again in the new release.

Script, File type, and Source ®le

These ®elds work together to de®ne the build script that the builder invokes to

accomplish the transformation. (The File type ®eld on the GUI corresponds to -text, -binary, and -nonein the command. The Source ®le ®eld on the GUI

corresponds to the -fromattribute in the command.)

You must ®rst create a separate ®le containing the build script. All MVS build scripts must be written using JCL statements and the TeamConnection syntax described in ªWriting an MVS build scriptº on page 163. You can store the build script one of two ways:

vTo store the build script as part of the builder: specify the fully quali®ed

path name of your build script ®le as the source ®le, and specify the ®le type as text. When the builder is created, this source ®le is stored as part of it in the TeamConnection database.

During a build, the build server creates and runs a local version of this ®le. Specify the name you want for this local ®le in theScript ®eld. For example, you might specify these values:

File type text

Script fhbc

Source ®le C:\build\script\fhbc.jcl

When this builder is created, the contents of C:\build\script\fhbc.jcl are stored in the builder. When this builder is invoked, TeamConnection creates a ®le named FHBC in the data set referenced by the TEAMPROC ddname, writes the build script into this ®le, and then runs it.

vTo store the build script on MVS: create the build script ®le and place it in the data set allocated to the TEAMPROC ddname in the RUNPGM JCL ®le. When you do this, specify the following attributes:

File type none

Script fhbc

Do not specify a source ®le.

vIf the builder is being used to only collect a set of build objects (for example, a VisualAge Generator collector part), specify these values:

File type none

Script null

Chapter 13. Working with MVS build scripts and builders 161

Image 181

IBM SC34-4499-03 manual Script, File type, and Source le, File type none Script fhbc, File type none Script null

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 4. Using TeamConnection to build applications Part 3. Using TeamConnection Notes Integrated DatabasesIntroduction to TeamConnection Integrated Notes Databases Creating and Maintaining Integrated Notes Databases Working with build scripts and builders Installing, starting, and stopping build serversWorking 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 How this book is organized About this bookConventions Xvii Tell us what you think Part 1. Introducing TeamConnection Users Guide An introduction to TeamConnection TeamConnections client/server architecture TeamConnection denitions Interfaces TeamConnection database Users and host lists FamiliesParts Check out ComponentsCheck Work areas Releases Drivers Processes Defects and features Approval Build Family administrator System administratorPackaging Roles people play End user Build administrator Users Guide Part 2. Developing a product using TeamConnection Working with component and release processes Getting familiar with the TeamConnection client interfaces Using the GUI Tasks window Starting the GUI Performing tasks with the GUI Stopping the GUI On the GUI Using the Settings notebook Online help information Using the command line interface Using the TeamConnection web client Getting familiar with the TeamConnection client interfaces Users Guide Laying the groundwork Basics of using TeamConnection Components window Authority to perform tasks Finding parts Finding objects within TeamConnection BuildView Using work areasPartFull Creating parts Naming your work areas Preparing to build your parts Naming your parts Working with parts Working in serial or concurrent development modeDependent Working with common parts Your workstations current working directory Getting parts from TeamConnection Checking parts in to TeamConnection Versioning releases Finding different versions of TeamConnection objects Versioning work areas Versioning drivers Analyzing defects and features Working with defects and featuresDesigning the resolution Versioning parts Resolving defects and implementing features Testing and verifying part changesVerifying the resolution of the defect or feature Reviewing the design and resource estimates Users Guide Component subprocesses States of TeamConnection objectsRelease subprocesses Open state Returned state Canceled stateDesign state Size state Working state Review stateVerify state Closed state Approve state States of work areasFix state Integrate state Restrict state States of driversCommit state Test state Restrict state Verication and test records Users Guide Working in serial development Working with no component or release processes For information about this task Go to this Accepting a defect Creating a work area CommandResult Create Work Areas window Checking out a part Check Out Parts window Searching for a part Part Filter window Selects Save to Task List Edit 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 updates Build Parts window Extract Parts window Extracting a part Check Out Parts Checking out the part one more time Checking the part back Now the work area contains the following parts Freezing the work area Refreshing the work area Refresh Work Areas window Building the application Integrating the work area Integrate Work Areas window Closing a defect Verify Defects window Working in concurrent development Following tasks are required Refreshing the work area from the driver 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 Results Changing defect ownership Accepting a defect Approving Accept Approval Records window \robot\src in the Destination directory eld \robot\src in the Source directory eld Checking in the changes Now the work area contains the following part versions Teamc workarea -freeze 456 -release robotcontrol Building the application Complete Fix Records window Accepting x records Adding a driver member Integrating changed parts into a release Returning the work area to the x state Reconciling the differences Activate Fix Records window Reactivating the x record Refreshing the driver Refresh Drivers window Building the driver Restricting the driver Restrict Drivers window Integrating the parts Complete Drivers window Completing the driver Accept Test Records window Testing the built application Retrieving a past version of a part Using a congured process Teamc workarea -freeze 1208 -release robotcontrol Working with component and release processes TeamConnection system returns the following report 101 Part 3. Using TeamConnection Notes Integrated Databases Users Guide Getting started Introduction to TeamConnection Integrated Notes Databases103 Prerequisites and dependencies Using TeamConnection with Lotus NotesSources of user information Database types Test Case Management and Tracking Forms and subformsGeneric User Dened Requirements Views All documents Document archiving Reviews 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 File-Save Select Administration-Document Control Creating customized production databases Select Administration-Document Control Performing reconciliation From the File menu, select Database-Replace Design Database maintenance refreshing design from a template Important notice to administrators Database Design Strategies and Advanced Customization Rules of thumb and general advice121 Using the Customization setup facility Common Database Options Modify Database Optional InformationDatabase-specic Options Modify the document hierarchy Reconciliation of Notes and TeamConnection Data Modify TeamConnection Access Advanced customization Activate Reconcile Defects and FeaturesLog Document Options Users Guide 127 Part 4. Using TeamConnection to build applicationsBasic build concepts Working with parsers Building an application an example Physical structure of the build function Basic build concepts129 TeamConnection part Build object modelBuild event Builder Build script Parent-child relationships in a build treeInput parts Output parts Users Guide Sample build object model for msgcat.exe Working with a build tree Build tree for the hello application For more information about this task Go to this Putting the pieces together For more information about this task Go to this Installing the build function Installing, starting, and stopping build serversCreating a build server on MVS 137 Cd JCL data set for load module Cd data set for teamproc jcl Creating a build server on MVS/OE 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 an MVS build server Stopping the build servers Users Guide Creating a builder Working with build scripts and builders147 Release Fromscriptfilespec -scriptname Environment Writing a build script TimeoutComparison operator and RC value Parameters As attributes of a builder Passing parameters to a build script As attributes of a part in the build tree As parameters of the part -build command Writing an executable le for a build script Writing a simple build script Testing a build script Putting a builder to work Modifying the contents of a build script Modify Part Properties window Removing a builder from a part 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 Fhbmasm.jcl Writing an MVS build scriptFhbcobm.jcl Fhbmpli.jcl Passing parameters to an MVS build script File name conversions for MVS Tcbldusr TeamConnection syntax for MVS build scripts Exec statement Supported JCL syntaxPositional parameters Keyword parameters DD Statement Example of a build script for a C compile WELLSK.TEAMC.ERROR Working with MVS build scripts and builders UNIT=SYSDA,SPACE=TRK,10,5 Example of a build script for a Cobol compile DCB=RECFM=FB,LRECL=80,BLKSIZE=3200 Example of a build script for a link Sysmod DD TCEXT=LOAD,DISP=NEW,DELETE Working with MVS build scripts and builders Users Guide Creating a parser Working with parsers175 Create Parser window Include Writing 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 example 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 Build tree display Starting the build on the client Build target Build modeWork area Build pool Unconditional Putting the build scripts to workDetail le name Monitoring the progress of a build Finishing the job and reporting the results to the user Building all parts, regardless of build times Running a build in spite of errors Finding out which parts will be built Canceling a build Dening multiple outputs from a single build event More sample build trees He creates the collector part Synchronizing the build of unrelated parts Building an application an example Users Guide Chapter Using TeamConnection to package a product Part 5. Using TeamConnection to package products199 Chapter Users Guide 201 Using TeamConnection to package a product Setting up a build tree for the gather tool Setting up your build tree for packaging 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 Package le looks like this Using exit keywords an example Users Guide 215 Using the Tivoli Software Distribution packaging tool 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 Log le Sample package leOption Trace facility Profile Using the Tivoli Software Distribution packaging tool Exit # end of file 225 Part 6. Appendixes Users Guide 227 Appendix A. Environment Variables Nlspath Tcbuildpool Tccasesense Tcmakeimportverbose Tcrelease TeamConnection dynamically set build environment variables Setting environment variables 235 Appendix B. Importing makele information into TeamConnection Create le Modied makeleConnect le Creating a rules le ContentLe mask Connect Component 239 Appendix C. TeamConnection Merge Parameter Description Setting up your project options Creating a TeamConnection-enabled Workframe project241 Project actions Using your TeamConnection Workframe project View part information Part actionsEdit part Show parts Using your project a simple scenario Tcuser 245 Tcbecome TC Extract Part TC View Part ContentsTC View Part Information TC Build Part Users Guide 249 Overview of the ENVY/Manager-TeamConnection Bridge Scope of this documentation Preparing to use the ENVY/Manager-TeamConnection Bridge How the bridge communicates with TeamConnection 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 Exporting Envy components to TeamConnection ExportReplace existing les Storage in TeamConnection Exporting conguration maps and applications Importing Envy components from TeamConnection Exporting les Scenario assumptions Envy TeamConnectionVisualAge Generator Developer Build generation Object mapping in TeamConnection TeamConnection build function TeamConnection change control Making a change to a member TeamConnection change control Projects vs Families Appendix G. Source Code Control Users Guide267 Installing the TeamConnection source code control DLL Using TeamConnection as your source code control provider Connecting TeamConnection to an IDERemoving the TeamConnection Source Code Control DLL Before you start Opening a project Integrated features Check-in Full features of TeamConnectionCheck-out Uncheck-out Migrating project data bases Starting a new project Users Guide 275 Appendix H. Supported expandable keywords 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 package les Sample parsers 307 Customer supportIBM Talklink Internet DB2 service maintenance and technical library IBM VisualAge TeamConnection Enterprise Server library Bibliography309 TeamConnection technical reports Glossary Related publications Users Guide 313 GlossaryCompare to Contrast with Users Guide Glossary End user. See user See also build dependent HPFS. See high-performance le system Users Guide Pool. See build pool Users Guide TeamConnection superuser. See superuser Users Guide 323 Index Builder 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 You Readers Comments Ð Wed Like to Hear from You IbmrPage Ibmr