VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1...

77
4-0182 914 INTEGRATED INFORMATION SUPPORT SYSTEM (1|SS) VOLUME 5 1/1 COMMON DATA MODEL S.. (U) GENERAL ELECTRIC CO SCHENECTADY 2Y PRODUCTION RESOURCES CONSU.. SSIFIED JL RLTHOFF ET AL. 01 NOV 05 PS-620141310 F/B 12/5 EahEmhhEmhEEEI Ehhmhmhhhhhhl EElhlhhhhElhEI IIIIIEIIEIIEI El""'/lll/

Transcript of VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1...

Page 1: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

4-0182 914 INTEGRATED INFORMATION SUPPORT SYSTEM (1|SS) VOLUME 5 1/1COMMON DATA MODEL S.. (U) GENERAL ELECTRIC COSCHENECTADY 2Y PRODUCTION RESOURCES CONSU..

SSIFIED JL RLTHOFF ET AL. 01 NOV 05 PS-620141310 F/B 12/5EahEmhhEmhEEEIEhhmhmhhhhhhlEElhlhhhhElhEIIIIIIEIIEIIEIEl""'/lll/

Page 2: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

IAICROCOPY RESOLUTM TEST CHART

0-~~~~~ q.i SW j .J o

Page 3: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

AD-A182 014 FILE COPY

AFAL-TR-86-4006Volume VPart 27

INTEGRATED INFORMATIONSUPPORT SYSTEM (IISS)Volume V - Common Data Model SubsystemPart 27 - Distributed Request Supervisor

Product Specification

General Electric CompanyProduction Resources ConsultingOne River RoadSchenectady, New York 12345

Final Report for Period 22 September 1980 - 31 July 1985 KINovember 1985

Approved for public release; distribution is unlimited.

DTICAEL.ECTEh -

PREPARED FOR: JUL 02 W33MATERIALS LABORATORYAIR FORCE VRIGHT AERONAUTICAL LABORATORIES EAIR FORCE SYSTEMS COMMANDWRIGHT-PATTERSON AFB, OH 45433-6533

- 'fb 1 ..

Page 4: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

NOTICE

When Government drawings. specifications, or other data are used for any purpose other thanin connection with a definitely related Government procurement operation, the United StatesGovernment thereby incurs no responsibility nor any obligation whatsoever, and the tact that thegovernment may have formulated, furnished, or in any way supplied the said drawings,specifications. or other data, is not to be regarded by implication or otherwise as in anymanner licensing the holder or any other person or corporation, or conveying any rights orpermission to manufacture, use. or sell any patented invention that may in any way be relatedthereto.

This report has been reviewed by the Office of Public Affairs (ASD/PA) and is releasable to theNational Technical Information Service (NTIS) At NTIS. it will be available to the generalpublic, including foreign nations.

This technical report has been reviewed and is approved for publication.

5./9/41/ID L.IJUDON PROJECT MANAGER DATEA AL ULTC! I

WFRGHT PATERSON AFB OH 45433

FOR THE COMMANDER.

.E ALD C. SHUMAKER, BRANCH CHIEF DATEAFWAL/ML TCWRIGHT PATTERSON AFB OH 45433

01f your address has changed, if you wish to be removed from our mailing list, or if theaddressee is no longer employed by your organization please notify AFWAL/MLTC. W-PAFB, OH45433 to help us maintain a current mailing list.,

Copies of this report should not be returned unless return is required by security Cnnqirfraitinncontractual obligations, or notice on a specific document

.~. 1* ' .d~e.f f - 4 -* * . ~ . ~ - I.'"~ q

Page 5: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

55 CB .Y ~AI eg~s~b0. IiS PSSI November 1985

REPORT DOCUMENTATION PAGEto A5ADAy SAC.,.,, C&AS8Pe1CATION~I i~c~s OWI UNI ARSSf LZO

ftciasa if ed

2& 9SCuS'?V C.&S.CAT60, £uT0444TV 3 DISTI IT 60%, AVAi.AS 10T WOf a&PO.,

ft 0 SCa.Ansole&C? of/oorua AO'.S5CkS*Ub.SW distribution Is unlimited.

4. P91k#OmIi5 0mGsahgAiD% dILODAT eeuW5*I5 5.0eaIm5OG&ft4AY6SeS AILIODA INWeSAgM,

AFVAL-TR-86-4006 Vol V, Part. 27

44 %Am& 00 04SAPORWu.tO OSGAfaZATION o, opoPe CSY60VUU I fa. A6 Of 0inO#.ItoB OaAtdAIeTON

Production Resources Consulting AVLKT

8.. £095855 IC. Sam ~ ZIP Cow) ft. AooAtLSSM" ~am ow ZIP Coft

Scheectay. W 1235 EATS. ON 45433-6533

