OpenMake Meister® 7.3- Releasing the power of builds through automation Pre-requisite Checklist z/OS Support Meister's Key Benefits Build and Workflow Procedures and Usage Workflow Automation vs. Build Automation Continuous Integration and Workflow Loops Distributed Workload Processing and Multi-platform Workflows On-Demand or Scheduled Builds and Workflows Builds and Workflows Parallelized Builds and Workflows Parallel Builds Meister Components Meister Eclipse Rich Client Platform GUI Management Control Console Postgresql Database Local Knowledgebase Server Community Developed Knowledgebase Server Remote Agents Continuous Integration Server and Remote Agents Workflow Process Automation Activity Plug-Ins Meister Insight Next Steps Contact Support Purchased Support and Evaluations Non Purchased Support Setup and Installation Installation Checklist Performing the Install Linux and UNIX Installation Notes Launching the Install Installing the Command Line Client Installing a Knowledge Base Server Knowledge Base Server as a Windows Service Installing a Remote Agent Build Server as a Windows Service Installing a Continuous Integration Server Installing the Client without the Knowledge Base Server Enabling the PostgreSQL Database Enabling a Secure Login Changing the Configuration Switching to the Community Knowledge Base Requesting and Installing a New License Installing Meister as an Eclipse Plug-in Installing and Setting up the Eclipse Target Generation Plug-In Installing the Visual Studio 2005 and 2008 Add-in Accessing the Management Control Console Upgrading the Client from a Previous Version of Meister Upgrading the Knowledge Base Server from a Previous Version of Meister Upgrading an OpenMake 6 Client to Meister Upgrading the Knowledge Base Server from OpenMake 6.41 Uninstalling Meister Getting Started With Workflows Testing Your Installation with Workflows The "Copy Example - Windows" Workflow The "System Info-Windows" Workflow The "Hello World - Windows" Workflow The "Metalworks ANT Build" Workflow Executing Your First Meister Build The "MetalWorks with Build Audit" Workflow Workflow Management What is a Workflow Components of Workflow Management Workflow Activity Remote Agents Workflow Editor Management Control Console Workflow Activity Chaining Workload Manager - OMSUBMIT Accelerating Workflows Configuring your Workflow to use Parallelized Mode Determining the Value of OMSUBMIT_MAX_USER_PROC Machine Recommendations for Parallelized Workflows Distributed Workload Processing Nested Workflows Reusable Workflows Defining Nested or Reusable Workflows Setting Up Your Workflow Setting Up Workflow Environment Variables Creating Workflow Activities Configuring Activities Chaining Workflow Activities Setting Up Workflow Notifications Real Time Monitoring Executing Workflows on a UNIX Platform Using the Workflow Editor History/Trends Tab Screen Monitor Tab Screen Activities Tab Screen Workflow Hierarchy Field Activity Information Field Command Field Configure Remote Agent Machine or Workflow Activity Environment Fields Workflow Activity Dependency Relationship Field Remote Agent Machine Details Field Configure Tab Screen General Information Field Execute Settings Field Adding Variables and Scripts Continuous Integration and Workflows Saving Workflows Running Command Line Workflows omcmdline.jar options Microsoft Team Build and Workflows Configuring Microsoft Team Build Executing your Build Definition Team Build Logging Post-Build Activities in Visual Studio .NET Projects The Management Control Console Management Control Console Navigation Executing on Demand Workflows from the Management Console Viewing Results from the Management Control Console Workflow Activity Plug-ins Pre-Defined Workflow Activity Plug-ins AccuRev Borland StarTeam CA CheckStyle Crap4J CVS Doxygen Email Emma FindBugs IBM Rational Japex JDepend JUnit Microsoft MKS Integrity NUnit OpenMake Meister OpenMake Mojo Perforce PMD Serena Subversion Creating Activity Plug-ins Using Meister Activity Plug-ins Generating Build Scripts bldmake options Executing Builds om Options OM Debugging Options Release or Debug Standardizing Environment Variables for Your Build Environment Variables Needed for Java Builds Use of multiple JAVA Compilers Modifying the Input or Output File Locations with Ant for Java Builds Errors and Warnings OM WARNING 343: ERROR 9: ERROR 10: ERROR 11: ERROR 11: ERROR 12: ERROR 15: ERROR 19: ERROR 29: ERROR 30: ERROR 37: ERROR 38: ERROR 40: ERROR 43: ERROR 49: ERROR 52: ERROR 53: ERROR 53: ERROR 54: ERROR 55: ERROR 56: ERROR 57: ERROR 58: ERROR 60: ERROR 65: ERROR 70: ERROR 71: ERROR 72: ERROR 73: ERROR 160: ERROR 161: ERROR 400: ERROR 401: ERROR 404: ERROR 404: ERROR 404: ERROR 405: ERROR 406: ERROR 406: ERROR 406: ERROR 408: ERROR 407: ERROR 501: ERROR 538: bldmake WARNING 10: ERROR 11: ERROR 42: ERROR 43: ERROR 44: ERROR 45: ERROR 48: ERROR 49: ERROR 50: ERROR 55: ERROR 56: ERROR 57: ERROR 58: ERROR 58: ERROR 60: ERROR 130: ERROR 131: ERROR 132: ERROR 133: ERROR 134: ERROR 390: ERROR 391: ERROR 392: ERROR 401: ERROR 404: ERROR 404: ERROR 404: ERROR 405: ERROR 406: ERROR 406: ERROR 406: ERROR 407: ERROR 408: omcmdline.jar Configuring Your Build Project Projects and Dependency Directories First Found Dependency Naming a Project Adding and Deleting Projects Naming a Project's Dependency Directories List Adding a New Dependency Directory List Name Adding Directories to your Dependency Directory List The REFDIR Variable Eclipse Plug-in Dependency Directories .NET and "Project" Dependency Directories Reusable Dependency Directories Ordering Dependency Directories Using Dependency Directory Lists for a Life Cycle Process Life Cycle Example Using Dependency Directory Lists for a Version Label Process Recommended Dependency Directory Setup Purchased 3rd Party Libraries Pre-Defined Compiler Dependency Directories Reusable Source Code Best Practices Using Build Services Build Service Attributes Creating Your Build Service Reviewing Pre-Defined Build Services Creating Your Custom Build Services Overview Attributes Detail Attributes Build Options Build Task Build Rules Wild Cards in Build Rules Phony Targets Using Build Methods How Build Methods are Executed Using Available Build Methods Ant and Java Build Methods Borland Build Methods Microsoft Build Methods IBM Rational and WebSphere Build Methods IBM AIX Build Methods HP Build Methods Microfocus Cobol Build Methods Oracle Build Methods Sun Solaris and Sybase Build Methods Weblogic Build Methods Other Build Methods z/OS Build Methods Writing Customized Build Methods Using the Build Method Editor Using Variables Variable Definitions Reusable Functions Openmake.pm FirstFoundInPath GetAnt unique Exclude( $pattern, @inlist ) GetCompiler, get_compiler FindFlag( $flagString, @possibleFlags ) GetFlag( $flagString, @possibleFlags ); GetExcludes( $Defines ) mkfulldir ( $Path ) CopyLocal( $FullPathDeps, $RelDeps, $toDir ) CopyExcludeLocal( $TargetDeps, $RelDeps, $toDir, @excludeExtensions ) ReadPackagesFile ( $TargetDeps) GetPackages ( @FileList ) GetPackageDeps ( $TargetDeps) GetClassPath ( $TargetDeps ) GetClasses ( $TargetDeps ) GetLocalClassPath ( $HOME_ENV ) GetSubTaskDeps ( $TargetDeps, $TargetRelDeps, $wanted_dir, $sub_task_ext ) GetAntIncludeXML ( @items ) WriteAntXML GenerateBillofMat( $BillofMat, $BillofMatRpt, $TargetFile ) GenerateFootPrint($FootPrint,$TargetFile,$FPSource,$FPObject,$CompilerFound,$FPCompilerArguments ) ExitScript( $RC, @doomedFiles ) Reusable Objects Openmake::File new(), new($FileName) set($FileName) getExt(), getE() getQuoted() getEscaped() getEscapedQuoted() getJEscaped() getJEscapedQuoted() setFile($FileName) getFile(), getFE() getF() getPFE() getDPF() getDPFE(), get() getAbsolute() getRelative() Openmake::FileList new, new( @list_of_files ) getExtension() getExt( @ExtensionList ) getExtList( @ExtensionList) getExtQuoted( @ExtensionList ) getExtQuotedList getAbsolute, getAbsolute($anchor_dir) getAbsoluteList, getAbsoluteList($anchor_dir) getQuotedAbsolute, getQuotedAbsolute( $anchor_dir ) Openmake::Log omLogger Openmake::SearchPath CleanSearchPath(@list_of_directories) new(@list_of_directories), new($string_of_directories) newFromScalar($string_of_directories) set(), set(@list_of_directories) setFromScalar(), setFromScalar($string_of_directories) get() getList() getString($PreText,$PostText) count() getQuoted() getQuotedList() getEscapedList() getEscapedQuotedList(), getQuotedEscapedList() getJEscapedList(), getJavaEscapedList() getJEscapedQuotedList(), getJavacEscapedQuotedList() push($dir) pop() mkdirs() unshift($dir) shift() Openmake::Path new(), new($full_path_string) get(), getDP() setVolume( $drive ), setDrive( $drive ) getVolume(), getDrive(), getD() setPath ( $path_string ) set( $path_string ) getPath(), getP() getQuoted() getEscaped() getEscapedQuoted() getJavacEscaped(), getJEscaped() getQuotedJavacEscaped(), getJEscapedQuoted() getEscapedPath() getPerlFileEscaped(), getPerlified() getAnchor() setAnchor(), setAnchor( $full_path_string ) getRelative() getQuotedRelative() isRelative() isAbsolute() getAbsolute() getQuotedAbsolute() CleanPath() Openmake::Snapshot LeftSnapshotOnly($after_snapshot, $before_snapshot) new(), new($directory, $file_extension) get() Openmake::BuildOption new($DebugFlags|$ReleaseFlags) update( $hashref) getBuildTasks getOptionGroups( $build_task) getBuildTaskFiles( $BuildTask, $OptionGroup, $all) getBuildTaskOption( $option_name, $build_task, $option_group) getBuildTaskOptions( $build_task, $option_group) Sample Build Method - The Visual Studio Compiler Section I: Initialization (Lines 1 - 18) Section II: Constructing the Compiler Step (Lines 19 - 34) Section III: Executing and Logging the Step (Lines 35 - 43) Creating and Managing Targets Defining Targets Adding Targets to Your Project Editing Targets Versioning Targets Copying Targets Target Overview Attributes Target Detail Attributes Target Directories and Project Dependency Directories Wildcards and File Dependencies Matching on * and ? Matching on ** Includes and Excludes Wild Card and Directory Dependencies Creating Targets for Java IDEs and Developer Tools Java Targets Creating a Java War Target Defining J2EE Deployment Descriptor Targets Automatically Generating Your Java Targets Setting Up the OpenMake Eclipse Target Generation Plug-in Mapping Meister Build Services to Eclipse Projects Setting Default Build Project Properties Creating Targets for C/C++ with the Eclipse CDT Configuring the Eclipse C Development Tools (CDT) Integration Prerequisites How the Integration Works Configuring the C and C++ Eclipse Project Properties Creating the C and C++ Eclipse Project Makefile Creating Targets for the Microsoft Visual Studio and .Net IDEs Creating Microsoft Visual Studio and .Net Targets Manually Generating Microsoft 2005 and 2008 Targets using the Add-In Setting Up the Visual Studio 2005 and 2008 Add-in Generating Microsoft Visual Studio 2008 Targets Generating Microsoft Visual Studio 2005 Targets Creating Microsoft .NET 2003 Targets Without the Add-in Setting Up omNet for Visual Studio 2003 Generating Targets using omNet Creating Microsoft Visual Studio 6.x C/C++ Targets Without the Add-in Creating Microsoft 6.x Visual Basic Targets Without the Add-in Performing Continuous Integration Setup of the Continuous Integration Server Remote Agents Defining Workflows for Local Continuous Integration Defining Workflows for Team Continuous Integration Configuring your Continuous Integration Continuous Integration Tab Screen Enhancing Your Continuous Integration Builds with Meister Improving Continuous Integration using Build Avoidance Improving Your Continuous Integration Build Pre-Commit Builds and Workflows Steps in a Pre-commit Workflow Setting up a Pre-commit Workflow in Meister Defining Dependency Directories to Support Pre-commit Builds Executing Pre-commit Builds Outside of Your IDE Using Build Avoidance with Pre-commit Builds Defining a Private Pre-commit Workflow Accelerating Your Builds with Meister Activating Build Avoidance Activating Parallelized Build Processing Machine Recommendations for Parallelized Builds Configuring Your Build Environment for Parallelized Builds Determining the Value of OMSUBMIT_MAX_USER_PROC Using Remote Agents Remote Agent Logs Distributing the Workload of the Workflow across multiple Remote Agents Setting up Workflow Activities to run on Remote Agents Running Remote Workflows From the Command Line and External Tools Defining Multi-Platform or Cross Language Workflows Managing Users and Groups Groups Default Administrator Group Administrator Group Access Privileges Default User Group User Group Access Privileges Creating Groups Managing Group Privileges Custom Access Privileges Managing Dependency Directory Privilege Managing Build Service Privilege Managing Public Workflow Privileges Managing Users with OM Admin Adding Users Adding or Removing Users from Groups Determining User Group Assignments Users Assigned to Multiple Groups Deleting Users Tracking Users Managing, Adding, and Deleting Users with LDAP Enabling and Modifying LDAP Configurations Using ompw Reports and Logs Reports and Logs Organization Standard OpenMake Meister or Mojo Max Reports Viewing Workflow Logs using the OM Reports Perspective Viewing Workflow Reports using the OM Reports Perspective Viewing Reports and Logs using the OM Workflow Perspective Viewing Reports and Logs from the Management Control Console Accessing the Management Control Console Standard Report Descriptions Workflow Activity Report Workflow History Report Pubic or Private Bill of Materials Public or Private Build Differences Users by Groups Defined User Privileges Report Workflow Activity Application Life Cycle Plug-in Reports Build Services Options Dependency Directory Usage by Project Meister Insight Activating Meister Insight Build Audits with Build Forensics Footprinting - Embedding the DNA Impact Analysis with Dependency Discovery OPENMAKE® SOFTWARE LICENSE AGREEMENT