UOUJMK 9 1/1 ~~~N~C - DTIC

I ADAIS BI NTCRAIE~ NFO~ !4 SP PIS&) UOUJMK 9 1/1r "P'W M"JN PA IAl 7 OD"LJ.(U) (Ric..T~( 0I H ~~~N~C TAP Y My DCTQ t dUNSIIED SNH Ei AL.. 0I N8J C PS- I6Z61Z5 F/G L2/5 NIL

I

1±20LL2,

r L L e

IJ

AD-A182 010 F El COP-Y

AFVA-TR-86-4006Volume VPart 22 IDTIC

ELECTJUL 0 8

DINTEGRATED INFORMATIONSUPPORT SYSTEM (1188)Volume V - Common Data Model SubsystemPart 22 -NDL Precompiler Build Calls and Messages

Product Specification

General Electric CompanyProduction Resources ConsultingOne River RoadSchenectady, New York 12345

Final Report for Period 22 September 1980 - 31 July 1985

November 1985

Approved for public release; distribution is unlimited.

MATERIALS LABORATORYAIR FORCE WRIGHT AERONAUTICAL LABORATORIESAIR FORCE SYSTEMS OOMMANDVRIG(T-PATTERSON AFI, ON 45433-8533

87 6 30 122

Ad- -122

REPORT DOCUMENTATION PAGE

*m @~aA.9.a~e~.4OhOA~eeS~wIVLEApproved foar public release;ft 0 C&SS O #CT $Ot tOW~O 01~ifit 9O4 V62distribution Is unlimited.

~..ptpofteMI, @*GaelA&?aghPOR alpeat kusoI m0 1.. WTORMG 40ANILA 0110' Nspom, NtMIea

AFVAL-TR-56-4005 Vol V. Part 22

Ge, %&AS Of PaP@kiohle OftSA%6A?OQd W Q99 'CS syi'S . U AW1& Of 09fhIYOA1#8 ORGANIZATION6

* Production Resouarces ConsultingUi. £55655 194u0. 5..e Ap ZtP eui) 7b. £556555 uram. Sao -W MrP Cow)

3"ncay OTye IMMS VPAF3. 0N 45433-6533

As 6041411 Of #WushO4POuSO^,6 OIC GV618cs 5v~5 . PaeOCWRIM1Idy INSrAWIMSN7 IDgkTOPICATiOf iUMeV200

Air Force Systems Comamg. USAr 5YOAL/HLD.C P5361 580-C-515

at £5061515 OCeh,.Sa me SIP Coosi 10 S*wlles 0. utDimes§ Not

Vzigbt-Pattersom An3. fte 45423 66mS o O. 080. No.

II.ImaS m.g: Ca~maaYS13P 7500 62 01

Is. fT6o?&& UYU

Ia. psaamILAWT0C0116Sigh S.ad hmpo. .5

13S £WVa*C of ind~~ A&mR - 113 TIME' dmIA 4 AS fAVR y..Mo. ampesf i, ~aa CVT.

Ina ThCAis& docuen t D the pduty specificatioetblis n th esgimlmnato fth comute ofigrtiontiem bereft arie Umveiiailgeeaeeoeinoafercs progamI sho an lci ommunicaed orithlpe

SCNote t generatd code andut coponet.ftedsriue eus

13019 £5 000 A g ~ ~ Ucafe

imlmntto ofR th7e IIS APRiuato Itemah PdE10 wh M05S Iaich wilaa~aa*laS

geeaecd noaue' rgrmwihcncmuiaewtothe geeae-oeadcmoetso h itiue eus

11. Title

Integrated Information Support System (IISS)Vol V - Common Data Model Subsys temnPart 22 - NDML Frecompiler Build Calls and Messages

Product Specification

A SD 86 145617 Jul 1986

Accesion For

NTIS CRA&IDTIC TAB 13Unannounced E3Justificatioia

Distibutioii I

4viaiit oe

Avail~ ardoDist~ bpeAa

PS 6201412581 November 1985

PREFACE

This product specification covers the york performed underAir Force Contract F33615-80-C-5155 (ICAN Project 6201). Thiscontract is sponsored by the Materials Laboratory, Air ForceSystems Command, Wright-Patterson Air Force Base, Ohio. It wasadministered under the technioal direction of Mr. Gerald C.Shunaker, ICAM Program Manager. Manufacturing TechnologyDivision, through Project Manager, Mr. David Judson. The PrimeContractor was Production Resources Consulting of the GeneralElectric Company, Schenectady, New York, under the direction ofMr. Alan Rubenstein. The General Electric Project Manager wasMr. Myron Hurlbut of Industrial Automation Systems Department,Albany, New York.

Certain work aimed at improving Test Bed Technolpgy hasbeen performed by other contracts with Project 6201oerforming

integrating functions. This work consisted of enhantements toTest Bed software and establishment and operation of Test Bedhardware and communications for developers and other users.Documentation relating to the Test Bed from all of thesecontractors and projects have been integrated under Project 6201for publication and treatment as an integrated set of documents.The particular contributors to each document are noted on theReport Documentation Page (DD1473). A listing and descriptionof the entire project documentation system and how they arerelated is contained in document FTR620100001, Project Overview.

The subcontractors and their contributing activities wereas follows:

TASK 4.2

Subcontractors Role

Boeing Military Aircraft Reviewer.Company (BEAC)

D. Appleton Company Responsible for IDEF support,(DACOM) state-of-the-art literature

search.

General Dynamics/ Responsible for factory viewFt. Worth function and information

models.

Aliii

PS 6201412581 November 1985

Subcontractors Role

Illinois Institute of Responsible for factory viewTechnology function research (IITRI)

and information models ofsmall and medium-size business.

North American Rockwell Reviewer.

Northrop Corporation Responsible for factory viewfunction and informationmodels.

Pritskqr ).nd Associates Responsible for IDEF2 support.

SofTech Responsible for IDEFO support.

TASKS 4.3 - 4.9 (TEST BED)

Subcontractors Role

Boeing Military Aircraft Responsible for consultation onCompany (BSAC) applications of the technology

and on IBM computer technology.

Computer Technology Assisted in the areas ofAssociates (CTA) communications systems, system

design and integrationmethodology, and design of theNetwork Transaction Manager.

Control Data Corporation Responsible for the Common Data(CDC) Model (CDM) implementation and

part of the CDM design (sharedwith DACOM).

D. Appleton Company Responsible for the overall CDM(DACOM) Subsystem design integration

and test plan, as well as partof the design of the CGD(shared with CDC). DACOM alsodeveloped the IntegrationMethodology and did the schemamappings for the ApplicationSubsystems.

,I V

PS 6201412581 November 1985

Subcontractors Role

Digital Equipment Consulting and support of theCorporation (DEC) performance testing and on DEC

software and computer systemsoperation.

McDonnell Douglas Responsible for the support andAutomation Company enhancements to the Network(McAuto) Transaction Manager Subsystem

during 1984/1985 period.

On-Line Software Responsible for programming theInternational (OSI) Communications Subsystem on the

IBM and for consulting on theIBM.

Rath and Strong Systems Responsible for assistance inProducts (RSSP) (In 1985 the implementation and use ofbecame McCormack it Dodge) the MRP II package (PIOS) that

they supplied.

SofTech. Inc. Responsible for the design andimplementation of the NetworkTransaction Manager (NTM) in1981/1984 period.

Software Performance Responsible for directing theEngineering (SPE) work on performance evaluation

and analysis.

Structural Dynamics Responsible for the UserResearch Corporation Interface and Virtual Terminal(SDRC) Interface Subsystems.

Other prime contractors under other projects who havecontributed to Test Bed Technology. their contributingactivities and responsible projects are as follows:

Contractors ICAM Project Contributing Activities