As ftA%4 of @*ut0muS4Pftu5OiaU6 oppac CSV"0 Y 0. PSOcuAtlMy 64fwad 0 IkISMSN MShIIAT SON loUma a

Air Foros Systems C...sai. USP.7 OFAL.C736 -0055

Wrigbt-Pattrsem £73. fti. 453I11ITfa m O 1o

woolly 7500 20

(See Rovers*) -

it. "440%'A4. LUT"OftelAlthoff. J. L. and Aploella. H. L.

1. Itv~ of 4910041 Saw. lI&H CviRIO 16 DAT9 Do PAPOO! eye.... aw I s. CouTVa. "eehale)l 01pOrt 22 Sept 305D - *I out? 1965 loss swomeber 73

i.IP tP4p9"w?4AW ft.O. The computer software Contained herein are theoretical and/or

SCAN Project 1prierity sao referenoes that In so way reflect Air Forceowmed or -developed

$62 LO ISNU ssu 5oS

isAURAT els~as~ rom Oftcoi, an sgoft oft 0ME au-'a

- This document Is the product specification establishing the designImplementation of the IISS Configuration Item Distributed RequestSupervisor which controls the processing of distributed data ~ h

requests by the aggregators and generated request processors. .,

Welca''awPUNLIW's W sow s "' WT. c *ic Mar Unclassified

DO FORM 13.83 APR 66Iet Do IS AlA" IS a 0OssoiSY. Ucasfe

08CuSITY g64.UPG.AY.Oh. Do Tiis 6-1

NY,

Page 6: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

11. Title

Integrated Information Support System (IISS)Vol V - Common Data Model SubsystemPart 27 - Distributed Request Supervisor

Product Specification

Acoession ForNTIS GRA&I

DTIC TABUnannounced QJust i eat ion

,,

Distributim/

Availability Codes

lAvaii aid/orDist Special

q'Pro

IK2>

@U

ia

Page 7: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310

1 November 1985

PREFACE

This product specification covers the work performed underAir Force Contract F33615-80-C-5155 (ICAM Project 6201). Thiscontract is sponsored by the Materials Laboratory, Air ForceSystems Command, Wright-Patterson Air Force Base, Ohio. It wasadministered under the technical direction of Mr. Gerald C.Shumaker, 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 Technology hasbeen performed by other contracts with Project 6201 performingintegrating functions. This work consisted of enhancements 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 (BMAC)

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.

tii

S

Page 8: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 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.

Pritsker and 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 (BMAC) 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 CDM(shared with CDC). DAGOM alsodeveloped the IntegrationMethodology and did the schemamappings for the ApplicationSubsystems.

iv

Page 9: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

Subcontractors Role

Digital Equipment Consulting and support of the

Corporation (DEC) performance testing and on DECsoftware and computer systemsoperation.

McDonnell Douglas Responsible for the support andAutomation Company enhancements to the Network

(McAuto) Transaction Manager Subsystemduring 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 & 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 the

Engineering (SPE) work on performance evaluationand 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

W~./C.'~.'Lf%'& " %\ ....- ,.-.

Page 10: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

Contractors ICAN Project Contributing Activities

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

Processor (CDNP).

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

General Electric 1502 Operation of the TestBed and communicationsequipment.

Hughes Aircraft 1701 Test Bed enhancements.Company (MAC)

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

(UI/VTX).

Systran 1502 Test Bed enhancements.Operation of Test Bed.

vi

Page 11: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310

1 November 1985

TABLE OF CONTENTS

Paf 0

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-23.4 Program Interrupts.....................3-33.5 Timing and Sequencing Description .. 3-33.6 Special Control Features..............3-33.7 Storage Allocation....................3-33.7.1 Database Definition.................3-33.7.1.1 File Description..................3-33.7.1.2 Table Description.................3-33.7.1.3 Item Description..................3-33.8 Object Code Creation..................3-33.9 Adaptation Data........................3-43.10 Detail Design Description.............3-43.10.1 Main Program List....................3-43.10.2 Module List......................... 3-63.10.3 External Routines List..............3-83.10.4 Include File List.............3-10 *

3.10.5 Where Include File Used List.......3-123.10.6 Where External Routine Used List .. 3-173.10.7 Main Program Parts List.............3-203.10.8 Module Documentation................3-233.10.9 Include File Description............3-323.10.10 Hierarchy Chart..................... 3-563.11 Program Listings Comments.............3-60

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

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

vii

i" %

Page 12: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

SECTION 1

SCOPE

1.1 Identification

This specification establishes the design of Function DRS,

)Distributed Request Supervisor', one of the major functions of

the Configuration Item, to be built and formally accepted by theICAN Program Office. This CI constitutes one of the subsystemsof the Common Data Model Processor (CDMP).

1.2 Functional Summary

The overall object ves of this CPCI are to:

