Beruflich Dokumente
Kultur Dokumente
CSGDM-10.0-MFUG-2004-04-30
The information in this documentation is furnished for your use only, and no disclosure or use of any portion of these materials may be made without the express, written consent of CSG Systems International, Inc. ("CSG"). The information is subject to change without notice, and CSG assumes no responsibility or liability for any errors or inaccuracies that may appear in this manual. This documentation is the property of CSG and its licensors, and it contains confidential and proprietary information of CSG. Copying, modifying, or distributing this documentation in violation of a license agreement, confidentiality agreement, United States Copyright Law, or the copyright law of any applicable foreign jurisdiction is expressly prohibited. CSG Data Mediation, CSG System Manager, CSG Systems, and the CSG Logo are registered trademarks or trademarks of CSG Systems International, Inc. and its affiliates in the United States and other countries. All other brand and product names are trademarks, service marks, registered trademarks, or registered service marks of their respective owners. Third-Party Software: This CSG product may contain or be distributed with third-party software. For information on any applicable third-party software, please refer to the Copyright Notices file that is bundled with your software. Portions of this software are copyrighted by DataDirect Technologies, 1991-2002. Copyright 2004 CSG Systems International, Inc. All rights reserved.
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Notational Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x Additional Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii 1 About Common Features Working with Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2 Working with Globals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 Working with Value Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 Working with Table Lookup Value Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Working with External Database Access Definitions . . . . . . . . . . . . . . . . . . . . . . .6 Accessing External Database Access Definitions . . . . . . . . . . . . . . . . . . . . . . . . . .9 Building Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Working with Secondary Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Working with Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Working with Field Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 Working with Record Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 Working with Record-to-Module Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 Working with Module Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 Working with Justification and Padding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 2 Mediation Feature Set Application Pages Mediation Features Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 Open the Mediation Features Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Select an Active Mediation Feature Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Mediation Feature Sets Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Open the Mediation Feature Sets Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 Go to a New Mediation Feature Set Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 Go to an Existing Mediation Feature Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32 Mediation Feature Set Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Open a New Mediation Feature Set Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34 Open an Existing Mediation Feature Set Page . . . . . . . . . . . . . . . . . . . . . . . . . . .35 Create a New Mediation Feature Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36 Update a Mediation Feature Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Open the Expression Page from the Action Fields Tables . . . . . . . . . . . . . . . . . .40 Open the Expression Page from the Data Fields Tables . . . . . . . . . . . . . . . . . . . .41 Create an Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42 Update an Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
CSGDM-10.0-MFUG-2004-04-30
iv
Contents
Secondary Key Mapping Page (Correlation File Conversion and Correlation Store Conversion) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Open a New Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Open an Existing Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . .48 Create a Secondary Key Mapping Expression . . . . . . . . . . . . . . . . . . . . . . . . . . .49 Update a Secondary Key Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50 3 About the Package Manager Application Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52 Accessing the Package Manager Application Pages . . . . . . . . . . . . . . . . . . . . . . .54 Setting Up a Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57 Transferring File and Block Headers/Trailers . . . . . . . . . . . . . . . . . . . . . . . . . . . .58 Working with Record Blocking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59 Working with Record Structure Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62 Auditing a Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64 Installing a Package in the Application Stream . . . . . . . . . . . . . . . . . . . . . . . . . . .65 4 Package Manager Application Pages Package Manager Applications Page. . . . . . . . . . . . . . . . . . . . . . . . . . 69 Open the Package Manager Applications Page . . . . . . . . . . . . . . . . . . . . . . . . . . .70 Go to the Create a New Package Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Go to the Package Manager Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72 Create a New Package Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Create a New Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78 Package Manager Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Open the Package Manager Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82 Go to the Package Manager Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . .83 Go to the Package Manager Record Blocking Page . . . . . . . . . . . . . . . . . . . . . . .84 Go to the Package Manager Record Structure Mapping Page. . . . . . . . . . . . . . . .85 Package Manager Application Page. . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Open the Package Manager Application Page. . . . . . . . . . . . . . . . . . . . . . . . . . . .89 Update the Package Manager Application Page . . . . . . . . . . . . . . . . . . . . . . . . . .90 Audit the Package Manager Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . .91 Go to Another Page in the Package Manager Application . . . . . . . . . . . . . . . . . .92 Package Manager Record Blocking Page . . . . . . . . . . . . . . . . . . . . . . 93 Open the Package Manager Record Blocking Page . . . . . . . . . . . . . . . . . . . . . . .95 Update the Package Manager Record Blocking Page . . . . . . . . . . . . . . . . . . . . . .96 Package Manager Record Structure Mapping Page . . . . . . . . . . . . . . 99 Open the Package Manager Record Structure Mapping Page . . . . . . . . . . . . . . .101 Update the Package Manager Record Structure Mapping Page . . . . . . . . . . . . .102
CSGDM-10.0-MFUG-2004-04-30
About File Format Conversion Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104 Accessing the File Format Conversion Pages . . . . . . . . . . . . . . . . . . . . . . . . . . .105 Setting Up a File Format Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108 Understanding the Three Types of File Format Conversions . . . . . . . . . . . . . . .110 Working with Cross-Level Mappings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111 Working with Modules and File Format Conversion . . . . . . . . . . . . . . . . . . . . .112 Working with Dummy Records and Modules . . . . . . . . . . . . . . . . . . . . . . . . . . .113 Installing a File Format Conversion Definition in the Application Streams . . . .114 Working Exception Handling and File Format Conversion . . . . . . . . . . . . . . . .115 Understanding the Data Process Flow and File Format Conversion . . . . . . . . . .116
File Format Conversion Application Pages File Format Conversion Applications Page . . . . . . . . . . . . . . . . . . . 119 Open the File Format Conversion Applications Page . . . . . . . . . . . . . . . . . . . . .120 Go to a New File Format Conversion Application Page . . . . . . . . . . . . . . . . . . .121 Go to an Existing File Format Conversion Application Page . . . . . . . . . . . . . . .122 File Format Conversion Application Page . . . . . . . . . . . . . . . . . . . . 123 Open an Existing File Format Conversion Application Page . . . . . . . . . . . . . . .125 Open a New File Format Conversion Application Page . . . . . . . . . . . . . . . . . . .126 Create a File Format Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127 Update a File Format Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128 Value Lists Page (File Format Conversion) . . . . . . . . . . . . . . . . . . . 129 Open the Value Lists Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130 Go to a New Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131 Go to an Existing Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132 Go to Another Page in the File Format Conversion . . . . . . . . . . . . . . . . . . . . . .133 Value List Page (File Format Conversion) . . . . . . . . . . . . . . . . . . . . 135 Open a New Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137 Open an Existing Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138 Create a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139 Update a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140 Add a Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141 Update a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142 Table Lookup Value Lists Page (File Format Conversion) . . . . . . . 143 Open the Table Lookup Value Lists Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 Go to a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .145 Go to an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .146
CSGDM-10.0-MFUG-2004-04-30
vi
Contents
Table Lookup Value List Page (File Format Conversion). . . . . . . . . 147 Open a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .149 Open an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .150 Create a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151 Update a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152 Add a Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153 Update a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154 Field Mappings Page (File Format Conversion) . . . . . . . . . . . . . . . . 155 Open the Field Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156 Go to an Existing Field Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157 Field Mapping Page (File Format Conversion) . . . . . . . . . . . . . . . . . 159 Open the Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160 Add a Mapping Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161 Update a Mapping Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162 Record Mappings Page (File Format Conversion) . . . . . . . . . . . . . . 163 Open the Record Mappings Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164 Go to a New Record Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165 Go to an Existing Record Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166 Record Mapping Page (File Format Conversion) . . . . . . . . . . . . . . . 167 Open a New Record Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169 Open an Existing Record Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170 Create a New Record Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171 Update a Record Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172 Secondary Key Mappings Page (File Format Conversion) . . . . . . . 173 Open the Secondary Key Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174 Go to a New Secondary Key Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . .175 Go to an Existing Secondary Key Mappings Page . . . . . . . . . . . . . . . . . . . . . . .176 Secondary Key Mapping Page (File Format Conversion) . . . . . . . . 177 Open a New Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .179 Open an Existing Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . .180 Create a Secondary Key Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181 Update a Secondary Key Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182 Rename a Secondary Key Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183 Block Header/Trailer Mappings Page. . . . . . . . . . . . . . . . . . . . . . . . . 185 Open the Block Header/Trailer Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . .187 Go to an Existing Record Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188 Go to a New Record Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
CSGDM-10.0-MFUG-2004-04-30
vii
File Header/Trailer Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . 191 Open the File Header/Trailer Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . .193 Go to the Record Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194 Module Mappings Page (File Format Conversion). . . . . . . . . . . . . . 195 Open the Module Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197 Go to a New Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198 Go to an Existing Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199 Module Mapping Page (File Format Conversion). . . . . . . . . . . . . . . 201 Open a New Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203 Open an Existing Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204 Update the Module Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205 7 About the Correlation Applications Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208 Accessing the Correlation Conversion Pages . . . . . . . . . . . . . . . . . . . . . . . . . . .210 Working with Correlation Store Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . .212 Working with Correlation File Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . .213 Working with Correlation IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215 Defining Correlation Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216 Working with Correlation Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 Working with Control Data Fields and Control Action Fields . . . . . . . . . . . . . .222 Working with Output File Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223 Working with Output Record Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . .225 Working with CORFILTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226 8 Correlation Mediation Features Application Pages Correlation Applications Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 Open the Correlation Applications Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230 Go to the Correlation Store Conversions Page . . . . . . . . . . . . . . . . . . . . . . . . . .231 Go to the Correlation File Conversions Page . . . . . . . . . . . . . . . . . . . . . . . . . . .232 Go to the Correlation IDs Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233 9 Correlation ID Application Pages Correlation IDs Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237 Open the Correlation IDs Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238 Go to a New Correlation ID Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239 Go to an Existing Correlation ID Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .240
CSGDM-10.0-MFUG-2004-04-30
viii
Contents
Correlation ID Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241 Open a New Correlation ID Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .242 Open an Existing Correlation ID Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243 Create a Correlation ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244 Update a Correlation ID. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245 Value Lists Page (Correlation ID Conversion). . . . . . . . . . . . . . . . . . 247 Open the Value Lists Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248 Go to a New Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249 Go to an Existing Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250 Go to Another Page within the Correlation ID Conversion. . . . . . . . . . . . . . . . .251 Value List Page (Correlation ID Conversion). . . . . . . . . . . . . . . . . . . 253 Open a New Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254 Open an Existing Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255 Create a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256 Update a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257 Add a List Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258 Update a List Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259 Table Lookup Value Lists Page (Correlation ID Conversion) . . . . . 261 Open the Table Lookup Value Lists Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .262 Go to a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .263 Go to an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .264 Table Lookup Value List Page (Correlation ID Conversion) . . . . . . 265 Open a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .267 Open an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .268 Create a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269 Update a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270 Add a Table Lookup Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271 Update a Table Lookup Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .272 Output File Management Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273 Open the Output File Management Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274 Update the Output File Management Settings . . . . . . . . . . . . . . . . . . . . . . . . . . .275 Output Record Management Page . . . . . . . . . . . . . . . . . . . . . . . . . . . 277 Open the Output Record Management Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .278 Update the Output Record Management Settings . . . . . . . . . . . . . . . . . . . . . . . .279 Correlation Conversion Assignments Page . . . . . . . . . . . . . . . . . . . 281 Open the Correlations Conversion Assignments Page . . . . . . . . . . . . . . . . . . . .282 Assign Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283 Unassign Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284
CSGDM-10.0-MFUG-2004-04-30
ix
Correlation Conversion Application Manager Page . . . . . . . . . . . . 285 Open the Correlation Conversion Application Manager Page . . . . . . . . . . . . . .287 Update Assigned Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288 Source Assignments Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289 Open the Source Assignments Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290 Assign Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291 Unassign Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .292 Output File and Record Management Expression Pages . . . . . . . . 293 Open the Output File Management Expression Page . . . . . . . . . . . . . . . . . . . . .295 Open the Output Record Management Expression Page. . . . . . . . . . . . . . . . . . .297 Create an Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299 10 Correlation File Conversion Application Pages Correlation File Conversions Page . . . . . . . . . . . . . . . . . . . . . . . . . . 303 Open the Correlation File Conversions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . .304 Go to a New Correlation File Conversion Page . . . . . . . . . . . . . . . . . . . . . . . . .305 Go to an Existing Correlation File Conversion Page. . . . . . . . . . . . . . . . . . . . . .306 Correlation File Conversion Page . . . . . . . . . . . . . . . . . . . . . . . . . . . 307 Open a New Correlation File Conversion Page. . . . . . . . . . . . . . . . . . . . . . . . . .309 Open an Existing Correlation File Conversion Page . . . . . . . . . . . . . . . . . . . . . .310 Create a New Correlation File Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311 Update a Correlation File Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312 Value Lists Page (Correlation File Conversion) . . . . . . . . . . . . . . . . 313 Open the Value Lists Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314 Go to a New Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315 Go to an Existing Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316 Go to Another Page in the Correlation File Conversion . . . . . . . . . . . . . . . . . . .317 Value List Page (Correlation File Conversion) . . . . . . . . . . . . . . . . . 319 Open a New Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321 Open an Existing Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .322 Create a New Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323 Update a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324 Add a Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325 Update a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326 Table Lookup Value Lists Page (Correlation File Conversion). . . . 327 Open the Table Lookup Value Lists Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328 Go to a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .329 Go to an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .330
CSGDM-10.0-MFUG-2004-04-30
Contents
Table Lookup Value List Page (Correlation File Conversion) . . . . . 331 Open a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .333 Open an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .335 Create a New Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .336 Update a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337 Add a Table Lookup Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338 Update a Table Lookup Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339 Field Mappings Page (Correlation File Conversion). . . . . . . . . . . . . 341 Open the Field Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342 Go to the Data Field Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343 Go to the Expression Page to Update a Control Action Field . . . . . . . . . . . . . . .344 Data Field Mapping Page (Correlation File Conversion) . . . . . . . . . 345 Open the Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347 Update a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348 Go to a Control Action Field Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . .349 Create a Control Action Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .350 Update a Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .351 Secondary Key Mappings Page (Correlation File Conversion) . . . . 353 Open the Secondary Key Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .355 Go to a New Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .356 Go to an Existing Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . .357 Record Mappings Page (Correlation File Conversion). . . . . . . . . . . 359 Open the Record Mappings Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .360 Go to a New Record Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .361 Go to an Existing Record Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .362 Record Mapping Page (Correlation File Conversion). . . . . . . . . . . . 363 Open a New Record Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .365 Open an Existing Record Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .366 Create a New Record Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .367 Go to a Record Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .368 Go to an Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369 Open the Record-to-Module Mappings Table . . . . . . . . . . . . . . . . . . . . . . . . . . .370 Go to a New Record to Module Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . .371 Go to an Existing Record to Module Mapping Page . . . . . . . . . . . . . . . . . . . . . .372 Record Data Field Mapping Page (Correlation File Conversion). . . 373 Open the Record Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .375 Create a Record Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .376 Update a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .377
CSGDM-10.0-MFUG-2004-04-30
xi
Record to Module Mapping Page (Correlation File Conversion) . . 379 Open a New Record to Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . .381 Open an Existing Record to Module Mapping Page . . . . . . . . . . . . . . . . . . . . . .383 Create a Record-to-Module Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .384 Go to the Data Field Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .385 Go to the Expression Page to Update a Control Action Field . . . . . . . . . . . . . . .386 Record to Module Data Field Mapping Page (Correlation File Conversion) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387 Open the Record to Module Data Field Mapping Page. . . . . . . . . . . . . . . . . . . .389 Create a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .391 Update a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .392 Module Mappings Page (Correlation File Conversion) . . . . . . . . . . 393 Open the Module Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .394 Go to a New Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .395 Go to an Existing Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .396 Module Mapping Page (Correlation File Conversion) . . . . . . . . . . . 397 Open a New Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .399 Open an Existing Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .400 Create a Module Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .401 Go to the Data Field Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .402 Go to the Expression Page to Update a Control Action Field . . . . . . . . . . . . . . .403 Module Data Field Mapping Page (Correlation File Conversion) . . 405 Open the Module Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .407 Create a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .408 Update a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .409 11 Correlation Store Conversion Application Pages Correlation Store Conversions Page. . . . . . . . . . . . . . . . . . . . . . . . . 413 Open the Correlation Store Conversions Page . . . . . . . . . . . . . . . . . . . . . . . . . .414 Go to a New Correlation Store Conversion Page . . . . . . . . . . . . . . . . . . . . . . . .415 Go to an Existing Correlation Store Conversion Page . . . . . . . . . . . . . . . . . . . .416 Correlation Store Conversion Page. . . . . . . . . . . . . . . . . . . . . . . . . . 417 Open a New Correlation Store Conversion Page. . . . . . . . . . . . . . . . . . . . . . . . .418 Open an Existing Correlation Store Conversion Page. . . . . . . . . . . . . . . . . . . . .419 Create a Correlation Store Conversion Application . . . . . . . . . . . . . . . . . . . . . .420 Update a Correlation Store Conversion Application . . . . . . . . . . . . . . . . . . . . . .421
CSGDM-10.0-MFUG-2004-04-30
xii
Contents
Value Lists Page (Correlation Store Conversion) . . . . . . . . . . . . . . . 423 Open the Value Lists Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .424 Go to a New Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .425 Go to an Existing Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .426 Go to Another Page in the Correlation Store Conversion . . . . . . . . . . . . . . . . . .427 Value List Page (Correlation Store Conversion) . . . . . . . . . . . . . . . . 429 Open a New Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .431 Open an Existing Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .432 Create a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433 Update a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .434 Add a List Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .435 Update a List Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .436 Table Lookup Value Lists Page (Correlation Store Conversion). . . 437 Open the Table Lookup Value Lists Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .438 Go to a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .439 Go to an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .440 Table Lookup Value List Page (Correlation Store Conversion). . . . 441 Open a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .443 Open an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .445 Create a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .446 Update a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .447 Add a Table Lookup Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .448 Update a Table Lookup Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .449 Secondary Key Mappings Page (Correlation Store Conversion) . . 451 Open the Secondary Key Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .453 Go to a New Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .454 Go to an Existing Secondary Key Mapping Page . . . . . . . . . . . . . . . . . . . . . . . .455 Record Mapping Page (Correlation Store Conversion) . . . . . . . . . . 457 Open the Record Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .459 Update the Record Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .460 Go to a Record Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .461 Go to an Expression Page to Update the Control Action Field . . . . . . . . . . . . . .462 Open the Record-to-Module Mappings Table . . . . . . . . . . . . . . . . . . . . . . . . . . .463 Go to a New Record to Module Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . .464 Go to an Existing Record to Module Mapping Page . . . . . . . . . . . . . . . . . . . . . .465 Record Data Field Mapping Page (Correlation Store Conversion) . 467 Open the Record Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .469 Create a Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .470 Update a Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .471
CSGDM-10.0-MFUG-2004-04-30
xiii
Record to Module Mapping Page (Correlation Store Conversion) . 473 Open the Record-to-Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .474 Module Mappings Page (Correlation Store Conversion). . . . . . . . . 475 Open the Module Mappings Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .477 Go to a New Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .478 Go to an Existing Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .479 Go to a New Module Trigger Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . .480 Go to an Existing Module Trigger Mapping Page. . . . . . . . . . . . . . . . . . . . . . . .481 Module Mapping Page (Correlation Store Conversion). . . . . . . . . . 483 Open a New Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .485 Open an Existing Module Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .487 Create a Module Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .488 Update a Module Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .489 Go to a Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .490 Go to an Expression Page to Update a Control Action Field . . . . . . . . . . . . . . .491 Module Data Field Mapping Page (Correlation Store Conversion). 493 Open the Module Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .495 Create a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .496 Update a Data Field Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .497 Module Trigger Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499 Open a New Module Trigger Mapping Page. . . . . . . . . . . . . . . . . . . . . . . . . . . .501 Open an Existing Module Trigger Mapping Page . . . . . . . . . . . . . . . . . . . . . . . .503 Create a Module Trigger Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .504 Go to a Data Field Mapping Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .505 Go to an Expression Page to Update a Control Action Field . . . . . . . . . . . . . . .506 12 External Database Access Definition Application Pages External Database Access Definitions Page . . . . . . . . . . . . . . . . . . 509 Open the External Database Access Definitions Page. . . . . . . . . . . . . . . . . . . . .510 Go to a New External Database Access Definition Page . . . . . . . . . . . . . . . . . .511 Go to an External Database Access Definition Page . . . . . . . . . . . . . . . . . . . . . .512 External Database Access Definition Page . . . . . . . . . . . . . . . . . . . 513 Open a New External Database Access Definition Page. . . . . . . . . . . . . . . . . . .515 Open an Existing External Database Access Definition Page . . . . . . . . . . . . . . .516 Create an External Database Access Definition . . . . . . . . . . . . . . . . . . . . . . . . .517 Update an External Database Access Definition . . . . . . . . . . . . . . . . . . . . . . . . .518
CSGDM-10.0-MFUG-2004-04-30
xiv
Contents
13
About File Format Definitions Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .520 Working with File Formats and Mediation . . . . . . . . . . . . . . . . . . . . . . . . . . . . .522 Accessing the File Format Definition Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . .523 Defining a GRID File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .526 Working with Data Field Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .527 Working with GRID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .529 Working with GRID Field Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .532 Working with Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .534 Working with File Structures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .536 Working with Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .539 Working with Special Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .540 Working with Module Supports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .541 Working with Block Header/Trailers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .542 Working with File Header/Trailers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .544 Working with File Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .546 Working with File Format & Structure Associations . . . . . . . . . . . . . . . . . . . . .547 Auditing a File Format Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .548 Troubleshooting a File Format Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .549 File Format Audit Error Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .551
14
File Format Definition Application Pages Fields Page (File Format Definitions). . . . . . . . . . . . . . . . . . . . . . . . . 567 Open the Fields Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .568 Go to a New Field Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .569 Go to an Existing Field Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .570 Go to Another Page in the Mediation Feature Set . . . . . . . . . . . . . . . . . . . . . . . .571 Field Page (File Format Definitions). . . . . . . . . . . . . . . . . . . . . . . . . . 573 Open a New Field Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .575 Open an Existing Field Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .576 Create a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .577 Update a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .578 Structures Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579 Open a Structures Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .580 Go to a New Structure Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .581 Go to an Existing Structure Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .582
CSGDM-10.0-MFUG-2004-04-30
xv
Structure Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583 Open a New Structure Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .585 Open an Existing Structure Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .586 Create a Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .587 Update a Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .588 Add a Field. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .589 Update a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .590 Modules Page (File Format Definitions) . . . . . . . . . . . . . . . . . . . . . . 591 Open the Modules Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .592 Go to a New Module Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .593 Go to an Existing Module Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .594 Module Page (File Format Definitions) . . . . . . . . . . . . . . . . . . . . . . . 595 Open a New Module Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .597 Open an Existing Module Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .598 Create a Module. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .599 Update a Module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .600 Add a Field. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .601 Update a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .602 Module Supports Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603 Open the Module Supports Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .605 Go to the Create New Module Support Wizard. . . . . . . . . . . . . . . . . . . . . . . . . .606 Go to an Existing Module Support Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .607 Module Support Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609 Open the Module Support Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .611 Go to the Basic Module Support Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .612 Go to the Module Identification Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .613 Go to the End of Module Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .614 Create a New Module Support Wizard. . . . . . . . . . . . . . . . . . . . . . . . 615 Open the Create a New Module Support Wizard . . . . . . . . . . . . . . . . . . . . . . . .617 Create a Module Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .618 Module Support Basic Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621 Open the Module Support Basic Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .622 Update the Module Support Basic Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . .623 Module Support Module Identification Page . . . . . . . . . . . . . . . . 625 Open the Module Support Module Identification Page . . . . . . . . . . . . . . . . .626 Update the Module Support Module Identification Page . . . . . . . . . . . . . . . .627
CSGDM-10.0-MFUG-2004-04-30
xvi
Contents
Module Support End of Module Page . . . . . . . . . . . . . . . . . . . . . . 629 Open the Module Support End of Module Page. . . . . . . . . . . . . . . . . . . . . . .631 Update the Module Support End of Module Page . . . . . . . . . . . . . . . . . . . . .632 Block Header and Trailer Structures Page . . . . . . . . . . . . . . . . . . . . 633 Open the Block Header and Trailer Structures Page . . . . . . . . . . . . . . . . . . . . . .634 Go to a New Block Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . . . .635 Go to an Existing Block Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . .636 Block Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . . . . . . 637 Open a New Block Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . . . .641 Open an Existing Block Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . .642 Create a New Block Header/Trailer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .643 Update a Block Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . . . . . . .647 Add a Field. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .651 Update a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .652 File Header/Trailer Structures Page . . . . . . . . . . . . . . . . . . . . . . . . . . 653 Open a File Header/Trailer Structures Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .654 Go to a New File Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . . . . . .655 Go to an Existing File Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . .656 File Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . . . . . . . . 657 Open a New File Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . . . . . .659 Open an Existing File Header/Trailer Structure Page . . . . . . . . . . . . . . . . . . . . .660 Create a File Header/Trailer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .661 Update a File Header/Trailer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .664 Add a Field. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .667 Update a Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .668 File Formats Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669 Open the File Formats Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .670 Go to the Create a New File Format Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . .671 Go to an Existing File Format Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .672 File Format General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673 Open the File Format Format General Page . . . . . . . . . . . . . . . . . . . . . . . . . .674 Update the File Format Format General Page . . . . . . . . . . . . . . . . . . . . . . . .675 File Format Format Type Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677 Open the File Format Format Type Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .678 Update the File Format Format Type Page. . . . . . . . . . . . . . . . . . . . . . . . . . .679 Add a Header/Trailer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .680 Update a Header/Trailer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .681
CSGDM-10.0-MFUG-2004-04-30
xvii
File Format File Size Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683 Open the File Format File Size Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .684 Update the File Format File Size Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .685 File Format Record Structure Page . . . . . . . . . . . . . . . . . . . . . . . 687 Open the File Format Record Structure Page . . . . . . . . . . . . . . . . . . . . . . . . .688 Update the File Format Record Structure Page . . . . . . . . . . . . . . . . . . . . . . .689 Create a New File Format Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . 691 Open the Create a New File Format Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . .692 Create a New File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .693 File Format & Structures Association Page . . . . . . . . . . . . . . . . . . . 695 Open the File Format & Structure Associations Page . . . . . . . . . . . . . . . . . . . . .696 Add a Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .697 Remove a Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .698 Audit Page (for Mediation Feature Sets) . . . . . . . . . . . . . . . . . . . . . 699 Open the Audit Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .701 Perform an Audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .702 15 About Search/Filter Application Definitions Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .704 Working with Field Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .706 Working with Record Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .708 Using the Search/Filter Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .709 Working with the Search Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .710 Defining the Search Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .712 Using the Pass Action Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .713 Auditing Search Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .714 Naming of Search Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .715 Working with the Filter Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .716 Defining the Filter Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .718 Using the Filter Test Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .719 Filtering File Headers and Block Headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .720 Auditing Filter Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .721 16 Search/Filter Application Definition Application Pages Value Lists Page (Search/Filter Application Definitions) . . . . . . . . 725 Open the Value Lists Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .726 Go to a New Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .727 Go to an Existing Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .728
CSGDM-10.0-MFUG-2004-04-30
xviii
Contents
Value List Page (Search/Filter Application Definitions) . . . . . . . . . . 729 Open a New Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .731 Open an Existing Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .732 Create a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .733 Update a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .734 Add a Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .735 Update a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .736 Field Filters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737 Open the Field Filters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .738 Go to a New Field Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .739 Go to an Existing Field Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .740 Field Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741 Open a New Field Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .743 Open an Existing Field Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .744 Create a Field Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .745 Update a Field Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .746 Record Filters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747 Open the Record Filters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .748 Go to a New Record Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .749 Go to an Existing Record Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .750 Record Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751 Open a New Record Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .753 Open an Existing Record Filter Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .754 Create a Record Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .755 Create a Special Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .756 Update a Record Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .757 Search/Filter Applications Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759 Open the Search/Filter Applications Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .760 Go to a New Search Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .761 Go to a New Filter Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .762 Go to an Existing Search Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .763 Go to an Existing Filter Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .764 Filter Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765 Open a New Filter Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .767 Open an Existing Filter Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .768 Create a Filter Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .769 Update a Filter Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .770 Add a Special Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .771 Update a Special Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .772
CSGDM-10.0-MFUG-2004-04-30
xix
Search Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773 Open a New Search Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .775 Open an Existing Search Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . .776 Create a Search Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .777 Update a Search Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .778 Add a Special Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .779 Update a Special Filter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .780 17 About the Validation Application Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .782 Accessing the Validation Application Definition Pages . . . . . . . . . . . . . . . . . . .785 Defining a Validation Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .788 Working with Exception Files and Validation . . . . . . . . . . . . . . . . . . . . . . . . . .789 Working with Validation Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .790 Working with Expression Record Associations . . . . . . . . . . . . . . . . . . . . . . . . .792 Working with Application Expression Associations . . . . . . . . . . . . . . . . . . . . . .793 Working with Validation Expressions Order. . . . . . . . . . . . . . . . . . . . . . . . . . . .794 Working with Validation Audits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .795 Working with the Duplicate Record Checking Feature. . . . . . . . . . . . . . . . . . . .796 18 Validation Application Definition Application Pages Value Lists Page (Validation Application). . . . . . . . . . . . . . . . . . . . . 805 Open the Value Lists Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .806 Go to a New Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .807 Go to an Existing Value List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .808 Go to Another Page in the Validation Application . . . . . . . . . . . . . . . . . . . . . . .809 Value List Page (Validation Application). . . . . . . . . . . . . . . . . . . . . . 811 Open a New Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .813 Open an Existing Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .814 Create a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .815 Update a Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .816 Add a Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .817 Update a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .818 Table Lookup Value Lists Page (Validation Application) . . . . . . . . 819 Open the Table Lookup Value Lists Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .820 Go to a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .821 Go to an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .822
CSGDM-10.0-MFUG-2004-04-30
xx
Contents
Table Lookup Value List Page (Validation Application) . . . . . . . . . . 823 Open a New Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . . . . . .825 Open an Existing Table Lookup Value List Page . . . . . . . . . . . . . . . . . . . . . . . .826 Create a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .827 Update a Table Lookup Value List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .828 Add a Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .829 Update a Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .830 Reference Sets Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831 Open the Reference Sets Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .832 Go to the Reference Set Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .833 Go to the Create a New Reference Set Wizard . . . . . . . . . . . . . . . . . . . . . . . . . .834 Create a New Reference Set Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . 835 Open the Create a New Reference Set Wizard . . . . . . . . . . . . . . . . . . . . . . . . . .837 Create a New Reference Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .838 Reference Set Parameters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 839 Open the Reference Set Parameters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .841 Update the Reference Set Parameters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . .842 Reference Set Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 843 Open the Reference Set Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .845 Go to the Reference Set Parameters Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .846 Go to the Reference Set Pruning Schedule Page . . . . . . . . . . . . . . . . . . . . . . . . .847 Reference Set Pruning Schedule Page . . . . . . . . . . . . . . . . . . . . . . . 849 Open the Reference Set Pruning Schedule Page . . . . . . . . . . . . . . . . . . . . . . . . .850 Update the Reference Set Pruning Schedule Page. . . . . . . . . . . . . . . . . . . . . . . .851 Validation Applications Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 853 Open the Validation Applications Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .854 Go to a New Validation Application Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .855 Go to an Existing Validation Application Page. . . . . . . . . . . . . . . . . . . . . . . . . .856 Validation Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 857 Open a New Validation Application Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .859 Open an Existing Validation Application Page . . . . . . . . . . . . . . . . . . . . . . . . . .860 Create a Validation Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .861 Update a Validation Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .862 Validation Expressions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 863 Open the Validation Expressions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .864 Go to a New Validation Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .865 Go to an Existing Validation Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . .866
CSGDM-10.0-MFUG-2004-04-30
xxi
Validation Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 867 Open a New Validation Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .869 Open an Existing Validation Expression Page . . . . . . . . . . . . . . . . . . . . . . . . . .870 Create a New Validation Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .871 Update a Validation Expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .872 Expression Record Association Page. . . . . . . . . . . . . . . . . . . . . . . . 873 Open the Expression Record Association Page . . . . . . . . . . . . . . . . . . . . . . . . . .874 Update the Expression Record Association Page . . . . . . . . . . . . . . . . . . . . . . . .875 Application Expression Association Page . . . . . . . . . . . . . . . . . . . . 877 Open the Application Expression Association Page . . . . . . . . . . . . . . . . . . . . . .878 Update the Application Expression Association Page. . . . . . . . . . . . . . . . . . . . .879 Validation Expressions Order Page . . . . . . . . . . . . . . . . . . . . . . . . . 881 Open the Validation Expressions Order Page . . . . . . . . . . . . . . . . . . . . . . . . . . .882 Update the Validation Expressions Order Page. . . . . . . . . . . . . . . . . . . . . . . . . .883 Audit Page (for Validation) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885 Open the Audit Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .886 Audit the Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .887 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
CSGDM-10.0-MFUG-2004-04-30
Figures
Figure 1 Figure 2 Figure 3 Figure 4 Figure 5 Figure 6 Figure 7 Figure 8 Figure 9 Figure 10 Figure 11 Figure 12 Figure 13 Figure 14 Figure 15 Figure 16 Figure 17 Figure 18 Figure 19 Figure 20 Figure 21 Figure 22 Figure 23 Figure 24 Figure 25 Figure 26 Figure 27 Figure 28 Figure 29 Figure 30 Figure 31 Figure 32 Figure 33 Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 External Database Access Definitions ................................................................... 6 The Package Manager Applications Link .............................................................. 9 The External Database Access Definitions Container Page................................... 9 The Expression Page ............................................................................................ 10 Mediation Features Page ...................................................................................... 25 Mediation Feature Sets Page ................................................................................ 29 Mediation Feature Set Page.................................................................................. 33 Expression Page ................................................................................................... 39 Secondary Key Mapping Page ............................................................................. 45 Package Manager Application.............................................................................. 52 Package Manager Application Link ..................................................................... 54 The Package Manager Applications Container Page ........................................... 54 The Create a New Package Wizard...................................................................... 56 Creating a Package ............................................................................................... 57 Variable-Length Blocks ....................................................................................... 60 Fixed Length Blocks ............................................................................................ 60 The Package Manager Application Page with the Audit Section ........................ 64 Package Manager Applications Page ................................................................... 69 Create a New Package Wizard Screen One..................................................... 73 Create a New Package Wizard Screen Two.................................................... 75 Create a New Package Wizard Screen Three.................................................. 77 Package Manager Summary Page ........................................................................ 81 Package Manager Application.............................................................................. 87 Package Manager Record Blocking Page ............................................................ 93 Package Manager Record Structure Mapping...................................................... 99 File Format Conversion Applications Link........................................................ 105 The File Format Conversion Applications Container Page................................ 105 File Format Conversion Application Page ......................................................... 106 The New File Format Conversion Application page.......................................... 107 Defining a File Format Conversion.................................................................... 108 Data Process Flow File Format Conversion Applications ............................ 116 File Format Conversion Applications Page........................................................ 119 File Format Conversion Application Page ......................................................... 123 Value Lists Page................................................................................................. 129 Value List Page .................................................................................................. 135 Table Lookup Value Lists Page ......................................................................... 143 Table Lookup Value List Page........................................................................... 147 Field Mappings Page .......................................................................................... 155 Field Mapping Page............................................................................................ 159 Record Mappings Page....................................................................................... 163 Record Mapping Page ........................................................................................ 167 Secondary Key Mappings Page.......................................................................... 173 Secondary Key Mapping Page ........................................................................... 177 Block Header/Trailer Mappings Page ................................................................ 185 File Header/Trailer Mappings Page ................................................................... 191
CSGDM-10.0-MFUG-2004-04-30
Figures
Figure 46 Figure 47 Figure 48 Figure 49 Figure 50 Figure 51 Figure 52 Figure 53 Figure 54 Figure 55 Figure 56 Figure 57 Figure 58 Figure 59 Figure 60 Figure 61 Figure 62 Figure 63 Figure 64 Figure 65 Figure 66 Figure 67 Figure 68 Figure 69 Figure 70 Figure 71 Figure 72 Figure 73 Figure 74 Figure 75 Figure 76 Figure 77 Figure 78 Figure 79 Figure 80 Figure 81 Figure 82 Figure 83 Figure 84 Figure 85 Figure 86 Figure 87 Figure 88 Figure 89 Figure 90 Figure 91 Figure 92 Figure 93 Figure 94 Figure 95
Module Mappings Page...................................................................................... 195 Module Mapping Page ....................................................................................... 201 The Correlation Provisioning Process ................................................................ 209 Correlation Applications Link............................................................................ 210 The Correlation Applications Page .................................................................... 210 The Correlation Store Conversion Provisioning Process ................................... 212 Correlation File Conversion Provisioning Process............................................. 214 Defining a Correlation ID................................................................................... 215 Correlation Applications Page............................................................................ 229 Correlation IDs Page .......................................................................................... 237 Correlation ID Page............................................................................................ 241 Correlation Value Lists Page.............................................................................. 247 Correlation ID Value List Page .......................................................................... 253 Correlation ID Table Lookup Value Lists Page ................................................. 261 Correlation ID Table Lookup Value List Page................................................... 265 Output File Management Page ........................................................................... 273 Output Record Management Page...................................................................... 277 Correlation Conversion Assignments Page ........................................................ 281 Correlation Conversion Application Manager Page........................................... 285 Source Assignments Page................................................................................... 289 Output File Management Expression Page ........................................................ 293 Output Record Management Expression Page ................................................... 294 The Correlation File Conversions Page.............................................................. 303 The Correlation File Conversion Page ............................................................... 307 Value Lists Page ................................................................................................. 313 Value List Page................................................................................................... 319 Table Lookup Value Lists Page ......................................................................... 327 Table Lookup Value List Page ........................................................................... 331 Field Mappings Page .......................................................................................... 341 Data Field Mapping Page ................................................................................... 345 Secondary Key Mappings Page.......................................................................... 353 Record Mappings Page....................................................................................... 359 Record Mapping Page ........................................................................................ 363 Record Data Field Mapping Page....................................................................... 373 Record to Module Mapping Page....................................................................... 379 Record to Module Data Field Mapping Page ..................................................... 387 Module Mappings Page...................................................................................... 393 Module Mapping Page ....................................................................................... 397 Module Data Field Mapping Page...................................................................... 405 Correlation Store Conversion Applications Page............................................... 413 Correlation Store Conversion Page .................................................................... 417 Correlation Store Conversion Value Lists Page................................................. 423 Value List Page................................................................................................... 429 Correlation Table Lookup Value Lists Page ...................................................... 437 Table Lookup Value List Page ........................................................................... 441 Secondary Key Mapping Page ........................................................................... 451 Record Mapping Page ........................................................................................ 457 Data Field Mapping Page ................................................................................... 467 Record to Module Mapping Page....................................................................... 473 Correlation Store Module Mappings Page ......................................................... 475
CSGDM-10.0-MFUG-2004-04-30
Figures
vi
Figure 96 Figure 97 Figure 98 Figure 99 Figure 100 Figure 101 Figure 102 Figure 103 Figure 104 Figure 105 Figure 106 Figure 107 Figure 108 Figure 109 Figure 110 Figure 111 Figure 112 Figure 113 Figure 114 Figure 115 Figure 116 Figure 117 Figure 118 Figure 119 Figure 120 Figure 121 Figure 122 Figure 123 Figure 124 Figure 125 Figure 126 Figure 127 Figure 128 Figure 129 Figure 130 Figure 131 Figure 132 Figure 133 Figure 134 Figure 135 Figure 136 Figure 137 Figure 138 Figure 139 Figure 140 Figure 141 Figure 142 Figure 143 Figure 144 Figure 145
Correlation Store Module Mapping Page........................................................... 483 Data Field Mapping Page ................................................................................... 493 Module Trigger Mapping Page .......................................................................... 499 External Database Access Definitions Page....................................................... 509 External Database Access Definition Page ........................................................ 513 Active Mediation Feature Set Drop-down Menu ............................................... 523 The File Format Definitions Links..................................................................... 523 Defining a File Format ....................................................................................... 526 GRID Field Attributes ........................................................................................ 532 Fields in a Data Record ...................................................................................... 534 Fields in a BAF Record ...................................................................................... 535 Typical File Configuration ................................................................................. 538 Fields Page ......................................................................................................... 567 Field Page ........................................................................................................... 573 Structures Page ................................................................................................... 579 Structure Page..................................................................................................... 583 Modules Page ..................................................................................................... 591 Module Page....................................................................................................... 595 Module Supports Page........................................................................................ 603 Module Support Page ......................................................................................... 610 Create a New Module Support Wizard Screen One...................................... 615 Module Support Basic Page ............................................................................... 621 Module Support Module Identification Page ..................................................... 625 Module Support End of Module Page................................................................ 629 Block Header/Trailer Structures Page................................................................ 633 Block Header/Trailer Structure Page ................................................................. 638 File Header/Trailer Structures Page ................................................................... 653 File Header/Trailer Structure Page..................................................................... 657 File Formats Page............................................................................................... 669 File Format General Page.............................................................................. 673 File Format Format Type Page...................................................................... 677 File Format Format File Size Page................................................................ 683 File Format Record Structure Page ............................................................... 687 The Create a New File Format Wizard Screen One...................................... 691 File Format & Structures Association Page ....................................................... 695 Audit Page .......................................................................................................... 699 Search/Filter Applications Definitions Menu..................................................... 704 Comparison Operator Drop-down Menu ........................................................... 706 Only Valid for Record ID Check Box................................................................ 708 New Search or Filter Page Radio Buttons.......................................................... 709 Existing Search or Filters in Search/Filter Applications Table.......................... 709 The Search Application ...................................................................................... 710 Defining a Search Application ........................................................................... 712 Pass Action Feature Radio Button Set ............................................................... 713 Search File Name Convention............................................................................ 715 The Filter Application in the Input and Output Streams .................................... 717 Defining the Filter Application .......................................................................... 718 Value Lists Page................................................................................................. 725 Value List Page .................................................................................................. 729 Field Filters Page................................................................................................ 737
CSGDM-10.0-MFUG-2004-04-30
vii
Figures
Figure 146 Figure 147 Figure 148 Figure 149 Figure 150 Figure 151 Figure 152 Figure 153 Figure 154 Figure 155 Figure 156 Figure 157 Figure 158 Figure 159 Figure 160 Figure 161 Figure 162 Figure 163 Figure 164 Figure 165 Figure 166 Figure 167 Figure 168 Figure 169 Figure 170 Figure 171 Figure 172 Figure 173 Figure 174 Figure 175 Figure 176 Figure 177
Field Filter Page ................................................................................................. 741 Record Filters Page............................................................................................. 747 Record Filter Page .............................................................................................. 751 Search/Filter Applications Page ......................................................................... 759 Filter Application Page....................................................................................... 765 Search Application Page..................................................................................... 773 Validation Data Process Flow ............................................................................ 783 Active Mediation Feature Set Drop-down Menu ............................................... 785 The Validation Application Definitions Links ................................................... 785 Creating a Validation Application Definition .................................................... 788 Validation Exception File Flow.......................................................................... 789 Available Operator Types................................................................................... 791 The Validation Audit Page ................................................................................. 795 The Reference Set Information on the Validation Application Page ................. 801 Validation Application Value Lists Page ........................................................... 805 Value List Page................................................................................................... 811 Validation Application Table Lookup Value Lists Page.................................... 819 Table Lookup Value List Page ........................................................................... 823 Reference Sets Page ........................................................................................... 831 Create a New Reference Set Wizard Screen One.......................................... 835 Create a New Reference Set Wizard Screen Two ......................................... 836 Reference Set Parameters Page .......................................................................... 839 Reference Set Summary Page ............................................................................ 843 Reference Set Pruning Schedule Page................................................................ 849 Validation Applications Page ............................................................................. 853 Validation Application Page............................................................................... 857 Validation Expressions Page .............................................................................. 863 Validation Expression Page................................................................................ 867 Expression Record Association Page ................................................................. 873 Application Expression Association Page.......................................................... 877 Validation Expressions Order Page.................................................................... 881 Audit Page (for Validation) ................................................................................ 885
CSGDM-10.0-MFUG-2004-04-30
Tables
Table 1 Table 2 Table 3 Table 4 Table 5 Table 6 Table 7 Table 8 Notational Conventions ................................................................................................ x Equation Options in Expressions ................................................................................ 11 Package Manager Summary Page Icons and the Corresponding Pages ..................... 55 Correlation Applications Icons and the Corresponding Pages ................................. 211 File Format Definitions Links and the Corresponding Pages................................... 524 Search/Filter Application Definitions Icons and Corresponding Pages ................... 705 Field Filter Comparison Operators ........................................................................... 706 Validation Application Definitions Links and the Corresponding Pages................. 786
CSGDM-10.0-MFUG-2004-04-30
Notational Conventions
Note Important notes appear in this format.
Caution
Warning!
Indicates serious risk of damage to data, software, or hardware. Table 1 Notational Conventions
Notation
Helvetica italic <UPPERCASE HELVETICA>
Explanation of Convention
References to printed documents Keys Code and file names Buttons, icons, and menu items
Example
For more information on the Users Page, see the Administration Guide. Press <ENTER>. At the prompt, type rename. Click Submit.
Additional Documentation
These manuals are available for the CSG Data Mediation System: Administration Guide CSGDM-10.0-AG-2004-04-30 Describes the administration pages and the procedures to administer and maintain the basic Data Mediation system. Data Dictionary CSGDM-10.0-DD-2004-04-30 Contains detailed information of form fields and buttons that appear in the application. CAPI User Guide CSGDM-10.0-CAUG-2004-04-30 Provides the concepts and functions for the Collection Application Programming Interface (CAPI). Data Collection Schedules User Guide CSGDM-10.0-DCSUG-2004-04-30 Describes how data collections are performed and stored on the Data Mediation system. Data Files User Guide CSGDM-10.0-DFUG-2004-04-30 Explains how to work with data files, including information on file types, the bulk edit feature, and exception files. Data File Searches User Guide CSGDM-10.0-DFSUG-2004-04-30 Contains information on setting up data file search schedules. Data Transmission Schedules User Guide CSGDM-10.0-DTSUG-2004-04-30 Provides information on data transmission, including scheduling transmissions. Destinations User Guide CSGDM-10.0-DUG-2004-04-30 Provides information on creating and setting up destinations. Getting Started Guide CSGDM-10.0-GSG-2004-04-30 Provides an overview of the Data Mediation system application and information for using the interface
xv
Additional Documentation
GML Developer Guide CSGDM-10.0-GDG-2004-04-30 Describes the mediation feature components, the semantics, and general syntax of the GRID Mapping Language (GML). Installation Guide (for IBM and SUN platforms) CSGDM-10.0-IIG-2004-04-30 CSGDM-10.0-SIG-2004-04-30 Describes how to install the Data Mediation system, including information about the Post Processing feature and an appendix of critical and major alarm messages. Interface Reference Guide CSGDM-10.0-IRG-2004-04-30 Contains reference information on the CDRP and OBDC interfaces. Logs User Guide CSGDM-10.0-LUG-2004-04-30 Provides information on the log types, message types, and message priority levels. Mediation API Reference Guide CSGDM-10.0-MARG-2004-04-30 Contains reference information on using the mediation API. Mediation Features User Guide CSGDM-10.0-MFUG-2004-04-30 Describes all the mediation applications, including correlation, file format, filter, package manager, search, and validation. Reports User Guide CSGDM-10.0-RUG-2004-04-30 Explains the what reports exist, how to generate them, and how to set up custom reports. Scripts Reference Guide CSGDM-10.0-SRG-2004-04-30 Provides information on script files, which contain additional instructions for functions for data collection and transmission. SockedBased API Guide CSGDM-10.0-SAG-2004-04-30 Explains the building applications using the Socket Based Record Transmission API. Programmers can use the guide to use the records received from the Data Mediation system for their own customized downstream application solutions Sources User Guide CSGDM-10.0-SUG-2004-04-30 Provides information on creating and updating sources.
Additional Documentation
xvi
System Summary User Guide CSGDM-10.0-SSUG-2004-04-30 Explains the form fields on the System Summary Page and provides status descriptions for active source and destination links.
xiv
Professional Services
Custom Software and Integration Development to build customized software to meet specific business needs and specifications, including specialized processors and collection interfaces Switch Integration to obtain on-site support for the testing, validation, and turn-up of new or existing switches beyond the scope of standard Data Manager application software installation and integration Customized Reporting Service to evaluate reporting requirements and create a custom reporting solution that can track and store statistical information, deliver customized statistics to downstream database systems, and provision specific reports using standard database reporting software Integration of External Information to identify required external information, which is from relational databases or from external systems that dynamically change the information, and design and implement a solution for integrating the external information CSG Data Mediation Systems Moves to obtain services associated with moving the CSG Data Mediation System from one location or hardware server to another. Includes planning, verifying the new hardware server, loading CSG Data Mediation software, moving data to the new server, performing product readiness testing, and helping with production cutover
This chapter describes common features used by various applications in Data Mediation and includes information on: Working with Defaults Working with Globals Working with Value Lists Working with Table Lookup Value Lists Working with External Database Access Definitions Accessing External Database Access Definitions Building Expressions Working with Secondary Keys Working with Mappings Working with Field Mappings Working with Record Mappings Working with Record-to-Module Mappings Working with Module Mappings Working with Justification and Padding
CSGDM-10.0-MFUG-2004-04-30
Order of Precedence
The default used in a field depends on the type of default. The default values have precedence, from highest to lowest, in this order: Function defaults Record defaults Field defaults Global defaults
For example, if the global default for an ASCII field is 000000 and the default specified in the field mapping is 0a000a, then the field default has precedence over the global default and the field is filled with 0a000a.
CSGDM-10.0-MFUG-2004-04-30
CSGDM-10.0-MFUG-2004-04-30
CSGDM-10.0-MFUG-2004-04-30
CSGDM-10.0-MFUG-2004-04-30
CSGDM-10.0-MFUG-2004-04-30
To work with the External Database Access feature you must: Have a working understanding of how databases work Have adequate knowledge of Structured Query Language (SQL) Know the name of the database table to be accessed and the structure of the fields to be retrieved from the database table Have the Level 1 administrator work with the manager of the external database to configure the interface between the Data Mediation system and the external data source
Local Files
The data retrieved using the External Database Access feature contains values used to populate lists or table lookup values used in mediation feature expressions. Data in the external database can change. Periodically update the locally stored file to ensure the data is current. You can update files manually by performing an audit or automatically by scheduling the update. If an on audit update fails, the local data file is not updated. You must correct the problem and rerun the update procedure.
CSGDM-10.0-MFUG-2004-04-30
If a scheduled update fails, the local data file is not updated. An error message is logged in the Error and Information Log. All mediation feature operations continues using the previously generated local data file.
CSGDM-10.0-MFUG-2004-04-30
When you click the External Database Access Definitions link, the External Database Access Definitions Page opens, which is a container page that lists all the external database access definitions in the table.
Figure 3 The External Database Access Definitions Container Page
If you click a link in this table, the corresponding External Database Access Definition Page, which is the instance page, opens. If you click the New icon, a new External Database Access Definition Page instance page opens.
CSGDM-10.0-MFUG-2004-04-30
10
Building Expressions
You can build expressions in the Filter, Search, File Format Conversion, Validation, and Correlation applications on these pages: Expression Page creates expressions to map input fields to output fields Output File and Record Management Expression Pages Secondary Key Mapping Page (Correlation File Conversion and Correlation Store Conversion) Secondary Key Mapping Page (File Format Conversion) Validation Expression Page creates expressions that tell the system how to validate record data Each page has common characteristics, including: At least one large text box where you enter your expression An operators drop-down menu and corresponding table, which lists the options available for the operator that you selected from the menu A fields drop-down menu and corresponding table, which lists the options available for the input, output, source, or target field that you selected from the menu
Figure 4 The Expression Page
CSGDM-10.0-MFUG-2004-04-30
Building Expressions
11
When you build the expression in the large text box, you use elements from the Fields drop-down menu, the Operators drop-down menu, and equation options that you enter from your keyboard. These options are listed in the following table:
Table 2 Equation Options in Expressions
Press
+ / * && || ! | = > < >= <= IF THEN ELSE
To Add mathematical expressions or the results of mathematical operators Subtract mathematical expressions or the results of mathematical operators Divide mathematical expressions or the results of mathematical operators Multiply mathematical expressions or the results of mathematical operators Represent AND, which requires two conditions to be true before continuing on in the expression logic Represent OR, which requires one of the two conditions to be true before continuing on in the expression logic Represent NOT, which requires that a condition not be true before continuing on in the expression logic Concatenate or join together the preceding value and following value in the expression Make sure that one field value or expression result is equal to another Make sure that one field value or expression result is greater than another Make sure that one field value or expression result is less than another Verifies that one field value or expression result is greater than or equal to another Make sure that one field value or expression result is less than or equal to another Start a conditional expression (IFTHEN). It defines the comparison Separate the conditional part of an IF statement from the mapping or action to perform Allow an alternate mapping operation be performed if the condition is not met in a conditional expression All nested IFTHEN logical statements must have an ELSE statement Show a nested IFTHENELSE logical statements in an expression
ELSEIF
CSGDM-10.0-MFUG-2004-04-30
12
Press
FI
To Close an IFTHEN logical statement. All nested IFTHENELSE logical statements must have a FI statement
IFTHEN Expression
This is an example of an ifthen conditional expression:
IFTHENELSE Expression
This is an example of an ifthenelse conditional expression:
For information on mapping operations, see the GML Developer Reference Guide
CSGDM-10.0-MFUG-2004-04-30
13
Record-to-record secondary mappings Record- to-record secondary key mappings apply conditional logic to fields within an input record structure or module. If the logic is true, a user-specified output record structure is generated Record-to-module secondary mappings Record-to-module secondary key mappings apply conditional logic to fields within an input record structure or module. If the logic is true, a user-specified output record module is appended to the output record being mapped Module-to-module secondary mappings Module-to-module secondary key mappings apply conditional logic to fields within an input record module. If the module exists in the input record and the logic is true, a user-specified module is appended to the output record being mapped
Note Secondary keys are not required for performing record or module mapping; however, you must complete a secondary key mapping before using the Record Mapping page.
When defining record or module secondary keys: For record-to-record and record-to-module mappings, use secondary keys with a key type of structure For module-to-module mappings, use secondary keys with a key type of module Secondary keys can be ordered to determine when a secondary key mapping is evaluated Secondary keys can be specified as exclusive Multiple secondary key mappings can be applied to an input record
CSGDM-10.0-MFUG-2004-04-30
14
When setting up a structure secondary key for a correlation store conversion, use fields from both the source record and target record to set up the conditional expression When setting up a module secondary key for a correlation store conversion, only use fields in the source module because the target module type is not known at the time of definition When setting up a structure secondary key for a correlation file conversion, use fields in the input record to set up the conditional expression When setting up a module secondary key for a correlation file conversion, use fields in the input module to set up the conditional expression
CSGDM-10.0-MFUG-2004-04-30
15
Triggers
Triggers are events that flag the Data Mediation system to create a record in the output file that is not a data record. For example, a trigger can prompt the system to create a file trailer when the end of a file is detected. You can map triggers to an expression just as output fields can be mapped. However, you cannot map an input field to a trigger. You can only use these operators to map values to triggers: Global operators Operators that access external data Other operators used with constant arguments, instead of the input field values These are the types of explicit triggers defined for the File Format Conversion application: START_OF_FILE END_OF_FILE MAX_BLOCK_SIZE_1 MAX_BLOCK_SIZE_2 MAX_BLOCK_SIZE_3 MAX_RECORD_PER_BLOCK_1 MAX_RECORD_PER_BLOCK_2 MAX_RECORD_PER_BLOCK_3 MAX_BLOCK_COUNT_1 MAX_BLOCK_COUNT_2 MAX_BLOCK_COUNT_3 MAX_FILE_SIZE MAX_RECORD_COUNT TERMINATING_MODULE
Use MAX_BLOCK_SIZE, MAX_RECORDS_PER_BLOCK, or MAX_BLOCK_ COUNT when you are converting from a format that does not contain block headers and trailers to one that does have them. Use MAX_FILE_SIZE, MAX_RECORD_COUNT, START_OF_FILE, and END_OF_ FILE when converting a format that has one file size to file format with a different file size.
CSGDM-10.0-MFUG-2004-04-30
16
Order of Evaluation
Record and module mappings are evaluated and executed in this order: 1. 2. 3. Record-to-record mappings that do not have an order specified Record-to-record mappings that do have a user-specified order Within a record-to-record mapping, any associated record-to-module mappings that do not have an order specified Within a record-to-record mapping, any associated record-to-module mappings that do have a user specified order Module-to-module mappings that do not have an order specified Module-to-module mappings that do have a user-specified order
4.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
17
Example
The source input file format contains a field named Connect Time The target output file format has a field named Call Start Time If you set up Connect Time to always map to Call Start Time, then whenever the File Format Conversion Application encounters these two fields, a field mapping is performed
CSGDM-10.0-MFUG-2004-04-30
18
Example
The input record ID 703 contains the field Connect Date The target output record ID 104 contains the field Call Start Date These two fields are then mapped at the record level If you set up Connect Date to always map to Call Start Date, then whenever the File Format Conversion Application encounters a source input record ID 703, it creates a target output record ID 104, then uses this specific record mapping to map input field Connect Date to output field Call Start Date If the File Format Conversion Application encounters any other input records containing the field Connect Time, this specific record mapping is not performed
CSGDM-10.0-MFUG-2004-04-30
19
CSGDM-10.0-MFUG-2004-04-30
20
CSGDM-10.0-MFUG-2004-04-30
21
and Padding is
blank
CSGDM-10.0-MFUG-2004-04-30
22
If Justification is
Right Left Right
and padding is
0 0 blank
References
For information on mapping operations, see the GML Developer Reference Guide
CSGDM-10.0-MFUG-2004-04-30
This section describes the Mediation Feature Set pages, including information on: Creating Mediation Feature Sets Opening Mediation Feature Set pages Updating Mediation Feature Set pages
CSGDM-10.0-MFUG-2004-04-30
25
Elements
This element appears on this page and is described in the Data Dictionary: Active Mediation Feature Set
CSGDM-10.0-MFUG-2004-04-30
26
CSGDM-10.0-MFUG-2004-04-30
27
CSGDM-10.0-MFUG-2004-04-30
29
Elements
These elements are on this page and are described in the Data Dictionary: Description Name
CSGDM-10.0-MFUG-2004-04-30
30
2.
Click the All Mediation Feature Sets link. The Mediation Feature Sets page opens.
CSGDM-10.0-MFUG-2004-04-30
31
The Mediation Feature Set page opens for a new mediation feature set.
CSGDM-10.0-MFUG-2004-04-30
32
CSGDM-10.0-MFUG-2004-04-30
33
Elements
These elements are on this page and are described in the Data Dictionary: Description Name
CSGDM-10.0-MFUG-2004-04-30
34
2.
Click All Mediation Feature Sets. The Mediation Feature Sets page opens. Click the New icon.
3.
The Mediation Feature Set page opens for a new mediation feature set.
CSGDM-10.0-MFUG-2004-04-30
35
2.
Click the mediation feature set from the Active Mediation Feature Set drop-down menu. The Mediation Feature Set page opens.
CSGDM-10.0-MFUG-2004-04-30
36
2.
CSGDM-10.0-MFUG-2004-04-30
37
2.
CSGDM-10.0-MFUG-2004-04-30
38
CSGDM-10.0-MFUG-2004-04-30
Expression Page
39
Expression Page
After you "Open the Expression Page from the Action Fields Tables" (240) or "Open the Expression Page from the Data Fields Tables" (241), you can: "Create an Expression" (242) "Update an Expression" (244)
Figure 8 Expression Page
Elements
These elements are on this and are described in the Data Dictionary: Correlation Record Mapping Expression Field Format Field Name (Expression Page) File Conversion Name (Correlation File Conversion Expressions) Justification Mapping ID New Record Mapping Expression Padding Store Conversion Name (Correlation Store Conversion Expressions)
CSGDM-10.0-MFUG-2004-04-30
40
2.
3.
Click the Correlation Store Conversion or Correlation File Conversion link. Click the Name of the correlation store conversion or correlation file conversion in the table. Click any of the links in the Mappings column except for the Secondary Key Mappings link. The appropriate mapping page appears. Click a mapping in one of the Action Fields table. A new window opens with the Expression page.
4.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
41
2.
3. 4.
Click Correlation Store Conversion or Correlation File Conversion. Click the Name of the correlation store conversion or correlation file conversion in the table. Click any of the links in the Mappings column except for the Secondary Key Mappings link. The appropriate mapping page appears. Click a mapping in one of the Data Fields tables. Create or update a mapping. Click Expression. A new window opens with the Expression page.
5.
6. 7. 8.
CSGDM-10.0-MFUG-2004-04-30
42
Create an Expression
To create an expression: 1. Click Mediation Features on the Data Mediation System Launch page. The Mediation Features page opens.
2.
3. 4.
Click Correlation Store Conversion or Correlation File Conversion. Click the Name of the correlation store conversion or correlation file conversion in the table. Click any of the links in the Mappings column except for the Secondary Key Mappings link. The appropriate mapping page appears. Click a mapping in one of the Data Fields tables or the Action Fields tables. Create a new mapping by clicking a New icon.
5.
6.
7.
8.
Fill out these form fields: Name Start (for Field Mappings) Length
CSGDM-10.0-MFUG-2004-04-30
Create an Expression
43
9. 10.
Click Expression. A new window opens with the Expression page. Fill out these form fields: Justification Padding Default Value
11. 12.
Build expressions using the items in the drop-down menus: Click Submit.
CSGDM-10.0-MFUG-2004-04-30
44
Update an Expression
To update an expression: 1. Follow the instructions to "Open the Expression Page from the Action Fields Tables" (240) or "Open the Expression Page from the Data Fields Tables" (241). Fill out these form fields: Justification Padding 3. 4. Update expressions using the items in the drop-down menus: Click Submit.
2.
CSGDM-10.0-MFUG-2004-04-30
45
Secondary Key Mapping Page (Correlation File Conversion and Correlation Store Conversion)
The Secondary Key Mapping page lets you define optional secondary key conditions that you can apply to an input or source record. You can open this page from the Correlation Store Conversion or Correlation File Conversion pages. After you "Open a New Secondary Key Mapping Page" (247), you can "Create a Secondary Key Mapping Expression" (249). After you "Open an Existing Secondary Key Mapping Page" (248), you can "Update a Secondary Key Mapping" (250).
Figure 9 Secondary Key Mapping Page
CSGDM-10.0-MFUG-2004-04-30
46
Elements
These elements are on this page and are described in the Data Dictionary: File Conversion Name (for Correlation File Conversion Expressions) Justification Key Type Name Padding Secondary Key Secondary Key Expression Source Structure Store Conversion Name (for Correlation Store Conversion Expressions) Target Record
CSGDM-10.0-MFUG-2004-04-30
47
2.
3. 4.
Click Correlation Store Conversion or Correlation File Conversion. Click the Name of the correlation store conversion or correlation file conversion in the table. Click Secondary Key Mappings in the Mappings column. Click the New icon.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
48
2.
3. 4.
Click Correlation Store Conversion or Correlation File Conversion. Click the Name of the correlation store conversion or correlation file conversion in the table. Click Secondary Key Mappings in the Mappings column. Click the Secondary Key in the table. The Secondary Key Mappings page opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
49
2.
CSGDM-10.0-MFUG-2004-04-30
50
2.
3.
CSGDM-10.0-MFUG-2004-04-30
This chapter describes the package manager application, including information on: Overview Accessing the Package Manager Application Pages Setting Up a Package Transferring File and Block Headers/Trailers Working with Record Blocking Working with Record Structure Mapping Auditing a Package Installing a Package in the Application Stream
CSGDM-10.0-MFUG-2004-04-30
52
Overview
The Package Manager feature lets you determine what output packaging changes, if any, that you need to make to files being processed in the source application stream or the destination application stream.
Figure 10 Package Manager Application
CSGDM-10.0-MFUG-2004-04-30
Overview
53
The Package Manager Application is not as sophisticated as the File Format application because it does not convert one file format to another; however, the Package Manager Application can perform basic functions that are similar to format without setting up an entire format conversion ID. The Package Manager application is typically used for instances that require changes to file packaging. Packaging is the way that a file is designed or grouped so that an application (AS400, CABS, and so on) can read it. For example, if an incoming file has file and block headers/trailers but the billing system only requires file headers and trailers, you can create a package that has block headers and trailers removed from the file without having to set up a file format conversion. Optional sections in Package Manager let you manage these three areas: Headers and trailers to determine if headers and trailers are included in the output file Data blocks to define variable or fixed-size blocks with an optional block descriptor word Record structure to define end-of-record sequence, bit stuffing sequence, and record descriptor word
CSGDM-10.0-MFUG-2004-04-30
54
When you click the Package Manager Applications link, the Package Manager Applications Page opens, which is a container page that lists all the packages in a table.
Figure 12 The Package Manager Applications Container Page
CSGDM-10.0-MFUG-2004-04-30
55
When you click a link in this table, the corresponding Package Manager Summary Page opens. This page provides links to the three package manager application pages.
Table 3 Package Manager Summary Page Icons and the Corresponding Pages
To Go to the Package Manager Application Page, which lets you assign an input file format and output file format for the package, then select which block and file header/trailers to transfer or delete Go to the Package Manager Record Blocking Page, which lets you configure the settings for record blocking Go to the Package Manager Record Structure Mapping Page, which lets you configure the settings for the end of record sequence, the bit stuff sequence, and the end of file sequence features. You can also determine whether you want to delete bytes from the beginning from data records and file and block header/trailers
CSGDM-10.0-MFUG-2004-04-30
56
When you click the new icon on this page, the Create a New Package Wizard opens. This wizard has three screens that are similar to the three pages on the Package Manager Summary Page.
Figure 13 The Create a New Package Wizard
CSGDM-10.0-MFUG-2004-04-30
Setting Up a Package
57
Setting Up a Package
Figure 14, "Creating a Package" (3-57), shows how the Package Manager Application is defined on the "Create a New Package Wizard" (473). When creating a package, you do not have to select all of the available options.
Figure 14 Creating a Package
CSGDM-10.0-MFUG-2004-04-30
58
CSGDM-10.0-MFUG-2004-04-30
59
CSGDM-10.0-MFUG-2004-04-30
60
Examples
Figure 15, "Variable-Length Blocks" (3-60) provides shows how a file looks on an IBM system when the blocks are sent as variable-length blocks. The blocks are mapped into the fixed block format of 2048 bytes that the system uses for disk files. These blocks can be broken in the middle of a data record.
Figure 15 Variable-Length Blocks
Figure 16, "Fixed Length Blocks" (3-60) provides shows the same data records that are padded out to match the mainframe fixed block size. The extra padding characters are added by Package Manager and sent as part of the file.The receiving system uses them to make the blocks a fixed size on its system. This configuration places a single block into a fixed-size block on the mainframe.
Figure 16 Fixed Length Blocks
CSGDM-10.0-MFUG-2004-04-30
61
CSGDM-10.0-MFUG-2004-04-30
62
ff01 ff ff03
End-of-Record Sequence
With the end-of-record sequences, the end-of-record characters are inserted at the end of each usage record. However, the end-of-record sequence is not included in the record length field if one already exists. End-of-record sequences are not bit stuffed, even if bit stuffing is specified on the page.
CSGDM-10.0-MFUG-2004-04-30
63
CSGDM-10.0-MFUG-2004-04-30
64
Auditing a Package
The Package Manager audit feature is not on a separate page. Instead, this feature is located on the "Package Manager Application Page" (487). This audit feature lets you audit a package for potential errors. When you click the Audit Button, the system makes sure that the package contains everything that it requires to process the package. Audit a package whenever you create a new package using the wizard or whenever you update a package. A new Package Manager Application has to be audited before it can be used.
Figure 17 The Package Manager Application Page with the Audit Section
After you run the audit, the audit messages are listed in the Results box and the information in the Last Audited field is updated with the date and time of the latest audit. When a package manager audit fails, use the information in the audit messages to help you start troubleshooting the issue.
CSGDM-10.0-MFUG-2004-04-30
65
CSGDM-10.0-MFUG-2004-04-30
This section describes the package manager pages, including information on: Creating package manager applications Updating package manager applications Opening the package manager pages
CSGDM-10.0-MFUG-2004-04-30
69
Elements
These elements are on this page and are described in the Data Dictionary: Description Input File Format (for Mediation Features) Name Output File Format
CSGDM-10.0-MFUG-2004-04-30
70
2.
CSGDM-10.0-MFUG-2004-04-30
71
2.
CSGDM-10.0-MFUG-2004-04-30
72
2.
CSGDM-10.0-MFUG-2004-04-30
73
Elements
These elements are on this page and are described in the Data Dictionary: Delete Empty File Headers/Trailers Delete Empty Tier 1 Block Headers/Trailers? Delete Empty Tier 2 Block Headers/Trailers? Delete Empty Tier 3 Block Headers/Trailers? Description Input File Format (for Mediation Features) Name Output File Format Transfer File Headers/Trailers Transfer Tier 1 Block Headers/Trailers
CSGDM-10.0-MFUG-2004-04-30
74
CSGDM-10.0-MFUG-2004-04-30
75
Elements
These elements are on this page and are described in the Data Dictionary: Base Block Descriptor Word Block Type Data Length (for Block Descriptor Word) Data Records (for Package Manager Record Blocking Page) Default Value (for Block Descriptor Words) End of Block Sequence Field Length File Headers/Trailers (For Package Manager Record Blocking Page) Format Include in Block Length Include in Block Record Count Length Maximum Block Length Maximum Records per Block Package Manager Name Record Blocking Replace a Tier 1 Block Header Start Position
CSGDM-10.0-MFUG-2004-04-30
76
Tier 1 Block Headers/Trailers (for Package Manager Record Blocking Page) Tier 2 Block Headers/Trailers (for Package Manager Record Blocking Page) Tier 3 Block Headers/Trailers (for Package Manager Record Blocking Page) Value (for Package Manager)
CSGDM-10.0-MFUG-2004-04-30
77
Elements
These elements are on this page and are described in the Data Dictionary: Bit Stuff Sequence Data Records (for Package Manager Record Structure Mapping Page) Delete Bytes from the Beginning End of File Sequence End of Record Sequence File Headers/Trailers (For Package Manager Record Structure Mapping Page) Format Length (for Package Manager Record Structure Mapping Page) Package Manager Name Tier 1 Block Headers/Trailers (for Package Manager Record Structure Mapping Page) Tier 2 Block Headers/Trailers (for Package Manager Record Structure Mapping Page) Tier 3 Block Headers/Trailers (for Package Manager Record Structure Page) Value (for Package Manager)
CSGDM-10.0-MFUG-2004-04-30
78
3.
6.
CSGDM-10.0-MFUG-2004-04-30
79
Include in Block Record Count Include in Block Length Replace a Tier 1 Block Header 7. To turn the end-of-block sequence on, select the End of Block Sequence check box, then fill out these form fields: Format Length Value (for Package Manager) 8. Click Next. The wizard opens the Package Manager Record Structure Mapping screen. To turn the end-of-record sequence on, select the End of Record Sequence check box, then fill out these form fields: Format Length Value (for Package Manager) 10. To turn the bit stuff sequence on, select the Bit Stuff Sequence check box, then fill out these form fields: Format Length Value (for Package Manager) 11. To turn the end-of-file sequence on, select the End of File Sequence check box, then fill out these form fields: Format Length Value 12. To delete bytes from the beginning, select the Delete Bytes from the Beginning check box, then fill out these form fields: File Headers/Trailers (For Package Manager Record Structure Mapping Page) Data Records (for Package Manager Record Structure Mapping Page) Tier 1 Block Headers/Trailers (for Package Manager Record Structure Mapping Page) Tier 2 Block Headers/Trailers (for Package Manager Record Structure Mapping Page) Tier 3 Block Headers/Trailers (for Package Manager Record Structure Page) 13. Click Finish.
9.
CSGDM-10.0-MFUG-2004-04-30
81
Elements
These elements are on this page and are described in the Data Dictionary: Description Input File Format (for Mediation Features) Output File Format Package Manager Name
CSGDM-10.0-MFUG-2004-04-30
82
2.
Click Package Manager Applications. The Package Manager Applications page opens.
3.
Click the Name of the package manager application in the table. The Package Manager Summary page opens.
CSGDM-10.0-MFUG-2004-04-30
83
2.
CSGDM-10.0-MFUG-2004-04-30
84
2.
CSGDM-10.0-MFUG-2004-04-30
85
2.
CSGDM-10.0-MFUG-2004-04-30
87
CSGDM-10.0-MFUG-2004-04-30
88
Elements
These elements are on this page and are described in the Data Dictionary: Audit Button Audited? Delete Empty File Headers/Trailers Delete Empty Tier 1 Block Headers/Trailers? Delete Empty Tier 2 Block Headers/Trailers? Delete Empty Tier 3 Block Headers/Trailers? Description Input File Format (for Mediation Features) Last Audited Name Output File Format Transfer File Headers/Trailers Transfer Tier 1 Block Headers/Trailers Transfer Tier 2 Block Headers/Trailers Transfer Tier 3 Block Headers/Trailers
CSGDM-10.0-MFUG-2004-04-30
89
2.
Click Package Manager Applications. The Package Manager Applications page opens.
3.
Click the Name of the package manager application in the table. The Package Manager Summary page opens. Click Package Manager Application. The Package Manager Application page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
90
2.
CSGDM-10.0-MFUG-2004-04-30
91
2.
CSGDM-10.0-MFUG-2004-04-30
92
CSGDM-10.0-MFUG-2004-04-30
93
Elements
These elements are on this page and are described in the Data Dictionary: Base Block Descriptor Word Block Type Data Length (for Block Descriptor Word) Data Records (for Package Manager Record Blocking Page) Default Value (for Block Descriptor Words) End of Block Sequence Field Length File Headers/Trailers (For Package Manager Record Blocking Page) Format Include in Block Length Include in Block Record Count Length (for Package Manager Record Blocking Page)
CSGDM-10.0-MFUG-2004-04-30
94
Maximum Block Length Maximum Records per Block Package Manager Name Record Blocking Replace a Tier 1 Block Header Start Position Tier 1 Block Headers/Trailers (for Package Manager Record Blocking Page) Tier 2 Block Headers/Trailers (for Package Manager Record Blocking Page) Tier 3 Block Headers/Trailers (for Package Manager Record Blocking Page) Value (for Package Manager)
CSGDM-10.0-MFUG-2004-04-30
95
2.
Click Package Manager Applications. The Package Manager Applications page opens.
3.
Click the Name of the package manager application in the table. The Package Manager Summary page opens. Click the Package Manager Record Blocking link. The Package Manager Record Blocking page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
96
2.
5.
CSGDM-10.0-MFUG-2004-04-30
97
6.
To turn the end of block sequence on, select the End of Block Sequence check box, then fill out these form fields: Format Length Value (for Package Manager)
7.
Click Submit.
CSGDM-10.0-MFUG-2004-04-30
99
Elements
These elements are on this page and are described in the Data Dictionary: Bit Stuff Sequence Data Records (for Package Manager Record Structure Mapping Page) Delete Bytes from the Beginning End of File Sequence End of Record Sequence File Headers/Trailers (For Package Manager Record Structure Mapping Page) Format Length (for Package Manager Record Structure Mapping Page) Package Manager Name
CSGDM-10.0-MFUG-2004-04-30
100
Tier 1 Block Headers/Trailers (for Package Manager Record Structure Mapping Page) Tier 2 Block Headers/Trailers (for Package Manager Record Structure Mapping Page) Tier 3 Block Headers/Trailers (for Package Manager Record Structure Page) Value (for Package Manager)
CSGDM-10.0-MFUG-2004-04-30
101
2.
The Package Manager Applications page opens. 3. Click the Name of the package manager application in the table. The Package Manager Summary page opens. Click Package Manager Record Structure Mapping.
4.
CSGDM-10.0-MFUG-2004-04-30
102
2.
CSGDM-10.0-MFUG-2004-04-30
This chapter describes the package manager applications, including information on: Overview Accessing the File Format Conversion Pages Setting Up a File Format Conversion Understanding the Three Types of File Format Conversions Working with Modules and File Format Conversion Installing a File Format Conversion Definition in the Application Streams Working Exception Handling and File Format Conversion Understanding the Data Process Flow and File Format Conversion
CSGDM-10.0-MFUG-2004-04-30
104
Overview
Using the File Format Conversion Application, you can convert records from a source input file format to a target output file format by: Merging different input formats into a single output format, sometimes referred to as normalization Creating customized output file formats on an individual destination basis File Format Conversion is based on the Generic Record Identification (GRID) feature. The GRID feature lets administrators create file format definitions, which consist of a set of record layout definitions as well as headers and trailers. Administrators can modify base file format definitions that come with Data Mediation or they can create new file format definitions. After these file formats are created, they are assigned to each input source so that Data Mediation can parse call detail records down to the individual field level. After these file format definitions are created with GRID, then the administrator can use the File Format Conversion Application to map input records to output records and then assign data transfers to a destination application to be packaged as this new output file format. A file format conversion can be performed in the source application stream or the destination application stream.
CSGDM-10.0-MFUG-2004-04-30
105
When you click the File Format Conversion Applications link, the File Format Conversion Applications Page opens, which is a container page that lists all the file format conversions in a table.
Figure 27 The File Format Conversion Applications Container Page
CSGDM-10.0-MFUG-2004-04-30
106
When you click a link in this table, the corresponding File Format Conversion Application Page opens. This page provides links to other file format conversion application pages.
Figure 28 File Format Conversion Application Page
CSGDM-10.0-MFUG-2004-04-30
107
When you click the new icon on this page, the new File Format Conversion Application Page opens with empty form fields. No other file format conversion page icons appear until after you fill out these form fields and submit the page.
Figure 29 The New File Format Conversion Application page
CSGDM-10.0-MFUG-2004-04-30
108
After the file format definitions are created with GRID, you can set the rules using the File Format Conversion Application to transform records from one format to another format by: Defining global defaults Set a standard global default for each field type in the file format. This value is placed into a field for that defined type for each output record that is generated unless another mapping takes place Defining field defaults Determine the value for a specific field basis that is placed in a target field if a higher precedence mapping is defined, but no value is generated from the mapping Mapping fields Identify fields from the input file format and associate them with the fields in the output file format
CSGDM-10.0-MFUG-2004-04-30
109
Mapping records Build individual fields for the output record using values from the input record. These values do not have to be the actual field values from the input record and, instead, can reference the values as with a table lookup, to create an output field value
CSGDM-10.0-MFUG-2004-04-30
110
Normalization
Normalization defines a file format that contains a single record format. All records, no matter what their file format, are mapped to this single record format. Normalization is performed so that potential downstream applications can build to a single input format if they know that Data Mediation is sending this data to them. Also, normalization reduces the number of format conversions that must be defined and executed.
Extraction
Extraction takes only the selected fields from an input record, performs a simple task such as reordering the fields, then sends the fields out to the downstream application.
References
For more information on GRID Field Attributes, see "Working with GRID Field Attributes" (13532)
CSGDM-10.0-MFUG-2004-04-30
111
CSGDM-10.0-MFUG-2004-04-30
112
CSGDM-10.0-MFUG-2004-04-30
113
CSGDM-10.0-MFUG-2004-04-30
114
References
For information about installing file format conversion applications, see "Source Application Associations Page" (2127) in the Sources User Guide or "Destination Application Associations Page" (255) in the Destinations User Guide For information about specifying the Exception File handling feature on input, see "Source Type Parameters Page" (281) in the Sources User Guide For information about specifying the Exception File handling feature on output, see "Destination Type Parameters Page" (245) in the Destinations User Guide
CSGDM-10.0-MFUG-2004-04-30
115
References
For information about how to manage and edit exception records, see "Working with Exceptions" (16) in the Data Files User Guide
CSGDM-10.0-MFUG-2004-04-30
116
CSGDM-10.0-MFUG-2004-04-30
This section describes the File Format Conversion pages, including information on: Creating File Format Conversions Updating File Format Conversions Opening File Format Conversion pages
CSGDM-10.0-MFUG-2004-04-30
119
Elements
These elements are on this page and are described in the Data Dictionary: Description Input File Format (for Mediation Features) Name Output File Format
CSGDM-10.0-MFUG-2004-04-30
120
2.
CSGDM-10.0-MFUG-2004-04-30
121
2.
CSGDM-10.0-MFUG-2004-04-30
122
2.
CSGDM-10.0-MFUG-2004-04-30
123
Elements
These elements are on this page and are described in the Data Dictionary: Audit Button Description Input File Format (for Mediation Features) Name
CSGDM-10.0-MFUG-2004-04-30
124
These elements also appear when you click Copy: New Name Old Name These elements also appear when you click Delete: Delete Audit File Results Name
CSGDM-10.0-MFUG-2004-04-30
125
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The existing File Format Conversion Application page opens.
CSGDM-10.0-MFUG-2004-04-30
126
2.
The File Format Conversion Applications page opens. 3. Click the New icon.
CSGDM-10.0-MFUG-2004-04-30
127
2.
CSGDM-10.0-MFUG-2004-04-30
128
2.
CSGDM-10.0-MFUG-2004-04-30
129
Elements
These elements are on this page and are described in the Data Dictionary: Description File Format Conversion ID Name
CSGDM-10.0-MFUG-2004-04-30
130
2.
The File Format Conversion Applications page opens. 3. 4. Click the Name of the file format conversion application. Click Value Lists in the Globals column. The Value Lists page opens.
CSGDM-10.0-MFUG-2004-04-30
131
CSGDM-10.0-MFUG-2004-04-30
132
CSGDM-10.0-MFUG-2004-04-30
133
CSGDM-10.0-MFUG-2004-04-30
135
CSGDM-10.0-MFUG-2004-04-30
136
Elements
These elements are on this page and are described in the Data Dictionary: Description File Format Conversion ID Input File Format (for Mediation Features) List Name Output File Format Value
CSGDM-10.0-MFUG-2004-04-30
137
2.
The File Format Conversion Applications page opens. 3. 4. 5. Click the Name of the file format conversion application. Click Value Lists in the Globals column. Click the New icon.
CSGDM-10.0-MFUG-2004-04-30
138
2.
The File Format Conversion Applications page opens. 3. 4. 5. Click the Name of the file format conversion application. Click Value Lists in the Globals column. Click the List Name of the value list in the table. The Value List page opens.
CSGDM-10.0-MFUG-2004-04-30
139
CSGDM-10.0-MFUG-2004-04-30
140
CSGDM-10.0-MFUG-2004-04-30
Add a Value
141
Add a Value
To add a value: 1. Click the New icon.
2.
3. 4.
CSGDM-10.0-MFUG-2004-04-30
142
Update a Value
To update a value: 1. Click the icon beside the value in the table. The form appears.
2.
3. 4.
CSGDM-10.0-MFUG-2004-04-30
143
Elements
These elements are on this page and are described in the Data Dictionary: Description File Format Conversion ID Name
CSGDM-10.0-MFUG-2004-04-30
144
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Table Lookup Value Lists in the Globals column. The Table Lookup Value Lists page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
145
2.
CSGDM-10.0-MFUG-2004-04-30
146
2.
CSGDM-10.0-MFUG-2004-04-30
147
CSGDM-10.0-MFUG-2004-04-30
148
Elements
These elements are on this page and are described in the Data Dictionary: Description File Format Conversion ID Input File Format Key Value List Name Name Output File Format Table Value
CSGDM-10.0-MFUG-2004-04-30
149
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Table Lookup Value Lists in the Globals column. The Table Lookup Value Lists page opens. Click the New icon.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
150
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Table Lookup Value Lists in the Globals column. The Table Lookup Value Lists page opens. Click the Name of the table lookup value list in the table. The Table Lookup Value List page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
151
2. 3. 4.
CSGDM-10.0-MFUG-2004-04-30
152
2.
CSGDM-10.0-MFUG-2004-04-30
Add a Value
153
Add a Value
To add a value: 1. Click the New icon.
2.
Fill out this form field: Key Value Target Field Name
3. 4.
CSGDM-10.0-MFUG-2004-04-30
154
Update a Value
To update a value: 1. Click the icon beside the value in the table. The form appears.
2.
3. 4.
CSGDM-10.0-MFUG-2004-04-30
155
Elements
These elements are on this page and are described in the Data Dictionary: Format Input File Format Length Mapping Complete? Name Output File Format Start (for Field Mappings)
CSGDM-10.0-MFUG-2004-04-30
156
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Application page opens. Click Field Mappings in the Mappings column. The Field Mappings page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
157
CSGDM-10.0-MFUG-2004-04-30
159
Elements
These elements are on this page and are described in the Data Dictionary: Description Expression (for Secondary Key Mappings) Field File Format Conversion ID Format Input File Format (for Mediation Features) Length Mapping Complete? Mapping Name Output File Format Start (for Field Mappings)
CSGDM-10.0-MFUG-2004-04-30
160
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Application page opens. Click Field Mappings in the Mappings column. The Field Mappings page opens. Click the ID of the Field Mapping in the table. The Field Mapping page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
161
The new mapping expression form appears. 3. Fill out these form fields in the form Mapping Name Start (for Field Mappings) Length 4. 5. Click Expression. The Expression subpage opens. Fill out these form fields at the top of the page: Justification Padding Default Value 6. Build the expression using expressions from the following drop-down menus: Mapping Operators Math Operators Date and Time Globals Comparison Operators GRID Counts 7. 8. Click Submit. Click Previous to go back to the Field Mapping page.
CSGDM-10.0-MFUG-2004-04-30
162
3.
CSGDM-10.0-MFUG-2004-04-30
163
Elements
These elements are on this page and are described in the Data Dictionary: Exclusive? Input File Format (for Mediation Features) Input Record Name Order Mapped Output Record Name Output File Format Secondary Key
CSGDM-10.0-MFUG-2004-04-30
164
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Record Mappings in the Mappings column. The Record Mappings page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
165
CSGDM-10.0-MFUG-2004-04-30
166
CSGDM-10.0-MFUG-2004-04-30
167
Elements
These elements are on this page and are described in the Data Dictionary: Description Exclusive? File Format Conversion ID Length Input File Format (for Mediation Features) Input Record Name Mapped? Max Trigger Value Offset Order Output Field Name
CSGDM-10.0-MFUG-2004-04-30
168
Output File Format Output Module Name Output Record Name Output Record Type Secondary Key Trigger Order Update Type (for File Format Conversion)
References
For information on updating a field mapping, see the "Field Mapping Page (File Format Conversion)" (6159) in this user guide For information on creating or updating module mappings, see the "Module Mapping Page (File Format Conversion)" (6201) in this user guide
CSGDM-10.0-MFUG-2004-04-30
169
2.
The File Format Conversion Applications page opens. 3. Click the name of the file format conversion application. The File Format Conversion Application page opens. Click Record Mappings in the Mappings column. The Record Mappings page opens. Click the New icon in the table.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
170
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Record Mappings in the Mappings column. The Record Mappings page opens. Click the ID for the Record Mapping in the table. The Record Mapping page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
171
5.
CSGDM-10.0-MFUG-2004-04-30
172
2.
4.
CSGDM-10.0-MFUG-2004-04-30
173
Elements
These elements are on this page and are described in the Data Dictionary: Expression (for Secondary Key Mappings) Input File Format (for Mediation Features) Input Record/Module Name Input Record Type Key Type Output File Format Secondary Key ID
CSGDM-10.0-MFUG-2004-04-30
174
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Secondary Key Mappings in the Mappings column. The Secondary Key Mappings page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
175
1.
2.
CSGDM-10.0-MFUG-2004-04-30
176
2.
CSGDM-10.0-MFUG-2004-04-30
177
CSGDM-10.0-MFUG-2004-04-30
178
Elements
These elements are on this page and are described in the Data Dictionary: Expression (for Secondary Key Mappings) Format Conversion ID Input Record Name Input Record Type Justification Key Type Secondary Key Padding
CSGDM-10.0-MFUG-2004-04-30
179
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Secondary Key Mappings in the Mappings column. The Secondary Key Mappings page opens. Click the New icon.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
180
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Secondary Key Mappings in the Mappings column. The Secondary Key Mappings page opens. Click the secondary key ID in the table. The Secondary Key Mapping page.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
181
2.
CSGDM-10.0-MFUG-2004-04-30
182
2.
CSGDM-10.0-MFUG-2004-04-30
183
2. 3.
4.
CSGDM-10.0-MFUG-2004-04-30
185
CSGDM-10.0-MFUG-2004-04-30
186
Elements
These elements are on this page and are described in the Data Dictionary: Exclusive? Input File Format (for Mediation Features) Input Record Name Maximum Value Order Output File Format Output Record Name Output Record Type Secondary Key Trigger Name Type
References
For more information on Triggers, see "Triggers" (115) in this user guide
CSGDM-10.0-MFUG-2004-04-30
187
2.
The File Format Conversion Applications page opens. 3. Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Block Header/Trailer Mappings in the Mappings column. The Block Header/Trailer Mappings page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
188
2.
CSGDM-10.0-MFUG-2004-04-30
189
2.
CSGDM-10.0-MFUG-2004-04-30
191
CSGDM-10.0-MFUG-2004-04-30
192
Elements
These elements are on this page and are described in the Data Dictionary: Exclusive? Input File Format (for Mediation Features) Input Record Name Maximum Value Order Output File Format Output Record Name Output Record Type Secondary Key Trigger Name Type
References
For more information about file header and trailer triggers, see "Triggers" (115)in this user guide
CSGDM-10.0-MFUG-2004-04-30
193
2.
3.
Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click File Header/Trailer Mappings in the Mappings column. The File Header/Trailer Mappings page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
194
2.
CSGDM-10.0-MFUG-2004-04-30
195
Elements
These elements are on this page and are described in the Data Dictionary: Exclusive? Input File Format (for Mediation Features) Input Module Name Order
CSGDM-10.0-MFUG-2004-04-30
196
Output File Format Output Module Name Output Module Type Secondary Key Trigger Name Type
CSGDM-10.0-MFUG-2004-04-30
197
2.
3.
Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
198
CSGDM-10.0-MFUG-2004-04-30
199
CSGDM-10.0-MFUG-2004-04-30
201
Elements
These elements are on this page and are described in the Data Dictionary: Description Exclusive? File Format Conversion ID Input File Format (for Mediation Features) Input Module Name Length Mapped?
CSGDM-10.0-MFUG-2004-04-30
202
Module Secondary Key Offset Order Output Field Name Output File Format Output Module Name
References
For information on updating the Field Mappings, see the "Field Mapping Page (File Format Conversion)" (6159) in this user guide
CSGDM-10.0-MFUG-2004-04-30
203
2.
3.
Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens. Click the New icon in the table.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
204
2.
3.
Click the Name of the file format conversion application. The File Format Conversion Application page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens. Click the ID for the module mapping in the table. The Module Mapping page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
205
CSGDM-10.0-MFUG-2004-04-30
This chapter describes the correlation applications, including information on: Overview Accessing the Correlation Conversion Pages Defining Correlation Rules Working with Correlation Mapping Working with Control Data Fields and Control Action Fields Working with Output File Management Working with Correlation File Conversions Working with Correlation IDs Working with Output File Management Working with Output Record Management Working with CORFILTER
CSGDM-10.0-MFUG-2004-04-30
208
Overview
To meet the billing problems that have come with high-bandwidth Internet access, mobile Internet access, e-commerce, and content-enhanced value-added services, CSG offers the correlation applications, which are highly flexible, are event-based, and provide truly convergent mediation capabilities, to help service providers bill timely and accurately for these services. Using the correlation applications, an administrator can define rules for how related records are identified, matched together, and combined into a single complete event record. The system then uses these rules to match related records, account for time stamp synchronization between sources, and generate a complete record of the event that can be sent to downstream applications, such as billing. Events can be received from different elements in the network, in different data formats, and in non-sequential time order. The correlation feature converts and combines multiple records from the same event into a one or more billable records by: Identifying the records that require correlation Storing records until all related records are received Harvesting the completed records into a file for distribution to one or more downstream destinations The correlation feature is based on the functionality of two underlying Data Mediation system features: Generic Record Identification (GRID) defines the input file format and the correlation file format. The correlation file format is the user-defined structure for all correlation records stored in and harvested from the correlation store Format Conversion maps one data file format to another. The correlation feature needs to convert one or more input file formats to the user-defined correlation file format, requiring some of the functionality of the format conversion feature, so this functionality is embedded in the correlation feature
CSGDM-10.0-MFUG-2004-04-30
Overview
209
CSGDM-10.0-MFUG-2004-04-30
210
When you click the Correlation Applications link, the Correlation Applications Page opens, which lists the links to the three correlation applications.
Figure 50 The Correlation Applications Page
CSGDM-10.0-MFUG-2004-04-30
211
When you click one of these links, the corresponding application container page opens.
Table 4 Correlation Applications Icons and the Corresponding Pages
CSGDM-10.0-MFUG-2004-04-30
212
CSGDM-10.0-MFUG-2004-04-30
213
CSGDM-10.0-MFUG-2004-04-30
214
CSGDM-10.0-MFUG-2004-04-30
215
CSGDM-10.0-MFUG-2004-04-30
216
4.
CSGDM-10.0-MFUG-2004-04-30
217
The administrator defines the correlation file format and then defines the rules for mapping each of the identified input records to the correlation file format. In addition to using the correlation application to account for the difference between source time stamps and synchronize the records, the administrator can configure: Field default values If the administrator does not assign any mapping rules to a particular field, it is automatically assigned a default value Value lists and table lookup value lists Lists of values or sequences of name/value pairs (tables) can be defined and so that they can be included as part of the conversion logic Field-level mappings These mappings can be used if a correlation store record field is always mapped with the same rules, regardless of the input record type Record-level mappings These mappings can be used to define sets of rules that are specific to a particular input record type Secondary keys mappings this option is available when record mapping is required, but the mapping rules depend on the value of some field or set of fields within the input record. Secondary key mapping supports record to record-level mappings, record-to-module mappings, and module-to-module mappings External tables The correlation module can retrieve list and table information from external data sources, possibly located on a remote system. The data can be located in an external relational database or in a flat file
CSGDM-10.0-MFUG-2004-04-30
218
Arithmetic and logical operators ifthenelse type statements can be developed using or logic in parenthetical expressions and combined with relational and arithmetic operators Predefined functions, including date and time functions These predefined functions let an administrator easily deal with operations such as calculating the difference between two date/time stamps, converting from one date/time format to another, shifting characters, padding fields, and so on Administrator-defined environment variables that are accessed at runtime Support for sequence numbers sequence numbers, which can be incremented and used within a correlation definition, can be defined. There are also strings that can be used as variables to store information from one record that is needed in processing subsequent records.
CSGDM-10.0-MFUG-2004-04-30
219
Correlation Rules
The administrator defines the rules for converting an input record to a record in the correlation store. Along with the standard functions available in the format module, the correlation applications have many functions and mapping rules that are just for correlation, including mapping rules for: uniquely identifying an event creating the first record of an event adding information from a subsequent event record to an existing correlation store record timing out records that have not received all their expected information In addition to the record fields within the correlation store record itself, each record also has a set of control data fields and control action fields associated with it. The control data fields include when the record was originally inserted into the correlation store, when the correlation store record was last updated, the correlation key for the record, and several others. The administrator has the option of defining rules to populate these control data fields. For example, the time the record was last updated defaults to Data Mediation's system time when the record was last changed; however, there can be situations where the timestamp within the input record is used instead. The control action fields let the administrator define the action to be taken when certain conditions occur. For example, if this is the first record in the correlation, there can be certain mapping rules the administrator wants to apply. Similarly, if this is the last record in the correlation, there can be another set of rules to be applied. There also can be certain conditions where the administrator wants to mark the event as complete.
CSGDM-10.0-MFUG-2004-04-30
220
CSGDM-10.0-MFUG-2004-04-30
221
CSGDM-10.0-MFUG-2004-04-30
222
CSGDM-10.0-MFUG-2004-04-30
223
Default Record Management mappings defined on this page can be overridden on an individual record type basis by using the Output Record Management Page. Use this page to determine: How often records are harvested from the correlation store The maximum number of correlation records allowed in an output file generated by the harvest process How long an incomplete record can stay in the correlation store The point that the incomplete record timeout period is measured The action to execute if a record is identified as incomplete and the timeout period has expired The action to execute if a correlation ID is deleted or the correlation store must be rebuilt
CSGDM-10.0-MFUG-2004-04-30
224
Harvest Process
The harvest process is initiated by the Generate Output File Interval field. At the occurrence of each time interval specified in the Generate Output File Interval field, the harvest process performs one or more of these actions: Selects all records from the correlation store that have correlation record State set to User Set Complete Record. The selected records are written to a file in the primary or tertiary directory of the associated correlation source. The selected records are deleted from the correlation store Selects all records from the correlation store that have correlation record State set to Exception Record. The selected records are written to a file in the exception directory of the associated correlation source. The selected records are deleted from the correlation store Selects all records from the correlation store that are incomplete and whose Incomplete Record Timeout Interval has expired. The associated Incomplete Record Action rules are executed for each selected record
CSGDM-10.0-MFUG-2004-04-30
225
CSGDM-10.0-MFUG-2004-04-30
226
References
For more information on installing a CORFILTER, see the "Source Application Associations Page" (2127) in the Sources User Guide
CSGDM-10.0-MFUG-2004-04-30
This section describes the correlation mediation features, including information on: Opening the Correlation Applications page Mapping objects such as fields, records, and modules Using the correlation feature
CSGDM-10.0-MFUG-2004-04-30
229
CSGDM-10.0-MFUG-2004-04-30
230
2.
CSGDM-10.0-MFUG-2004-04-30
231
2.
CSGDM-10.0-MFUG-2004-04-30
232
2.
CSGDM-10.0-MFUG-2004-04-30
233
2.
CSGDM-10.0-MFUG-2004-04-30
This section describes the Correlation ID pages, including information on: Creating a Correlation ID Updating a Correlation ID Opening the Correlation ID pages
CSGDM-10.0-MFUG-2004-04-30
237
Elements
These elements are on this page and are described in the Data Dictionary: Name Correlation File Format Description
CSGDM-10.0-MFUG-2004-04-30
238
2.
3.
CSGDM-10.0-MFUG-2004-04-30
239
CSGDM-10.0-MFUG-2004-04-30
240
CSGDM-10.0-MFUG-2004-04-30
Correlation ID Page
241
Correlation ID Page
After you "Open a New Correlation ID Page" (9242), you can "Create a Correlation ID" (9244). After you "Open an Existing Correlation ID Page" (9243), you can "Update a Correlation ID" (9245).
Figure 56 Correlation ID Page
Elements
These elements are on this page and are described in the Data Dictionary: Audit Button Audited? Audit Results Correlation File Format Description Key Padding Character Last Audited Maximum Number of Modules Module Key Length Name Rebuild Correlation Store Structure Key Length
CSGDM-10.0-MFUG-2004-04-30
242
2.
3.
4.
CSGDM-10.0-MFUG-2004-04-30
243
2.
3.
4.
Click the Name of the Correlation ID in the table. The Correlation ID page opens.
CSGDM-10.0-MFUG-2004-04-30
244
Create a Correlation ID
To create a correlation ID: 1. 2. Follow the instructions to "Open a New Correlation ID Page" (9242). Fill out these form fields at the top of the page: Name Correlation File Format Description 3. Set these key values: Structure Key Length Key Padding Character Module Key Length Maximum Number of Modules 4. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
Update a Correlation ID
245
Update a Correlation ID
To update a correlation ID: 1. 2. Follow the instructions to "Open an Existing Correlation ID Page" (9243). Fill out these form fields at the top of the page: Correlation File Format Description 3. Set these key values: Structure Key Length Key Padding Character Module Key Length Maximum Number of Modules 4. 5. Click Submit. Update your global settings by clicking these links on the screen: Value Lists Table Lookup Value Lists 6. Update these management settings by clicking these links on the screen: Output File Management Output Record Management Correlation Conversion Assignments Correlation Conversion Application Manager Source Assignments 7. To audit the correlation ID, click Audit. The audit results appear in the Audit Results text box.
CSGDM-10.0-MFUG-2004-04-30
247
Elements
These elements are on this page and are described in the Data Dictionary: List Name Correlation ID Description
CSGDM-10.0-MFUG-2004-04-30
248
2.
3.
4.
Click the Name of the Correlation ID in the table. The Correlation ID page opens. Click Value Lists in the Global column. The Value Lists page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
249
CSGDM-10.0-MFUG-2004-04-30
250
CSGDM-10.0-MFUG-2004-04-30
251
CSGDM-10.0-MFUG-2004-04-30
253
Elements
These elements are on this page and are described in the Data Dictionary: Description List Name List Value
CSGDM-10.0-MFUG-2004-04-30
254
2.
3.
4.
Click the Name of the Correlation ID in the table. The Correlation ID page opens. Click Value Lists in the Global column. The Value Lists page opens. Click the New icon.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
255
2.
3.
4.
Click the Name of the Correlation ID in the table. The Correlation ID page opens. Click Value Lists in the Global column. The Value Lists page opens. Click the List Name for the value list in the table. The Value List page opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
256
CSGDM-10.0-MFUG-2004-04-30
257
5.
CSGDM-10.0-MFUG-2004-04-30
258
CSGDM-10.0-MFUG-2004-04-30
259
2.
CSGDM-10.0-MFUG-2004-04-30
261
Elements
These elements are on this page and are described in the Data Dictionary: Correlation ID Description List Name
CSGDM-10.0-MFUG-2004-04-30
262
2.
3.
4.
Click the Name of the Correlation ID in the table. The Correlation ID page opens. Click Table Lookup Value Lists in the Global column. The Table Lookup Value Lists page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
263
2.
CSGDM-10.0-MFUG-2004-04-30
264
2.
CSGDM-10.0-MFUG-2004-04-30
265
CSGDM-10.0-MFUG-2004-04-30
266
Elements
These elements are on this page and are described in the Data Dictionary: Description Key List Name Value
CSGDM-10.0-MFUG-2004-04-30
267
2.
3.
4.
Click the Name of the Correlation ID in the table. The Correlation ID page opens. Click Table Lookup Value Lists in the Global column. The Table Lookup Value Lists page opens. Click the New icon.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
268
2.
3.
4.
Click the Name of the Correlation ID in the table. The Correlation ID page opens. Click Table Lookup Value Lists in the Global column. The Table Lookup Value Lists page opens. Click the List Name for the table lookup value list in the table. The Table Lookup Value List page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
269
2.
4.
CSGDM-10.0-MFUG-2004-04-30
270
2.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
271
The new table lookup value form opens. 2. Fill out these form fields: Key Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
272
2.
CSGDM-10.0-MFUG-2004-04-30
273
Elements
These elements are on this page and are described in the Data Dictionary: Delete ID Action Mapping ID Expression Button Generate Output File Interval Incomplete Record Action Mapping ID Incomplete Record Timeout Interval Maximum Record Count Per File Measure Incomplete Timeout Record From
References
For a detailed description and usage information for mapping the Incomplete Record Action control field, see "Correlation ID Definition and Control Fields" (17483) in the GML Developer Reference Guide
CSGDM-10.0-MFUG-2004-04-30
274
2.
3.
4.
Click the Name of the correlation ID in the table. The Correlation ID page opens. Click Output File Management in the Management column. The Output File Management page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
275
2.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
277
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Correlation ID Delete ID Action Mapping ID Delete ID Mapping Incomplete Record Action Mapping ID Incomplete Record Mapping Incomplete Record Timeout Interval Measure Incomplete Timeout Record From Record Name
CSGDM-10.0-MFUG-2004-04-30
278
2.
3.
4.
Click the Name of the correlation ID in the table. The Correlation ID page opens. Click Output Record Management in the Management column. The Output Record Management page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
279
2. 3.
5.
To enter either an new Incomplete Record Action Mapping ID or Delete ID Action Mapping ID, enter a name, then click Expression. The information on the Output Record Management page is saved and the Output Record Expression page opens. Click Submit.
6.
CSGDM-10.0-MFUG-2004-04-30
281
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Input File Format (for Mediation Features) Name
CSGDM-10.0-MFUG-2004-04-30
282
2.
3.
4.
Click the Name of the correlation ID in the table. The Correlation ID page opens. Click Correlation Conversion Assignments in the Management column. The Correlation Conversion Assignments page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
Assign Conversions
283
Assign Conversions
To assign conversions: 1. Follow the instructions to "Open the Correlations Conversion Assignments Page" (9282). Click the icon beside the conversion in the Unassigned Conversion table. The conversion is moved to the Assigned Conversions table. Click Submit.
2.
3.
CSGDM-10.0-MFUG-2004-04-30
284
Unassign Conversions
To unassign conversions: 1. Follow the instructions to "Open the Correlations Conversion Assignments Page" (9282). Click the icon beside the conversion in the Assigned Conversion table. The conversion is moved to the Unassigned Conversions table. Click Submit.
2.
3.
CSGDM-10.0-MFUG-2004-04-30
285
CSGDM-10.0-MFUG-2004-04-30
286
Elements
These elements are on this page and are described in the Data Dictionary: Application Name Correlation ID Input File Format (for Mediation Features) Name Order Type (for Correlation Conversion Application Manager)
CSGDM-10.0-MFUG-2004-04-30
287
2.
3.
4.
Click the Name of the correlation ID in the table. The Correlation ID page opens. Click Correlation Conversion Application Manager in the Management column. The Correlation Conversion Application Manager page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
288
2.
3. 4.
CSGDM-10.0-MFUG-2004-04-30
289
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Name Status
CSGDM-10.0-MFUG-2004-04-30
290
2.
3.
4.
Click the Name of the correlation ID in the table. The Correlation ID page opens. Click Source Assignments in the Management column. The Source Assignments page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
Assign Sources
291
Assign Sources
To assign sources: 1. 2. Follow the instructions to "Open the Source Assignments Page" (9290). Click the icon beside the source name in the Unassigned Sources table. The source is moved to the Assigned Sources table. Click Submit.
3.
CSGDM-10.0-MFUG-2004-04-30
292
Unassign Sources
To unassign sources: 1. 2. Follow the instructions to "Open the Source Assignments Page" (9290). Click the icon beside the source name in the Assigned Sources table. The source is moved to the Unassigned Sources table. Click Submit.
3.
CSGDM-10.0-MFUG-2004-04-30
293
Elements
These elements are on this page and are described in the Data Dictionary: Correlation ID Expression (for Output File and Output Record Management) Field Name (Expression Page) Justification Mapping ID Name Padding
CSGDM-10.0-MFUG-2004-04-30
294
Elements
These elements are on this page and are described in the Data Dictionary: Correlation ID Expression (for Secondary Key Mappings) Field Name (Expression Page) Justification Mapping ID Name Padding Record
CSGDM-10.0-MFUG-2004-04-30
295
2.
3.
4.
Click the Name of the correlation ID in the table. The Correlation ID page opens. Click Output File Management. The Output File Management page opens. To update the Incomplete Record Action Mapping ID or Delete ID Action Mapping ID, click Expression. The information on the Output File Management page is saved and the Output File Expression page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
296
7.
To enter an new Incomplete Record Action Mapping ID or Delete ID Action Mapping ID, enter a name, then click Expression. The information on the Output File Management page is saved and the Output File Expression page opens.
CSGDM-10.0-MFUG-2004-04-30
297
2.
3.
4.
Click the Name of the correlation ID in the table. The Correlation ID page opens. Click Output Record Management. The Output Record Management page opens. To update the Incomplete Record Action Mapping ID or Delete ID Action Mapping ID, click Expression. The information on the Output Record Management page is saved and the Output Record Expression page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
298
7.
To enter an new Incomplete Record Action Mapping ID or Delete ID Action Mapping ID, enter a name, then click Expression. The information on the Output Record Management page is saved and the Output Record Expression page opens.
CSGDM-10.0-MFUG-2004-04-30
Create an Expression
299
Create an Expression
To create an expression: 1. Follow the instructions to "Open the Output File Management Expression Page" (9295) or "Open the Output Record Management Expression Page" (9297). Fill out these form fields: Justification Padding 3. 4. 5. Build expressions using the items in the drop-down menus: Click Submit. Click Close.
2.
CSGDM-10.0-MFUG-2004-04-30
300
CSGDM-10.0-MFUG-2004-04-30
This section describes how to use the correlation file conversion pages, including information on: Creating a correlation file conversion Updating the correlation file conversion pages Opening the correlation file conversion pages
CSGDM-10.0-MFUG-2004-04-30
303
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Description Input File Format (for Mediation Features) Name
CSGDM-10.0-MFUG-2004-04-30
304
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
CSGDM-10.0-MFUG-2004-04-30
305
2.
CSGDM-10.0-MFUG-2004-04-30
306
2.
CSGDM-10.0-MFUG-2004-04-30
307
CSGDM-10.0-MFUG-2004-04-30
308
Elements
These elements are on this page and are described in the Data Dictionary: Audit Button Audited? Audit Results Correlation File Format Description Input File Format (for Mediation Features) Last Audited Name
References
"Value Lists Page (Correlation File Conversion)" (10313) in this user guide "Table Lookup Value Lists Page (Correlation File Conversion)" (10327) in this user guide "Field Mappings Page (Correlation File Conversion)" (10341) in this user guide "Secondary Key Mappings Page (Correlation File Conversion)" (10353) in this user guide "Record Mappings Page (Correlation File Conversion)" (10359) in this user guide "Module Mapping Page (Correlation File Conversion)" (10397) in this user guide
CSGDM-10.0-MFUG-2004-04-30
309
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
310
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens.
CSGDM-10.0-MFUG-2004-04-30
311
2.
CSGDM-10.0-MFUG-2004-04-30
312
2.
CSGDM-10.0-MFUG-2004-04-30
313
Elements
These elements are on this page and are described in the Data Dictionary: List Name Correlation File Conversion ID Description
CSGDM-10.0-MFUG-2004-04-30
314
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the correlation conversion in the table. The Correlation File Conversion page opens. Click Value Lists. The Value Lists page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
315
CSGDM-10.0-MFUG-2004-04-30
316
CSGDM-10.0-MFUG-2004-04-30
317
CSGDM-10.0-MFUG-2004-04-30
319
CSGDM-10.0-MFUG-2004-04-30
320
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Correlation File Format Description Input File Format (for Mediation Features) List Name List Value
CSGDM-10.0-MFUG-2004-04-30
321
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Value Lists. The Value Lists page opens. Click the New icon.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
322
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Value Lists. The Value Lists page opens. Click the List Name in the table. The Value List page opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
323
CSGDM-10.0-MFUG-2004-04-30
324
CSGDM-10.0-MFUG-2004-04-30
Add a Value
325
Add a Value
To add a value: 1. Click the New icon.
The new value form appears. 2. Fill out this form field: List Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
326
Update a Value
To update a value: 1. 2. Click the icon beside the List Value in the table. The value form appears. Update this form field: List Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
327
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Description List Name
CSGDM-10.0-MFUG-2004-04-30
328
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Table Lookup Value Lists. The Table Lookup Value Lists page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
329
2.
CSGDM-10.0-MFUG-2004-04-30
330
2.
CSGDM-10.0-MFUG-2004-04-30
331
CSGDM-10.0-MFUG-2004-04-30
332
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Correlation File Format Description Input File Format (for Mediation Features) Key List Name Value
CSGDM-10.0-MFUG-2004-04-30
333
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Table Lookup Value Lists. The Table Lookup Value Lists page opens. Click the New icon.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
334
CSGDM-10.0-MFUG-2004-04-30
335
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Table Lookup Value Lists. The Table Lookup Value Lists page opens. Click the List Name for the table lookup value list in the table. The Table Lookup Value List page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
336
2.
4. 5.
CSGDM-10.0-MFUG-2004-04-30
337
2.
4.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
338
The new table lookup value form opens. 2. Fill out these form fields: Key Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
339
2.
CSGDM-10.0-MFUG-2004-04-30
340
CSGDM-10.0-MFUG-2004-04-30
341
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Field Mapping ID Format Input File Format (for Mediation Features) Length Mapped? Name Start (for Field Mappings) Total Length
CSGDM-10.0-MFUG-2004-04-30
342
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Field Mappings. The Field Mappings page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
343
CSGDM-10.0-MFUG-2004-04-30
344
CSGDM-10.0-MFUG-2004-04-30
345
CSGDM-10.0-MFUG-2004-04-30
346
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Correlation File Format Description Field Format (for Correlation File Conversion) Field Length (for Correlation File Conversion) Field Name (for Correlation File Conversion) Input File Format (for Mediation Features) Length Mapping ID Start (for Field Mappings)
CSGDM-10.0-MFUG-2004-04-30
347
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Field Mappings. The Field Mappings page opens. Click the Name of the data field in the Control Data Fields or Record Data Fields table. The Data Field Mapping page opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
348
3.
CSGDM-10.0-MFUG-2004-04-30
349
CSGDM-10.0-MFUG-2004-04-30
350
The mapping form opens. 3. Fill out these form fields: Mapping ID Start (for Field Mappings) Length 4. 5. Click Expression. A new window opens with the Expression page. Fill out these form fields: Justification Padding Default Value 6. 7. 8. Build an expression using the expressions listed in the drop-down menu. Click Close. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
Update a Mapping
351
Update a Mapping
To update a mapping: 1. 2. 3. 4. Follow the instructions to "Open the Data Field Mapping Page" (10347). Click the icon beside the mapping ID. The mapping form opens. Click Expression. A new window opens with the Expression page. Update these form fields: Justification Padding Default Value 5. 6. 7. Build an expression using the expressions listed in the drop-down menu. Click Close. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
353
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Expression (for Secondary Key Mappings) Input File Format (for Mediation Features) Key Type Secondary Key Source Record/Module
CSGDM-10.0-MFUG-2004-04-30
354
References
For more information on the Secondary Key Mapping page, see "Secondary Key Mapping Page (Correlation File Conversion and Correlation Store Conversion)" (245) in this user guide
CSGDM-10.0-MFUG-2004-04-30
355
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Secondary Key Mappings. The Secondary Key Mappings page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
356
2.
CSGDM-10.0-MFUG-2004-04-30
357
2.
CSGDM-10.0-MFUG-2004-04-30
359
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Correlation Record Name Exclusive? Input File Format (for Mediation Features) Input Record Name Order Secondary Key
CSGDM-10.0-MFUG-2004-04-30
360
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Record Mappings. The Record Mappings page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
361
CSGDM-10.0-MFUG-2004-04-30
362
CSGDM-10.0-MFUG-2004-04-30
363
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Correlation File Format Correlation Module Name
CSGDM-10.0-MFUG-2004-04-30
364
Correlation Record Name Exclusive? Input File Format (for Mediation Features) Input Record Name Mapped? Name Offset Order Secondary Key
CSGDM-10.0-MFUG-2004-04-30
365
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Record Mappings. The Record Mappings page opens. Click the New icon.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
366
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Record Mappings. The Record Mappings page opens. Click the ID for the record mapping in the table. The Record Mapping page opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
367
CSGDM-10.0-MFUG-2004-04-30
368
2.
CSGDM-10.0-MFUG-2004-04-30
Go to an Expression Page
369
Go to an Expression Page
To go to an Expression page: 1. Follow the instructions to "Open an Existing Record Mapping Page" (10 366). Click the Name of the data field in the Control Action Fields table. A new window opens with the Expression page.
2.
CSGDM-10.0-MFUG-2004-04-30
370
2.
CSGDM-10.0-MFUG-2004-04-30
371
2.
CSGDM-10.0-MFUG-2004-04-30
372
2.
CSGDM-10.0-MFUG-2004-04-30
373
Elements
These elements are on this page and are described in the Data Dictionary: Field Format (for Correlation File Conversion) Field Length (for Correlation File Conversion) Field Name (for Correlation File Conversion) Correlation File Conversion ID Correlation File Format Correlation Record Name Description Input File Format (for Mediation Features) Input Record Name Length Mapping ID
CSGDM-10.0-MFUG-2004-04-30
374
CSGDM-10.0-MFUG-2004-04-30
375
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Record Mappings. The Record Mappings page opens. Click the ID beside the record mapping in the table. The Record Mapping page opens. Click the Name of a control data field in the Control Data Fields or Record Data Fields table. The Data Field Mapping page opens.
5. 6.
7.
CSGDM-10.0-MFUG-2004-04-30
376
2.
The mapping form opens. 3. Fill out these form fields: Mapping ID Start (for Field Mappings) Length 4. 5. Click Expression. A new window opens with the Expression page. Fill out these form fields: Justification Padding Default Value 6. 7. 8. Build an expression using the expressions listed in the drop-down menu. Click Close. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
377
CSGDM-10.0-MFUG-2004-04-30
379
CSGDM-10.0-MFUG-2004-04-30
380
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Correlation File Format Correlation Module Name Exclusive? Input File Format (for Mediation Features) Input Record Name Mapped? Name Offset Order Secondary Key
CSGDM-10.0-MFUG-2004-04-30
381
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Record Mappings. The Record Mappings page opens. Click the arrow beside Record-to-Module Mappings. The Record-toModule Mappings table opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
382
7.
CSGDM-10.0-MFUG-2004-04-30
383
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Record Mappings. The Record Mappings page opens. Click the arrow beside Record-to-Module Mappings. The Record-toModule Mappings table opens. Click the ID for the record-to-module mapping in the Record-to-Module Mapping table. The Record to Module Mapping page opens.
5. 6.
7.
CSGDM-10.0-MFUG-2004-04-30
384
2.
CSGDM-10.0-MFUG-2004-04-30
385
2.
CSGDM-10.0-MFUG-2004-04-30
2.
387
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Correlation File Format Correlation Module Name Correlation Record Name Description Field Format (for Correlation File Conversion) Field Length (for Correlation File Conversion) Field Name (for Correlation File Conversion) Input File Format (for Mediation Features) Input Record Name
CSGDM-10.0-MFUG-2004-04-30
388
Length Mapping ID Module Secondary Key Order Record Secondary Key Start (for Field Mappings)
CSGDM-10.0-MFUG-2004-04-30
389
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Record Mappings. The Record Mappings page opens. Click the ID beside the record mappings in the table. The Record Mapping page opens. Click the arrow beside Record-to-Module Mappings. The Record-toModule Mappings table opens.
5. 6.
7.
CSGDM-10.0-MFUG-2004-04-30
390
8.
Click the ID for the record-to-module mapping in the table. The Record to Module Mapping page opens. Click the Name of the control data field in the Control Data Fields or Record Data Fields table. The Data Field Mapping page opens.
9.
CSGDM-10.0-MFUG-2004-04-30
391
2.
The new Mapping form opens. 3. Fill out these form fields: Mapping ID Start (for Field Mappings) Length 4. 5. Click Expression. A new window opens with the Expression page. Fill out these form fields, if available: Justification Padding Default Value 6. 7. 8. Build an expression using the expressions listed in the drop-down menu. Click Close. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
392
2.
3.
CSGDM-10.0-MFUG-2004-04-30
393
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Correlation Module Name Exclusive? Input File Format (for Mediation Features) Input Module Name Order Secondary Key Type
CSGDM-10.0-MFUG-2004-04-30
394
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Module Mappings. The Module Mappings page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
395
CSGDM-10.0-MFUG-2004-04-30
396
CSGDM-10.0-MFUG-2004-04-30
397
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Conversion ID Correlation File Format Correlation Module Name Description Exclusive? Input File Format (for Mediation Features)
CSGDM-10.0-MFUG-2004-04-30
398
Input Module Name Mapped? Module Name (Field Filter page) Name Order Offset
CSGDM-10.0-MFUG-2004-04-30
399
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Module Mappings. The Module Mappings page opens. Click the New icon.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
400
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Module Mappings. The Module Mappings page opens. Click the ID for the module mapping in the Module Mappings or Trigger Mappings table. The Module Mapping page opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
401
CSGDM-10.0-MFUG-2004-04-30
402
2.
CSGDM-10.0-MFUG-2004-04-30
403
2.
CSGDM-10.0-MFUG-2004-04-30
405
Elements
These elements are on this page and are described in the Data Dictionary: Field Format (for Correlation File Conversion) Field Length (for Correlation File Conversion) Field Name (for Correlation File Conversion) Correlation File Conversion ID Correlation File Format Correlation Module Name Description Input File Format (for Mediation Features) Input Module Name Length Mapping ID
CSGDM-10.0-MFUG-2004-04-30
406
CSGDM-10.0-MFUG-2004-04-30
407
2.
3.
Click Correlation File Conversions. The Correlation File Conversions Page opens.
4.
Click the Name of the correlation file conversion in the table. The Correlation File Conversion page opens. Click Module Mappings. The Module Mappings page opens. Click the Name of a control data field in the Control Data Fields or Record Data Fields table. The Data Field Mapping page opens.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
408
2.
The new mapping form appears. 3. Fill out these form fields: Mapping ID Start (for Field Mappings) Length 4. 5. Click Expression. A new window opens with the Expression page. Fill out these form fields: Justification Padding Default Value 6. 7. 8. Build an expression using the expressions listed in the drop-down menu. Click Close. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
409
2.
3.
CSGDM-10.0-MFUG-2004-04-30
This section describes the Correlation Store Conversion pages, including information on: Creating Correlation Store Conversions Updating Correlation Store Conversion Opening Correlation Store Conversion pages Working with Correlation Store Conversions
CSGDM-10.0-MFUG-2004-04-30
413
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Description Name Source Record Target Record Name
CSGDM-10.0-MFUG-2004-04-30
414
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
CSGDM-10.0-MFUG-2004-04-30
415
2.
CSGDM-10.0-MFUG-2004-04-30
416
2.
CSGDM-10.0-MFUG-2004-04-30
417
Elements
These elements are on this page and are described in the Data Dictionary: Audit Button Audit Results Correlation File Format Description Last Audited Name Source Record Name Target Record Name
CSGDM-10.0-MFUG-2004-04-30
418
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
419
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens.
CSGDM-10.0-MFUG-2004-04-30
420
2.
CSGDM-10.0-MFUG-2004-04-30
421
2.
CSGDM-10.0-MFUG-2004-04-30
423
Elements
These elements are on this page and are described in the Data Dictionary: Correlation Store Conversion ID Description List Name
CSGDM-10.0-MFUG-2004-04-30
424
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click Value Lists in the Globals column. The Value Lists page opens.
CSGDM-10.0-MFUG-2004-04-30
425
CSGDM-10.0-MFUG-2004-04-30
426
CSGDM-10.0-MFUG-2004-04-30
427
CSGDM-10.0-MFUG-2004-04-30
429
CSGDM-10.0-MFUG-2004-04-30
430
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Correlation Store Conversion ID Description List Name List Value
CSGDM-10.0-MFUG-2004-04-30
431
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4. 5. 6.
Click the Name of the correlation store conversion in the table. Click Value Lists in the Global column. Click the New icon.
CSGDM-10.0-MFUG-2004-04-30
432
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4. 5. 6.
Click the Name of the correlation store conversion in the table. Click Value Lists in the Global column. Click the List Name for the value list in the table. The Value List page opens.
CSGDM-10.0-MFUG-2004-04-30
433
CSGDM-10.0-MFUG-2004-04-30
434
5.
CSGDM-10.0-MFUG-2004-04-30
435
The new List Value form opens. 2. Fill out this field: List Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
436
CSGDM-10.0-MFUG-2004-04-30
437
Elements
These elements are on this page and are described in the Data Dictionary: Correlation Store Conversion ID Description List Name
CSGDM-10.0-MFUG-2004-04-30
438
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4. 5.
Click the correlation store conversion. Click Table Lookup Value Lists in the Global column. The Table Lookup Value Lists page opens.
CSGDM-10.0-MFUG-2004-04-30
439
2.
CSGDM-10.0-MFUG-2004-04-30
440
2.
CSGDM-10.0-MFUG-2004-04-30
441
After you set up a table lookup value list, you can use the information in operators such as the table or dateTable mapping operators on the associated Secondary Key Mapping or Field Mapping page.
Figure 90 Table Lookup Value List Page
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format
CSGDM-10.0-MFUG-2004-04-30
442
CSGDM-10.0-MFUG-2004-04-30
443
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Table Lookup Value Lists in the Global column. The Table Lookup Value Lists page opens. Click the New icon.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
444
CSGDM-10.0-MFUG-2004-04-30
445
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Table Lookup Value Lists in the Global column. The Table Lookup Value Lists page opens. Click the List Name for the table lookup value list in the table. The Table Lookup Value List page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
446
2.
4.
CSGDM-10.0-MFUG-2004-04-30
447
2.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
448
The new table lookup value form appears. 2. Fill out these fields: Key Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
449
2.
CSGDM-10.0-MFUG-2004-04-30
450
CSGDM-10.0-MFUG-2004-04-30
451
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Expression (for Secondary Key Mappings) Secondary Key Source Structure Type
CSGDM-10.0-MFUG-2004-04-30
452
References
For more information on the Secondary Key Mapping page, see "Secondary Key Mapping Page (Correlation File Conversion and Correlation Store Conversion)" (245) in this user guide
CSGDM-10.0-MFUG-2004-04-30
453
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4. 5.
Click the Name of the correlation store conversion in the table. Click Secondary Key Mappings in the Mappings column. The Secondary Key Mappings page opens.
CSGDM-10.0-MFUG-2004-04-30
454
2.
CSGDM-10.0-MFUG-2004-04-30
455
2.
CSGDM-10.0-MFUG-2004-04-30
456
CSGDM-10.0-MFUG-2004-04-30
457
CSGDM-10.0-MFUG-2004-04-30
458
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Correlation Module Name Exclusive? Mapped? Name Offset Order Secondary Key Source Record Store Conversion ID Target Record Name
CSGDM-10.0-MFUG-2004-04-30
459
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Record Mapping in the Mappings column. The Record Mapping page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
460
CSGDM-10.0-MFUG-2004-04-30
461
CSGDM-10.0-MFUG-2004-04-30
462
CSGDM-10.0-MFUG-2004-04-30
463
CSGDM-10.0-MFUG-2004-04-30
464
3.
CSGDM-10.0-MFUG-2004-04-30
465
3.
CSGDM-10.0-MFUG-2004-04-30
467
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Field Description Field Format Field Length Length Name Secondary Key Source Record Start (for Field Mappings) Store Conversion ID
CSGDM-10.0-MFUG-2004-04-30
468
CSGDM-10.0-MFUG-2004-04-30
469
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Record Mappings in the Mappings column. The Record Mappings page opens. Click the Name of the mapping in the Control Data Fields or Record Data Fields table. The Record Data Field Mapping page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
470
Create a Mapping
To create a mapping: 1. Follow the instructions to "Open the Record Data Field Mapping Page" (11469). Click the New icon.
2.
The new Mapping box opens. 3. Fill out these form fields: Name Start (for Field Mappings) Length 4. 5. Click Expression. A new window with the Expression page opens. Fill out these form fields: Justification Padding Default Value 6. 7. 8. Build an expression using the expressions listed in the drop-down menu. Click Submit. Click Close. The Expression page closes and the Record Data Field Mapping page is updated.
CSGDM-10.0-MFUG-2004-04-30
Update a Mapping
471
Update a Mapping
To update a mapping: 1. Follow the instructions to "Open the Record Data Field Mapping Page" (11469). Click the icon beside the mapping ID. The Mapping form opens. Update these form fields: Name Start (for Field Mappings) Length 4. 5. Click Expression. A new window with the Expression page opens. Update these form fields: Justification Padding Default Value 6. 7. 8. Build an expression using the expressions listed in the drop-down menu. Click Submit. Click Close. The Expression page closes and the Record Data Field Mapping page is updated.
2. 3.
CSGDM-10.0-MFUG-2004-04-30
473
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Exclusive? Mapped? Name Offset Order Secondary Key Source Record Store Conversion ID Target Module Name Target Record Name
CSGDM-10.0-MFUG-2004-04-30
474
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Record Mappings in the Mappings column. The Record Mappings page opens. Click the arrow beside the Record-to-Module Mappings. The Record-toModule Mappings table appears. Click the ID for the Record-to-Module Mapping in the table. The Recordto-Module Mapping page opens.
5.
6.
7.
CSGDM-10.0-MFUG-2004-04-30
475
Module trigger mappings are events that flag the correlation feature to generate the terminating module for a record.
Figure 95 Correlation Store Module Mappings Page
CSGDM-10.0-MFUG-2004-04-30
476
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Exclusive? Order Secondary Key Source Module Target Module Type
CSGDM-10.0-MFUG-2004-04-30
477
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the "Name" (16483) of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens.
5.
CSGDM-10.0-MFUG-2004-04-30
478
CSGDM-10.0-MFUG-2004-04-30
479
CSGDM-10.0-MFUG-2004-04-30
480
CSGDM-10.0-MFUG-2004-04-30
481
CSGDM-10.0-MFUG-2004-04-30
483
CSGDM-10.0-MFUG-2004-04-30
484
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Exclusive? Mapped? Module Name (Field Filter page) Name Offset Order Source Module Store Conversion ID Target Module Target Module Description
CSGDM-10.0-MFUG-2004-04-30
485
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens. Click the New icon in the toolbar of the Module Mappings table.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
486
CSGDM-10.0-MFUG-2004-04-30
487
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens. Click the ID for the module mapping in the Module Mappings table. The Module Mapping page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
488
CSGDM-10.0-MFUG-2004-04-30
489
2.
3.
4.
CSGDM-10.0-MFUG-2004-04-30
490
2.
CSGDM-10.0-MFUG-2004-04-30
491
2.
CSGDM-10.0-MFUG-2004-04-30
492
CSGDM-10.0-MFUG-2004-04-30
493
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Field Description Field Format Field Length Length Module Name (Field Filter page) Name Source Module Start (for Field Mappings) Store Conversion ID
CSGDM-10.0-MFUG-2004-04-30
494
CSGDM-10.0-MFUG-2004-04-30
495
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens. Click the Name of the control data field in the Control Data Fields or Module Data Fields table. The Module Data Field Mapping page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
496
2.
The new mapping form appears. 3. Fill out these form fields: Name Start (for Field Mappings) Length 4. 5. Click Expression. A new window with the Expression page opens. Fill out these form fields: Justification Padding Default Value 6. 7. Build an expression using the expressions listed in the drop-down menu. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
497
2. 3.
CSGDM-10.0-MFUG-2004-04-30
499
CSGDM-10.0-MFUG-2004-04-30
500
Elements
These elements are on this page and are described in the Data Dictionary: Correlation File Format Description Mapped? Name Offset Source Module Store Conversion ID Target Module
CSGDM-10.0-MFUG-2004-04-30
501
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens. Click the New icon in the Trigger Mapping table.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
502
CSGDM-10.0-MFUG-2004-04-30
503
2.
3.
Click Correlation Store Conversions. The Correlation Store Conversions page opens.
4.
Click the Name of the correlation store conversion in the table. The Correlation Store Conversion page opens. Click Module Mappings in the Mappings column. The Module Mappings page opens. Click the ID of the trigger mapping in the Trigger Mapping table. The Trigger Mapping page opens.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
504
2.
CSGDM-10.0-MFUG-2004-04-30
505
2.
CSGDM-10.0-MFUG-2004-04-30
2.
This section describes the external database access definition pages, including information on: Creating External Database Access Definitions Updating External Database Access Definitions Opening External Database Access Definition pages
CSGDM-10.0-MFUG-2004-04-30
509
Elements
These elements are on this page and are described in the Data Dictionary: Description Name ODBC Data Source Type
References
For information about configuration and setup of the ODBC software, see the Installation Guide For information on the knowledge and permissions you need to work with this feature, see "Working with External Database Access Definitions" (16)
CSGDM-10.0-MFUG-2004-04-30
510
2.
Click External Database Access Definitions. The External Database Access Definitions page opens.
CSGDM-10.0-MFUG-2004-04-30
511
2.
CSGDM-10.0-MFUG-2004-04-30
512
2.
CSGDM-10.0-MFUG-2004-04-30
513
CSGDM-10.0-MFUG-2004-04-30
514
Elements
These elements are on this page and are described in the Data Dictionary: and minutes at hours Audited? Data Length Dates in the Selected Month Days of Each Week Description First Byte Start Format in months Name ODBC Data Source on days SQL Statement Type Update Local Data
References
For information about configuration and setup of the ODBC software, see the Installation Guide For information on the knowledge and permissions you need to work with this feature, see "Working with External Database Access Definitions" (16) "Working with Table Lookup Value Lists" (15) in this user guide
CSGDM-10.0-MFUG-2004-04-30
515
2.
Click External Database Access Definitions. The External Database Access Definitions page opens.
3.
CSGDM-10.0-MFUG-2004-04-30
516
2.
Click External Database Access Definitions. The External Database Access Definitions page opens.
3.
Click the Name of the external access definition in the table. The External Database Access Definition page opens.
CSGDM-10.0-MFUG-2004-04-30
517
2.
CSGDM-10.0-MFUG-2004-04-30
518
2.
CSGDM-10.0-MFUG-2004-04-30
This chapter describes the file format definitions, including information on: Overview Working with File Formats and Mediation Accessing the File Format Definition Pages Defining a GRID File Format Working with Data Field Types Working with GRID Working with GRID Field Attributes Working with Fields Working with File Structures Working with Modules Working with Special Modules Working with Module Supports Working with Block Header/Trailers Working with File Header/Trailers Working with File Formats Working with File Format & Structure Associations Auditing a File Format Definition Troubleshooting a File Format Definition File Format Audit Error Messages
CSGDM-10.0-MFUG-2004-04-30
520
Overview
Data Mediation receives billing records from different sources in many different file formats. A file format ID is a tag name given to a a set of definitions that specifies the format in which the usage records are received from the source. GRID File Format Definitions provide the basis for processing all data coming into and flowing out of the system. Defining a file format consists of putting together all the rules used by GRID to recognize the information contained within a file of data. After the file format is defined, it can be associated with any or all sources that generate usage data files with that file format. To recognize each file format, GRID requires that these components be defined to create each format: Fields contain call data or parsing information File Structures define components of a file format Structures sets of fixed length fields containing call detail information, which is information generated by the switch detailing call information or events, such as the originating number, terminating number, start time, end time, and call type Modules additional call data not contained in the structure (optional) Module Supports contains parsing information Block Headers and Trailers provide a way of packaging data records (optional) File Headers and Trailers provide a way of packaging data records and optional blocks (optional) Record to File Format Associations describes how the structures are associated Some file formats come predefined on the Data Mediation System, depending on the system package purchased (for example: wireline, wireless). Using the Data Mediation system, you can build file format definitions to extract, and use the information (mediate) contained in the data records. Not all fields on the file format definition pages are required. These fields are available to accommodate a variety of file formats and to increase the flexibility and efficiency of GRID. After the parts have been defined and joined together into a file format, GRID can break down information to the field and sub-field level and pass it to mediation applications, such as Filter, Search, File Format Conversion, Correlation, Package Manager, or Validation.
Consulting Services
Users can create and modify their own mediation feature sets or contract with the Mediation Engineering and Consulting Service (MECS) group for any mediation feature sets and mediation services that can be required.
CSGDM-10.0-MFUG-2004-04-30
Overview
521
Source Upgrades
The Data Mediation system is originally configured with predefined file formats, set up to the vendor specifications. These file formats include the latest available updates to CSG Systems, Inc. sources. Even after a release of Data Mediation, any generic upgrades to Data Mediation sources are supported. All Gold or Gold Uplift maintenance contract customers are notified of source upgrades and provided with instructions so that they can update their systems. Maintenance of file formats depends on the type of contract established with CSG Systems, Inc.
CSGDM-10.0-MFUG-2004-04-30
522
Using the Data Files pages, you can view or print records from usage data files that have defined file formats.
CSGDM-10.0-MFUG-2004-04-30
523
When you select an option from this drop-down menu, three columns of links appear, including the File Format Definitions links.
Figure 102 The File Format Definitions Links
CSGDM-10.0-MFUG-2004-04-30
524
When you click a link in this column, the corresponding File Format Definitions page opens. These links are found in the File Format Definitions column.
Table 5 File Format Definitions Links and the Corresponding Pages
CSGDM-10.0-MFUG-2004-04-30
525
These links are listed in the order in which they must be completed; however, depending on the type of GRID mediation feature set and file format type required, not all pages are necessarily used. For example, a GRID using only records, does not require the user to complete the Block Header/Trailer or File Header/Trailer pages.
CSGDM-10.0-MFUG-2004-04-30
526
CSGDM-10.0-MFUG-2004-04-30
527
BINARY
The BINARY data type there has only two possible values or states for a particular condition such as on or off, or one or zero. The BINARY data type uses only two digits: 0 and 1. (Two nibbles per byte, one character per nibble) Normally, written numbers follow the decimal format. In the decimal format, when you move a number one position to the left, then you are increasing it by ten. For example, 100 is ten times the number 10. However, when computers use BINARY notation and a number is moved one position to the left, the value is doubled. For example, the BINARY number 10101 is equivalent to 16 + 0 + 4 + 0 + 1 = 21 in decimal. The BINARY notation differs slightly from the ASCII or EBCDIC notations. With ASCII and EBCDIC, the BINARY values are used for coding of individual characters or keys or symbols on keyboards or in computers. So each string of seven (as in ASCII) or eight (as in EBCDIC) ones and zeros is a unique value, but not a mathematical one. GRID interprets BINARY fields similar to how it interprets fields as BCD.When GRID interprets fields as BCD, the decimal numbers 0 through 15 are represented
CSGDM-10.0-MFUG-2004-04-30
528
by the decimal digits 09 and the alphabet digits af (AF). However, when GRID interprets an output value, the output is in Base 16. For example, 100 is translated to 100 (decimal 256). If the input field is BINARY, GRID transforms the user input to hexadecimal. For example, a user-entered 100 is translated to 64.
CSGDM-10.0-MFUG-2004-04-30
529
After GRID: Parsed records are passed to the application association, which applies the appropriate mediation features in the order specified On collection, files are moved to the primary directory On transmission, files are moved to the tertiary directory GRID interprets all data coming into and going out of the system. This means that both processes require an incoming and outgoing GRID. If the data coming into the system remains the same on transmission (AUTOPLEX data in, AUTOPLEX data out), then only one file format definition (AUTOPLEX) is required. However, if the data differs, (AUTOPLEX in, EMI out), then two file format definitions (AUTOPLEX and EMI) are required. You can create as many file format definitions as needed to process all information. There is not a system limit on how many file format definitions can be created.
CSGDM-10.0-MFUG-2004-04-30
530
CSGDM-10.0-MFUG-2004-04-30
531
GRID on Collection
Call data records are sent into Data Mediation from sources, typically a switch. The records are stored in Data Mediation as flat UNIX files. Before files are stored in Data Mediation, they are processed through GRID and any optional mediation features (filter, format, validation, and so on). During this processing, the files are stored in a temporary directory. If the files are successfully processed, they are stored in the primary directory for the source that sent the original file. In this scenario, files are stored in the mediated format, meaning that the file reflects any optional mediation processing, such as filter that were performed before committing the file to the directory. If no mediation was indicated on collection, the files are stored in the original format the source generated.
GRID on Transmission
Data files received from the various sources are stored in the their original format in each sources primary directory. After GRID is run for the file to be transmitted, we look at the Application Association to see which mediation features are attached to the transmission stream. Based on that information, the input file is converted to the required output file format and transmitted to the Destination. After all the formatted files have been transmitted, the original input files are moved from the primary directory to the tertiary directory for the original source. The reformatted files are not stored on the system.
References
CSGDM-10.0-MFUG-2004-04-30
532
Figure 104, "GRID Field Attributes" (13-532) shows an example of the GRID field attributes. The Key Field structure code contains information indicating modules are appended to the record structure.
Figure 104 GRID Field Attributes
Note
You can obtain this type of parsing information from the format description document supplied by your switch manufacturer.
CSGDM-10.0-MFUG-2004-04-30
533
When additional information is required for a selected field, the GRID field attributes area is displayed by selecting specific fields on the following pages: Module Support page Block Header/Trailer Structures page File Header/Trailer Structures page File Formats page
GRID Field Attributes that contain length data are interpreted by GRID as follows: If the field has a format of BINARY, then the field is interpreted as a hexadecimal value, base 16. If the field has a format of BCD, then the field is interpreted as BCD, base 10. If the field has a format of ASCII or EBCDIC then the ASCII or EBCDIC value is interpreted as the user specified base on the GRID Field Attribute If the field has a format of BIT, then the field is interpreted as base 16 (logically BIT is interpreted as base 2; for GRID purposes it is interpreted as base 16). For block headers and trailers GRID recognizes and uses parsing information contained only in the block header, not in the block trailer. If trailers are defined, all trailers for a given level have the same GRID field attributes. GRID Field Attributes for trailers are defined separately from the headers. Other mediation applications can adjust length and count fields in the block trailer.
CSGDM-10.0-MFUG-2004-04-30
534
When you define a field in a usage data record, you define the: type use format length data offset data length
Note The information for the format and the length of the field usually comes from the specification.
The GRID field attributes identify specific subfields within a field allowing GRID to parse information down to the byte/nibble level for specified fields. GRID requires a minimum amount of information to completely define the file format, so while it is not necessary to define all fields, it is recommended. The Data Mediation system applications can only work with defined fields.
CSGDM-10.0-MFUG-2004-04-30
535
The information that you enter to define a field helps the system target where a particular field will be used. As GRID reviews the records that come in and out of the system, if it finds a field that falls outside of the parameters set on the Field Definitions Page, an error is produced or an exception is generated. Field formats are determined by your file format standards. Different fields within a record can be a different format. GRID and parse information length data.
Field Input
Fields do not have to be entered in the order of their position in the structure, although verifying their accuracy is easier if you do. The Structure page lists them in sequential order starting with the lowest offset number as they are entered. Figure 106, "Fields in a BAF Record" (13-535) shows an example of fields in a BAF record. One record uses modules and the other does not. Different file formats use different layouts, but the concept of fields in a defined order applies to most file formats.
Figure 106 Fields in a BAF Record
CSGDM-10.0-MFUG-2004-04-30
536
Using the Structure Page, you can define all of the data record structures that are included in the specified mediation feature set. When you define a data record, you define all of the information that makes up the record structure: name length field names offsets
CSGDM-10.0-MFUG-2004-04-30
537
These definitions are what the system uses to evaluate if an incoming or outgoing structure is correct.
Note Record structures must be added as outlined in the source or destination specification book.
CSGDM-10.0-MFUG-2004-04-30
538
FILE HEADER { BLOCK HEADER 2 { BLOCK HEADER 1 { RECORD RECORD } BLOCK HEADER 1 { RECORD RECORD RECORD } BLOCK HEADER 1 { RECORD } } BLOCK TRAILER 2 BLOCK HEADER 2 { BLOCK HEADER 1 { RECORD RECORD RECORD } } BLOCK TRAILER 2 } FILE TRAILER
CSGDM-10.0-MFUG-2004-04-30
539
CSGDM-10.0-MFUG-2004-04-30
540
Building Records
The Module Page builds records in the same way as the Structures page. A table is created for each module type in the data record by adding fields in the order that they appear. Unlike data structures, which have various fields that contain call origination, destination, and duration information, modules contain very specific and limited information. Consequently, module structures typically have a length that is less than 20 bytes.
CSGDM-10.0-MFUG-2004-04-30
541
CSGDM-10.0-MFUG-2004-04-30
542
CSGDM-10.0-MFUG-2004-04-30
543
You use the Block Header and /Trailer page to specify how GRID is to handle this situation.
CSGDM-10.0-MFUG-2004-04-30
544
CSGDM-10.0-MFUG-2004-04-30
545
You use the File Header and Trailer page to specify how GRID is to handle the end of a file. GRID does not process any records in the file after one of these events occurs. Normally, there are not any records left in the file.
CSGDM-10.0-MFUG-2004-04-30
546
After a file format is created, it can be associated with any or all sources that collect usage data files with that file format.
CSGDM-10.0-MFUG-2004-04-30
547
CSGDM-10.0-MFUG-2004-04-30
548
Error Messages
When the GRID audit cannot find enough information to determine how to do a task, it prints out an error message that lists all the ways it can do that task in the results area of the Audit Page (for Mediation Feature Sets). Use the error messages to start troubleshooting the errors in the file format definition.
References
For a list of all GRID Audit Error Messages, see the "Troubleshooting a File Format Definition" (13549) in this user guide
CSGDM-10.0-MFUG-2004-04-30
549
CSGDM-10.0-MFUG-2004-04-30
550
2.
GRID fails but can continue parsing the file. This can occur when GRID encounters an undefined record structure, but other information in the file format enables GRID to successfully find the next record. GRID outputs an error message to the Error and Information Log to alert you of the problem GRID outputs the file to downstream applications if there are no other unrecoverable errors If this is a file transmission operation, the file is transmitted to the destination. This problem can cause other mediation applications to fail
CSGDM-10.0-MFUG-2004-04-30
551
This example problem occurs when a fill character has been specified for Tier 1 blocks, but GRID cannot figure out how or when to fill out a block, because the length of a Tier 1 has not been provisioned correctly in GRID.
Text 1
A fill character has been specified for Tier 1 Block Header: <BH1 ID> but there is no way to identify how to use the character to fill a block. The following combinations of information can be parsed by GRID ((SS) indicates subscreen):
Block Header/Trailer Structures Screen: Tier 1 fixed block length. There are cases for: No tier 1 block trailer. Tier 1 block trailer, trailer not included in block length. Tier 1 block trailer, trailer included in block length, no support for modules.
Explanation 1
This message refers to provisioning the Tier 1 block header (<BH1 ID>) on the fifth line of the Block Header and Trailer page. GRID can use this information if the data file contains: No Tier 1 block trailer. A Tier 1 block trailer, but the block trailer is not included in the block length calculation. A Tier 1 block trailer, the block trailer is included in the block length calculation and no modules are attached to the block trailer (no support for modules).
CSGDM-10.0-MFUG-2004-04-30
552
Text 2
Tier 1 (SS) Block Information field indicating block length.
There are cases for: No tier 1 block trailer. Tier 1 block trailer, trailer not included in block length. Tier 1 block trailer, trailer included in block length, no support for modules.
Explanation 2
This message refers to provisioning the Tier 1 block header (<BH1 ID>) on the Block Header and Trailer page by checking the box beside the question: Structure contains information about blocks? This expands so you can specify a field whose contents indicate the block length. GRID can use the information in this field if the data file contains: No Tier 1 block trailer A Tier 1 block trailer, but the block trailer is not included in the block length calculation A Tier 1 block trailer, the block trailer is included in the block length calculation, but no modules are attached (no support for modules)
Text 3
Tier 2 (SS) Sub-block Information fixed subblock length.
There are cases for: No tier 1 block trailer list. Tier 1 block trailer, trailer not included in block length. Tier 1 block trailer, trailer included in block length, no support for modules.
Explanation 3
This message refers to provisioning a Tier 2 block header on the Block Header and Trailer page by checking the box beside the question: Structure contains information about subblocks? This expands so you can specify a fixed subblock length. GRID can use the information in this field if the data file contains: No Tier 1 block trailer. A Tier 1 block trailer, but the block trailer is not included in the block length calculation. A Tier 1 block trailer, the block trailer is included in the block length calculation, but no modules are attached (no support for modules).
CSGDM-10.0-MFUG-2004-04-30
553
Text 4
Tier 2 (SS) Sub-block Information field indicating subblock length.
There are cases for: No tier 1 block trailer. Tier 1 block trailer, trailer not included in block length. Tier 1 block trailer, trailer included in block length, no support for modules
Explanation 4
This message refers to provisioning a Tier 2 block header on the Block Header and Trailer page by checking the box beside the question: Structure contains information about subblocks? This expands to allow you to specify a field whose contents indicate the subblock length. GRID can use the information in this field if the data file contains: No Tier 1 block trailer A Tier 1 block trailer, but the block trailer is not included in the block length calculation A Tier 1 block trailer, the block trailer is included in the block length calculation, but no modules are attached (no support for modules)
Text 5
File Header and Trailer screen:
There are only tier 1 blocks, File Header (SS) Block Information field indicating length of highest tier block. There are cases for: No tier 1 block trailer. Tier 1 block trailer, trailer not included in block length. Tier 1 block trailer, trailer included in block length, no support for modules.
Explanation 5
This message refers to provisioning a file header on the File Header and Trailer page by checking the box beside the question: Structure contains information about blocks? This expands so you can specify a field whose contents indicate the length of the highest Tier block. GRID can use this information (for this current problem) if the data file contains: Only Tier 1 blocks No Tier 1 block trailer A Tier 1 block trailer, but the block trailer is not included in the block length calculation A Tier 1 block trailer, the block trailer is included in the block length calculation, but no modules are attached (no support for modules).
CSGDM-10.0-MFUG-2004-04-30
554
CSGDM-10.0-MFUG-2004-04-30
555
File Header/Trailer Structures Screen: There are only tier 1 blocks, File Header (SS) Block Information field indicating length of highest tier block. There are cases for: No tier 1 block trailer Tier 1 block trailer, trailer not included in block length Tier 1 block trailer, trailer included in block length, no support for modules
CSGDM-10.0-MFUG-2004-04-30
556
File Header/Trailer Structures Screen: There is a (SS) Record Information field in the file header structure that indicates the length of records in the file Block Header/Trailer Structures Screen: There is a (SS) Record Information field in the block header structure whose contents identify the length of records in that block.
CSGDM-10.0-MFUG-2004-04-30
557
CSGDM-10.0-MFUG-2004-04-30
558
End of Module Section: field in structure that indicates the number (#) of modules attached End of Module Section: fixed length of attached modules. This requires a field that indicates modules are attached in the Module Support section End of Module Section: field in structure that indicates length of modules End of Module Section: field in first module that indicates the number (#) of attached modules End of Module Section: field in first module that indicates the length of attached modules End of Module Section: field in module that indicates last module. This also requires the value that indicates last module File Headers/Trailers Structures Screen: Record Length Field
CSGDM-10.0-MFUG-2004-04-30
559
File Header/Trailer Structures Screen: (SS) Block Information field indicating length of highest tier block. There are cases for: No highest tier block trailer Highest tier block trailer, trailer not included in block length Highest tier block trailer, trailer included in block length no support for modules
Identify Module Support for Tier <i> Block Headers and Trailers
No way to determine module support for block header structures tier: <i> GRID Module Support Screen: Module Support Section: are modules supported - no Module Support Section: a field in the structure that indicates modules are attached End of Module Section: a field in the structure that indicates the number (#) of modules attached End of Module Section: a field in the structure that indicates the length of attached modules Block Header/Trailer Structures Screen: Record Length Field
Identify Module Codes for Tier <i> Block Headers and Trailers
No way to identify module code for block header structures tier: <i> GRID must be able to identify a block header's/trailer's module codes. GRID can parse these combinations of information: Module Support Screen: Module Identification Section: single module code. Module Identification Section: field that identifies the module code.
CSGDM-10.0-MFUG-2004-04-30
560
Identify the Last Module for Tier <i> Block Headers and Trailers
No way to determine last module for block header structures tier: <i> GRID must be able to identify a block header's/trailer's last module. GRID can parse these combinations of information: Module Support Screen: End of Module Section: a module code that identifies the last module. This requires a field that identifies the module code in the Module Identification section. End of Module Section: fixed number of modules attached. This requires that a field that indicates modules are attached in the Module Support section. End of Module Section: field in structure that indicates the number (#) of modules attached. End of Module Section: fixed length of attached modules. This requires a field that indicates modules are attached in the Module Support section. End of Module Section: field in structure that indicates length of modules. End of Module Section: field in first module that indicates the number (#) of attached modules. End of Module Section: field in first module that indicates the length of attached modules. End of Module Section: field in module that indicates last module. This also requires the value that indicates last module. Block Headers/Trailers Structures Screen: Record Length field
CSGDM-10.0-MFUG-2004-04-30
561
Tier i+1 (SS) Block Information field indicating block length. There are cases for: No tier i+1 block trailer Tier i+1 block trailer, trailer not included in block length Tier i+1 block trailer, trailer included in block length, no support for modules Tier i+1 (SS) Sub-block Information field indicating fixed number of subblocks in the containing block Tier i+1 (SS) Sub-block Information field in the structure whose contents indicate the number of subblocks in the block File Header/Trailer Structures Screen: (SS) Block Information field indicating number of highest tier blocks in the file
CSGDM-10.0-MFUG-2004-04-30
Tier 1 block trailer, trailer included in block length, no support for modules Tier 1 (SS) Block Information field whose contents indicate the length of the block. There are cases for: No tier 1 block trailer Tier 1 block trailer, trailer not included in block length Tier 1 block trailer, trailer included in block length, no support for modules Tier 1 (SS) Record Information fixed number of records in the block Tier 1 (SS) Record Information field whose contents indicate the number of records in the block Tier 2 (SS) Sub-block Information fixed subblock length There are cases for: No tier 1 block trailer Tier 1 block trailer, trailer not included in block length Tier 1 block trailer, trailer included in block length, no support for modules Tier 2 (SS) Sub-block Information field whose contents indicate subblock length. There are cases for: No tier 1 block trailer Tier 1 block trailer, trailer not included in block length. Tier 1 block trailer, trailer included in block length, no support for modules There is a tier 1 block trailer with a Key Field on the Block Header Trailer Screen. There is a tier 1 block header with a Key Field on the Block Header Trailer Screen and there is not a tier 1 block header. File Formats Screen: (SS) Block Headers and Trailers field for key field that indicates last record in tier one block There is a field in the structure that is a Last Record Key Field and there is a (SS) Block Headers and Trailers field that indicates a value for the last record Key Field that indicates last record in a tier 1 block.
563
File Header/Trailer Structures Screen: If there is only one level of blocking, the (SS) Block Information field whose contents indicate the length of the highest tier block indicates the length of tier 1 blocks. There are cases for: No tier 1 block trailer Tier 1 block trailer, trailer not included in block length Tier 1 block trailer, trailer included in block length, no support for modules
CSGDM-10.0-MFUG-2004-04-30
564
CSGDM-10.0-MFUG-2004-04-30
This section describes the File Format Definition pages, including information on: Creating File Format Definitions Updating File Format Definition pages Opening File Format Definition pages
CSGDM-10.0-MFUG-2004-04-30
567
Elements
These elements are on this page and are described in the Data Dictionary: Description Field Use Format Mediation Feature Set (MFS) Name Record Type
CSGDM-10.0-MFUG-2004-04-30
568
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
CSGDM-10.0-MFUG-2004-04-30
569
CSGDM-10.0-MFUG-2004-04-30
570
CSGDM-10.0-MFUG-2004-04-30
571
CSGDM-10.0-MFUG-2004-04-30
573
Elements
These elements are on this page and are described in the Data Dictionary: Data Length Data Start Description Field Length Field Use Format Mediation Feature Set (MFS)
CSGDM-10.0-MFUG-2004-04-30
574
CSGDM-10.0-MFUG-2004-04-30
575
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3. 4.
Click Fields. The Fields page opens. Click the New icon.
CSGDM-10.0-MFUG-2004-04-30
576
2.
\
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3. 4.
Click Fields. The Fields page opens. Click the Name of the field in the table. The Field page opens.
CSGDM-10.0-MFUG-2004-04-30
Create a Field
577
Create a Field
To create a field: 1. 2. Follow the instructions to "Open a New Field Page" (14575). Fill out these form fields: Name Mediation Feature Set (MFS) Format Record Type Field Use Description Field Length 3. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
578
Update a Field
To update a field: 1. 2. Follow the instructions to "Open a New Field Page" (14575). Fill out these form fields: Format Record Type Field Use Description Field Length Data Length Data Start 3. Click Submit.
CSGDM-10.0-MFUG-2004-04-30
Structures Page
579
Structures Page
After you "Open a Structures Page" (14580), you can: "Go to a New Structure Page" (14581) "Go to an Existing Structure Page" (14582) "Go to Another Page in the Mediation Feature Set" (14571)
Figure 110 Structures Page
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name
CSGDM-10.0-MFUG-2004-04-30
580
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Structures link in the File Format Definitions section. The Structures page opens.
CSGDM-10.0-MFUG-2004-04-30
581
CSGDM-10.0-MFUG-2004-04-30
582
CSGDM-10.0-MFUG-2004-04-30
Structure Page
583
Structure Page
The Structure page lets you define all of the data record structures that are to be included in the specified mediation feature set. After you "Open a New Structure Page" (14585), you can: "Create a Structure" (14587) "Add a Field" (14589) "Go to Another Page in the Mediation Feature Set" (14571) After you "Open an Existing Structure Page" (14586), you can: "Update a Structure" (14588) "Add a Field" (14589) "Update a Field" (14590) "Go to Another Page in the Mediation Feature Set" (14571)
After data record structures are defined, use the Record page to add them to the file format.
Figure 111 Structure Page
CSGDM-10.0-MFUG-2004-04-30
584
Elements
These elements are on this page and are described in the Data Dictionary: Automatically Adjust Offset Field? Description Length Mediation Feature Set (MFS) Name Offset
CSGDM-10.0-MFUG-2004-04-30
585
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Structures link in the File Format Definitions section. The Structures page opens. Click the Name of the structure in the table. The Structure page opens. Click the New icon.
4. 5.
CSGDM-10.0-MFUG-2004-04-30
586
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Structures link in the File Format Definitions section. The Structures page opens. Click the Name of the structure in the table. The Structure page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
Create a Structure
587
Create a Structure
To create a structure: 1. 2. Follow the instructions to "Open a New Structure Page" (14585). Fill out these form fields at the top of the page: Name Mediation Feature Set (MFS) Description Length 3. 4. To add a field, follow the instructions to "Add a Field" (14589). Click Submit.
CSGDM-10.0-MFUG-2004-04-30
588
Update a Structure
To update a structure: 1. 2. Follow the instructions to "Open an Existing Structure Page" (14586). Update these form fields at the top of the page: Description Length 3. 4. 5. To add a field, follow the instructions to "Add a Field" (14589). To update a field, follow the instructions to "Update a Field" (14590). Click Submit.
CSGDM-10.0-MFUG-2004-04-30
Add a Field
589
Add a Field
To add a field: 1. Click the New icon in the Fields table.
The new Field form opens. 2. Fill out these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
590
Update a Field
To update a field: 1. 2. Click the Name of the field in the Fields table. The Field form opens. Update these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
591
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name Type
CSGDM-10.0-MFUG-2004-04-30
592
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Modules link in the File Format Definitions section. The Modules page opens.
CSGDM-10.0-MFUG-2004-04-30
593
CSGDM-10.0-MFUG-2004-04-30
594
CSGDM-10.0-MFUG-2004-04-30
595
CSGDM-10.0-MFUG-2004-04-30
596
Elements
These elements are on this page and are described in the Data Dictionary: Automatically Adjust Offset Field? Description Module Length Name Mediation Feature Set (MFS)
CSGDM-10.0-MFUG-2004-04-30
597
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Modules link in the File Format Definitions section. The Modules page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
598
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Modules link in the File Format Definitions section. The Modules page opens. Click the Name of the module in the table. The Module page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
Create a Module
599
Create a Module
To create a Module: 1. 2. Follow the instructions to "Open a New Module Page" (14597). Fill out these form fields at the top of the page: Name Mediation Feature Set (MFS) Available in Description Length 3. 4. To add a field, follow the instructions to "Add a Field" (14601). Click Submit.
CSGDM-10.0-MFUG-2004-04-30
600
Update a Module
To update a module: 1. 2. Follow the instructions to "Open a New Module Page" (14597). Update these form fields at the top of the page: Description Length 3. 4. 5. To add a field, follow the instructions to "Add a Field" (14601). To update a field, follow the instructions to "Update a Field" (14602). Click Submit.
CSGDM-10.0-MFUG-2004-04-30
Add a Field
601
Add a Field
To add a field: 1. Click the New icon in the Fields table.
The new Field form opens. 2. Fill out these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
602
Update a Field
To update a field: 1. 2. Click the field in the Fields table. The Field form opens. Update these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
603
CSGDM-10.0-MFUG-2004-04-30
604
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name
CSGDM-10.0-MFUG-2004-04-30
605
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Module Supports link in the File Format Definitions section. The Module Supports page opens.
CSGDM-10.0-MFUG-2004-04-30
606
CSGDM-10.0-MFUG-2004-04-30
607
CSGDM-10.0-MFUG-2004-04-30
609
Complete this page only if the usage records do contain modules. The Module page must be completed prior to the Module Support page. GRID supports block headers/trailers and file headers/trailers with attached modules.
CSGDM-10.0-MFUG-2004-04-30
610
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name
CSGDM-10.0-MFUG-2004-04-30
611
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Module Supports link in the File Format Definitions section. The Module Supports page opens. Click the Name of the module support in the table. The Module Support page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
612
CSGDM-10.0-MFUG-2004-04-30
613
CSGDM-10.0-MFUG-2004-04-30
614
CSGDM-10.0-MFUG-2004-04-30
615
Elements
These elements are on this page and are described in the Data Dictionary: Base Description Field indicates modules are attached Field in the 1st module that indicates # of attached modules Field in the 1st module that indicates the length of modules Field in the modules that indicates last module Field in the structure that indicates # of attached modules Field in the structure that indicates the length of modules
CSGDM-10.0-MFUG-2004-04-30
616
Fixed number of modules Fixed total module length Justification Length (for Module Support) Module Identified by Module indicates last module Module Indicator Value Modules Supported? Module Support Name Mediation Feature Set (MFS) Name Padding Single Module Used Start Position
CSGDM-10.0-MFUG-2004-04-30
617
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Module Supports link in the File Format Definitions section. The Module Supports page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
618
2.
CSGDM-10.0-MFUG-2004-04-30
619
Fixed total module length Field in the structure that indicates # of attached modules Field in the structure that indicates the length of modules Field in the 1st module that indicates # of attached modules Field in the 1st module that indicates the length of modules 9. If you selected any of the check boxes except for Module indicates last module, then fill out these form fields: Start Position Length Base Justification Padding 10. Click Finish.
CSGDM-10.0-MFUG-2004-04-30
621
Elements
These elements are on this page and are described in the Data Dictionary: Base Description Field indicates modules are attached Length (for Module Support) Justification Mediation Feature Set (MFS) Module Indicator Value Modules Supported? Name Padding Start Position
CSGDM-10.0-MFUG-2004-04-30
622
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Module Supports link in the File Format Definitions section. the Module Support page opens. Click the Name of the module support in the table. The Module Support page opens. Click the Basic link. The Module Support Basic page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
623
2.
5. 6.
8.
CSGDM-10.0-MFUG-2004-04-30
624
11. 12.
CSGDM-10.0-MFUG-2004-04-30
625
Elements
These elements are on this page and are described in the Data Dictionary: Base Justification Length (for Module Support) Module Identified by Padding Single Module Used Start Position
CSGDM-10.0-MFUG-2004-04-30
626
2.
drop-down menu.
3.
Click the Module Supports link in the File Format Definitions section. the Module Support page opens. Click the Name of the module support in the table. The Module Support page opens. Click Module Identification. The Module Identification page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
627
2.
CSGDM-10.0-MFUG-2004-04-30
629
CSGDM-10.0-MFUG-2004-04-30
630
Elements
These elements are on this page and are described in the Data Dictionary: Base Field in the 1st module that indicates the length of modules Field in the 1st module that indicates # of attached modules Field in the modules that indicates last module Field in the structure that indicates # of attached modules Field in the structure that indicates the length of modules Fixed number of modules Fixed total module length Justification Length (for Module Support) Module indicates last module Padding Start Position
CSGDM-10.0-MFUG-2004-04-30
631
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Module Supports link in the File Format Definitions section. The Module Support page opens. Click the Name of the module support in the table. The Module Support page opens. Click the End of Module link. The Module Support End of Module page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
632
2.
CSGDM-10.0-MFUG-2004-04-30
633
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name
CSGDM-10.0-MFUG-2004-04-30
634
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Block Header Trailers link in the File Format Definitions section. The Block Header/Trailer Structures page opens.
CSGDM-10.0-MFUG-2004-04-30
635
2.
CSGDM-10.0-MFUG-2004-04-30
636
2.
CSGDM-10.0-MFUG-2004-04-30
637
CSGDM-10.0-MFUG-2004-04-30
638
CSGDM-10.0-MFUG-2004-04-30
639
Elements
These elements are on this page and are described in the Data Dictionary: Automatically Adjust Offset Field? Base Block Headers and/or Trailers built from this structure will be included in the calculation of: Block length (sum of record lengths) Block record counts (total number of records) Description Field Field Format Field indicates the length of the highest tier block Field indicates fixed module supported in the block Field indicates the length of records (if exists) Field indicates the number of records (if exists) Field indicating the last block in a containing block in the file File length (sum of record lengths) File Trailer Name Fill Character Fixed Block Length Fixed number of subblocks (if available) Fixed subblock length (if available) Justification Key Field Length Mediation Feature Set (MFS) Module Support Name Number of records in this block (if fixed) Offset Padding Record Length Field Start Position Structure contains information about blocks? Structure contains information about module support? Structure contains information about records in the block? Structure contains information about subblocks? Structure Length (for File and Block Header/Trailers) Work With Archive Files
CSGDM-10.0-MFUG-2004-04-30
640
Not all fields on this page require data. Fields are there to accommodate a variety of structure types and to increase the efficiency and flexibility of record parsing. Populate only those fields that are for the structure you are defining. If there is not enough information present to parse the file format, it is indicated by the audit results. These are guidelines for possible file format scenarios: If the file format consists of blocks of data, but no block header record exists, then create a block header with a structure length of zero and a block length specifying the number of bytes contained in the data block The Structure Length and Fixed Block Length field values must be coordinated with data entered via the questions on the Block Header and Trailer Structures page.
Caution Make sure these values are correct. The GUI does not check to see if the values you enter are correct.
CSGDM-10.0-MFUG-2004-04-30
641
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Block Header Trailers link in the File Format Definitions section. The Block Header and Trailer page opens. Click a New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
642
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Block Header Trailers link in the File Format Definitions section. The Block Header and Trailer page opens. Click the Name of the block header and trailer in the table. The Block Header/Trailer Structure page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
643
2.
CSGDM-10.0-MFUG-2004-04-30
644
9.
To view the information about the blocks, select the Structure contains information about blocks? check box. To view the information about the length of the block, click the arrow beside the heading: Field Base Start Position Justification Length Padding
10.
11.
To view the information about the last block in a containing block or in the file, click the arrow beside the Field indicating the last block in a containing block in the file. Field Base Start Position Justification Length Padding
12.
To view the information about the subblocks, select the Structure contains information about subblocks? check box. Fill out these form fields: Fixed subblock length (if available) Fixed number of subblocks (if available)
13.
14.
To view the information about the Field indicating the length of subblocks (if available), click the arrow beside the Field indicating the length of subblocks (if available). Field Base Start Position Justification Length Padding
15.
To view the information about the Field indicating the number of subblocks (if available), click the arrow beside the Field indicating the number of subblocks (if available). Fill out these form fields:
16.
CSGDM-10.0-MFUG-2004-04-30
645
Field Base Start Position Justification Length Padding 17. To view the information about the module support, select the Structure contains information about module support? check box. Fill out this form field: Module Support 19. To view the information about the records in the file, select the Structure contains information about records in the block? check box. Fill out this form field: Number of records in this block (if fixed) 21. To view the information about Field indicates the number of records (if exists), select the Field indicates the number of records (if exists) check box. Fill out these form fields: Field Base Start Position Justification Length Padding 23. To view the information about Field indicates the length of records (if exists), select the Field indicates the length of records (if exists) check box. Fill out these form fields: Field Base Start Position Justification Length Padding
18.
20.
22.
24.
CSGDM-10.0-MFUG-2004-04-30
646
25.
To view the information about Field indicates the length of the highest tier block, select the Field indicates the length of the highest tier block check box. Fill out these form fields: Field Base Start Position Justification Length Padding
26.
27.
To view the information about Field indicates fixed module supported in the block, select the Field indicates fixed module supported in the block check box. Fill out these form fields: Field Base Start Position Justification Length Padding
28.
29.
Click Submit.
CSGDM-10.0-MFUG-2004-04-30
647
2.
CSGDM-10.0-MFUG-2004-04-30
648
Block length (sum of record lengths) Block record counts (total number of records) 10. To view the information about the blocks, select the Structure contains information about blocks? check box. To view the information about the length of the block, click the arrow beside the heading: Field Base Start Position Justification Length Padding 12. To view the information about the last block in a containing block or in the file, click the arrow beside the Field indicating the last block in a containing block in the file. Field Base Start Position Justification Length Padding 13. To view the information about the subblocks, select the Structure contains information about subblocks? check box. Update these form fields: Fixed subblock length (if available) Fixed number of subblocks (if available) 15. To view the information about the Field indicating the length of subblocks (if available), click the arrow beside the Field indicating the length of subblocks (if available). Field Base Start Position Justification Length Padding
11.
14.
CSGDM-10.0-MFUG-2004-04-30
649
16.
To view the information about the Field indicating the number of subblocks (if available), click the arrow beside the Field indicating the number of subblocks (if available). Update these form fields: Field Base Start Position Justification Length Padding
17.
18.
To view the information about the module support, select the Structure contains information about module support? check box. Update this form field: Module Support
19.
20.
To view the information about the records in the file, select the Structure contains information about records in the block? check box. Update this form field: Number of records in this block (if fixed)
21.
22.
To view the information about Field indicates the number of records (if exists), select the Field indicates the number of records (if exists) check box. Update these form fields: Field Base Start Position Justification Length Padding
23.
24.
To view the information about Field indicates the length of records (if exists), select the Field indicates the length of records (if exists) check box. Update these form fields: Field Base Start Position Justification
25.
CSGDM-10.0-MFUG-2004-04-30
650
Length Padding 26. To view the information about Field indicates the length of the highest tier block, select the Field indicates the length of the highest tier block check box. Update these form fields: Field Base Start Position Justification Length Padding 28. To view the information about Field indicates fixed module supported in the block, select the Field indicates fixed module supported in the block check box. Update these form fields: Field Base Start Position Justification Length Padding 30. Click Submit.
27.
29.
CSGDM-10.0-MFUG-2004-04-30
Add a Field
651
Add a Field
To add a field: 1. Click the New icon.
The new Fields form appears. 2. Fill out these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
652
Update a Field
To update a field: 1. 2. Click the field in the table. The Fields form appears. Update these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
653
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name
CSGDM-10.0-MFUG-2004-04-30
654
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Header Trailers link. The File Header/Trailer Structures page opens.
CSGDM-10.0-MFUG-2004-04-30
655
2.
CSGDM-10.0-MFUG-2004-04-30
656
2.
CSGDM-10.0-MFUG-2004-04-30
657
CSGDM-10.0-MFUG-2004-04-30
658
Elements
These elements are on this page and are described in the Data Dictionary: Base Description Field Field Format File Headers and/or Trailers built from this structure will be included in the calculation of: File length (sum of record lengths) Justification Key Field Length Mediation Feature Set (MFS) Name Offset Padding Record counts (total number of records)? Record Length Field Start Position Structure contains information about the file? Structure contains information about subblocks? Structure contains information about module support? Structure contains information about records in the block? Structure Length (for File and Block Header/Trailers)
Not all form fields on this page require data. Fields are there to accommodate a variety of structure types and to increase the efficiency and flexibility of record parsing. Only fill out form fields that pertain to the structure you are defining.
CSGDM-10.0-MFUG-2004-04-30
659
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Header Trailers link in the File Format Definitions section. The File Header and Trailers page opens. Click a New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
660
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Header Trailers link in the File Format Definitions section. The File Header and Trailers page opens. Click the Name of the file header and trailer in the table. The File Header/Trailer Structure page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
661
2.
CSGDM-10.0-MFUG-2004-04-30
662
10.
To view the information about the length of the file, click the arrow beside the Field indicating the length of subblocks (if available). Field Base Start Position Justification Length Padding
11.
To view the information about the number of records in a file, click the arrow beside the Field indicates the number of records (if exists). Field Base Start Position Justification Length Padding
12.
To view the information about the subblocks, select the Structure contains information about subblocks? check box. To view the information about the Field indicates the length of the highest tier block, click the arrow beside the Field indicates the length of the highest tier block. Field Base Start Position Justification Length Padding
13.
14.
To view the information about the Field indicates the number of highest tier blocks in the file, click the arrow beside the Field indicates the number of highest tier blocks in the file. Fill out these form fields: Field Base Start Position Justification Length Padding
15.
CSGDM-10.0-MFUG-2004-04-30
663
16.
To view the information about the module support, select the Structure contains information about module support? check box. Fill out this form field: Module Support
17.
18.
To view the information about the records in the file, select the Structure contains information about records in the block? check box. To view the information about Field indicates the length of records (if exists), select the arrow beside the Field indicates the length of records (if exists) check box. Fill out these form fields: Field Base Start Position Justification Length Padding
19.
20.
21.
Click Submit.
CSGDM-10.0-MFUG-2004-04-30
664
2.
CSGDM-10.0-MFUG-2004-04-30
665
11.
To view the information about the length of the file, click the arrow beside the Field indicating the length of subblocks (if available). Field Base Start Position Justification Length Padding
12.
To view the information about the number of records in a file, click the arrow beside the Field indicates the number of records (if exists). Field Base Start Position Justification Length Padding
13.
To view the information about the subblocks, select the Structure contains information about subblocks? check box. To view the information about the Field indicates the length of the highest tier block, click the arrow beside the Field indicates the length of the highest tier block. Field Base Start Position Justification Length Padding
14.
15.
To view the information about the Field indicates the number of highest tier blocks in the file, click the arrow beside the Field indicates the number of highest tier blocks in the file. Fill out these form fields: Field Base Start Position Justification Length Padding
16.
CSGDM-10.0-MFUG-2004-04-30
666
17.
To view the information about the module support, select the Structure contains information about module support? check box. Fill out this form field: Module Support
18.
19.
To view the information about the records in the file, select the Structure contains information about records in the block? check box. To view the information about Field indicates the length of records (if exists), select the Field indicates the length of records (if exists) check box. Fill out these form fields: Field Base Start Position Justification Length Padding
20.
21.
22.
Click Submit.
CSGDM-10.0-MFUG-2004-04-30
Add a Field
667
Add a Field
To add a field: 1. Click the New icon.
The new Fields form appears. 2. Fill out these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
668
Update a Field
To update a field: 1. 2. Click the field in the table. The Fields form appears. Update these form fields: Name Offset Automatically Adjust Offset Field? 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
669
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name Type
CSGDM-10.0-MFUG-2004-04-30
670
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Formats link in the File Format Definitions section. The File Formats page opens.
CSGDM-10.0-MFUG-2004-04-30
671
CSGDM-10.0-MFUG-2004-04-30
672
CSGDM-10.0-MFUG-2004-04-30
673
Elements
These elements are on this page and are described in the Data Dictionary: Description Format Name Mediation Feature Set (MFS) Module Support Name
CSGDM-10.0-MFUG-2004-04-30
674
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Formats link in the File Format Definitions section. the File Formats page opens. Click the Name of file format in the table. The File Format Format General page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
675
2.
CSGDM-10.0-MFUG-2004-04-30
677
Elements
These elements are on this page and are described in the Data Dictionary: Block Header Name Block Information Block Trailer Name File Header Name File information File Trailer Name Format Name Format Type Level Mediation Feature Set (MFS)
CSGDM-10.0-MFUG-2004-04-30
678
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Formats link in the File Format Definitions section. The File Formats page opens. Click the Name of the file format in the table. The File Format Format General page opens. Select Format Type from the Go drop-down menu. Click Go. The File Format Format Type page opens.
4.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
679
2.
4.
5.
6.
CSGDM-10.0-MFUG-2004-04-30
680
Add a Header/Trailer
To add a header/trailer: 1. Click a New icon.
The New Header/Trailer form appears. 2. If a File Header/Trailer, fill out these form fields: File Header Name File Trailer Name 3. If a Block Header/Trailer, fill out these form fields: Block Header Name Block Trailer Name Level 4. Click Update.
CSGDM-10.0-MFUG-2004-04-30
Update a Header/Trailer
681
Update a Header/Trailer
To update a header/trailer: 1. 2. Click a Header/Trailer in the table. The Header/Trailer form appears. If a File Header/Trailer, update these form fields: File Header Name File Trailer Name 3. If a Block Header/Trailer, update these form fields: Block Header Name Block Trailer Name 4. Click Update.
CSGDM-10.0-MFUG-2004-04-30
683
Elements
These elements are on this page and are described in the Data Dictionary: Format Name Fixed File Length Fixed Record Count Last Record Key Field Mediation Feature Set (MFS)
CSGDM-10.0-MFUG-2004-04-30
684
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Formats link in the File Format Definitions section. The File Formats page opens. Click the Name of the file format in the table. The File Format Format General page opens. Select Format File Size from the Go drop-down menu. Click Go. The File Format File Size page opens.
4.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
685
2.
CSGDM-10.0-MFUG-2004-04-30
687
Elements
These elements are on this page and are described in the Data Dictionary: Base Format Name If there is a value for Key field that indicates the last record in a Tier 1 Block, enter that value Length Mediation Feature Set (MFS) Maximum Record Size Padding Single Structure Used Structure Identified By Start Position
CSGDM-10.0-MFUG-2004-04-30
688
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Formats link in the File Format Definitions section. The File Formats page opens. Click the Name of the file format in the table. The File Format Format General page opens. Select Format Record Structure from the Go drop-down menu. Click Go. The File Format Format Record Structure page opens.
4.
5. 6.
CSGDM-10.0-MFUG-2004-04-30
689
2.
CSGDM-10.0-MFUG-2004-04-30
691
In the wizard, you define the specific parameters for a file format, which helps GRID process it. After you create a file format, it can be associated with any or all sources that generate usage data files with that file format. Not all the form fields in the File Format pages are required. You only need to fill out the necessary fields for the file format that you are creating. The other form fields are there to accommodate a variety of file formats and to increase the flexibility and efficiency of GRID. After you have completed the File Formats page, use the File Format and Structure Associations page to assign the associated record structures to the file format.
Figure 129 The Create a New File Format Wizard Screen One
CSGDM-10.0-MFUG-2004-04-30
692
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Formats link in the File Format Definitions section. The File Formats page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
693
2.
7.
8. 9.
CSGDM-10.0-MFUG-2004-04-30
694
11.
To fill out additional information for the Record Length Field drop-down menu, click the arrow, then fill out these form fields: Start Position Length Justification Base Padding
12. 13.
Click Next. The next page opens. Fill out these form fields: Fixed File Length Fixed Record Count Last Record Key Field
14.
To fill out additional information for the Last Record Key Field dropdown menu, click the arrow, then fill out these form fields: Key Value (for File Format File Size Page) Start Position Length
15.
Click Finish.
CSGDM-10.0-MFUG-2004-04-30
695
After you "Open the File Format & Structure Associations Page" (14696), you can: "Add a Structure" (14697) "Remove a Structure" (14698) "Go to Another Page in the Mediation Feature Set" (14571)
Figure 130 File Format & Structures Association Page
Elements
These elements are on this page and are described in the Data Dictionary: Description File Format Mediation Feature Set (MFS) Name
CSGDM-10.0-MFUG-2004-04-30
696
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the File Format & Structure Associations link in the File Format Definitions column. The File Format & Structures Associations page opens.
CSGDM-10.0-MFUG-2004-04-30
Add a Structure
697
Add a Structure
1. Follow the instructions to "Open the File Format & Structure Associations Page" (14696). Fill out this form fields at the top of the page: File Format 3. 4. Click the icon beside the structure in the Available Structures table. Click Submit.
2.
CSGDM-10.0-MFUG-2004-04-30
698
Remove a Structure
1. Follow the instructions to "Open the File Format & Structure Associations Page" (14696). Fill out this form fields at the top of the page: File Format 3. 4. Click the icon beside the structure in the Associated Structures table. Click Submit.
2.
CSGDM-10.0-MFUG-2004-04-30
699
CSGDM-10.0-MFUG-2004-04-30
700
Elements
These elements are on this page and are described in the Data Dictionary: Audit Button Audited File Format Only? File Format Mediation Feature Set (MFS) Results
CSGDM-10.0-MFUG-2004-04-30
701
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Audit link in the File Format Definitions section. The Audit page opens.
CSGDM-10.0-MFUG-2004-04-30
702
Perform an Audit
To perform an audit: 1. 2. Follow the instructions to "Open the Audit Page" (14701). Fill out these form fields: Mediation Feature Set (MFS) File Format Audited File Format Only? 3. Click Audit. The results of the audit appear in the Results text box and the date on the Audit Button is updated.
CSGDM-10.0-MFUG-2004-04-30
This chapter describes the search and filter applications, including information on: Overview Working with Field Filters Working with Record Filters Using the Search/Filter Applications Working with the Search Application Defining the Search Application Using the Pass Action Feature Auditing Search Applications Naming of Search Files Working with the Filter Application Defining the Filter Application Using the Filter Test Tool Filtering File Headers and Block Headers Auditing Filter Applications
CSGDM-10.0-MFUG-2004-04-30
704
Overview
After you select a mediation feature set, three sets of icons appear, including the Search/Filter Application Definitions icons. This group of links, called the Search/Filter Definitions menu, lets you access the pages needed to create all the parts of a filter.
Figure 132 Search/Filter Applications Definitions Menu
When you click each of these links, the corresponding Search/Filter Application Definitions page opens. These pages are listed, from top to bottom, in the order that you need to access the pages. You do not need to use all the pages; use only the pages that have the filter features that you want.
CSGDM-10.0-MFUG-2004-04-30
Overview
705
Because the filter and search use the same engine and processes, you only have to define the criteria for a format once. If you define the criteria for a filter, then you can use the same criteria to define a search without reentering it.
Table 6 Search/Filter Application Definitions Icons and Corresponding Pages
To Go to the Value Lists Page (Search/Filter Application Definitions) to create the list IDs
Go to the Field Filters Page, which lets you create a one-to-one relationship between a field and a specific filter comparison operator Go to the Record Filters Page, which lets you create the system logic for a filter
Go to the Search/Filter Applications Page, which lets you combine all the filter requirements together and create a unique name for the filter or search
CSGDM-10.0-MFUG-2004-04-30
706
The field comparison operator values must match the GRID field you selected.
Table 7 Field Filter Comparison Operators
Use this operator Equals Not Equals Greater Than Greater Than or Equals Less Than Less Than or Equals Match In Range In List Not Match Not In List Field Exists Field Does Not Exist Not In Range
When you want the field value to Be exactly the same as the comparison operator Value field Not be the same as the comparison operator Value field Be larger than the comparison operator Value field Be greater than or equal to the comparison operator Value field Be less than the comparison operator Value field Be less than or equal to the comparison operator Value field Exactly match the comparison operator Value field Be greater than or equal to the Lower Range value and less than or equal to the Upper Range value Exactly match one of the values contained in the List ID (Field Filter Page) Not match the comparison operator Value field Not match one of the values contained in the List ID (Field Filter Page) Be contained in the record being filtered Not be contained in the record being filtered Not be greater than or equal to the Lower Range value and less than or equal to the Upper Range value
CSGDM-10.0-MFUG-2004-04-30
707
When you want the field value to Exactly match one of the values contained in the External DB Name Not match one of the values contained in the External DB Name
Wildcard
Use wildcard characters to represent one or more characters with the Match and Not Match operators. You can use any number of wildcard characters in the comparison field value. Use the question mark (?) as the wildcard character for all data types; however, you can also use the asterisk (*) for EBCDIC and ASCII.
Example
The comparison value of 3?7 matches any string that is three characters long, begins with a 3, and ends with a 7 The comparison value of?2???c matches any string that is 6 characters long, has a value of 2 in the second position, and ends with a c
CSGDM-10.0-MFUG-2004-04-30
708
References
For information on the Filter Test Tool, see "Using the Filter Test Tool" (15719).
CSGDM-10.0-MFUG-2004-04-30
709
You can go to an existing search or filter page by clicking the name of an existing search or filter that is listed in the table.
Figure 136 Existing Search or Filters in Search/Filter Applications Table
CSGDM-10.0-MFUG-2004-04-30
710
CSGDM-10.0-MFUG-2004-04-30
711
Using this feature, you can verify test calls, validate new services, and isolate errors. After you determine the field or fields that you want to examine, select what records you want to search the information that you are searching for, such as: Services Subscribers Called numbers Calling numbers Elapsed time Specified data fields
Search records are stored as tertiary billing data files. After the records are stored in the search source (automatically created after a search name is audited) they are marked as tertiary and can be: Searched by using the Data Files Page Viewed with the Data File Page Sent to a printer or saved to a UNIX file using the Print function provided by the Data File Page Transmitted to a downstream destination using the Data Transmission Schedule Page Searched again by using the Data File Searches Page or by setting up a new search on a search source type Records remain on the Data Mediation system disk until the system parameters for disk high and disk low percentages are met. These values are set on the System Parameters Page. You can also manually delete these files from the system.
CSGDM-10.0-MFUG-2004-04-30
712
CSGDM-10.0-MFUG-2004-04-30
713
CSGDM-10.0-MFUG-2004-04-30
714
CSGDM-10.0-MFUG-2004-04-30
715
Search Application Name The value you used to name the search File format Identifies the name of the file format. System-generated ID The formula for the system generated unique ID is DYYJJJ$$SXXXXX. These characters are defined as follows: The D is the character D The YY stands for the last two digits of the current year The JJJ stands for the Julian Day The $$ is the previously defined file name separator The S is the character S XXXXX is the number of seconds after midnight that the search started This formula generates a unique filename as long as you do not start multiple searches with the same prefix at exactly the same time. Volume number If a single file is not large enough to hold the search data found for the specified file format, additional files are created. To track the ordering of files, a volume number is assigned to every file. The first file is designated with a v1, the second with v2 (as in the preceding examples of output file names), the third is v3, and so on to vn, where n is the final file created to handle the search data for the specified file format. Specify the maximum number of records that are written to an individual search output file using Search Parameters Page.
CSGDM-10.0-MFUG-2004-04-30
716
CSGDM-10.0-MFUG-2004-04-30
717
Figure 141 The Filter Application in the Input and Output Streams
CSGDM-10.0-MFUG-2004-04-30
718
CSGDM-10.0-MFUG-2004-04-30
719
CSGDM-10.0-MFUG-2004-04-30
720
CSGDM-10.0-MFUG-2004-04-30
721
CSGDM-10.0-MFUG-2004-04-30
This section describes the Search/Filter Application Definition pages, including information on: Creating Search/Filter Application Definitions Updating Search/Filter Application Definitions Opening Search/Filter Application Definition pages
CSGDM-10.0-MFUG-2004-04-30
725
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) List Name
CSGDM-10.0-MFUG-2004-04-30
726
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click Value Lists in the Search/Filter Application Definitions section. The Value Lists page opens.
CSGDM-10.0-MFUG-2004-04-30
727
CSGDM-10.0-MFUG-2004-04-30
728
CSGDM-10.0-MFUG-2004-04-30
729
CSGDM-10.0-MFUG-2004-04-30
730
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) List Name Value
CSGDM-10.0-MFUG-2004-04-30
731
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click Value Lists in the Search/Filter Application Definitions section. The Value Lists page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
732
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click Value Lists in the Search/Filter Application Definitions section. The Value Lists page opens. Click a List Name in the table. The Value List page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
733
CSGDM-10.0-MFUG-2004-04-30
734
CSGDM-10.0-MFUG-2004-04-30
Add a Value
735
Add a Value
To add a value: 1. Click the New icon.
The Value form appears. 2. Fill out this form field: Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
736
Update a Value
To update a value: 1. 2. Click the icon beside the value in the table. The Value form appears. Update this form field: Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
737
Elements
These elements are on this page and are described in the Data Dictionary: Description Field Filter Use Mediation Feature Set (MFS) Name Record Type
CSGDM-10.0-MFUG-2004-04-30
738
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Field Filters link in the Search/Filter Application Definitions section. The Field Filters page opens.
CSGDM-10.0-MFUG-2004-04-30
739
CSGDM-10.0-MFUG-2004-04-30
740
CSGDM-10.0-MFUG-2004-04-30
741
CSGDM-10.0-MFUG-2004-04-30
742
Elements
These elements are on this page and are described in the Data Dictionary: Comparison Operator Description External DB Name Field Field Filter Name Field Name (Field Filter Page) Filter Use List ID (Field Filter Page) Lower Range Mediation Feature Set (MFS) Module Name (Field Filter page) Record Type Upper Range Value
References
For more information on field filters, see "Working with Field Filters" (15706)
CSGDM-10.0-MFUG-2004-04-30
743
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Field Filters link in the Search/Filter Application Definitions section. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
744
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Field Filters link in the Search/Filter Application Definitions section. Click the Name of the field filter in the table. The Field Filter page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
745
References
For more information on field filters, see "Working with Field Filters" (15706)
CSGDM-10.0-MFUG-2004-04-30
746
CSGDM-10.0-MFUG-2004-04-30
747
Elements
These elements are on this page and are described in the Data Dictionary: Description Mediation Feature Set (MFS) Name Record Type Valid for Record ID
CSGDM-10.0-MFUG-2004-04-30
748
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Record Filters link in the Search/Filter Application Definitions section. The Record Filters page opens.
CSGDM-10.0-MFUG-2004-04-30
749
CSGDM-10.0-MFUG-2004-04-30
750
CSGDM-10.0-MFUG-2004-04-30
751
After you "Open a New Record Filter Page" (16753), you can: "Create a Record Filter" (16755) "Create a Special Filter" (16756) "Go to Another Page in the Mediation Feature Set" (14571) After you "Open an Existing Record Filter Page" (16754), you can: "Update a Record Filter" (16757) "Go to Another Page in the Mediation Feature Set" (14571)
Figure 148 Record Filter Page
CSGDM-10.0-MFUG-2004-04-30
752
Elements
These elements are on this page and are described in the Data Dictionary: Description Expression (for Secondary Key Mappings) Field Filters Mediation Feature Set (MFS) Name Only valid for Record ID (Special Filters) Record Type
CSGDM-10.0-MFUG-2004-04-30
753
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Record Filters link in the Search/Filter Application Definitions section. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
754
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Record Filters link in the Search/Filter Application Definitions section. Click the Name of the record filter in the table. The Record Filter page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
755
CSGDM-10.0-MFUG-2004-04-30
756
CSGDM-10.0-MFUG-2004-04-30
757
CSGDM-10.0-MFUG-2004-04-30
759
Elements
These elements are on this page and are described in the Data Dictionary: Description Format Name Mediation Feature Set (MFS) Name Type
References
For information on creating special filters, see "Create a Special Filter" (16756)
CSGDM-10.0-MFUG-2004-04-30
760
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
CSGDM-10.0-MFUG-2004-04-30
761
2.
A drop-down menu appears. 3. Select the Search Application radio button. A new Search Application page opens.
CSGDM-10.0-MFUG-2004-04-30
762
2.
A drop-down menu appears. 3. Select the Filter Application radio button. A new Filter Application page opens.
CSGDM-10.0-MFUG-2004-04-30
763
2.
CSGDM-10.0-MFUG-2004-04-30
764
2.
CSGDM-10.0-MFUG-2004-04-30
765
CSGDM-10.0-MFUG-2004-04-30
766
Elements
These elements are on this page and are described in the Data Dictionary: Audited? Description File Format For Block Headers (Level 1) apply For Block Headers (Level 2) apply For Block Headers (Level 3) apply For Data Records apply For File Headers apply Last Audited Mediation Feature Set (MFS) Name Pass Action Record Filter Results Rule
CSGDM-10.0-MFUG-2004-04-30
767
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Search/Filter Applications link in the Search/Filter Application Definitions section. Click the New icon.
4.
A drop-down menu appears. 5. Select the Filter Application radio button. A new Filter Application page opens.
CSGDM-10.0-MFUG-2004-04-30
768
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Search/Filter Applications link in the Search/Filter Application Definitions section. Click the Name of the filter application in the table. The Filter Application page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
769
4. 5. 6. 7.
CSGDM-10.0-MFUG-2004-04-30
770
2.
4.
5. 6. 7. 8.
CSGDM-10.0-MFUG-2004-04-30
771
The Special Rule form appears. 2. Fill out these form fields: Rule Record Filter 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
772
CSGDM-10.0-MFUG-2004-04-30
773
CSGDM-10.0-MFUG-2004-04-30
774
Elements
These elements are on this page and are described in the Data Dictionary: Audited? Data Record Filter Description File Format Last Audited Mediation Feature Set (MFS) Name Pass Action Results
CSGDM-10.0-MFUG-2004-04-30
775
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Search/Filter Applications link in the Search/Filter Application Definitions section. Click the New icon.
4.
A drop-down menu appears. 5. Select the Search Application radio button. A new Search Application page opens.
CSGDM-10.0-MFUG-2004-04-30
776
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Search/Filter Applications link in the Search/Filter Application Definitions section. Click the Name of the search application in the table. The Search Application page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
777
2.
4. 5. 6. 7.
CSGDM-10.0-MFUG-2004-04-30
778
2.
4.
5. 6. 7. 8.
CSGDM-10.0-MFUG-2004-04-30
779
The Special Filter form appears. 2. Fill out this form field: Filter 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
780
CSGDM-10.0-MFUG-2004-04-30
This chapter describes the validation application, including information on: Overview Accessing the Validation Application Definition Pages Defining a Validation Application Working with Exception Files and Validation Working with Validation Expressions Working with Expression Record Associations Working with Application Expression Associations Working with Validation Expressions Order Working with Validation Audits Working with the Duplicate Record Checking Feature
CSGDM-10.0-MFUG-2004-04-30
782
Overview
Validation is an optional mediation feature that lets you define a set of validation criteria and apply it to data that is processed in the source and destination application streams. Validation can be performed on: A single field or set of fields in a record. You can test a field that: has a file format defined in GRID is numeric, alphanumeric, or BCD contains a call code that falls within a specified range contains a valid date or time value A record Block and file headers and trailers. You can validate that the size, count, or sequence number field in a header or trailer are correct You can set up the validation process to be performed when data is collected from the source or just prior to transmission to the destination. The feature normally is not performed in both application streams. You associate the validation application with an application stream on the Source Application Associations Page or Destination Application Associations Page; however, you must create and audit a validation application before installing it in an application stream. The system supports a unique set of validation criteria for each application stream.
CSGDM-10.0-MFUG-2004-04-30
Overview
783
CSGDM-10.0-MFUG-2004-04-30
784
GRID parses the file being transmitted based on the defined file format, then passes the records to the Validation module. The validation criteria are compared with the contents of the targeted data fields in the input records. If the record does not meet the validation criteria, it can: Be automatically corrected and remain in the application stream Remain in the application stream uncorrected Be removed from the application stream and sent to an exception file area Force the rejection of the entire data block or file to the exception file area Be removed from the application stream and discarded Force the discard of the entire data block or file
Note If the record has not been assigned to a validation expression name, it passes by default.
In all cases, even if the record passes the validation criteria, a message can be sent to the Application Event log or Error and Information log. Using the Customer Defined Statistics Report, you can set up the report to profile record processing by summarizing the number of validation actions performed on records, such as how many records were deleted, corrected, or rejected.
CSGDM-10.0-MFUG-2004-04-30
785
When you select an option from this drop-down menu, three columns of links appear, including the Validation Application Definitions links.
Figure 154 The Validation Application Definitions Links
CSGDM-10.0-MFUG-2004-04-30
786
When you click a link in this column, the corresponding Validation Application Definitions page opens. These links are found in the Validation Application Definitions column.
Table 8 Validation Application Definitions Links and the Corresponding Pages
CSGDM-10.0-MFUG-2004-04-30
787
Go to the Validation Expressions Order Page. Use this page to assign the order that validation expressions are processed in the data stream.
Go to the Audit Page (for Validation). Use this page to audit the validation application definition.
CSGDM-10.0-MFUG-2004-04-30
788
CSGDM-10.0-MFUG-2004-04-30
789
CSGDM-10.0-MFUG-2004-04-30
790
CSGDM-10.0-MFUG-2004-04-30
791
Using Operators
Expressions are created using operators (or functions). When you click the operators drop-down menu, a menu of available operators appears.
Figure 157 Available Operator Types
On the Validation Expression Page, several operators in this menu are used only with validation, including: Update Statistics for populating user-defined statistic fields in the database which can be used for generating user-defined statistical reports or retrieved using the getStatistics operators Validation Operators for specific field checks Validation Actions for specifying what happens with the data and whether an alarm message is generated Duplicate Record Checking for detecting duplicate data in collection or transmission Another set of operators (an optional feature available only when purchased) is the Bulk Edit Actions set.
References
For more information on format and validation operators, see the GML Developer Reference Guide
CSGDM-10.0-MFUG-2004-04-30
792
CSGDM-10.0-MFUG-2004-04-30
793
CSGDM-10.0-MFUG-2004-04-30
794
CSGDM-10.0-MFUG-2004-04-30
795
After you run the audit, the audit messages are listed in the Results box and the information in the Last Audited field is updated with the date and time of the latest audit. When a validation audit fails, use the information in the audit messages to help you start troubleshooting the issue.
CSGDM-10.0-MFUG-2004-04-30
796
2.
3.
4.
5.
These operators are described in the GML Developer Reference Guide and determine whether a record is a duplicate record, which is a record or event that was previously collected or transmitted. Duplicate records do not have to be identical and they can have different record structures, be from different sources, be of different file formats, or belong to different mediation feature sets. The isDuplicate and isNotDuplicate operators only have one parameter (record_ key); the operators evaluate the key for each record. This key is an expression that identifies the record. It has one or more pieces of information from the record that uniquely characterizes the record, such as a field or set of fields. If this key matches a key in the reference set, then the system determines that this record is a duplicate. Otherwise, the key is added to the reference set for
CSGDM-10.0-MFUG-2004-04-30
797
subsequent duplicate record checking. This process of evaluating the key for each record is called the duplicate key micro check. Because the system has a limited space for the reference set, it must periodically prune older (expired) record keys to make room for incoming record keys. If the record being evaluated is older than the set of records in the reference set, there is no way to determine if the record is a true duplicate because it is too old. To overcome this problem, the macro check can be used. The isDuplicate1 and isNotDuplicate1 operators have two parameters (reference_key and reference_number); the operators evaluate the key for the record. If it is a duplicate, then it is treated for the micro check. If it is not a duplicate, then the reference number for the record is compared with the reference number, which is typically a date or time value, for the reference set. This reference number value determines the age (or sequence) of the record. When the records are removed from the reference set, the minimum value of this reference number for all records is identified and saved. After the micro check, the system checks to see if the record being evaluated is older than the reference set by comparing the record reference_number with the reference set reference_ number. If the record reference_number is smaller than the record, it is considered older and is treated as a duplicate record. This micro/macro strategy allows efficient duplicate record checking over an extended period of time with minimal impact to computer resources or performance. Only records that pass this macro check are considered to be nonduplicate and their keys are added to the reference set. Using the validation actions, you can specify in the operator how duplicate records are managed (for example, change a field in the record, send the record to the exception file, or delete the duplicate record). For each case, an alarm message can be generated for a log. You perform these validation actions so that the record can be evaluated at a later time by looking in the exception file or viewing the log.
Note Reference numbers must not be negative. Although reference numbers are frequently date and time values, you can also use other numeric values such as sequence numbers. In all cases, however, if the second parameter for the record is smaller than the reference set reference number, then the record is determined to be older than the record information in the reference set.
CSGDM-10.0-MFUG-2004-04-30
798
In this example: The isDuplicate operator is highlighted The record key value is defined as the catenation of these fields: Calling Number, Called Number, Disconnect Date, and Disconnect Time If the record is determined to be a duplicate record, the record is sent to the exception file, a minor alarm message is generated, and the alarm message is sent to the Error and Information log
In this example: The isDuplicate1 operator is highlighted The record key value is defined as the catenation of these fields: Calling Number and Called Number The value compared with the reference number is defined as the disconnect date or time, represented as seconds since 1970. The expressions mathDate and mathTime convert the respective representation of date and time in the record fields into seconds The micro check looks to see if a record key value exists in the reference set. If the record key value does not exist, then the macro check is performed, checking to see if the disconnect date and time value is less than the oldest record in the reference set If the micro or macro check determines that the record is a duplicate, the record is sent to the exception file, a minor alarm message is generated, and the alarm message is sent to the Error and Information log
CSGDM-10.0-MFUG-2004-04-30
799
CSGDM-10.0-MFUG-2004-04-30
800
CSGDM-10.0-MFUG-2004-04-30
801
For instructions on filling out the form fields on this page, see "Validation Application Page" (18857) in this user guide.
CSGDM-10.0-MFUG-2004-04-30
This section describes the Validation Application Definition pages, including information on: Opening the Validation Application Definitions pages Creating Validation Application Definitions Updating Validation Application Definitions
CSGDM-10.0-MFUG-2004-04-30
805
Elements
These elements are on this page and are described in the Data Dictionary: Description List Name Mediation Feature Set (MFS)
CSGDM-10.0-MFUG-2004-04-30
806
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Value Lists link in the Validation Application Definitions section. The Value Lists page opens.
CSGDM-10.0-MFUG-2004-04-30
807
CSGDM-10.0-MFUG-2004-04-30
808
CSGDM-10.0-MFUG-2004-04-30
809
CSGDM-10.0-MFUG-2004-04-30
811
CSGDM-10.0-MFUG-2004-04-30
812
Elements
These elements are on this page and are described in the Data Dictionary: Description List Name Mediation Feature Set (MFS) Value
CSGDM-10.0-MFUG-2004-04-30
813
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Value Lists link in the Validation Application Definitions section. The Value Lists page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
814
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Value Lists link in the Validation Application Definitions section. The Value Lists page opens. Click the List Name of the value list in the table. The Value List page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
815
CSGDM-10.0-MFUG-2004-04-30
816
CSGDM-10.0-MFUG-2004-04-30
Add a Value
817
Add a Value
To add a value: 1. Click the New icon.
The Value form appears. 2. Fill out this form field: Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
818
Update a Value
To update a value: 1. 2. Click the icon beside the value in the table. The Value form appears. Update this form field: Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
819
Elements
These elements are on this page and are described in the Data Dictionary: Description List Name Mediation Feature Set (MFS)
CSGDM-10.0-MFUG-2004-04-30
820
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Table Lookup Value Lists link in the Validation Application Definitions section. The Table Lookup Value Lists page opens.
CSGDM-10.0-MFUG-2004-04-30
821
2.
CSGDM-10.0-MFUG-2004-04-30
822
2.
CSGDM-10.0-MFUG-2004-04-30
823
CSGDM-10.0-MFUG-2004-04-30
824
Elements
These elements are on this page and are described in the Data Dictionary: Description Key Value List Name Mediation Feature Set (MFS) Table Value
CSGDM-10.0-MFUG-2004-04-30
825
2.
\
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Table Lookup Value Lists link in the Validation Application Definitions section. The Table Lookup Value Lists page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
826
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click Table Lookup Value Lists in the Validation Application Definitions section. The Table Lookup Value Lists page opens. Click the List Name of the table lookup value list in the table. The Table Lookup Value List page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
827
2.
CSGDM-10.0-MFUG-2004-04-30
828
2.
CSGDM-10.0-MFUG-2004-04-30
Add a Value
829
Add a Value
To add a value: 1. Click the New icon.
The Value form appears. 2. Fill out these form field: Key Value Table Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
830
Update a Value
To update a value: 1. 2. Click the icon beside the value in the table. The Value form appears. Update these form field: Key Value Table Value 3. Click Update.
CSGDM-10.0-MFUG-2004-04-30
831
Elements
These elements are on this page and are described in the Data Dictionary: Description Reference Set Name
References
"Working with the Duplicate Record Checking Feature" (17796) in the Mediation Features User Guide
CSGDM-10.0-MFUG-2004-04-30
832
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Reference Sets link in the Validation Application Definitions section.
CSGDM-10.0-MFUG-2004-04-30
833
CSGDM-10.0-MFUG-2004-04-30
834
CSGDM-10.0-MFUG-2004-04-30
835
Elements
These elements are on this page and are described in the Data Dictionary: Check Secondary Files? Check Tertiary Files? Description File System (for Reference Sets) Maximum Reference Set Count Reference Key Length Reference Key Pad Reference Set Name Reference Window Interval Root Node Count Update Record? Update Time Stamp?
CSGDM-10.0-MFUG-2004-04-30
836
Elements
These elements are on this page and are described in the Data Dictionary: and minutes (for Reference Sets) at hours (for reference sets) Days of Each Week Dates in the Selected Month Description in months on days Reference Set Name
References
"Working with the Duplicate Record Checking Feature" (17796) in the Mediation Features User Guide
CSGDM-10.0-MFUG-2004-04-30
837
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Reference Sets link in the Validation Application Definitions section. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
838
2.
CSGDM-10.0-MFUG-2004-04-30
839
Elements
These elements are on this page and are described in the Data Dictionary: Check Secondary Files? Check Tertiary Files? Description File System (for Reference Sets) Maximum Reference Set Count Reference Key Length Reference Key Pad Reference Set Name
CSGDM-10.0-MFUG-2004-04-30
840
Reference Window Interval Root Node Count Update Record? Update Time Stamp?
References
"Working with the Duplicate Record Checking Feature" (17796) in the Mediation Features User Guide
CSGDM-10.0-MFUG-2004-04-30
841
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Reference Sets link in the Validation Application Definitions section. Click the Reference Set Name in the table. The Reference Set Summary page opens. Click the Parameters link. The Reference Set Parameters page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
842
2.
CSGDM-10.0-MFUG-2004-04-30
843
Elements
These elements are on this page and are described in the Data Dictionary: at hours and minutes Check Secondary Files? Check Tertiary Files? Description File System (for Reference Sets) in months Maximum Reference Set Count on days Reference Key Length Reference Key Pad Reference Window Interval
CSGDM-10.0-MFUG-2004-04-30
844
References
"Working with the Duplicate Record Checking Feature" (17796) in the Mediation Features User Guide
CSGDM-10.0-MFUG-2004-04-30
845
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Reference Sets link in the Validation Application Definitions section. Click the Reference Set Name in the table. The Reference Set Summary page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
846
2.
CSGDM-10.0-MFUG-2004-04-30
847
2.
CSGDM-10.0-MFUG-2004-04-30
849
Elements
These elements are on this page and are described in the Data Dictionary: and minutes (for Reference Sets) at hours (for reference sets) Days of Each Week Dates in the Selected Month Description in months on days Reference Set Name
References
"Working with the Duplicate Record Checking Feature" (17796) in the Mediation Features User Guide
CSGDM-10.0-MFUG-2004-04-30
850
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Reference Sets link in the Validation Application Definitions section. Click the Reference Set Name in the table. The Reference Set Summary page opens. Click the Pruning Schedule link. The Reference Set Pruning Schedule page opens.
4.
5.
CSGDM-10.0-MFUG-2004-04-30
851
2.
CSGDM-10.0-MFUG-2004-04-30
853
Elements
These elements are on this page and are described in the Data Dictionary: Description File Format Mediation Feature Set (MFS) Name Reference Set
CSGDM-10.0-MFUG-2004-04-30
854
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Validation Applications links in the Validation Application Definitions section. The Validations Applications page opens.
CSGDM-10.0-MFUG-2004-04-30
855
2.
CSGDM-10.0-MFUG-2004-04-30
856
2.
CSGDM-10.0-MFUG-2004-04-30
857
CSGDM-10.0-MFUG-2004-04-30
858
Elements
These elements are on this page and are described in the Data Dictionary: Description File Format Mediation Feature Set (MFS) Name Reference Set Name
These elements are also available when you view the reference set information by placing your cursor on the View icon. at hours and minutes Check Secondary Files? Check Tertiary Files? Description File System (for Reference Sets) in months Maximum Reference Set Count on days Reference Key Length Reference Key Pad Reference Window Interval Root Node Count Update Record? Update Time Stamp?
CSGDM-10.0-MFUG-2004-04-30
859
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click Validation Applications in the Validation Application Definitions section. The Validation Applications page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
860
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click Validation Applications in the Validation Application Definitions section. The Validation Applications page opens. Click the Name of the validation application in the table. The Validation Application page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
861
2.
CSGDM-10.0-MFUG-2004-04-30
862
2.
5.
CSGDM-10.0-MFUG-2004-04-30
863
Elements
These elements are on this page and are described in the Data Dictionary: Expression (for Secondary Key Mappings) Mediation Feature Set (MFS) Name Record Type
CSGDM-10.0-MFUG-2004-04-30
864
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Validation Expressions link in the Validation Application Definitions section. The Validation Expressions page opens.
CSGDM-10.0-MFUG-2004-04-30
865
2.
CSGDM-10.0-MFUG-2004-04-30
866
2.
CSGDM-10.0-MFUG-2004-04-30
867
CSGDM-10.0-MFUG-2004-04-30
868
Elements
These elements are on this page and are described in the Data Dictionary: Default Execution Order Expression (for Validation) Justification Mediation Feature Set (MFS) Padding Record Type Validation Expression
CSGDM-10.0-MFUG-2004-04-30
869
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Validation Expressions links in the Validation Application Definitions section. The Validation Expressions page opens. Click the New icon.
4.
CSGDM-10.0-MFUG-2004-04-30
870
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click Validation Expressions in the Validation Application Definitions section. The Validation Expressions page opens. Click the Name of the validation expression in the table. The Validation Expression page opens.
4.
CSGDM-10.0-MFUG-2004-04-30
871
CSGDM-10.0-MFUG-2004-04-30
872
2.
CSGDM-10.0-MFUG-2004-04-30
873
Elements
These elements are on this page and are described in the Data Dictionary: Display by File Format Mediation Feature Set (MFS) Name Record Names Record Type Validation Expression Names
CSGDM-10.0-MFUG-2004-04-30
874
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Expression Record Association link in the Validation Application Definitions section.
CSGDM-10.0-MFUG-2004-04-30
875
2.
5.
6.
7.
CSGDM-10.0-MFUG-2004-04-30
877
Elements
These elements are on this page and are described in the Data Dictionary: Display by File Format Mediation Feature Set (MFS) Name Validation Name Validation Expression Names
CSGDM-10.0-MFUG-2004-04-30
878
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Application Expression Association link in the Validation Application Definitions section.
CSGDM-10.0-MFUG-2004-04-30
879
2.
5.
6.
7.
CSGDM-10.0-MFUG-2004-04-30
881
Elements
These elements are on this page and are described in the Data Dictionary: Expression Name Mediation Feature Set (MFS) Validation Name New Order Order Record Type Name
CSGDM-10.0-MFUG-2004-04-30
882
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Validation Expressions Order link in the Validation Application Definitions section. The Validation Expressions Order page opens.
CSGDM-10.0-MFUG-2004-04-30
883
2.
4.
CSGDM-10.0-MFUG-2004-04-30
885
Elements
These elements are on this page and are described in the Data Dictionary: Audited? Description Expression Name File Format Last Audited Mediation Feature Set (MFS) Validation Name Order Record Type Reference Set Name Results
CSGDM-10.0-MFUG-2004-04-30
886
2.
Select the mediation feature set from the Active Mediation Feature Set drop-down menu.
3.
Click the Audit link in the Validation Application Definitions section. The Audit page opens.
CSGDM-10.0-MFUG-2004-04-30
887
4.
CSGDM-10.0-MFUG-2004-04-30
Index
A
application expression associations 793 application GUI structure checks 537 application manager 114 application stream 65, 114 ASCII 527 error messages 548 file format 551 evaluation order 16 event records 217 combining 218 exception files 789 exception handling 115 expression record associations 792 external database access definitions 6, 9 extraction 110
B
BCD 527 BINARY 527 BIT 528 bit stuff sequence 63 block descriptor word 61 block header/trailers 542 block headers/trailers guidelines 542 transferring 58 blocking 59 building expressions 10 building records 540
F
field 534 field filters 706 field input 535 field mapping 17 field mappings 17 fields 534 file format 546 file format & structure associations 547 file format conversion 105 setting up 108 file format conversions 116 types 110 file format definition auditing 548 troubleshooting 549 file format definition pages 523 file formats 522, 546 file header/trailers 544 file headers and block headers filtering 720 file headers/trailers guidelines 544 transferring 58 file structures 536 filter application 716 defining 718 filter applications auditing 721 filter test tool 719
C
consulting services 520 control action fields 222 control data fields 222 core record 112 corfilter 226 correlation conversion 210 correlation definitions installing 220 correlation file conversions 213 correlation IDs 215 correlation mapping 221 correlation rules 219 defining 216 correlation store conversions 212 cross-level mappings 111, 112
D
data field types 527 defaults 2 delete bytes from the beginning 63 dummy records 113 duplicate record 796 duplicate record checking feature 796 duplicate record checking operators setting up 796
G
generic record conversion 110 globals 3 grid 529 GRID and exception files 531 grid failure 549 GRID Field Attributes 532 grid field attributes 532 grid file format defining 526 GRID on collection 531 GRID on transmission 531
E
EBCDIC 528 end of block sequence 61 end of file sequence 63 end-of-record sequence 62
CSGDM-10.0-MFUG-2004-04-30
H
harvesting 219, 224 Helvetica italic x
R
record blocking 59 record filters 708 record mappings 18 record structure mapping 62 record-to-module mappings 19 record-to-record mappings 18 reference number, 797 reference set 796 reference sets creating 800 regular modules naming 539 run time errors 549
I
ifthen expression 12 ifthenelse expression 12 incomplete record action 219 incomplete record timeout 219 isDuplicate operator example 798 isDuplicate1 operator example 798
J
justification 21
L
local files 7
S
search application 710 defining 712 search applications auditing 714 search files naming 715 search/filter applications 709 secondary keys 13 source upgrades 521 special filters 708 special modules 540 naming 540 ordering 540
M
macro check 797 mappings 16 mediation feature sets 530 micro check 797 module mappings 20 module supports 541 modules 112, 539 module-to-module mappings 20 multiple modules 539 multiple record structures 537 multiple secondary keys 14
T
table lookup value lists 5 tiers 536, 542 triggers 15
N
nested conditional statements 790 normalization 110
V O
odbc configuration files 7 Open Database Connectivity Software 7 operators 791 output file management 223 output record management 225 validation application defining 788 validation application definition 785 validation audits 795 validation expressions 790 validation expressions order 794 value lists 4
P
package auditing 64 setting up 57 package manager application 54 Packaging 53 padding 21
W
wildcard characters 707
CSGDM-10.0-MFUG-2004-04-30
CSGDM-10.0-MFUG-2004-04-30
CSGDM-10.0-MFUG-2004-04-30