Boeing Military 1701, 2201, Enhancements for IBMAircraft Company 2202 node use. Technology(BMAC) Transfer to Integrated

Sheet Metal Center(ISMC).

v

I

PS 6201412581 November 1985

Contractors ICAN Project Contributing Activities

Control Data 1502, 1701 IISS enhancements toCorporation (CDC) Common Data Model

Processor (CDMP).

D. Appleton Company 1502 IISS enhancements to(DACOM) Integration Methodology.

General Electric 1502 Operation of the TestBed and communicationsequipment.

Hughes Aircraft 1701 Test Bed enhancements.Company (HAC)

Structural Dynamics 1502, 1701, IISS enhancements toResearch Corporation 1703 User Interface/Virtual(SDRC) Terminal Interface

(UI/VTI).

Systran 1502 Test Bed enhancements.Operation of Test Bed.

vi

.. . ...... _ _ ,,.. __A - . ..k Nt a I

PS 620141258

1 November 1985

TABLE OF CONTENTS

Panye

SECTION 1.0 SCOPE .................................. 1-11.1 Identification ....................... 1-11.2 Functional Summary .................. 1-1

SECTION 2.0 DOCUMENTS .............................. 2-12.1 Reference Documents .................. 2-12.2 Terms and Abbreviations ............. 2-1

SECTION 3.0 REQUIREMENTS .......................... 3-13.1 Structural Description..............3-13.2 Functional Flow ..................... 3-13.3 Interfaces ........................... 3-23.3.1 Inputs/Outputs .................... 3-33.4 Program Interrupts .................. 3-33.5 Timing and Sequencing Description ... 3-33.6 Special Control Features ............ 3-43.7 Storage Allocation .................. 3-43.7.1 Database Definition ............... 3-43.7.1.1 File Description ................ 3-43.7.1.2 Table Description ............... 3-43.7.1.3 Item Description ................ 3-43.8 Object Code Creation ................ 3-43.9 Adaptation Data ..................... 3-43.10 Detail Design Description ........... 3-53.10.1 Main Program List ................. 3-53.10.2 Module List ........................ 3-73.10.3 External Routines List ............ 3-93.10.4 Include File List ................. 3-113.10.5 Where Include File Used List ...... 3-133.10.6 Where External Routine Used List .. 3-213.10.7 Main Program Parts List ........... 3-253.10.8 Module Documentation .............. 3-273.10.9 Include File Description .......... 3-493.10.10 Hierarchy Chart ................... 3-693.11 Program Listings Comments ........... 3-79

SECTION 4.0 QUALITY ASSURANCE PROVISIONS .......... 4-14.1 Introduction and Definitions ........ 4-14.2 Computer Programming and Test

Evaluation .......................... 4-1

vii

I

PS 6201412581 November 1985

SECTION 1

SCOPE

1.1 Identification

This specification establishes the design of FunctionPRE1O,9Build Calls Messages into the Users AP , one of themajor functions of the Configuration Item 'Precompiler-pto bebuilt and formally accepted by the ICAM Program Office. This CIconstitutes one of the subsystems of the Common Data ModelProcessor (CDMP).

1.2 Fun Sumar

The purpose of this Computer Program Configuration Item(CPCI) is to generate into the User Application process code toassemble tables and parameters needed by both the DistributedRequest Supervisor and conceptual to external transfor er tosatisfy an NDML request. ;.-, ) -

The following functio" will be performedby the CPCI: lP?.rA-§ 7 ,,

1. Generate working storage for external schema variablesto hold the ES results in the user specified structureor variables, and temporary conceptual schema variablesnecessary for the transformation.

2. Generate working storage variables to hold theprecompile tables namely the Join Query Graph,Attribute Pair List, results table and conceptualschema Action List to satisfy the NDML request.

3. Generate Working Storage and Procedure Divisionstatements for domain and assertion checks.

4. Generate Procedure Division statements to call the DRS,return with the results and call the conceptual toexternal transformer and move the ES results into theuser variables or structure.

A-1

PS 6201412581 November 1985

SECTION 2

DOCUMENTS

2.1 Reference Documents

1. ICAM Documentation Standards: IDS5I012000A. 28 December1981.

2. D. Appleton Co., CDM Administrators Manual:UM620141000, March, 1984.

3. D. Appleton Co., CDM1-IDEF, Model of the Common DataModel: CCS620141000, 15 May, 1985.

4. D. Appleton Co., Computer Program DevelopmentSpecification (DS) for ICAM Intelrated Support System(IISS) Configuration Item: NDML Precompiler:DS620141200, October, 1984

5. D. Appleton Co., Embedded NDML Programmers ReferenceManual: PRM620141200, March, 1985

6. Softech, Inc., NTM Programmers Guide: UM620140001,July 1984.

7. Control Data Corp., Computer Program DevelopmentSpecification (DS) for ICAM Integrated Support SystemCIISS) Configuration Item: NDDL Command Processor:DS620141100, June 1985.

2.2 Terms and Abbreviations

Attribute Use Class: (AUC)

Conceptual Schema: (CS)

Common Data Model Processor: (CDMP)

Common Data Model: (CDM) Describes common data applicationprocess formats, form definitions, etc. of the IISS and includesconceptual schema, external, internal schemas, and schematransformation operators.

Data Field: (DF) An element of data in the externalschema. It is by this name that an NDXL programmer references

2-1

PS 6201412581 November 1985

data.

Database Management System: (DBMS)

Distributed Request Supervisor: (DRS) This IISS CDMsubsystem configuration item controls the execution ofdistributed NDML queries and non distributed updates.

Domain: A logical definition of legal attribute classvalues.

Domain Constraint: Predicate that applies to a single

domain.

External Schema: (ES)

Forms: Structured views which may be imposed on windows orother forms. A form is composed of fields where each field is aform, item, or window.

Forms Processor: (FP) A set of callable execution timeroutines available to an application program for formprocessing.

Internal Schema: (IS)

Integrai.ed Information Support System: (IISS) A testcomputing environment used to investigate, demonstrate and testthe concepts of information management and informationintegration in the context of Aerospace Manufacturing. The IISSaddresses the problems of integration of data resident onheterogeneous databases supported by heterogeneous computersinterconnected via a local Area Network.

Napping: The correspondence of independent objects in twoschemas: ES to CS or CS to IS.

Network Transaction Manager: (NT) Performs thecoordination, communication and housekeeping functions requiredto integrate the application processes and system servicesresident on the various hosts into a cohesive system.

Neutral Data Manipulation Language: (NDML) A languagedeveloped by the IISS project to provide uniform access tocommon data, regardless of database manager or distributioncriteria. It provides distributed retrieved and single nodeupdates.

2-2

PS 6201412581 November 1985

ORACLE: Relational DBMS based on the SQL (Structured QueryLanguage, a product of ORACLE Corp. Menlo Park, CA). The CDM isan ORACLE database.

Parcel: A sequential file containing sections of sourcecode of the input Application Program.

Request Processor: (RP) A COBOL program that will satisfya retrieval or update NDML subtransaction against a particularDatabase Management System.

User Interface: (UI) Controls the user's terminal andinterfaces with the rest of the system.

Virtual Terminal Interface: (VTI) Performs the interfacingbetween different terminals and the UI. This is done bydefining a specific set of terminal features and protocols whichmust be supported by UI software which constitutes the VirtualTerminal Definition. Specific terminals are then mapped againstthe Virtual Terminal software by specific software moduleswritten for each type of real terminal supported.

2-3

iA

PS 6201412581 November 1985

SECTION 3

REQUIREMENTS

3.1 Structural Description

The graphic portrayal of this CPCI is included in Section3.10. This chart shows the hierarchical relationship of eachmodule making up this CPCI.

This CPCI uses a number of lower level modules to handlespecific operations such as:

