CONTENTS Title Page Copyright Page Preface 1 Getting Started 1.1 What You Get in the ASD/SEE Toolkit 1.2 ASD/SEE FileView 1.3 User Workspace 1.4 Getting Help 2 Discussing and Tracking Design Information 2.1 Choosing a Moderator 2.2 Setting Up a Conference 2.3 Maintaining a Conference 2.4 Invoking Design Communication Notes 2.5 Discussing and Recording Design Decisions 2.6 Design Communication Utilities 2.7 Retrieving Notes Daily 2.8 Retrieving Notes Hourly 2.9 Extracting Topics by Keyword 2.10 Extracting Topics by Number 2.11 Creating a Directory Listing of Topic Titles 2.12 Archiving a Conference 3 Controlling and Building Configurations 3.1 Four Tasks of Configuration Management 3.2 Invoking SQL PCMS 3.3 Controlling Versions 3.4 Controlling Changes 3.5 Controlling Configurations 3.6 Baseline Overview 3.7 Assigning CIINs for Use by Baseline Prep 3.8 Customizing the Configuration Data File for Your System 3.9 Customizing the Image Data File for Your System 3.10 Special Considerations for Baseline Prep 3.11 Using the ASD/SEE Toolkit Baseline Prep Functions 3.12 Checking the Results of the ASD/SEE Toolkit Baseline Prep Functions 3.13 Creating a Baseline With the SQL PCMS Commands 3.14 Customizing the General Baseline Prep Procedures 3.15 Customizing the Default Baseline Prep Procedures 3.16 Creating New Baseline Prep Tool Procedures 3.17 Restoring Information from PCMS 4 Identifying Components 4.1 Configuration Item Identification Number (CIIN) Defined 4.2 A Sample CIIN with the Map Explaining its Code 4.3 Steps to Store a CIIN in an SQL PCMS Database 4.4 Accessing CIIN Management Functions 4.5 Accessing the CIIN Assignment Function 4.6 Displaying and Selecting Number Maps 4.7 Uploading a Number Map 4.8 Downloading a Number Map 4.9 Exporting the CIINs of a Selected Map 4.10 Changing an Existing Number Map 4.11 Adding Fields to a Number Map 4.12 Allocating CIINs From a Number Map 4.13 Creating a Number Map 4.14 Deleting a Number Map 4.15 The Site Prefix for File Names 4.16 Assigning/Defining Each CIIN 4.17 Assigning/Defining Each CIIN Continued 5 Storing Development and Support Information 5.1 Understanding SQL PCMS and SDF 5.2 Invoking SDF Management 5.3 Selecting a Lifecycle State or a Revision of an SDF Object 5.4 Viewing an SDF Object 5.5 Updating an SDF Object 5.6 Editing an SDF Object 5.7 Creating an SDF Object 5.8 Reserving an SDF Object 5.9 Unreserving an SDF Object 5.10 Fetching an SDF Object 5.11 Replacing an SDF Object 5.12 Customizing SDF Management: Overview 5.13 Customizing the SDF Management Functions 5.14 Customizing the SDF Management Lists 5.15 ASD/SEE Generic Control Plan Summary: Product-Item Type Lifecycles 5.16 ASD/SEE Generic Control Plan Summary: Objects, Tools, and Storage 6 Using Metrics Management 6.1 Metrics Environment 6.2 Invoking Metrics from FileView and DCL 6.3 Collecting Data: General Information 6.4 Collecting Data: Reference Tables 6.5 Collecting Data: Opening a Table 6.6 Collecting Data: Entering Data in a Table 6.7 Collecting Data: Saving a Table 6.8 Collecting Data: Creating Historical Data (Snapshots) 6.9 Protection and Access Modes of Tables and Folders 6.10 Metrics Reports: General Information 6.11 Metrics Reports: Generating a Report from FileView 6.12 Metrics Reports: Requirements Stability Report (SRS) - Source Information 6.13 Requirements Stability Report (SRS) - Explanation 6.14 Metrics Reports: Requirements Stability Report (IRS) - Source Information 6.15 Requirements Stability Report (IRS) - Explanation 6.16 Metrics Reports: SDD Design Stability Report - Source Information 6.17 SDD Design Stability Report - Explanation 6.18 Metrics Reports: Requirements Development Progress Report - Source Information 6.19 Requirements Development Progress Report - Explanation 6.20 Metrics Reports: Preliminary Design Progress Report - Source Information 6.21 Preliminary Design Progress Report - Explanation 6.22 Metrics Reports: Detailed Design Progress Report - Source Information 6.23 Detailed Design Progress Report - Explanation 6.24 Metrics Reports: Coding and Unit Test Progress Report - Source Information 6.25 Coding and Unit Test Progress Report - Explanation 6.26 Metrics Reports: Software Integration Progress Report - Source Information 6.27 Software Integration Progress Report - Explanation 6.28 Metrics Reports: FQT (Formal Qualification Test) Test Procedures Dry Run Progress Report - Source Information 6.29 FQT Test Procedures Dry Run Progress Report - Explanation 6.30 Metrics Reports: Budget Status Report - Source Information 6.31 Budget Status Report - Explanation 6.32 Metrics Reports: Software Development Personnel Report - Source Information 6.33 Software Development Personnel Report - Explanation 6.34 Metrics Reports: Software Size Report - Source Information 6.35 Software Size Report - Explanation 6.36 Metrics Reports: Target Processor Throughput Report - Source Information 6.37 Target Processor Throughput Report - Explanation 6.38 Metrics Reports: Target Processor Memory Utilization Report - Source Information 6.39 Target Process Memory Utilization Report - Explanation 6.40 Metrics Reports: Data Bus Throughput Utilization Report - Source Information 6.41 Data Bus Throughput Utilization Report - Explanation 6.42 Metrics Reports: Software Target Processor SLOCs/Memory Expansion Status Report - Source Information 6.43 Software Target Processor SLOCs/Memory Expansion Status Report - Explanation 6.44 Metrics Reports: Software Target Processor Code/Data to Memory Expansion Report - Source Information 6.45 Software Target Processor Code/Data to Memory Expansion Report - Explanation 6.46 Metrics Reports: Process Compliance Report - Source Information 6.47 Process Compliance Report - Explanation 6.48 Metrics Reports: Software Change Notices (SCN) Report - Source Information 6.49 Software Change Notices Report - Explanation 6.50 Metrics Reports: Viewing, Printing, and Saving Metrics Reports 6.51 Metrics Reports: Scheduling Single Reports and Sets of Reports 6.52 Customizing Metrics Reports: General Information 6.53 Customizing Metrics Reports: Blueprints 6.54 Customizing Metrics Reports: Calc Templates 6.55 Customizing Metrics Reports: Report Definitions 6.56 Customizing Reports: DECquery Macros 6.57 Customizing Metrics Data: General Information 6.58 Analyzing Data - Creating Subsets 6.59 Analyzing Data - Changing Selection Criteria 6.60 Rollups: General Information 6.61 Rollups: Based on One Table 6.62 Rollups: Based on Many Tables 6.63 Source Lines of Code (SLOC) Counter 7 Defining, Tracking, and Reporting Interfaces 7.1 What Does the IDT Do? 7.2 Accessing and Exiting the IDT 7.3 Navigating Within the IDT 7.4 Building a Block Diagram (BD): Entering Data in the Physical Interface 7.5 BD Steps 1 and 2: Naming a Model 7.6 Limiting Access to a Model 7.7 BD Step 3: Naming a Block Diagram 7.8 BD Step 4A: Naming a Bus or Cable 7.9 BD Step 4B: Naming a Bus or Cable 7.10 BD Step 5: Naming a Block Diagram Interface 7.11 BD Step 6: Modifying the Interface Record 7.12 BD Steps 7 and 8: CI Connection List 7.13 BD Steps 9 and 10: Entering Items in the Configuration Item List 7.14 BD Step 11: Making the Bus/Cable Connection to an Item 7.15 Building a Data Flow Diagram (DFD): Entering Data in the Logical Interface 7.16 DFD Steps 1 Through 3: Naming a Data Flow Diagram (DFD) 7.17 DFD Step 4: Entering Data Flow Information 7.18 DFD Step 5: Modifying the Interface Record 7.19 DFD: Fields in the Interface Record 7.20 Modifying a Signal in an Interface Record: Digital Bus Type 7.21 Modifying a Signal in an Interface Record: Analog Bus Type 7.22 DFD Steps 6 Through 8: Modifying the Node List and the Node Record 7.23 Verifying Information Copied from Cadre Team work 7.24 Migrating Information from Cadre Team work to the IDT 7.25 Creating Reports in the IDT 7.26 Modifying the Report Record 7.27 Creating Signal Tables 7.28 Entering Data in Signal Tables 7.29 Import Data (I) 7.30 Export Data (X) A Full Names of Metrics Management Fields B Metrics Management Error Messages C Tables in Metrics Management Folder D Fields in Metrics Management Tables Glossary EXAMPLES 6-1 Scheduling Reports 6-2 Example of DECquery Macro FIGURES 1 Training Menu 1-1 Choosing a Job Function 1-2 Displaying Available Tools 1-3 Workspace Directories 1-4 FileView Help Option 1-5 Online Help 2-1 Choosing a Moderator 2-2 Maintaining a Conference 2-3 Invoking Design Communication Notes 2-4 Design Communication Notes 2-5 Suggested Conference 2-6 Design Communication Utilities Menu 2-7 Retrieving Notes Daily 2-8 Retrieving Notes Hourly 2-9 Extracting Notes by Keyword 2-10 Extracting Notes by Number 2-11 Creating a Directory Listing 2-12 Archiving a VAX Notes Conference 3-1 Four Tasks of Configuration Management 3-2 Invoking SQL PCMS 3-3 Version Control 3-4 Example of a Change Control Process 3-5 Creating a Baseline 3-6 Example of a Configuration Data File 3-7 Default Image File for Baseline Prep Functions 3-8 Baseline Prep Menu Path 3-9 Sample Mail Message Sent by Baseline Prep Functions 3-10 ASD/SEE Toolkit Directories 4-1 Sample Number Map Defining the Code in a CIIN 4-2 Sample CIIN Using the Code in Figure 4-1 4-3 Selecting ASD/SEE Configuration Management 4-4 Choosing CIIN Management 4-5 Choosing CIIN Assignment 4-6 Number Map Dialog Box 4-7 Uploading a Number Map 4-8 Downloading a Number Map 4-9 Exporting a CIIN of a Selected Map 4-10 Modify Map Dialog Box 4-11 Modify Field Dialog Box 4-12 Add Field 4-13 Create Field 4-14 Allocating a Number Map 4-15 Creating a Number Map 4-16 Deleting a Number Map 4-17 CIIN Assignment 4-18 CIIN Assignment: Define 4-19 CIIN Assignment: Options 5-1 SDF Hierarchy 5-2 Invoking SDF Management 5-3 SDF Management Dialog Box 5-4 SDF Lifecycle/Revision Options 5-5 Viewing an SDF Object 5-6 Updating an SDF Object 5-7 Editing an SDF Object 5-8 Creating an SDF Object 5-9 Reserving an SDF Object 5-10 Unreserving an SDF Object 5-11 Fetching an SDF Object 5-12 Replacing an SDF Object 5-13 SDF File Locations 5-14 Example of ASDSEE$DATA:ASDSEE$SDF_OBJECTS.DAT 6-1 Overview of Metrics Management 6-2 Choosing Metrics from FileView 6-3 DECquery: Open Window 6-4 Metrics Management in a DECdecision Window 6-5 Error Message Example 6-6 Snapshot View 6-7 FileView of ASD/SEE Metrics Report Generation 6-8 Example of a Requirements Stability Report (SRS) 6-9 Example of a Requirements Stability Report (IRS) 6-10 Example of an SDD Design Stability Report 6-11 Example of a Requirements Development Progress Report 6-12 Example of a Preliminary Design Progress Report 6-13 Example of a Detailed Design Progress Report 6-14 Example of a Coding and Unit Test Progress Report 6-15 Example of a Software Integration Progress Report 6-16 Example of a FQT Test Procedures Dry Run Progress Report 6-17 Example of a Budget Status Report 6-18 Example of a Software Development Personnel Report 6-19 Example of a Software Size Report 6-20 Example of a Target Processor Throughput Report 6-21 Example of a Target Process Memory Utilization Report 6-22 Example of a Data Bus Throughput Utilization Report 6-23 Example of a Software Target Processor SLOCs/Memory Expansion Status Report 6-24 Example of a Software Target Processor Code/Data to Memory Expansion Report 6-25 Example of a Process Compliance Report 6-26 Example of a Software Change Notices Report 6-27 Print Menu 6-28 Customizing a Report 6-29 Customizing a Blueprint 6-30 Customizing a Calc Template 6-31 Customizing a Report Definition 6-32 Customizing Macro Access Example 6-33 General Customizing 6-34 DECquery: Export Window 6-35 SLOC Example 7-1 Menu Hierarchy of the IDT 7-2 Accessing the IDT Through the ASD/SEE Toolkit FileView Menu 7-3 Select IDT Function Menu 7-4 Hierarchy: Menus for Building a Block Diagram (BD) 7-5 Hierarchy: Model List 7-6 Model List Menu 7-7 Model Access List Menu 7-8 Hierarchy: Interface Block Diagram List 7-9 Interface Block Diagram List Menu 7-10 Hierarchy: Bus/Cable List 7-11 Bus/Cable List Menu 7-12 Bus Type List Menu 7-13 Block Diagram Graphic Representation 7-14 Hierarchy: Interface List 7-15 Interface List Menu 7-16 Hierarchy: Modify Interface Record - Block Diagram 7-17 Modify Interface Record Menu - Block Diagram 7-18 Hierarchy: CI Connection List 7-19 CI Connection List Menu 7-20 Hierarchy: Configuration Item List 7-21 Configuration Item List Menu 7-22 Configuration Item List Graphic 7-23 Hierarchy: Bus/Cable Connection List 7-24 Bus/Cable Connection List Menu 7-25 Bus/Cable Connection List Graphic 7-26 Hierarchy: Menus for Building a Data Flow Diagram (DFD) 7-27 Hierarchy: Model List 7-28 Hierarchy: Data Flow Diagram List 7-29 Data Flow Diagram List Menu 7-30 Hierarchy: Data Flow List 7-31 Data Flow List Menu 7-32 Graphic of Accel. Messages 7-33 Hierarchy: Modify Interface Record - DFD 7-34 Modify Interface Record Menu - DFD 7-35 Hierarchy: Node List 7-36 Hierarchy: Modify Node Record 7-37 Modify Node Record Menu 7-38 Hierarchy: External Tool Logical Interface Definition 7-39 Report List Menu 7-40 Component Identification Item List Menu 7-41 Modify Report Record Menu 7-42 Create Bus Type Table 7-43 Import Data Prompt at Select IDT Function Menu 7-44 Export IDT Data Screen TABLES 1 Digital and Third-Party Documents 1-1 DEC ASD/SEE Toolkit for VMS Tools 1-2 Additional Software Tools 1-3 Workspace Verbs 2-1 Suggested Keyword Categories and Sample Keywords 2-2 Steps for Moving a Note to Another Conference 2-3 Steps for Dividing a Conference 2-4 Steps for Merging Conferences 3-1 Information Stored by Baseline Prep Functions 3-2 CIIN Assignment Conventions 3-3 Format of the Configuration Data File 3-4 Format of the Image Data File 3-5 Privileges Required to Use a Baseline Prep Function 3-6 Baseline Prep . . . Controls 3-7 General Baseline Procedure Files 3-8 Baseline Prep Procedure Files for Default Tools 3-9 Baseline Prep Functions Summary 4-1 Choices for Field Types 4-2 CIIN Assignment: Define 5-1 SQL PCMS and SDF Terms 5-2 Command Procedures 5-3 Parameters for SDF Management Functions 5-4 ASD/SEE Generic Control Plan: Product-Item Type Lifecycles 5-5 ASD/SEE Generic Control Plan Summary: Objects, Tools, and Storage 6-1 ASD/SEE Metrics COLLECTION and REPORTING Folders 6-2 Levels in Which Data is Maintained 6-3 Opening a Metrics Table 6-4 Entering Data in a Table 6-5 Saving Data in a Table 6-6 Creating, Naming, and Accessing a Snapshot from FileView 6-7 Default Protections and Access Modes 6-8 Metrics Management: Standard Reports 6-9 Requirements Stability Report (SRS) Prompts 6-10 Requirements Stability Report (SRS) Logical Names 6-11 Explanation of Requirements Stability (SRS) Report 6-12 Requirements Stability Report (IRS) Prompts 6-13 Requirements Stability Report (IRS) Logical Names 6-14 Explanation of Requirements Stability (IRS) Report 6-15 SDD Design Stability Report Prompts 6-16 SDD Design Stability Report Logical Names 6-17 Explanation of SDD Design Stability Report 6-18 Requirements Development Progress Report Prompts 6-19 Requirements Development Progress Reports Logical Names 6-20 Explanation of Requirements Development Progress Report 6-21 Preliminary Design Progress Report Prompts 6-22 Preliminary Design Progress Report Logical Names 6-23 Explanation of Preliminary Design Progress Report 6-24 Detailed Design Progress Report Prompts 6-25 Detailed Design Progress Report Logical Names 6-26 Explanation of Detailed Design Progress Report 6-27 Coding and Unit Test Progress Report Prompts 6-28 Coding and Unit Test Progress Report Logical Names 6-29 Explanation of Coding and Unit Test Progress Report 6-30 Software Integration Progress Report Prompts 6-31 Software Integration Progress Report Logical Names 6-32 Explanation of Software Integration Progress Report 6-33 FQT Test Procedures Dry Run Progress Report Prompts 6-34 FQT Test Procedures Dry Run Progress Report Logical Names 6-35 Explanation of FQT Test Procedures Dry Run Progress Report 6-36 Budget Status Report Prompts 6-37 Budget Status Report Logical Names 6-38 Explanation of Budget Status Report 6-39 Software Development Personnel Report Prompts 6-40 Software Development Personnel Report Logical Names 6-41 Explanation of Software Development Personnel Report 6-42 Software Size Report Prompts 6-43 Software Size Report Logical Names 6-44 Explanation of Software Size Report 6-45 Target Processor Throughput Report Prompts 6-46 Target Processor Throughput Report Logical Names 6-47 Explanation of the Target Processor Throughput Report 6-48 Target Processor Memory Utilization Report Prompts 6-49 Target Process Memory Utilization Report Logical Names 6-50 Explanation of Target Process Memory Utilization Report 6-51 Data Bus Throughput Utilization Report Prompts 6-52 Data Bus Throughput Utilization Report Logical Names 6-53 Explanation of Data Bus Throughput Utilization Report 6-54 Software Target Processor SLOCs/Memory Expansion Status Report Prompts 6-55 Software Target Processor SLOCs/Memory Expansion Status Report Logical Names 6-56 Software Target Processor Code/Data to Memory Expansion Report Prompts 6-57 Software Target Processor Code/Data to Memory Expansion Report Logical Names 6-58 Process Compliance Report Prompts 6-59 Process Compliance Report Logical Names 6-60 Explanation of Process Compliance Report 6-61 Software Change Notices Report Prompts 6-62 Software Change Notice (SCN) Report Logical Names 6-63 Explanation of Software Change Notices Report 6-64 Viewing a Report 6-65 Steps Creating a New Base Metric Table 6-66 Creating a Subset from One Table 6-67 Creating a Subset from Many Tables 6-68 Steps in Changing Selection Criteria for Analysis of Data 6-69 Example of Source of Information for a Rollup 7-1 IDT Editing Functions 7-2 Steps in Building a Block Diagram (BD) 7-3 Steps in Building a Data Flow Diagram (DFD) 7-4 Steps to Modify an Interface Record: Signals - Digital Bus Type 7-5 Steps to Modify an Interface Record: Signals - Analog Bus Type 7-6 Steps to Verify Cadre Team work 7-7 Steps to Migrate Information from Cadre Team work to the IDT 7-8 Confirming Differences When Migrating from Team work to the IDT 7-9 Creating Signal Tables 7-10 Steps in Entering Information in a Signal/Message Table C-1 Tables in COMPUTER_RESOURCE_UTILZTN, Computer Resource Utilization Folder C-2 Tables in PROCESS_COMPLIANCE, Process Compliance Folder C-3 Tables in REFERENCE_TABLES, Standard Reference Tables Folder C-4 Tables in REQUIREMENT_DESIGN_STABILITY, Requirements and Design Stability Folder C-5 Tables in SCN_STATUS, Software Change Notice Status Folder C-6 Tables in SOFTWARE_SIZE, Software Size Folder C-7 Tables in SW_DEVELOPMENT_PERSONNEL, Software Development Personnel Staffing Profile Folder C-8 Tables in SW_DEVELOPMENT_PROGRESS, Software Development Progress Folder D-1 Fields in BDGT_STATUS_ACTLS Tables D-2 Fields in BDGT_STATUS_PLNS Tables D-3 Fields in CDNG_AND_UNIT_TEST_ACTLS Tables D-4 Fields in CDNG_AND_UNIT_TEST_PLNS Tables D-5 Fields in CSCI_BLCK_IDS Tables D-6 Fields in CSCI_IDS Tables D-7 Fields in CSCI_SW_SIZE_ESTS Tables D-8 Fields in CSCI_SW_SIZE_ACTLS Tables D-9 Fields in CSC_IDS Tables D-10 Fields in CSC_SW_SIZE_EST Tables D-11 Fields in CSC_SW_SIZE_ACTLS Tables D-12 Fields in CSC_TIME_PERIOD_TOTLS Tables D-13 Fields in CSU_IDS D-14 Fields in CSU_SW_SIZE_EST Tables D-15 Fields in CSU_SW_SIZE_ACTLS Tables D-16 Fields in DATA_BUS Tables D-17 Fields in DATA_BUS_RSRV_PLNS Tables D-18 Fields in DATA_BUS_THRUPUT_UTIL Tables D-19 Fields in DATA_ITEM_ACRNYMS Tables D-20 Fields in DSGN_STBLTY Tables D-21 Fields in DTLD_DSGN_ACTLS Tables D-22 Fields in DTLD_DSGN_PLNS Tables D-23 Fields in FQT_DRY_RUN_ACTLS Tables D-24 Fields in FQT_DRY_RUN_PLNS Tables D-25 Fields in PRLMNRY_DSGN_ACTLS Tables D-26 Fields in PRLMNRY_DSGN_PLNS Tables D-27 Fields in PROCS_CMPLNC Tables D-28 Fields in PROCS_CMPLNC_DEFNCIES Tables D-29 Fields in PROCS_DEFNCY_TYPES Tables D-30 Fields in PROCS_TYPES Tables D-31 Fields in REQMTS_DVLPMT_ACTLS Tables D-32 Fields in REQMTS_DVLPMT_PLNS Tables D-33 Fields in REQMTS_STBLTY Tables D-34 Fields in SW_CHNG_NOTICES Tables D-35 Fields in SW_CHNG_NOTICE_ERRS Tables D-36 Fields in SW_CHNG_NOTICE_ORIGTN_TYPES Tables D-37 Fields in SW_DVLPMT_PRSNL_ACTLS Tables D-38 Fields in SW_DVLPMT_PRSNL_PLNS Tables D-39 Fields in SW_INTGRTN_ACTLS Tables D-40 Fields in SW_INTGRTN_PLNS Tables D-41 Fields in SW_SIZE Tables D-42 Fields in TRGT_PROCSR Tables D-43 Fields in TRGT_PROCSR_MEMRY_UTIL Tables D-44 Fields in TRGT_PROCSR_RSRV_PLNS Tables D-45 Fields in TRGT_PROCSR_THRUPUT_UTIL Tables D-46 Fields in UOMS Tables D-47 Fields in WORK_PKG_IDS Tables