1) Determine the appropriate sequence of inter databaseJoin, Union and Not In Set operations required toproduce the result for a multi-database transaction]--rt-'

2) Coordinate and control the interactions among a user'sapplication process (AP), the generated RequestProcessor (RP) and the Aggregator(s) for both singleand multi-database transactions. , .

1-1

Page 13: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

SECTION 2

DOCUMENTS

2.1 Reference Documents

1. ICAM Documentation Standards: IDS15012000A, 28December 1981.

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

3. D. Appleton Co., CDMl-IDEF1 Model of the Common DataModel; CCS620141000, 15 May 1985.

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

5. D. Appleton Co., Embedded NDML Programmer's ReferenceManual: PRM620141200, March 1985.

6. Softech, Inc., NTM Proframmer's Guide: UM620140001,July 1984

7. Control Data Corporation, Computer Program DevelopmentSpecification (DS) for ICAM Integrated Support System(IISS) 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: (CDX) 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 NDML programmer reference

2-1

Page 14: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

data.

Database Management System: (DBMS)

Distributed Request Supervisor: (DRS) This IISS CDMsubsystem configuration item controls the execution ofdistributed NDNL 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)

Integrated 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.

Mappin: The correspondence of indepen'ent objects in twoschemas: ES to CS or CS to IS.

Network Transaction Manager: (NTM) 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 Languaje: (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

**, bovuz It, **C. - *

Page 15: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 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 source codeof 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

Page 16: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

SECTION 3

REQUIREMENTS

3.1 Structural Description

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

The DRS has been coded as a single, large COBOL subprogram.

It is internally composed of three subfunctions and definedin the DS Reference 8. These subfunctions are:

1. Initiate/Resume Subtransaction Processing

2. Schedule Stages

3. Initiate CS/ES Transform Processing

3.2 Functional Flow

This CPCI implements the logic defined in the DevelopmentSpecification for this CPCI. Details of inputs/outputs andrelationships between modules are to be found in Section 3.10.

This CPCI has been designated to operate in an interactivemode. It must operate in the system environment established forIISS; that is, use of the Network Transaction Manager.

The following exceptions to the Development Specificationare noted.

1. The DS calls for the CS/ES transform step to becontrolled by the DRS as a separate process, using fileinput-output and NTM interprocess communication. Ininterests of efficiency, the CS/ES transform iscontrolled by code generated into the user AP directly.This saves one file of external query results andallows th interaction with the CS/ES transform to bedirect, without use of NTM services.

2. The DS called for the DRS to be a separate process. Inthe interests of efficiency, it has been implemented asa subprogram called from the user's AP.

3-1

Page 17: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

3. The contents of Transmission Cost Table are compiledinto the DRS. The DRS specifies that this be found ina file.

3.3 Interfaces

The following diagram depicts the interface of DRS and theother CPCI's.

I USER II AP ---------------

ISUBROUTINE II CALLS I

--- ------ ---------------I DRS I I CS ES II I I TRANSFORMERSI

---------------------------- ----------------- NTM SERVICES

-------------- + I +---------------+I REQUEST I I I AGGREGATORS II PROCESSORS I I I PS620141320 I+-------------- +---------------+

+------------------I FILE UTILITIES II PS620141330 I---------------------

3.3.1 Input/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: DRS

INPUT OUTPUT

Subtransaction NumberDRS Action Conceptual Schema

Result FilePool of Input Tables from Results Countthe Users Application Process Module Status

3-2

Page 18: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

3.4 Program Interrupts

The DRS makes use of NTM services to start and controlmultiple request processors at the same time. It also controlsmultiple instances of aggregators at the same time. It mustwait until each process has completed before it can begin itsnext sequence of activities.

3.5 Timing and Sequencing Description

The DRS can control many request processors at the sametime, asynchronously. In other words, it will start allsubtransactions of a query and wait for them all to complete.When complete, it handles aggregation of these results. Theaggregation may also execute asynchronously in parallel. TheDRS will wait for all processes to complete. It has no timelimits.

3.6 Special Control Features

Not applicable to this CPCI.

3.7 Storage Allocation

3.7.1 Database Definition

No databases are used by this CPCI.

3.7.1.1 File Description

No permanent files have been defined for this CPCI. It mayuse temporary scratch files for such things as generated programsource code or temporary query results. The cost Informationtable has not been implemented as a file.

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 system

3-3

Page 19: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

integration test team by using defined IISS SoftwareConfiguration Management procedures. This CPCI will use theCOBOL language compiler.

3.9 Adaptation Data

This CPCI has been coded using ANSI COBOL. The intent wasto provide a transportable system. Any system environmentsupporting this language, a virtual memory management scheme,the CON and NTH subsystems of IISS and the ORACLE DatabaseManagement System should be able to support this CPCI. Everypossible 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.10 Detail Design Description

The following sections have been computer generated forthis CPCI.

3.10.1 Main Program 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-4

36a

Page 20: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Main Program List

Module Name Purpose

INTFTN CONVERT INTEGER VALUE TO CHARACTER STRING

TOTOPN CONTROL OPENING OF TOTAL DE FILES

TRMNDML TERMINATE USE OF NDML AND NTH

3-5

Page 21: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

3.10.2 Nodule 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-6

Page 22: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310

1 November 1985

DISTRIBUTED REQUEST SUPERVISOR Nodule List

Nodule Name Purpose

CDFUNC DETERMINE AP NAME GIVEN THE FUNCTION AND

HOST

CDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

INTFTN CONVERT INTEGER VALUE TO CHARACTER STRING

TOTOPN CONTROL OPENING OF TOTAL DB FILES

TRMNDML TERMINATE USE OF NDML AND NTM

3-7

' . ' d_' .' ._ .. 2" " , . .. ". " .. • ... .''._. . .. ,. " .. - . . .-. . - . .. . , . - - . '. . . . '

Page 23: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 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 NumberCH 620100001). See section 3.10.6 for a list of the modulesthat call each of these external routines.