1. Generate working storage for data definitions forDelete, Modify and Qualify data values (CDECWS).

2. Generate working storage for data definitions forinsert values (CDPIOE).

3. Generate working storage variables to hold ES results(CDPIOF).

4. Generate the precompile tables needed by theDistributed Request. Supervisor (DRS) into the UsersAP, and Procedure division statements to move theresults (CDPlOB).

5. Generate the Working Storage and Procedure Divisionstatements to perform domain and assertion verification(CDCONS).

6. Generate Procedure Division statements for transformingthe external to conceptual and, if necessary, generateworking storage if an algorithm was required to do thetransformation (CDEC).

7. Control the processing logic to call routines totransform Working Storage and Procedure Divisionstatements from conceptual to external (CDPIOA).

8. Generate the final ES Results into user specified

structure, variables or a file.

3.2 Functional Flow

This CPCI implemented the logic defined in the Development

3-1

PS 6201412581 November 1985

Specification for this CPCI. Details of inputs/outputs andrelationships between modules are found in Section 3.10.

This CPCI has been designated to operate in a batch orinteractive mode. It must operate in the system environmentestablished for IISS; that is, the Network Transaction Manager.It currently can only be executed on the DEC VAX due to thedependence on the VAX sort although this can be changed forexecution on the IBM.

3.3 Interfaces

The following diagram depicts the interface of this CPCI,PREl0 with other CPCI's in the system.

------------I CDP13 II P41210 I

--------------

-----------------I PRE10 II I

+------------

3-2

PS 6201412581 November 1985

3.3.1 Inputs/Outputs

The following table depicts the inputs and outputs of thisCPCI. A detailed description for each item can be found in theDS for this CPCI.

FUNCTION: PRE10

INPUT OUTPUT

External Schema Action List Nodule StatusExternal Schema Qualify ListConceptual Schema Action ListConceptual Schema Qualify ListInternal Schema Action ListInternal Schema Qualify ListJoin Query GraphJQG Attribute Pair ListResults Field TableSubtrans Process ID tableCode Generator TableORACLE Log on Data AreaIDFile NameFDFile NameWorking Storage File NameProcedure Division File NameError FileCS-ES Nod NameUser View Abbreviation ListID Section Indicator

3.4 Program Interrupts

Not applicable to the CPCI.

3.5 Timing and Sequencing Description

This CPCI I called for each NDEL statement to generatecalls to the Distributed Request Supervisor and/or Conceptual toExternal transformer. so the results may be returned in themanner the user specified.

3-3

PS 6201412581 November 1985

3.6 Special Control Features

Not applicable to this CPCI.

3.7 Storage Allocation

3.7.1 Database Definition

The database used by this CPCI is the Common Data Model(CDM) database. The model is defined by the CDM1, the IDEF-1model of the CDM, Reference Document Number 3.

3.7.1.1 File Description

No permanent files have been defined for this CPCI. It mayuse temporary scratch files for such things a input and results.

3.7.1.2 Table Description

All tables used by this CPCI have been defined by theDevelopment Specification for this CPCI.

3.7.1.3 Item Description

Not applicable to this CPCI.

3.8 Object Code Creation

The object code for this CPCI will be created by the systemintegration team using defined IISS Software ConfigurationManagement Procedures. This CPCI will use the COBOL languagecompiler.

3.9 Adaptation Data

This CPCI has been using ANSI COBOL language. The intentwas to provide a transportable system. Any system environmentsupporting these languages, a virtual memory management schema,the COMM and NTH subsystems of IISS and the ORACLE DatabaseManagement System should be able to support this CPCI. Every

possible attempt has been made to localize and identify anymachine or environment dependent modules through the originaldesign of the IISS and application of Configuration ManagementProcedures.

3-4

PS 6201412581 November 1985

3.10 Detail Design Description

The following sections have been computer generated for

this CPCI.

3.10.1 Main Prosram List

The following is a list of all "Main Programs" whichare modules that are not called by any other module beingdocumented here. These modules are either program entry pointsor, if they are hooked into another set of programs viasubroutine calls, they are the points the external programs cancall and therefore enter through. To differentiate between thetwo types of entry points, look at the individual ModuleDocumentation (section 3.10.8) and look at Module Type for eachof the Main Program modules listed. Note whether the routineis a Program, Subroutine, or Function. If it is a Program, itis truly a main program entry point. If not, then it is merelycalled by other programs not being documented here.

3-5

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Main Program List

Module Name Purpose

CDPIO BUILD CALLS AND MESSAGES INTO THE USERS- APPLICATION PROCESS

3-6

-- AI

PS 6201412581 November 1985

3.10.2 Module List

The following is a list of all the modules beingdocumented here along with their purpose. Each module has aunique name, no matter what language It was written In.

3-7?

LI

PS 620141258

1 November 1965

BUILD CALLS AND MESSAGES Module List

Nodule Name Purpose

CD NS DOMAIN AND ASSERTION VERIFICATION MODULE

CDEC GENERATES VS AND PROC DIV FOR DF FOR ES TOCS

CDECVS ES/CS DATA DEF FOR RT INSERT/MODIFY/QUALDATA VALUES

CDPI0 BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS

CD'IOA GENERATE THE TRANSFORMATION OF ES VALUESAND VARIABLES

CDPIOB GENERATED THE PRECOMPILE TABLES INTO THEUSERS AP

CDPIOC GENERATE ES RESULTS INTO USER VARIABLES ORSTRUCTURE

CDPIOE GENERATE ES/CS DATA DEFINITIONS FOR INSERTVALUES

CDPIOF GENERATE WORKING STORAGE VARIABLES TO HOLDES RESULTS

CDUEMV GENERATE EXTERNAL/CONCEPTUAL SCHEMA MOVESTATEMENTS

3-8

PS 6201412581 November 1985

3.10.3 External Routines List

The following is a list of all routines or functions notdocumented here that are called by modules that are documentedhere. The first caller, in alphabetical order, is listed aswell. The specification in which any module is documented maybe found in the Module Documentation Index (Document NumberCM 620100001). See section 3.10.6 for a list of the modulesthat call each of these external routines.

3-9

PS 6201412581 November 1985

B3UILD CALLS AND MESSAGES External Routines List

Module Name First User

CDNACR CDP1OACDPIC CDPIOFERIPRO CDPI OBOBINDN CDGONSOCWBSE CDECODF INN CDOONSOEXEC CDOONSOFETGR CDOONSQOPEN CDCONSOSQL3 CDECRPTERR CDCONS

3-10

PS 6201412581 November 1985

3.10.4 Include File List

The following is a list of all include files called inby modules being documented here. Each include file has aunique name regardless of the language being used. The purposeof each include file is listed as well. A more completedescription of each include file is given in section 3.10.9.The purpose listed is the one that is in the source code of theinclude file.

A purpose of "**** PURPOSE NOT FOUND BY STRIPPER "indicates that a purpose statement was not written into theinclude file itself. The most common reason for this is thatthe include file comes from system libraries that were notdeveloped by the project, such as 'C' libraries that areprovided with the 'C' compiler.

See section 3.10.6 for a set of lists which show allthe modules which call in each of these include files.

3-11

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Include File List

File Name Purpose

APL JOIN QUERY ATTRIBUTE PAIR LISTCGTABLE CODE GENERATING TABLE- TRACKS ALL GENERATED

SOFTWARECHKCDM IISS CDMP CHECK STATUS CODESCSAL CONCEPTUAL SCHEMA ACTION LISTCSQUAL CONCEPTUAL SCHEMA QUALIFY LISTERRCDM IISS ERROR STATUS CODES FOR CDMP MODULESERRPRO PROCESS ERROR INCLUDE FILEESAL EXTERNAL SCHEMA ACTION LISTESQUAL EXTERNAL SCHEMA QUALIFY LISTISAL INTERNAL SCHEMA ACTION LISTISQUAL INTERNAL SCHEMA QUALIFY LISTJQGTBL JOIN QUERY GRAPH TELLS HOW TO CONNECT

SUBTRANSACTIONSLANGNO SOURCE LANGUAGE VARIABLEMACCALL CALL THE MACRO COPY UTILITYORCLEDA WS DEFINITION FOR THE ORACLE LOGIN AREARFTABLE THE RESULT FIELD TABLESBSTLST WS DEFINITION FOR THE SUBSTITUTION LIST TABLESUBPROC SUBTRANSACTION PROCESSES ID TABLEUVABBR USER VIEW ABBREVIATION LIST

3-12

PS 6201412581 November 1985

3.10.5 Where Include File Used List

The following lists each include file from 3.10.4 andall the modules documented in this specification which includethem. The purpose of each module is listed as well.

3-13

I

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Where-include-file-used List

Include Nodule ModuleFile Name Purpose

APLCDPIO BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESSCDPIOB GENERATED THE PRECOMPILE TABLES INTO THE

USERS AP

CGTABLECDPIO BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESSCDP1OA GENERATE THE TRANSFORMATION OF ES VALUES

AND VARIABLES

CHKCDMCDP1O BUILD CALLS AND MESSAGES INTO THE USERS


USERS AP

CSALCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDECWS ES/CS DATA DEF FOR RT INSERT/MODIFY/QUAL

DATA VALUESCDP1O BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESSCDPIOA GENERATE THE TRANSFORMATION OF ES VALUES

AND VARIABLESCDPIOB GENERATED THE PRECOMPILE TABLES INTO THE

USERS APCDPIOF GENERATE WORKING STORAGE VARIABLES TO HOLD

ES RESULTS

3-14

PS 6201412581 November 1985


Include Module ModuleFile Name Purpose


CSQUALCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDECWS ES/CS DATA DEF FOR RT INSERT/MODIFY/QUAL

DATA VALUESCDP10 BUILD CALLS AND MESSAGES INTO THE USERS


AND VARIABLESCDUEMV GENERATE EXTERNAL/CONCEPTUAL SCHEMA MOVE

STATEMENTS

ERRCDMCDOONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CSCDECWS ES/CS DATA DEF FOR RT INSERT/MODIFY/QUAL

DATA VALUESCDPIO BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESSCDP1OA GENERATE THE TRANSFORMATION OF ES VALUES


USERS APCDPIOC GENERATE ES RESULTS INTO USER VARIABLES OR

STRUCTURECDPIOE GENERATE ES/CS DATA DEFINITIONS FOR INSERT

VALUESCDPIOF GENERATE WORKING STORAGE VARIABLES TO HOLD

ES RESULTSCDUEMV GENERATE EXTERNAL/CONCEPTUAL SCHEMA MOVE

STATEMENTS

3-15

A -

PS 6201412581 November 1985


Include Module NoduleFile Name Purpose

ERRPROCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO









STATEMENTS

ESALCDECWS ES/CS DATA DEF FOR RT INSERT/MODIFY/QUAL

DATA VALUESCDPIO BUILD CALLS AND MESSAGES.INTO THE USERS


AND VARIABLESCDPIOC GENERATE ES RESULTS INTO USER VARIABLES OR


VALUES

3-16

I

7 -

-- ---

PS 620141258_g 1 November 1985

BUILD CALLS AND MES7AGES Where-include-file-used List

Include Module NoduleFile Name Purpose

CDPIOF GENERATE WORKING STORAGE VARIABLES TO HOLDES RESULTS


ESQUALCDECWS ES/CS DATA DEF FOR RT INSERT/MODIFY/QUAL



AND VARIABLESCDUEMV GENERATE EXTERNAL/CONCEPTUAL SCHEMA MOVE

STATEMENTS

ISAL CDPIO BUILD CALLS AND MESSAGES INTO THE USERS


AND VARIABLES

ISQUALCDPIO BUILD CALLS AND MESSAGES INTO THE USERS


AND VARIABLES

JQGTBL

3-17

PS 6201412581 November 1985



CDPIO BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS

CDP1OB GENERATED THE PRECOMPILE TABLES INTO THEUSERS AP

LANGNOCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO





USERS APCDP1OC GENERATE ES RESULTS INTO USER VARIABLES OR




STATEMENTS

MACCALLCDPIO BUILD CALLS AND MESSAGES INTO THE USERS


USERS AP

3-18

PS 5201412581 November 1985


Include Nodule ModuleFile Name Purpose

ORCLEDACDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CSCDPIO BUILD CALLS AND MESSAGES INTO THE USERS



USERS AP

RFTABLECDPIO BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESSCDPIOB GENERATED THE PREOOMPILE TABLES INTO THE

USERS AP

SBSTLSTCDPI0 BUILD CALLS AND MESSAGES INTO THE USERS



USERS AP

SUBPROC

3-19

\4' t 1

PS 6201412581 November 1985



CDPIO BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS

CDPIOA GENERATE THE TRANSFORMATION OF ES VALUESAND VARIABLES

UVABBRCDPIO BUILD CALLS AND MESSAGES INTO THE USERS


AND VARIABLES

3-20

PS 6201412581 November 1985

3.10.6 Vhere External Routine Used List

The folloving lists each external function or routinelisted in 3.10.3 and all the documented modules which call it.The purpose of each module is listed as well.

3-21

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Where-external-routine-used List

System Nodule ModuleModule Name Purpose

CDMACRCDPIO BUILD CALLS AND MESSAGES INTO THE USERS



USERS AP

CDPICCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO


DATA VALUESCDPIOE GENERATE ES/CS DATA DEFINITIONS FOR INSERT


ES RESULTS

ERRPROCDONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CSCDECVS ES/CS DATA DEF FOR RT INSERT/NODIFY/QUAL






VALUES

3-22

-A&A

PS 6201412581 November 1985


System Module ModuleModule Name Purpose

CDP1OF GENERATE WORKING STORAGE VARIABLES TO HOLDES RESULTS


OBINDYCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CS

OCLOSECDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES VS AND PROC DIV FOR DF FOR ES TO

CS

ODFINNCDCONS DOMAIN AND ASSERTION VERIFICATION NODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CS

OEXECCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CS

OFETCHGDOONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CS

3-23

- I l II a

PS 6201412581 November 1985


System Module ModuleModule Name Purpose

OOPENCDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CS

OSQL3CDCONS DOMAIN AND ASSERTION VERIFICATION MODULECDEC GENERATES WS AND PROC DIV FOR DF FOR ES TO

CS

RPTERRCDOONS DOMAIN AND ASSERTION VERIFICATION MODULE

3-24

--

PS 6201412581 November 1985

3.10.7 Main Program Parts List

The following lists each Main Program listed in 3.10.1and all the modules which are called either by that moduleitself or by any of the documented modules which it calls. Itis possible for a non-main module to be listed more that onceif it is called by multiple modules. The called modules, inthis case known as program parts, are marked as to whetherthey are documented here. If so, the phrase "well-definedmodule" appears by the module name, if not it is an "external"routine". The Purpose of the Main Program module is listedas well.

3-25

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Main Program Parts List

Main Pg. Module ModuleName Name Type

CDPIO Purpose--,BUILD CALLS AND MESSAGES INTOTHE USERS APPLICATION PROCESS

CDCONS Well-defined moduleCDEC Well-defined moduleCDECWS Well-defined moduleCDMACR External routineCDPIOA Well-defined moduleCDPIOB Well-defined moduleCDP1OC Well-defined moduleCDPIOE Well-defined moduleCDPIOF Well-defined moduleCDPIC External routineCDUEMV Well-defined moduleERRPRO External routineOBINDN External routineOCLOSE External routineODFINN External routineOEXEC External routineOFETCH External routineOOPEN External routineOSQL3 External routineRPTERR External routine