3-8

Page 24: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR External Routines List

Module Name First User

DELFIL CDS01ERRPRO CDFUNCISEND CDSO1NSEND CDSOIOPENX TOTOPNRCV CDSO1SIGABT CDSO1SIGERR CDSOITRMNAT TRNNDMLVMTHST CDSO1

3-9

-

Page 25: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 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 are

* provided with the 'C' compiler.

See section 3.10.6 for a set of lists which show all* the modules which call In each of these include files.

3-10

Page 26: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File List

File Name Purpose

AGGNSG AGGREGATOR INPUT MESSAGEAPL JOIN QUERY ATTRIBUTE PAIR LISTCHKCDM IISS CDMP CHECK STATUS CODESCITABLE COST INFORMATION TABLECSAL CONCEPTUAL SCHEMA ACTION LISTDMPCSAL DISPLAYS THE CONTENTS OF THE CS ACTION LISTDUNPAPL DISPLAYS THE CONTENTS OF THE ATTRIBUTE PAIR LISTDUMPCIT **** PURPOSE NOT FOUND BY STRIPPER ****DUMPJQG DISPLAY THE CONTENTS OF THE JQG TABLEDUMPRFT DISPLAY THE CONTENST OF THE RFT TABLEDUMPRIT DISPLAY THE CONTENTS OF THE RIT TABLEERRCDM IISS ERROR STATUS CODES FOR CDMP MODULESERRPRO PROCESS ERROR INCLUDE FILEFSMSG MESSAGE FOR THE FILE SEND UTILITYJQGTBL JOIN QUERY GRAPH TELLS HOW TO CONNECT

SUBTRANSACTIONSLNKEDGE DETERMINE DUPLICATE EDGES IN THE JQGQITABLE REQUEST INFORMATION TABLERFTABLE THE RESULT FIELD TABLERITABLE RIT- RELATION INFORMATION TABLESRVRET AS THE RETURN GIVEN A TABLE-FULL ERRORSTDRESP WS DEFINITION FOR STANDARD STATUS VARIABLESUBPROC SUBTRANSACTION PROCESSES ID TABLETCTABLE TRANSMISSION COST TABLE

3-11

Page 27: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101November 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 includethen. The purpose of each module Is listed as well.

3-12

Page 28: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Where-include-file-used List

Include Module ModuleFile Name Purpose

AGGMSGCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

APLCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

CHKCDMCDFUNC DETERMINE AP NAME GIVEN THE FUNCTION AND

HOSTCDSOI THE DISTRIBUTED REQUEST SUPERVISOR

TOTOPN CONTROL OPENING OF TOTAL DB FILESTRMNDML TERMINATE USE OF NDML AND NTM

CITABLECDS01 THE DISTRIBUTED REQUEST SUPERVISOR

CSALCDSO THE DISTRIBUTED REQUEST SUPERVISOR

DMPCSALCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

3-13

Page 29: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Where-include-file-used List

Include Nodule ModuleFile Name Purpose

DUMPAPLCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

DUMPCITCDSOI THE DISTRIBUTED REQUEST SUPERVISOR

DUMPJQGCDSOl THE DISTRIBUTED REQUEST SUPERVI3OR

DUMPRFTCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

DUMPRITCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

ERkCDMCDFUNC DETERMINE AP NAME GIVEN THE FUNCTION AND

HOSTCDSO1 THE DISTRIBUTED REQUEST SUPERVISORTOTOPN CONTROL OPENING OF TOTAL DB FILESTRMNDML TERMINATE USE OF NDML AND NTM

3-14

Page 30: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Vhere-include-filie-used List

Include Module ModuleFile Name Purpose

ERRPRO,CDFUNC DETERMINE AP NAME GIVEN THE FUNCTION AND