3-26

PS 6201412581 November 1985

3.10.8 Nodule Documentation

The following documentation describes informationwhich is specific to each individual module being documentedin this specification as listed in section 3.10.2. Itprovides a compact way of getting information that would beotherwise buried within each module's source code.

The specific items in this module documentation have thefollowing meanings:

NAME: Name of program Nodule.

PURPOSE: Purpose of Module as detailed in thesource code.

LANGUAGE: Programming language source code iswritten in.The choices are:

VAX-I FORTRAN

C (I/S-I Workbench 'C')VAX-l1 COBOL

NODULE TYPE: Whether a Program, Subroutine, orFunction.

SOURCE FILE: Name of Source File from filespecification.

SOURCE FILE TYPE: Source File Extension from filespecification.

HOST: Whether this is a host-dependentroutine (VAX or IBM) or blank ifhost-independent.

SUBSYSTEM- IISS sub-system this file resides in.

SUBDIRECTORY: Sub-directory of that subsystem inwhich this file resides.

DOCUNUTATION GROUP: Name of documentation group of whichthis source file is a member.

DESCRIPTION: A description of the module as otained

3-27

PS 6201412581 November 1985

from the source code.

ARGUMENTS: The arguments with which this routineis called if it is a Subroutine or aFunction.

INCLUDE FILES: A list of all the files that areincluded into this module as well astheir purposes.

ROUTINES CALLED: Subroutines or Functions, eitherdocumented or external, called bythis module, if any.

CALLED DIRECTLY BY: The documented routines which callthis module, if any.

USED IN MAIN PROGRAM(S): The documented Main Programs whichcontain this module in their partslist according to the list in section3.10.7.

The Module Documentation is arranged alphabetically accordingto Module Name.

3-28

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Module Documentation

NAME: CDCONSPURPOSE: DOMAIN AND ASSERTIIN VERIFICATION MODULELANGUAGE: VAX-11 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDCONSSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

ARGUMENTS:

LANG-NO - RECRDORACLE-LDA - RECRDCS-ACTION-LIST - RECRDCS-QUALIFY-LIST - RECRDWORK-FILE-NAME - DSPLY IX(30)]PROC-FILE-NAME - DSPLY EX(30)]NEXT-PARAMETER-NO - DSPLY [999]ES-NDML-NO - DSPLY [999]ERROR-FILE - DSPLY [X(30)]RET-STATUS - DSPLY [X(5)]

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESLANGNO - SOURCE LANGUAGE VARIABLEORCLEDA - WS DEFINITION FOR THE ORACLE LOGIN AREACSAL - CONCEPTUAL SCHEMA ACTION LISTCSQUAL - CONCEPTUAL SCHEMA QUALIFY LISTERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

RPTERR

3-29

PS 6201412581 November 1985

CDPICOOPENOSQL3ODFINNOBINDNOEXECOFETCHOCLOSEERRPRO

CALLED DIRECTLY BY:

CDPIO - BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS

USED IN MAIN PROGRAM(S):

CDP1O - BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS

3-30

ALI

PS 6201412581 November 1985


NAME: CDECPURPOSE: GENERATES WS AND PROC DIV FOR DF FOR ES

TO CSLANGUAGE: VAX-I1 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDECSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

- THIS ROUTINE WILL GENERATE WORKING STORAGE

CODE WILL BE GENERATED INTO THE WORKING STORAGE

ARGUMENTS:

LANG-NO - RECRDWORK-FILE-NAME - DSPLY [X(30)]PROC-FILE-NAME - DSPLY [X(30)]ORACLE-LDA - RECRDNEXT-PARAMETER-NO - DSPLY (9(3)]CLIST-INDEX - DSPLY [99]ELIST-INDEX - DSPLY [99]ACTION-TYPE - DSPLY [X]ES-ACTION-TYPE - DSPLY EX]ES-NDML-NO - DSPLY [999]CS-NDML-NO - DSPLY [999]SEC-ID - DSPLY [X(30)]DI-ID - DSPLY [X(30)]VAR-OR-FILE-IND - DSPLY [IXRET-STATUS - DSPLY IX(5)]

INCLUDE FILES:

ERRCDK - IISS ERROR STATUS CODES FOR CDMP MODULESLANGNO - SOURCE LANGUAGE VARIABLEORCLEDA - WS DEFINITION FOR THE ORACLE LOGIN AREAERRPRO - PROCESS ERROR INCLUDE FILE

3-31

PS 6201412581 November 1985

ROUTINES CALLED:

OOPENOSQL3ODF INNOBINDNOEXECOFETCHCDPICOCLOSEERRPRO

CALLED DIRECTLY BY:

CDP1OA - GENERATE THE TRANSFORMATION OF ES VALUES ANDVARIABLES


CDPIO -BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS

3- 324

PS 6201412581 November 1985


NAME: CDECWSPURPOSE: ES/CS DATA DEF FOR RT INSERT/MODIFY/QUAL

DATA VALUESLANGUAGE: VAX-li COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDECWSSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

EXTERNAL/CONCEPTUAL SCHEMA DATA DEFINITIONSFOR RUNTIME INSERT, MODIFY AND QUALIFY DATA VALUES

CODE WILL BE GENERATED INTO THE WORKING STORAGESECTION OF THE MODIFIED AP, DEPENDING ON THECS-ACTIONTHE FOLLOWING CODE WILL BE GENERATED01 CS-VAR-NDMLNO-NN PIC TYPE(SIZEM(V9(ND)J.

01 CSQ-VAR-NDMLNO-NN PIC TYPECSIZE)(V9(ND)].01 ES-VAR-NDMLNO-NN PIC TYPE(SIZE)CVg(ND)].01 ESQ-VAR-NDMLNO-NN PIC TYPE(SIZE)[V9(ND)].WHERE NN IS EITHER THE CS-ES-FTR OR CSQ-ES-PTROR CS-INDEX OR CSQ-INDEX.

ARGUMENTS:

LANG-NO - REORDWORK-FILE-NAME - DSPLY [1(30)]CS-ACTION-LIST m RECRDCS-QUALIFY-LIST - RECRDES-ACTION-LIST - RECRDES-QUALIFY-LIST - REORDRET-STATUS -DSPLY [(()]

3-33

PS 6201412581 November 1985

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESLANGNO - SOURCE LANGUAGE VARIABLECSAL - CONCEPTUAL SCHEMA ACTION LISTCSQUAL - CONCEPTUAL SCHEMA QUALIFY LISTESAL - EXTERNAL SCHEMA ACTION LISTESQUAL - EXTERNAL SCHEMA QUALIFY LISTERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

CDP ICERRPRO

CALLED DIRECTLY BY:

CDPIOA - GENERATE THE TRANSFORMATION OF ES VALUES ANDVARIABLES



3-34

. .. l.

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Module Document&tion

NAME: CDP1OPURPOSE: BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESSLANGUAGE: VAX-il COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDPIOSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

GENERATES CODE INTO THE USERS APPLICATION PROGRAM REQUIREDTO PROCESS THE NDML REQUEST AT RUNTIME. THIS INCLUDES CODETO ASSEMBLE TABLES AND PARAMETERS NEEDED BY THE DISTRIBUTEDREQUEST SUPERVISOR TO SATISFY AN NDML REQUEST AND CODE TORECEIVE THE RESULTS FROM THE REQUEST.

ARGUMENTS:

ES-ACTION-LIST - RECRDES-QUALIFY-LIST - RECRDCS-ACTION-LIST - RECRDCS-QUALIFY-LIST - REGRDIS-ACTION-LIST - REORDIS-QUALIFY-LIST - RECRDJQG - RECRDJQG-ATTRIBUTE-PAIR-LI ST - RECRDRFT w RECRDSUBTRAS-PROCESS-ID-TABLE - RECRDCODE-GENERATOR-TABLE - RECRDORACL,-LDA - RECRDIDFILZ- A E DSPLY [x(30)]FDFILE-SAME - DSPLY [X(30)]WORKFILE-NAME - DSPLY [X(50)]PROCFXILE-.A, - DSPLY (X(30)]ERROR-FILE - DSPLY (X(30)]

3-35 I

PS 6201412581 November 1985

CS-ES-HOD-NAME - DSPLY [X(iO)]SOURCE-LANGUAGE - DSPLY [X(10)]UV-ABBR-LIST - RECRDIOSECTION-INDICATOR w DSPLY [9]RETURN-STATUS - DSPLY IX(5)]

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESCHKCDM - IISS CDMP CHECK STATUS CODESSBSTLST - WS DEFINITION FOR THE SUBSTITUTION LIST TABLELANGNO - SOURCE LANGUAGE VARIABLEESAL - EXTERNAL SCHEMA ACTION LISTESQUAL - EXTERNAL SCHEMA QUALIFY LISTCSAL - CONCEPTUAL SCHEMA ACTION LISTCSQUAL - CONCEPTUAL SCHEMA QUALIFY LISTISAL - INTERNAL SCHEMA ACTION LISTISQUAL - INTERNAL SCHEMA QUALIFY LISTJQGTBL - JOIN QUERY GRAPH TELLS HOW TO CONNECT