HOSTCDSO1 THE DISTRIBUTED REQUEST SUPERVISORTOTOPN CONTROL OPENING OF TOTAL DE FILESTRMNDNL TERMINATE USE OF NML AND NTM

FSMSGCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

JQGTBLCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

LNKEDGECDSOI THE DISTRIBUTED REQUEST SUPERVISOR

QITABLECDSOl THE DISTRIBUTED REQUEST SUPERVISOR

RFTABLECDSOl THE DISTRIBUTED REQUEST SUPERVISOR

3-15

Page 31: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Where-include-ftle-used List

Include Module ModuleFile Name Purpose

RITABLECDSO THE DISTRIBUTED REQUEST SUPERVISOR

SRVRETCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

STDRESPCDS01 THE DISTRIBUTED REQUEST SUPERVISOR

SUBPROCCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

TCTABLECDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

3-16

Page 32: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

3.10.6 Where External Routine Used List

The following 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-17

Page 33: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Where-external-routine-usedList

System Module ModuleModule Name Purpose

DELFILCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

ERRPROCDFUNC DETERMINE AP NAME GIVEN THE FUNCTION AND

HOSTCDSOI THE DISTRIBUTED REQUEST SUPERVISORTOTOPN CONTROL OPENING OF TOTAL DB FILESTRMNDML TERMINATE USE OF NDML AND NTM

ISENDCDSOI THE DISTRIBUTED REQUEST SUPERVISOR

NSENDCDSOI THE DISTRIBUTED REQUEST SUPERVISOR

OPENXTOTOPN CONTROL OPENING OF TOTAL DB FILES

RCVCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

SIGABTCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

SIGERR

3-18

Page 34: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Where-external-routine-usedList

System Module ModuleModule Name Purpose

CDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

TRKNATTRMNDML TERMINATE USE OF NDML AND NTH

WHTHSTCDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

3-19

Page 35: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

3.10.7 Main Profram 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"routineo. The Purpose of the Main Program module is listedas well.

3-20

Page 36: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Main Program Parts List

Main Pga Module ModuleName Name Type

TOTOPN Purpose-- ,CONTROL OPENING OF TOTAL DBFILES

ERRPRO External routineOPENX External routine

3-21