SUBTRANSACTIONSAPL - JOIN QUERY ATTRIBUTE PAIR LISTRFTABLE - THE RESULT FIELD TABLESUBPROC - SUBTRANSACTION PROCESSES ID TABLECGTABLE - CODE GENERATING TABLE- TRACKS ALL GENERATED

SOFTWAREUVABBR - USER VIEW ABBREVIATION LISTORCLEDA - WS DEFINITION FOR THE ORACLE LOGIN AREAMACCALL - CALL THE MACRO COPY UTILITYERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

CDPIOC - GENERATE ES RESULTS INTO USER VARIABLES ORSTRUCTURE

CDPIOA - GENERATE THE TRANSFORMATION OF ES VALUES ANDVARIABLES

CDPIOB - GENERATED THE PRECOMPILE TABLES INTO THE USERSAP

CDPIOE - GENERATE ES/CS DATA DEFINITIONS FOR INSERTVALUES

CDPIOF - GENERATE WORKING STORAGE VARIABLES TO HOLD ESRESULTS

CDOONS - DOMAIN AND ASSERTION VERIFICATION MODULECDKACRERRPRO

3-36

-A-

PS 6201412581 November 1985


NAME: CDP 1OAPURPOSE: GENERATE THE TRANSFORMATION OF ES VALUES

AND VARIABLESLANGUAGE: VAX-i1 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDPIOASOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

ARGUMENTS:

LANG-NO - RECRDFD-FILE-NAME - DSPLY [X(30)]WORK-FILE-NAME - DSPLY [X(30)]PROC-FILE-NAME - DSPLY [X(q3)]CS-ACTION-LIST - RECRDCS-QUALIFY-LIST - RECRDES-ACTION-LIST - RECRDES-QUALIFY-LIST - RECRDIS-ACTION-LIST - RECRDIS-QUALIFY-LIST - RECRDUV-ABBR-LIST - RECRDCODE-GENERATOR-TABLE - RECRDSUBTRANS-PROCESS-ID-TABLE - RECRDORACLE-LDA - RECRDNEXT-PARAMETER-NO - DSPLY [999]ERROR-FILE - DSPLY [X(30)]RET-STATUS - DSPLY EX(5)]

INCLUDE FILES:

3-37

PS 6201412581 November 1985

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESSBSTLST - WS DEFINITION FOR THE SUBSTITUTION LIST TABLELANGNO - SOURCE LANGUAGE VARIABLEORCLEDA - WS DEFINITION FOR THE ORACLE LOGIN AREAESAL - EXTERNAL SCHEMA ACTION LISTESQUAL - EXTERNAL SCHEMA QUALIFY LISTISAL - INTERNAL SCHEMA ACTION LISTISQUAL - INTERNAL SCHEMA QUALIFY LISTCSAL - CONCEPTUAL SCHEMA ACTION LISTCSQUAL - CONCEPTUAL SCHEMA QUALIFY LISTCGTABLE - CODE GENERATING TABLE- TRACKS ALL GENERATED

SOFTWARESUBPROC - SUBTRANSACTION PROCESSES ID TABLEUVABBR - USER VIEW ABBREVIATION LISTERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

CDECWS - ES/CS DATA DEF FOR RT INSERT/MODIFY/QUAL DATAVALUES

CDUEMV - GENERATE EXTERNAL/CONCEPTUAL SCHEMA MOVESTATEMENTS

CDEC - GENERATES WS AND PROC DIV FOR DF FOR ES TO CSCDMACRERRPRO

CALLED DIRECTLY BY:

CDP1O - BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS



3-38 &

.+ 1.

PS 6201412581 November 1985


NAME: CDP1OBPURPOSE: GENERATED THE PRECOMPILE TABLES INTO THE

USERS APLANGUAGE: VAX-11 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDPIOBSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

- GENERATE THE TRANSFER OF PRECOMPILETABLES INTO THE USERS AP. THESE TABLES INCLUDE:JQG - JOIN QUERY GRAPHAPL - ATTRIBUTE PAIR LISTRFT - RESULT FIELD TABLECSAL - CONCEPTUAL SCHEMA ACTION LIST

GENERATE WORKING STORAGE VARIABLES TO HOLD THEPRECOMPILE TABLES REQUIRED FOR THE NDML REQUEST. THENPOPULATE THESE VARIABLES WITH PRECOMPILED RESULTSREQUIRED FOR THE NDML REQUEST.

ARGUMENTS:

LANG-NO - RECRDWORKFILE-NANE - DSPLY [X(30)]PROCFILE-NAME - DSPLY [X(30)]ES-NDML-NO - DSPLY [999]JQG - RECRDJQG-ATTRIBUTE-PAIR-LIST - RECRDRFT - RECRDCS-ACTION-LIST - RECRDORACLE-LDA - RECRDRETURN-STATUS - DSPLY [X(5)]

INCLUDE FILES:

3-39

PS 6201412581 November 1985

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESCHKCDM - IISS CDMP CHECK STATUS CODESSBSTLST - WS DEFINITION FOR THE SUBSTITUTION LIST TABLELANGNO - SOURCE LANGUAGE VARIABLEJQGTBL - JOIN QUERY GRAPH TELLS HOW TO CONNECT

SUBTRANSACTIONSAPL - JOIN QUERY ATTRIBUTE PAIR LISTRFTABLE - THE RESULT FIELD TABLECSAL - CONCEPTUAL SCHEMA ACTION LISTORCLEDA - WS DEFINITION FOR THE ORACLE LOGIN AREAMACCALL - CALL THE MACRO COPY UTILITYERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

CDMACRERRPRO

CALLED DIRECTLY BY:




3-40

PS 6201412581 November 1985


NAME: CDPIOCPURPOSE: GENERATE ES RESULTS INTO USER VARIABLES

OR STRUCTURELANGUAGE: VAX-li COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDPIOCSOURCE FILE TYPE: .00BHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

ARGUMENTS:

LANG-NO - RECRDPROC-FILE-NAME - DSPLY [X(30)]

ES-ACTION-LIST - RECRDCS-NDML-NO - DSPLY [999]RET-STATUS - DSPLY [X(5)]

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESLANGNO - SOURCE LANGUAGE VARIABLEESAL - EXTERNAL SCHEMA ACTION LISTERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

ERRPRO

3-41

PS 6201412581 November 1985

CALLED DIRECTLY BY:---------------CDPIO - BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESS

USED IN MAIN PROGRAM(S):--------------------CDPIO - BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESS

3-42

-016

PS 6201412581 November 1985


NAME: CDPIOEPURPOSE: GENERATE ES/CS DATA DEFINITIONS FOR

INSERT VALUESLANGUAGE: VAX-I1 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDPlOESOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

ARGUMENTS:

LANG-NO - RECRDID-FILE-NAME - DSPLY [X(30)]FD-FILE-NAME - DSPLY [X(30)]WORX-FILE-NAME - DSPLY [X(30))PROC-FILE-NAME - DSPLY [X(30)]ES-ACTION-LIST - RECRDES-VALUE-USED - DSPLY (99]RET-STATUS - DSPLY [X(5)]

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESLANGNO - SOURCE LANGUAGE VARIABLEESAL - EXTERNAL SCHEMA ACTION LISTERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

CDPIC

3-43

.L n . .. . . ,mmi

PS 6201412581 November 1985

ERRPRO

CALLED DIRECTLY BY:




3

3-44

I

PS 620141258I November 1985


NAME: CDP1OFPURPOSE: GENERATE WORKING STORAGE VARIABLES TO

HOLD ES RESULTSLANGUAGE: VAX-11 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDP1OFSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

ARGUMENTS:

LANG-NO - RECRDCS-ACTION-LIST - RECRDES-ACTION-LIST - RECRDFD-FILE-NAME - DSPLY [X(30)]WORK-FILE-NAME - DSPLY [X(30)]RET-STATUS - DSPLY [X(5)]

INCLUDE FILES:

ERRCDH - IISS ERROR STATUS CODES FOR CDMP MODULESLANGNO - SOURCE LANGUAGE VARIABLECSAL - CONCEPTUAL SCHEMA ACTION LISTESAL - EXTERNAL SCHEMA ACTION LISTERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

CDPICERRPRO

3-45

PS 6201412581 November 1985

CALLED DIRECTLY BY:


USED IN MAIN PROGRAM(S):- - - - - - - -- -------CDPIO -BUILD CALLS AND MESSAGES INTO THE USERS

APPLICATION PROCESS

3-46

PS 6201412581 November 1985


NAME: CDUEMVPURPOSE: GENERATE EXTERNAL/CONCEPTUAL SCHEMA MOVE

STATEMENTSLANGUAGE: VAX-11 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDUEMVSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41258

DESCRIPTION:

ARGUMENTS:

LANG-NO - RECRDPROC-FILE-NAME - DSPLY [X(30)]CS-ACTION-LIST - RECR)CS-QUALIFY-LIST - RECRDES-ACTION-LIST - RECRDES-QUALIFY-LIST - RECRDRET-STATUS - DSPLY [X(5)]

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESLANGNO - SOURCE LANGUAGE VARIABLECSAL - CONCEPTUAL SCHEMA ACTION LISTCSQUAL - CONCEPTUAL SCHEMA QUALIFY LISTESAL - EXTERNAL SCHEMA ACTION LISTESQUAL - EXTERNAL SCHEMA QUALIFY LISTERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

3-47

PS 620141258

1 November 1985

ERRPRO,

CALLED DIRECTLY BY:

CDP1OA -GENERATE THE TRANSFORMATION OF ES VALUES ANDVARI ABLES


CDPIO -BUILD CALLS AND MESSAGES INTO THE USERSAPPLICATION PROCESS

3-48

PS 6201412581 November 1985

3.10.9 Include File Descriptions

The following list contains a purpose and description ofeach include file listed in 3.10.4 as specified in the sourcecode. The language it is written in is also given.

3-49

PS 6201412581 November 1985

BUILD CALLS AND MESSAGES Include File Description

FILE NAME: APLPURPOSE: JOIN QUERY ATTRIBUTE PAIR LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

CONTAINS INFORMATION AOUT THE JOINATTRIBUTES FOR NDML SUBTRANSACTIONS

3-50

I,I Ld ------- i

PS 6201412581 November 1985


FILE NAME: CGTABLEPURPOSE: CODE GENERATING TABLE- TRACKS ALL GENERATED SOFTWARELANGUAGE: VAX-11 COBOL

DESCRIPTION:

CODE GENERATOR TABLE, HOLDS PERTINENT RESULTSABOUT ALL CODE GENERATED OR MODIFIED BY THEPRECOMPILERNOTE: ROW 100 RESERVED FOR SWAPPING DURING SORTING.

3-51

-AWL

PS 6201412581 November 1985


FILE NAME: CHKCDMPURPOSE: IISS CDMP CHECK STATUS CODESLANGUAGE: VAX-i COBOL

DESCRIPTION:

CONTAINS ALL STATUS CODES FOR THECDMP MODULES

3-52

I

PS 6201412581 November 1985


FILE NAME: CSALPURPOSE: CONCEPTUAL SCHEMA ACTION LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

TABLE TO HOLD CONCEPTUAL DATA ABOUT THE REQUEST

THE CONCEPTUAL SCHEMA ACTION LIST

3-53

- L

PS 6201412581 November 1985


FILE NAME: CSQUALPURPOSE: CONCEPTUAL SCHEMA QUALIFY LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

CONTAINS CONCEPTUAL SCHEMA INFORMATION FORTHE REQUESTS QUALIFICATION

THE CONCEPTUAL SCHEMA QUALIFY LIST

3-54

PS 6201412581 November 1985


FILE NAME: ERRCDMPURPOSE: IISS ERROR STATUS CODES FOR CDMP MODULESLANGUAGE: VAX-I1 COBOL

DESCRIPTION:

CONTAINS ALL ERROR CODES USED BY CDMP *MODULES FOR ERROR HANDLING

3-55

I

. , m m un m4

PS 6201412561 November 1985


FILE NAME: ERRPROPURPOSE: PROCESS ERROR INCLUDE FILELANGUAGE: VAX-l1 COBOL

DESCRIPTION:

14

.4

3-56

PS 6201412581 November 1985


FILE NAME: ESALPURPOSE: EXTERNAL SCHEMA ACTION LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

CONTAINS THE EXTERNAL SCHEMA INFORMATION FOR ANNDML REQUEST

THE EXTERNAL SCHEMA ACTION LIST

3-57

PS 6201412581 November 1985


FILE NAME: ESQUALPURPOSE: EXTERNAL SCHEMA QUALIFY LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

CONTAINS EXTERNAL SCHEMA INFORMATION FOR THE NDLQUALIFICATION

THE EXTERNAL SCHEMA QUALIFY LIST

3-58

• I

PS 6201412581 November 1985


FILE NAME: ISALPURPOSE: INTERNAL SCHEMA ACTION LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

CONTAINS INTERNAL SCHEMA INFORMATION ABOUT ANNDML REQUEST

THE INTERNAL SCHEMA ACTION LIST

3

II

PS 6201412581 November 1985


FILE NAME: ISQUALPURPOSE: INTERNAL SCHEMA QUALIFY LISTLANGUAGE: VAX-li COBOL

DESCRIPTION:

IIi4

3-60

PS 6201412581 November 1985


FILE NAME: JQGTBLPURPOSE: JOIN QUERY GRAPH TELLS HOW TO CONNECT

SUBTRANSACTIONSLANGUAGE: VAX-li COBOL

DESCRIPTION:

3-61

-- a

PS 6201412581 November 1985


FILE NAME: LANGNOPURPOSE: SOURCE LANGUAGE VARIABLELANGUAGE: VAX-I1 COBOL

DESCRIPTION:

CONTAINS THE VALUES FOR THE SOURCE LANGUAGEOF THE APPLICATION

3-62