- ( /e< ,'.' ,.,.,...,.........,-.....'.'.-.. -'.-.....,..'......._--...-.....-..,.-.-....-.-..'........ '.'....,'......-.....-"..-.".-...".. "

Page 37: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Main Program Parts List

Main Pgm Module ModuleName Name Type

TRMNDML Purpose-- TERMINATE USE OF NDML AND NTHCDFUNC Well-defined moduleCDS01 Well-defined moduleDELFIL External routineERRPRO External. routineISEND External routineNSEND External routineRCV External routineSIGABT External routineSIGERR External routineTRNNAT External routineWVTHST External routine

3-22

Page 38: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

3.10.8 Module 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:

MKE: Name of program Module.

PURPOSE: Purpose of Nodule as detailed in thesource code.

LANGUAGE: Programing language source code iswritten In.The choices are:

VAX-li FORTRAN

C (I/S-i Workbench 'C')VAX-il COBOL

MODULE TYPE: Whether a Program. Subroutine, orFunc tion.

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.

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

DESCRIPTION: A description of the module as otained

3-23

Page 39: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

from the source code.

ARGUNMENT S: 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 a~stheir 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-24

Page 40: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Module Documentation

NAME: CDFUNCPURPOSE: DETERMINE AP NAME GIVEN THE FUNCTION AND

HOSTLANGUAGE: VAX-1l COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDFUNCSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41310

DESCRIPTION:

- PERFORM A TABLE LOOK UP BASED ON THE GIVENHOST NAME AND THE FUNCTION DESIRED.RETURN THE PROPER AP NAME.

ARGUMENTS:

FUNCT-IN - DSPLY [X(10)]HOST-IN - DSPLY [XXX]TARGET-AP - DSPLY [X(10)]RET-STATUS - DSPLY [X(5)]

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESCHKCDM - IISS CDMP CHECK STATUS CODESERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

ERRPRO

CALLED DIRECTLY BY:

3-25

Xsek....w ''%~C a

Page 41: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310

1 November 19115

CDSO1 THE DISTRIBUTED REQUEST SUPERVISOR

USED IN MAIN PROGRAM(S):

TRMNDML - TERMINATE USE OF NDMJ AND NTM

3-26

Page 42: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Module Documentation

NAME: CDSO1PURPOSE: THE DISTRIBUTED REQUEST SUPERVISORLANGUAGE: VAX-Il COBOLMODULE TYPE: SUBROUTINESOURCE FILE: CDS01SOURCE FILE TYPE: .COBHOST: VAXSUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41310

DESCRIPTION:

- THE DRS IS THE RUN TIME MONITOROF ALL RUN TIME PROGRAMS NECESSARYTO FULFILL A NDML REQUEST.

ARGUMENTS:

SS-NO-SUBTRANS - DSPLY [999]DRS-ACTION - DSPLY [X]SS-POOL - RECRDCS-ACTION-LIST - RECRDJQG - RECRDJQG-ATTRIBUTE-PAIR-LIST - RECRDUSER-RFT - RECRDCS-RESULTS-FILE - DSPLY [X(30)]CS-RESULTS-COUNT - DSPLY [9(6)]RET-STATUS - DSPTY [X(5)]

INCLUDE FILES:

TCTABLE - TRANSMISSION COST TABLECITABLE - COST INFORMATION TABLERITABLE - RIT- RELATION INFORMATION TABLEQITABLE - REQUEST INFORMATION TABLESUBPROC - SUBTRANSACTION PROCESSES ID TABLERFTABLE - THE RESULT FIELD TABLESTDRESP - WS DEFINITION FOR STANDARD STATUS VARIABLEERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULES

3-27

Page 43: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

CHKCDM - IISS CDMP CHECK STATUS CODESSRVRET - AS THE RETURN GIVEN A TABLE-FULL ERRORFSNSG - MESSAGE FOR THE FILE SEND UTILITYAGGMSG - AGGREGATOR INPUT MESSAGECSAL - CONCEPTUAL SCHEMA ACTION LISTJQGTBL - JOIN QUERY GRAPH TELLS HOW TO CONNECT

SUBTRANSACTIONSAPL - JOIN QUERY ATTRIBUTE PAIR LISTERRPRO - PROCESS ERROR INCLUDE FILELNKEDGE - DETERMINE DUPLICATE EDGES IN THE JQGDUMPCIT - **** PURPOSE NOT FOUND BY STRIPPER ****DUMPRIT - DISPLAY THE CONTENTS OF THE RIT TABLEDUMPAPL - DISPLAYS THE CONTENTS OF THE ATTRIBUTE PAIR LISTDUMPRFT - DISPLAY THE CONTENST OF THE RFT TABLEDUMPJQG - DISPLAY THE CONTENTS OF THE JQG TABLEDMPCSAL - DISPLAYS THE CONTENTS OF THE CS ACTION LIST

ROUTINES CALLED:

ERRPROSIGERRNSENDISENDRCVCDFUNC - DETERMINE AP NAME GIVEN THE FUNCTION AND HOSTDELFILWHTHSTSIGABT

CALLED DIRECTLY BY:

TRMNDML - TERMINATE USE OF NDML AND NTM

USED IN MAIN PROGRAM(S):

TRMNDML - TERMINATE USE OF NDML AND NTM

3-28

Page 44: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Nodule Document&tion

NAME: INTFTNPURPOSE: CONVERT INTEGER VALUE TO CHARACTER STRINGLANGUAGE: VAX-11 FORTRANMODULE TYPE: SUBROUTINESOURCE FILE: INTFTNSOURCE FILE TYPE: .FORHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41310

DESCRIPTION:

ARGUMENTS:

NUMBER - 1*4CHAROT - CHAR

3-29

Page 45: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Module Documentation

NAME: TOTOPNPURPOSE: CONTROL OPENING OF TOTAL DB FILESLANGUAGE: VAX-li COBOLMODULE TYPE: SUBROUTINESOURCE FILE: TOTOPNSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41310

DESCRIPTION:

BY USING A GLOBAL REALM CONTAINING ALL FILESCURRENTLY OPENED BY TOTAL OF THIS PROCESS ANDA LOCAL REALM OF FILES A PARTICULAR RP NEEDS,ONLY THE NEW FILES NEED BE OPENED AND RECORDEDIN THE GLOBAL REALM TABLE. A SINGLE "OPENX"CALL MAY BE ISSUED, AND EACH FILE SUCCESSFULLYOPENED STORED IN THE GLOBAL REALM. IF ANY FILEIS FOUND IN ERROR, A MESSAGE IS LOGGED.

ARGUMENTS:LOCAL-REALM - REORDGLOBAL-REALM - RECRD

TOTAL-STATUS - DSPLY [X(4)]

INCLUDE FILES:

ERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESCHKCDM - IISS CDMP CHECK STATUS CODESERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

OPENXERRPRO

5-30

0 p

Page 46: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Nodule Documentation

NAME: TRMNDMLPURPOSE: TERMINATE USE OF NDNL AND NTMLANGUAGE: VAX-i1 COBOLMODULE TYPE: SUBROUTINESOURCE FILE: TRMNDMLSOURCE FILE TYPE: .COBHOST:SUBSYSTEM: CDMSUBDIRECTORY:DOCUMENTATION GROUP: PS41310

DESCRI PTION:

- THIS MODULE WILL BE USED TO SIGNAL END OF ANYNDML COMMAND PROCESSING. IT WILL SEND A SPECIALCALL TO THE DRS. SO THAT IT CAN NOTIFY EACHACTIVE RP TO DO A CLOSE AND TERMINATE ITSPROCESSING. WHEN THE DRS RETURNS AFTER EACH RP ISDONE, NTM SERVICE TRMNAT WILL BE CALLED TO STOP THERUN. NOTE, THE USER WILL NOT NEED TO USE TRMNAT.

ARGUMENTS:

TERMINATION-STATUS - DSPLY [X]

INCLUDE FILES:

CHKCDM - IISS CDMP CHECK STATUS CODESERRCDM - IISS ERROR STATUS CODES FOR CDMP MODULESERRPRO - PROCESS ERROR INCLUDE FILE

ROUTINES CALLED:

CDSOI - THE DISTRIBUTED REQUEST SUPERVISORTRMNATERRPRO

3-31

Page 47: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 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 source

code. The language it is written in is also given.

3-32

Page 48: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: AGGNSG*PURPOSE: AGGREGATOR, INPUT MESSAGE

LANGUAGE: VAX-li COBOL

* DESCRIPTION:

CONTAINS THE FORMAT OF THE INPUT MESSAGE FOR THECDMP AGGREGATORS

DESCRIPTION :

AGGREGATOR INPUT MESSAGE FORMAT

NIS -NOT IN SET

3-33

Page 49: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310

1 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

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

DESCRIPTION:

CONTAINS INFORMATION ABOUT THE JOINATTRIBUTES FOR NDNL SUBTRANSACTIONS

3-34

V V - 'v

Page 50: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: CHKCDKPURPOSE: IISS CDKP CHECK STATUS CODESLANGUAGE: VAX-11 COBOL

DESCRIPTION:

CONTAINS ALL STATUS CODES FOR THECDP MODULES

3-35

V V ~ ,.,, *

Page 51: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

.FILE MANE: CITABLEPURPOSE: COST INFORMATION TABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

THIS TABLE IS USED BY THE DRS TOTRACK COSTS OF POSSIBLE SUBTRANSACTIONS

3-36

Page 52: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAKE: CSPURPOSE: DISPLAY CONTENTS OF THE COST INFORMATION TABLELANGUAGE: VAX-il COBOL

DESCRIPTION:

3-37

Page 53: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: CSALPURPOSE: CONCEPTUAL SCHEMA ACTION LISTLANGUAGE: VAX-1l COBOL

DESCRI PT ION:

TABLE TO HOLD CONCEPTUAL DATA ABOUT THE REQUEST

..... THE CONCEPTUAL SCHEMA ACTION LI ST

3-.3B

Page 54: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: DMPCSALPURPOSE: DISPLAYS THE CONTENTS OF THE CS ACTION LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

3-39

Page 55: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 ,oveuber 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: DUMPAPLPURPOSE: DISPLAYS THE CONTENTS OF THE ATTRIBUTE PAIR LISTLANGUAGE: VAX-11 COBOL

DESCRIPTION:

3-40

; r ¢ ~~~~~~~~~~~~~.....-.... ...... ...... .'-"""""" "'.. .....- "".',

Page 56: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310

1 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: DUMPJQGPURPOSE: DISPLAY THE CONTENTS OF THE JQG TABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

3-41

Page 57: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: DUMPRFTPURPOSE: DISPLAY THE CONTENST OF THE RFT TABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

3-42

~|

Page 58: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: DUMPRITPURPOSE: DISPLAY THE CONTENTS OF THE RIT TABLELANGUAGE: VAX-i1 COBOL

DESCRIPTION:

3-43

Page 59: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310I November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: ERRCDMPURPOSE: IISS ERROR STATUS CODES FOR CDNP NODULESLANGUAGE: VAX-11 COBOL

DESCRIPTION:

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

3-44

Page 60: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

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

DESCRIPTION:

3-45

Page 61: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: FSNSGPURPOSE: MESSAGE FOR THE FILE SEND UTILITYLANGUAGE: VAX-i1 COBOL

DESCRIPTION:

MESSAGE FORMAT FOR THE FILE SEND INPUT

3-46

Page 62: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

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

SUBTRANSACTIONSLANGUAGE: VAX-11 COBOL

DESCRIPTION:

3-47

Page 63: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: LNKEDGEPURPOSE: DETERMINE DUPLICATE EDGES IN THE JQGLANGUAGE: VAX-1 1 COBOL

DESCRIPTION:

DURING JQG COLLAPSING, DUPLICATE JQG ENTRIES MAY RESULTWITH

DIFFERENT APL'S. THIS WILL BE EXECUTED AT THE END OFSENDS

FOR A STAGE AND WILL FIND THE DUPLICATE EDGES AND HOOK THEAPL'S TOGETHER BEFORE THE CIT IS REBUILT AT THE BEGINNINGOF THE NEXT STAGE.

3-48

Page 64: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: QITABLEPURPOSE: REQUEST INFORMATION TABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

THIS TABLE WILL TRACK ALL ACTIVE REQUEST PROCESSORSFOR THE DRS.

QITABLE.INC

3-49

-~ - . -w '~ i

Page 65: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: RFTABLEPURPOSE: THE RESULT FIELD TABLELANGUAGE: VAX-i 1 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-50

.+l ,.,. .- , .,,.l, . , -, r, .. +<,, '''; -p".'' ' ' *% :

Page 66: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 620141310

1 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: RITABLEPURPOSE: RIT- RELATION INFORMATION TABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

USED BY THE DRS TO KNOW ABOUT EACH RELATIONIN A TRANSACTION

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

5-51

In~l AjI, I ,'Ar .'. ' -,.r_,p, rr .w-... _r , . _r_-.'-' -. ',. _4.r_- , . .... -0.- , - "-" -'' ' n

Page 67: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: SRVRETPURPOSE: AS THE RETURN GIVEN A TABLE-FULL ERRORLANGUAGE: VAX-il COBOL

DESCRIPTION:

MODIFIED 11/2/83 TO INCLUDE RET-CODE-5MODIFIED 1/9/84 TO INCREASE ALL ERROR CODES TO PIC X(5)

AND TO ELIMINATE ALPHA'S *MODIFIED 1/26/84 TO ADD RET-CODE FOR GETUSR-NOT-SUCCSRV-SUCCESSFUL ADDED FOR GENERIC RETURN *MODIFIED 2/7/84 TO ADD ERROR CODES FOR ENTRY-NOT-FOUND *MODIFIED 2/8/84 TO ADD WHTHST-NOT-SUCCESSFUL *MODIFIED 2/20/84 TO ADD TSTMOD NEW CODES.

MODIFIED 20 AUG 84 INITALIZE ALL LOCAL VARAIBLES TOSPACES OR 0.

MODIFIED 5/21/85 TO ADD RCL AND FILGEN RETURN CODES

3-52

Page 68: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: STDRESPPURPOSE: WS DEFINITION FOR STANDARD STATUS VARIABLELANGUAGE: VAX-11 COBOL

DESCRIPTION:

THE STANDARD 'PROCESS COMPLETE' MESSAGE

3-53

&f Z N

Page 69: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: SUBPROCPURPOSE: SUBTRANSACTION PROCESSES ID TABLELANGUAGE: VAX- 1 COBOL

DESCRIPTION:

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

3-54

Page 70: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

DISTRIBUTED REQUEST SUPERVISOR Include File Description

FILE NAME: TCTABLEPURPOSE: TRANSMISSION COST TABLELANGUAGE: VAX-I1 COBOL

DESCRIPTION:-- -- - -- -

HOLDS RELATIVE COST OF TRANSMISSION/PROCESSINGFILE TRANSFERS/JOINS ON THE NETWORK AND IS USED ASA BASIS OF STAGER/SCHEDULER OPTIMIZATION ALGORITHMS

THESE ARE THE EXPERIMENTAL VALUES FOR THE TCT:

3-55

Page 71: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 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-56

,m,,jl ~ ~ ~ i C '"d"' ' ' ' % '' '' '" " '',' . . .N%' N '' ' +

Page 72: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

I TOTOPN I I TR)WDtL I

I I

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

IOPEIXI I]RRPROI laDeOl I ITRENATI IERRPROI+------ -------- - - - +--- - -

I IIII+-------+ +-------- -+- -+-+++++---

IKURPROI ISIGERRI INSENDI IISEUDI IRCVI l(CONT)l----- -- --- ---- - --- ----- 2+

3-57

Page 73: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

2

ICDSO1II

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

(C0NT)i ICDFUNCI iDELFILI IVHTHSTI ISIGABTI

I ERRPRO I

3-58

Page 74: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

CDFUNC ....2CDSOl .1DELFILERRPROXSENDNSENDOPENXRCV

TOTOPN ..TRENATTRKNMM .... 1VUTRIST

3-59

O F~ l II , j U ,IIII i~ ii 1111 1111, 11111

Page 75: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 November 1985

3.11 Program Listinkfs Comments

This Information Is contained in the Module Descriptions Insection 3.10.

3-60

Page 76: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

PS 6201413101 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. ODebuggingo 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 then 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 Programminf 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.ILGovenment Printing Office: 1967 - 748-061/60920

Page 77: VOLUME 5 1/1 EahEmhhEmhEEEI SSIFIED JL RLTHOFF ET AL. 01 … · 2014. 9. 27. · PS 620141310 1 November 1985 PREFACE This product specification covers the work performed under Air

9 9