PS 8201412581 November 1985


FILE NAME: MACCALLPURPOSE: CALL THE MACRO COPY UTILITYLANGUAGE: VAX-11I COBOL

DESCRIPTION:

PARAGRAPHS TO SUBSTITUTE PARAMETERS FOR MACRO CALLSAND TO CALL "CDMACR" ROUTINE

3-83

PS 6201412581 November 1985


FILE NAME: ORCLEDAPURPOSE: VS DEFINITION FOR THE ORACLE LOGIN AREALANGUAGE: VAX- 11 COBOL

DESCRIPTION:

THE ORACLE LOGON DATA AREA

3-"4

-AW

PS 6201412581 November 1985


FILE NAME: RFTABLEPURPOSE: THE RESULT FIELD TABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

CONTAINS CONCEPTUAL SCHEMA INFORMATION ABOUTTHE RESULTS OF AN NDML REQUEST

THE RESULT FIELD TABLE

WHEN CHANGING THE STRUCTURE OF THIS TABLEBE SURE TO CHANGE THE LAYOUT IN THELINKAGE SECTION OF THE DRS (CDSOI)

WHICH WAS COPIED FROM THIS.

3-65

I I I I I I l - n - I| . . .I II I I t

PS 6201412581 November 1985


FILE NAME: SBSTLSTPURPOSE: WS DEFINITION FOR THE SUBSTITUTION LIST TABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

SUBSTITUTION-LIST REPRESENTS THE INPUT TABLEOF SUBSTITUTION PARAMETERS FOR THE CDMACRMACRO EXPANSION SUBROUTINE

3-W6I

PS 6201412581 November 1985


FILE NAME: SUEPROCPURPOSE: SUBTRANSACTION PROCESSES ID TABLELANGUAGE: VAX-li COBOL

DESCRIPTION:

THIS TABLE MUST HAVE THE SAME NUMBER OF OCCURSAS THE RITABLE.INC SINCE THEY ARE PARALLELTABLES.

3-67

II ,I I P

PS 6201412581 November 1985


FILE NAME: UVABBRPURPOSE: USER VIEW ABBREVIATION LISTLANGUAGE: VAX-li COBOL

DESCRIPTION:

CONTAINS THE ABBREVIATIONS FOR ALL USERVIEW REFERENCED IN THE NDML REQUEST

3-68

.. .. . .. .... .j ,b. . ,,j -- ,. _ I'

PS 6201412581 November 1985

3.10.10 Hierarchy Chart

The following hierarchy charts show the relationshipsbetween all of the modules mentioned in the above documentation.A module may call a subroutine several times within its code,but the call will only be shown once as a single relationship onthis hierarchy chart. All modules shown at the top of the firstpage are considered Main Programs as described in section 3.10.1above.

There is an internal paging scheme as marked by the numbersin the upper right corner of each page. An index after the lastpage of the chart shows where a routine and its calls are firstdefined. If a routine has no page reference, it either makes nocalls or is an external routine. A continuation box on the endof a tree limb shows where that the tree continues on the pagenumbered mentioned. A number in a box with a routine namepoints to the page where the routine is further defined withinthe hierarchy tree. If there is no number in a box, the routineeither makes no calls or is an external routine.

3-WS

A.

PS 6201412581 November 1985

ICDPIO!

----------------------- --- +--+-------------------------I I I I I I

+-------+ +--+ ----- ---.----- -------- -------- ------

ICDPIOCI ICDPlOAI ICDPIOBI ICDPIOEI ICDPIOFI I(CONT)I+--+---- ------ 2 - ------ 3 - ------ 4+ +--+---+ +------ 5+

I I

I I I1+--.--+ +--+---+

IERRPROI ICDPICI IERRPROI+-------- +-------+ +--------

3-70

PS 6201412581 November 1985

2

ICDP1OAI

I

+ - ...- +--- -- -

I I I I I

------ +--+---+ +-+--+ +--+---+ +--+---+ICDECWSI ICDUEMVI ICDECI ICDMACRI IERRPROI------- +--+---+ +---6+ -------- --------

I I+- --- --.. I

I I I+--+--+ +--+---+ +--+---+ICDPICI IERRPROI IERRPROI+-------+ -------- --------

3-71

PS 620141258

1 November 1985

3

ICDPIOBI

I

I I+------ -------I DKACRI I ERPRO I

3-72

PS 6201412581 November 1985

44+ .. ..

I CDPIOE I

I

----- .----I I

I CDPICI iE~PiO-

3-73

PS 6201412581 November 1985

5

ICDPIOI

+-- -+---+-I- - -- -- -- -- -- --- .- - -.........--- --

I I I I+--+---+ +--+---+ +--+----+

I(OONT)I iCDCONSI ICDNACRI IERRPROI.....1+ +--+---+ +- + ---- +

I

I I I I I I+--+---+ +--+-- +----+----------- ---------- ------ +

IRPTERRI ICDPICI IOOPENI IOSQL31 IODFINNI I(CONT)I--------- .------- +------- ------- -------- ------ 7+

3-74

PS 6201412581 November 1985

6

I CDEC I

+ ------- -+-- ----- +----+- -- -* - I I I I I

+--+---+ +--+--+ +--+----+ +--+---+ +--+--+ +--+---+IOOPENI IOSQL31 IODFINNI IOBINDNi JOEXECI I(CONT)I+-------+ +-------+ --------+ -------- +-------+ +------ 8+

3-75

PS 6201412581 November 1985

7

+--------ICDCONSi

I

-------------.---------- -- ------------------.------------------I I I I I------- ----- _ +-+--_ + ---------- _-+ _ +------

I(cOT)I IOBINDNI IOEXECI IOFETCHI IOCLOSICI IEjIPROI-- -5 + -------- + +-------+ -------- + --------- + +--------

37

. .. , kh . l . .. . . .3. ...6

PS 6201412581 Noveber 1985

S

ICDICI

+ -4 - ++ - 4 +

I I I I I+--+----+ +-.-+---. +--+--+ +--+---+ +-----+I(COET) I lOFEH I ICDPICI IOcwSZI IERPROl+ ------- +- -. +-.... --------

3-77

PS 6201412581 November 1985

a OU.... 5CDZC .6

CDPIO ....CDPIOA .... .2

CDPlOg ... .I

CDPIOF .. .. ICDPICCDUzNv .. .. 2

0CLOS3ODFXINY

OOPKN

3-78

PS 6201412581 November 1985

3.11 Program Listinjs Comments

This Information is contained in the Module Descriptions insection 3.10.

3-79O

PS 6201412581 November 1985

SECTION 4

QUALITY ASSURANCE PROVISIONS

4.1 Introduction and Definitions

"Testing" is a systematic process that may be preplannedand explicitly stated. Test techniques and procedures may bedefined in advance, and a sequence of test steps may bespecified. "Debugging" is the process of isolation andcorrection of the cause of an error.

"Antibugging" is defined as the philosophy of writingprograms in such a way as to make bugs less likely to occur andwhen they do occur, to make them more noticeable to theprogrammer and the user. In other words, as much error checkingas is practical and possible in each routine should beperformed.

4.2 Computer Proframaing Test and Evaluation

The quality assurance provisions for test consists of thenormal testing techniques that are accomplished during theconstruction process. They consist of design and codewalk-throughs, unit testing, and integration testing. Thesetests are performed by the design team. Structured design.design walk-through and the incorporation of "antibugging"facilitate this testing by exposing and addressing problem areasbefore they become coded "bugs."

4-1"U.S.Governmont Printing Offlce 194 7 741-061/60917

IPRRrwaw- .7

A E

F'ILMED

UOUJMK 9 1/1 ~~~N~C - DTIC

Documents

Transcript of UOUJMK 9 1/1 ~~~N~C - DTIC