xvEPA
United States
Environmental Protection
Agency
Office of Air Quality
Planning and Standards
Research Triangle Park NC 27711
EPA-450/4-79-009
May 1979
Air
The Air Quality Data
Handling System
User's Guide
-------
INSTRUCTIONS FOR AQDHS-II UPDATE 25
DOCUMENTATION REVISIONS
October 1, 1979
This document provides pen and ink changes that are to be made to
THE AIR QUALITY DATA HANDLING SYSTEM USER'S GUIDE (EPA-450/4-79-009, May
1979).
-------
AQDHS-11 USER'S GUIDE
Pen and Ink Changes
Page
J
J
J*
Location
2nd line from
bottom
3rd line from
bottom (AQRPP10)
Last paragraph,
3rd line
Message 027,
'Action' Paragraph
'Parameter Code'
description
Section 4.4.2.5.4,
in the run stream
Last 1ine
'Description1 column
4th line
Message 054, 'Action'
paragraph
3rd line from bottom
Message 005
2nd line
Record position
39
Record position
40
Change
Change 'charcters1 to
'characters'
Change page number from 578 to
478
Replace 'old master' with 'no old
master'
Delete 'Section 4.2.2.8 for a
list of these programs and1
Replace 'modifying them' with
'modifying these programs'
Delete 'Refer to APTD-06331
change 'Volumne1 to 'Volume'
Change 'OLDMSTR' to 'OLDSTAN'
Change 'NEWMSTR1 TO 'NEWSTAN1 .
Delete 'units code1
Change 'maximun' to 'maximum1
Change 'accomodate' to
'accommodate'
Change 'AQEDT10,1 to 'AQEDT10'
Change '005 - CONDITIONAL' to
'005 CONDITIONAL' in message text
Change 'AQ0871 to 'A0871
Change value in 'Field Length1
column from '2' to T
Change value in 'Field Length'
column from blank to '!'
5th line from bottom Change 'Option' to 'Optional1
2nd paragraph,
2nd line
Change 'Figure 6.2.2-b1 to
'Figure 6.2.3-b1
-------
Page
'68
Location
3rd paragraph
J?4
1,276
pi
J20
321
39
421
•J
486
J550
2nd paragraph,
3rd. line
Message 005
1st paragraph,
3rd line from bottom
Message 009, 'Action'
paragraph, 1st line
Section 5.4.2.7,
1st line
Last line
Last line
Last line
Section 5.5.3.4,
Message 001
1st paragraph,
1st line
Section 5.7.1.1,
2nd line
Section 5.7.1.1,
3rd line
Section 6.2.5.5.4,
in the run stream
2nd paragraph,
1st line
10th line from
bottom
1st line
Change
Qnange 'Section 5.5.2' to
'Section 5.2.2'
.Change 'Section 5.5.31 to
"^Section 5.2.3'
>Cnange 'Section 5.6.2' to
'Section 6.2.3'
Change '5.3.1.3' to '5.3.2.3'
Delete the word 'KEY' in the
message text
Replace 'less than1 with 'less
than or equal to1
Change 'questioning* to
'question1
Change 'An run' to 'A run'
Change '5.4.2-b1 to '5.4.2-b.'
Change '5.4.2-b' to
'5.4.2-b - continued.1
Change 'AppendixD' to 'AEROS
Manual Series, Volume III:
Summary and Retrieval1
Change 'RECORDS - OUTPUT1 to
'RECORDS; OUTPUT1
Change 'the the' to 'the1
Change 'link-edits' to 'link
edits1
Change 'program ARTGENR1 to
'program, ARTGENR'
Change 'PRMSTOS1 to 'STANFIL1
Change 'user specified* to
'user-specified*
Change '1087' to 'A087'
Change 'UCLR=D4R* to IUCLR=D4R"1
-------
Page
Location
Change
8
18
N/6
671
749
•761
776
x/84
7th line
Figure title
Message 001
Section 7.2.4,
3rd paragraph,
lines 1 and 2
Section 8.2.4.1
next to last line
Section 8.3.3,
1st paragraph,
4th line
Message 001
Message 008
Message 045
Message 054,
'Action' paragraph
Message 005
Message 001
Message 005
Change 'CONVERT. OPTION1 to
'CONVERT. OPTIONS'
Change 'Figure 6.4.5-b' to
'Figure 6.4.5-a1
Delete the period at the end of
the message
Change 'AQSMERG' to 'AMSMERG'
Change 'program/level' to
'version/level'
Change 'can be is found' to
'can be found'
Change 'RECORDS - OUTPUT1 to
'RECORDS; OUTPUT1
Delete 'IS' from message
Change 'END OF DAY -' to 'END OF
DAY) -' in the message
Change 'Accomodate' to
'Accommodate1
Change '005 - CONDITIONAL1 to
'005 CONDITIONAL' in the message
Delete the period at the end of
the message
Delete 'KEY' in the message
-------
EPA-450/4-79-009
The Air Quality Data
Handling System User's Guide
by
Larry R. McMaster, Project Leader
Research Triangle Institute
Research Triangle Park, North Carolina 27709
Contract No. 68-02-3011
EPA Project Officer: Lloyd M. Hedgepeth
Prepared for
U.S. ENVIRONMENTAL PROTECTION AGENCY
Office of Air, Noise, and Radiation
Office of Air Quality Planning and Standards
Research Triangle Park, North Carolina 27711
May 1979
-------
This report is issued by the Environmental Protection Agency to report
technical data of interest to a limited number of readers. Copies are
available free of charge to Federal employees, current contractors and
grantees, and nonprofit organizations - in limited quantities - from the
Library Services Office (MD-35), U.S. Environmental Protection Agency,
Research Triangle Park, North Carolina 27711;or for a nominal fee,
from the National Technical Information Service, 5285 Port Royal Road,
Springfield,Virginia 22I6I.
This report was furnished to the Environmental Protection Agency by
The Research Triangle Institute, Research Triangle Park, N.C. 27709,
in fulfillment of Contract No. 68-02-3011. The contents of this report are
reproduced herein as received from The Research Triangle Institute. The
opinions, findings, and conclusions expressed are those of the author and
not necessarily those of the Environmental Protection Agency. Mention of
company or product names is not to be considered as an endorsement by
the Environmental Protection Agency.
Publication No. EPA-450/4-79-009
-------
AQDHS-II
TABLE OF CONTENTS
Page 1
Release Date: 4/30/79
Update #: 24
TABLE OF CONTENTS
LIST OF FIGURES xix
LIST OF TABLES xxxi
ACKNOWLEDGEMENT xxxii
1.0 INTRODUCTION 1
1.1 Organization 1
1.2 Definition of Terms and Conventions 9
2.0 OVERVIEW OF AQDHS-II 26
2.1 Introduction 26
2.2 Program Structure 28
2.3 System Charts 30
3.0 ECONOMICS 34
3.1 Economy Measures 34
4.0 FILE CREATION AND MAINTENANCE 36
4.1 Introduction 36
4.1.1 Parameter File Creation and Maintenance 36
4.1.2 Site File Creation and Maintenance 37
4.1.3 Parameter Standards File Creation and Maintenance ... 38
4.1.4 Master File Creation and Maintenance 39
4.2 Parameter File 46
4.2.1 Parameter File Transaction Sort Program -
ASRPARM (AQ0150) 46
4.2.1.1 Description 46
4.2.1.2 File Formats 46
4.2.1.3 Options 46
4.2.1.4 Error Messages 46
4.2.1.5 Cataloged JCL 47
4.2.1.6 Warnings and Special Instructions 47
4.2.1.7 Cost Considerations 47
4.2.1.8 Related Programs and Procedures 48
4.2.2 Parameter File Maintenance Program - AEMPARM (AQ0070) . 51
4.2.2.1 Description 51
4.2.2.2 File Formats .' 52
iii
-------
AQDHS-II
TABLE OF CONTENTS
Page 2
Release Date: 4/30/79
Update #: 24
4.2.2.3 Options 53
4.2.2.4 Error Messages 53
4.2.2.5 Cataloged JCL 60
4.2.2.5.1 JCL Listing 60
4.2.2.5.2 Cross-reference of DD Names
and Files 60
4.2.2.5.3 User-supplied JCL 61
4.2.2.5.4 Sample Run Stream 61
4.2.2.6 Warnings and Special Instructions 62
4.2.2.7 Cost Considerations 63
4.2.2.8 Related Programs and Procedures 63
4.3 Site File 79
4.3.1 Site File Transaction Sort Program - ASRSITE (AQ0160) . 79
4.3.1.1 Description 79
4.3.1.2 File Formats 79
4.3.1.3 Options 79
4.3.1.4 Error Messages 79
4.3.1.5 Cataloged JCL 80
4.3.1.6 Warnings and Special Instructions 80
4.3.1.7 Cost Considerations 80
4.3.1.8 Related Programs and Procedures 80
4.3.2 Site File Maintenance Program - AEMSITE (AQ0080). ... 84
4.3.2.1 Description 84
4.3.2.2 File Formats 84
4.3.2.3 Options 85
4.3.2.4 Error Messages 85
4.3.2.5 Cataloged JCL 86
4.3.2.5.1 JCL Listing 87
4.3.2.5.2 Cross-reference of DD Names
and Files 87
4.3.2.5.3 User-supplied JCL 87
4.3.2.5.4 Sample Run Stream 87
4.3.2.6 Warnings and Special Instructions 88
4.3.2.7 Cost Considerations 88
4.3.2.8 Related Programs and Procedures 89
4.4. Parameter Standards File 98
4.4.1 Parameter Standards File Transaction Sort Program - OQ
ASRSTND (AQ0170) 98
iv
-------
AQDHS-II
TABLE OF CONTENTS
Page 3
Release Date: 4/30/79
Update I: 24
4.4.1.1 Description .... 98
4.4.1.2 File Formats 98
4.4.1.3 Options 98
4.4.1.4 Error Messages 98
4.4.1.5 Cataloged JCL 99
4.4.1.6 Warnings and Special Instructions 99
4.4.1.7 Cost Considerations 99
4.4.1.8 Related Programs and Procedures 100
4.4.2 Parameter Standards File Maintenance Program -
AEMSTND (AQ0090) 103
4.4.2.1 Description 103
4.4.2.2 File Formats 104
4.4.2.3 Options 105
4.4.2.4 Error Messages 105
4.4.2.5 Cataloged JCL 106
4.4.2.5.1 JCL Listing 106
4.4.2.5.2 Cross-reference of DD Names
and Files 107
4.4.2.5.3 User-supplied JCL 107
4.4.2.5.4 Sample Run Stream 108
4.4.2.6 Warnings and Special Instructions 108
4.4.2.7 Cost Considerations 109
4.4.2.8 Related Programs and Procedures 109
4.5 Master File 120
4.5.1 Master File Transaction Edit Program -
AEDMSTR (AQ0060) 120
4.5.1.1 Description 120
4.5.1.2 File Formats 122
4.5.1.3 Options 123
4.5.1.4 Error Messages 124
4.5.1.5 Cataloged JCL 136
4.5.1.5.1 JCL Listing 136
4.5.1.5.2 Cross-reference of DD Names
and Files 136
4.5.1.5.3 User-supplied JCL 136
4.5.1.5.4 Sample Run Stream 136
4.5.1.6 Warnings and Special Instructions 137
4.5.1.7 Cost Considerations 137
4.5.1.8 Related Programs and Procedures 138
-------
AQDHS-II
TABLE OF CONTENTS
Page 4
Release Date: 4/30/79
Update #: 24
4.5.2 Master File Internal Transaction Sort Program -
ASRINTR (AQ0130) 156
4.5.2.1 Description 156
4.5.2.2 File Formats 156
4.5.2.3 Options 156
4.5.2.4 Error Messages 156
4.5.2.5 Cataloged JCL 157
4.5.2.6 Warnings and Special Instructions 157
4.5.2.7 Cost Considerations 157
4.5.2.8 Related Programs and Procedures 158
4.5.3 Master File Maintenance Program - AFMMSTR (AQ0100). . . 161
4.5.3.1 Description 161
4.5.3.2 File Formats 162
4.5.3.3 Options 163
4.5.3.4 Error Messages 165
4.5.3.5 Cataloged JCL 167
4.5.3.5.1 JCL Listing 167
4.5.3.5.2 Cross-reference of DD Names
and Files ' 168
4.5.3.5.3 User-supplied JCL 168
4.5.3.5.4 Sample Run Stream 168
4.5.3.6 Warnings and Special Instructions 169
4.5.3.7 Cost Considerations 171
4.5.3.8 Related Programs and Procedures 171
4.6 Multi-program Procedures 186
4.6.1 Master File Edit-Maintenance Procedure 186
4.6.1.1 Cataloged JCL 186
4.6.1.1.1 JCL Listing 186
4.6.1.1.2 Cross-reference of DD Names
and Files 186
4.6.1.1.3 User-supplied JCL 187
4.6.1.1.4 Sample Run Stream 187
5.0 DATA ACCESSING AND MANIPULATION 195
5.1 Introduction 195
5.2 Retrieval 196
5.2.1 Introduction ..... 196
5.2.2 Retrieval Language Processor Program -
ARTLNGP (AQ0110) 199
vi
-------
AQDHS-II
TABLE OF CONTENTS
Page 5
Release Date: 4/30/79
Update #: 24
5.2.2.1 Description 199
5.2.2.2 File Formats 199
5.2.2.2.1 AQDHS-II Retrieval Language .... 200
5.2.2.2.2 COBOL Retrievals . 210
5.2.2.2.3 Batched Retrievals 217
5.2.2.3 Options 219
5.2.2.4 Error Messages 219
5.2.2.5 Cataloged JCL 222
5.2.2.5.1 JCL Listing 222
5.2.2.5.2 Cross-reference of DD Names
and Files 223
5.2.2.5.3 User-supplied JCL 223
5.2.2.5.4 Sample Run Stream 223
5.2.2.6 Warnings and Special Instructions 224
5.2.2.7 Cost Considerations 227
5.2.2.8 Related Programs and Procedures 227
5.2.3 Generated Retrieval Program - ARTGENR (AQ0120) .... 253
5.2.3.1 Description 253
5.2.3.2 File Formats 253
5.2.3.3 Options 254
5.2.3.4 Error Messages 254
5.2.3.5 Cataloged JCL 255
5.2.3.5.1 JCL Listing 255
5.2.3.5.2 Cross-reference of DD Names
and Files 255
5.2.3.5.3 User-supplied JCL 255
5.2.3.5.4 Sample Run Stream 255
5.2.3.6 Warnings and Special Instructions 256
5.2.3.7 Cost Considerations 256
5.2.3.8 Related Programs and Procedures 257
5.3 Statistical Analysis 263
5.3.1 Introduction 263
5.3.1.1 Statistical Analysis Report 263
5.3.1.2 Sliding Average Report 266
5.3.2 Preliminary Statistics Program - ASTPRLM (AQ0190) ... 273
5.3.2.1 Description 273
5.3.2.2 File Formats 274
vii ~~V
-------
AQDHS-II
TABLE OF CONTENTS
Page 6
Release Date: 4/30/79
Update #: 24
5.3.2.3 Options 275
5.3.2.4 Error Messages 275
5.3.2.5 Cataloged JCL 277
5.3.2.6 Warnings and Special Instructions 277
5.3.2.7 Cost Considerations 278
5.3.2.8 Related Programs and Procedures 278
5.3.3 Statistical Analysis Program - ASTMSST (AQ0200) .... 282
5.3.3.1 Description 282
5.3.3.2 File Formats 285
5.3.3.3 Options 285
5.3.3.4 Error Messages 285
5.3.3.5 Cataloged JCL 287
5.3.3.6 Warnings and Special Instructions 287
5.3.3.7 Cost Considerations 288
5.3.3.8 Related Programs and Procedures 288
5.3.4 Sliding Average Program - ASTSLAV (AQ0180) 290
5.3.4.1 Description 290
5.3.4.2 File Formats 293
5.3.4.3 Options . 294
5.3.4.4 Error Messages 295
5.3.4.5 Cataloged JCL 297
5.3.4.5.1 JCL Listing 297
5.3.4.5.2 Cross-reference of DD Names
and Files 297
5.3.4.5.3 User-supplied JCL 298
5.3.4.5.4 Sample Run Stream 298
5.3.4.6 Warnings and Special Instructions 299
5.3.4.7 Cost Considerations 299
5.3.4.8 Related Programs and Procedures 300
5.4 AQDHS-II Master File Archival and Merging 311
5.4.1 Introduction 311
5.4.2 Master File Merge Program - AMSMERG (AQ0210) 315
5.4.2.1 Description 315
5.4.2.2 File Formats 315
5.4.2.3 Options 315
5.4.2.4 Error Messages 315
5.4.2.5 Cataloged JCL 316
5.4.2.5.1 JCL Listing 316
5.4.2.5.2 Cross-reference of DD Names
and Files 316
viii
-------
AQDHS-II
TABLE OF CONTENTS
Page 7
Release Date: 4/30/79
Update #: 24
5.4.2.5.3 User-supplied JCL 317
5.4.2.5.4 Sample Run Stream 317
5.4.2.6 Warnings and Special Instructions 317
5.4.2.7 Cost Considerations 317
5.4.2.8 Related Progams and Procedures 318
5.4.3 Master File Archival Program - AMSARCH (AQ0215) .... 323
5.4.3.1 Description 323
5.4.3.2 File Formats 323
5.4.3.3 Options 323
5.4.3.4 Error Messages 324
5.4.3.5 Cataloged JCL 324
5.4.3.5.1 JCL Listing 324
5.4.3.5.2 Cross-reference of DD Names
and Files 324
5.4.3.5.3 User-supplied JCL 324
5.4.3.5.4 Sample Run Stream 325
5.4.3.6 Warnings and Special Instructions 325
5.4.3.7 Cost Considerations 325
5.4.3.8 Related Programs and Procedures 326
5.5 File Conversion 333
5.5.1 Introduction 333
5.5.2 SAROAD to AQDHS-II Conversion Program -
ACVSARD (AQ0010) 339
5.5.2.1 Description 339
5.5.2.2 File Formats 339
5.5.2.3 Options 340
5.5.2.4 Error Messages 341
5.5.2.5 Cataloged JCL 342
5.5.2.5.1 JCL Listing 342
5.5.2.5.2 Cross-reference of DD Names
and Files 343
5.5.2.5.3 User-supplied JCL 343
5.5.2.5.4 Sample Run Stream 343
5.5.2.6 Warnings and Special Instructions 344
5.5.2.7 Cost Considerations 345
5.5.2.8 Related Programs and Procedures 345
5.5.3 Master File COBOL to FORTRAN Format Conversion
Program - ACVMFOR (AQ0020) 360
5.5.3.1 Description 360
ix
-------
AQDHS-II
TABLE OF CONTENTS
Page 8
Release Date: 4/30/79
Update f: 24
5.5.3.2 File Formats 360
5.5.3.3 Options 361
5.5.3.4 Error Messages 361
5.5.3.5 Cataloged JCL 361
5.5.3.5.1 JCL Listing 361
5.5.3.5.2 Cross-reference of DD Names
and Files 361
5.5.3.5.3 User-supplied JCL 362
5.5.3.5.4 Sample Run Stream 362
5.5.3.6 Warnings and Special Instructions 362
5.5.3.7 Cost Considerations 362
5.5.3.8 Related Programs and Procedures 363
5.5.4 Parameter File COBOL to FORTRAN Format Conversion
Program - ACVPFOR (AQ0030) 369
5.5.4.1 Description 369
5.5.4.2 File Formats 369
5.5.4.3 Options ..... 370
5.5.4.4 Error Messages . 370
5.5.4.5 Cataloged JCL 370
5.5.4.5.1 JCL Listing 370
5.5.4.5.2 Cross-reference of DD Names
and Files 370
5.5.4.5.3 User-supplied JCL 371
5.5.4.5.4 Sample Run Stream 371
5.5.4.6 Warnings and Special Instructions 371
5.5.4.7 Cost Considerations 371
5.5.4.8 Related Programs and Procedures 372
5.5.5 Anomaly Screening Master File Conversion Program -
ACVANOM (AQ0040) 377
5.5.5.1 Description 377
5.5.5.2 File Formats 379
5.5.5.3 Options 380
5.5.5.4 Error Messages 381
5.5.5.5 Cataloged JCL 383
5.5.5.6 Warnings and Special Instructions 383
5.5.5.7 Cost Considerations 385
5.5.5.8 Related Programs and Procedures 385
5.5.6 Units Code Conversion Program - ACVUNIT (AQ0050) ... 392
5.5.6.1 Description 392
5.5.6.2 File Formats 392
-------
AQDHS-II
TABLE OF CONTENTS
Page 9
Release Date: 4/30/79
Update #: 24
5.5.6.3 Options 393
5.5.6.4 Error Messages 394
5.5.6.5 Cataloged JCL 395
5.5.6.5.1 JCL Listing 396
5.5.6.5.2 Cross-reference of DD Names
and Files 396
5.5.6.5.3 User-supplied JCL 396
5.5.6.5.4 Sample Run Stream 396
5.5.6.6 Warnings and Special Instructions 397
5.5.6.7 Cost Considerations 397
5.6 Master File Sorting 404
5.6.1 Introduction 404
5.6.2 Master File Sort Program - ASRMSTR (AQ0140) 407
5.6.2.1 Description 407
5.6.2.2 File Formats 407
5.6.2.3 Options 408
5.6.2.4 Error Messages 409
5.6.2.5 Cataloged JCL 409
5.6.2.5.1 JCL Listing 409
5.6.2.5.2 Cross-reference of DD Names
and Files 409
5.6.2.5.3 User-supplied JCL 409
5.6.2.5.4 Sample Run Stream 410
5.6.2.6 Warnings and Special Instructions 410
5.6.2.7 Cost Considerations 411
5.6.2.8 Related Programs and Procedures 411
5.7 Multi-program Procedures . 421
5.7.1 Retrieval Procedure - AQRTM10 421
5.7.1.1 Cataloged JCL 421
5.7.1.1.1 JCL Listing 421
5.7.1.1.2 Cross-reference of DD Names
and Files 421
5.7.1.1.3 User-supplied JCL 422
5.7.1.1.4 Sample Run Stream 422
6.0 REPORTS 428
6.1 Introduction 428
6.2 File Listings . .' 429
-------
AQDHS-II
TABLE OF CONTENTS
Page 10
Release Date: 4/30/79
Update #: 24
6.2.1 Introduction 429
6.2.2 Master File Formatted Dump Program -
ARPDUMP (AQ0310) 437
6.2.2.1 Description 437
6.2.2.2 File Formats 437
6.2.2.3 Options 437
6.2.2.4 Error Messages 438
6.2.2.5 Cataloged JCL 438
6.2.2.5.1 JCL Listing 438
6.2.2.5.2 Cross-reference of DD Names
and Files 438
6.2.2.5.3 User-supplied JCL 438
6.2.2.5.4 Sample Run Stream 438
6.2.2.6 Warnings and Special Instructions 439
6.2.2.7 Cost Considerations 439
6.2.3 Master File Detailed Report Program -
ARPMSTR (AQ0230) 445
6.2.3.1 Description 445
6.2.3.2 File Formats 446
6.2.3.3 Options 446
6.2.3.4 Error Messages 448
6.2.3.5 Cataloged JCL 452
6.2.3.5.1 JCL Listing 452
6.2.3.5.2 Cross-reference of DD Names
and Files 452
6.2.3.5.3 User-supplied JCL 453
6.2.3.5.4 Sample Run Stream 453
6.2.3.6 Warnings and Special Instructions 454
6.2.3.7 Cost Considerations 455
6.2.3.8 Related Programs and Procedures 456
6.2.4 Parameter File Detailed Report Program -
ARPPARM (AQ0240) 478
6.2.4.1 Description 478
6.2.4.2 File Formats 478
6.2.4.3 Options 478
6.2.4.4 Error Messages 478
6.2.4.5 Cataloged JCL 478
6.2.4.5.1 JCL Listing 478
6.2.4.5.2 Cross-reference of DD Names
and Files 479
6.2.4.5.3 User-supplied JCL 479
xii
-------
AQDHS-II
TABLE OF CONTENTS
Page 11
Release Date: 4/30/79
Update #: 24
6.2.4.5.4 Sample Run Stream 479
6.2.4.6 Warnings and Special Instructions 479
6.2.4.7 Cost Considerations 479
6.2.4.8 Related Programs and Procedures 480
6.2.5 Parameter Standards File Detailed Report Program -
ARPSTND (AQ0250) 485
6.2.5.1 Description 485
6.2.5.2 File Formats 485
6.2.5.3 Options 485
6.2.5.4 Error Messages 485
6.2.5.5 Cataloged JCL 485
6.2.5.5.1 JCL Listing 486
6.2.5.5.2 Cross-reference of DD Names
and Files 486
6.2.5.5.3 User-supplied JCL 486
6.2.5.5.4 Sample Run Stream 486
6.2.5.6 Warnings and Special Instructions 486
6.2.5.7 Cost Considerations 487
6.2.5.8 Related Programs and Procedures 487
6.2.6 Site File Detailed Report Program -
ARPSITE (AQ0260) 492
6.2.6.1 Description 492
6.2.6.2 File Formats 492
6.2.6.3 Options 492
6.2.6.4 Error Messages 492
6.2.6.5 Cataloged JCL 492
6.2.6.5.1 JCL Listing 492
6.2.6.5.2 Cross-reference of DD Names
and Files 493
6.2.6.5.3 User-supplied JCL 493
6.2.6.5.4 Sample Run Stream 493
6.2.6.6 Warnings and Special Instructions 493
6.2.6.7 Cost Considerations 494
6.2.6.8 Related Programs and Procedures 494
6.3 EPA-Required Reports 499
6.3.1 Introduction 499
6.3.2 AQDHS-II to SAROAD Conversion Program -
ARPSARD (AQ0220) 501
6.3.2.1 Description 501
xi i i
-------
AQDHS-II
TABLE OF CONTENTS
Page 12
Release Date: 4/30/79
Update #: 24
6.3.2.2 File Formats 502
6.3.2.3 Options 503
6.3.2.4 Error Messages 503
6.3.2.5 Cataloged JCL 503
6.3.2.5.1 JCL Listing 503
6.3.2.5.2 Cross-reference of DD Names
and Files 504
6.3.2.5.3 User-supplied JCL 504
6.3.2.5.4 Sample Run Stream 504
6.3.2.6 Warnings and Special Instructions 505
6.3.2.7 Cost Considerations 505
6.3.2.8 Related Programs and Procedures 506
6.4 Summary Reports 514
6.4.1 Introduction 514
6.4.1.1 Statistical Reports 514
6.4.1.2 Anomaly Screening Report 514
6.4.1.3 Inventory by Site and Inventory
by Pollutant Reports 516
6.4.1.4 Master File Summary Report 517
6.4.1.5 Parameter Exception and Site
Exception Reports 518
6.4.2 Statistical Report Program - ARPMSST (AQ0270) 525
6.4.2.1 Description 525
6.4.2.2 File Formats 525
6.4.2.3 Options 526
6.4.2.4 Error Messages 526
6.4.2.5 Cataloged JCL 529
6.4.2.5.1 JCL Listing 529
6.4.2.5.2 Cross-reference of DD Names
and Files 529
6.4.2*5.3 User-supplied JCL 530
6.4.2.5.4 Sample Run Stream 531
6.4.2.6 Warnings and Special Instructions 533
6.4.2.7 Cost Considerations 533
6.4.2.8 Related Programs and Procedures 533
6.4.3 Anomaly Screening Report Program - ARPANOM (AQ0320) . . 547
6.4.3.1 Description 547
6.4.3.2 File Formats 550
6.4.3.3 Options 553
xiv
-------
AQDHS-II
TABLE OF CONTENTS
Page 13
Release Date: 4/30/79
Update #: 24
6.4.3.4 Error Messages 554
6.4.3.5 Cataloged JCL 555
6.4.3.5.1 JCL Listing 556
6.4.3.5.2 Cross-reference of DD Names
and Files 556
6.4.3.5.3 User-supplied JCL 557
6.4.3.5.4 Sample Run Stream 557
6.4.3.6 Warnings and Special Instructions 558
6.4.3.7 Cost Considerations 560
6.4.3.8 Related Programs and Procedures 560
6.4.4 Inventory by Site Report Program - ARPINVS (AQ0280) . . 575
6.4.4.1 Description 575
6.4.4.2 File Formats 575
6.4.4.3 Options 575
6.4.4.4 Error Messages 576
6.4.4.5 Cataloged JCL 577
6.4.4.5.1 JCL Listing 577
6.4.4.5.2 Cross-reference of DD Names
and Files 577
6.4.4.5.3 User-supplied JCL 578
6.4.4.5.4 Sample Run Stream 578
6.4.4.6 Warnings and Special Instructions 578
6.4.4.7 Cost Considerations 578
6.4.4.8 Related Programs and Procedures ....... 579
6.4.5 Inventory by Pollutant Report Program -
ARPINVP (AQ0290) 587
6.4.5.1 Description 587
6.4.5.2 File Formats 587
6.4.5.3 Options 587
6.4.5.4 Error Messages 588
6.4.5.5 Cataloged JCL 589
6.4.5.5.1 JCL Listing 589
6.4.5.5.2 Cross-reference of DD Names
and Files 589
6.4.5.5.3 User-supplied JCL 590
6.4.5.5.4 Sample Run Stream 590
6.4.5.6 Warnings and Special Instructions 590
6.4.5.7 Cost Considerations 591
xv
-------
AQDHS-II
TABLE OF CONTENTS
Page 14
Release Date: 4/30/79
Update #: 24
6.4.6 Master File Summary Report Program - ARPMSBR (AQ0300) . 598
6.4.6.1 Description 598
6.4.6.2 File Formats 598
6.4.6.3 Options 598
6.4.6.4 Error Messages 598
6.4.6.5 Cataloged JCL 598
6.4.6.5.1 JCL Listing 599
6.4.6.5.2 Cross-reference of DD Names
and Files 599
6.4.6.5.3 User-supplied JCL 599
6.4.6.5.4 Sample Run Stream 599
6.4.6.6 Warnings and Special Instructions 599
6.4.6.7 Cost Considerations 600
6.4.6.8 Related Programs and Procedures 600
6.4.7 Parameter Exception Report Program - ARPPMEX (AQ0330) . 606
6.4.7.1 Description 606
6.4.7.2 File Formats 606
6.4.7.3 Options 607
6.4.7.4 Error Messages 607
6.4.7.5 Cataloged JCL 608
6.4.7.5.1 JCL Listing 608
6.4.7.5.2 Cross-reference of DD Names
and Files 608
6.4.7.5.3 User-supplied JCL 609
6.4.7.5.4 Sample Run Stream 609
6.4.7.6 Warnings and Special Instructions 609
6.4.7.7 Cost Considerations 610
6.4.7.8 Related Programs and Procedures 610
6.4.8 Site Exception Report Program - ARPSMEX (AQ0340) ... 617
6.4.8.1 Description 617
6.4.8.2 File Formats 617
6.4.8.3 Options 618
6.4.8.4 Error Messages 618
6.4.8.5 Cataloged JCL 619
6.4.8.5.1 JCL Listing 620
6.4.8.5.2 Cross-reference of DD Names
and Files 620
6.4.8.5.3 User-supplied JCL 620
6.4.8.5.4 Sample Run Stream 620
xv i
-------
AQDHS-II
TABLE OF CONTENTS
Page 15
Release Date: 4/30/79
Update #: 24
6.4.8.6 Warnings and Special Instructions 621
6.4.8.7 Cost Considerations 621
6.4.8.8 Related Programs and Procedures 622
7.0 INTER-FUNCTIONAL PROCEDURES 630
7.1 Introduction 630
7.2 Examples 631
7.2.1 Retrieval and Conversion to SAROAD Transactions ... 631
7.2.2 Retrieval and Anomaly Screening 631
7.2.3 Archival and Merging 632
7.2.4 Retrieval from Two Files, Merging, and Inventory
by Pollutant 633
7.2.5 Retrieval, Conversion to User Units Code, and
Detailed Report 634
7.2.6 Sliding Retrieval, Sliding Average Calculation,
and Sliding Average Report 635
7.2.7 Batched Retrieval, Sort, and Statistical Analysis . . 636
7.2.8 Retrieval and Detailed Report 637
7.2.9 Retrieval, Sort, and Statistical Analysis 638
7.2.10 SAROAD to AQDHS-II Conversion and Master File
Maintenance 639
8.0 JCL AND GENERAL TOPICS 653
8.1 IBM JCL 653
8.1.1 Introduction 653
8.1.2 JOB Card 654
8.1.3 EXEC Card 654
8.1.4 DD Card 655
8.1.5 Special JCL Cards 656
8.1.6 Cataloged Procedures 656
8.2 Updates 665
8.2.1 Introduction 665
8.2.2 General Update Information 665
8.2.2.1 Update Numbers 665
8.2.2.2 Update Packages 666
8.2.3 Update Installation 667
8.2.3.1 IBM Utility IEBUPDTE 667
8.2.3.2 Run Stream for IEBUPDTE 669
8.2.3.3 Non-IEBUPDTE Updates 670
8.2.4 Compiling Updated Programs 670
xv ii
-------
AQDHS-II
TABLE OF CONTENTS
Page 16
Release Date: 4/30/79
Update #: 24
8.2.4.1 Cataloged JCL (AQCLC10) 671
8.2.4.1.1 JCL Listing 671
8.2.4.1.2 User-supplied JCL 671
8.2.4.1.3 Sample Run Stream 671
8.2.4.2 Cataloged JCL (AQCLF10) 672
8.2.4.2.1 JCL Listing 672
8.2.4.2.2 User-supplied JCL . . 672
8.2.4.2.3 Sample Run Stream 672
8.2.5 Testing Modifications 672
8.2.6 Cost Considerations 673
8.2.7 Warnings and Special Instructions 674
8.3 Installation of AQDHS-II 706
8.3.1 Introduction 706
8.3.2 Initial Preparation 706
8.3.3 Installation Job Execution 707
8.3.4 Program Modification 708
8.3.5 Procedure Modification 708
8.3.6 Compiling Programs 710
8.3.7 Testing the System 710
8.3.8 Cost Considerations 711
8.3.9 Warnings and Special Instructions . 712
APPENDIX A: CODE TABLES 726
APPENDIX B: ERROR MESSAGES 734
APPENDIX C: PROGRAM TABLE MODIFICATION 788
APPENDIX D: SAMPLE LOAD SHEETS 814
APPENDIX E: AQDHS-II FILE SPECIFICATIONS 823
INDEX 839
REFERENCES 857
xvm
-------
AQDHS-II
TABLE OF CONTENTS
Page 17
Release Date: 5/01/80
Update #: 27
6.4.7.5.1 JCL Listing 608
6.4.7.5.2 Cross-reference of DD Names
and Files 608
6.4.7.5.3 User-supplied JCL 609
6.4.7.5.4 Sample Run Stream 609
6.4.7.6 Warnings and Special Instructions 609
6.4.7.7 Cost Considerations 610
6.4.7.8 Related Programs and Procedures 610
6.4.8 Site Exception Report Program - ARPSMEX (AQ0340) . . 617
6.4.8.1 Description 617
6.4.8.2 File Formats 617
6.4.8.3 Options 618
6.4.8.4 Error Messages 618
6.4.8.5 Cataloged JCL 619
6.4.8.^1 JC . Listing 620
6.4.8.:. n Cross-reference of DD Names
and Files 620
6.4.8.5.^ User-supplied JCL 620
6.4.8.5.4 Sample Run Stream 620
6.4.8.6 Warnings and Special Instructions 621
6.4.8.7 Cost Considerations 621
6.4.8.8 Related Programs and Procedures 622
6.4.9 Violations of Standards Report Program -
ARPVSTD (AQ0350) 629.1
6.4.9.1 Description 629.1
6.4.9.2 File Formats 629.4
6.4.9.3 Options 629.4
6.4.9.4 Error Messages 629.7
6.4.9.5 Cataloged JCL 629.15
6.4.9.5.1 JCL Listing 629.15
6.4.9.5.2 Cross-reference of DD Names
and Files 629.16
6.4.9.5.3 User-supplied JCL 629.16
6.4.9.5.4 Sample Run Stream 629.16
6.4.9.6 Warnings and Special Instructions 629.18
6.4.9.7 Cost Considerations 629.20
6.4.9.8 Related Programs and Procedures 629.20
xix
-------
AQDHS-II
FABLE OF CONTENTS
Page 18
Release Date: 10/31/81
llndat.p »-. 29
6.5 SLAMS Report .... 629.29
6.5.1 Introduction 629.29
6.5.2 SLAMS Retrieval Program - ARTSLAM (A00375) 629.33
6.5.2.1 Description 629.33
6.5.2.2 File Formats 629.33
6.5.2.3 Options 629.34
6.5.2.4 Error Messages 629.35
6.5.2.5 Cataloged JCL . 620.37
6.5.2.6 Warnings and Special Instructions 629.37
6.5.2.7 Cost Considerations . . ....... 629.38
6.5.2.8 Related Programs and Procedures 629.39
6.5.3. SLAMS Statistical Analysis Program -
ASTSLAM (AQ0380) 629.43
6.5.3.1 Description 629.43
6.5.3.2 File Formats 629.47
6.5.3.3 Options . 629.47
6.5.3.4 Error Messages 629.47
6.5.3.5 Cataloged JCL . . 620.48
6.5.?.6 Warnings and Special Instructions 629.48
6.5.7.7 Cost Considerations 629.48
6.5.3.8 Related Programs and Procedures ... 629.48
6.5.4 SLAMS Report Program - APPSLAM (AQ0390) 629.50
6.5.A.I Description 629.50
6.5.4.2 File Formats 629.50
6.5.4.3 Options 629.52
6.5.1.4 Error Messages 629.52
6.5.4.5 Cataloged JCL 629.54
6.5.4.5.1 JCL Listing 629.55
6.5.4.5.2 Cross-reference of DD
Names and Files 629.55
6.5.4.5.3 User-supplied JCL 629.56
6.5.4.5.4 Sample Run Stream 629.56
6.5.2.6 Warnings and Special Instructions 629.57
6.5.2.7 Cost Considerations 629.58
6.5.2.8 Related Programs and Procedures 629.58
xx
-------
AQDHS-II
TABLE OF CONTENTS
Page 19
Release Date: 10/31/81
Update #: 29
6.6 Standards Report 629.95
6.6.1 Introduction 629.95
6.6.2 Standards Retrieval Program - ARTSTDS (AQ0400) 629.99
6.6.2.1 Description 629.99
6.6.2.2 File Formats 629.99
6.6.2.3 Options 629.100
6.6.2.4 Error Messages 629.101
6.6.2.5 Cataloged JCL 620.103
6.6.2.6 Warnings and Special Instructions 629.104
6.6.2.7 Cost Considerations 629.105
6.6.2.8 Related Programs and Procedures 629.105
6.6.3 Standards Statistical Analysis Program -
ASTSTDS (AQ0410) 629.109
6.6.3.1 Description 629.109
6.6.3.2 File Formats 629.116
6.6.3.3 Options 629.116
6.6.3.4 Error Messa s 629.117
6.6.3.5 Cataloged <,'(' 629.119
6.6.3.6 Warnings and Special Instructions 629.119
6.6.3.7 Cost Considerations 629.120
6.6.3.8 Related Programs and Procedures 629.120
6.6.4 Standards Report Program - ARPSTDS (AQ0420) 629.122
6.6.4.1 Description 629.122
6.6.4.2 File Formats 629.123
6.6.4.3 Options 629.124
6.6.4.4 Error Messages 629.124
6.6.4.5 Cataloged JCL . 629.127
6.6.4.5.1 JCL Listing 629.128
6.6.4.5.2 Cross-reference of DD
Names and Files 629.128
6.6.4.5.3 User-supplied JCL 629.129
6.6.4.5.4 Sample Run Stream 629.129
6.6.4.6 Warnings and Special Instructions 629.130
6.6.4.7 Cost Considerations 629.131
6.6.4.8 Related Programs and Procedures 629.132
xx. 1
-------
AQDHS-II
TABLE OF CONTENTS
Page 20
Release Date: 10/31/81
Update #: 29
This page left blank intentionally.
xx. 2
-------
AQDHS-II
TABLE OF CONTENTS
Page 21
Release Date: 5/01/81
Update #: 28
7.0 INTER-FUNCTIONAL PROCEDURES 630
7.1 Introduction 630
7.2 Examples 631
7.2.1 Retrieval and Conversion to SAROAD Transactions . . . 631
7.2.2 Retrieval and Anomaly Screening 631
7.2.3 Archival and Merging 632
7.2.4 Retrieval from Two Files, Merging, and Inventory
by Pollutant 633
7.2.5 Retrieval, Conversion to User Units Code, and
Detailed Report 634
7.2.6 Sliding Retrieval, Sliding Average Calculation,
and Sliding Average Report 635
7.2.7 Batched Retrieval, Sort, and Statistical Analysis . . 636
7.2.8 Retrieval and Detailed Report 637
7.2.9 Retrieval, Sort, and Statistical Analysis 638
7.2.10 .SAROAD to AQDHS-II Conversion and Master File
Maintenance 639
8.0 JCL AND GENERAL TOPICS 653
8.1 IBM JCL 653
8.1.1 Introduction 653
8.1.2 JOB Card 654
8.1.3 EXEC Card 654
8.1.4 DD Card 655
8.1.5 Special JCL Cards 656
8.1.6 Cataloged Procedures 656
8.2 Updates 665
8.2.1 Introduction 665
8.2.2 General Update Information 665
8.2.2.1 Update Numbers 665
8.2.2.2 Update Packages 666
8.2.3 Update Installation 667
8.2.3.1 IBM Utility IEBUPDTE 667
8.2.3.2 Run Stream for IEBUPDTE 669
8.2.3.3 Non-IEBUPDTE Updates 670
8.2.4 Compiling Updated Programs 670
xxi
-------
AQDHS-II
TABLE OF CONTENTS
Page 22
Release Date: 5/01/8!
Update #: 28
8.2.4.1 Cataloged JCL (AQCLC10) 671
8.2.4.1.1 JCL Listing 671
8.2.4.1.2 User-supplied JCL 671
8.2.4.1.3 Sample Run Stream 671
8.2.4.2 Cataloged JCL (AQCLF10) 672
8.2.4.2.1 JCL Listing 672
8.2.4.2.2 User-supplied JCL ... 672
8.2.4.2.3 Sample Run Stream 672
8.2.5 Testing Modifications 672
8.2.6 Cost Considerations 673
8.2.7 Warnings and Special Instructions . 674
8.3 Installation of AQDHS-II 706
8.3.1 Introduction 706
8.3.2 Initial Preparation 706
8.3.3 Installation Job Execution 707
8.3.4 Program Modification ....... 708
8.3.5 Procedure Modification 708
8.3.6 Compiling Programs 710
8.3.7 Testing the System 710
8.3.8 Cost Considerations 711
8.3.9 Warnings and Special Instructions 712
8.4 Deleting and Uncataloging Data Sets 725.1
8.4.1 Introduction 725.1
8.4.2 Procedure AQUDD10 725.1
8.4.3 Procedure AQDLD10 725.2
8.4.4 Procedure AQUCD10 725.2
APPENDIX A: CODE TABLES 726
APPENDIX B: ERROR MESSAGES 734
APPENDIX C: PROGRAM TABLE MODIFICATION 738
APPENDIX D: SAMPLE LOAD SHEETS 766
APPENDIX E: AQDHS-II FILE SPECIFICATIONS 775
xxi i
-------
AQDHS-II
LIST OF FIGURES
Page 5
Release Date: 4/30/79
Update: I 24
Figure
Number
5.4.2-c
5.4.3-a
5.4.3-b
5.4.3-c
5.4.3-d
5.5.1-a
5.5.1-b
5.5.1-c
5.5.2-a
5.5.2-b
5.5.2-c
5.5.2-d
5.5.2-e
5.5.2-f
5.5.2-g
5.5.3-a
5.5.3-b
5.5.3-c
5.5.3-d
5.5.4-a
5.5.4-b
5.5.4-c
Title
Page
Number
Substltutable Parameters for AQMSM10 322
Diagnostic Report 327
Option Card Format 328
Cataloged Procedure AQMSM20 329
Substltutable Parameters for AQMSM20 331
Master File COBOL to FORTRAN Format Conversion
Flowchart 336
Parameter File COBOL to FORTRAN Format Conversion
Flowchart 337
Units Code Conversion Flowchart 338
SAROAD Transaction Formats 346
Description of SAROAD Transaction Fields 350
Action Card Format . 355
Option Card Format 356
Diagnostic Report 357
Cataloged Procedure AQCVT10 358
Substltutable Parameters for AQCVT10 359
FORTRAN-compatible Record Format 364
Diagnostic Report 365
Cataloged Procedure AQCVM10 366
Substltutable Parameters for AQCVM10 368
Format of the Converted Parameter File 373
Diagnostic Report 374
Cataloged Procedure AQCVP10 375
xxi11
-------
AQDHS-II
LIST OF FIGURES
Page 6
Release Date: 4/30/79
Update: # 24
Figure Title Page
Number Number
5.5.4-d Substitutable Parameters for AQCVP10 376
5.5.5-a Categories of Data Subjected to Anomaly Screening
Tests 386
5.5.5-b Status Flags for Records, AQDHS-II Master File . . 387
5.5.5-c Status Flags for Readings, AQDHS-II Master File . 388
5.5.5-d Nominal Values for Categories of Data to be
Screened for Anomalies 389
5.5.5-e Diagnostic Report 390
5.5.5-f Format for the Option Card for ACVANOM (AQ0040) . 391
5.5.6-a Option Card Format 399
5.5.6-b Diagnostic Report 400
5.5.6-c Cataloged Procedure AQCVM20 401
5.5.6-d Substitutable Parameters for AQCVM20 403
5.6.1-a Master File Sort Flowchart 406
5.6.2-a Diagnostic Report 412
5.6.2-b Option Card Format 413
5.6.2-c Sort Sequence for BATCH Option 414
5.6.2-d Sort Sequence for PARM Option 415
5.6.2-e Sort Sequence for SITE or STAT 416
5.6.2-f Sort Sequence for STND Option 417
5.6.2-g Cataloged Procedure AQSRM10 418
5.6.2-h Substitutable Parameters for AQSRM10 420
5.7.1-a Cataloged Procedure AQRTM10 423
5.7.1-b Substitutable Parameters for AQRTM10 427
xxiv
-------
AQDHS-II
LIST OF FIGURES
Page 7
Release Date: 4/30/79
Update: # 24
Figure Title Page
Number Number
6.2.1-a Master File Formatted Dump Flowchart 432
6.2.1-b Master File Detailed Report Flowchart 433
6.2.1-c Parameter File Detailed Report Flowchart 434
6.2.1-d Parameter Standards File Detailed Report
Flowchart 435
6.2.1-e Site File Detailed Report Flowchart 436
6.2.2-a Master File Formatted Dump 440
6.2.2-b Option Card Format 442
6.2.2-c Cataloged Procedure AQRPM25 443
6.2.2-d Substitutable Parameters for AQRPM25 444
6.2.3-a Mean Report 457
6.2.3-b Sliding Average Report 470
6.2.3-c Sum Report 472
6.2.3-d Diagnostic Report 473
6.2.3-e Option Card Format 474
6.2.3-f Cataloged Procedure AQRPM20 475
6.2.3-g Substitutable Parameters for AQRPM20 477
6.2.4-a Parameter File Detailed Report 481
6.2.4-b Cataloged Procedure AQRPP10 483
6.2.4-c Substitutable Parameters for AQRPP10 484
6.2.5-a Parameter Standards File Detailed Report 488
6.2.5-b Cataloged Procedure AQRPD10 490
6.2.5-c Substitutable Parameters for AQRPD10 491
6.2.6-a Site File Detailed Report 495
xxv
-------
AQDHS-II
LIST OF FIGURES
Page 8
Release Date: 4/30/79
Update: # 24
Figure
Number
6.2.6-b
6.2.6-c
6.3.1-a
6.3.2-a
6.3.2-b
6.3.2-c
6.3.2-d
6.3.2-e
6.4.1-a
6.4.1-b
6.4.1-c
6.4.1-d
6.4.1-e
6.4.1-f
6.4.2-a
6.4.2-b
6.4.2-c
6.4.2-d
6.4.2-e
6.4.3-a
6.4.3-b
Title
Page
Number
Cataloged Procedure AQRPS10 497
Substltutable Parameters for AQRPS10 498
AQDHS-II to SAROAD Conversion Flowchart 500
Diagnostic Report 507
Sample Transactions 508
Option Card Format 509
Cataloged Procedure AQRPM05 510
Substltutable Parameter for AQRPM05 512
Anomaly Screening Flowchart 519
Inventory by Site Report Flowchart 520
Inventory by Pollutant Report Flowchart 521
Master File Summary Report Flowchart 522
Parameter Exception Report Flowchart . 523
Site Exception Report Flowchart 524
Examples of the Statistical Analysis
Report with Full Option 534
Option Card Format 539
Example of Statistical Analysis
Report with Brief Option 540
Cataloged Procedure AQRPM10 541
Substitutable Parameters for AQRPM10 545
Categories of Data to be Subjected to Anomaly
Screening Tests 561
Test Values for the Maximum Value Test 562
xxvi
-------
AQDHS-II
LIST OF FIGURES
Page 9
Release Date: 4/30/79
Update: # 24
Figure Title Page
Number Number
6.4.3-c Test Values for the Adjacent Hourly Difference
Test 563
6.4.3-d Test Values for the Spike Test 564
6.4.3-e Shewhart Test Coefficients " 565
6.4.3-f Diagnostic Report 566
6.4.3-g Anomaly Screening Report for Hourly Readings ... 567
6.4.3-h Anomaly Screening Report for Daily Readings ... 568
6.4.3-i Record Format for Skeleton Transactions from
ARPANOM (AQ0320) 569
6.4.3-j Cataloged Procedure AQRPM45 570
6.4.3-k Substitutable Parameters for AQRPM45 573
i
6.4.4-a Inventory by Site Report 580
6.4.4-b Cataloged Procedure AQRPM35 583
6.4.4-c Substitutable Parameters for AQRPM35 586
6.4.5-a Inventory by Pollutant Report 592
6.4.5-b Cataloged Procedure AQRPM40 594
6.4.5-c Substitutable Parameters for AQRPM40 597
6.4.6-a Master File Summary Report 601
6.4.6-b Diagnostic Report 603
6.4.6-c Cataloged Procedure AQRPM30 604
6.4.7-c Diagnostic Report .613
6.4.7-c Cataloged Procedure AQRPP20 614
6.4.7-e Substitutable Parameters for AQRPP20 616
6.4.8-a Site Exception Report 623
xxvii
-------
AQDHS-II
LIST OF FIGURES
Page 10
Release Date: 4/30/79
Update: # 24
Figure
Number
Title
Page
Number
6.4.8-b
6.4.8-c
6.4.8-d
6.4.8-e
6.4.8-f
7.2-a
7.2-b
7.2-c
7.2-d
7.2-e
7.2-f
7.2-g
7.2-h
7.2-1
7.2-j
7.2-k
7.2-1
8.1-a
8.1-b
8.1-c
8.1-d
8.2-a
Site File Skeleton Transaction Format 624
Diagnostic Report 625
Option Card 626
Cataloged Procedure AQRPS20 627
Substltutable Parameters for AQRPS20 629
Example 7.2.1 - Run Stream 640
Example 7.2.2 - Run Stream 642
Example 7.2.2 - COBOL Copy Member
COPYEXM2 643
Example 7.2.3 - Run Stream 644
Example 7.2.4 - Run Stream 645
Example 7.2.5 - Run Stream 646
Example 7.2.6 - Run Stream 647
Example 7.2.7 - Run Stream 648
Example 7.2.8 - Run Stream 649
Example 7.2.8 - COBOL Copy members 650
Example 7.2.9 - Run Stream 651
Example 7.2.10 - Run Stream 652
General Format of JCL Statement 658
JOB Card Format 659
JOB Card Information Fields 660
DD Card Field Specification 661
Sample Update Message 676
xxv HI
-------
AQDHS-II
LIST OF FIGURES
Page 11
Release Date: 4/30/79
Update: # 24
Figure
Number
8.2-b
8.2-c
8.2-d
8.2-e
8.2-f
8.2-g
8.2-h
8.2-1
8.2-j
8.2-k
8.2-1
8.2-m
8.2-n
8.2-0
8.2-p
8.2-q
8.2-r
8.3-a
8.3-b
8.3-c
8.3-d
8.3-e
Title
Page
Number
IEBUPDTE Output - Program Listing 677
Update Letter 679
Update Packing List 684
Update Verification Form 685
Tape Contents 686
Checklist for Installing Update 687
Listing of Update Deck 688
Condition Codes for IEBUPDTE 689
Message Indicating Completion of
IEBUPDTE Modification 690
Condition Codes for Compiler and Linkage Editor . 691
Error Messages from Compiler 693
Linkage Editor Message 694
Compiler Version Message 695
Cataloged Procedure AQCLC10 696
Substltutable Parameters for AQCLC10 699
Cataloged Procedure AQCLF10 701
Substltutable Parameters for AQCLF10 704
Checklist for Installing AQDHS-II 713
Installation Letter 714
AQDHS-II Installation Deck Listing 718
System Status/Hardware/Software Questionnaire . . 721
Condition Code for IEHMOVE 725
xxix
-------
AQDHS-II
LIST OF FIGURES
Page 12
Release Date: 4/30/79
Update: # 24
Figure
Number
Title
Page
Number
E-l
E-2
Sample Job Stream to Reblock a Permanent
or FORTRAN-Compatible AQDHS-II File Stored
on Disk 837
Sample Job Stream to Reblock on AQDHS-II
Program Source Module Library 838
xxx
-------
AQDHS-II
LIST OF TABLES
Page 1
Release Date: 4/30/79
Update: # 24
Table
Number
A-l
A-2
A-3
A-4
A-5
A-6
E-l
E-2
LIST OF TABLES
Title
Agency Codes
Project Codes
Time Codes
Units Codes
Valid Negative Value Parameters . . .
Maximum Values for Parameters ....
Cross-Reference of Files and Programs
Blocking Factors of AQDHS-II Files .
Page
Number
728
729
730
731
732
733
825
832
xxxi
-------
AQDHS-II
ACKNOWLEDGEMENT
Page 1
Release Date: 4/30/79
Update #: 24
ACKNOWLEDGEMENT
This manual was prepared by the Research Triangle Institute, Research
Triangle Park, North Carolina, for the Environmental Protection Agency (EPA)
under-Contract 68-02-3011. The work has been conducted under the direction of
Mr. Lloyd M. Hedgepeth of the National Air Data Branch (NADB), who is the EPA
Project Officer for the contract.
_;RTI staff members principally participating in the development of this
document are:
R. C. Haws, Laboratory Supervisor
L. R. McMaster, Project Leader
D. L. Franke, Analyst/Programmer
D. E. Warren, Analyst/Programmer
W. M. Bailey, Programmer
F. A. Farmer, Programmer
K. C. Ng, Programmer
C. 0. Scheper, Programmer
A. F. Tallant, Programmer
H. B. Ashmore, Technical Writer/Editor
D. J. Adams, Secretary
E. A. Hamilton, Secretary
N. L. Kuzil, Secretary
C. S. Lenco, Secretary
D. H. Rachal, Secretary
xxxn
-------
AQDHS-II
LIST OF FIGURES
Page 11
Release Date: 10/31/81
Update #: 29
Figure
Number
6.4.9-g
6.5.1-a
6.5.2-a
6.5.2-b
6.5.2-c
6.5.3-a
6.5.4-a
6.5.4-b
6.5.4-c
6.5.4-d
6.5.4-e
6.5.4-f
6.6.1-a
6.6.2-a
6.6.2-b
6.6.2-c
6.6.3-a
6.6.4-a
6.6.4-b
6.6.4-c
6.6.4-d
6.6.4-e
7.2-a
7.2-b
7.2-c
7.2-d
Title
Page
Number
Substitutable Parameters for AQRPM50 629.28
SLAMS Report System Flowchart 629.31
Categories of Data Retrieved by ARTSLAM
(AQ0375) 629.40
Diagnostic Report 629.41
Option Card Format for ARTSLAM (AQ0375) 629.42.
Diagnostic Report 629.49
SLAMS Transaction Formats 629.59
Sample SLAMS Report 629.67
Diagnostic Report 629.86
Option Card 629.87
Cataloged Procedure /*qRPM55 . . . 629.88
Substitutable ' ram^ters for AQRPM55 629.92
Standards Repor System Flowchart 629.97
Categories of Data Retrieved by ARTSTDS
(AQ0400) 629.106
Diagnostic Report 629.107
Option Card Format for ARTSTDS (AQ0400) 629.108
Diagnostic Report . 629.121
Sample Standards Report 629.133
Diagnostic Report 629.149
Option Card 629.150
Cataloged Procedure AQRPM60 629.151
Substitutable Parameters for AQRPM60 629.155
Example 7.2.1 - Run Stream 640
Example 7.2.2 - Run Stream 642
Example 7.2.2 - Copy Member 643
Example 7.2.3 - Run Stream 644
xxxii
-------
AQDHS-II
LIST OF FIGURES
Page 12
Release Date: 5/01/80
Update #: 27
7.2-e
7.2-f
7.2-g
7.2-h
7.2-1
7.2-j
7.2-k.
7.2-1
8.1-a
8.1-b
8.1-c
8.1-d
8.2-a
8.2-b
8.2-c
8.2-d
8.2-e
8.2-f
8.2-g
8.2-h
8.2-i
8.2-j
8.2-k
8.2-1
8.2-m
8.2-n
8.2-0
8.2-p
8.2-q
8.2-r
Example 7.2.4 - Run Stream 645
Example 7.2.5 - Run Stream 646
Example 7.2.6 - Run Stream 647
Example 7.2.7 - Run Stream ...... 648
Example 7.2.8 - Run Stream 649
Example 7.2.8 - Copy Members 650
Example 7.2.9 - Run Stream 651
Example 7.2.10 - Run Stream 652
General Format of JCL Statement . 658
JOB Card Format 659
JOB Card Information Fields 660
DD Card Field Specification 661
Sample Update Message . 676
IEBUPDTE Output - Program Listing 677
Update Letter 679
Update Packing Form 684
Update Verification Form 685
Tape Contents 686
Checklist for Installing Update 687
Listing of Update Deck 688
Condition Codes for IEBUPDTE 689
Message Indicating Completion of Modification . . 690
Condition Codes for Compiler and Linkage Editor . 691
Error Messages from Compiler 693
Linkage Editor Message 694
Compiler Version Message .... 695
Cataloged Procedure AQCLC10 696
Substitutable Parameters for AQCLC10 699
Cataloged Procedure AQCLF10 701
Substitutable Parameters for AQCLF10 704
xxxi v
-------
AQDHS-II
LIST OF FIGURES
Page 13
Release Date: 5/01/80
Update #: 27
Figure
Number
8.3-a
8.3-b
8.3-c
8.3-d
8.3-e
8.4-a
8.4-b
8.4-c
B-l
E-l
E-2
Title
Page
Number
Checklist for Installing AQDHS-II 713
Installation Letter 714
AQDHS-II Installation Deck Listing 718
System Status/Hardware/Software Questionnaire . . 721
Condition Code for IEHMOVE 725
Cataloged Procedure AQUDD10 725.4
Cataloged Procedure AQDLD10 725.5
Cataloged Procedure AQUCD10. . 725.6
References for Error Messages 736
Sample job Stream to Reblock a Permanent
or FORTRAN-Compatible AQDHS-II File Stored
on Disk. .. 789
Sample Job Stn n ti Reblock an AQDHS-II
Program Source . >dule Library 790
xxxiv.l
-------
AQDHS-II
LIST OF FIGURES
Page 14
Release Date: 10/31/81
Update #: 29
This page left blank intentionally.
xxxiv.2
-------
AQDHS-II
INTRODUCTION
SECTION 1.1
ORGANIZATION
Page 1
Release Date: 4/30/79
Update #: 24
1.0 INTRODUCTION
1.1 ORGANIZATION
The major functions of the AQDHS-II subsystem are creating and
maintaining a valid data base, accessing and manipulating that data base, and
producing reports. This User's Guide is structured to reflect these
functions, i.e., the programs and procedures in AQDHS-II are documented within
these three groupings. The discussions of the AQDHS-II functions and programs
comprise Section 4.0 FILE CREATION AND MAINTENANCE, Section 5.0 DATA ACCESSING
AND MANIPULATION, and Section 6.0 REPORTS.
Each of these sections contains an introduction which explains the
particular function and operating instructions for each of the programs which
comprise that function. Flow charts illustrating the operation of the
programs are included in each introduction. The program operating
instructions consist of a description of the program, the formats of the files
accessed by the program, a discussion of program options, and a list of error
messages produced by the program. A discussion of the JCL for executing the
program, warnings and special instructions, cost estimates, and related
programs and procedures are also included.
The programs discussed in Sections 5.0 and 6.0 are grouped into
categories according to the specific aspect of the major function which they
perform. The categories addressed in Section 5.0 DATA ACCESSING AND
MANIPILATION are retrieval, statistical analysis, master file archival and
merging, file conversion, and master file sorting. The categories comprising
Section 6.0 REPORTS are file listings, EPA-required reports, and summary
reports.
In addition to these program sections, this User's Guide includes
sections which provide information necessary for full utilization of AQDHS-II.
Section 2.0 OVERVIEW OF AQDHS-II provides a brief discussion of the subsystem,
explains the program design, and provides a system flowchart. Section 3.0
ECONOMICS discusses the cost of installing and operating AQDHS-II as well as
-------
AQDHS-II
INTRODUCTION
SECTION 1.1
ORGANIZATION
Page 2
Release Date: 4/30/79
Update #: .24
ways to reduce these costs. Section 7.0 INTER-FUNCTIONAL PROCEDURES describes
sample run streams which execute programs from more than one functional area,
such as producing a report from a retrieved answer file. Section 8.0 JCL AND
GENERAL TOPICS discusses the IBM JCL used in the AQDHS-II cataloged procedures
and explains the installation and updating processes. Additional information
concerning the operation of AQDHS-II is included in the five appendices. An
index is provided to aid the user in finding all the information contained in
the User's Guide.
Seven-letter names are used for all programs in AQDHS-II. The first
position contains an 'A1 for AQDHS-II, positions 2 and 3 contain a function
indicator (see Figure 1.1-a), and positions 4 thru 7 contain information
relating to the file used or type of report. Each program is also assigned a
program number prefixed by 'AQ'. See Figure 1.1-b for a list of program
names, numbers, and descriptions.
The cataloged procedures all have seven-character names. The first two
characters are 'AQ1, then positions 3 and 4 contain the function indicators
(See Figure 1.1-a), position 5 provides information on the file used (See
Figure 1.1-c), and the last two cjior^ters- are numeric. See Figure 1.1-d for a
list of procedures.
-------
AQDHS-II
INTRODUCTION
SECTION 1.1
ORGANIZATION
Page 3
Release Date: 4/30/79
Update #: 24
Code
CV
CE
ED
EM
FM
MS
RP
RT
SR
ST
Description
Conversion
Conversion and Edit
Edit
Edit Maintenance
File Maintenance
Miscellaneous
Report
Retrieval
Sort
Statistical
Figure 1.1-a. Function Indicators
-------
AQDHS-II
INTRODUCTION
pfia°rm
ACVANOM
ACVMFOR
ACVPFOR
ACVSARD
ACVUNIT
AEDMSTR
AEMPARM
AEMSITE
AEMSTND
AFMMSTR
AMSARCH
AMSMERG
ARPANOM
ARPDUMP
ARPINVP
ARPINVS
ARPMSBR
ARPMSST
ARPMSTR
ARPPARM
Program
Numoer
AQ0040
AQ0020
AQ0030
AQ0010
AQ0050
AQ0060
AQ0070
AQ0080
AQ0090
AQ0100
AQ0215
AQ0210
AQ0320
AQ0310
AQ0290
AQ0280
AQ0300
AQ0270
AQ0230
AQ0240
SECTION 1.1
ORGANIZATION
Description
Anomaly Screening Master File
Conversion
Master File COBOL to FORTRAN
Format Conversion
Parameter File COBOL to
FORTRAN Format Conversion
SAROAD to AQDHS-II Conversion
Units Code Conversion
Master File Transaction Edit
Parameter File Maintenance
Site File Maintenance
Parameter Standards File
Maintenance
Master File Maintenance
Master File Archival
Master File Merge
Anomaly Screening Report
Master File Formatted Dump
Inventory by Pollutant Report
Inventory by Site Report
Master File Summary Report
Statistical Report
Master File Detailed Report
Page 4
Release Date:
Update #: 24
Reference
5.5.5
5.5.3
5.5.4
5.5.2
5.5.6
4.5.1
4.2.2
4.3.2
4.4.2
4.5.3
5.4.3
5.4.2
6.4.3
6.2.2
6.4.5
6.4.4
6.4.6
6.4.2
6.2.3
Parameter File Detailed Report 6.2.4
4/30/79
.Page
Number
377
360
369
339
392
120
51
84
103
161
323
315
547
437
587
575
598
525
445
478
(page 1 of 2)
Figure 1.1-b. AQDHS-II Programs
-------
AQDHS-II
INTRODUCTION
Program
Name
ARPPMEX
ARPSARD
ARPSITE
ARPSLAM
ARPSMEX
ARPSTDS
ARPSTND
ARPVSTD
ARTGENR
ARTLNGP
ARTSLAM
ARTSTDS
ASRINTR
ASRMSTR
ASRPARM
ASRSITE
ASRSTFL
ASRSTND
ASRTRAN
ASTMSST
ASTPRLM
ASTSLAM
ASTSLAV
ASTSTDS
Program
Number
AQ0330
AQ0220
AQ0260
AQ0390
AQ0340
AQ0420
AQ0250
AQ0350
AQ0120
AQ0110
AQ0375
AQ0400
AQ0130
AQ0140
AQ0150
AQ0160
AQ0360
AQ0170
AQ0370
AQ0200
AQ0190
AQ0380
AQ0180
AQ0410
Figure
SECTION 1.1
ORGANIZATION
Description
Parameter Exception Report
AQDHS-II to SAROAD Conversion
Site File Detailed Report
SLAMS Report
Site Exception Report
Standards Report
Parameter Standards File
Detailed Report
Page 5
Release Date:
Update #: 29
Reference
6.4.7
6.3.2
6.2.6
6.5.4
6.4.8
6.6.4
6.2.5
Violations of Standards Report 6.4.9
Generated Retrieval Program
Retrieval Language Processor
SLAMS Retrieval
Standa 5 Retrieval
Master 'le Internal
Transact! on Sort
Master File Sort
5.2.3
5.2.2
6.5.2
6.6.2
4.5.2
5.6.2
Parameter File Transaction Sort 4.2.1
Site File Transaction Sort
Site File Sort
Parameter Standards File
Transaction Sort
Master File Input Transaction
Sort
Statistical Analysis
Preliminary Statistics
SLAMS Statistical Analysis
SI iding Average
Standards Statistical Analysis
4.3.1
5.6.3
4.4.1
4.5.4
5.3.3
5.3.2
6.5.3
5.3.4
6.6.3
(page 2 of
10/31/81
Page
Number
606
501
492
629.50
617
629.122
485
629.1
253
199
629.33
629.99
156
407
46
79
420.1
98
185.1
282
273
629.43
290
629.109
2)
1.1-b - continued. AQDHS-II Programs
-------
AQDHS-II
INTRODUCTION
SECTION 1.1
ORGANIZATION
Page 6
Release Date: 4/30/79
Update #: 24
Code
D
M
P
S
T
File
Parameter Standards File
Master File
Parameter File
Site File
Transaction
Figure 1.1-c. File Code
-------
AQDHS-II
INTRODUCTION
Procedure
AQCLC10
AQCLF10
AQCVM10
AQCVM20
AQCVP10
AQCVT10
AQDLD10
AQEDT10
AQEMD10
AQEMM10
AQEMP10
AQEMS10
AQFMM10
AQMSM10
AQMSM20
AQRPD10
AQRPM05
AQRPM10
AQRPM20
AQRPM25
AQRPM30
AQRPM35
AQRPM40
AQRPM45
AQRPM50
AQRPM55
AQRPM60
SECTION 1.1
ORGANIZATION
Description
Cobol Compiler and Linkage Editor
Fortran Compiler and Linkage Editor
Master File COBOL to FORTRAN Format
Conversion
Units Code Conversion
Parameter File COBOL to FORTRAN Format
Conversion
SAROAD to AQDHS-II Conversion
Data Set Deletion
Master File Transaction Edit
Parameter Standards File Maintenance
Master File Edit Maintenance
Parameter File Maintenance
Site File Maintena .e
Master File Mainte nee
Master File Merge
Master File Archival
Parameter Standards File Detailed Report
AQDHS-II to SAROAD Conversion
Statistical Analysis Report
Master File Detailed Report
Master File Formatted Dump
Master File Summary Report
Inventory by Site Report
Inventory by Pollutant Report
Anomaly Screening Report
Violations of Standards Report
SLAMS Report
Standards Report
Page 7
Release Date: 10/31/81
Update #: 29
Page
Reference Number
8.2.4.1 671
8.2.4.2 672
5.5.3.5 361
5.5.6.5 395
5.5.4.5 370
5.5.2.5 342
8.4.3 725.5
4.5.1.5 136
4.4.2.5 106
4.6.1 186
4.2.2.5 60
4.3.2.5 86
4.5.3.5 167
5.4.2.5 316
5.4.3.5 324
6.2.5.5 485
6.3.2.5 503
6.4.2.5 529
6.2.3.5 452
6.2.2.5 438
6.4.6.5 598
6.4.4.5 577
6.4.5.5 589
6.4.3.5 555
6.4.9.5 629.15
6.5.4.5 629.54
6.6.4.5 629.127
(page 1 of 2)
Figure 1.1-d. AQDHS-II Cataloged Procedures
7
-------
AQDHS-II
INTRODUCTION
Procedure
AQRPP10
AQRPP20
AQRPS10
AQRPS20
AQRTM10
AQRTM20
AQRTM30
AQSRM10
AQSRS10
AQSTM20
AQUCD10
AQUDD10
SECTION 1.1
ORGANIZATION
Page 8
Release Date: 5/01/80
Update #: 27
Page
Description Reference Number
Parameter File Detailed Report
Parameter Exception Report
Site File Detailed Report
Site Exception Report
Retrieval
Retrieval (Generate and Store Program)
Retrieval (Execute Stored Program)
Master File Sort
Site File Sort
Sliding Average
Data Set Uncataloging
Data Set Uncataloging and Deletion
6.2.4.5 478
6.4.7.5 608
6.2.6.5 492
6.4.8.5 619
5.7.1 421
5.2.2.5 222
5.2.3.5 255
5.6.2.5 409
5.6.3.5 420.2
5.3.4.5 297
8.4.4 725.6
8.4.2 725.4
(page 2 of 2)
Figure 1.1-d - continued. AQDHS-II Cataloged Procedures
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 1
Release Date: 4/30/79
Update #: 24
1.2 DEFINITIONS OF TERMS AND CONVENTIONS
ABORT:
The termination of a job due to a malfunction. Any condition that causes
an abort error message in any of the AQDHS-II programs will cause the
execution of that program to be terminated immediately but will allow
any successive programs in the same run stream to be executed; however,
the results of any such programs are probably invalid. Programs may also
abort with a system error message. In this case, no successive programs
will be executed.
Action Code:
An AQDHS-II master file field. See Figure 4.5.1-b and Section 4.5.3.2
for a complete description. Also a parameter file transaction field
(see Figure 4.2.2-b).
Agency Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
ANS (ANSI):
An acronym for the American Rational Standards institute, which
establishes the standards for the COBOL and FORTRAN languages.
Answer File: '
A file that is either (1) produced by a (non-batched) retrieval without
the SLIDING option and is a subset of the records on the master file, (2)
produced by a set of batched retrievals without the SLIDING option and is
a group of subsets of the records in the master file, or (3) produced by
the units code conversion program and consists of records from the master
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 2
Release Date: 4/30/79
Update #: 24
file with readings expressed in different units than in the master file.
An answer file may be input to any program that uses the master file for
the purpose of generating reports; however, an answer file may contain
duplicate records and may not be in the normal master file order. See
Sections 5.2, 5.5.6, and 5.6. Note: an answer file should not replace
the master file for file maintenance purposes. Also, see sliding average
answer file and standard answer file.
AQDHS-II:
The Mr Duality Data JJandl ing System is a sub-system of CDHS. It
provides a systematic method for collecting large volumes of atmospheric
pollution data and storing it in a data base that will provide a central
source for the information.
AQCR Code:
The Mr Duality Control Region is an AQDHS-II master file field. See
Figure 4.5.1-b for a complete description.
Area Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Baseline:
A version of the AQDHS-II system maintained by NADB. All installation
and update copies are made from the baseline. If local modifications
are made to AQDHS-II, it is recommended that a copy of the baseline be
maintained. Only the baseline AQDHS-II is supported by NADB.
Batched Retrievals:
When more than one retrieval is processed in one execution of the
AQDHS-II retrieval programs, the retrievals are said to be batched.
10
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 3
Release Date: 4/30/79
Update #: 24
Block:
A group of records handled by the computer as a single unit. The size
of a block should be set to take best advantage of the size of a track
if the file is to be stored on disk.
Blocking Factor:
The number of records in a block. Information on the blocking factors
for the files in the AQDHS-II system can be found in Appendix E.
Card:
A punched card used to enter data into the computer. The 80-column card
is used for AQDHS-II. Each column of a card is used to enter a single
numeric or alphabetic character and one card is used for a single
transaction. Transactions may be entered by other methods that do not
use cards, but the term card is still used to denote a transaction.
Catalog:
A table of descriptive information for files, such as unit, volume, and
DCB information, which is maintained by the computer. A cataloged data
set may be used by specifying its name and disposition.
Cataloged data set:
A data set that has been listed in the system catalog of files. Items
such as unit, volume, and DCB information for the data set are contained
in the system catalog.
CDHS:
Comprehensive Data Dandling _System (CDHS) is comprised of AQDHS-II and
EIS/P&R (^mission _I/wentory _Sys tern/Permits and Registration).
11
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 4
Release Date: 4/30/79
Update #: 24
COBOL:
An acronym for jCOmmon Business JDriented Language. It is an
internationally accepted programming language used for systems which
handle large data bases. The statements are English-like but must comply
with rules established for the language. A majority of the programs in
AQDHS-II are written in COBOL.
Composite Data:
Records containing information resulting from analyses of a solution
containing a number of individual samples that have been chemically
combined. Used for hi-vol particulate functions.
Composite Number of Samples:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Composite Period:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Composite Time Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Composite Type:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Compile:
To create an object module from source language statements by means of a
compiler. While some compilers generate object modules which contain
machine code that can be executed directly, most generate code which must
12
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 5
Release Date: 4/30/79
Update #: 24
be further processed by a linkage editor to produce an executable load
module. In most AQDHS-II installations, the linkage editor is used.
CONDITIONAL:
A type of error message generated by programs in AQDHS-II. Conditional
errors are not serious enough to cause rejection of the input data,
however the message cannot be suppressed.
Control Card:
A card entered to provide specific instructions to a program. Used
interchangeably with option card.
County Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Cylinder:
Used in allocating space on a direct access device (disk). As a unit of
measure, it contains several tracks, the exact number being dependent
upon the type of disk.
Data:
A general term used to describe the elements of information that can be
processed by a computer. Data is used to describe all the information
collected and stored for AQDHS-II.
Data-field:
Used in AQDHS-II to signify a reading. See Reading.
Data Set:
A file used by the computer. Data sets may be stored on disks or tapes.
Partitioned data sets are used as libraries to store a collection of
programs or procedures.
13
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 6
Release Date: 4/30/79
Update #: 24
Day:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Decimal Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Deck:
A collection or pack of punched cards. The cards necessary to run a job,
including JCL, option cards, and transactions, form a deck.
Diagnostic Report:
A report printed during the execution of most programs in AQDHS-II. The
report contains the update messages, information on the options used for
the program, messages explaining errors encountered during the execution
of the program, and run statistics indicating the number of records pro-
cessed and the number of errors found. Those AQDHS-II programs that do
not produce a separate diagnostic report contain the information normally
included in a diagnostic report at the beginning and end of other printed
output.
DISASTER:
A type of error message printed by AQDHS-II programs. Execution of the
program will be terminated immediately when a disaster condition is
encountered, but other programs in the same run stream will be executed
and produce unpredictable results. The user should contact NADB for
information on recovering from a disaster condition.
Disk:
A flat circular plate upon which data may be stored by a magnetic
process. Also may be called a magnetic disk. In large computer systems,
14
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 7
Release Date: 4/30/79
Update #: 24
one or more magnetic disks are mounted on a spindle and form a disk pack.
Each disk is divided conceptually into tracks, and tracks are combined
into cylinders. Space may be allocated by tracks or cylinders. A disk
is a direct access device.
Error Message:
In AQDHS-II, the term is used two ways. First, it is used as a general
term to include all types (WARNING, CONDITIONAL, ERROR, ABORT, and
DISASTER) of messages printed when an error is encountered by a program.
Further information on errors can be found in Appendix B. Secondly, it
refers specifically to messages prefaced by the word ERROR which
indicate that input data has been rejected due to the error found, but
that processing will continue.
Execute:
To perform the operations specified by a particular program or
procedure.
Field:
A subdivision of a record containing a particular item of data.
Generally, several characters of information are grouped together to form
a field. Examples of fields in AQDHS-II include state code,
parameter code, and start hour.
File:
An organized collection of related records. One or more files may be on
a tape or a disk. The records in a file are usually sequenced by some
key contained in the records. Files may be stored for future use
(permanent) or used by only one job (temporary). Permanent files used by
AQDHS-II include the master file, the parameter file, the site file, and
the parameter standards file.
15
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 8
Release Date: 4/30/79
Update #: 24
Form Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Format:
A specified or predetermined arrangement of data on a record or document
synonymous with layout. Formats given for the files in AQDHS-II include
the position, length, and description of each field.
FORTRAN:
Acronym for FORmula TRANslator. A programming language designed
primarily for the solution of mathematical and scientific problems. Used
in AQDHS-II for programs which calculate statistical information such as
standard deviation and geometric mean.
Hardware:
The physical equipment making up a computer system. Hardware includes
printers, disk and tape drives, terminals, and the central processing
unit of a computer.
Installation:
Two definitions are used by AQDHS-II. The first pertains to the initial
preparation needed when setting up the AQDHS-II system for the first
time. The second refers to a particular computer system, the people who
operate and use it, the work it does, and the place where it is located.
Internal Transaction:
A record created by the master file transaction edit program and used by
the master file maintenance program to update the master file. These
records are not 80 columns in length and are not interchangeable with
punched cards used to enter transactions.
16
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 9
Release Date: 4/30/79
Update #: .24
JCL:
Job Control Language. A programming language used to identify a job and
describe its requirements to the operating system. Information on JCL
can be found in Section 8.1.
Job:
A unit of work entered into the computer by means of a single run stream
containing a single job card. A job consists of one or more procedures
or programs.
Key:
One or more fields within a record used to identify or control that
record. Keys are used by AQDHS-II both to sequence files and to
match transactions with file records when updating a file.
Library:
An organized set of programs or files. In AQDHS-II, partitioned data
sets are used as libraries to store source programs, load modules, and
procedures.
Link Edit:
To combine object modules into an executable load module. In AQDHS-II,
all programs are link edited after being compiled, and the resulting load
modules are stored in a load library.
Load Module:
The output of a linkage editor; a program in a suitable form to be loaded
into memory and executed. Load modules are stored in the load library.
Master File:
A file containing the actual air quality data as collected. The master
file is used to generate reports, including sending the required
17
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 10
Release Date: 4/30/79
Update #: 24
quarterly report to SAROAD. File format and field descriptions can be
found in Section 4.5.1.2.
Method Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Module:
A group of records treated as a unit. Often refers to an individual
member of a partitioned data set or library. Each program in AQDHS-II is
stored as a module in both the source and load libraries.
Month:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
NADB:
An acronym for the Rational Air Data JJranch which is in the EPA's Office
of Air Quality Planning and Standards.
Null Reading:
A reading for which no information is known. The position in the.record
for a null reading is filled with 9's; that is, the reading is 9999 with
a decimal code of zero. In the sliding average program, readings of 9998
are generated as null readings and indicate that not enough readings were
present to calculate a sliding average.
Object Module:
A module that is produced by a compiler and input to a linkage editor.
Object modules are not saved in AQDHS-II since the compiler and
linkage editor are executed within one procedure.
18
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 11
Release Date: 4/30/79
Update #: .24
Observation:
Used in AQDHS-II to signify reading. See reading.
Option Card:
A card used to provide instructions to a program. Used interchangeably
with control card. Options are used in AQDHS-II to indicate such things
as whether files should be listed, whether warnings should be printed, or
the number of lines to be printed on a page.
Parameter:
The word has two meanings in AQDHS-II. One refers to a pollutant or
other variable being measured (see Parameter Code). The other definition
is used to refer to certain variables in the cataloged procedures which
may be changed when the procedure is run. These variables are called
substitutable parameters.
Parameter Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Parameter File:
A file containing information on the parameters used by a given AQDHS-II
installation. The file is used for validation and for printing
information on reports. File format and field descriptions can be found
in Section 4.2.2.2.
Parameter Standards File:
A file containing descriptions of standards for the parameters used in
AQDHS-II. The file is used for printing information on reports. File
format and field descriptions can be found in Section 4.4.2.2.
19
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 12
Release Date: 4/30/79
Update #: 24
Partitioned Data Set:
A file containing several individual groups of records. This file can be
used as a whole, or each group of records (module) may be used alone. In
AQDHS-II, partitioned data sets are used as libraries to store the source
programs, the load modules, and the procedures.
Percentile:
A term used in the statistical analysis package which denotes a value for
which a specified pecentage of a group of data fall below or are equal
to that value, e.g., the 30th percentile is a value for which 30% of the
readings are less than or equal to that value.
Permanent File:
A file kept after execution of a job has been completed. Such a file may
be used by later jobs and may be cataloged. Examples of permanent files
in AQDHS-II include the master, parameter, site, and parameter standards
files.
Procedure:
A series of JCL statements used to execute one or more programs. In
AQDHS-II, the procedures are stored and cataloged in a procedure library.
A program may be executed by naming the procedure without supplying all
the required JCL needed for that program.
Program:
A series of statements in a language acceptable by a computer and used to
achieve a specified result.
Project Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
20
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 13
Release Date: 4/30/79
Update #: 24
Reading:
A field in the master file containing the actual value measured for a
given variable. Reading is referred to as DATA-FIELD in the retrieval.
Each record contains from one to thirty-one readings, depending upon the
time code of the record.
Repeating Section:
A portion of each master file record containing the readings and both the
status codes and decimal codes for those readings. The repeating section
is variable in length and may contain from one to thirty-one readings.
Run Stream:
A deck consisting of JCL cards and, possibly, option cards and
transactions used to execute one or more successive procedures.
Generally, a run stream will contain one job.
SAROAD:
Acronym for ^torage And Retrieval Of Aerometric Data. Refers to a
technique for coding air quality data and also a data base maintained by
EPA containing air quality data from the entire United States.
Site Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Site File:
A file containing descriptive information for all sites used by an
AQDHS-II installation. The site file is used for validation and for
report information. The file format and field definitions can be found
in Section 4.3.2.2.
21
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 14
Release Date: 4/30/79
Update #: 24
SLAMS/NAMS ID:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description. Also a site file field (see Figure 4.3.2-a). Also referred
to as SLAMS-ID.
Sliding Average Answer File:
A file created by the retrieval when using the SLIDING option. This
file should only be used as input to the sliding average program, ASTSLAV
(AQ0180).
Sliding Average Value File:
A file created by the sliding average program, ASTSLAV (AQ0180). It
should only be used as input to the master file detailed report program
ARPMSTR (AQ0230).
Software:
All programs which can be used on a particular computer system. Includes
compilers, library routines, and user-written programs.
Source Program or Source Module:
A program written in a programming language that cannot be directly
processed by the computer, but which must be compiled and link edited
prior to being executed. The source programs in AQDHS-II are written in
either COBOL or FORTRAN.
Space:
A variable used in JCL to indicate the amount of room ocupied by a file
on a direct access device (disk). Space is allocated by either tracks or
cylinders.
22
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 15
Release Date: 4/30/79
Update #: 24
Standard Answer File:
A file created by the retrieval without the SLIDING option being
used. Standard answer files may be used for any reports, but should not
replace the master file for file maintenance purposes. Also see Answer
File and Sliding Average Answer File.
Start Hour:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
State:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Status Flag:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Structured Programming:
A coding technique used AQDHS-II.
See Section 2.2.
Substitutable Parameters:
Variables in the AQDHS-II procedures which may change from one run of a
procedure to the next, and which may be changed by specifying keywords
defined in the procedure along with the values to be used. A list of the
substitutable parameters is given with the information on individual
procedures in the user's guide.
Systems Personnel:
People involved with the user support and/or operations for a computer
installation. Systems personnel can supply information, such as disk and
23
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 16
Release Date: 4/30/79
Update #: 24
tape drives used and required account codes, and can give assistance in
correcting system problems.
Tape:
A magnetic film coated with a substance which allows data to be stored by
selective magnetism. Tapes can be used to store files for AQDHS-II. The
user should consult his systems personnel for information on the
characteristics of the tape drives used at his installation.
Temporary File:
A file used during the duration of one job and then discarded. Temporary
files are used to pass data from one program to another within the same
job.
Time Code:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
Top-down:
A term used in structured programming. See Section 2.2.
Track:
A unit of measure for space allocation on a disk. The size of a track is
dependent upon the type of disk used.
Transaction:
A card (or other record) used to enter data into the system. All
transactions are edited by the AQDHS-II programs prior to being used.
Unit:
A term used in JCL to specify the device type used for storing a file.
Values include DISK, TAPE, or specific types of disk or tape.
24
-------
AQDHS-II
INTRODUCTION
SECTION 1.2
DEFINITIONS OF TERMS
AND CONVENTIONS
Page 17
Release Date: 4/30/79
Update #:-24
Update Message:
A portion of the diagnostic report printed at the beginning of the
execution of each program in AQDHS-II. Information given includes the
name, revision level, update status, and update date of the program. The
information is useful for troubleshooting.
Volume:
A recording medium, such as a tape or disk, which is mounted and
dismounted as a unit. A volume is identified by a volume serial number.
WARNING:
A type of error message used in AQDHS-II to inform the user of an aspect
of the input data which may warrant his attention. A warning condition
does not cause data to be rejected nor the execution of the program to be
terminated. Warning messages may be suppressed.
Year:
An AQDHS-II master file field. See Figure 4.5.1-b for a complete
description.
25
-------
AQDHS-II
OVERVIEW OF AQDHS-II
SECTION 2.1
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: 24
2.0 OVERVIEW OF AQDHS-II
2.1 INTRODUCTION
The National Air Data Branch (NADB) of the Environmental Protection
Agency (EPA) has the responsibility of collecting, storing, retrieving, and
analyzing air quality and emissions data for 50 states and 5 territories. In
order to aid the data flow and to assist the states in the monitoring and
control of atmospheric pollution, EPA has developed and provided the
Comprehensive Data Handling System (CDHS).
The purpose of CDHS is to provide the user with a systematic approach to
solving the problem of creating and maintaining files, submitting data to EPA,
doing statistical analysis, and generating internal reports from a large data
base of observed pollutant concentrations or emissions.
CDHS currently consists of two major subsystems: the Emissions Inventory
Subsystem with Permits and Registrations (EIS/P&R) which processes emissions
data, and the Air Quality Data Handling Subsystem (AQDHS-II) which processes
ambient air quality and meteorological data. This User's Guide deals only
with AQDHS-II and is intended to provide the user of AQDHS-II with a usable
day-to-day reference document.
AQDHS-II currently consists of 35 computer programs (33 written in ANS-68
COBOL, 2 written in ANS FORTRAN) which provide the user with a variety of
tools to assist him in the enormous task of organizing, storing, and analyzing
the vast amounts of ambient air quality data collected by him.
26
-------
AQDHS-II
OVERVIEW OF AQDHS-II
SECTION 2.1
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
A discussion of program structure is provided in Section 2.2 and a chart
illustrating the interrelationships of the functional areas in AQDHS-II is
provided in Section 2.3. More detailed flow diagrams of each functional area
and its component programs are provided in the section discussing that
particular function.
27
-------
AQDHS-II
OVERVIEW OF AQDHS-II
SECTION 2.2
PROGRAM STRUCTURE
Page 1
Release Date: 4/30/79
Update #:. 24
2.2 PROGRAM STRUCTURE
The AQDHS-II programs are modularized by function; i.e. each program
performs one complete function. When several functions are needed for a given
process (such as file maintenance), the separate programs that perform the
component functions are performed in a single procedure. This modularization
gives the system greater flexibility. An illustration of this modularity can
be seen in the following example: ASRPARM (AQ0150) sorts parameter file
transactions, AEMPARM (AQ0070) maintains the parameter file, and ARPPARM
(AQ0240) prints the parameter file. The sort and file maintenance programs
are performed by the procedure AQEMP10, and the report by AQRPP10. Both
procedures should be run when the parameter file is updated, but the report
procedure may be run alone whenever a listing of the parameter file is
desired.
All of the programs in AQDHS-II are written using American National
Standard (ANS) COBOL or FORTRAN. An attempt is made to standardize the
programs so that they can be run on a variety of vendor main frames with
minimal changes. Currently, the AQDHS-II system has been installed on
IBM-370, UNIVAC 1100, CDC CYBER, Honeywell 6000, AMDAHL, and ITEL series
computers.
Structured programming techniques have been used in writing the programs;
i.e., the programs are designed using a 'top-down' technique with control
remaining in a short mainline module. The program tasks are accomplished by
self-contained modules performed from the mainline. As a result of this
top-down design, the programs are self-documenting. These structured
techniques are not in themselves of interest to the user, but they do allow
for easier maintenance of the programs when modifications or troubleshooting
support are needed.
Several programs contain COBOL sorts which have been developed so that
the user does not have to code system sort procedures or provide control
cards. The COBOL sort is an ANS structure and should work on most computers;
28
-------
AQDHS-II
OVERVIEW OF AQDHS-II
SECTION 2.2
PROGRAM STRUCTURE
Page 2
Release Date: 4/30/79
Update #: . 24
however, the actual collating sequence used is determined by the default value
of the hardware. As an example, EBCDIC sequence (used on IBM) sorts
alphabetic characters before numeric ones, while ASCII sequence (variations
used by Honeywell, UNIVAC, and CDC) sorts numeric before alphabetic
characters.
29
-------
AQDHS-II
OVERVIEW OF AQDHS-II
SECTION 2.3
SYSTEM CHARTS
Page 1
Release Date: 4/30/79
Update #: 24
2.3 SYSTEM CHARTS
A system-level flowchart of AQDHS-II is shown in Figure 2.3-a. This
flowchart depicts the relationships of the major processing functions of
AQDHS-II. Included in the flowchart are references to sections of this
document that contain detailed information on each processing function. More
detailed flowcharts of each function are presented in the referenced sections.
30
-------
OLD AQDHS-II/ /PARAMETER
FILE
TRANSACTIONS
PARAMETER
FILE
\
OLD AQDHS-I.
SITE
FILE
LZZ
^ SITE
FILE TRANSACTION*
LOLD AQDHS-II /
PARAMETER I
STANDARDS FILE\
PARAMETER
STANDARDS FILE
TRANSACTIONS
PARAMETER
FILE
MAINTENANCE
-
Se<
SITE
FILE
MAINTENANCE
Section 4.1
Section 4.1
AQDHS-II
PARAMETER
FILE
AQDHS-II
SITE
FILE
Figure 2.3-a. AQDHS-II System Flowchart
PARAMETER
STANDARDS
FILE MAINTENANCE
0 3>
< XD
m o
•30 DC
< IS*
1— 1 1
JO
O
oc
co
1
Section 4.1
AQDHS-II
PARAMETER 1
STANDARDS FILE\
co co
-< m
CO O
—I —I
m 1—1
3 i
0
a: ro
70 CO
co
(page 1 of 3)
3D -O
•a n> o»
Q. — • «Q
n> a>
- Oi
n> to ro
a>
=«=
o
Q)
r+
ro a>
CO
CD
-------
SAROAD
TRANSACTIONS
SAROAD TO
AQDHS-II
CONVERSION
Section 5.5.1
CO
ro
' AQ
MAST
TRANS
/ °
AQD
I MAST
DHS-II 7
ER FILE|
ACTIONS\
LD /
HS-II
ER FILEy
/ AQDHS-II
MASTER FILE
TRANSACTIONS
s
AQDHS-II
MASTER FILE
MAINTENANCE
Section 4.1
AQDHS-II
MASTER FILE
/ ,
1 '
RETRIEVAL
\
x^
Section 5
ANSWER
FILE
(page 2 of 3)
Figure 2.3-a - Continued. AQDHS-II System Flowchart
o >
< JO
m o
73 ZC
< in
o
1C
co
CO CO
-< m
to o
3 O
O
3: ro
73 CO
—t
co
T3
Q.
01
c-h
n>
=«=
OJ
o
cu
ro n>
•P* ••
co
o
10
-------
MASTER FILE
ARCHIVAL AND
MERGING
Section
ERA-
REQUIRED
REPORTS
FILE
CONVERSION
5.4
Section 6.3
co
CO
FILE
LISTING
Section 6.2
Section
STATISTICAL
ANALYSIS
5.5
MASTER
FILE
SORTING
Section
Section 5.3
5.6
SUMMARY
REPORTS
Section 6.4
(page 3 of 3)
Figure 2.3-a - Continued. AQDHS-II System Flowchart
o >
< JO
m o
73 1C
< co
co
—I —)
m i—i
3 o
=c ro
TO co
co
TJ
Q.
o>
<-f
n>
O> DJ
—' tQ
n> n>
o>
in -p»
n>
ro ro
CO
o
10
-------
AQDHS-II
ECONOMICS
SECTION 3.1
ECONOMY MEASURES
Page 1
Release Date: 4/30/79
Update #: . 24
3.0 ECONOMICS
3.1 ECONOMY MEASURES
Several steps can be taken to reduce the cost of the AQDHS-II system,
such as keeping the size of the files as small as possible, printing files
only when necessary, storing frequently used retrievals, and updating files
only when a substantial number of transactions are available.
Since the cost of running any program is directly related to the size of
the files processed by that program, the user's files should be as small as
possible. The size can be reduced by archiving static data of the master file
so that the current master file will contain only that data needed for file
maintenance and current reports. See Section 5.4 for information on file
archival. The size of the parameter, site, and parameter standards files can
be controlled by assuring that they contain only information actually in use,
i.e., that they precisely reflect the master file data. Not only are these
auxiliary files read by programs (including the master file edit, AEDMSTR
(AQ0060), and several report programs), but also the data from these files is
stored in tables, which must be large enough to hold an entire file. Since
the amount of core necessary to run a program increases with the size of
these tables, they should be kept as small as possible. The size of the
input master file which is processed by a report program can be reduced
without actually reducing the size of the master file. This can be
accomplished by running the retrieval package prior to generating the report
so that only the desired data is printed. See Section 5.2 for information on
retrievals.
Several programs have a LIST option. This option allows for complete
files to be printed, usually confirmation listings of the input and
output files. Since printing the files does add to the cost of running
these programs, the LIST option should only be used when a listing is
34
-------
AQDHS-II
ECONOMICS
SECTION 3.1
ECONOMY MEASURES
Page 2
Release Date: 4/30/79
Update #: . 24
required; otherwise, the NOLIST option should be used. Some programs,
especially those that edit transactions, also contain a FLAGW option which
causes all warning messages to be printed. Using the NOFLAGW option (and thus
suppressing the warning messages) will reduce the cost of operation.
Another cause of unnecessary cost is running the entire retrieval process
using identical retrieval specifications to retrieve the same data from
different files. If it is known that a retrieval will be executed multiple
times, the load module created in the first execution should be stored. This
allows the retrieval language processor to be bypassed and only the retrieval
itself to be executed. The cataloged procedures AQRTM20 (see Section 5.2.2.5)
and AQRTM30 (Section 5.2.3.5) are provided to facilitate the re-execution of
retrievals.
Another form of unnecessarily repeated program execution is updating the
master file each time transactions are edited. Since a large part of the cost
of updating a file is the actual processing of the file (i.e., reading,
searching, and writing), as many transactions as possible should be entered
in one update run. This can be accomplished by editing the various batches of
transactions as they are coded, saving the resulting internal transactions,
and concatenating them for one execution of file maintenance. The cataloged
procedures AQEDT10 (see Section 4.5.1.5) and AQFMM10 (see Section 4.5.3.5)
provide the means of doing this.
Additional cost considerations are included in the discussions of the
individual AQDHS-II programs. These considerations include the cost of a
sample run of the program and, where applicable, information on how to reduce
costs for running the program.
35
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: 24
4.0 FILE CREATION AND MAINTENANCE
4.1 INTRODUCTION
The primary file in the AQDHS-II system is the master file which contains
the user's ambient air quality data. At a gross level, the function of
AQDHS-II is to place data in the master file and extract data from the master
file (including the very important function of extracting data from the
AQDHS-II master file for submission to SAROAD).
There are three auxiliary files to the master file: the parameter file,
the site file, and the parameter standards file. The auxiliary files are used
primarily in editing the master file transactions and in providing prose
descriptions of parameters, sites, and parameter standards which appear in
various reports. The parameter and site files must be created prior to the
creation of the master file since they supply various edit criteria used in
the verification of master file transactions.
The master file, parameter file, site file, and parameter standards file
are sequential files (i.e., the file records are read sequentially from
beginning to end). The master file contains variable-length records with the
length of each record determined by the number of readings stored in that
record; the three auxiliary files contain fixed-length records.
4.1.1 PARAMETER FILE CREATION AND MAINTENANCE
Two programs must be executed to create or update the parameter file:
the parameter file transaction sort program, ASRPARM (AQ0150), and the
parameter file maintenance program, AEMPARM (AQ0070). Refer to Figure 4.1.1-a
for the parameter file maintenance flowchart.
36
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
ASRPARM (AQ0150) sorts the input parameter file transactions and passes
the sorted transactions to AEMPARM (AQ0070), which edits the sorted
transactions and uses those transactions that pass the edit criteria to create
or update the parameter file. When a parameter file is being created
initially, no old parameter file is input to AEMPARM (AQ0070); however, when
updating an existing parameter file, that file is input to AEMPARM (AQ0070).
AEMPARM (AQ0070) produces the new parameter file and, optionally, listings of
the input transactions, the old parameter file, and the new parameter file.
Both ASRPARM (AQ0150) and AEMPARM (AQ0070) produce a diagnostic report.
Refer to Sections 4.2.1 and 4.2.2 for detailed discussions of ASRPARM
(AQ0150) and AEMPARM (AQ0070), respectively.
ASRPARM (AQ0150) and AEMPARM (AQ0070) may be executed using the cataloged
procedure AQEMP10, which is discussed in Section 4.2.2.5. Examples of job
streams to create and update a parameter file are shown in Section 4.2.2.5.4.
4.1.2 SITE FILE CREATION AND MAINTENANCE
Two programs are executed to create or update the site file: the site
file transaction sort program, ASRSITE (AQ0160); and the site file maintenance
program, AEMSITE (AQ0080). See Figure 4.1.2-a for the site file maintenance
flowchart.
ASRSITE (AQ0160) sorts the input site file transactions and passes the
sorted transactions to AEMSITE (AQ0080). AEMSITE (AQ0080) edits the sorted
transactions and uses those transactions that pass the edit criteria to create
or update the site file. When a site file is being created initially, no old
site file 1s input to AEMSITE (AQ0080); however, when updating an existing
site file, that file is Input to AEMSITE (AQ0080). Both ASRSITE (AQ0160) and
AEMSITE (AQ0080) produce a diagnostic report.
37
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 3
Release Date: 4/30/79
Update #: . 24
Refer to Sections 4.3.1 and 4.3.2 for detailed discussions of ASRSITE
(AQ0160) and AEMSITE (AQ0080), respectively.
ASRSITE (AQ0160) and AEMSITE (AQ0080) may be executed using the cataloged
procedure AQEMS10, which is discussed in Section 4.3.2.5. Examples of job
streams to create and update a site file are shown in Section 4.3.2.5.4.
4.1.3 PARAMETER STANDARDS FILE CREATION AND MAINTENANCE
Two programs are executed to create or update the parameter standards
file: the parameter standards file transaction sort program, ASRSTND (AQ0170),
and the parameter standards file maintenance program AEMSTND (AQ0090). See
Figure 4.1.3-a for the parameter standards file maintenance flowchart.
ASRSTND (AQ0170) sorts the input parameter standards file transactions
and passes the sorted transactions to AEMSTND (AQ0090). AEMSTND (AQ0090)
edits the sorted transactions and uses those transactions that pass the edit
criteria to create or update the parameter standards file. When a parameter
standards file is being created initially, no old parameter standards file is
input to AEMSTND (AQ0090); however, when updating an existing parameter
standards file, that file is input to AEMSTND (AQ0090). Both ASRSTND (AQ0170)
and AEMSTND (AQ0090) produce a diagnostic report.
Refer to Sections 4.4.1 and 4.4.2 for a detailed discussion of ASRSTND
(AQ0170) and AEMSTND (AQ0090), respectively.
ASRSTND (AQ0170) and AEMSTND (AQ0090) may be executed using the cataloged
procedure AQEMD10, which is discussed in Section 4.4.2.5. Examples of job
streams to create and update a parameter standards fi.le are shown in Section
4.4.2.5.4.
38
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 4
Release Date: 4/30/79
Update I: . 24
4.1.4 MASTER FILE CREATION AND MAINTENANCE
The following programs are executed to create or update the master file:
the master file transaction edit program, AEDMSTR (AQ0060); the master file
transaction sort program, ASRINTR (AQ0130); the master file maintenance
program, AFMMSTR (AQ0100); and, possibly, the SAROAD to AQDHS-II conversion
program, ACVSARD (AQ0010). See Figure 4.1.4-a for the master file maintenance
flowchart.
The user may code transactions to enter 1n the AQDHS-II master file 1n
either AQDHS-II format or SAROAD format. If the transactions are coded In
AQDHS-II format, they are Input directly to AEDMSTR (AQ0060) for editing. If
they are coded in SAROAD format, they must be converted to AQDHS-II format by
ACVSARD (AQ0010) prior to being edited by AEDMSTR (AQ0060).
AEDMSTR (AQ0060) edits AQDHS-II format master file transactions; the
parameter and site files are used to verify the parameter and site fields in
the master file transactions. AEDMSTR (AQ0060) converts those transactions
which pass the edit criteria to internal format and passes the internal
transactions to ASRINTR (AQ0130). Optionally, AEDMSTR (AQ0060) produces a
listing of those transactions which pass the edit criteria.
ASRINTR (AQ0130) sorts the internal transactions and passes the sorted
internal transactions to AFMMSTR (AQ0110).
AFMMSTR (AQ0110) processes the sorted internal transactions and uses them
to create or update the master file. When a master file is being created
in1t1ally,^old master file is input to AFMMSTR (AQ0110); however, when
updating an existing master file, that file is input to AFMMSTR (AQ0110).
AFMMSTR (AQ0110) produces the new master file and, optionally, listings of the
input internal transactions and those records in the old and new master files
which were affected by AFMMSTR (AQ0110).
39
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 5
Release Date: 4/30/79
Update #: 24
ACVSARD (AQ0010), AEDMSTR (AQ0060), ASRINTR (AQ0130), and AFMMSTR
(AQ0110) each produce a diagnostic report.
There are two methods which may be used in maintaining the master file.
The user may choose to execute AEDMSTR (AQ0060) repetitively, each time
editing a different set of master file transactions and later merge (or
concatenate) the internal transactions before processing them through
ASRINTR (AQ0130) and AFMMSTR (AQ0110). Or, the user could choose to execute
all file maintenance programs for each set of master file transactions.
Refer to the following sections for a detailed discussion of each of the
master file maintenance programs: ACVSARD (AQ0010), 5.5.2; AEDMSTR (AQ0060),
4.5.1; ASRINTR (AQ0130), 4.5.2; AFMMSTR (AQ0100), 4.5.3.
ACVSARD (AQ0010) may be executed using the cataloged procedure AQCVT10,
which is discussed in Section 5.5.2.5. A sample run stream to convert SAROAD
format transactions to AQDHS-II transactions is shown in Section 5.5.2.5.4.
AEDMSTR (AQ0060) may be executed using the cataloged procedure AQEDT10,
which is discussed in Section 4.5.1.5. ASRINTR (AQ0130) and AFMMSTR (AQ0100)
may be executed using the cataloged procedure AQFMM10, which is discussed in
Section 4.5.3.5. AEDMSTR (AQ0060), ASRINTR (AQ0130), and AFMMSTR (AQ0100) may
all be executed using the cataloged procedure AQEMM10, which is discussed in
Section 4.6.1. An example of a job stream to create a master file using
procedure AQEMM10 is shown in Section 4.6.1.1.4. Sample job streams to update
an existing master file using procedures AQEDT10 and AQFMM10 are shown in
Sections 4.5.1.5.4 and 4.5.3.5.4.
40
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 6
Release Date: 4/30/79
Update #: 24
SORTED PARAMETER
FILE TRANSACTIONS
(Temporary)
I
NEW AQDHS-II
PARAMETER FILE
V
PARAMETER
FILE TRANSACTIONS
ASRPARM (AQ0150)
PARAMETER FILE TRANSACTION
SORT PROGRAM
SORT WORK
FILE
(Temporary)
1
DIAGNOSTIC
REPORT
OLD AQDHS-II
PARAMETER FILE
(Optional)
OPTION CARD
(Optional)
AEMPARM (AQ0070)
PARAMETER FILE
MAINTENANCE PROGRAM
TRANSACTION
LISTING
(Optional)
DIAGNOSTIC
REPORT
NEW PARAMETER
FILE LISTING
(Optional
OLD PARAMETER
FILE LISTING
(Optional
Figure 4.1.1-a. Parameter File Maintenance Flowchart
41
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 7
Release Date: 4/30/79
Update #: 24
SITE FILE
TRANSACTIONS
ASRSITE (AQ0160)
SITE FILE TRANSACTION
SORT PROGRAM
SORT WORK
FILE
(Temporary)
1
DIAGNOSTIC
REPORT
I SORTED SITE
FILE TRANSACTIONS
(Temporary)
OLD AQDHS-II
SITE FILE
(Optional)
AEMSITE (AQ0080)
SITE FILE
MAINTENANCE PROGRAM
NEW AQDHS-II
SITE FILE
DIAGNOSTIC
REPORT
Figure 4.1.2-a. Site File Maintenance Flowchart
42
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 8
Release Date: 4/30/79
Update #: 24
PARAMETER STANDARDS
FILE TRANSACTIONS
ASRSTND (AQ0170)
PARAMETER STANDARDS FILE
TRANSACTION SORT PROGRAM
SORT WORK
FILE
(Temporary)
DIAGNOSTIC
REPORT
SORTED PARAMETER
STANDARDS FILE TRANSACTIONS
(Temporary)
/
OLD AQDHS-II
f PARAMETER STANDARDS
I FILE (Optional)
AEMSTND (AQ0090)
PARAMETER STANDARDS FILE
MAINTENANCE PROGRAM
NEW AQDHS-II
PARAMETER STANDARDS
FILE
DIAGNOSTIC'
REPORT
Figure 4.1.3-a. Parameter Standards File Maintenance Flowchart
43
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 9
Release Date: 4/30/79
Update #: . 24
SAROAD FORMAT
TRANSACTIONS
OPTION CARD
(Optional)
ACVSARD (AQ0010)
SAROAD TO AQDHS-II
CONVERSION PROGRAM
'AQDHS-II FORMAT
MASTER FILE
TRANSACTIONS
DIAGNOSTIC
REPORT
AQDHS-II FORMAT
MASTER FILE
TRANSACTIONS
AQDHS-II
PARAMETER
FILE
CARD
(Optional)
AQDHS-II
SITE
FILE
AEDMSTR (AQ0060)
MASTER FILE TRANSACTION
EDIT PROGRAM
/ INTERNAL 7
(TRANSACTIONS!
UTemporary) \
DIAGNOSTIC
REPORT
TRANSACTION
LISTING
(Optional
o
(Page 1 of 2)
Figure 4.1.4-a. Master File Maintenance Flowchart
44
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.1
INTRODUCTION
Page 10
Release Date: 4/30/79
Update #: 24
OLD AQDHS-II
MASTER FILE
(Optional)
NEW AQDHS-II
MASTER FILE
ASRINTR (AQ0130)
MASTER FILE INTERNAL
TRANSACTION SORT PROGRAM
SORTED INTERNAL
TRANSACTIONS
(Temporary)
AFMMSTR (AQ0110)
MASTER FILE
MAINTENANCE PROGRAM
OLD MASTER
FILE LISTING
(Optional
DIAGNOSTIC
REPORT
SORT WORK
FILE
(Temporary)
OPTION CARD
(Optional)
TRANSACTION
LISTING
(Optional
NEW MASTER
FILE LISTING
(Optional
(Page 2 of 2)
Figure 4.1.4-a. Master File Maintenance Flowchart
45
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.1
PARAMETER SORT
ASRPARM (AQ0150)
Page 1
Release Date: 4/30/79
Update #: 24
4.2 PARAMETER FILE
4.2.1 PARAMETER FILE TRANSACTION SORT PROGRAM - ASRPARM (AQ0150)
4.2.1.1 Description
ASRPARM (AQ0150) sorts parameter file transactions into the sequence
required by the parameter file maintenance program AEMPARM (AQ0070); Figure
4.2.1-a details this sort order. All parameter file transactions must be
sorted by ASRPARM (AQ0150) before they can be used to update (or create) the
parameter file. See Section 4.2.2 for additional information on the parameter
file transactions.
4.2.1.2 File Formats
Input to ASRPARM (AQ0150) consists solely of the parameter file
transactions. See Section 4.2.2.2 for the parameter file transaction format.
ASRPARM (AQ0150) produces two output files: a file containing the sorted
parameter file transactions and a diagnostic report. The transactions are in
the same sequence as the parameter file and can be used as input to the
parameter file maintenance program AEMPARM (AQ0070). An example of the
diagnostic report is shown in Figure 4.2.1-b.
4.2.1.3 Options
There are no options.
4.2.1.4 Error Messages
There are no error messages.
46
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.1
PARAMETER SORT
ASRPARM (AQ0150)
Page 2
Release Date: 4/30/79
Update #: 24
4.2.1.5 Cataloged JCL
ASRPARM (AQ0150) should always be executed in conjunction with the
parameter file maintenance program AEMPARM (AQ0070). See Section 4.2.2.5 for
a discussion of the cataloged procedure AQEMP10, which executes both programs.
4.2.1.6 Warnings and Special Instructions
Note that the COBOL sort verb is used in this program; therefore, the
collating sequence for alphanumeric fields is determined by the user's
particular installation. Also note that there is a special sort sequence for
action code (see figure 4.2.1-a).
In addition to the diagnostic report produced by ASRPARM (AQ0150),
messages generated by the sort-merge package will be printed. The format and
content, as well as the physical location, of these messages depends upon the
computer or the user's particular installation.
4.2.1.7 Cost Considerations
The following estimates are for the execution of ASRPARM (AQ0150) on an
IBM 370/168:
Number of parameter file transactions:
CPU time:
I/O time:
Total time:
300 transactions
.7 seconds
12.9 seconds
13.6 seconds
Estimated cost:
$2.36
47
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.1
PARAMETER SORT
ASRPARM (AQ0150)
Page 3
Release Date: 4/30/79
Update #: 24
4.2.1.8 Related Programs and Procedures
ASRPARM (AQ0150) should always be executed in conjunction with the
parameter file maintenance program AEMPARM (AQ0070). The cataloged procedure
AQEMP10 executes both programs.
48
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.1
PARAMETER SORT
ASRPARM (AQ0150)
Page 4
Release Date: 4/30/79
Update #: 24
Record Position
Description
Sort Sequence
2-6
7 - 8
9-10
80
1
Parameter Code
Method Code
Unit Code
Action Code
Card Type
Ascending
Ascending
Ascending
*
Ascending
Sort sequence is D (delete), A (add), C (change).
Figure 4.2.1-a. Sort Sequence for Parameter File Transactions
49
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.1
PARAMETER SORT
ASRPARM (AQ0150)
Page 5
Release Date: 4/30/79
Update #: 24
ca
<
a.
o
a.
UJ
CE
< CO
w O
z u
ceo o
« o
O. I ••
a: — <» o
to (M uj
~uj * ac
X uiui Cv
* W ^ OS
2 < O
or co
o >eo>-
oc uj«
o. r-
~eo
co x
§2
55
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
FARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 1
Release Date: 4/30/79
Update #: 24
4.2.2 PARAMETER FILE MAINTENANCE PROGRAM - AEMPARM (AQ0070)
4.2.2.1 Description
AEMPARM (AQ0070) creates and maintains the parameter file from
user-supplied transactions. There are three transaction card types: card 1,
card 2, and card 3. A complete set of the three card types is required to
create a parameter file record. Each card in a set contains the same key
information (parameter, method, and units codes. See Section 4.2.2.2 for
additional information on these card types. The transactions must be sorted
by the parameter file transaction sort program ASRPARM (AQ0150) into correct
parameter file sequence before they can be used by AEMPARM (AQ0070) to create
or update the parameter file. The sorted transactions are edited by AEMPARM
(AQ0070) for invalid entries before any change is made to the parameter file.
New parameter file records can be added and existing records changed or
deleted; a parameter file is created from add transactions.
Addition of a record to the parameter file requires a complete set of the
three transaction card types, each with an action code of A. Every defined
field in these three cards, with two exceptions, must contain valid, non-blank
data. The exceptions are the user units code and the user units conversion
factor, which may be left blank if the user does not need them for the given
parameter.
Any non-key field in an existing parameter file record can be changed.
Changes are made by transactions containing the key of the record to be
changed; new, valid data in the fields to be changed; and an action code of C.
For changes to non-key fields, only those card types that contain the fields
to be changed are needed. Non-key fields that are left blank on change
transactions are not changed in the parameter file.
To change a field in the parameter key, a delete transaction should be
created for the old key together with a complete set of add transactions
51
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
FARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 2
Release Date: 4/30/79
Update #: 24
containing the identical record information, but with the new key substituted
for the old. When these transactions are submitted together, the result will
be a change in key for the specified parameter record.
Deletion of a record is accomplished by coding a card type 1 transaction
with only the following information: the appropriate key, the card type, and
an action code of D.
Multiple actions may be performed on the same parameter key. For
example, a record may be deleted, re-added, and then changed, all in the same
update run.
4.2.2.2 File Formats
AEMPARM (AQ0070) uses three input files: the transaction file, the old
parameter file (this file is optional), and an option card. The transaction
file must be sorted by ASRPARM (AQ0150) (see Section 4.2.1) prior to its use
as input to the parameter file maintenance program. The format of each
transaction card type 1s shown 1n Figure 4.2.2-a; each transaction field is
described in Figure 4.2.2-b. The old parameter file, to which the
transactions will be applied, is also required input, unless the user 1s
creating the initial parameter file. The parameter file format is shown in
Figure 4.2.2-c. The option card controls the listing of Input and output
files and the printing of warning messages.
The primary output file is the new parameter file, which has the same
format as the old parameter file. Four print files are also produced. One of
these, the diagnostic report, 1s always printed. It includes all diagnostic
messages generated by the transaction edit as well as the summary statistics
for the update run. The other three print files list the input transaction
file, the input parameter file, and the output parameter file. These latter
three files appear in the printout only if the LIST option 1s specified on
52
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
FARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 3
Release Date: 4/30/79
Update #: 24
the option card (see Section 4.2.2.3). See Figure 4.2.2-d for a sample
diagnostic report from this program.
4.2.2.3 Options
The option card for AEMPARM (AQ0070) contains two fixed-position option
fields (see Figure 4.2.2-e for the option card format). The first option
field on the card determines whether warning messages are to appear in the
diagnostic report. If the user-supplied value in this field is FLAGW, warning
messages will be listed along with all other messages. If the value is
NOFLAGW or is any other value except FLAGW, warning messages will not be
listed, although all other messages will be printed.
The second option field controls the listing of the input transactions,
the input parameter file, and the output parameter file. If this field
contains the value LIST, each of the three files will be listed in its
entirety. If the value 1s NOLIST or any other value except LIST, none of
these files will be listed.
Should there be no option card in the run stream, the default options
NOFLAGW and NOLIST will be used.
4.2.2.4 Error Messages
AEMPARM 001 CONDITIONAL - NO OPTION CARD, DEFAULTS OF NOLIST, NOFLAGW USED
Meaning: There was no option card 1n the run stream.
Action: None, 1f the user Intends for the default options to be used;
otherwise, an option card should be included in the run stream
and the job resubmltted.
AEMPARM 002 CONDITIONAL - INVALID FLAGW OPTION, DEFAULT OF NOFLAGW USED
Meaning: The value 1n the FLAGW field on the option card is neither
53
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 4
Release Date: 4/30/79
Update #:• 24
FLAGW nor NOFLAGW.
Action: If the user wishes warning messages to be listed, he must
insert the value FLAGW in the FLAGW field and resubmit the
job.
AEMPARM 003 CONDITIONAL - INVALID LIST OPTION, DEFAULT OF NOLIST USED
Meaning: The value in the list field on the option card is neither LIST
nor NOLIST.
Action: If the user wishes the input and output files to be listed, he
must insert the value LIST in the list field and resubmit the
job.
AEMPARM 004 ERROR - INVALID CARD TYPE; 1,2,3 ALLOWED; CARD REJECTED
Meaning: The card type field contains a value other than 1, 2, or 3.
Action: Correct the card type field and resubmit the transaction.
i
AEMPARM 005 ERROR - INVALID PARAMETER CODE, CARD REJECTED
Meaning: The parameter code is either non-numeric or equal to zero.
Action: Correct the parameter code field and resubmit the transaction.
AEMPARM 006 ERROR - INVALID METHOD CODE, CARD REJECTED
Meaning: The method code is either non-numeric or equal to zero.
Action: Correct the method code field and resubmit the transaction.
AEMPARM 007 ERROR - INVALID UNITS CODE, CARD REJECTED
Meaning: The units code is either non-numeric or equal to zero.
Action: Correct the units code field and resubmit the transaction.
AEMPARM 008 ERROR - INVALID ACTION CODE, CARD REJECTED
Meaning: The only valid action codes are A (add), C (change), and D
(delete).
Action: Correct the action code field and resubmit the transaction.
54
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 5
Release Date: 4/30/79
Update #: • 24
AEMPARM 009 ERROR - INVALID MINIMUM DETECTABLE DECIMAL CODE, CARD REJECTED
Meaning: The only valid decimal codes are 0, 1, 2, 3, and 4.
Action: Correct the decimal position field and resubmit the
transaction.
AEMPARM 010 ERROR - INVALID MINIMUM DETECTABLE, CARD REJECTED
Meaning: The minimum detectable value must be of the form 'dddd1 for
non-negative values or '-ddd1 for negative values.
Action: Correct the minimum detectable field and resubmit the
transaction.
AEMPARM Oil ERROR - NEG MIN DETECTABLE INVALID FOR THIS PARAMETER, CARD
REJECTED
Meaning: The only parameters that allow negative minimum detectable
values are: lapse rate (61202), temperature (62101); dew point
(62103); temperature, 24-hour maximum (62104); temperature,
24-hour minimum (62105); temperature difference (62106).
Action: Correct the minimum detectable field and resubmit the
transaction.
AEMPARM 012 ERROR - STANDARD UNITS MUST BE SPECIFIED, CARD REJECTED
Meaning: On an add transaction, both standard units fields should have
non-blank values.
Action: Insert the proper values 1n the standard units code and
standard units conversion factor fields. Refer to the AEROS
Manual Series, Volume V: AEROS Manual of Codes for a complete
11st of currently acceptable standard units codes and standard
units conversion factors. Resubmit the corrected transaction.
AEMPARM 013 ERROR - INVALID STANDARD UNITS CODE, CARD REJECTED
Meaning: The standard units code field contains a non-numeric or zero
value.
55
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 6
Release Date: 4/30/79
Update #: 24
Action: Insert the proper value in the standard units code field.
Refer to the AEROS Manual Series, Volume V: AEROS Manual of
Codes for a complete list of currently acceptable standard
units codes. Resubmit the corrected transaction.
AEMPARM 014 ERROR - INVALID STANDARD UNITS CONVERSION FACTOR, CARD REJECTED
Meaning: The standard units conversion factor field contains a
non-numeric value.
Action: Insert the proper value in the standard units conversion factor
field. Refer to the AEROS Manual Series, Volume V: AEROS
Manual of Codes for a complete list of currently accepted
standard units conversion factors. Resubmit the corrected
transaction.
AEMPARM 015 ERROR - STANDARD UNITS CONVERSION FACTOR MUST BE NON-ZERO, CARD
REJECTED
Meaning: The standard units conversion factor field contains a zero
value.
Action: Insert the proper value in the standard units conversion factor
field. Refer to the AEROS Manual Series, Volume V: AEROS
Manual of Codes for a complete list of currently accepted
standard units conversion factors. Resubmit the corrected
transaction.
AEMPARM 016 WARNING - ADD TRANSACTION DOES NOT SPECIFY USER UNITS CODE,
ASSUMING UNITS CODE IN KEY
Meaning: The user units fields in the add transaction were left blank;
the program inserted into the user units code field the same
value as the one in the units code field of the parameter key.
Action: None, if the user does not wish to specify additional units
information in the user fields.
56
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 7
Release Date: 4/30/79
Update #: 24
AEMPARM 017 ERROR - INVALID USER UNITS CODE, CARD REJECTED
Meaning: The user units code field contains a value that is non-numeric
or zero.
Action: Correct the user units code field and resubmit the transaction.
AEMPARM 018 WARNING - ADD TRANSACTION DOES NOT SPECIFY USER UNITS CONV FAC,
ASSUMING UNITY
Meaning: The user fields in the add transaction were left blank; the
program inserted into the user units conversion factor field
a value of 1.0 (see error message #16, above).
Action: None, if the user does not wish to specify additional units
information in the user fields.
AEMPARM 019 ERROR - INVALID USER UNITS CONVERSION FACTOR, CARD REJECTED
Meaning: The user units conversion factor field contains a non-numeric
value.
Action: Correct the user units conversion factor field and resubmit the
transaction.
AEMPARM 020 ERROR - USER UNITS CONVERSION FACTOR MUST BE NON-ZERO, CARD
REJECTED
Meaning: The user units conversion factor field contains a value of
zero.
Action: Correct the user units conversion factor field and resubmit the
transaction.
AEMPARM 021 ERROR - TRANSACTION IS DELETE AND NOT TYPE 1, CARD REJECTED
Meaning: A record is deleted only if a card type 1 delete transaction
with the same parameter key is entered. No other card-type
transaction will delete a record.
Action: If deletion of a record is intended, and there is no type 1
delete transaction for that parameter key in the input
57
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 8
Release Date: 4/30/79
Update #: 24
transactions, change the card type of this deletion to 1
and resubmlt the transaction.
AEMPARM 022 ERROR - COLUMNS 11 THRU 79 OF DELETE CARD MUST BE BLANK, CARD
REJECTED
Meaning: A delete transaction should have only the following fields
coded: the card type field (value is 1), the parameter key
fields, and the action code field (value is D).
Action: Correct the delete transaction and resubmit.
AEMPARM 023 ERROR - NO MATCH FOR TRANSACTION ON PARAMETER FILE, CARD REJECTED
Meaning: The transaction is a change or a delete transaction, but no
matching parameter key can be found in the parameter file.
Action: Correct the parameter key of the transaction if a change or a
delete is Intended; otherwise, change the action code to A.
Resubmit the transaction.
AEMPARM 024 ERROR - ADD TRANSACTION NOT ALLOWED FOR RECORD ON FILE, CARD
REJECTED
Meaning: The transaction is an add transaction, but a record with the
same key already exists in the file.
Action: Correct the parameter key if an add is intended; otherwise,
convert the transaction to a change or delete transaction.
Resubmit the transaction.
AEMPARM 025 ERROR - ADD TRANSACTION DOES NOT HAVE VALID 1, 2 AND 3 CARDS, CARD
REJECTED
Meaning: A record cannot be added unless a full set of three valid
transactions is present for it. Any otherwise valid add
transactions in this incomplete set must be rejected since no
parameter record can be created from them.
58
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 9
Release Date: 4/30/79
Update #: 24
Action: Correct the given set of transactions to obtain three valid
cards; resubmit these.
AEMPARM 026 ERROR - BLANK CARD, REJECTED
Meaning: A blank card was inserted in the transaction file.
Action: If the same transaction file is to be used again, remove the
blank card.
AEMPARM 027 CONDITIONAL - NUMBER OF RECORDS IN OUTPUT PARAMETER FILE EXCEEDS
200
Meaning: Each AQDHS-II program (as released by NADB) that has a
parameter-record storage table allows a maximum of 200
parameter records to be stored; a parameter file containing
more than 200 records causes these programs to abort. AEMPARM
(AQ0070) itself has no output file limit; it will generate as
many output records as required by the interaction of the input
parameter file and the input transactions.
Action: Either delete enough parameter records to make the file fall
within the limit of 200 records, or increase the limit by
making the appropriate changes in the affected AQDHS-II
programs. See Sect4en-4»-2-;2Tr8"for>'-a lfst~of; these progretfus-
Appendix C for instructions on modifying them*
AEMPARM 028 ABORT - INPUT TRANSACTION FILE OUT OF SEQUENCE
Meaning: The input transactions have not been previously sorted by the
parameter transaction sort program, ASRPARM (AQ0150). Any
output from this run is unuseable.
Action: Sort the transaction file and resubmit the job.
59
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
FARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 10
Release Date: 4/30/79
Update #: 24
AEMPARM 029 DISASTER - OUTPUT PARAMETER FILE OUT OF SEQUENCE
Meaning: A program error has produced an output parameter file whose
records are not in correct parameter-key sequence. Any output
from this run is unuseable.
Action: Contact NADB.
4.2.2.5 Cataloged JCL
4.2.2.5.1 JCL listing - AEMPARM (AQ0070) is executed by the cataloged
procedure AQEMP10. This procedure also executes the parameter file
transaction sort program ASRPARM (AQ0150). See Figure 4.2.2-f for a listing
of AQEMP10.
4.2.2.5.2 Cross-reference of DD names and files
Program Name: ASRPARM (AQ0150)
DD Name File Description
AQSINPUT AQDHS-II parameter file transactions
SORTWK01 Sort work file
AQSOUTPT Sorted AQDHS-II parameter file transactions
AQSPRINT Diagnostic report
Program Name: AEMPARM (AQ0070)
DD Name File Description
AQSTRANS Sorted AQDHS-II parameter file transactions
AQSOLDPR Old AQDHS-II parameter file
AQSOPTIN Option card
AQSNEWPR New AQDHS-II parameter file
Input/Output
Input
Internal
Output
Output
Input/Output
Input
Input
Input
Output
60
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
FARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 11
Release Date: 4/30/79
Update #: 24
AQSPRINT Diagnostic report Output
AQSPINLS Listing of old AQDHS-II parameter file Output
AQSPOTLS Listing of new AQDHS-II parameter file Output
AQSTXNLS Listing of sorted AQDHS-II parameter file Output
transactions
4.2.2.5.3 User-supplied JCL - To execute the cataloged procedure AQEMP10, the
user must supply the job accounting information and the data set names of the
old and new parameter files. See Figure 4.2.2-g for a description of the
procedure's substitutable parameters. Two options can be specified for the
file maintenance step; the valid option words are FLAGW or NOFLAGW and LIST or
NOLIST. For a more detailed description of the use of these options and the
format of the option card see Section 4.2.2.3.
4.2.2.5.4 . Sample run streams - The first run stream listed is used to create
the initial parameter file from transactions. The option card indicates that
warning messages are to be printed, but that the input and output files are
not to be listed.
// EXEC AQEMP10,
// NEWPARM=PARM0001
//SORT. INPUT DD *
(Parameter transactions)
/*
//UPDATE. AQSOLDPR DD DUMMY
//UPDATE. OPTIONS DD *
FLAGW NOLIST
/*
The second run stream shows the initial parameter file being updated. No
option card is 'included, so the default options NOFLAGW and NOLIST are used.
61
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 12
Release Date: 4/30/79
Update #: 24
// EXEC AQEMP10,
// OLDPARM=PARM0001,
// NEWPARM=PARM0002
//SORT.INPUT DD *
(Parameter transactions)
/*
//
4.2.2.6 Warnings and Special Instructions
The user should remember that a full set of three cards is required to
add a record to the parameter file. To delete a record, only the card type 1
transaction is allowed. Also, non-key fields that are left blank on change
transactions are not affected in the parameter file.
The majority of the fields in the parameter record are used within the
AQDHS-II system either to aid in editing the master file transactions or to
supply prose descriptions of the parameter keys in the page headings of
AQDHS-II reports. However, certain parameter fields have special functions
and should be coded on the transactions with particular accuracy. The minimum
detectable and decimal position fields are used in the statistical analysis
program, ASTMSST (AQ0200). The standard units conversion factor field is used
in the anomaly screening conversion program, ACVANOM (AQ0040), to convert the
readings of certain parameters to standard units. Either the standard units
fields or the user units fields may be used by the units code conversion
program, ACVUNIT (AQ0050), to convert readings and units codes in the master
file.
Values do not have to be coded for two of the defined fields in a set of
add transactions: the user units code and the user units conversion factor
fields. If both of these fields are blank, AEMPARM (AQ0070) will insert
appropriate values in the user units fields of the added parameter record
based on the units code field in the transaction key. Two warning messages
62
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 13
Release Date: 4/30/79
Update #: 24
will be generated to let the user know that this 1s being done. These are, 1n
fact, the only warning messages produced by AEMPARM (AQ0070); when the user
has a large number of add transactions that have blank user units fields, he
might consider using the NOFLAGW option to suppress the many warning messages
that would otherwise be produced.
4.2.2.7 Cost Considerations
The following example provides an estimate of the cost of executing
AEMPARM (AQ0070) on an IBM 370/168.
Number of input transaction cards: 300 cards
Number of input parameter file records: 0 records
Number of output parameter file records: 100 records
CPU time: 2.3 seconds
I/O time: 6.9 seconds
Estimated cost: $2.30
4.2.2.8 Related Programs and Procedures
In the parameter file maintenance procedure, AQEMP10, the parameter file
transaction sort program, ASRPARM (AQ0150), is also executed (see Section
4.2.1). Related procedures include: (1) the parameter file COBOL to FORTRAN
format conversion procedure, AQCVP10, which invokes the program ACVPFOR
(AQ0030); (2) the parameter file detailed report procedure, AQRPP10, which
invokes the program ARPPARM (AQ0240); and (3) the parameter exception report
procedure, AQRPP20, which invokes the program ARPPMEX (AQ0330).
63
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2;2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 14
Release Date: 4/30/79
Update #: 24
The following programs use the parameter file and must be modified if
the parameter file exceeds the NADB-established size of 200 records:
AEDMSTR (AQ0060)
ASTPRLM (AQ0190)
ACVANOM (AQ0040)
ACVUNIT (AQ0050)
ARPMSTR (AQ0230)
ARPMSST (AQ0270)
ARPINVS (AQ0280)
ARPINVP (AQ0290)
ARPPMEX (AQ0330)
64
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 15
Release Date: 4/30/79
Update #: . 24
Card 1
Columns
Field Length
Data Type
Description
1
2-6
7-8
9-10
11
12
16
46
71
15
45
70
79
80
1
5
2
2
1
Numeri c
Numeric
Numeric
Numeric
Numeric
4
30
25
9
1
Numeric
Alphanumeric
Alphanumeric
Alphabetic
Card Type (value is 1)
Parameter Code
Method Code
Units Code
Minimum Detectable
Decimal Code
Minimum Detectable*
Parameter Description
Collection Method
Unused
Action Code
If the minimum detectable value is negative it must adhere to the following
format: -ddd where d is any digit 0-9. The minimum detectable value must be
expressed in the units specified by the units code in columns nine and 10.
(Page 1 of 3)
Figure 4.2.2-a. Parameter File Transaction Formats
65
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 16
Release Date: 4/30/79
Update #: 24
Card 2
Columns
Field Length Data Type
Description
2
7
9
11
36
66
1
6
8
10
35
65
79
80
1
5
2
2
25
30
14
1
Numeric
Numeric
Numeric
Numeric
Alphanumeric
Alphanumeric
Alphabetic
Card Type (value is 2)
Parameter Code
Method Code
Units Code
Analysis Method
Units Description
Unused
Action Code
(Page 2 of 3)
Figure 4.2.2-a - Continued. Parameter File Transaction Formats
66
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 17
Release Date: 4/30/79
Update #: 24
Card 3
Columns
Field Length
Data Type
Description
2
7
9
11
13
1
6
8
10
12
21
22 - 23
24 - 32
33 - 79
80
1
5
2
2
2
2
9*
47
1
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Alphabetic
Card Type (value is 3)
Parameter Code
Method Code
Units Code
Standard Units Code
Standard Units Conversion
Factor
User Units Code**
User Units Conversion
Factor**
Unused
Action Code
* A five-digit decimal position is assumed; e.g., 2.62 would be coded as
'000262000'. Leading zeroes are not required, but trailing zeroes must be
coded.
** If the user units code and user units conversion factor are blank on an
add transaction, the user units code on the added parameter file record
will be the same as the units code in columns nine and 10 of the
transaction, and the user units conversion factor will be one.
(Page 3 of 3)
Figure 4.2.2-a - Continued. Parameter File Transaction Formats
67
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 18
Release Date: 4/30/79
Update #: 24
Action Code: Identifies the intended action of the transaction on the
parameter file.
Valid Codes: A-add, C-change, and D-delete
Field Length: 1 character
Analysis Method: A prose description of the analysis method.
Valid Codes:
Field Length:
Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted
analysis methods.
25 characters
Card Type: Identifies the transaction as either card 1, card 2, or card 3.
Valid Codes: 1-3
Field Length: 1 character
Collection Method: A prose description of the collection method.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted method
codes.
Field Length: 25 characters
Method Code: Identifies both the collection method and the analysis method
for the parameter being described.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted method
codes.
Field Length: 2 characters
Minimum Detectable: Specifies the minimum value detectable using the
specified collection and analysis methods. The minimum detectable
value must be expressed in the units specified by the units code in
card columns nine and 10 of the transaction.
(Page 1 of 4)
Figure 4.2.2-b. Parameter File Field Descriptions
68
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 19
Release Date: 4/30/79
Update #: . 24
Valid Codes:
Field Length:
Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted minimum
detectable values.
4 characters
Minimum Detectable Decimal Code: A number which indicates the number of
digits in the minimum detectable value that are to fall to the right
of the decimal point.
Valid Codes: 0-4
Field Length: 1 character
Parameter Code: Identifies the parameter being described.
Valid Codes:
Field Length:
Refer to the AEROS Manual Series, Volumfle V: AEROS Manual
of Codes for a complete list of currently accepted
parameter codes.
5 characters
Parameter Description: A prose description of the parameter.
Valid Codes:
Field Length:
Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted
parameter descriptions.
30 characters
Standard Units Code: Identifies the standard units in which values for the
given parameter are expressed.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted standard
units codes.
Field Length: 2 characters
(Page 2 of 4)
Figure 4.2.2-b - Continued. Parameter File Field Descriptions
69
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
FARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 20
Release Date: ,4/30/79
Update #: . 24
Standard Units Conversion Factor: The factor which, when multiplied by a
value expressed in the units identified in the parameter key,
converts that value to the standard units.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted
standard units conversion factors.
Field Length: 9 characters with a 5-digit decimal position assumed.
Leading zeroes are not required but trailing zeroes must be
coded.
Units Code: Identifies the units in which readings will be expressed for each
parameter/method code combination. Since the units code is in the
parameter file record key, more than one units code may be
associated with each parameter/method code combination.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted units
codes.
Field Length: 2 characters
Units Description: A prose description of the units.
Valid Codes:
Field Length:
Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted units
descriptions.
30 characters
User Units Code: Identifies the units in which the user may want readings
with the given parameter key to be alternatively expressed. This
field may be left blank on an add transaction.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a complete list of currently accepted units
codes.
Field Length: 2 characters
Figure 4.2.2-b - Continued.
(Page 3 of 4)
Parameter File Field Descriptions
70
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 21
Release Date: 4/30/79
Update #:. 24
User Units Conversion Factor: The factor which, when multiplied by a value
expressed in the units identified in the parameter key, converts
that value to units expressed by the user units code.
Valid Codes: This field should be left blank on an add transaction if
the user units code field is blank. If the user units is
the same as the standard units code, the user units
conversion factor will be the same as the standard units
conversion factor, which may be found in AEROS Manual
Series, Volume V: AEROS Manual of Codes. Otherwise, the
: user must compute the units conversion factor.
Field Length: 9 characters with a 5-digit decimal position assumed.
Leading zeroes are not required, but trailing zeroes must
be coded.
Figure 4.2.2-b - Continued.
(Page 4 of 4)
Parameter File Field Descriptions
71
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
FARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 22
Release Date: 4/30/79
Update #: 24
Columns
1 -
6 -
8 -
10 -
15 -
17 -
26 -
28 -
37 -
67 -
92 -
117 -
5
7
9
13
14
16
25
27
36
66
91
116
146
Field Length
5
2
2
4*
1
2
g**
2
g**
30
25
25
30
Description
Key
Parameter Code
Method Code
Units Code
Minimum Detectable
Minimum Detectable Decimal Code
Standard Units Code
Standard Units Conversion Factor
User Units Code
User Units Conversion Factor
Parameter Description
Collection Method
Analysis Method
Units Description
* The minimum detectable value is stored in 'zoned decimal format1 in the
parameter file, i.e. the sign is combined with the right-most character.
** A 5-digit decimal position is assumed; e.g., 2.62 would be stored as
'000262000'.
Figure 4.2.2-c. Parameter File Format
72
-------
AQDHS-II PARAMETER FILE EDIT AND MAINTENANCE PROGRAM DIAGNOSTIC MESSAGES
PAGE
PROGRAM NAME: AEMPARM (AQ0070)
REVISION LEVEL: 1-00
INCORPORATED: OCTOBER 31. 1978
LAST UPDATE «'. Z<\
OPTIONS IN EFFECT: FLAGW LIST
311103910101000100000 A
«*» AEMPARM oi6 WARNING - ADD TRANSACTION DOES NOT SPECIFY USER UNITS CODE, ASSUMING UNITS CODE IN KEY
«•« AEMPARM 018 WARNING - ADD TRANSACTION DOES NOT SPECIFY USER UNITS CONV FAC, ASSUMING UNITY
NUMBER OF INPUT PARAMETER FILE RECORDS: 89
NUMBER OF OUTPUT PARAMETER FILE RECORDS: 89
NUMBER OF INPUT TRANSACTION CARDS: 5
NUMBER Of VALID TRANSACTION CARDS: 5
NUMBER OF REJECTED TRANSACTION CARDS: 0
NUMOER OF DISASTER MESSAGES: 0
NUMBER OF ABORT MESSAGES: 0
NUMBER OF ERROR MESSAGES: 0
NUMOER OF CONDITIONAL MESSAGES: 0
NUMBER Of EARNING MESSAGES 2
CO
Figure 4.2.2-d. Diagnostic Report
i—i JO
i— o
m 3c
co
<-> i
70 *-•
m •—>
-o co
3> m
73 O
TO T| O
O 3>
O HH
-~J Z
O —I
o
.£»
•
ro
•
ro
73
TJ (B
Q. — •
at m
o>
re (^
n>
=«=
o
ro
-P.
CO
o
O<
tO
n>
ro
co
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 24
Release Date: 4/30/79
Update #: . 24
Column #1 Column #9
FLAGW
OPTION
LIST
OPTION
The options are subject to the following restrictions:
1. The FLAGW option, if it appears, must begin in column 1 and be
written as either FLAGW or NOFLAGW.
i
2. The LIST option, if it appears, must begin in column 9 and be written
as either LIST or NOLIST.
Figure 4.2.2-e. Option Card Format
74
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 25
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME: AQEMP10
REVISION LEVEL: 1-00
LAST UPDATE »> 24
DATE INCORPORATED: OCTOBER 31,1976
THIS PROCKDURE ALLOWS THE USER TO MAINTAIN THE AQDHS-II
FILE
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AGEMP10 PROC PROJECT='CN.EPALMH.A067,CDHS.HQ.AQS',
// PROG1=ASRPAKM,
// PROG2=A£MPARM,
// TI ME 1 ='1,0',
// TIME2='2,0',
// OLDPARMrAGOLDPRM,
// NEWPARMsAQNEWPRM,
// UNIT=3330,
// SERIAL=CDHSPK,
// DISP='NEW,CATLG,DELETE',
// SPCUNIT=TRK,
// PRIMARY=10,
// SCNDARYS5,
// TEMP=SYSDA,
// SORTSPC=10,
OUT = A
tXEC
PGMs&PRllGl,
TIME=(&TIME1)
//
//*
//SORT
//*
//* SORT PARAMETER FILE TRANSACTIONS INTO FILE SEQUENCE
//*
//S1EPLIB DD DSNAME=RPROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// I)ISP=(SHR,PASS)
//SORTLI8 DD DSNAME=SYS1.SORTLIB,
// 1>ISP = (SHR,PASS)
//*
//* SORT WORK FILES
//*
OD IJNIT = &TEMP,
SPACES(TRK,&SORTSPC,,CONTIG)
//SORTWK01
//
//*
OD UNIT = UTEMP,SEP = SUHJWK01),
// SPACE=(TRK,&SORTSPC,,CONTIG)
//*
//SORTWK03 DD UMn = (&TEMP,3EP=(SORTWK01,S(IRTV
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 26
Release Date: 4/30/79
Update #: 24
// DISP=(NEW,PASS,DELETE),
// SPALt=(TRK,&SORTSPC,RLSE),
// DSNAME=&RTRANS,
// DCB=(RECFM=F,LRECL=aO,BLKSIZE=80)
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//AQSPRINT DD SYSOUTs&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUT=&OUT
//*
//SYSOUT DD SYSUUTa&OUT
//*
//SYSDBOUT DD SYSOUT=&OUT
//*
//SYSDTERM DD SYSOUT=RUUT
//*
//SYSUDUMP OD 3YSOUT=80UT
//*
//*
//UPDATE EXEC PGM=fU'R()G2,
// TIME=UTIME2)
//*
//* MAINTAIN PARAMETER FILE
//*
//STEF'LIB DD DSNAME = 8PRDJECT . .LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - TRANSACTIONS
//*
//AQSTRANS DD DSNAME=&KTRAN3,
// DISP=COLD,DELETE)
//*
//* INPUT DATA SET - OLD PARAMETER FILE
//*
//AQSOLDPR DD DSN=&PROJECT..DATA.&OLDPARM,
// VOLUME=(PR1VATE,RETAIN),
// DISPe(SMR,PASS)
//*
//* OUTPUT DATA SET - NEW PARAMETER FILE
//*
//AOS.MCWPR DD DSNAME = &PROJECT . .DATA.RNEWPAKM,
// VULUME=(PRIVATE,RETAIN,SER=&SER1AL),
// UISP=(&DISP),
// SPACE=(&SPCUNIT,(&PRIMARY,RSCNDARY),RLSE),
// UNIT = *UJNIT
//*
//* INPUT DATA SET - OPTION CARD
//*
//AQSOPTIN DD ODNAMEsOPTIONS,
//*
//* OUTPUT DATA SET • LIST OF INPUT TRANSACTIONS
//*
//AOSTXNLS DD
00005900
00006000
00006100
00006300
00006300
00006400
00006SOO
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
00008000
00008100
00008200
00008300
OOOOBUOO
00008500
00008600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
00010800
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
Figure 4.2.2-f - Continued.
(Page 2 of 3)
Cataloged Procedure AQEMP10
76
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 27
Release Date: 4/30/79
Update #: 24
//*
//* OUTPUT DATA SET - LIST OF INPUT PARAMETER FILE
//*
//AQSPINLS 00 SYS()UT = &OUT
//*
//* OUTPUT DATA SET - LIST OF OUTPUT PARAMETER FILE
//*
//AOSPOTLS DD SYSOUT=RUUT
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//AQSPRINT DO SYSDUTs&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUT=ROUT
//SYSOUT DD
//*
X/SYSDBOUT DO SYSOUT=ROUT
//*
//SYSDTERM DD SYSOUTr&UUT
//*
//SYSUDUMP DD SYSOUT=&OUT
//*
OOOt1700
00011800
00011900
00012000
00012100
00012200
00012300
00012400
00012500
00012600
00012700
00012900
00012900
00013000
00013100
00013200
00013300
00013000
00013500
00013600
00013700
00013HOO
00013900
00014000
00014100
Figure 4.2.2-f - Continued.
(Page 3 Of 3)
Cataloged Procedure AQEMP10
77
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.2.2
PARM FILE MAINTENANCE
AEMPARM (AQ0070)
Page 28
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
TIME2
OLDPARM
NEWPARM
UNIT
SERIAL
DISP
SPCUNIT
PRIMARY
SCNDARY
TEMP
SORTSPC
OUT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS1
PROG1
PROG2
TIME1
ASRPARM
AEMPARM
'1,0'
Description
Highest-level index of data set names
(e.g.,CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
AQOLDPRM would be the full data set name of
the old parameter file)
Parameter file transaction sort program
Parameter file maintenance program
Time (minutes, seconds) allocated for
execution of ASRPARM
Time (minutes, seconds) allocated for
execution of AEMPARM
Lowest-level index of old parameter file
Lowest-level index of new parameter file
Unit type to which new parameter file is to
be written
Volume serial number of the volume to which
new parameter file is to be written
Disposition of new parameter file
Units in which space for new parameter file
is to be allocated
Primary space allocation for new parameter
file
Secondary space allocation for new parameter
file
Unit type for temporary work space
Number of tracks to be allocated for the
sort work space
SYSOUT class for all print files
Figure 4.2.2-g. Substitutable Parameters for AQEMP10
'2,0'
AQOLDPRM
AQNEWPRM
3330
CDHSPK
1 NEW,CATLG,DELETE1
TRK
10
5
SYSDA
10
78
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.1
SITE TRANSACTION SORT
PROGRAM ASRSITE (AQ0160)
Page 1
Release Date: 4/30/79
Update #: 24
4.3 SITE FILE
4.3.1 SITE FILE TRANSACTION SORT PROGRAM - ASRSITE (AQ0160)
4.3.1.1 Description
ASRSITE (AQ0160) sorts site file transactions into the sequence required
by the site file maintenance program AEMSITE (AQ0080); Figure 4.3.1-a details
this sort order. All site file transactions must be sorted by ASRSITE
(AQ0160) before they can be used to update (or create) the site file. See
Section 4.3.2 for additional information on the parameter file transactions.
4.3.1.2 File Formats
Input to ASRSITE (AQ0160) consists solely of the site file transactions.
See Section 4.3.2.2 for the site file transaction format.
ASRSITE (AQ0160) produces two output files: a file containing the sorted
site file transactions and a diagnostic report. The transactions are in the
same sequence as the site file and can be used as input to the site file
maintenance program AEMSITE (AQ0080). An example of the diagnostic report is
shown in Figure 4.3.1-b.
4.3.1.3 Options
There are no options.
4.3.1.4 Error Messages
There are no error messages.
79
-------
AQDHS-II
.FILE CREATION AND
MAINTENANCE
SECTION 4.3.1
SITE TRANSACTION SORT
PROGRAM ASRSITE (AQ0160)
Page 2
Release Date: 4/30/79
Update #: 24
4.3.1.5 Cataloged JCL
ASRSITE (AQ0160) should always be executed in conjunction with the site
file maintenance program AEMSITE (AQ0080). See Section 4.3.2.5 for a
discussion of the cataloged procedure AQEMS10, which executes both programs.
4.3.1.6 Warnings and Special Instructions
Note that the COBOL sort verb is used in this program; therefore, the
collating sequence for alphanumeric fields is determined by the computer at
the user's particular installation.
In addition to the diagnostic report produced by ASRSITE (AQ0160),
messages generated by the sort-merge package will be printed. The format and
content, as well as the physical location, of these messages depend upon the
user's particular installation.
4.3.1.7 Cost Considerations
The following estimates are for the execution of ASRSITE (AQ0160) on an
IBM 370/168:
Number of sorted site file transactions:
CPU time:
I/O time:
Total time:
3 transactions
.4 seconds
5.6 seconds
6.0 seconds
Estimated cost:
$1.11
80
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.1
SITE TRANSACTION SORT
PROGRAM ASRSITE (AQ0160)
Page 3
Release Date: 4/30/79
Update #: 24
4.3.1.8 Related Programs and Procedures
ASRSITE (AQ0160) should always be executed in conjunction with the site
file maintenance program AEMSITE (AQ0080). The cataloged procedure AQEMS10
executes both programs.
81
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.1
SITE TRANSACTION SORT
PROGRAM ASRSITE (AQ0160)
Page 4
Release Date: 4/30/79
Update #:. 24
Record Position
1
3
7
11
13
16
2
6
9
10
12
15
19
Description
State Code
Area Code
Site Code
Agency Code
Project Code
AQCR Code
County Code
Sort Order
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Figure 4.3.1-a. Sort Sequence for Site File Transactions
82
-------
AUOHS-1I SITE FILE TRANSACTION SORT PROGRAM - DIAGNOSTIC REPORT
PAGE 1
PROGRAM NAME: ASRSITE (AQ0160)
REVISION LEVEL: 1-00
LAST UPDATE »: 2H
t)ATE INCORPORATED: OCTOBER 31, 1978
NUMBER OF TRANSACTIONS READ:
NUMBER OF TRANSACTIONS WRITTEN:
36
36
CO
CO
Figure 4.3.1-b. Diagnostic Report
3 -n >
3=» I-H JO
•—I i— o
z rn DC
—I co
rn o i
z -yo •-•
j> m i—i
•z. f*
O —)
m i—i
o
-O CO CO
TO >—< m
o -H o
3> —i o
2 50 z
> Z -I*
co co •
73 f> CO
CO O •
> co
-o o
O 70
T3
a.
Ol
€-»•
ft)
=«=
70
O)
CO
o
•—I
IO
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 1
Release Date: 4/30/79
Update #:. 24
4.3.2 SITE FILE MAINTENANCE PROGRAM - AEMSITE (AQ0080)
4.3.2.1 Description
AEMSITE (AQ0080) creates and updates a file containing valid site codes
for a user's AQDHS-II installation plus a description associated with each
site code.
The site file transactions must be sorted by the site file transaction
sort program ASRSITE (AQ0160) prior to being processed by AEMSITE (AQ0080). A
transaction is sorted according to the value of the transaction key which
contains the coded identification of the site: state code, area code, site
code, agency code, and project code. AEMSITE (AQ0080) does not check the
sequence of the transactions since it is assumed that they have been sorted by
ASRSITE (AQ0160). See Section 4.3.1 for a discussion of the site file
transaction sort program.
If a transaction key matches a key in the site file and all remaining
transaction fields (AQCR, county, SLAMS/NAMS ID, and site description) are
blank, then the record is deleted from the site file. If the remaining fields
are not blank, then the AQCR and county fields of the transaction are edited.
If they are numeric, then these fields, along with the SLAMS/NAMS ID and site
description fields, replace the corresponding fields of the site file record.
If they are not numeric, the transaction is rejected and an error message is
generated. If no matching key is found, a new site file record is created
unless the remaining transaction fields are blank; in this case an error
message is generated and the transaction is rejected.
4.3.2.2 File Formats
Input to AEMSITE (AQ0080) consists of an initial sorted transaction file
and the current AQDHS-II site file. However, if the site file is being
84
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 2
Release Date: 4/30/79
Update #: 24
created there will be no input AQDHS-II site file. See Figure 4.3.1-a
for a description of the site transaction sort order, Figure 4.3.2-a for a
description of the AQDHS-II site file record format, and Figure 4.3.2-b for
the AQDHS-II site file data definitions.
Output consists of a new AQDHS-II site file and a print file containing a
diagnostic report. AEMSITE (AQ0080) does not check the sequence of input or
output files (see Section 4.3.2.6). The diagnostic report contains a printed
image of each transaction and the associated action taken by the program (add,
replace, delete, rejected). A rejected transaction will be followed by an
error message indicating the reason for rejection. See Figure 4.3.2-c for a
sample diagnostic report.
4.3.2.3 Options
There are no options.
4.3.2.4 Error Messages
*** AEMSITE 001 ERROR - NO MATCHING KEY ON MASTER FILE - DELETE REQUEST
IGNORED - CARD REJECTED
Meaning: A delete was specified for a non-existent record. The
transaction was not processed.
Action: Check the transaction to insure that it contains the proper
data. If the transaction does not contain the proper data,
correct the error and resubmit the job.
*** AEMSITE 002 ERROR - COLUMN 01 - STATE CODE BLANK - TRANSACTION REJECTED
Meaning: There is no state code on the transaction card.
Action: Correct the error and resubmit the job.
85
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 3
Release Date: 4/30/79
Update #: 24
*** AEMSITE 003 ERROR - COLUMN 13 - NON-NUMERIC AQCR - TRANSACTION REJECTED
Meaning: The AQCR field on the transaction card is not numeric.
Action: Correct the error and resubmit the job.
*** AEMSITE 004 ERROR - COLUMN 16 - NON-NUMERIC COUNTY-CODE - TRANSACTION
REJECTED
Meaning: The county field on the transaction card is not numeric.
Action: Correct the error and resubmit the job.
*** AEMSITE 005 ERROR - COLUMN 03 - NON-NUMERIC AREA CODE - TRANSACTION
• REJECTED
Meaning: The area field on the transaction card is not numeric.
Action: Correct the error and resubmit the job.
*** AEMSITE 006 ERROR - COLUMN 07 - NON-NUMERIC SITE CODE - TRANSACTION
REJECTED
Meaning: The site field on the transaction card is not numeric.
Action: Correct the error and resubmit the job.
*** AEMSITE 007 ERROR - COLUMN 10 - NON-ALPHABETIC AGENCY CODE - TRANSACTION
REJECTED
Meaning: The agency field on the transaction card is not alphabetic.
Action: Correct the error and resubmit the job.
*** AEMSITE 008 ERROR - COLUMN 11 - NON-NUMERIC PROJECT CODE - TRANSACTION
REJECTED
Meaning: The project field on the transaction card is not numeric.
Action: Correct the error and resubmit the job.
4.3.2.5 Cataloged JCL
86
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 4
Release Date: 4/30/79
Update #: 24
4.3.2.5.1 JCL listing - AEMSITE (AQ0080) can be run by executing the
cataloged procedure AQEMS10. This procedure executes ASRSITE (AQ0160) first
so that only sorted transactions are input to AEMSITE (AQ0080). See Figure
4.3.2-d for a listing of this procedure.
4.3.2.5.2 Cross-reference of DP names and files
Program Name: ASRSITE (AQ0160)
DD Name
File Description
Input/Output
AQSINPUT
SORTWK01
AQSOUTPT
AQSPRINT
Site file transactions
Sort work file
Sorted site file transactions
Diagnostic report
Program Name: AEMSITE (AQ0080)
Input
Internal
Output
Output
DD Name
File Description
Input/Output
AQSTRANS
AQSOLDMS
AQSNEWMS
AQSPRINT
Sorted site file transactions Input
Current AQDHS-II site file Input
New or updated AQDHS-II site file Output
Diagnostic report Output
4.3.2.5.3 User-supplied JCL - The user must supply the site file transactions
and the data set names of the current and updated AQDHS-II site files. See
Figure 4.3.2-e for a description of the procedure's substitutable parameters.
4.3.2.5.4 Sample run stream - The following run stream would create the
AQDHS-II site file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.SITEFILE1:
87
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 5
Release Date: 4/30/79
Update #: 24
// EXEC AQEMS10,
// NEWMSTR=SITEFILE
//SORT.INPUT DD *
(Site file transaction cards)
/*
//UPDATE.AQSOLDMS DD DUMMY
The following run stream would produce the updated AQDHS-II site file 'CN.
EPALMH.A087.CDHS.HQ.AQS.DATA.AQNEWSTE1 from the existing AQDHS-II site file
'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQOLDSTE':
// EXEC AQEMS10,
// OLDMSTR=AQOLDSTE,
// NEWMSTR=AQNEWSTE
//SORT.INPUT DD *
(Site file transaction cards)
/*
4.3.2.6 Warnings and Special Instructions
To insure that the AQDHS-II site file is produced in the proper sequence
the user must sort the transactions using ASRSITE (AQ0160) prior to executing
AEMSITE (AQ0080). If the transactions are processed out of sequence, the new
AQDHS-II site file might be out of sequence; this would cause erroneous output
from programs which access this file.
4.3.2.7 Cost Considerations
A test run of AEMSITE (AQ0080) was executed on an IBM 370/168 to create a
test AQDHS-II site file. The following estimates are from that test run:
88
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 6
Release Date: 4/30/79
Update #: 24
Input site file transactions:
Current input site file records:
Updated output site file records:
CPU time:
I/O time:
Total time:
24 transactions
0 records
24 records
0.2 second
3.1 seconds
3.3 seconds
Estimated cost:
$.95
4.3.2.8 Related Programs and Procedures
AEMSITE (AQ0080) must be run in conjunction with ASRSITE (AQ0160) to
insure that the AQDHS-II site file is maintained in the proper sequence. The
cataloged procedure AQEMS10 executes both programs.
89
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 7
Release Date: 4/30/79
Update #:. 24
Column #
1 -
3 -
7 -
11 -
13 -
16 -
21 -
2
6
9
10
12
15
19
20
80
Field Length
2
4
3
1
2
3
4
1
60
Data Type
Description
Numeric
Numeric
Numeric
Alphabetic
Numeric
Numeric
Numeric
Alphanumeric
Alphanumeric
State Code
Area Code
Site Code
Agency Code
Project Code
> Key
AQCR Code
County Code
SLAMS/NAMS ID
Site Description
Figure 4.3.2-a. AQDHS-II Site File Record Format
90
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 8
Release Date: 4/30/79
Update #: 24
Agency Code: Identifies the agency responsible for the sampling site.
Valid Codes: See Appendix A, Table 1. Contact the EPA Regional Office
for additional information.
Field Length: 1 character
AQCR Code: Identifies the Air Quality Control Region in which the sampling
site is located.
Valid Codes: The valid codes are 0-247. For additional information,
see the AEROS Manual Series, Volume V: AEROS Manual of
Codes.
Field Length: 3 characters
Area Code: Identifies the area within the state in which the sampling site is
located.
Valid Codes: Contact the EPA Regional Office for the valid codes.
t
Field Length: 4 characters
County Code: Identifies the county in which the sampling site is located.
Valid Codes: The code must be numeric. For additional information, see
the AEROS Manual Series, Volume V: AEROS Manual of Codes.
Field Length: 4 characters
Project Code: Identifies the project associated with the sampling site.
Valid Codes: See Appendix A, Table 2.
Field Length: 2 characters
(Page 1 of 2)
Figure 4.3.2-b. AQDHS-II Site File Data Definitions
91
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 9
Release Date: 4/30/79
Update #: 24
Site Code: Identifies the site at which the sample was taken.
Valid Codes: Contact the EPA Regional Office to obtain a list of valid,
recognized site codes.
Field Length: 3 characters
Site Description: A prose description of the sampling site.
Field Length: 60 characters
SLAMS/NAMS ID: Indicates whether the sampling site is a State and Local Air
Monitoring Station (SLAMS) or a National Air Monitoring Station
(NAMS). The code must be alphabetic.
Valid Codes: EPA has not established valid codes.
Field Length: 1 character
State Code: Identifies the state (or other geographic division) in which the
sampling site is located.
Valid Codes: The valid codes are 01-55. For additional information,
see the AEROS Manual Series, Volume V: AEROS Manual of
Codes.
Field Length: 2 characters
(Page 2 of 2)
Figure 4.3.2-b - Continued. AQDHS-II Site File Data Definitions
92
-------
VO
co
AQDHS-II SITE FILE MAINTENANCE PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: AEMSITE (A00060)
REVISION LEVEL: 1-00
LAST UPDATE Hi 20
DATt INCORPORATED! OCTOBER 31. 1978
INPUT/ERRORS
ACTION
100001001E02049I060 N.10TH. AVE., JACKSONVILLE, DUVAL CO.
«*• ADDED
120001001C0106000BO MOUNTAIN ROAD, HRO, HAWAII CO.
«•» ADDED
I2000I002C0106001QO PEARL HARBOR, HONOLULU, HONOLULU CO.
• •* ADDED
12000I003COI0600IOO MAIKIKI, HONOLULU, HONOLULU CO.
*** ADDED
l2000IOOOC010600taO SCHOFIELD BARRACKS, HONOLULU CO.
«** ADDED
12000100SC010600140 PEARL CITY, HONOLULU CO.
•«* ADDED
I20001006C010600140 MAHIAHA, HONOLULU CO.
• ** ADDED
120001007C010600100 KANEOHE, HONOLULU CO.
*«• ADDED
RECORDS ADDED: 36
RECORDS DELETED: 0
RECORDS REPLACED: 0
OLD SITE FILE COUNT: 0
NEW SITE FILE COUNT: 36
ERROR COUNT: 0
Figure 4.3.2-c. Diagnostic Report
> i-i JO
i—i r~ o
z m re
—I CO
m o i
z so •-«
3> m i—i
o -H
m 1-1
O
•D to co
•yo >-• m
O —I o
CJ m —I
3> m *»
m •
2 2 co
co ^ •
i—i >—i ro
o
o
co
o
o
m
T3
O.
Oi
r*
n>
=«=
ID
o>
o>
«3
m
o
CU
rt
ro n
co
o
—i
VO
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 11
Release Date: 4/30/79
Update #: 24
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AOEMS10 PROC PROJECT='CtJ.EPALMH.A087.CDHS.HQ.AQS',
PROGlsASRSITE,
PROCEDURE NAME! AOEMS10
REVISION LEVEL: 1-00
LAST UPDATE *: 24
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO MAINTAIN THE AQDHS-II SITE FILE
ft
ft
//
ft
tt
//
//
//
//
PROG2=AEMSITE,
TIME2='1,0',
OLPSITEsAQOLDSTE,
NEWSITE=AQNEWSTE,
UNIT*3330,
SERIAL=CDHSPK,
OISP='NEW,CATLG, DELETE',
SPCUNIT=TRK,
PRIMARYslO,
SECNDRY=5,
TEMPsSYSDA,
SORTSPC=10,
OUT=A
EXEC PGM=&PROG1,
TIME=(RTIME1)
DD SYSOUTs&OUT
//*
//SORT
//*
//* SORT SITE FILE TRANSACTIONS INTO FILE SEQUENCE
//*
//STEPLIB DD DSNAMF.S&PROJECT..LOAD,
// VOLUMEs(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//SORTLIB DO OSNAME=SYS1.SURTLIB,
// DISP=(SHR,PASS)
//*
//SYSOUT
//*
//SORTWK01 DD UNIT=&TEMP,
tt SPACEs(TRK,&SURTSPC,,CONTIG)
//*
//SORTWK02 DD UNIT=(&TEMP,SEP=SORTWK01),
tt SPACE3(THK,&SORTSPC,,CUNTIG)
//*
//SORTWK03 DD UNIT=UTEMP,SEP=(SORTWK01,SORTWK02)),
// SPACE=(TRK,RSORTSPC,,CONTIG)
//*
//* INPUT DATA SET - SITE FILE TRANSCATIONS
//*
//AQSINPUT DO DDNAMEsINPUT,
// DCD=DLKS1ZE=80
//*
//* OUTPUT DATA SET - SORTED SITE FILE TRANSACTIONS
//*
//AOSOUTPT DD UNIT=(RTEMP,SEP=(SORTWK01,S(1RTHK02,SORTWK03)),
// DISP=(NEW,PASS,DELETE),
// SPACEa(TRK, (&PRIMAPY,»Sf.CNDRY),RLSE),
00000100
00000200
00000300
00000400
00000500
OOOOOfeOO
00000700
00000800
00000<>00
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
OOOOUOOO
00004100
00004200
00004300
00004400
00004500
00001600
00004700
00004HOO
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
Figure 4.3.2-d.
(Page 1 of 3)
Cataloged Procedure AQEMS10
94
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 12
Release Date: 4/30/79
Update #: 24
// DSNAMES&&TRANS,
// DCB«(RECFMsF,LRtCLs80,BLK3IZE»80)
//*
//• OUTPUT DATA SET • DIAGNOSTIC REPORT
//AQSPR1NT DD SYSOUTs&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//SYSPRINT 00 SYSOUTs&OUT
//*
//SYSOUT DO SYSOUTB&OUT
//*
//3Y3DBOUT DD SY30UT=&OUT
//*
//SYSDTERM 00 SYSOUTs&OUT
//*
//SYSUDUMP 00 SYSOUTs&OUT
//*
//*
//UPDATE tXEC PGMS&PROG2,
// REGION=60K,
// TlMEs(*TIME2)
//*
//* MAINTAIN SITE FILE
//*
//STEPLIB DO DSNAME3&PROJECT..LOAD,
// VOLUMEs(PRlVATE,RETAIN),
// DISPs(SHH,PASS)
// DD DSNAMEsSYSl.COBLIB,
// DISPs(SHH,PASS)
//*
//* INPUT DATA SET • TRANSACTIONS
//*
//AOSTRANS DO D3NAME=&&TRAMS,
// DISP=(OLD,DELETE)
//*
//* INPUT DATA SET • OLD SITE FILE
//*
//AOSOLDM3 DD OSNAMEs&PROJECT..DATA.ROLDSITE,
// VOLUMF.s(PRIVATE, RETAIN),
// DISP=(SHR,PASS)
//*
//* OUTPUT DATA SET • NEW SITE FILF.
//*
//AOSNEWMS DD UNITs&lJNIT,
// VOLUMES(PRIVATE,RETAIN,StHs&SERIAL),
// DISP=(&01SP),
// SPACEs(&8PCUNIT,(KPRIMARY,HSECNDRY),RLSE),
// DSNAME=&PRUJECT..OATA.&NtWSITE
//*
//* OUTPUT DATA SET • DIAGNOSTIC MESSAGES
//*
//AOSPRINT DD SYSl)UT = RUUT
//*
//* OUTPUT DATA SETS • SY5H.M OPERATION
//*
//SYSPRINT DD SYSOUTs&DUT
00005900
00006000
00006100
00006300
00006400
00006SOO
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007200
00007400
00007500
00007600
00007700
00007800
00007900
OOOOBOOO
00008100
00008200
00008300
00006400
00008500
00008600
OOOOB700
00008AOO
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
oooioaoo
00010900
00011000
00011100
00011200
00011300
0001 1400
00011500
0001 1600
Figure 4.3.2-d - continued.
(Page 2 of 3)
Cataloged Procedure AQEMS10
95
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 13
Release Date: 4/30/79
Update #: 24
//*
//SYSOUT DO SYSOUTs&OUT
//*
//SY3DBOUT DO SYSUUT=&OUT
//*
//SYSDTEHM DD 3YSOUT=&OUT
//*
//SYSUDUMP DO SYSOUTs&OUT
//*
00011700
00011600
00011900
00012000
00012100
00012200
00012300
00012400
00012500
Figure 4.3.2-d - continued.
(Page 3 of 3)
Cataloged Procedure AQEMS10
96
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2
SITE FILE MAINTENANCE
PROGRAM AEMSITE (AQ0080)
Page 14
Release Date: 4/30/79
Update #: 24
Parameter
Name
Default
Value
PROJECT 'CN.EPALMH.A087.
CDHS.HQ.AQS'
PROG1 ASRSITE
PROG2 AEMSITE
TIME1 '1,0'
TIME2 '1,0'
OLDMSTR AQOLDSTE
NEWMSTR AQNEWSTE
UNIT 3330
SERIAL CDHSPK
DISP 'NEW,CATLG,DELETE1
SPCUNIT TRK
PRIMARY 10
SECNDRY 5
TEMP SYSDA
SORTSPC 10
OUT A
Description
Highest-level index of data set names (e.g., the
full data set name of the AQDHS-II site file would
be CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQOLDSTE)
Site file transaction sort program
Site file maintenance program
Time allocation for execution of ASRSITE
Time allocation for execution of AEMSITE
Lowest-level index of current AQDHS-II site file
Lowest-level index of new or updated AQDHS-II site
file
Unit type to which new or updated AQDHS-II site
file is to be written
Volume ID to which new or updated AQDHS-II site
file is to be written
Disposition of new or updated AQDHS-II site file
Units in which space for new or updated AQDHS-II
site file is to be allocated
Primary space allocation for new or updated
AQDHS-II site file
Secondary space allocation for new or updated
AQDHS-II site file
Unit type specified for temporary sort work files
Space allocation for temporary sort work files
SYSOUT class for all print files
Figure 4.3.2-e. Substitutable Parameters for AQEMS10
97
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.1
PARM STANDARDS SORT
PROGRAM ASRSTND (AQ0170)
Page 1
Release Date: 4/30/79
Update #: 24
4.4 PARAMETER STANDARDS FILE
4.4.1 PARAMETER STANDARDS FILE TRANSACTION SORT PROGRAM - ASRSTND (AQ0170)
4.4.1.1 Description
ASRSTND (AQ0170) sorts parameter standards file transactions into the
sequence required by the parameter standards file maintenance program AEMSTND
(AQ0090); Figure 4.4.1-a details this sort order. All parameter standards
file transactions must be sorted by ASRSTND (AQ0170) before they can be used
to update (or create) the parameter standards file. See Section 4.4.2 for
additional information on the parameter standards file transactions.
4.4.1.2 File Formats
Input to ASRSTND (AQ0170) consists solely of the parameter standards file
transactions. Refer to Section 4.4.2.2 for the parameter standards file
transaction format.
ASRSTND (AQ0170) produces two output files: a file containing the sorted
parameter standards file transactions and a diagnostic report. The transac-
tions are in the same sequence as the parameter standards file and can be used
as input to the parameter standards file maintenance program AEMSTND (AQ0090).
An example of the diagnostic report is shown in Figure 4.4.1-b.
4.4.1.3 Options
There are no options.
4.4.1.4 Error Messages
There are no error messages.
98
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.3.2 Page 66
SITE FILE MAINTENANCE Release Date: 5/01/81
PROGRAM AEMSITE (AQ0080) Update #: 28
Record Position Field Length Description
261 1
262 1
263 - 268 6
269 1
270 1
271 . 1
272 1
273 - 297 25
298 1
299 - 301 3
302 - 308 7
309 - 333 25
334 1
335 - 337 3
338 - 344 7
345 - 405 61
406 - 466 61
467 - 527 61
528 - 529 2
530 - 534 5
535 - 536 2
537 1
538 - 540 3
541 - 546 6
547 - 550 4
551 - 553 3
Not Meeting With Waiver
Ref/Equ Method Used
When Ref/Equ Method Will Be Used
(MMDDYY)
Used for TSP PSI
Filters to EMSL
TSP NASN Station
Meteorological Data at Site
Regional Office Contact Person
Regional Office Contact FTS
Regional Office Contact Area Code
Rjgional Office Contact Phone
State/Local Contact Person
State/Local FTS
State/Local Area Code
State/Local Phone
Supporting Agency
Lab Collecting
Lab Analyzing
Number of Parameters
Parameter Code
Method Code
SLAMS/NAMS ID [Repeating Section
Equipment Code [(Occurs 1 to 20 times)
Date Calibrated (MMDDYY)
Height of Inlet Probe
in Meters
Reporting Organization Code_
(Page 3 of 3)
Figure 4.3.2-c - continued. AQDHS-II Site File Format
97.52
-------
AQDHS-II SITE FILE MAINTENANCE PROGRAM
DIAGNOSTIC REPORT
PROGRAM NAME: AEMSITE (AQOOSO)
REVISION LEVEL: 4-00
LAST UPDATE «: 29
DATE INCORPORATED: OCTOBER 31, 1931
PAGE 1
OPTIONS IN EFFECT: NOLIST (DEFAULT), FLAGW (USER SPECIFIED), 80 LINES PER PAGE (USER SPECIFIED)
***AEMSITE 086 CONDITIONAL - MISSING OR INVALID LIST OPTION - NOLIST USED
001234567X011112220 XAQMA01SMSA INVALID STATE 01A
***AEMSITE 001 ERROR - COLUMN 1 - INVALID STATE CODE - CARD REJECTED
***AEMSITE 009 WARNING - COLUMN 20 - FIPS CODE SET TO SPACES
010010011X02XX13224001142100021112001122334455 S 02A
***AEMSITE 017 ERROR - COLUMN 13 - INVALID UTM ZONE - DATA REJECTED
***AEMSITE 020 CONDITIONAL - COLUMN 15 - UTM EASTING COORDINATE OUT Or RANGE -
***AEMSITE 022 CONDITIONAL - COLUMN ZZ - UTM NCRTHIN3 COORDINATE OUT OF RANGE
DATA ACCEPTED
- DATA ACCEPTED
«**AEMSITE 016 ERROR - COLUMN 13 - ONE OR MORE UTH FIELDS INVALID - ALL UTM FIELDS REJECTED
***AEMSITE 023 ERROR - COLUMN 30 - INVALID SCCTOR CODE - DATA REJECTED
***AEMSITE 026 ERROR - COLUMN 32 - INVALID E/W HEMISPHERE - DATA REJECTED
***AEMSITE 030 ERROR - COLUMN 40 - INVALID N/S HEMISPHERE - DATA REJECTED
***AEMSITE 025 ERROR - COLUMN 32 - ONE OR MORE GEOGRAPHIC COORDINATES INVALID
- ALL REJECTED
0 ***AEMSITE 034 ERROR - COLUMN 47 - INVALID ELEVATION ABOVE SEA LEVEL - DATA REJECTED
*xj
i,. OU100200A0811111111111111111111U11MONTGOMERY 01A
'-> ***AEMSITE 075 ERROR - DUPLICATE ADD CARD - CARD REJECTED
NUMBER OF INPUT TRANSACTIONS: 187
NUMBbR OF INPUT SITE FILE RECORDS: 0
NUMBER OF OUTPUT SITE FILE RECORDS: 60
NUMBER OF SITES CHANGED: 0
NUMBER OF SITES ADDED: 60
NUMBER OF SITES DELETED: 0
NUMBER OF WARNING MESSAGES: 48
NUMBER OF CONDITIONAL MESSAGES: 13
NUMBER OF ERROR MESSAGES: 91
NUMBER OF ABORT MESSAGES: 0
NUMBER OF DISASTER MESSAGES: 0
PROGRAM NAME: AEMSITE (AQOOSO)
REVISION LEVEL: 4-00
LAST UPDATE «: 29
DATE INCORPORATED: OCTOBER 31, 1981
Fnnnvo A. "3 9_H n-t •^rmne*-*-! ** nAnAU4.
2
>
1 1
^
~H
m
^
o
m
70
o
CT3
TO
-^
m
GO
*_H
—1
m
O
0
00
0
1
cr
a.
a>
ro
=*=
ro
10
-n
,— t
i—
m
o
m
Ja
—1
o
^»
^
O
GO
t— *
—1
m
-n
I— 1
r-
m
3
5=>
*—*
~z
—I
m
O
rn
70
ro
CD
a>
fl>
o
CU
r+
rc
1— '
o
GO
1—"
oo
1 — '
>
o
:r
V
h— 4
t— t
GO
m
— I
o
•?»
f"
GO
•
ro
TD
(S
fO
(Tl
~J
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.1
PARM STANDARDS SORT
PROGRAM ASRSTND (AQ0170)
Page 2
Release Date: 4/30/79
Update #: 24
4.4.1.5 Cataloged JCL
ASRSTND (AQ0170) should always be executed in conjunction with the
parameter standards file maintenance program AEMSTND (AQ0090). See Section
4.4.2.5 for a discussion of the cataloged procedure AQEMD10, which executes
both programs.
4.4.1.6 Warnings and Special Instructions
Note that the COBOL sort verb is used in this program; therefore, the
collating sequence for alphanumeric fields is determined by the computer at
the user's particular installation.
In addition to the diagnostic report produced by ASRSTND (AQ0170),
messages generated by the sort-merge package will be printed. The format and
content, as well as the physical location, of these messages depend upon the
user's particular installation.
4.4.1.7 Cost Considerations
The following estimates are for the execution of ASRSTND (AQ0170) on an
IBM 370/168:
Number of parameter standards file transactions:
CPU time:
I/O time:
Total time:
80 transactions
.4 second
7.7 seconds
8.1 seconds
Estimated cost:
$1.34
99
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.1
FARM STANDARDS SORT
PROGRAM ASRSTND (AQ0170)
Page 3
Release Date: 4/30/79
Update #: 24
4.4.1.8 Related Programs and. Procedures
ASRSTND (AQ0170) should always be executed in conjunction with the
parameter standards file'maintenance program AEMSTND (AQ0090). The cataloged
procedure AQEMD10 executes both programs.
100
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.1
PARM STANDARDS SORT
PROGRAM ASRSTND (AQ0170)
Page 4
Release Date: 4/30/79
Update #:• 24
Record Position
Description
Sort Order
1 - 5
6
7 - 8
9
Parameter Code
Standard type
Standard Number
Standard Flag
Ascending
Ascending
Ascending
Ascending
Figure 4.4.1-a. Sort Sequence for Parameter Standards File Transactions
101
-------
AQDHS-II PARAMETER STANDARDS FILE TRANSACTION SORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME! ASRSTND (A00170)
REVISION LEVEL! 1-00
LAST UPDATE *: 24
DATE INCORPORATED: OCTOBER 11 • 1976
NUMBER OF TRANSACTIONS READ:
NUMBER OF TRANSACTIONS WRITTEN:
85
85
O
ro
Figure 4.4.1-b. Diagnostic Report
2 TI >
> •-. jo
i—i I— O
z m :r
-H CO
m o i
Z 50 >-•
j» m i—i
z J>
O -H
o
0
co
30
co
JO
o
CO
m
o
CO O
O
co
CO
o
T3
CL
Q)
fD
—"
n>
Ol
to
o
01
ft)
CO
o
—i
vo
CD
n>
en
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
FARM STANDARDS MAINTENANC
PROGRAM AEMSTND (AQ0090)
Page 1
Release Date: 4/30/79
Update #: 24
4.4.2 PARAMETER STANDARDS FILE MAINTENANCE PROGRAM - AEMSTND (AQ0090)
4.4.2.1. Description
AEMSTND (AQ0090) creates and maintains the AQDHS-II parameter standards
file. It uses information from input parameter standards transactions to add,
delete, or replace records on an existing parameter standards file. To create
a parameter standards file, AEMSTND (AQ0090) is executed with add transactions
and no input parameter standards file.
The format of the parameter standards file is shown in Figure 4.4.2-a.
Each record in the parameter standards file contains a primary standard
and/or a secondary standard.
The parameter standards file is used by the master file detailed
report program, ARPMSTR (AQ0230), as the source of the federal and state
parameter standards. Examples of the master file detailed report are shown
in Figure 6.2.3-a. ARPMSTR (AQ0230) selects the parameter standards from
the parameter standards file in the following manner. The records in the
parameter standards file are stored in a table. The table is searched for a
match of the parameter and units codes on the master file. If more than one
match of parameter and units codes is found, the first match encountered
is used in the detailed report. If no match of the parameter and units
codes is found, but one or more match of the parameter code is found the
first such match is used. This procedure is followed for both the federal
and state standards. If no match is found for either standard, then
that standard will be omitted from the report.
Since the standard number field is a part of the key of the parameter
standards file, it partially determines the order of records in the parameter
standards file and thereby affects the priority used in selecting parameter
103
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 2
Release Date: 4/30/79
Update #: 24
standards. The user should insure that for each parameter code standard type,
and units code, the lowest standard number is used for the Standard he wants
to appear in the master file detailed report.
The format of the parameter standard file transactions is shown in Figure
4.4.2-b. The key of each transaction contains the following information:
parameter code, standard type, standard, number, and standard flag (primary or
secondary standard).. To delete or replace a standard on the parameter
standards file, a transaction with exactly the same key must be entered. If
the standard description is not blank, the corresponding standard will be
replaced in the file; if it is blank, the primary and secondary standard (i.e.
the entire parameter standards record) will be deleted if the standard flag is
'!', or the secondary standard will be deleted if the standard flag is '2'.
To add a standard to the parameter standards file, a transaction must be
entered that has a key that is not in the existing file and has a loern-blank
description field.
Figure 4.4.2-c presents a description of parameter standards transaction
fields and their valid codes.
4.4.2.2. File Formats
Input to AEMSTND (AQ0090) consists of an AQDHS-II parameter standards
file and a parameter standards transaction file; the formats of these files
are shown in Figure 4.4.2-a and Figure 4.4.2-b, respectively.
Input transactions must be sorted into the sequence shown in Figure
4.4.1-a prior to their use by this program. Sorting can be done by executing
the parameter standards sort program ASRSTND (AQ0170).
104
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 3
Release Date: 4/30/79
Update #: .24
Output consists of an updated AQDHS-II parameter standards file and a
diagnostic report. The diagnostic report contains the standard program update
messages, a list of the input transactions with the action taken by AEMSTND
(AQ0090), any applicable diagnostic messages, and the following statistical
messages: (1) the number of standards added; (2) the number of standards
deleted; (3) the number of standards replaced; (4) the number of input
parameter standards file records; (5) the number of output parameter standards
file records; and, (6) the number of errors detected. An example of the
diagnostic report is shown in Figure 4.4.2-d.
4.4.2.3 Options
There are no options.
4.4.2.4 Error Messages
AEMSTND 001 ERROR - NON-NUMERIC PARAMETER CODE - TRANSACTION REJECTED
Meaning: The parameter code field columns 1-5 contains alphabetic
characters.
Action: Correct the parameter code and resubmit the transaction.
AEMSTND 002 ERROR - INVALID FEDERAL OR STATE FLAG
Meaning: An illegal character has been found in the standard type field
(column 6).
Action: Correct the standard type (F for federal or S for state
standard) and resubmit the transaction.
AEMSTND 003 ERROR - NON-NUMERIC STANDARD NUMBER CODE
Meaning: Alphabetic characters have been found in the standard rfumber
field (columns 7-8).
Action: Correct the standard number and resubmit the transaction.
105
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 4
Release Date: 4/30/79
Update #: 24
AEMSTND 004 ERROR - INVALID PRIMARY/SECONDARY CODE
Meaning: An illegal character has been found in the standard flag field
(column 9).
Action: Correct the standard flag (1 for primary or 2 for secondary)
and resubmit the transaction.
AEMSTND 005 ERROR - NON-NUMERIC UNITS-CODE
Meaning: An alphabetic character has been found in the units code field
(columns 10-11).
Action: Correct the units code and resubmit the transaction.
AEMSTND 006 ERROR - NO MATCHING KEY ON MASTER FILE - DELETE REQUEST
IGNORED - SET REJECTED
Meaning: No record in the input parameter standards file has the same
key information as the indicated transaction; therefore, no
record can bexdeleted.
Action: Correct the key information on the indicated transaction if
"replace" or "add" action is intended rather than "delete",
columns 12-61 (standard description) should not be blank.
Resubmit the transaction.
4.4.2.5 Cataloged JCL
4.4.2.5.1 JCL Listing - AEMSTND (AQ0090) can be run by executing the
cataloged procedure AQEMD10. This procedure also executes the parameter
standards sort program ASRSTND (AQ0170).
See Figure 4.4.2-e for a listing of this procedure.
106
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 5
Release Date: 4/30/79
Update #: 24
4.4.2.5.2 Cross Reference of DD names and files
Program Name: ASRSTND (AQ0170)
DD Name
AQSINPUT
SORTWK01
AQSOUTPT
AQSPRINT
File Description
AQDHS-II parameter standards
file transactions
Sort work file
Sorted AQDHS-II parameter
standards file transactions
Diagnostic report
Program Name: AEMSTND (AQ0090)
DD Name
AQSCARDS
AQSOLDFL
AQSSTDFL
AQSPRINT
File Description
Sorted AQDHS-II parameter
standards file transactions
Old AQDHS-II parameter
standards file
New (or updated) AQDHS-II
parameter standards file
Diagnostic report
Input/Output
Internal
Output
Input/Output
Input
Input
Output
4.4.2.5.3 User-supplied JCL -To execute the cataloged procedure AQEMD10, the
user must supply job accounting information, the input transaction card
file, and the data set names of the old and new (or updated) AQDHS-II
parameter standards files. Other JCL elements likely to be supplied by the
user are the time parameters. See Figi/re 4.4.2-f for a description of the
procedure's substitutable parameters.
107
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 6
Release Date: 4/30/79
Update #: 24
4.4.2.5.4 Sample run streams - The following run stream would produce an
updated AQDHS-II parameter standards file named 'CN.EPALMH.A087.CDHS.HQ.AQS.
DATA.HTSTNDAB1 from an existing AQDHS-II parameter standards file named 'CN.
EPALMH.A087.CDHS.HQ.AQS.DATA.HTSTNDAA1 and an input parameter standards
transaction card file.
// EXEC AQEMD10
ot-DS-TAW
// -etDMSfRfHTSTNOAA,
// -NfWMSfl^HTSTNDAB
//SORT. INPUT DD *
(parameter standards transactions)
/*
4.4.2.6 User Warnings
For proper updating, the input AQDHS-II parameter standards transactions
must be sorted into the correct sequence (see Section 4.4.2.2).
Extra care should be taken in providing transaction key information to
insure that the right record is added, replaced, or deleted.
The standard number field determines the priority to be used by program
ARPMSTR (AQ0230) in selecting the parameter standards for the master file
detailed report (refer to 4.4.2.1). The user should insure that for each
parameter code, standard type, and units code, the lowest standard number is
used for the standard he wants in the master file detailed report.
108
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 7
Release Date: 4/30/79
Update #: 24
4.4.2.7 Cost Considerations
The following estimates are for the execution of AEMSTND (AQ0090) on an
IBM 370/168:
Number of sorted parameter
standards file transactions:
CPU time:
I/O time:
Total time:
Estimated cost:
4.4.2.8 Related Programs and Procedures
43 transactions
.2 seconds
3.2 seconds
3.4 seconds
$.68
ASRSTND (AQ0170) should always be executed prior to AEMSTND (AQ0090).
The cataloged procedure AQEMD10 executes both programs.
109
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
FARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 8
Release Date: 4/30/79
Update #: 24
Record Field
1 - 5
6
7-8
9-10
11 - 60
61 - 62
63 -112
Field Length
5
1
2
2
50
2
50
Description
Parameter code Record
Standard type > key
Standard number |
Primary standard units code
Primary standard
Secondary standard units code
Secondary standard um'ts-eode-
Figure 4.4.2-a. AQDHS-II Parameter Standards File Format
110
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 9
Release Date: 4/30/79
Update #: 24
Card Column
1
7
10
12
62
- 5
6
- 8
9
- 11 .
- 61
- 60
5
1
2
1
2
50
19
Field Length Data Type
Numeric
Alphabetic
Numeric
Numeric
Numeric
Alphanumeric
Description
Parameter code
Standard type (F or S)
Standard number
Standard flag (1 or 2)
^Transaction
Key
Units code
Standard description
Not used
Figure 4.4.2-b. AQDHS-II Parameter Standards File Transaction Format
111
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
FARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 10
Release Date: 4/30/79
Update #: 24
Parameter code:
Identifies the parameter for which a standard is
being specified.
Valid codes:
Field length:
Refer to AEROS Manual Series, Volume V: AEROS
Manual of Codes for a complete list of currently
accepted parameter codes.
Five characters.
Standard description: A prose description of the standard.
Field length: 50 characters.
Standard flag:
Valid codes:
Field length:
Identifies the standard as a primary standard (1)
or a secondary standard (2).
1, 2
One character
Standard number:
Field length:
A number that identifies the priority to be used
in selection standards from the parameter standards
file (refer to 4.4.2.1).
Two characters
Standard type:
Valid Codes:
Field length:
Identifies the standard as a federal standard (F)
or a state standard (S).
F, S.
One character.
(page 1 of 2)
Figure 4.4.2-c. Parameter Standards File Transaction Field Descriptions
112
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 11
Release Date: 4/30/79
Update #: .24
Units code: Indentifies the units in which the standard is expressed.
Valid codes: Refer to AEROS Manual Series, Volume V: AEROS
Manual of Codes for a complete list of currently
accepted units codes.
Field length: Two characters.
(page 2 of 2)
Figure 4.4.4-c - Continued. Parameter Standards File Transaction Field
Descriptions
113
-------
PROGRAM NAME: AEMSTNO («ooo«o)
REVISION LEVELI 1-00
LAST UPDATE •! 24
DATE INCORPORATED! OCTOBER Sir 1978
INPUT/ERRORS
AODHS-II PARAMETER STANDARDS FILE MAINTENANCE PROGRAM -
DIAGNOSTIC REPORT
PAGE
ACTION
44201F02107 0.08 PARTS/MILLION* 1 HR. MAX, 1 PER YR
«•* ADDED
44201F02207 0.08 PARTS/MILLION/ 1 HR MAX, 1 PER HR.
»*• ADDED
44201SOI101 155 U6/M3 (25 C) .1 HR. MAX, 1 PER VR.
»•• ADDED
44201S01201 ISS UG/M3 (25 C) ,1 HR. MAX, 1 PER YR.
•** ADDED
4420IS02107 0.06 PARTS/ MILLION, 1 HR. MAX, 1 PER YR.
**• ADDED
44201S02207 0.06 PARTS/ MILLION, 1 HR. MAX, 1 PER YR.
«•• ADDED
NUMBER OF STANDARDS ADDEDI 65
(DUMBER OF STANDARDS DELETED: 0
NUMBER OF STANDARDS REPLACED! 0
NUMBER OF INPUT PARAMETER STANDARDS FILE RECORDSl 0
NUMBER OF OUTPUT PARAMETER STANDARDS FILE RECORDS! 45
NUMBER OF ERRORS DETECTED! 0
Figure 4.4.2-d. Diagnostic Report
> •-• JO
•-« r— o
z m 3:
—I CO
m o i
z
O
m 1-4
^ -O CO
73 3> m
o -yo o
CD 2 -H
^3 •—I
i> co CD
m o •
2 3> 4*
CO xO •
—I o ro
z co
O —I
o m
to z
O 3s
o
(D fa
CL —• to
O) to n>
n>
ro
o
o>
co
o
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 13
Release Date: 4/30/79
Update #: 24
PROCEDURE NAMEl AQEMD10
REVISION LEVtU 1-00
LAST UPDATE *i 24
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO MAINTAIN THE PARAMETER
TILE
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQEMD10 PROC PROJf.CT = 'CIJ.EPALMH, A087.CDHS.HQ. A03'
// PRUG1=ASRSTND,
// PROG2=AEMSTND,
// OLDSTANsAQOLDSTD,
// NEWSTANsAONEWSTD,
// UNITs3330,
// SERlALsCDHSPK,
// DISP='NKW,CATLG, DELETE',
3PCUNIT=TRK,
PRIMARYalO,
SECNDRYsS,
TEMPsSYSDA,
//
//
//
//
//*
//SORT
//
//STEPLIB
//
OUTsA
EXEC PGMsdPROGl,
TIME=(1,0)
UD DSNAMEX&PROJECT..LOAD,
VOLUME=(PRIVATE,RETA IN),
DISP=(SHR,PASS)
//* SORT INCOMING TRANSACTIONS INTO FILE SEQUENCE
//*
//SORTLIB DD DSNAMEaSYSl.50RTLIB,
// DISP=(SHR,PASS)
//*
//SYSOUT
//*
//SORTrtKOl
//
//*
//SORTWK02
00 SYSOUTs&OUT
DD UNIT=*TEMP,
SPACES ( IRK, &SORTSPC,,CONTIG)
DD
SPACE* (TRK,&SORTSPC,,CONTIG)
//SORTWK03 DD UNIr=(&TEMP,SEP=(SORTWK01,SORTWK02)),
// SPACEs(TRK,RS()RTSPC,,CONTIG)
//*
//* INPUT DATA SET - PARAMETER STANDARDS FILE TRANSACTIONS
//*
//AOSINPUT DD DDNAMEsINPUI,
// DCB=BLKSIZE=80
//* OUTPUT DATA SET • SORTED TRANSACTIONS
//*
//AOSOUTPT DD UNITs(RTEMP,SEP=(SORTWK01,SORTWK02,SORTWK03)),
// DISP=(NEW,PASS,DELETE),
// SPACEs(TRK,RSORTSPC,HLSt),
// DSNAME = S.RTRANS,
00000100
00000?00
00000300
00000400
ooooosoo
00000600
STANDARDS00000700
oooooaoo
00000900
00001000
00001100
00001200
00001300
00001100
00001500
OOOOlhOO
00001700
ooooiaoo
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002«00
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
OOOOUOOO
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
Figure 4.4.2-e.
(Page 1 of 3)
Cataloged Procedure AQEMD10
115
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 14
Release Date: 4/30/79
Update #: 24
ft OCB=(RECFM=F,LRECLs80,BLKSIZEs80)
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//AQSPRINT DO SY30UT=&OUT
//*
//* OUTPUT OATA SETS - SYSTEM OPERATION
//*
//SYSPRINT 00 SYSOUTstOUT
//*
//SYSOUT OD SYSOUTs&UUT
//*
//SYSDBOUT 01) SYSOUTs&OUT
//*
//SYSDTEKM DD SYSOUTs&UUT
//*
//SYSUOUMP 00 SYSOUT=ROUT
//*
//*
//UPDATE tX£C PGM=&PRCJG2r
// REGIONS60K,
// TIME»(1,0)
//*
//* MAINTAIN PARAMETER STANDARDS FILfr
//*
//3TF.PLIB DD DSNAMEs&PROJECT. .LOAD,
ft VIJLUME = (PRIVATE,RETAIN),
// OISP=(SHR,PASS)
tt DO DSNAME=SYS1.CC)HLI8,
// DI3Ps(SHR,PASS)
//*
//* INPUT DATA SET - SORTED TRANSACTIONS
//*
//AOSCAR08 00 DSNAMEs&RTRANS,
// DISP«(OLD,OtLETt)
//*
//* INPUT DATA Sfr.T • OLD PARAMETER STANDARDS FILE
//*
//AHSOLDFL DO DSNAMKsfcPROJECT..DATA.MJLOSTAN,
// VULUME=(PRIVATE,RETAIN),
// I)ISPB(3HR,PASS)
//*
//* OUTPUT OATA SET - NEW PARAMETER STANDARDS FILE
//AQSSTDFL 00 UNIT=RUNIT,
tt VOLUMES (PRIVATE, RtTAIN,3ERs&8fcRI At),
// DISP«(JOISf),
ft SPACES USPCUNIT,UPRIMARY,HSECNORY),RLSE),
// DSNAMf.a»pROJECT,.OATA,*Nf.WSTAN
//*
//* OUTPUT OATA StT • DIAGNOSTIC MESSAGES
//*
//AQSPRINT 00
//* OUTPUT OATA SETS - SY3TFM OPERATION
//*
//SYSPRINf 00 SY3()llTBM)UT
00005900
00006000
00006100
00006200
00006300
00006400
00006SOO
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
ooooeooo
00006100
ooooe?oo
00008300
00008400
00008500
00008600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009<)00
00009600
00009700
00009000
00009900
00010000
00010100
00010200
00010300
00010400
00010'JOO
00010600
00010700
00010800
00010900
ooonooo
00011100
000)1800
00011300
00011400
00011500
00011600
Figure 4.4.2-e - continued,
(page 2 of 3)
Cataloged Procedure AQEMD10
116
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 15
Release Date: 4/30/79
Update #: 24
//svsnut
//*
//SYSDBOUT
//*
//SYSOTEKM
//*
//3YSUDUMP
//*
OD SYSCJUTs&OUT
1)0 SYSOUTs&OUT
DO SYSOUTs&OUT
DO SYSOUT=»OUT
00011700
00011800
00011900
00012000
oooieioo
00012200
00012500
00012400
Figure 4.4.2-e - continued.
(Page 3 of 3)
Cataloged Procedure AQEMD10
117
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 16
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROG1
PROG2
OLDMSTR
NEWMSTR
UNIT
SERIAL
DISP
Default .
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ASRSTND
AEMSTND
AQOLDSTD
AQNEWSTD
3330
CDHSPK
'NEW.CATLG,DELETE'
Description
Highest-level index of data set
names (e.g., CN.EPALMH.A087.
CDHS.HQ.AQS.DATA.AQOLDSTD would
be the old parameter standards
file
Parameter standards file trans-
action sort program.
Name of the parameter data set.
Parameter standards file main-
tenance program.
Lowest-level index of old para-
meter standards file
Lowest-level index of new (or
updated) parameter standards
file.
Unit type to which new (or up-
dated) parameter standards
file is to be written
Volume serial number of the
volume to which new (or updated)
parameter standards file
is to be written
Disposition of new parameter
standards file
(page 1 of 2)
Figure 4.4.2-f. Substitutable Parameters for AQEMD10
118
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.4.2
PARM STANDARDS MAINTENANCE
PROGRAM AEMSTND (AQ0090)
Page 17
Release Date: 4/30/79
Update #: .24
Parameter
Name
SPCUNIT
PRIMARY
SECNDRY
TEMP
SORTSPC
OUT
Default
Value
TRK
10
5
SYSDA
10
A
Description
Units in which space for new
parameter standards file is to
be allocated
Primary space allocation for
new (or updated) parameter stan-
dards file.
Secondary space allocation for
new (or updated) standards file.
Unit type for temporary work
space
Number of tracks to be allocated
for the sort work space
SYSOUT class for all print files
(page 2 of 2)
Figure 4.4,2-f - Continued. Substltutable Parameter's for AQEMD10
119
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 1
Release Date: 4/30/79
Update #: 24
4.5 MASTER FILE
4.5.1 MASTER FILE TRANSACTION EDIT PROGRAM - AEDMSTR (AQ0060)
4.5.1.1 Description
The AQDHS-II master file is created and updated by AQDHS-II input
transactions. These transactions can be either add, change, or delete
transactions. The master file transaction edit program edits the input
transactions and converts those that pass the edit criteria into internal
transactions that can be input to the master file maintenance program AFMMSTR
(AQ0100). There are three formats for the AQDHS-II input transactions: Form
1, Form 2, and Form 3. The Form 1 transactions are used to enter multiple
readings taken at less than daily intervals for a single parameter at a given
site. The Form 2 transactions are used to enter readings taken at daily or
greater than daily intervals for multiple parameters; also, Form 2 transactions
are used to enter composite data. The Form 3 transactions are used to enter
readings taken at daily or greater than daily intervals for multiple sites.
See Figure 4.5.1-a for an illustration of these various formats and Appendix D
for examples of the load sheets.
The input transactions can be entered in any order as the editing of a
transaction is done independently of other transactions. AEDMSTR (AQ0060)
edits each field of each transaction for proper format and, where possible,
proper content. See Figure 4.5.1-b for a description of the AQDHS-II
transaction fields and their valid codes. Additionally, AEDMSTR (AQ0060)
checks the parameter, method, and units codes of each transaction against the
parameter file and rejects any that are not on that file. An analogous check
is made for the site code group (state, area, site, agency, and project codes);
the AQCR, county, and SLAMS/NAMS ID codes from the matching site file record
are inserted in the transaction. Other special edits include checking that
120
-------
AQDH5-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 2
Release Date: 4/30/79
Update #: 24
negative readings are valid for the given parameter and comparing readings for
certain parameters to established maximum values. See Appendix A Table 5 for a
list of the valid negative parameters and Appendix A Table 6 for a list of
maximum values for parameters.
Each input transaction is a physical record (card) containing one or more
logical records (records containing common key information). A Form 1
transaction is a physical record containing one (1) logical record. A Form 2
transaction is a physical record containing from one (1) to four (4) logical
records; i.e., there is one logical record for each parameter entry in a Form 2
transaction. A Form 3 transaction is a physical record with from one (1) to
four (4) logical records; i.e., one (1) logical record for each site entry.
AEDMSTR (AQ0060) edits and rejects the logical record, not the physical
record; i.e., one or several logical records on a physical record may fail the
edit and be rejected even though the other logical records pass the edit and
are converted to internal transactions. This method of rejecting only logical
records insures the integrity of the master file while allowing the user to
pass as many valid logical records as possible during one execution of AEDMSTR
(AQ0060).
The logical record is rejected if any field is in error. If a common
key field is in error, all logical records on the physical record will be
rejected. Also, if the action code or action code/status flag combination is
invalid, all logical records on that physical record will be rejected. By
format type, the following rules apply:
Form 1: Form 1 transactions consist of one and only one
logical record. That logical record is rejected
if any field is in error.
121
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 3
Release Date: 4/30/79
Update #: 24
Form 2: A logical record is rejected if the parameter,
method, or units code, the decimal position, or
the reading for that logical record is in error.
All logical records on the physical record (card)
are rejected if a common key field is in error, or
if either the action code or action code/status
flag combination is invalid.
Form 3: A logical record is rejected if the start hour,
site code group, or reading for that logical
record is in error.
All logical records on the physical record
(card) are rejected if a common key field
is in error, or if either the action code
or action code/status flag combination is
invalid.
See Figure 4.5.1-b for a description of each
field and its valid entries.
4.5.1.2 File Formats
AEDMSTR (AQ0060) uses four input files: the parameter file, the site
file, the AQDHS-II transaction file, and an option card. See Sections
4.2.2.2 and 4.3.2.2 for the parameter and site code file formats. See
Figure 4.5.1-a for the transaction formats and Figure 4.5.1-b for a
description of the fields. The options are discussed in the following
section.
122
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 4
Release Date: 4/30/79
Update #: 24
AEDMSTR (AQ0060) produces a file containing internal transactions and a
diagnostic report. The output internal transactions are in the format
required for input to the file maintenance program but are not in the
required sort order. The internal transaction sort program must be run on
these transactions prior to running the file maintenance program (see Section
4.5.2 Master File Internal Transaction Sort Program). Figure 4.5.1-c
illustrates the format of the internal transactions.
The diagnostic report consists of a listing of input transactions
containing one or more logical records which failed the edit. An error
message is printed with each transaction indicating both the invalid data and
the field where it is contained. This listing does not contain those trans-
actions which caused warning messages but did not fail the edit unless the
user requests that listing via an option card. The diagnostic report also
lists the update messages as well as summary statistics giving the options in
effect, the number of input transactions, the number of output internal
format transactions, and the number of errors detected. See Figure 4.5.1-d
for art example of the diagnostic report.
1 •
AEDMSTR (AQ0060) also produces an optional listing of the rinput trans-
actions which passed the edit. See Section 4.5.1.3 Options for a discussion
of this listing and instructions for producing it, and Figure 4.5.1-e for
an example of this listing.
4.5.1.3 Options
AEDMSTR (AQ0060) produces two optional listings: (1) a confirmation
listing of input transactions which passed the edit, and (2) a listing of
input transactions which contain questionable but not rejected data. To
select one or both of these listings, the user must include an option card in
the execution deck (see Section 4.5.1.5 Cataloged JCL). Figure 4.5.1-f
illustrates the required format of the option card.
123
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT .
PROGRAM AEDMSTR (AQ0060)
Page 5
Release Date: 4/30/79
Update #: 24
The LIST option produces the input transaction, confirmation listing;
i.e., a listing of those records which passed the edit. If this option is in
effect, the entire physical record (transaction card) will be printed whenever
at least one logical record on that card passes the edit. If any of the
logical records failed the edit, the transaction card-and error messages will
also be printed in the diagnostic report. This listing of valid input
transactions is an independent listing and is separate from the diagnostic
report; the LIST option must be .specified for it to be produced. If this
option is not specified, its default, NOLIST, is in effect and the valid
transaction listing will not be produced; however, the diagnostic report is
always produced.
If the NOLIST option is specified, no listing of valid transactions will
be produced. However, the diagnostic report listing all transactions which
failed the edit will still be produced. Specifying the NOLIST option produces
the same result as not specifying LIST.
The FLAGW option produces a listing of those transactions which contain
logical records that are questionable but were not rejected. Such records
produce warning messages indicating the questionable data and the field
containing it. This listing is contained in the diagnostic report along with
the listing of the rejected transactions whenever the FLAGW option is in
effect. If FLAGW is not specified, its default, NOFLAGW, is in effect and
this listing will not be produced. However, the rejected transactions will
still be listed. ' ~
If the NOFLAGW option is specified, no listing of questionable
transactions will be produced. However, the diagnostic report will still be
produced. Specifying the NOFLAGW option produces the same result as not
specifying FLAGW.
If no option card is included in the execution deck, or if an invalid
option card is included, the default options NOLIST and NOFLAGW will be in
effect.
124
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 6
Release Date: 4/30/79
Update #: 24
4.5.1.4 Error Messages
AEDMSTR 001 ERROR - COLUMN 01 - INVALID TRANSACTION CODE - CARD REJECTED
Meaning: The only valid transaction codes are 1, 2, and 3.
Action: Correct and resubmit.
AEDMSTR 002 ERROR - COLUMN 01 - NON-NUMERIC TRANSACTION CODE - CARD REJECTED
Meaning: The only valid transaction codes are 1, 2, and 3.
Action: Correct and resubmit.
AEDMSTR 003 ERROR - COLUMN 80 - INVALID ACTION CODE - CARD REJECTED
Meaning: The only valid action codes are 1 (Delete), 2 (Add), and 3
(Change).
Action: Correct and resubmit.
AEDMSTR 004 ERROR - COLUMN 80 - NON-NUMERIC ACTION CODE - CARD REJECTED
Meaning: The only valid action codes are 1 (Delete), 2 (Add), and 3
(Change).
Action: Correct and resubmit.
AEDMSTR 005 ERROR - COLUMN xx - INVALID TIME CODE - CARD REJECTED
Meaning: The time code beginning in column xx is invalid. The valid time
codes are shown in Appendix A, Table 3.
Action: Correct and resubmit.
AEDMSTR 006 ERROR - COLUMN 02 - NON-NUMERIC STATE CODE - CARD REJECTED
Action: Correct and resubmit.
xx - Column Number yy - Group Number
125
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 7
Release Date: 4/30/79
Update #: 24
AEDMSTR 007 ERROR - COLUMN 02 - INVALID STATE CODE - CARD REJECTED
Meaning: The state code is not in the site file.
Action: Correct the state code or update the site file and resubmit.
AEDMSTR 008 ERROR - COLUMN xx - NON-NUMERIC AREA CODE - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 009 ERROR - COLUMN xx - NON-NUMERIC SITE CODE - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 010 ERROR - COLUMN xx - NON-ALPHABETIC AGENCY CODE - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR Oil ERROR - COLUMN xx - NON-NUMERIC PROJECT CODE - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 012 ERROR - COLUMN xx - NON-NUMERIC TIME CODE - CARD REJECTED
Meaning: The time code beginning in column xx is invalid. The valid time
codes are shown in Appendix A, Table 3.
Action: Correct and resubmit.
AEDMSTR 013 ERROR - COLUMN xx - NON-NUMERIC YEAR - CARD REJECTED
Action: Correct and. resubmit.
AEDMSTR 014 ERROR - COLUMN xx - YEAR LESS THAN SIXTY - CARD REJECTED
Meaning: SAROAD does not accept data prior to 1960.
xx - Column Number yy - Group Number
126
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 8
Release Date: 4/30/79
Update #: 24
AEDMSTR 015 ERROR - COLUMN xx - NON-NUMERIC MONTH - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 016 ERROR - COLUMN xx - MONTH ZERO OR GREATER THAN TWELVE - CARD
REJECTED
Action: Correct and resubmit.
AEDMSTR 017 ERROR - COLUMN xx - NON-NUMERIC DAY - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 018 ERROR - COLUMN xx - INVALID DAY - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 019 ERROR - COLUMN xx - NON-NUMERIC START HOUR - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 020 ERROR - COLUMN xx - DECIMAL POSITION GREATER THAN FOUR - CARD
REJECTED
Meaning: AQDHS-II currently will not accept a decimal position greater
than four.
Action: Change units, data value, and decimal code to accomodate the
new decimal and resubmit.
AEDMSTR 021 ERROR - COLUMN xx - NON-NUMERIC PARAMETER CODE - CARD REJECTED
Action: Correct and resubmit.
xx - Column Number yy - Group Number
127
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 9
Release Date: 4/30/79
Update #: 24
AEDMSTR 022 ERROR - COLUMN xx - NON-NUMERIC METHOD CODE - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 023 ERROR - COLUMN xx - NON-NUMERIC UNITS CODE - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 024 ERROR - COLUMN xx - NON-NUMERIC DECIMAL POSITION - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 025 ERROR - COLUMN 21 - START HOUR INVALID FOR TIME CODE - CARD
REJECTED
Meaning: See Appendix A, Table 3 for valid time codes versus start hour.
Action: Correct and resubmit.
AEDMSTR 026 WARNING - COLUMN xx - START HOUR GREATER THAN TWENTY-THREE - CARD
ACCEPTED
Meaning: An erroneous start hour has been coded; however, this will not
affect the operation of the programs or the file sequence (for
Form 2 and 3 data only).
Action: No action required.
AEDMSTR 027 ERROR - COLUMN xx - NON-NUMERIC READING - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 028 ERROR - RECORD CONTAINS NO READINGS - CARD REJECTED
Meaning: The transaction contains no readings for Form 1 data or no key
information and readings for Form 2 and Form 3 data.
Action: Correct and resubmit.
xx - Column Number yy - Group Number
128
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 10
Release Date: 4/30/79
Update #: 24
AEDMSTR 029 ERROR - COLUMN 19 - NON-NUMERIC NUMBER OF SAMPLES - CARD REJECTED
Action: Correct and resubmit.
AEDMSTR 030 ERROR - COLUMN 22 - INVALID COMPOSITE TIME CODE - CARD REJECTED
Meaning: The only valid composite time codes are 1-9, A, and B.
Action: Correct and resubmit.
AEDMSTR 031 ERROR - COLUMN 21 - NON-NUMERIC COMPOSITE TYPE - CARD REJECTED
Meaning: The only valid composite type codes are 1 (Quarterly), 2
(Seasonal), 3 (Monthly), 4 (Weekly), and 5 (Annual).
Action: Correct and resubmit.
AEDMSTR 032 ERROR - COLUMN 17 - NON-NUMERIC PERIOD - CARD REJECTED
Meaning: The composite period field contains non-numeric data.
Action: Correct and resubmit.
AEDMSTR 033 ERROR - COLUMN 17 - INVALID PERIOD - CARD REJECTED
Meaning: The composite period field contains invalid data; see Section
4.5.1.2, Figure 4.5.1-b for the valid codes.
Action: Correct and resubmit.
AEDMSTR 034 ERROR - COLUMN 21 - INVALID COMPOSITE TYPE - CARD REJECTED
Meaning: See Section 4.5.1.2, Figure 4.5.1-b for the valid codes.
Action: Correct and resubmit.
AEDMSTR 035 ERROR - COLUMN xx - INVALID AREA CODE - CARD REJECTED
Meaning: The area code specified is not in the site file.
Action: Correct the area code or update the site file and resubmit.
xx - Column Number yy - Group Number
129
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 11
Release Date: 4/30/79
Update #: 24
AEDMSTR 036 ERROR - COLUMN xx - INVALID SITE CODE - CARD REJECTED
Meaning: The site code specified is not in the site file.
Action: Correct the site code or update the site file and resubmit.
AEDMSTR 037 ERROR - COLUMN xx - INVALID AGENCY CODE - CARD REJECTED
Meaning: The agency code specified is not in the site file.
Action: Correct the agency code or update the site file and resubmit.
AEDMSTR 038 ERROR - COLUMN xx - INVALID PROJECT CODE - CARD REJECTED
Meaning: The project code specified is not in the site file.
Action: Correct the project code or update the site file and resubmit.
AEDMSTR 039 ERROR - COLUMN xx - INVALID PARAMETER CODE - CARD REJECTED
Meaning: The parameter code specified is not in the parameter file.
Action: Correct the parameter code or update the parameter file and
resubmit.
AEDMSTR 040 ERROR - COLUMN xx - INVALID METHOD CODE - CARD REJECTED
Meaning: The method code specified is not in the parameter file.
Action: Correct the method code or update the parameter file and
resubmit.
AEDMSTR 041 ERROR - COLUMN xx - INVALID UNITS CODE - CARD REJECTED
Meaning: The units code specified is not in the parameter file.
Action: Correct the units code or update the parameter file arid
resubmit.
xx - Column Number yy - Group Number
130
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 12
Release Date: 4/30/79
Update #: 24
AEDMSTR 042 CONDITIONAL - COLUMN xx - READING EXCEEDS MAXIMUM PERMITTED
Meaning: The reading exceeds the SAROAD maximum value allowed for the
parameter. However, the data is accepted.
Action: If this value is correct, notify EPA, in writing, when you
submit your data that you have already verified the reading and
that it should be included in SAROAD.
AEDMSTR 043 CONDITIONAL - COLUMN xx - READING EXCEEDS MAXIMUM PERMITTED
Meaning: The reading exceeds the SAROAD maximum value allowed for the
parameter. However, the data is accepted.
Action: If this value is correct, notify EPA, in writing, when you
submit your data that you have already verified the reading and
that it should be included in SAROAD.
AEDMSTR 044 ERROR - COLUMN 79 - INVALID STATUS FLAG - CARD REJECTED
Meaning: Blank and S are the only valid transaction status flag values.
Moreover, S is only valid for add transactions.
Action: Correct and resubmit.
AEDMSTR 045 ERROR - COLUMN xx - INVALID START HOUR (READINGS SPAN END OF
DAY) - REJECTED
Meaning: See Appendix A, Table 3 for valid start hours.
Action: Correct and resubmit.
AEDMSTR 046 CONDITIONAL - MISSING OR INVALID OPTION CARD - DEFAULT OPTIONS
USED
Meaning: An invalid option or no option has been specified. The program
was executed using the default options NOLIST and NOFLAGW.
xx - Column Number yy - Group Number
131
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 13
Release Date: 4/30/79
Update #: 24
AEDMSTft 047 ERROR - COLUMN xx - INVALID AREA CODE - GROUP yy REJECTED
Meaning: The area code specified is not in the site file.
Action: Correct the area code or update the site file and resubmit.
AEDMSTR 048 ERROR - COLUMN xx - INVALID SITE CODE - GROUP yy REJECTED
Meaning: The agency code specified is not in the site file.
Action: Correct the agency code or update the site file and resubmit.
AEDMSTR 049 ERROR - COLUMN xx - INVALID AGENCY CODE - GROUP yy REJECTED
Meaning: The agency code specified is not in the site file;
Action: Correct the agency code or update the site file and resubmit.
AEDMSTR 050 ERROR - COLUMN xx - INVALID PROJECT CODE - GROUP yy REJECTED
Meaning: The project code specified is not in the site file.
Action: Correct the project code or update the site file and resubmit.
AEDMSTR 051 ERROR - COLUMN xx - INVALID PARAMETER CODE - GROUP yy REJECTED
Meaning: The parameter code specified is not in the parameter file.
Action: Correct the parameter code or update the parameter file and
resubmit.
AEDMSTR 052 ERROR - COLUMN xx - INVALID METHOD CODE - GROUP yy REJECTED
Meaning: The method code specified is not in the parameter file.
Action: Correct the method code or update the parameter file and
resubmit.
xx - Column Number yy - Group Number
132
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 14
Release Date: 4/30/79
Update #: 24
AEDMSTR 053 ERROR - COLUMN xx - INVALID UNITS CODE - GROUP yy REJECTED
Meaning: The units code specified is not 1n the parameter file.
Action: Correct the units code or update the parameter file and
resubmit.
AEDMSTR 054 ERROR - COLUMN xx - DECIMAL POSITION GREATER THAN FOUR - GROUP yy
REJECTED
Meaning: AQDHS-II currently will not accept a decimal position greater
than four.
Action: Change units, data value, and decimal code to accomodate the
new decimal and resubmit.
AEDMSTR 055 ERROR - COLUMN xx - NON-NUMERIC DECIMAL POSITION - GROUP yy
REJECTED
Action: Correct and resubmit.
AEDMSTR 056 ERROR - COLUMN xx - NON-NUMERIC AREA CODE - GROUP yy REJECTED
Action: Correct and resubmit.
AEDMSTR 057 ERROR - COLUMN xx - NON-NUMERIC SITE CODE - GROUP yy REJECTED
Action: Correct and resubmit.
AEDMSTR 058 ERROR - COLUMN xx - NON-NUMERIC PARAMETER CODE - GROUP yy REJECTED
Action: Correct and resubmit.
AEDMSTR 059 ERROR - COLUMN xx - NON-NUMERIC METHOD CODE - GROUP yy REJECTED
Action: Correct and resubmit.
xx - Column Number yy - Group Number
133
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 15
Release Date: 4/30/79
Update #: 24
AEDMSTR 060 ERROR - COLUMN xx - NON-NUMERIC UNIT CODE - GROUP yy REJECTED
Action: Correct and resubmit.
AEDMSTR 061 ERROR - COLUMNsxx - NON-NUMERIC READING - GROUP yy REJECTED
Action: Correct and resubmit.
AEDMSTR 062 ERROR - COLUMN xx - NON-NUMERIC START HOUR - GROUP yy REJECTED
Action: Correct and resubmit.
AEDMSTR 063 ERROR - COLUMN xx - INVALID NEGATIVE DATA .FORMAT - GROUP yy
REJECTED
Meaning: Negative data must adhere to the following format: -ddd where
d is any digit 0-9.
Action: Correct and resubmit.
AEDMSTR 064 ERROR - COLUMN xx - DATA MUST BE POSITIVE FOR THIS PARM - GROUP yy
REJECTED
Meaning: Check the parameter code and the reading for consistency (see
Appendix A, Table 5 for valid negative parameters).
Action: Correct and resubmit.
AEDMSTR 065 ERROR - COLUMN xx - INVALID NEGATIVE DATA FORMAT - CARD REJECTED
-Meaning: Negative data must adhere to the following format: -ddd where
d is any digit 0-9.
Action: Correct and resubmit.
xx - Column Number yy - Group Number
134
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 16
Release Date: 10/31/8
Update #.: 29
AEDMSTR 066 ERROR - COLUMN xx - DATA MUST BE POSITIVE FOR THIS PARM - CARD
REJECTED
Meaning: Check the parameter code and the reading for consistency (see
Appendix A, Table 5 for valid negative parameters).
Action: Correct and resubmit.
AEDMSTR 067 ABORT - NUMBER OF PARAMETER FILE RECORDS EXCEEDS MAXIMUM ALLOWED
Meaning: The parameter file contains more entries than allowed;
therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the allowed size
of the parameter file.
AEDMSTR 068 ABORT - PARM-CODE-KEY-ARRAY AREA OVERFLOW
Meaning: The parameter file contains more entries than allowed;
therefore, the r was terminated.
Action: See Appendix C •': instructions on increasing the allowed size
AEDMSTR 069 WARNING - COLUMN xx - PARAMETER NOT IN SITE FILE - DEFAULT
SLAMS/NAMS USED
Meaning: The parameter is not in the site file; a value of 3 has been
inserted in the SLAMS/NAMS ID field.
Action: None required.
AEDMSTR 070 ERROR - COLUMN 80 - INVALID ACTION CODE FOR FORM-4 - CARD REJECTED
Meaning: The only valid action code for a Form 4 transaction is 2 (Add).
Action: Correct and resubmit.
xx - Column Number yy - Group Number
135
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 17
Release Date: 10/31/81
Update #: 29
AEDMSTR 071 ERROR - INVALID TIME PERIOD SPECIFIED - CARD REJECTED
Meaning: The specified ending date is not greater than the specified
beginning date on a Form 4 transaction.
Action: Correct and resubmit.
AEDMSTR 072 ERROR - COLUMN xx - INVALID READING FOR FORM-4 - CARD REJECTED
Meaning: The only valid values for a reading on a Form 4 transaction
are 9980-9997.
Action: Correct and resubmit.
AEDMSTR 073 ABORT - SITE-CODE-ARRAY AREA OVERFLOW
Meaning: The site file contains more entries than allowed; therefore,
the run was terminated.
Action: See Appendix C for instructions on increasing the allowed size
of the site file.
4.5.1.5 Cataloged JCL
4.5.1.5.1 JCL listing - AEDMSTR (AQ0060) can be run by executing the
cataloged procedure AQEDT10. This procedure also executes ASRTRAN (AQ0370).
See Figure 4.5.1-g for a listing of AQEDT10.
4.5.1.5.2 Cross-reference of DD names and files
Program Name: ASRTRAN (AQ0370)
DD Name File Description
AQSINPUT
AQSOUTPT
SORTWK01
AQSPRINT
Unsorted transactions
Sorted transactions
Sort work file
Diagnostic report
Input/Output
Input
Output
Internal
Output
136
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 18
Release Date: 4/30/79
Update #: . 24
/*
//EDIT.INPUT DD *
Transaction cards
/*
4.5.1.6 Warnings and Special Instructions
Any parameter, method, and units code combination coded on an input
transaction must exist on the input parameter file for that transaction to
pass the the edit. Likewise, any state, area, site, agency, and project
combination must exist on the input site file.
As released by NADB, AEDMSTR (AQ0060) will not accept parameter or site
files containing more than 200 records. If either of these input files
contains more than 200 records, the program will abort before any transactions
are edited. If you require larger files, see Appendix C for the modifications
which must be made to your source module for AEDMSTR (AQ0060). After the
required changes are made to the source module, AEDMSTR (AQ0060) must be
recompiled,and link edited using the cataloged procedure AQCLC10 (see Section
8.2.4.1). Also, note that every program which uses either the parameter or
the site file will be affected by the increase in size. See Sections 4.2.2.
and 4.3.2 for a list of those programs.
4.5.1.7 Cost Considerations
To reduce the cost of running AEDMSTR (AQ0060), use the default options
NOLIST and NOFLAGW unless you actually need one or both of the optional
listings.
137
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 19
Release Date: 4/30/79
Update #: 24
The estimates listed below are based on the execution of the run stream
discussed In Section 4.5.1.5.4 on an IBM 370/168.
Number of input transactions:
Number of output internal transactions:
Number of errors detected:
CPU time:
I/O time:
Total time:
26 transactions
26 transactions
8 errors
.4 second
5.1 seconds
5.5 seconds
Estimated cost:
$1.59
4.5.1.8 Related Programs and Procedures
The cataloged procedure AQEMM10 may be executed to edit and convert
AQDHS-II input transactions, sort the resultant internal transactions, and
update the master file. See Section 4.6.1 Master File Edit-Maintenance for a
complete description of this procedure.
138
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
AQDHS-II
Column # Field
1
2-3
4-7
8-10
11
12 - 13
14
15 - 16
17 - 18
19 - 20
21-22
23 - 27
28 - 29
30 - 31
32
33 - 36
37 - 40
41 - 44
45 - 48
49 - 52
53 - 56
57 - 60
61 - 64
SECTION 4.5.1
' TRANSACTION 'tDIT
PROGRAM AEDMSTR (AQ0060)
Page 20
Release Date: 4/30/79
Update #: 24
Transaction - Form 1 (Less-than-Daily Data)
u
Length
1
2
4
3
1
2
1
2
2
2
2
5
2
2
1
4
4
4
4
4
4
4
4
65 - 78 14
79
80
1
1
Data Type
Numeric
Numeric
Numeric
Numeric
Alphabetic
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Alphabetic
Numeric
Description
Form Code
State Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Month
Day
Start Hour
Parameter Code
Method Code
Units Code
Decimal Code
Reading
Reading
Reading
Reading
Reading
Reading
Reading
Reading
Unused
Transaction Status
Flag
Action Code
(Page 1 of 4)
Figure
4.5.1-a. Transaction Formats
139
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 21
Release Date: 4/30/79
Update #: 24
AQDHS-II Transaction - Form 2 (Dally or Greater-than-Daily Data)
Column #
Field Length
Data Type
Description
2
4
8
12
15
17
19
21
23
28
30
33
37
51
65
1
- 3
- 7
- 10
11
- 13
14
- 16
- 18
- 20
- 22
- 27
- 29
- 31
32
- 36
- 50
- 64
- 78
79
1
2
4
3
1
2
1
2
2
2
2
5
2
2
1
4
14
14
14
1
Numeric
Numeri c
Numeric
Numeric
Alphabetic
Numeric
Alphanumeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Alphabetic
80
Numeric
Form Code
State Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Month
Day
Start Hour
Parameter Code
Method Code
Units Code
Decimal Code
Reading
Repeat Columns 23-36
Repeat Columns 23-36
Repeat Columns 23-36
Transaction Status
Flag
Action Code
(Page 2 of 4)
Figure 4.5.1-a - Continued. Transaction Formats
140
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 22
Release Date: 4/30/79
Update #: 24
Column
AQDHS-II Transaction - Form 2 Composite Data
Field Length
Data Type
Description
1 - 16
17 - 18
19 - 20
21
22
23 - 80
16
2
2
1
1
58
Numeric
Numeric
Numeric
Alphanumeric
Same as Form 2
Composite Period
Composite Number of
Samples
Composite Type
Composite Time Code*
Same as Form 2
Use SAROAD time code (Appendix A, Table 3 instead of AQDHS-II time code.
(Page 3 of 4)
Figure 4.5.1-a - Continued. Transaction Formats
.141
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 23
Release Date: 4/30/79
Update #: 24
AQDH£--II Transaction - Form 3
(Multiple Site for Daily or Greater-than-Daily Data)
Column #
Field Length
Data Type
2
5
8
13
15
18
20
22
24
26
30
33
37
50
63
76
1
- 3
4
- 6
7
- 12
- 14
- 16
17
- 19
- 21
- 23
- 25
- 29
- 32
- 36
- 49
- 62
- 75
- 78
79
1
2
1
2
1
5
2
2
1
2
2
2
2
4
3
4
13
13
13
3
1
Numeric
Numeric
Alphabetic
Numeric
Alphanumeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Alphabetic
80
Numeric
Description
Form Code
State Code
Agency Code
Project Code
Time Code
Parameter Code
Method Code
Units Code
Decimal Code
Year
Month
Day
Start Hour
Area Code
Site Code
Reading
Repeat Columns 24-36
Repeat Columns 24-36
Repeat Columns 24-36
Unused
Transaction Status
Flag
Action Code
(Page 4 of 4)
Figure 4.5.1-a - Continued. Transaction Formats
142
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 24
Release Date: 4/30/79
Update #: 24
Action Code: Indicates whether the transaction 1s an add, change, or delete.
Valid Codes: 1 - Delete
2 - Add
3 - Change
Field Length: 1 character
Agency Code: Identifies the agency responsible for the sampling site.
Valid Codes: See Appendix A, Table 1. Also, the code must be on the
site file.
Field Length: 1 character
AQCR Code (internal transactions only): Identifies the AQCR (A1r Quality
Control Region) in which the sampling site is located.
Valid Codes: 001-247
Field Length: 3 characters
Area Code: Identifies the area in which the sampling site is located.
Valid Codes: The code must be on the site file.
Field Length: 4 characters
Composite Number of Samples: Indicates the number of individual samples that
were composited.
Field Length: 2 characters
Composite Period: Identifies the period during which the composite sample was
taken.
Valid Codes: 01 - 04 Quarterly and Seasonal Composite
(Page 1 of 5)
Figure 4.5.1-b. Definition of AQDHS-II Master File Transaction Fields
143
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 25
Release Date: 4/30/79
Update #: 24
Field Length:
01 - 12 Monthly Composite
01 - 52 Weekly Composite
00 Annual Composite
2 characters
Composite Time Code: Indicates the interval at which the individual
composited samples were taken.
Valid Codes:
Field Length:
This time code should be taken from the SAROAD time codes
in Appendix A, Table 3. The only valid composite time
codes are 1-9, A, and B.
1 character
Composite Type: Indicates the interval for which the samples were composited,
Valid Codes:
Field Length:
1 - Quarterly Composite
2 - Seasonal Composite
3 - Monthly Composite
4 - Weekly Composite
5 - Annual Composite
1 character
County Code (internal transactions only): Identifies the county in which the
sampling site is located.
Valid Codes: The code must be numeric.
Field Length: 4 characters
Day: The day of the month on which the sample was taken.
Field Length: 2 characters
(Page 2 of 5)
Figure 4.5.1-b - Continued. Definition of AQDHS-II Master File
Transaction Fields
144
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 26
Release Date: 4/30/79
Update #: 24
Decimal Code: Indicates the number of digits in the reading that are to fall
to the right of the decimal point. For example, a reading of 123.5
would have a decimal code of 1.
Valid Codes: 0-4
Field Length: 1 character
Form Code: Indicates which transaction format is being used.
Valid Codes: 1 - Form 1
2 - Form 2
3 - Form 3
Field Length: 1 character
Method Code: Identifies both the collection method and the analysis method
for the parameter being measured.
Valid Codes: The code must be on the parameter file.
Field Length: 2 characters
Month: The month of the year during which the sample was taken.
Field Length: 2 characters
Number of Readings (internal transactions only): The number of readings
contained in the transaction.
Valid Codes: 1-8
Field Length: 2 characters
Parameter Code: Identifies the parameter being measured.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a full list of currently accepted parameter
codes. Also, the code must be on the parameter file.
(Page 3 of 5)
Figure 4.5.1-b - Continued. Definition of AQDHS-II Master File
Transaction Fields
145
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 27
Release Date: 4/30/79
Update #: 24
Field Length: 5 characters
Project Code: Identifies the project In association with which the sample was
taken.
Valid Codes: See Appendix A, Table 2. Also, the code must be on the
site file.
Field Length: 2 characters
Reading: The value of the sample taken.
Valid Codes: This field can contain either positive or negative data;
however, either type must be right-justified within the
field. Also, if the reading is negative, it must adhere to
the following format: -ddd where d is any digit 0-9.
See Appendix A, Table 5 for a list of parameters which may
have negative readings.
Field Length: 4 characters
Site Code: Identifies the site at which the sample was taken.
Valid Codes: The code must be on the site file.
Field Length: 3 characters
SLAMS/NAMS ID (internal transactions only): Indicates whether the sampling
site is a State and Local Air Monitoring Station (SLAMS) or a
National Air Monitoring Station (NAMS).
Valid Codes: The code must be alphabetic.
Field Length: 1 character
(Page 4 of 5)
Figure 4.5.1-b - Continued. Definition of AQDHS-II Master File
Transaction Fields
146
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 28
Release Date: 4/30/79
Update #: . 24
Start Hour: On Form 1 transactions, the hour at which the first reading was
taken. On Form 2 and Form 3 transactions, the hour at which the
sample was taken.
Valid Codes: See Appendix A, Table 3.
Field Length: 2 characters
State: Indicates the state (or other geographic division) in which the
sampling site is located.
Valid Codes: The code must be on the site file.
Field Length: 2 characters
Time Code: Indicates the interval at which the samples were taken.
Valid Codes: See Appendix A, Table 3.
Field Length: 1 character
Transaction Status Flag: Indicates the status of the readings on the
transaction.
Valid Codes: S Previously sent to SAROAD
Note: S can only be used on add transactions.
blank To be sent to SAROAD
Field Length: 1 character
Units Code: Indicates the units in which the parameter was measured.
Valid Codes: See Appendix A, Table 4 for a partial list. Also, the code
must be on the parameter file.
Field Length: 2 characters
Year: The year in which the sample was taken.
Valid Codes: The year must be greater than or equal to 60.
Field Length: 2 characters
(Page 5 of 5)
Figure 4.5.1-b - Continued. Definition of AQDHS-II Master File
Transaction Fields
147
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1 Page 29
TRANSACTION EDIT Release Date: 4/30/79
PROGRAM AEDMSTR (AQ0060) Update #: . 24
Record Position Field Length Description
1 1
2 1
3 1
4-8 5
9-10 2
11-13 3
14-17 4
18-21 4
22-24 3
25 1
26-27 2
28 1
29-30 2
31-35 5
36-37 2
38-39 2
40-41 2
42-43 2
44-45 2
46 1
47 - 56 10
57 1
58-59 2
60-63 4
Action Code
Form Code
Transaction Status Flag
Reserved Area
State Code
AQCR Code
County Code
Area Code~
> Sort Kev 1
Site Code
Agency Code
Project Code
Time Code
Year
_ v
Sequence
^ Uau
Parameter Code 1
Method Code > Sort Key 2
Units Code I
Month 1
Day > Sort Key 3
Start Hour |
SLAMS/NAMS ID
Reserved Area
Decimal Code
Number of Readings
Reading - Can be repeated up to 8
times
(Page 1 of 2)
Figure 4.5.1-c. AQDHS-II Internal Transaction Format
; 148
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1 Page 30
TRANSACTION EDIT Release Date: 4/30/79
PROGRAM AEDMSTR (AQ0060) Update #: 24
Record Position Field Length Description
1 1
2 1
3 1
4-8 5
9-10 2
11-13 3
14-17 4
18-21 4
22-24 3
25 1
26-27 2
28 1
29-30 2
31-35 5
36-37 2
38 - 39 2
40 1
41 1
42-43 2
44-45 2
46 1
47 - 56 10
57 1
58-59 2
60-63 4
Action Code
Form Code
Transaction Status Flag
Reserved Area
State Code
AQCR Code
County Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Parameter Code
> Sort Key 1
Sequence
f Key
•*»»j
Method Code S> Sort Key 2
Units Code I
Composite Type
Composite Time Code
Composite Period
Composite Number of
Samples
> Sort Key 3
SLAMS/NAMS ID
Reserved Area
Decimal Code
Number of Readings
Reading - Can be repeated up to 8
times
(Page 2 of 2)
Figure 4.5.1-c. AQDHS-II Internal Transaction Format - Composite Data
149
-------
Ol
o
AODHS-Il MASTER FILE TRANSACTION EDIT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM MANE: AEOMSTR (A00060)
REVISION LEVEL! 1-00
LAST UPDATE «: 2Q
DATE INCORPORATED* OCTOBER 31, 1<»78
OPTIONS IN EFFECT! LIST NOFLAGH
INPUT TRANSACTIONS
ERRORS
1340003010G041750822166110123 I2l000i000i>0003000 t-t
1-4 r—
m
:>
jo
o
m
00
-H
m o
zz TO t~i
.
O —I
m i— i
o
70
O
CO i—i
> o
o z
m o
o 2:
•3i
oo m
—I o
TO i—i
o
o
cn
cr TO
"O fl>
Q. —'
ft> n>
e+ (U
n>
CD
ro
-^
co
o
10
-------
AODHS-II MASTER FILE TRANSACTION tDIT PROGRAM - CONFIRMATION LISTING
PAGE
INPUT TRANSACTIONS PASSING EDIT CRITERIA
1120001003C01174061000611022114000010002000400030002000300020001
1120001003C01174061008611022114000020001000300000002000400020004
I120001003C011740610166110221140000S0003000200010002000200030004
1120001003C011730912006110250I40000500060004000300030002000S0003
1120001003C01173091208611025014000030004000300040003000300030002
1I20001003C01173091216611025014000030002000400030003000200040003
I373000997AOS2630101006210120151900091009200
1373000997A052630102006f 10120150900091009200
1373000997A0526301030062101201S390009I009200
1373000997AOS26301040062101201S2900091009200
1373000997AOS2630105006210120152900091009200
NUMBER OF TRANSACTIONS PASSING EDIT CRITERIA!
11
Figure 4.5.1-e. Optional Listing
m
•-• JO
i— o
m 3C
oo
o i
90 M
m i—,
r> —i
m •— •
o
•o — I co
30 30 rn
o > o
en z — i
30 CO >-t
U.
m
O
oo m »-•
—I o
30 •-•
o>
o
<= 30 -O
•a n> n>
o. —• ca
o> a> n>
c* a>
n> ro
ro a>
co
o
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 33
Release Date: 4/30/79
Update #: 24
[OPTION-1] [OPTION-2]
The options can appear in any order and in any position on the card subject to
the following rules:
1. There can be only one card.
2. All options must be punched within columns 1 through 72, inclusive.
3. There must be at least one space between the options if both are
specified. A comma may be used as a separator rather than a space,
and a space may precede and/or follow the comma.
Figure 4.5.1-f. Option Card Format
152
-------
ui
CO
AQDHS-II MASTER FILE TRANSACTION EDIT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: AEDMSTR (AQ0060)
REVISION LEVEL: 4-00
LAST UPDATE «: 29
DATE INCORPORATED: OCTOBER 31,
1981
OPTIONS IN EFFECT: DEFAULT (NOLIST NOFLAGW)
INPUT TRANSACTIONS ERRORS
*** AEDMSTR 046 CONDITIONAL - MISSING OR INVALID OPTION CARD - DEFAULT OPTIONS USED
2420760001F018810701001110191010999942602840109999 1
*** AEDMSTR 036 ERROR - COLUMN 08 - INVALID SITE CODE - CARD REJECTED
NUMBER OF TRANSACTIONS READ:
NUMBER OF TRANSACTIONS PASSINS EDIT CRITERIA:
NUMBER OF INTERNAL TRANSACTIONS CREATED:
NUMBER OF WARNING MESSAGES:
NUMBER OF CONDITIONAL MESSAGES:
NUMBER OF ERROR MESSAGES:
NUMBER OF ABORT MESSAGES:
7
6
11
0
1
1
0
Figure 4.5.1-d. Diagnostic Report
5= •— -O
I-H I— O
•z. m oc
—I CO
m o i
m
o
TO 70
O >
(75 Z —I
73 tS> i—•
> 3=> O
2 O Z
o
o
CT)
O
en
T3
O.
a>
r+
n>
ro
10
n>
-o
Ql
10
n>
(0
Oi
in co
ro -p>
OJ
H-
fD
»—'
o
CO
i—•
oo
-------
AfinHS-tl MA.Slf.R Flit IRANfiACT |HN 101 I PHHl.MAM - CUNI- I HMAT I UN L1STINU
PAGt
INPUT TRANSACTIONS PASSINU EDIT CRITERIA
I340ooioo3«06i75osi 31 66 H 012013100070 o HII
1340001003A06175051308611012013100070080
I340ootoo3>061750513006110120I3toofl7oo8o
I 340001003A06275051317611012013100070080
I340001003A062750513166II012013I00070080
1310001003A0627505I30I61 1 01 201 51 00070080
1310001003A 0627505130061 I 0 I 2013I 00070080
13(1000 I 003AQ637S05130261101201 31 OUO7OOno
I 31000100340637505I 30161101201Jl00070080
I 31000I003A06375051300611012013100070080
I 340001003A0647505I303611012013100070080
1340001003A06475051302611012013100070080
1340001003*06175051301611 012013100070080
1340001003A0647505130U611012013100070080
1340001003»0657iObl305611012013100070080
1310001003A06575051301611012013100070080
I 31000 I 003406575051 J026 11 01201 31 00070081)
I 340001003A06575051301611012013 I"0070"80
1340001003«0657505130061101201310007008u
I 340001 003AU667S05I 30161 10120131 01)0700«n
1340001003A06675051 30061 I (I I201SI 00070080
1140001003«06675051306611012013100070080
1340001003*06675051307611 012013100070080
I34000100JA0667505I305611012013100070080
1310001003A06675051304611012013100070080
1310001003*06675051303611 012013100070080
I 34000 I 003A06675051 30261 101 20 13100070081)
I 34000 I 003A 06775051311611012013100070080
1340001003A 06775051310611012013100070080
I 340001003A06775051309611012013100070080
I 340001003A06775051 309611 012013100070080
134000I003A06775051308611012013100070080
I 340001003A06775051300611012013100070080
1340,001 003A06775051 300611 01201 31 00070080
131000I003A06775051307611012013100070080
I 340001003A067750513066110120131000700AO
I 310'001003A0677505I 3046110120 I M 00070080
I 340001003A06775051304611 012013100070080
I 340001003A067750513056110120 I 310007008Q
1340001003A06775051303611012013100070080
I 340001003«06775051301611 0120131000/0080
I 340001003A06775051302611 0120131000?00«0
3S4A06S62101*2150700 I 01000001003 I 500
334A06812401II 021700 I 010000010030050
234000?OOir>05A74080ll244IOt 1501 10196
734000200 111 05H7408012 3141 01 1501 lOIQt,
23400020011> 05 87408010044101 1501 1019b
?340002001 (105874080199411 01 1501 10|<>6
231000200100597408010714101150110196
2310003002G04C740I0518
NUMBER UF THANSACUONS PASSING tDIT CHIIFHIA!
58
Figure 4.5.1-e. Optional Listing
_
> •-, -O
r- o
m 3:
CO
m o i
TO >-.
m >—i
o 5
S O
> —•
n o
a z
co m
73 i—c
JO
O
o
oo
m
01
c:
a
a.
Cu
c*
fD
ro
~~j
73 T3
(D Cu
—' IQ
(D
CU
CO
(D
CO
cn
CU
rt
en
o
oo
o
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.1
TRANSACTION EDIT
PROGRAM AEDMSTR (AQ0060)
Page 36
Release. Date: 4/30/79
Update #: . 24
Parameter
Name
PROJECT
PRIMARY
SECNDRY
TRANS
PARMFIL
SITEFIL
OUT
Default
Value
'CN.EPALMH.A087,
CDHS.HQ.AQS1
PROGRAM AEDMSTR
TIME1 '3,0'
UNIT 3330
SERIAL
DISP
SPCUNIT
CDHSPK
'NEW.CATLG,
DELETE'
TRK
10
EDITTRAN
AQPARMFL
AQSITEFL
A
Description
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQPARMFL would
be the full data set name of the parameter
file)
Master file transaction edit program ,
Time allocated for execution of AEDMSTR
Unit type to which edited internal trans-
actions are to be written
Volume identification to which edited
internal transactions are to be written
Disposition of edited internal transactions
i
Units in which space for edited internal
transactions is to be allocated
Primary space allocation for edited internal
transactions
Secondary space allocation for edited
internal transactions
Lowest-level index of data set to contain
edited internal transactions
Lowest-level index of parameter file
Lowest-level index of site file
SYSOUT class for all print files
Figure 4.5.1-h. Substitutable Parameters for AQEDT10
155
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.2
INTERNAL TRANSACTION SORT
PROGRAM ASRINTR (AQ0130)
Page 1
Release Date: 4/30/79
Update #: . 24
4.5.2 MASTER FILE INTERNAL TRANSACTION SORT PROGRAM - ASRINTR (AQ0130)
4.5.2.1 Description
ASRINTR (AQ0130) sorts master file internal transactions Into the
sequence required by the master file maintenance program AFMMSTR (AQ0100);
Figure 4.5.2-a details this sort order. All master file internal transactions
must be sorted by ASRINTR (AQ0130) before they can be used to update (or
create) the master file. See Section 4.5.1 for additional information on the
internal transactions.
4.5.2.2 File Formats
Input to this program consists solely of master file internal trans-
actions generated by AEDMSTR (AQ0060), the master file transaction edit
program. Refer to Section 4.5.1.2 for a description of the internal
transaction format.
ASRINTR (AQ0130) produces two output files: a temporary file containing
the sorted internal transactions and a diagnostic report. The transactions
are in the same sequence as the master file and can be used as input to the
master file maintenance program AFMMSTR (AQ0100). An example of the
diagnostic report is shown in Figure 4.5.2-b.
4.5.2.3 Options
There are no options.
4.5.2.4 Error Messages
There are no error messages.
156
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.2
INTERNAL TRANSACTION SORT
PROGRAM ASRINTR (AQ0130)
Page 2
Release Date: 4/30/79
Update #: . 24
4.5.2.5 Cataloged JCL
ASRINTR (AQ0130) should always be executed In conjunction with the master
file maintenance program AFMMSTR (AQ0100). See Section 4.5.3.5 for a
discussion of the cataloged procedure AQFMM10, which executes both programs.
4.5.2.6 Warnings and Special Instructions
Note that the COBOL sort verb 1s used in this program; therefore, the
collating sequence for alphanumeric fields is determined by the computer at
the user's particular installation.
In addition to the diagnostic report produced by ASRINTR (AQ0130),
messages generated by the sort-merge package will be printed. The format and
content, as well as the physical location, of these messages depends upon the
user's particular installation.
4.5.2.7 Cost Considerations
The following estimates are for the execution of ASRINTR (AQ0130) on an
IBM 370/168:
Number of internal transactions: 69 transactions
CPU time: .5 seconds
I/O time: 6.8 seconds
Total time: 7.3 seconds
Estimated cost: $1.16
157
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.2
INTERNAL TRANSACTION SORT
PROGRAM ASRINTR (AQ0130)
Page 3
Release Date: 4/30/79
Update #: 24
4.5.2.8 Related Programs and Procedures
ASRINTR (AQ0130) should always be executed in conjunction with the
master file maintenance program AFMMSTR (AQ0100). The cataloged procedure.
AQFMM10 will execute both programs.
Also, ASRINTR (AQ0130) and AFMMSTR (AQ0100) may be executed in
conjunction with the master file transaction edit program, AEDMSTR (AQ0060),
by the cataloged procedure AQEMM10. See Section 4.6.1 for a discussion of
this procedure.
158
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.2
INTERNAL TRANSACTION SORT
PROGRAM ASRINTR (AQ0130)
Page 4
Release Date: 4/30/79
Update #: 24
Record Position
Description
Sort Sequence
9
11
14
18
22
26
29
31
36
38
40
42
44
- 10
- 13
- 17
- 21
- 24
25
- 27
28
- 30
- 35
- 37
- 39
- 41
- 43
- 45
1
2
3
State
AQCR
County
Area
Site
Agency
Project
Time Code
Year
Parameter Code
Method Code
Unit Code
Month
Day
Start Hour
Action Code
Form Code
Status Flag
Ascending
Ascending
Ascending
Ascendi ng
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Figure 4.5.2-a. Sort Sequence for Master File Internal Transactions
159
-------
AODHS-Il MASTER FILE INTERNAL TRANSACTION SORT PROGRAM - DIAGNOSTIC REPORT
PAGE I
PROGRAM NAMEl ASRINTR (AQOI30)
REVISION LtVELI 1-00
LAST UPDATE »: ZQ
DATE INCORPORATED! OCTOBER 31, 1978
NUMBER OF INPUT INTERNAL TRANSACTIONS!
NUMBER OF OUTPUT INTERNAL TRANSACTIONS:
11
11
Figure 4.5.2-b. Diagnostic Report
i-i r— o
z rn :c
—« co
m o i
Z 50 i-H
3» m I-H
-o M co
50 z m
O — I o
O m — i
50 50 1-1
3> Z O
3 p z
3> •£»
—!•
50 50 en
-« 3> •
ro
oo
50
oo
3>
o
£ 5
o z
I— •
co co
o o
--- 50
c: •yo -o
•a m tu
o. — • (o n>
C* D»
(D en en
o>
ro
•t*
Oi
co
o
10
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 1
Release Date: 4/30/79
Update t: 24
4.5.3 MASTER FILE MAINTENANCE PROGRAM - AFMMSTR (AQ0100)
4.5.3.1 Description
The master file maintenance program is used to create and/or update the
AQDHS-II master file. Internal format transactions produced by the master
file transaction edit program are used as input to the file maintenance
program to accomplish these functions. These internal transactions must be
sorted into master file sequence before they are input into the file
maintenance program (see Section 4.5.2 Master File Internal Transaction Sort
Program).
Each internal transaction either adds data to, replaces (changes) data
in, or deletes records from the master file. Any combination of transactions
may be entered in one execution of the file maintenance program.
When a master file record is created and all readings are not supplied,
all blank fields up to the last supplied reading are filled with nines to
indicate a null reading. These null fields may then be updated by either an
add or change transaction. (One cannot change a non-existing reading or add
a reading to an existing reading.)
If a record contains one or more readings which have not been submitted
to SAROAD, that record's submission status flag is N or V. It is N if one or
more non-null readings have not undergone anomaly screening, V if all non-null
readings have undergone anomaly screening. If all readings in a record have
been submitted to SAROAD, that record's submission status flag is S or T. It
is S if one or more non-null readings have not undergone anomaly screening, T
if all non-null readings have undergone anomaly screening.
161
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 2
Release Date: 4/30/79
Update #: 24
4.5.3.2 File Formats
AFMMSTR (AQ0100) uses two Input files: the current AQDHS-II master file
and the file of Internal transactions produced by AEDMSTR (AQ0060). However,
1f AFMMSTR (AQ0100) 1s being executed to create a new AQDHS-II master file
rather than update a current one, there Is no Input master file. See Figure
4.5.3-a for the format of the master file and Section 4.5.1.2, Figure 4.5.1-c
for the format of the internal transactions. Note that the internal
transactions must be sorted into master file sequence before they are Input
into AFMMSTR (AQ0100).
AFMMSTR (AQ0100) produces a new (or updated) master file and a diagnostic
report. The master file consists of records designed to contain all data
related to a particular parameter collected at a specific site. Each record
contains from 1 to 31 readings representing a certain logical period of time,
with the length of the period and the number of readings determined by the
interval at which the samples were taken. For any sampling interval less than
24 hours, the record contains one day's readings (1-24 readings); for daily
sampling intervals, the record contains one month's readings (1-31 readings);
for weekly sampling intervals, the record contains one week's readings (1
reading); for monthly and quarterly sampling intervals, the record contains a
year's readings (1-12 and 1-4 readings, respectively); for composite data,
the record contains one reading. All records have the same format but are
variable in length, since the length is determined by the number of readings
actually stored 1n the record and not the maximum number possible. . For
example, a record for an hourly interval could hold a maximum of 24 readings:
1f readings 1, 3, and 6 were supplied when the record was created, the record
would be six readings long (readings 2, 4, and 5 would be filled with nines to
Indicate null values).
The format of the master file record is illustrated 1n Figure 4.5.3-a.
The individual fields are the same as those described for the master file
162
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 3
Release Date: 4/30/79
Update #: 24
transactions in Section 4.5.1.1, Figure 4.5.1-b, with the following
exceptions: the action code field of the master file record indicates the
last action (add or change) performed on that record, the record submission
status flag indicates if any or all of the readings in the record have been
submitted to SAROAD and screened for anomalies, and the number of readings
indicates the number of readings contained in the record. The reserved areas
in the master file (see Figure 4.5.3-a) contain no data but allow for future
expansion of the master file record.
The diagnostic report contains the program update messages, option
messages, diagnostic messages, and summary statistics. It also prints a table
of the print characters used to represent the signed readings; however, since
the representation of signed data is machine-dependent, these characters are
not the same for all installations. A diagnostic message concerning a
particular internal transaction is printed along with that transaction.
Section 4.5.3.4 lists and explains the diagnostic messages produced by
AFMMSTR. The report does not list warning messages (and the transactions
causing them) unless the user requests that listing via an option card. See
Figure 4.5.3-g for an example of the diagnostic report.
AFMMSTR (AQ0100) also produces optional confirmation listings of internal
transactions, the records on the old master file which were affected by
AFMMSTR (AQ0100), and the records on the new (or updated) master file which
were affected by AFMMSTR (AQ0100). See Section 4.5.3.3 for a discussion of
these listings and instructions for producing them, and Figure 4.5.3-b for
examples of these listings.
4.5.3.3 Options
There are four optional confirmation listings which can be produced by
AFMMSTR (AQ0100): (1) a listing of warning messages, (2) a listing of the
valid internal transactions, (3) a listing of the records on the old master
file which were affected by AFMMSTR (AQ0100), and (4) a listing of the records
163
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 4
Release Date: 4/30/79
Update |: 24
on the new (or updated) master file which were affected by AFMMSTR (AQ0100).
To select one or all of these listings, include an option card in the
execution deck (see Section 4.5.3.5 Cataloged JCL). Figure 4.5.3-c
illustrates the required format of the option card.
The LIST option produces the transaction, old master, and new master
confirmation listings. If this option is not specified, its default, NOLIST,
is in effect and none of these confirmation listings will be produced.
If the NOLIST option is specified, neither the transaction, old master,
nor new master listings will be produced. Specifying the NOLIST option
produces the same result as not specifying LIST.
Individual confirmation listings may be requested by the LISTTRAN,
LISTOLD, and LISTNEW options. These three options can be requested in any
combination, but only those listings specified will be produced. If neither
LISTTRAN, LISTOLD, LISTNEW, nor LIST is specified, the default option NOLIST
is in effect. Note that specifying all three individual options (LISTTRAN,
LISTOLD, and LISTNEW) is the same as specifying LIST.
The FLAGW option produces a listing of warning messages generated by
AFMMSTR (AQ0100). When this option is specified, each warning message (and
the internal transaction to which it refers) is listed in the diagnostic
report. If the FLAGW option is not specified, its default, NOFLAGW, is in
effect and no warning messages will be listed.
If the NOFLAGW option is specified, warning messages will not be listed;
however, all other diagnostic messages will still be listed. Specifying the
NOFLAGW option produces the same result as not specifying FLAGW.
164
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 5
Release Date: 4/30/79
Update #: 24
If no option card 1s Included 1n the execution deck, or 1f an Invalid
option card 1s Included, the default options NOLIST and NOFLAGW will be 1n
effect.
4.5.3.4 Error Messages
AFMMSTR 001 ERROR - READING xx - ATTEMPT TO ADD DATA TO EXISTING READING -
DATA REJECTED
Meaning: The specified master file record already contained a reading 1n
the position Indicated for adding reading xx. Reading xx was,
therefore, rejected.
Action: Correct and resubmlt.
AFMMSTR 002 WARNING - READING xx - VALUE NOT SPECIFIED - FILLED WITH NINES
(yyyyyyyyyyyyy-yyyyyyyy-yyyyyyyyy)
Meaning: No value was specified for reading xx 1n the record with key
yyyyyyyyyyyyy-yyyyyyyy-yyyyyyyyy. Since subsequent readings
were specified for this record, this reading 1s set to the null
value (9999) as a place-holder.
Action: None.
AFMMSTR 003 ERROR - NO MATCHING KEY FOUND ON MASTER FILE - TRANSACTION
REJECTED
Meaning: There 1s no corresponding record 1n the master file for this
transaction.
Action: Correct and resubmlt.
xx - Reading Number
165
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 6
Release Date: 4/30/79
Update #: . 24
AFMMSTR 004 ERROR - READING xx - ATTEMPT TO CHANGE NON-EXISTING READING - DATA
REJECTED
Meaning: A change transaction was submitted for a non-existent or null
reading in the specified master file record. The reading was,
therefore, rejected.
Action: Correct and resubmit.
AFMMSTR 005 $ CONDITIONAL - MISSING OR INVALID OPTION CARD - DEFAULT OPTIONS
(NOLIST NOFLAGW) USED
Meaning: An invalid option was specified, or no option card submitted.
The program was executed using the default options NOLIST and
NOFLAGW.
Action: None.
AFMMSTR 006 ABORT - TRANSACTION FILE IS NOT IN PROPER SORT SEQUENCE
Meaning: The input file of internal transactions has not been sorted
and, therefore, the run was terminated. Do not use the output
from this run.
Action: Sort the internal transactions using the master file internal
transaction sort program ASRfNTR (AQ0130).
AFMMSTR 007 DISASTER - DUPLICATE RECORD IN OLD MASTER FILE
MASTER FILE RECORD KEY 1 = XXX
MASTER FILE RECORD KEY 2 = XXX
TRANSACTION RECORD KEY = XXX
Meaning: Two master file records with the same key were found and,
therefore, the run was terminated. Do not use the output from
this run.
Action: Call NADB.
xx - Reading Number
166
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 7
Release Date: 4/30/79
Update I: . 24
AFMMSTR 008 ABORT - MASTER FILE IS OUT OF SEQUENCE
MASTER FILE RECORD KEY 1 - XXX
MASTER FILE RECORD KEY 2 • XXX
TRANSACTION RECORD KEY - XXX
Meaning: An out-of-sequence master file record was found and, therefore,
the run was terminated. Do not use the output from this run.
Action: Determine 1f the Input master file has been sorted by the
master file sort program ASRMSTR (AQ0140). If 1t has been,
re-execute AFMMSTR (AQ0100) using the correct master file
(I.e., a master file that has not been sorted by ASRMSTR
(AQ0140)). If the correct master file was used, there 1s a
serious problem with that master file, and the user should
contact NADB.
AFMMSTR 009 DISASTER - NEW MASTER FILE WILL BE OUT OF SEQUENCE
MASTER FILE RECORD KEY 1 = XXX
MASTER FILE RECORD KEY 2 = XXX
TRANSACTION RECORD KEY = XXX
Meaning: AFMMSTR (AQ0100) attempted to create a new master file record
with a key less than or equal to that of the last master file
record written and, therefore, the run was terminated. Do not
use the output from this run.
Action: Call NADB.
4.5.3.5 Cataloged JCL
4.5.3.5.1 JCL listing - AFMMSTR (AQ0100) 1s executed by the cataloged
procedure AQFMM10. The procedure also executes the master file Internal
transaction sort program ASRINTR (AQ0130). See Figure 4.5.3-d for a listing
of this procedure.
167
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 8
Release Date: 4/30/79
Update #: 24
4.5.3.5.2 Cross-reference of DD names and files
Program Name: ASRINTR (AQ0130)
DD Name
File Description
Input/Output
AQSINPUT Unsorted internal transactions
AQSOUTPT Sorted internal transactions
AQSPRINT Diagnostic report
SORTWK01 Sort work file
Input
Output
Output
Internal
Program Name: AFMMSTR (AQ0100)
DD Name
File Description
Input/Output
AQSINPUT Option card Input
AQSINTRN Sorted internal transactions Input
AQSOLDMS Old AQDHS-II master file Input
AQSNEWMS New or updated AQDHS-II master file Output
AQSCONFR Internal transaction confirmation listing Output
AQSOLDRC Old master file confirmation listing Output
AQSNEWRC New master file confirmation listing Output
AQSPRINT Diagnostic report Output
4.5.3.5.3 User-supplied JCL - To execute the cataloged procedure AQFMM10, the
user must specify the data set names of the input (old) master file, the input
internal transactions, and the output (new or updated) master file. See
Figure 4.5.3-e for a description of the procedure's substitutable parameters.
4.5.3.5.4 Sample run stream - The following run stream would update the
AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.AQ1029C2'. The NOLIST and
168
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 9
Release Date: 4/30/79
Update #: . 24
FLAGW options are specified; the updated master file is named 'CN.EPALMH.
-AQe8^-.CDHS.HQ.AQS.DATA.AQ1019CC'.
// EXEC AQFMM10,
// OLDMSTR=AQ1029C2,
// NEWMSTR=AQ1019CC
//UPDATE.INPUT DD *
NOLIST FLAGW
/*
4.5.3.6 Warnings and Special Instructions
The AQDHS-II master file is constructed to contain a variable number of
readings up to a maximum of 31 (see Figure 4.5.3-a for the format of the
master file). The number of readings contained in any master file record
depends on the time code of that record; i.e., a record can consist of hourly
readings for one day, daily readings for one month, one weekly reading,
monthly readings for one year, and quarterly readings for one year. When
coding transactions to update the master file, the correct date (year, month,
day) for each reading must be coded to insure that the reading is inserted in
the correct position on the appropriate master file record. Moreover, for
less-than-daily data, the time code, the start hour, and the relative position
of the reading in the repeating section identify the hour at which that
particular reading was taken. Therefore, care must be taken when coding
less-than-daily data (Form 1 transactions only) to position the reading in the
correct relative position.
The following examples illustrate adding data to an existing master file
record. Note that the transactions illustrated in these examples are not
internal format transactions. They are AQDHS-II transactions and have to be
submitted to the master file transaction edit program AEDMSTR (AQ0060) for
169
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 10
Release Date: 4/30/79
Update #: 24
editing and conversion to Internal format transactions prior to their use as
Input to AFMMSTR (AQ0100).
Example 1: The master file record contains one-hourly (time code = 1)
readings for hours 00-07 and you wish to add readings for
hours 12-23. Since a Form 1 transaction can accommodate only
eight (8) readings per card, you should code two
transactions: first, an add transaction with start hour 08
and blanks in the positions for the first four readings,
followed by the readings for hours 12-15; second, an add
transaction with start hour 16 and the readings for hours
16-23. See Figure 4.5.3-f, Example 1.
Example 2: The master file record contains three two-hourly (time code
= 2) readings for hours 04; 06, and 08 and you wish to add
readings for hours 00 and 02. You should code an add
transaction even though the master file record contains null
readings in these two positions. See Figure 4.5.3-f,
Example 2.
The delete transaction can only be used to delete an entire ma'ster file
record. Only the key fields and the action code must be coded on the delete
transaction.
To delete a particular reading from a master file record, you must create
a change transaction to change that reading to a null value (9999). That
reading will then be deleted from your file and from the SAROAD file by
ARPSARD (AQ0220) when you submit your data to SAROAD (see Section 6.3.2
AQHDS-II to SAROAD conversion).
170
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 11
Release Date: 4/30/79
Update #: 24
4.5.3.7 Cost Considerations
The estimates listed below are for the execution of AFMMSTR (AQ0100)
on an IBM 370/168.
Number of old AQDHS-II master file records:
Number of internal transactions:
Number of updated AQDHS-II master file records:
CPU time:
I/O time:
Total time:
Estimated cost:
237 records
26 transactions
263 records
.6 second
4.8 seconds
5.4 seconds
$1.13
4.5.3.8 Related Programs and Procedures
The cataloged procedure AQEMM10 may be executed to edit and convert
AQDHS-II input transactions, sort the resultant internal transactions, and
update (or create) the AQDHS-II master file. See Section 4.6.1 Master File
Edit-Maintenance for a complete description of this procedure.
171
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3 Page 12
MASTER FILE MAINTENANCE Release Date: 4/30/79
PROGRAM AFMMSTR (AQ0100) Update #: . 24
Record Position Field Length Description
1 1
2 1
3 1
4-7 4
8-9 2
10-12 3
13-16 4
17-20 4
21-23 3
24 1
25-26 2
27 1
28-29 2
30-34 5
35-36 2
37-38 2
39-40 2
41-42 2
43-44 2
45 1
46 - 55 10
56-57 2
58 1
59 1
60-63 4
Action Code
Form Code
Record Submission Status Flag
Reserved Area
State Code
AQCR Code
County Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
> Sort Key 1
Sequence
r Key
Parameter Code 1
Method Code > Sort Key 2
Units Code f
Month 1
Day p> Sort Key 3
Start Hour ]
SLAMS/NAMS ID
Reserved Area
Number of Readings
Reading Status Flag Repeating Section
Decimal Code (Occurs 1 to 31 times)
Reading
(page 1 of 2)
Figure 4.5.3-a. AQDHS-II Master File Format
172
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3 Page 13
MASTER FILE MAINTENANCE Release Date: 4/30/79
PROGRAM AFMMSTR (AQ0100) Update #: . 24
Record Position Field Length Description
1 1
2 1
3 1
4-7 4
8-9 2
10-12 3
13-16 4
17-20 4
21-23 3
24 1
25-26 2
27 1
28-29 2
30-34 5
35-36 2
37-38 2
39 XI
40 1
41-42 2
43-44 2
45 1
46 - 55 10
56-57 2
58 1
59 1
60-63 4
Action Code
Form Code
Record Submission Status Flag
Reserved Area
State Code
AQCR Code
County Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Parameter Code
Method Code
Units Code
Composite Type
Composite Time Code
Composite Period
Composite Number of
Samples
>Sort Key 1
Sequence
f Key
> Sort Key 2
>Sort Key 3
SLAMS/NAMS ID
Reserved Area
Number of Readings
Reading Status Flag Repeating Section
Decimal Code (Occurs 1 to 31 times)
Reading
(page 2 of 2)
Figure 4.5.3-a. AQDHS-II Master File Format - Composite Data
173
-------
FIXED SEGMENT
21T
AQDHS-II MASTER FILE MAINTENANCE PROGRAM - INPUT MASTER FILE CONFIRMATION LISTING
REPEAT INC DATA
1000910800001001E02171 «a
2
00
— 1
•£
o
0
0
cz
Q.
CD
c-h
(V
=«»:
• •
ro
-n
H^
r-
m
o
•73
n
— i
1— H
O
^9
--*^_
>
2
oo
—1
m
73
-n
i —
m
|
5
m
>
<->
m
^
i_j
o>
to
in
(b
0
Cu
.-fc
*•
^D
^
oo
o
— 1
VO
>o
o
oc
00
1
»— 1
HH
oo
m
c->
-H
I— 1
o
z
en
00
-a
-------
AQDHS-1I MASTER FILE MAINTENANCE PROGRAM - INTERNAL TRANSACTION CONFIRMATION LISTING
PAGE
INTERNAL TRANSACTION
ACTION
21 laObOOl 400001003C011736110250140<>ieOO
«•« ADOE.D
21 UObOOl 400001003CO1173611025014091208
•o* ADDED
21 ' 1206001400001003C011736110250I4091216
•*« ADDED
21 1206001400001003CO1170611022114061000
»»• ADDED
21 1206001400001003CO117461102211X061008
*** ADDED
21 1206001400001003C01174611022114061016
•** ADDED
31 3718630203000997AQ5263621012015010100
••• CHANGED
31 371B630203000997A05263621012015010200
•«• CHANGED
31 371863020300Q997A05263621012015010300
*** CHANGED
31 3718630203000997A05263621012015010400
«•* CHANGED
31 3718630203000997A05263621012015010500
•*« CHANGED
NUMBER OF INPOT INTERNAL TRANSACTIONS:
00800050006000400030003000200050003
00800030004000300040003000300030002
00600030002000400030003000200040003
00800010002000400030002000300020001
00800020001000300000002000400020004
00600050003000200010002000200030004
103900091009200
003900091009200
303900091009200
203900091009200
203900091009200
11
Figure 4.5.3-b - continued. Optional Listings
(page 2 of 3)
•-i r~
z m
—I
m o
Z 3C
3> m
r> —I
o
i
CO
-O 2 CO
30 >> m
o oo o
o —I —i
30 m •-•
3 m in
2 •
CO 3 co
—\ y>
73 •-•
JO
O
o
o
o
n> en
— • to
n> n>
O»
=«:
.. O
Ol
d-
ro n>
co
CD
vo
n> en
-------
FIXED SEGMENT
AQDHS-II MASTER FILE MAINTENANCE PROGRAM - OUTPUT MASTER FILE CONFIRMATION LISTING
REPEATING DATA
cn
21N 120600ia00001003C01l736110£S011000 24
A00001A00002A00004A00003*
A00005A00003A00002A00001A00002A00002A00003A00004
3IN 3718630203000997AOS263621Q1201b010100 12
C19000C19100C19200S09300S09400S09500S09600S09700S09800S09900S09901S09902
3IN 371Bb30203000997A052636210120lSOI0200 12
C09000C09100C09200S19)00319400S19SOOS19600319700S19BOOS19900S19901 SI 9902
31N 3716630203000997AOS26362101201SOI0300 12
C39000C39100C39200S29300S29400S29500S29600S29700S29800S29900S29901S29902
31N 37ieb30203000997A05Z63621012015010400 12
C29000C29100C29200S39300339400S39500339600S39700S39600S39900S39901S39902
31N 371H630203000997A0526362101201S010SOO 12
C29000C29100C29200S49300S49400S(l9SOOS49600S49700S49BOOS49900S49901Sa9902
NUMBER OF OUTPUT MASTER FILE RECORDS:
NUMBER OF OUTPUT MASTER FILE RECORDS LISTED:
41
7
Figure 4.5.3-b - continued. Optional Listings
PAGE 1
ACTION
ADDED
03A00003A00002
ADDED
04A00002A00004
CHANGED
CHANGED
CHANGED
CHANGED
CHANGED
(page 3 of 3)
2
-H
m
^
0
-o
73
O
CT5
|
-n
co
^j
^n
X)
2
o
0
o
c.
•Q
D.
CU
{-^
0>
=*fc
• •
ro
-n
>— i
r~
'
o
m
—I
o
o
5
CO
—1
m
73
1— 1
m
3
^
-H
m
f*
0
m
73
m
«j
n>
CU
(/>
(D
O
CU
n>
^
CO
o
1 — 1
VO
o
-T-
co
1
H- 1
1— 1
oo
m
o
-H
O
•z.
*=•
en
CO
-o
cu
tf~*
ro
i— •
en
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 17
Release Date: 4/30/79
Update #: 24
[OPTION-1] [OPTION-2] [OPTION-3] [OPTION-4]
The options can appear in any order and in any position on the card
subject to the following rules:
1. There can be only one card.
2. All options must be punched within columns 1 through 72, inclusive.
3. There must be at least one space between two successive options.
A comma may be used as a separator rather than a space, and a space
may precede and/or follow the comma.
Figure 4.5.3-c. Option Card Format
177
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 18
Release Date: 4/30/79
Update #: . 24
//*
//* PROCEDURE NAMEl AHFMMJO
//* REVISION LEVELi 1-00
//* LAST UPDATE «t 24
//* DATE INCORPORATEDi OCTOBER 31,1978
//* THIS PROCEDURE ALLOWS THE USER TO MAINTAIN THE AQDHS-II MASTER
//* FILE USING PREVIOUSLY EDITED TRANSACTIONS
//*
//*
//AQFMM10 PROC PROJECT='CN.EPALMH.AOfl7.CDHS.HQ.AQS',
// PROGlsASRINTR,
// PROG2=AFMMSTR,
// R1=100K,
// R2=120K,
// TIME1='3,0',
// T1ME2='3,0',
// OLDMSTR=AQOLDMST,
// NEWMSTRsAONEWMST,
// UNIT=3330,
// SERIAL=CDHSPK,
// OISP1='OLD,DELETE',
// PISP2='NEW,CATLG,DELETE',
// SPCUNIT=TRK,
// PRIMARY=20,
// SECNDRY=10,
// TFMPsSYSDA,
// WORKSPC=50,
// TRANS=TKANS,
// OUT=A
//*
//SORT EXEC PGMs&PROGl,
// REGIONsttRl,
// TIMEs(iTIMEl)
//*
//* SORT INTERNAL TRANSACTIONS INTO FILE SEQUENCE
//*
//STEPLIB DO DSNAMES&PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DlSPs(SHR,PASS)
//SORTLIO DO OSNAME=SYS1.SORTLIB,
// DlSPs(SHR,PASS)
//*
//SYSOUT DD SYSOUTs&OUT
//*
//SORTWK01 DD UNITs&TEMp,
// SPACES(TRK,(RWORKSPC),,C()NTIG)
//*
//SOPTWK02
//*
//SORTWK03
//*
//* INPUT DATA SET • INTERNAL TRANSACTIONS
//*
//AQSINPUT DD DSNAMEs&PKClJtCT,.OATA,&TRANS,
// OISPs(&DlSPl)
DD UNITs(RTEMP,SEP = SriRTWK01),
SPACEs(TRK, (fttvURKSPC),f CONTIG)
DD UNIT=((tTEMP,SEPs(SORTWK01,SORTWK02)),
SPACE=(TRK,(&W(IRKSPC),,CONTIG)
00000100
00000200
00000300
00000400
00000500
00000600
00000700
OOOOOHOO
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00005800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005600
Figure 4.5.3-d.
(page 1 of 3)
Cataloged Procedure AQFMM10
178
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 19
Release Date: 4/30/79
Update #: 24
//*
//• OUTPUT DATA SET - SORTED INTERNAL TRANSACTIONS
//*
//AQ60UTPT DO UNIT=RTEMP,
// OlSP=(NtW,PASS,DELETE),
// SPACE=CTRK,(RWORKSPC),RLSE),
// DSNAME=R&SORTED
//*
//* OUTPUT DATA SET • SUMMARY INFORMATION
//*
//AOSPRINT 00 SYSOUT = 8,OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DO SYSOUTsROUT
//*
//SYSOUT 00 SYSOUTs&OUT
//*
//SYSDBOUT 00 SYSOUT=&OUT-
//*
//SYSDTERM DO SYSOUT=&OUT
//*
//SYSUDUMP DO SYSOUT=&OUT
//*
//*
//UPDATE EXEC PGM=RPROG2,
// REGION=RR2,
// TIME=(&TIME2)
//*
//* MAINTAIN AODHS-I1 MASTER FILE
//*
//STEPLIB DO DSNAME=&PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
// DO OSNAME=SYS1.COBLIB,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - FILE MAINTENANCE CONTROL CARD
//*
//AOSINPUT 00 ODNAME=OPTIONS,
// DCB=BLKSIZE=80
//*
//* INPUT DATA SET - SORTED INTERNAL TRANSACTIONS
//*
//AQ3INTRN DO DSNAHE = &HSORT{-.D,
// DISP=(OLO,DELETE)
//*
//* INPUT DATA SF.T - OLO MASTER FILE
//*
//AQSOLDMS DO DSNAME=HPROJECT..DATA.&OLDMSTR,
// VOLUME=(PRIVATE,RETAIN),
// OISP=(SMH,PASS)
//*
//• OUTPUT DATA SET - NEW MASTER FILE
//*
//AOSNEWMS 00 UNIT=&UNIT,
// VOLUMES(PR IVATE,RtTAIN,SERs&SERIAL),
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006«00
00006900
00007000
00007100
00007200
00007300
0000700-0
00007bOO
00007600
00007700
00007600
00007900
00008000
00008100
00008200
00008300
00008100
00008500
00008600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009UOO
00009500
00009600
00009700
00009BOO
00009900
00010000
00010100
00010200
00010300
oooioaoo
OOOlObOO
00010600
00010700
00010*00
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
(page 2 of 3)
Figure 4.5.3-d - continued. Cataloged Procedure AQFMM10
179
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 20
Release Date: 4/30/79
Update #: 24
//*
//* OUTPUT
//*
//AOSCONFR
//*
//* OUTPUT
//*
//AOSPRINT
//*
//* OUTPUT
//*
X/AOSOLDRC
//*
//* OUTPUT
ft*
//AQSMEWRC
//*
//* OUTPUT
//*
//SYSPRINT
//*
//SYSOUT
//*
//SYSDBOUT
//*
//3YSDTERM
//*
//SYSUDUMP
/t*
SPACE"(&SPCUNIT,(&PRIMAHY,&SECNDRY),RLSE),
DSNAME=RPROJECT..OATA.dNEWMSTR
DATA SET - INTERNAL TRANSACTION LISTING
DO 3YSOUT=&OUT
DATA SET - DIAGNOSTIC MESSAGES
UD SYSOUTsROUT
DATA SET • OLD MASTER LISTING
DO SYSOUT=ROUT
DATA SET - NErt MASTER LISTING
DO SY30UT=&OUT
DATA SETS • SYSTEM OPERATION
DD SYSOUT = ltOUT
DO SYSOUTs&OUT '
I
DD SYSIJUTa&OUT
DD SYSOUT = 8,OUT
DD SYSOUT=80UT
00011700
00011BOO
00011900
oooiaooo
00012100
00012200
00012300
00012400
00012SOO
00012600
00012700
00012600
00012900
00013000
00013100
00013200
00013300
00013400
00013500
00013600
00013700
00013600
00013900
00014000
00014100
00014200
00014300
00014400
00014SOO
00014600
00014700
(page 3 of 3)
Figure 4.5.3-d - continued. Cataloged Procedure AQFMM10
180
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 21
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROG1
PROG2
Rl
R2
TIME1
TIME2
OLDMSTR
NEWMSTR
UNIT
SERIAL
DISP1
DISP2
SPCUNIT
PRIMARY
SECNDRY
TEMP
Default
Value
'CN.EPALMH.A087,
CDHS.HQ.AQS'
ASRINTR
AFMMSTR
100K
120K
'3,0'
'3,0'
AQOLDMST
AQNEWMST
3330
CDHSPK
'OLD,DELETE1
'NEW.CATLG,
DELETE1
TRK
20
10
SYSDA
Description
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQOLDMST would be
the full data set name of the old master file)
Master file internal transaction sort program
Master file maintenance program
Region size allocated for execution of ASRINTR
Region size allocated for execution of AFMMSTR
Time allocated for execution of ASRINTR
Time allocated for execution of AFMMSTR
Lowest-level index of old master file
Lowest-level index of new (or updated) master file
Unit type to which new (or updated) master file is
to be written
Serial number of volume to which new (or updated)
master file is to be written
Disposition of internal transactions
Disposition of new (or updated) master file
Units in which space for new (or updated) master
file is to be allocated
Primary space allocation for new (or updated)
master file
Secondary space allocation for new (or updated)
master file
Unit type for temporary work space
(Page 1 of 2)
Figure 4.5.3-e. Substitutable Parameters for AQFMM10
181
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.3
MASTER FILE MAINTENANCE
PROGRAM AFMMSTR (AQ0100)
Page 22
Release Date: 4/30/79
Update #: 24
Parameter
Name
WORKSPC
TRANS
Default
Value
50
TRANS
OUT
Description
Space allocation for sort work areas
Lowest level index of unsorted internal
transactions
SYSOUT class for all print files
Figure 4.5.3-e - Continued.
(Page 2 of 2)
Substitutable Parameters for AQFMM10
182
-------
CO
co
Example 1:
Col f
1 2-20 21-22 23-32 33-36 37-40 41-44 45-48 49-52
53-56
57-60 61-64 65-79 80
Entry
08
blanks blanks blanks blanks reading reading reading reading blanks A
Col I
2-20 21-22 23-32 33-36 37-40 41-44 45-48 49-52
53-56
57-60
61-64 65-79 80
Entry
16
reading reading reading reading reading reading reading reading blanks A
Exaaple 2:
Col I
2-20 21-22 23-32 33-36 37-40 41-64 65-79
80
Entry
00
reading reading blanks blanks A
NOTE: '...' Indicates that the fields in this range must be coded.
Figure 4.5.3-f. Sample Transactions to Modify Existing Master File Records
J> •-• JO
•-• i— o
z m zc
—I co
m o i
z 30 •-«
3» m •-•
r> —i
m «-•
O
•z.
3>
•o 3 in
TO 5> m
CD CO f)
m —I —1
•30 m «-•
> 30 o
3 m ui
co 3 co
o 3>
!-• =2
CD r>
C3 m
c: 30 -o
-o o> o>
a. —• ua
ai a> a>
c* D»
to vi ro
a> co
=*:
.. o
a>
c*
ro a>
co
o
-j
to
-------
AQDHS-II MASTER FILE MAINTENANCE PROGPAM
DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: AFMMSTR (AQ0100)
REVISION LEVELJ 1-00
LAST UPDATE »J £
> •— JO
-
m
oo
m o
3> m i—i
o —I
m t—i
o
xO
O
£T>
70
3=>
3 oo
^ m
oo o
—) —I
m •—i
3 m en
oo 3 OJ
—I >
73 1-1
Z
*^^ "^
i> m
o
o
o
Q.
CU
n>
=*t=
TO
n>
(D
CU
CO
cu
(Q
(D
ro
cu
rt-
ro o>
-P»
^
OJ
-------
AQDHS-II MASTER FILE MAINTENANCE PROGRAM - DIAGNOSTIC REPORT
PAGE
co
en
TRANSACTION
ERRORS/ACTION
21 371GA30203000997A05174't310::i 107080200
«** ACMMSIR 001 ERROR - READING 0* - ATTEMPT
Zl 3718630203000997A051744310211070B0208
*** AFMMSTR 001 ERROR - READING 09 - ATTEMPT
*** AFIIMSTR 001 ERROR - READING 12 - ATTEMPT
21 3718630203000997A05174431021107080800
*** AFMMSTR 001 ERROR - READING 05 - ATTEMi '
21 3718630203000997A05174431021107080808
**» AFMMSTR 001 ERROR - READING 11 - ATTEMPT
NUMBER OF INPUT INTERNAL TRANSACTIONS:
NUMBER OF INPUT MASTER FILE RECORDS:
NUMBER OF MASTER FILE RECORDS FLAGGED FOR DELETION:
NUMBER OF MASTER FILE RECORDS ADDED:
NUMBER OF OUTPUT MASTER FILE RECORDS:
NUMBER OF WARNING MESSAGES:
NUtlBER OF CONDITIONAL MESSAGES:
NUMBER OF ERROR MESSAGES:
NUMBER OF ABORT MESSAGES:
NUMBER OF DISASTER MESSAGES:
PROGRAM NAME: AFMMSTR (AQ0100)
REVISION LEVEL: 3-00
LAST UPDATE 8: 28
DATE INCORPORATED: MAY 1, 1981
00000030002000100000005000200010002
TO ADD DATA TO EXISTING READING - DATA REJECTED
0040001000300020000
TO ADD DATA TO EXISTING READING - DATA REJECTED
TO ADD DATA TO EXISTING READING - DATA REJECTED
30804000600050207001002100540003002
10 ADD DATA TO EXISTING READING - DATA REJECTED
303 2000
TO ADD DATA TO EXISTING READING - DATA REJECTED
1,057
0
0
Figure 4.5.3-g - continued.
(Page 2 of 2)
Diagnostic Report
S -n >
> -< O
-< r~* O
z m a:
-H CO
'1 O I
_Z. sO '—'
~3> m i—i
3»
~O IS CO
73 % m
O OO O
CD -H —I
73 m i—i
>• 73 O
m en
"2. co
O O
O rn
<=.
-o
o.
o>
<•+
n>
ro
a>
• • o
ai
<-+
ro n>
cx> ••
en
o
i—»
CXI
cu
IQ
re
ro
en
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.5.4
INPUT TRANSACTION SORT
PROGRAM ASRTRAN (AQ0370)
Page 1
Release Date: 10/31/81
Update #: 29
4.5.4 MASTER FILE INPUT TRANSACTION SORT PROGRAM - ASRTRAN (AQ0370)
4.5.4.1 Description
ASRTRAN (AQ0370) sorts master file input transactions into site file
sequence, as required by the master file transaction edit program, AEDMSTR
(AQ0060); Figure 4.5,.4-a details this sort order. All master file input
transactions must be sorted by ASRTRAN (AQ0370) before they can be edited by.
AEDMSTR (AQ0060). See Section 4.5.1 for additional information on master file
transactions.
4.5.4.2 File Formats
Input to ASRTRAN (AQ0370) consists solely of the master file input
transactions. See Section 4.5.1.2 for the master file transaction formats.
ASRTRAN (AQ0370) produces two output files: a file containing the sorted
master file transactions and a diagnostic report. The transactions are in the
same sequence as the site file and can be used as input to the master file
transaction edit program, AEDMSTR (AQ0060). A sample diagnostic report is
shown in Figure 4.5.4-b.
4.5.4.3 Options
There are no options.
4.5.4.4 Error Messages
There are no error messages.
185.1
-------
TRANSACTION
21
AQDHS-Il MASTER FILE MAINTENANCE PROGRAM - DIAGNOSTIC REPORT
ERRORS/ACTION
PAGE
371B630203000997A05277431021107080200 308006700500031007100830
*«* AFMMSTR OOJ ERROR - READING 02 - ATTEMPT TO ADD DATA TO EXISTING READING - DATA REJECTED
NUMBER UF INPUT INTERNAL TRANSACTIONSl 128
NUMBER UF INPUT MASTER FILE RECORDS: 301
NUMBER UF MASTER FILE RECORDS FLAGGED FOR DELETION: 0
NUMBER UF MASTER FILE RECORDS ADDED: 37
NUMBtR UF OUTPUT MASTER FILE RECORDS: 376
NUMBER OF WARNING MESSAGES: 0
NUMBER OF CONDITIONAL MESSAGES: 1
NUMBER OF ERROR MESSAGES: 1
NUMBER OF ABORT MESSAGES: 0
NUMBER OF DISASTER MESSAGES: o
PROGRAM NAME: AFMMSTR (AQ0100)
REVISION LEVEL: i-oo
LAST UPDATE ft: 20
DATE INCORPORATED: OCTOBER 31, me
CO
in
Figure 4.5.3-g - continued. Diagnostic Report
(page 2 of 2)
2 -n >
oo
m i— i
>
•U 3 OO
73 f> m
O OO O
CD —I —I
73 m •—i
> 70 O
•n r— •
3 m in
3 •
oo 3 oo
—) >
;o i—i
•j> m
JO Z.
o >
o
o
o
m
CX>
o-
ro
=«=
ro
70
O)
ro
O)
to
n>
o
CD
00
o
fa
U3
n>
ro
in
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 1
Release Date: 4/30/79
Update f: 24.
4.6 MULTI-PROGRAM PROCEDURES
4.6.1 MASTER FILE EDIT-MAINTENANCE PROCEDURE - AQEMM10
4.6.1.1 Cataloged JCL
The cataloged procedure AQEMM10 allows the user to edit AQDHS-II
transactions and update (or create) the AQDHS-II master file 1n one job run.
This procedure executes the master file transaction edit program AEDMSTR
(AQ0060), the master file Internal transaction sort program ASRINTR (AQ0130),
and the master file maintenance program AFMMSTR (AQ0100).
4.6.1.1.1 JCL listing - See Figure 4.6.1-a for a listing of this procedure.
4.6.1.1.2 Cross-reference of DD names and files
Program Name: AEDMSTR (AQ0060)
DD Name
AQSTRANS
AQSPARMS
AQSSITES
AQSOPTIN
AQSINTRN
AQSCONFR
AQSPRINT
File Description
AQDHS-II transactions
Parameter file
Site file
Option card
Edited Internal transactions
Input transaction confirmation listing
Diagnostic report
Input/Output
Input
Input
Input
Input
Output
Output
Output
186
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 2
Release Date: 4/30/79
Update #: . 24
Program Name: ASRINTR (AQ0130)
DP Name
AQSINPUT
AQSOUTPT
AQSPRINT
File Description
Unsorted internal transactions
Sorted internal transactions
Diagnostic report
Program Name: AFMMSTR (AQ0100)
DP Name
AQSINPUT
AQSINTRN
AQSOLDMS
AQSNEWMS
AQSCONFR
AQSOLDRC
AQSNEWRC
AQSPRINT
File Description
Option card
Sorted internal transactions
Old AQDHS-II master file
New or updated AQDHS-II master file
Internal transaction confirmation listing
Old master file confirmation listing
New master file confirmation listing
Diagnostic report
Input/Output
Input
Output
Output
Input/Output
Input
Input
Input
Output
Output
Output
j
Output
Output
4.6.1.1.3 User-supplied JCL - To execute the cataloged procedure AQEMM10, the
user can expect to supply job accounting information; input transactions; the
data set names of both the old and the updated (or new) AQDHS-II master file,
the parameter file, and the site file; and option cards to specify any desired
options. See Figure 4.6.1-b for a description of the procedure's substitu-
table parameters.
4.6.1.1.4 Sample run stream - The following run stream illustrates the use of
AQEMM10 to create an AQDHS-II master file from Input transactions stored "on
disk in a data set named CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQTRANS. The new
master file will be named CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQ1029V3; the data
187
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 3
Release Date: 4/30/79
Update f: 24
set names of the parameter and site files are their respective default values;
and the LIST and FLAGW options are specified for AEDMSTR (AQ0060) and for
AFMMSTR (AQ0100).
// EXEC AQEMM10,
// NEWMSTR=AQ1029V3
//EDIT.INPUT DD DISP=OLD,
// DSN=CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQTRANS
//EDIT.OPTIONS DD *
LIST FLAGW
/*
//UPDATE.AQSOLDMS DD DUMMY
//UPDATE.INPUT DD *
LIST FLAGW
188
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 4
Release Date: 4/30/79
Update #: 24
//*
//* PROCEDURE NAME! AOEMMIO
//* REVISION LEVEL! 1-00
//* LAST UPDATE Hi 24
//• DATE INCORPORATED! OCTOBER 31,1978
//•
//* THIS PROCEDURE ALLOWS 1HE USER TO EDIT AUDHS-II TRANSACTIONS AND
//* USE THE EDITED TRANSACTIONS TO MAINTAIN THE AUDHS-II MASTER FILE
//*
//*
//AQEMM10 PROC PROJECT='CN.EPALMH.A087.CDHS.HQ.AOS',
// PROGl=AfcDM3TR,
// PROG2sASRINTR,
// PROGJsAFMMSTR,
// RECJIGN18120K,
// REGION2»100K,
// REGIONSslOOK,
// TIMEla'3,0',
// TIME2a'3,0',
// T1ML3='3,0',
// ULDMSTRsAQOLDMST,
// NEWMSTRsAQNEWMST,
// PARMFlLsAOPARMFL,
// SITEFILsAOSITEFL,
// UNITs3330,
// SEKIALsCDHSPK,
// DlSPs'NEW,CATLG,DELETE',
// SPCUNITeTRK,
// PRIMARY820,
// SECNDRYalO,
// TEMP83Y3DA,
// WORKSPCsSO,
// OUT»A
//*
//EDIT
//
//
//*
//* EDIT AUDHS-II MASTER FILE TRANSACTIONS
//*
//STEPLIB DD D3NAMEsftPRQJECT..LOAD,
// VOLUME»(PRIVATE,RETAIN),
// DI3Ps(SHR,PASS)
// DD DSNAMCaSYSl.CIIHLID,
// DI3P8(3HR,PA3S)
//*
//* INPUT DATA SET • EDIT OPTIONS CONTROL CARD
//*
//AQSOPTIN DD DDNAMtaOPTIONS,
// DCBsBLKSIZEsBO
//*
//* INPUT DATA SET - AODHS-I1 MASTER FILE TRANSACTIONS
DD DDNAMMINPUT,
// DC8=OLKSIZE=80
//*
//* INPUT DATA SET • PARAMETER FILE
//*
EXEC PGM>&PROG1,
REGIONa&RF.UIUNl,
TlMEa(UIMEl)
//AOSTRAN3
00000100
00000200
00000300
00000400
00000500
00000600
00000700
OOOOOROO
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003600
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004600
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005600
(page 1 of 4)
Figure 4.6.1-a. Cataloged Procedure AQEMM10
189
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 5
Release Date: 4/30/79
Update I: 24
//AQSPARMC 00 DSNAME=&PROJECT..DATA.&PARMFIL,
ft VOLUM£=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - SITE FILE
//*
//AQSSITES 00 DSNAME=&PROJECT..DATA.RSITEFIL,
't VOLUME=(PRIVATt,RETAIN),
ft DISP=(SHR,PASS)
//* OUTPUT DATA SET - AQDHS-II INTERNAL TRANSACTIONS
//*
//AOSINTRN DD UNITx&TEMP,
" D1SP=(NEW,PASS,DELETE),
/' SPACE=(TRK, UWORKSPC),RLSE),
// DSNAME=&RTRANS
//*
//* OUTPUT DATA SET - TRANSACTION LISTING
//*
//AQSCONFR DD SYSOUT=&UUT
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//AQSPRINT DD SYSOUT=&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSUUT=&OUT
//*
//SYSOUT DD SYSOUT = &IJUT
//*
//SYSDBOUT DD SYSOUT=&UUT
//*
//SYSDTERM DO SYSUUTa&UUT
//*
//SYSUDUMP DD SYSOUT=&OUT
//*
//SORT EXEC PGM=&PROG2,
//*
//* SORT INTERNAL TRANSACTIONS INTO FILE SEQUENCE
//STEPLIW DD DSNAME=&PROJtCT.,LOAD,
f VULUMh=(PRIVATE,RETAIN),
// DISP=(SHK,PASS)
//30RTLIO DD DSNAME=SYS1.SORTLIB,
// DISP=(SHR,PASS)
//*
//SYSUUT
//*
//SORTWK01
ft SI'ACt=(TRK,(&t«ORKSPC),,CONTlG)
//*
//SORTWK02
//
//*
//SORTWK03 DD UNIT=(&TEMP,StP=(SORTrtKQl,SURTWK02)),
DD SYSOUT=&OUT
DD
DO
SPACEs(TRK,(HWORKSPC),,CONTIG)
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
00007«00
00007500
00007600
00007700
00007800
00007900
00008000
00008100
00008200
00008300
00008400
00008500
00008600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
00010800
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
Figure 4.6.1-a - continued.
(page 2 of 4)
Cataloged Procedure AQEMM10
190
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 6
Release Date: 4/30/79
Update #: 24
// SPACEsURK, (&WORKSPC),,CONT1G)
//*
//* INPUT DATA SET - UNSORTED INTERNAL TRANSACTIONS
//*
//AQSINPUT DD DSNAME»UTRANS,
// DlSPs(OLO,DELETE)
//*
//* OUTPUT DATA SET - SORTED INTERNAL TRANSACTIONS
//*
//AQSOUTPT DD UNITs&TEMP,
// D1SP=(NEW,PASS,DELETE),
// SPACEs(TRK,(RWURKSPC),RLSE),
// DSNAMES&&SORTED,
// OCB«(RECFM=FB,LRECL=68,BLKSIZEsl632)
//*
//* OUTPUT DATA SET • SUMMARY INFORMATION
//*
//AOSPRINT DD SYSOUTs&PUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD 3YSOUT=&OUT
//*
//SYSOUT DD SYSOUT=&DUT
//*
//SYSDnOUT DD SYSOUT = R(JUT
//*
//SYSDTERM OD 3YSOUT=&OUT
//3YSUDUMP OD 3YS(IUT=&OUT
//*
//*
//UPDATE EXEC PGMsRPROGS,
// REGKJNSRREGION3,
// TIME=(STIME3)
//*
//* MAINTAIN AQDHS-II MASTER FILE
//*
//STEPLIB DD DSNAMt = 8.PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
// DD DSNAMt=SYSl.COBLIB,
// DI3P=(SHR,PA3S)
//*
//* INPUT DATA SET - FILE MAINTENANCE CONTROL CARD
//*
//AQSINPUT OD DDNAMEsOPTIONS,
// DCBsBLKSIZE=80
//*
//* INPUT DATA SET - SORTED INTERNAL TRANSACTIONS
//*
//AQS1NTRN DD DSNAME = it&SORTED,
// DISPs(OLI),DELETE)
//*
//* INPUT DATA SET • ()LI> AQDHS-II MASTER FILE
//*
//AQSULDMS DD I)SNAME=RI'ROJECT. .OATA.&ULDMSTR,
// VOLUME=(PRIVATE,RETAIN),
00011700
ooonnoo
00011900
00012000
00012100
00012200
00012300
00012400
00012bOO
00012600
00012700
00012800
00012900
00013000
00013100
00013200
00013300
00013400
00013500
00013600
00013700
00013800
00013900
00014000
00014100
00014POO
00014300
00014400
00014bOO
00014600
00014700
00014800
00014900
00015000
00015100
00015200
00015300
00015400
00015500
00015600
00015700
00015800
00015900
00016000
00016100
00016200
00016300
00016400
00016500
00016600
00016700
00016800
00016900
00017000
00017100
00017200
00017300
00017400
Figure 4.6.1-a - continued.
(page 3 of 4)
Cataloged Procedure AQEMM10
191
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 7
Release Date: 4/30/79
Update #: 24
II
II*
II* OUTPUT
II*
//AQSNEWMS
II
I/
II
II*
II* OUTPUT
II*
//AQSCONFR
II*
/I* OUTPUT
II*
//AOSPRINT
II*
II* OUTPUT
II*
//AQSOLDRC
II*
It* OUTPUT
II*
//AOSNEWRC
II*
II* OUTPUT
II*
//SYSPRINT
II*
//SYSOUT
II*
//SYSDBOUT
II*
//SYSDTERM
II*
.//SYSUDUMP
II*
OISP=(3HR,PASS)
DATA SET - NEW AQDHS-II MASTER FILE
DO UNIT=&UNIT,
VOLUME = (PRIVATE, RET A1N,SER = &SERI AD,
DISP=UDISP),
SPACE=(RSPCUNIT,(&PRIMARY,&SECNDRY),RLSE),
DSNAMES&PROJECT..DATA.&NEWMSTR
DATA SET - UJTERNAL TRANSACTION LISTING
DD SYSOUT=&OUT
PATA SET - DIAGNOSTIC MESSAGES
DD SYSOUTs&OUT
DATA SET - OLD MASTER LISTING
DD SYSOUT=&OUT
DATA SET - NEW MASTER LISTING
DD SYSOUTs&OUT
DATA SETS - SYSTEM OPERATION
DD SYSOUTa&OUT
DD SYSOUTs&OUT
DD SYSOUT=&OUT
DD SYSOUTs&OUT
DD SYSOUTsftUUT
00017500
00017600
00017700
00017600
00017900
00018000
00018100
00018200
00018.500
oooinaoo
ooom^oo
00018600
00018700
00018800
00018900
00019000
00019100
00019200
00019300
00019400
00019500
00019600
00019700
00019800
00019900
00020000
00020100
00020200
00020300
00020400
00020500
00020600
00020700
00020800
00020900
00021000
00021100
00021200
(page 4 of 4)
Figure 4.6.1-a - continued. Cataloged Procedure AQEMM10
192
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 8
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROG1
PROG2
PROG3
REGION1
REGION2
REGIONS
TIME1
TIME2
TIME3
OLDMSTR
NEWMSTR
PARMFIL
SITEFIL
UNIT
Default
Value
'CN.EPALMH.A087
CDHS.HQ.AQS1
AEDMSTR
ASRINTR
AFMMSTR
120K
100K
100K
'3,0'
•3.0'
•3.0'
AQOLDMST
AQNEWMST
AQPARMFL
AQSITEFL
3330
SERIAL
DISP
CDHSPK
'NEU.CATLG,
DELETE1
Description
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQMSTOLD)
Master file transaction edit program
Master file internal transaction sort program
Master file maintenance program
Region size allocated for execution of AEDMSTR
Region size allocated for execution of ASRINTR
Region size allowed for execution of AFMMSTR
Time allocated for execution for AEDMSTR
Time allocated for execution of ASRINTR
Time allocated for execution of AFMMSTR
Lowest-level index of old master file
Lowest-level index of new (or updated) master
file
Lowest-level index of parameter file
Lowest-level index site file
Unit type to which new (or updated) master file
is to be written
Serial number of volume to which new (or updated)
master file is to be written
Disposition of new (or updated) master file
Figure 4.6.1-b.
(Page 1 of 2)
Substitutable Parameters for AQEMM10
193
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
SECTION 4.6.1
MASTER FILE MAINTENANCE
PROCEDURE AQEMM10
Page 9
Release Date: 4/30/79
Update I: 24
Parameter
Name
SPCUNIT
PRIMARY
SECNDRY
Default
Value
TRK
20
10
TEMP
WORKSPC
OUT
SYSDA
50
A
Description
Units 1n which space for new (or updated) master
file 1s to be allocated
Primary space allocation for new (or updated)
master file
Secondary space allocation for new (or updated)
master file
Unit type for temporary work space
Space allocation for sort work areas
SYSOUT class for all print files
(Page 2 of 2)
Figure 4.6.1-b - Continued. Substitutable Parameters for AQEMM10
194
-------
AQDHS-II USERS GUIDE
DATA ACCESSING AND
MANIPULATION
SECTION: 5.1
INTRODUCTION
Page: 1
Release Date: 4/10/79
Update #: 24
5.0 DATA ACCESSING AND MANIPULATION
5.1 INTRODUCTION
AQDHS-II provides the user with various data accessing and manipulation
capabilities which are primarily designed to perform intermediate steps in the
production of AQDHS-II reports. These are (1) the capability to extract or
retrieve specific data from the master file, (2) the capability to perform
various statistical analyses on data from the master file, (3) the capability
to archive data from the master file and to merge archived and active master
files (or any two distinct master files), (4) the capability to convert data
into formats required by various programs or to convert the units in which
data is recorded, and (5) the capability to sort the master file as required
by various programs.
195
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.1
RETRIEVAL
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: .24
5.2 RETRIEVAL
5.2.1 INTRODUCTION
The retrieval function 1n AQDHS-II 1s performed by executing two
programs: the retrieval languages processor program, ARTLNGP (AQ0110), and
the generated retrieval program, ARTGENR (AQ0120). The retrieval language
processor program must be executed first. All retrieval specifications are
processed by ARTLNGP (AQ0110) and, based upon the retrieval specifications,
ARTLNGP (AQ0110) produces the second retrieval program, ARTGENR (AQ0120),
which 1s referred to as the generated retrieval program. This generated
retrieval program must then be compiled and link edited before 1t can be
executed. When 1t 1s executed, 1t processes master file records and selects
those records which satisfy the retrieval specifications that were entered
Into ARTLNGP (AQ0110). The selected records are written to an output file
which 1s referred to as an AQDHS-II answer file. The answer file has the same
format as the AQDHS-II master file and may be used as Input to any AQDHS-II
program that uses the master file as Input. Refer to Figure 5.2.1-a for a
flowchart of the AQDHS-II retrieval function.
The retrieval package provides the user with a great amount of flexibi-
lity. He can use the retrieval package to select specific data from the
master file (e.g., all sulfur dioxide readings for the year 1976) and then
produce a detailed report containing only the selected data, or he can subject
the selected data to a statistical analysis. He could also use the retrieval
package to modify specific fields on the master file. (Note: The master file
would normally be updated or corrected using the programs AEDMSTR (AQ0060),
ASRINTR (AQ0130), and AFMMSTR (AQ0100). However, there are Instances when a
modification could be accomplished easier by using the retrieval programs. An
example of this 1s changing all flags on the master file to 'add'.) The
reader will find many examples of retrievals throughout this document,
particularly in Sections 5.2.2.5.4, 5.2.3.5.4, and 7.0.
196
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.1
RETRIEVAL
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
A special use of the retrieval programs is to produce the necessary input
file for the sliding average program, ASTSLAV (AQ0180), in order to produce
the sliding average report. The retrieval specifications entered into ARTLNGP
(AQ0110) must specify that a sliding average retrieval is desired. The file
produced by ARTGENR (AQ0120) in this case is referred to as a sliding average
answer file and must not be confused with the standard answer file. Refer to
Section 5.3.4 for a complete discussion of the production of a sliding average
report.
Detailed information on ARTLNGP (AQ0110) and on the retrieval specifica-
tions can be found in Section 5.2.2. Detailed Information on ARTGENR (AQ0120)
can be found in Section 5.2.3.
Three procedures are available for executing the retrieval programs.
They are AQRTM10, AQRTM20, and AQRTM30. The procedure AQRTM10 executes
ARTLNGP (AQ0110); then compiles, link edits, and executes the generated
retrieval program ARTGENR (AQ0120). ARTGENR (AQ0120) is not saved. See
Section 5.7 for additional information on AQRTM10.
If the user frequently performs the same retrieval, he should save the
load module of the generated retrieval program created by ARTLNGP (AQ0110) for
that retrieval. He can then perform the retrieval by executing this load
module directly, using the cataloged procedure AQRTM30 (see Section 5.2.3.5).
The load module can be created and saved by executing the cataloged procedure
AQRTM20 (see Section 5.2.2.5).
197
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.1
RETRIEVAL
INTRODUCTION
Page 3
Release Date: 4/30/79
Update #: . 24
' RETRIEVAL
SPECIFICATIONS
GENERATED RETRIEVAL/
PROGRAM SOURCE
MODULE \
COBOL COMPILE AND
LINK EDIT
ANSWER
FILE
ARTLNGP (AQ0110)
RETRIEVAL LANGUAGE
PROCESSOR PROGRAM
/
AQDHS-II
I MASTER FILE
ARTGENR (AQ0120)
GENERATED RETRIEVAL
PROGRAM
DIAGNOSTIC
REPORT
RETRIEVAL SKELETON
PROGRAM (ARTSKEL)
DIAGNOSTIC
REPORT
ANSWER FILE
LISTING
(OPTIONAL;
Figure 5.2.1-a. Retrieval Flowchart
198
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 1
Release Date: 4/30/79
Update #: . 24
5.2.2 RETRIEVAL LANGUAGE PROCESSOR PROGRAM - ARTLNGP (AQ0110)
5.2.2.1 Description
ARTLNGP (AQ0110) 1s the first of two AQDHS-II programs used to retrieve
data from the AQDHS-II master file. The generated retrieval program, ARTGENR
(AQ0120), must be compiled, link edited, and executed after ARTLNGP (AQ0110)
1s run to complete the retrieval process.
The retrieval language processor program, ARTLNGP (AQ0110), uses the
retrieval skeleton program, ARTSKEL, and user-supplied retrieval specification
cards to build a generated retrieval program, ARTGENR (AQ0120). All options
and retrieval requirements are contained in the specification cards (see
Section 5.2.2.2).
The retrieval requests can be written in either the AQDHS-II retrieval
language (see Section 5.2.2.2) or in COBOL. COBOL statements may be included
on cards with the execution JCL or stored as copy members in an external
source library.
Retrievals may be run in either the standard or the sliding average mode;
output answer file records from either mode can be optionally listed. The
sliding average answer file is used as input to ASTSLAV (AQ0180), the sliding
average program (see Section 5.3.4). A standard answer file may be used as
input to any program that can use the AQDHS-II master file as input.
5.2.2.2 File Formats
ARTLNGP (AQ0110) uses two input files: the retrieval skeleton program
ARTSKEL, which is stored in a cataloged source library, and the retrieval
specification card file. The retrieval specification cards consist of
retrieval control cards and retrieval request cards. The control cards
199
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 2
Release Date: 4/30/79
Update #: 24
indicate the beginning and end of the retrieval specification file, the
language the requests are written in, the retrieval mode, and whether or not
the LIST option is to be in effect. The control cards also contain the member
names required for COBOL retrievals and the name to be assigned to the
retrieval load module should the user want to save it. Figure 5.2.2-a
illustrates the format of the control cards and Figure 5.2.2-b contains the
field definitions.
The retrieval requests precisely identify the data to be retrieved from
the master file. The data names that can be used for these requests are
listed in Figure 5.2.2-c; each valid data name is defined in Figure 5.2.2-d.
The AQDHS-II retrieval language requirements are discussed in Section
5.2.2.2.1; the COBOL requirements in Section 5.2.2.2.2.
Two output files are produced: a temporary file containing the retrieval
source program, ARTGENR, and a diagnostic report (see Figure 5.2.2-e).
5.2.2.2.1 AQDHS-II retrieval language - The AQDHS-II retrieval language is
designed to allow the user to select records from the AQDHS-II master file
based upon the value of specific fields. See Figure 5.2.2-c for a list of
those master file fields that can be used in the AQDHS-II retrieval language.
The AQDHS-II retrieval language specifications are written in the format
described in Figure 5.2.2-f. See Figure 5.2.2-g for the definitions of the
fields in these statements.
There are two types of operators used in the AQDHS-II retrieval language:
the relational and the Boolean. The relational operator indicates the
relationship between a subject name and an object name. That is to say, the
relational operator actually asks a question and assigns a truth value (true
or false) depending on the answer to that question. The valid relational
operators are '=' (equality), '>' (greater than), and '<' (less than). The
construction of a relationship is as follows:
200
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 3
Release Date: 4/30/79
Update #: 24
'subject name' 'relational operator1 object name'.
An easy way to determine the truth value of the relationship is to ask the
following question:
Is 'subject name1 'relational operator' 'object name'?
If the answer is 'yes', the truth value of that relationship is true, if
the answer is 'no1, the truth value is false. Following are examples of
relationships and their truth values:
Subject Name Relational Operator Object Name Truth Value
11
11
11 <
11 <
11 >
11 >
The Boolean operator determines a truth value for a relationship or a set
of relationships. The valid Boolean operators are NOT, AND, and OR. The
construction of a Boolean expression involving AND or OR is as follows:
'Relationship 1' 'Boolean operator' 'Relationship 2'.
An easy way to determine the truth value of an expression using AND is to
ask the question:
Is the truth value of both relationships true?
11
12
12
10
10
12
True
False
True
False
True
False
201
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 4
Release Date: 4/30/79
Update #: 24
If the answer is 'yes1, the truth value of the expression is true; if the
answer is 'no1, the truth value is false. An easy way to determine the truth
value of a Boolean expression using OR is to ask the question:
Is the truth value of either one of the relationships true?
If the answer is 'yes', the truth value of the expression is true and if
the answer is 'no', the truth value is false.
The basic construction of a Boolean expression using NOT is as follows:
'NOT' 'relationship'.
An easy method to determine the truth value of the NOT expression is to
reverse the truth value of the relationship; in other words, if the truth
value of the relationship is true, then the truth value of the NOT
relationship is false and vice-versa. A table of truth values for Boolean
expressions is shown in Figure 5.2.2-h.
The use of relationships and Boolean expressions in AQDHS-II retrievals
is shown in the following set of examples. The examples will be structured as
follows: (1) an assumption concerning the specific data to be retrieved from
an existing master or answer file; (2) the AQDHS-II retrieval statements
needed to accomplish the request; (3) a brief discussion of how the computer
will evaluate the retrieval specifications; (4) a brief discussion of the
records which qualify for retrieval. It will be extremely helpful to keep in
mind that during a retrieval, the computer is examining only one single record
at a time. After that record has been examined, and its qualification for
retrieval determined, the following record in the file is then examined.
202
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLN6P (AQ0110)
Page 5
Release Date: 4/30/79
Update #: 24
Example 1
Assume you want to retrieve all of the 1979 data in the master file.
The retrieval control statements to accomplish that request are:
Col 1-22
Subject
Name
$$SELECT
YEAR
$$END
Col 24
Negation
Flag
Col 26
Relational
Operator
=
Col 28-67
Object
Name
.79.
Col 69-71
Boolean
Operator
Each record in the input master file will be individually and
sequentially examined, and the question 'is the year equal to 79?' will be
asked. Thus, in this retrieval only those records in the master file which
have a 79 in the YEAR field will be retrieved.
Example 2
Assume you want to retrieve the records for the month of January, 1979.
The retrieval statements for this request are:
Col 1-22
Subject
Name
$$SELECT
YEAR
MONTH
$$END
Col 24
Negation
Flag
Col 26
Relational
Operator
=
=
Col 28-67
Object
Name
.79.
'01'
Col 69-71
Boolean
Operator
AND
203
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 6
Release Date: 4/30/79
Update #: 24
In this retrieval we have a Boolean expression containing two relation-
ships. For each individual record in the master file, the computer evaluates
each relationship separately and then evaluates the Boolean expression. Thus,
it determines if the YEAR field of the record is 79 and then if the MONTH
field is 01. After obtaining the truth value for each relationship, it then
evaluates the Boolean expression. If, and only if, the truth value of both
relationships is true, then the Boolean expression AND is true and that record
will be retrieved.
Example 3
Assume you want to retrieve 1979 data for nitrogen dioxide (42602) and
oxides of nitrogen (42603). The retrieval statements to accomplish the
request are:
Col 1-22 Col 24 Col 26
Subject Negation Relational
Name Flag Operator
$$SELECT
YEAR
PARAMETER-CODE
YEAR
PARAMETER-CODE
$$END
Col 28-67
Object
Name
'79'
'42602'
'79'
'42603'
Col 69-71
Boolean
Operator
AND
OR
AND
In this retrieval we have four relationships and two different Boolean
operators. The computer now has the problem of which operator to evaluate
first. That is, what is the hierarchy of the relational and Boolean
operators? If an expression does not contain parentheses, the computer
evaluates according to the following hierarchy:
204
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLN6P (AQ0110)
Page 7
Release Date: 4/30/79
Update #: . 24
1st (level 1)
2nd (level 1)
3rd (level 3)
4th (level 4)
All relational operators
Boolean NOT
Boolean AND
Boolean OR
If there are operators on the same level, the computer evaluates those
operators from left to right (top to bottom).
Therefore, using these rules for evaluating expressions, the computer
will determine a truth value for the entire expression for each individual
record as follows:
Step
1
2
3
4
5
6
7
Operation
YEAR = '79'
PARAMETER-CODE = '42602'
YEAR = '79'
PARAMETER-CODE = '42603'
Result of Step 1 AND result of Step 2
Result of Step 3 AND result of Step 4
Result of Step 5 OR result of Step 6
Referring to Figure 5.2.2-h, for a record containing oxides of nitrogen
for 1979, Step 7 will be evaluated as 'False1 OR 'True', which has a value of
'True', and the record will be retrieved. For a record containing nitrogen
dioxide for 1979, Step 7 will be evaluated as 'True' OR 'False1, which is
'True', and the record will be retrieved. For any other record, Step 7 will
be 'False'; thus any record not containing oxides of nitrogen for 1979 or
nitrogen dioxide for 1979 will not be retrieved.
NOTE: Step 7 can never be evaluated as 'True1 OR 'True1 since it is
impossible to have an individual record containing both a 42602
205
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 8
Release Date: 4/30/79
Update #: 24
(nitrogen dioxide) and 42603 (oxides of nitrogen) in the parameter-code
field.
In Example 3, we used the expression YEAR = '79' twice because of the
order in which the Boolean operators are evaluated. By using parentheses, we
can express the same retrieval with one less statement, as shown in Example 4.
Example 4
Same as Example 3, but this time parentheses will be used. That is,
retrieve nitrogen dioxide (42602) and oxides of nitrogen (42603) for 1979.
The retrieval statements to accomplish this request are:
Col 1-22 Col 24
Subject Negation
Name Flag
$$SELECT
YEAR
(PARAMETER-CODE
PARAMETER-CODE
$$END
Col 26
Relational
Operator
=
=
=
Col 28-67
Object
Name
• 79.
'42602'
'42603')
Col 69-71
Boolean
Operator
AND
OR
In this retrieval, parentheses were used to alter the hierarchy of
evaluation of the expression. To evaluate parenthetical expressions the
computer will first find the least most inclusive pair (i.e., the inner most
pair) of parentheses (see Figure 5.2.2-i) and derive a truth value for that
parenthetical expression using the normal method of evaluation. It then
proceeds through all sets of parentheses determining the truth value for each
set of parentheses. After having evaluated the parenthesized portion of the
206
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 9
Release Date: 4/30/79
Update #: 24
expression, the nonparenthesized expression Is evaluated as we have shown
previously. Thus, the computer evaluates this retrieval example as follows:
Step Operation
1 PARAMETER-CODE = '42602'
2 PARAMETER-CODE = '42603'
3 (Result of Step 1 OR result of Step 2)
4 YEAR = '79'
5 Result of Step 4 AND result of Step 3
Example 5
As an example of the NOT Boolean operator, consider a sliding average
retrieval for sulfur dioxide (42401) records for all years 1978 and later.
The retrieval statements are:
Col 1-22 Col 24
Subject Negation
Name Flag
$$SELECT
YEAR N
PARAMETER-CODE
$$END
The steps for evaluating
Step
1
2
Col 26 Col 28-67
Relational Object
Operator Name
SLIDING
< '78'
'42401'
this retrieval would then be:
Operation
YEAR < '78'
PARAMETER-CODE = '42401'
Col 69-71
Boolean
Operator
AND
207
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 10
Release Date: 4/30/79
Update #: 24
3 NOT (Result of Step 1)
4 Result of Step 3 AND result of Step 2
Two fields, STATUS-FLAG and DATA-FIELD, are in the repeating portion of
the AQDHS-II master file record. When these fields are used in retrievals,
the retrieval expression will be evaluated for each occurence of the repeating
field in the record. The entire record will be retrieved if the expression is
'True' for any occurence of the repeating field. The record will not be
retrieved if the expression is 'False' for all occurences of the repeating
field. Also, for data values, both the data value and the decimal code should
be expressed together. Thus, if it is desired to retrieve a value equal to
.05, the statement would be DATA-FIELD = '.05'. For negative values, a sample
statement would be DATA-FIELD < '-1.015'. Note that it is not necessary (nor
is it possible) to specify a decimal code as a subject name. The retrieval
programs will automatically take the decimal code of each reading into
consideration.
Example 6
Assume a user wants to retrieve all hourly data (TIME-CODE = 1) for TSP
(11101) and S02 (42401) which had readings greater than the SAROAD maximum
allowable readings. Standard units codes are desired for these parameters.
For 11101/01, the maximum value is 2000. For 42401/01 the value is 5240. In
AQDHS-II, a data reading of '9999' indicates a null-value; we will exclude
these from our retrieval. The following statements are used for this
retrieval:
208
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
Col 1-22 Col 24
Subject Negation
Name Flag
$$SELECT
TIME-CODE
UNIT-CODE
DATA-FIELD
(PARAMETER-CODE
DATA-FIELD
PARAMETER-CODE
DATA-FIELD
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 11
Release Date: 4/30/79
Update #: 24
Col 26 Col 28-67 Col 69-71
Relational Object
Operator Name
'I1
•or
< '9999'
'11101
> '2000'
'42401
> '5240'
Boolean
Operator
AND
AND
AND
AND
OR
AND
)
The steps to evaluate this retrieval are:
1
2
3
4
5
6
7
8
9
10
11
12
13
Operation
PARAMETER-CODE = '11101'
DATA-FIELD > '2000'
PARAMETER-CODE = '42401'
DATA-FIELD > '5240'
Result of Step 1 AND result of Step 2
Result of Step 3 AND result of Step 4
Result of Step 5 OR result of Step 6
TIME-CODE = 'I1
UNIT-CODE = '01'
DATA-FIELD < '9999'
Result of Step 8 AND result of Step 9
Result of Step 11 AND result of Step 10
Result of Step 12 AND result of Step 7
209
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 12
Release Date: 4/30/79
Update #: 24
In this retrieval, a record will be selected If the TIME-CODE field is 1,
the UNIT-CODE field is 01, the PARAMETER field is 11101, and any DATA-FIELD is
both greater than 2000 and less than 9999; or, if the TIME-CODE field is 1,
the UNIT-CODE field is 01, the PARAMETER field is 42401, and any DATA-FIELD is
both greater than 5240 and less than 9999.
5.2.2.2.2 COBOL retrievals - In-line COBOL language specifications are entered
immediately following the $$SELECT card which has USER coded as the language
keyword. These cards are punched according to COBOL rules for syntax and
punctuation. Any user-defined paragraph or section name should begin with the
prefix USER-to avoid conflict with other names in the program. Any valid
PROCEDURE DIVISION statements, with the exception of DECLARATIVES, may be
entered. Since the retrieval language processor program does not examine the
COBOL statements, any errors could result in COBOL diagnostics or
unpredictable results. A data field named SUB (PIC 99 COMP SYNC) is provided
for use as a subscript for referencing repeating data names (STATUS-FLAG and
DATA-FIELD). The COBOL reserved data name TALLY may be used as an
accumulator. All valid data names shown in Figure 5.2.2-c may be used. The
RECORD-QUALIFIES-SW is used to indicate whether or not a record is written on
the answer file (RECORD-QUALIFIES-SW equal to TRUE). The data names TRUE and
FALSE may be used to set RECORD-QUALIFIES-SW.
In a COBOL retrieval where DATA-FIELD is to be compared to a numeric
value, the numeric value must not be enclosed in quotation marks. For
example, a valid comparison would be:
IF DATA-FIELD (1) < 9999
while
IF DATA-FIELD (1) < '9999'
210
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 13
Release Date: 4/30/79
Update #: . 24
is invalid. Also, in user retrievals, DATA-FIELD only refers to the four-
digit reading and does not incorporate the decimal code as is done in AQDHS-II
language retrievals.
NOTE: The user is reminded that the above rules are only valid for user-
supplied COBOL retrievals (either in-line or copy member).
Any retrieval that can be run using the AQDHS-II retrieval language can
also be run using the USER option and COBOL statements, but nothing is gained
in these retrievals by using COBOL. However, some retrievals can only be
accomplished by using COBOL. Several examples follow to illustrate the
advantages of COBOL retrievals.
When running the AQDHS-II language retrievals, each record in the answer
file is exactly the same as the corresponding record in the input master file:
no changes to the records can be made. In a COBOL retrieval, changes can be
made to the answer file records. Example 1 illustrates one common use of this
capability.
Example 1
Assume that a user has submitted his 1979 data to SAROAD using program
ARPSARD (AQ0220) and that the data were submitted as 'adds'. However, he is
required to resubmit the 1979 data for some unforeseen reason. If copies of
the SAROAD submittal files were not kept, it will be necessary to re-execute
ARPSARD (AQ0200). However, the status flags on the master file indicate that
the data has been sent. The following in-line COBOL retrieval will change the
RECORD-STATUS-FLAG from S (sent, not anomaly screened) to N (not sent, not
screened) or from T (sent, screened) to V (not sent, screened). The
STATUS-FLAG for each reading will be changed from S (sent, not screened) to A
(add, not screened) or from T (sent, screened) to B (add, screened). The
SAROAD transactions can then be generated from the answer file using ARPSARD.
211
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 14
Release Date: 4/30/79
Update #: . 24
$$SELECT USER
GO TO USER-PARAGRAPH.
USER-REPEAT.
IF DATA-FIELD (SUB) IS NOT EQUAL TO 9999
IF STATUS-FLAG (SUB) IS EQUAL TO 'S1 OR
STATUS-FLAG (SUB) IS EQUAL TO 'C'
MOVE 'A1 TO STATUS-FLAG (SUB)
ELSE
IF STATUS-FLAG (SUB) IS EQUAL TO V OR
STATUS-FLAG (SUB) IS EQUAL TO 'D'
MOVE 'B' TO STATUS-FLAG (SUB).
ADD 1 TO SUB.
USER-REPEAT END.
EXIT.
USER-PARAGRAPH.
MOVE TRUE TO RECORD-QUALIFIES-SW.
IF YEAR IS EQUAL TO '79'
MOVE 1 TO SUB
PERFORM USER-REPEAT THRU USER-REPEAT-END
NBR-OF-READINGS TIMES
IF RECORD-STATUS-FLAG IS EQUAL TO 'S'
MOVE 'N1 TO RECORD-STATUS-FLAG
ELSE
IF RECORD-STATUS-FLAG IS EQUAL TO 'T1
MOVE 'V TO RECORD-STATUS-FLAG.
USER-PARAGRAPH-END.
EXIT.
$$END
In the above example, all records are written to the answer file (the
value true is moved to the RECORD-QUALIFIES-SW before any selection 1s
performed). Then the records are examined to see if the year is equal to
212
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLN6P (AQ0110)
Page 15
Release Date: 4/30/79
Update #: . 24
'79'; if so, the record status flag is examined. First, each reading is
examined. For non-null readings (those with a value other than 9999), the
status flag of the reading is changed from S to A or from T to B to indicate
that the reading has been added and not sent to SAROAD; all other status flags
are left unchanged. Then the record status flag is examined. If the record
status flag is S (meaning the record has been sent to SAROAD, but not all of
the readings have been screened), the record status flag is changed to N (the
record has not been sent to SAROAD and not all of the readings have been
screened). If the value is T (meaning the record has been sent to SAROAD; and
all of the readings have been screened), the record status flag is changed to
V (all the readings have been screened, but the record has not been sent to
SAROAD).
Example 2
A modification of the preceding retrieval would be to change the status
flags in the answer file so that all records would be screened by the anomaly
screening program. Such a modification is shown in this example.
A COBOL copy member containing the retrieval statements will be created
and cataloged prior to running the retrieval. The retrieval will then use
this copy member to create an answer file with all records flagged to be
screened.
COBOL copy member COPYEXM2
GO TO USER-PARAGRAPH.
USER-REPEAT.
IF DATA-FIELD (SUB) NOT EQUAL TO 9999
IF STATUS-FLAG (SUB) EQUAL TO 'B1
MOVE 'A' TO STATUS-FLAG (SUB)
ELSE
213
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 16
Release Date: 4/30/79
Update #: 24
IF STATUS-FLAG (SUB) EQUAL TO 'D'
MOVE 'C1 TO STATUS-FLAG (SUB)
ELSE
IF STATUS-FLAG (SUB) EQUAL TO T
MOVE 'S1 TO STATUS-FLAG (SUB).
ADD BINARY-1 TO SUB.
USER-REPEAT-END.
EXIT.
USER-PARAGRAPH.
MOVE TRUE TO RECORD-QUALIFIES-SW.
MOVE BINARY-1 TO SUB.
PERFORM USER-REPEAT THRU USER-REPEAT-END
NBR-OF-READINGS TIMES.
IF RECORD-STATUS-FLAG EQUAL TO 'T1
MOVE 'S1 TO RECORD-STATUS-FLAG
ELSE
IF RECORD-STATUS-FLAG EQUAL TO 'V
MOVE 'N1 TO RECORD-STATUS-FLAG.
USER-PARAGRAPH-END. EXIT.
The retrieval statements would then be as follows:
$$SELECT USER COPYEXM2
$$END
In Example 2, all records are written to the answer file. The SAROAD
status of each record and reading remains the same, but all of the file is
flagged to be screened by the anomaly screening procedure (that is all records
in the answer file have record status flags of S or N and reading flags of A,
C, or D). The answer file can then be used as input to the anomaly screening
procedure AQRPM45 for appropriate anomaly flagging.
214
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 17
Release Date: 4/30/79
Update #: 24
Example 3
This example makes use of a member name, a user-defined data member name,
and a user-defined subroutine member name. When It is desired to use either
user-defined data or a user-defined subroutine, all three fields (member name,
user-defined data member name, and user-defined subroutine member name) must
be used. In addition, at least one AQDHS-II language specification must be
used. This retrieval sample tests data for S02 (42401) and determines if the
mean value for the record is greater than 1.00 parts per million (units code
of 07). This retrieval provides an elementary violation-of-standards
technique.
The following copy members must be set up prior to running the retrieval:
RPTEST03;
MOVE FALSE TO RECORD-QUALIFIES-SW.
IF PARAMETER-CODE EQUAL TO '42401'
AND UNIT-CODE EQUAL TO '07'
MOVE ZERO TO USER-TOTAL-READING
USER-AVG-READING
USER-NBR
MOVE BINARY-1 TO SUB
PERFORM USER-CK THRU USER-CK-END NBR-OF-READINGS TIMES
DIVIDE USER-TOTAL-READING BY USER-NBR
GIVING USER-AVG-READING
IF USER-AVG-READING IS GREATER THAN 1
MOVE TRUE TO RECORD-QUALIFIES-SW.
DTTEST03
01 USER-DATA-STRUCTURE.
02 USER-TOTAL-READING PIC S9(5)V9(4) VALUE +0.
02 USER-AVG-READING PIC S9(5)V9(4) VALUE +0.
215
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 18
Release Date: 4/30/79
Update #: 24
02 USER-NBR
02 USER-DATA-FLD
02 USER-DATA-FLDO
USER-DATA-FLD
USER-DATA-FLD1
USER-DATA-FLD
USER-DATA-FLD2
USER-DATA-FLD
USER-DATA-FLD3
USER-DATA-FLD
USER-DATA-FLD4
USER-DATA-FLD
USER-DATA-FLDX
02
02
02
02
02
PIC 99 VALUE 0,
PIC S9(4).
REDEFINES
PIC S9(4).
REDEFINES
PIC S999V9.
REDEFINES
PIC S99V99.
REDEFINES
PIC S9V999.
REDEFINES
PIC SV9999.
PIC S9(4)V9(4).
RPTEST3A:
USER-CK.
MOVE DATA-FIELD (SUB) TO USER-DATA-FLD.
IF DECIMAL-CODE (SUB) EQUAL TO 0
MOVE USER-DATA-FLDO TO USER-DATA-FLDX
ELSE
IF DECIMAL-CODE (SUB) EQUAL TO 1
MOVE USER-DATA-FLD1 TO USER-DATA-FLDX
ELSE
IF DECIMAL-CODE (SUB) EQUAL TO 2
MOVE USER-DATA-FLD2 TO USER-DATA-FLDX
ELSE
IF DECIMAL-CODE (SUB) EQUAL TO 3
MOVE USER-DATA-FLD3 TO USER-DATA-FLDX
ELSE
MOVE USER-DATA-FLD4 TO USER-DATA-FLDX.
IF USER-DATA-FLDX IS LESS THAN 9998
ADD 1 TO USER-NBR
216
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 19
Release Date: 4/30/79
Update #: 24
ADD USER-DATA-FLDX TO USER-TOTAL-READING.
ADD 1 TO SUB.
USER-CK-END. EXIT.
The following retrieval specifications are used.
$$SELECT
YEAR
$$END
RPTEST03
DTTEST03 RPTEST3A
= YEAR
The AQDHS-II retrieval statement 'YEAR=YEAR' serves only to fulfill the
requirements for using the specified copy members.
5.2.2.2.3 Batched retrievals - Up to twenty retrievals can be run in one
execution of the retrieval procedure. Such retrievals are said to be
'batched1. Only AQDHS-II language retrievals using the standard mode (i.e.,
not sliding average) may be batched. When batching retrievals, each retrieval
begins with a $$SELECT card. Only the first $$SELECT card can contain options
(LIST and the generated load module name are the only valid options for
batched retrievals). One $$END card occurs at the end of all the retrievals.
The output answer file will contain all retrieved records. Each record
in the answer file will contain a letter, A-T, in the first position of the
record to indicate which retrieval selected the record. If a given record is
selected by more than one retrieval, it will appear once in the answer file
for each retrieval that selected it. The master file sort program ASRMSTR
(AQ0140) must be run using the BATCH option to sort the answer file so that
each retrieval's answer records are grouped together. Once the answer file
has been sorted, it may be used as input to any of the report programs. A
batched answer file should never be used in place of an AQDHS-II master file
in any procedures except those that produce reports, since the batched answer
file may contain duplicate records (that is, if a record satisfies more than
217
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 20
Release Date: 4/30/79
Update #: 24
one of the batched retrievals, a copy of the record will be on the answer file
for each retrieval that 1t satisfied).
The following example makes use of batched retrievals:
Example 1
Assume a user wants a detailed listing of first quarter 1979 data for
TSP, S02 and N0x» He 1s Interested only 1n hourly data for TSP, dally data
for S02, and all NOX data. For his report, he wants each parameter printed
separately, although some sites monitor more than one of these parameters.
The following retrieval statements will be used:
Col 1-22 Col 24 Col 26
Subject Negation Relational
Name Flag Operator
$$SELECT
YEAR
MONTH <
PARAMETER-CODE
TIME-CODE '
$$SELECT
YEAR
MONTH [ <
PARAMETER-CODE
TIME-CODE
$$SELECT
YEAR
MONTH <
PARAMETER -CODE
$$END
Col 28-67
Object
Name
'79'
'04'
'11101'
'!'
.79.
'04'
'42401'
'8'
.79.
'04'
'42603'
Col 69-71
Boolean
Operator
AND
AND
AND
AND
AND
AND
AND
AND
218
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 21
Release Date: 4/30/79
Update #: . 24
The answer file produced by this retrieval must be sorted by ASRMSTR
(AQ0140) using the BATCH option. The sorted answer file would then be used as
input to ARPMSTR (AQ0230) to produce the desired detailed report.
5.2.2.3 Options
The options allowed for ARTLNGP (AQ0110) are specified on the $$SELECT
retrieval control card. Information on this card can be found in Figure
5.2.2-a and Figure 5.2.2-b. Figure 5.2.2-j lists possible combinations of the
options for different types of retrievals.
5.2.2.4 Error Messages
ARTLNGP 001 CONDITIONAL - $$END CARD MISSING
Meaning: The last card for the retrieval specifications must be a! $$END.
If this card is missing, the error message will be printed,
but program execution will continue.
Action: No action required unless other errors have been detected.
ARTLNGP 002 ABORT - FIRST CONTROL CARD NOT $$SELECT
Meaning: The first control card for specifying a retrieval must be a
$$SELECT card. If this card is not present, the run is
aborted.
Action: Include the $$SELECT card and resubmit the job.
ARTLNGP 003 ABORT - DATA NAME INVALID 'identifier1
Meaning: Subject and object names (identifiers) must be spelled exactly,
including the hyphen, as spelled in the valid retrieval data
names, Figure 5.2.2-c. The program execution was prematurely
terminated.
Action: Correct the subject or object name (indicated by the identifier
1n the error message) and resubmit the job.
219
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 22
Release Date: 4/30/79
Update #: 24
ARTLNGP 004 ABORT - NO CONTROL CARDS IN INPUT STREAM
Meaning: There must be at least a $$SELECT and a $$END card in the
input run stream. The run was aborted.
Action: Include control cards as shown in 5.2.2.5.4 and resubmit the
job.
ARTLNGP 005 ABORT - INVALID NEGATION CHARACTER
Meaning: The character N should be used as the negation flag; otherwise,
the negation flag field should be blank. The run was aborted.
Action: Correct the error and resubmit the job.
ARTLNGP 006 ABORT - INVALID RELATIONAL OPERATOR
Meaning: The only valid relational operators are • denoting equal to, >
denoting greater than, and < denoting less than; any other
symbol will be rejected. The run was aborted.
Action: Correct the error and resubmit the job.
ARTLNGP 007 ABORT - INVALID BOOLEAN OPERATOR
Meaning: The valid Boolean operators are AND and OR. The run was
aborted.
Action: Correct the error and resubmit the job.
ARTLNGP 008 ABORT - $$SELECT OR $$END CARD EXPECTED BUT NOT FOUND
Meaning: An AQDHS-II retrieval language card with no Boolean operator
was followed by another retrieval language card. Since only
the last card in a retrieval may have no Boolean operator, the
run was aborted.
Action: Correct the retrieval and resubmit the job.
ARTLNGP 009 ABORT - RETRIEVAL LANGUAGE CARD EXPECTED BUT NOT FOUND
Meaning: The last AQDHS-II retrieval language card 1n a retrieval had a
Boolean operator with no matching relationship. The last
220
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 23
Release Date: 4/30/79
Update #: 24
retrieval language card in a retrieval must not contain a
Boolean operator; therefore, the run was aborted.
Action: Correct the retrieval and resubmit the job.
ARTLNGP 010 ABORT - NUMBER OF RETRIEVALS EXCEEDS BATCH LIMIT
Meaning: More than twenty retrievals have been batched in one run;
therefore, the run was aborted.
Action: Resubmit the job with no more than twenty retrievals batched in
one run.
ARTLNGP Oil ERROR - ALL STATEMENTS AFTER $$END CARD ARE IGNORED
Meaning: Cards have been found after the $$END card; these are ignored.
Action: None, if the cards after the $$END card can be ignored with no
significant change in the result of the retrieval; otherwise,
correct the retrieval and resubmit.
ARTLNGP 012 ABORT - MORE THAN ONE RETRIEVAL IN USER-WRITTEN COBOL RUN
Meaning: With the USER option specifying COBOL language statements,
only one retrieval ($$SELECT card) is allowed per run. The run
was aborted.
Action: Delete the additional retrievals and resubmit the job.
ARTLNGP 013 ABORT - MORE THAN ONE RETRIEVAL IN SLIDING AVERAGE RUN
Meaning: The SLIDING option on the first $$SELECT card will allow only
one retrlval to be processed. The run was aborted.
Action: Delete the additional retrievals and resubmit the job.
ARTLNGP 014 ABORT - ONLY THE FIRST $$SELECT CARD CAN SPECIFY OPTIONS
Meaning: Only the first $$SELECT card can specify options. Columns nine
through 72 of all subsequent $$SELECT cards must be blank;
therefore, the run was aborted.
Action: Correct the retrieval and resubmit the job.
221
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 24
Release Date: 4/30/79
Update #: 24
ARTLNGP 015 CONDITIONAL - INVALID PROGRAM NAME, USING ARTDFLT
Meaning: The name of the generated load module on the $$SELECT card be
seven characters or less; the first character must be
alphabetic, and the remaining characters must be alphabetic or
numeric. No spaces are allowed. If the name is found to be
invalid, the name 'ARTDFLT1 is used.
Action: No action is needed if the program name ARTDFLT is acceptable.
ARTLNGP 016 ABORT - INVALID $$SELECT CARD
Meaning: Invalid options appear on the $$SELECT card or an invalid
combination of options appear on the $$SELECT card. The run
was aborted.
Action: Refer to Figures 5.2.2-a, 5.2.2-b, and 5.2.2-j for valid
options and combinations of options. Correct the $$SELECT card
and resubmit the run.
5.2.2.5 Cataloged JCL
The cataloged procedure AQRTM20 which is discussed below, executes the
retrieval language processor program, ARTLNGP (AQ0110), then compiles and
link edits the generated retrieval program, ARTGENR (AQ0120), and stores the
resulting load module. The cataloged procedure AQRTM30 is used to execute the
stored load module and produce an answer file. See Section 5.2.3.5 for
information on AQRTM30.
The cataloged procedure AQRTM10 executes the retrieval language processor
program, then compiles, link edits, and executes the generated retrieval
program. The corresponding load module is not saved. See Section 5.7.1 for
information on AQRTM10.
5.2.2.5.1 JCL listing - Figure 5.2.2-k contains a listing of the cataloged
procedure AQRTM20.
222
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 25
Release Date: 4/30/79
Update #: 24
5.2.2.5.2 Cross-reference of DD names and files
Program Name: ARTLNGP (AQ0110)
DD Name
AQSINPGM
AQSINPUT
AQSRTRVR
AQSPRINT
File Description
Retrieval skeleton program
Retrieval specification cards
Generated retrieval source program
Diagnostic report
Input/Output
Input
Input
Output
Output
5.2.2.5.3 User-supplied JCL - To execute the cataloged procedure AQRTM20, the
user can expect to supply job accounting information and the name for the
generated retrieval program to be stored. See Figure 5.2.2-1 for a descrip-
tion of the procedure's substltutable parameters.
5.2.2.5.4 Sample run stream - The following run stream uses procedure AQRTM20
to create the retrieval load module ARTGEN1. This retrieval module can then
be executed using the procedure AQRTM30; see Section 5.2.3.5.4 for that run
stream. The AQDHS-II retrieval specifications entered indicate that the
retrieval will be for state 12 and site 001. This run stream is from the
AQDHS-II baseline test run series.
// EXEC AQRTM20,
// PGMSAVE=ARTGEN1
//COMPILE.INPUT DD *
$$SELECT ARTGEN1
STATE = '12' AND
SITE = '001'
$$END
/*
223
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 26
Release Date: 4/30/79
Update #: 24
5.2.2.6 Warnings and Special Instructions
The retrieval language processor program, ARTLNGP (AQ0110), edits the
retrieval specification control cards and the AQDHS-II retrieval language
cards, but does not edit user-written COBOL retrieval statements.
Both cataloged procedures AQRTM10 and AQRTM20 execute the COBOL compiler
after ARTLNGP (AQ0110) to compile the generated retrieval source program.
During the compilation of the generated retrieval source program, errors may
be encountered that were not detected by ARTLNGP (AQ0110). For example,
unmatched parentheses in AQDHS-II retrieval language cards will not be
detected by ARTLNGP (AQ0110) but will cause errors when the COBOL compiler is
executed. Also, errors in the user-written COBOL retrieval statements will be
detected by the COBOL compiler. Thus, when executing procedure AQRTM10 or
AQRTM20, error messages may be generated by the COBOL compiler. When this
occurs, the user should examine the retrieval specification cards for errors.
If'no errors can be found, the user should contact NADB for assistance.
General rules for retrieval specification control cards are presented
below:
Only the first $$SELECT card is edited for special option
fields. When coded, these optional fields must occur in exactly
the columns specified, must be spelled exactly as stated (see
Figure 5.2.2-a and Figure 5.2.2-b), and must reflect a valid
combination of options (see Figure 5.2.2-j).
When batching retrievals, each retrieval is preceded by a
$$SELECT card. Batched retrievals may only use the AQDHS-II
language specifications. No $$SELECT card except the first may
contain optional fields. Twenty batches are allowed.
224
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 27
Release Date: 4/30/79
Update #: 24
A $$END card must be the last card in the specification. If
any other cards follow the $$END card, they will be ignored.
For AQDHS-II language specifications, the following rules apply:
Names must be spelled exactly as shown in Figure 5.2.2-c.
All literals should be enclosed in quotes, and should be the
same length as that specified in Figure 5.2.2-d for the compared
field.
When specifying values for DATA-FIELD in AQDHS-II language
retrievals, remember that the data value is combined with the
decimal code; that is, a value of '1023' with decimal code of two
should be specified as '10.23', and '-258' with decimal code of
three is '-.258'.
If any repeating field satisfies the retrieval criteria, the entire
record qualifies for retrieval.
COBOL retrieval statements are not edited by ARTLNGP (AQ0110). COBOL
statements should follow ANS COBOL specifications. In COBOL statements, the
name DATA-FIELD refers only to the value contained in that field: DECIMAL-
CODE must be specified separately.
When COBOL copy members are used, they must be created and stored prior
to running the retrieval procedure.
The user-defined data and subroutine fields of the $$SELECT card must be
used in conjunction with a COBOL copy member and an AQDHS-II retrieval
language statement.
225
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 28
Release Date: 4/30/79
Update #: . 24
Sliding average answer files are for use with the sliding average program
ASTSLAV (AQ0180) only. Information on this program can be found in Section
5.3.4.
All records retrieved from a batched retrieval are written to the same
answer file. The master file sort program ASRMSTR (AQ0140) must be run using
the BATCH option to sort the records by batch numbers. This sorted file can
then be used as input to any of the report programs. See Section 5.6 for
information on ASRMSTR (AQ0140).
All null-value readings (value 9999) have a decimal code of 0. Care must
be taken to insure that null values are not retrieved by mistake. Thus, if it
is desired to retrieve values greater than '1050', the statements
DATA-FIELD > '1050' AND
DATA-FIELD N = '9999'
should be used.
When ARTLNGP (AQ0110) is run and encounters an abort error, the generated
retrieval source program, ARTGENR (AQ0120), will contain statements that will
cause compilation errors. Thus, the generated retrieval load module will not
be produced nor executed. When an abort occurs, correct the error encountered
by ARTLNGP (AQ0110) and resubmit the job.
The language processor program ARTLNGP (AQ0110) must always be run prior
to running the generated retrieval program ARTGENR (AQ0120). The two programs
may be run together using the cataloged procedure AQRTM10 or the generated
retrieval module may be stored using the cataloged procedure AQRTM20 and run
later using the cataloged procedure AQRTM30.
When specifying a generated load module name during a run using cataloged
procedure AQRTM20, the load module name must be specified on the $$SELECT
226
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 29
Release Date: 4/30/79
Update #: 24
card in the retrieval specifications and as the value of the substitutable
parameter PGMSAVE in the user-supplied JCL. If no load module is specified on
the $$SELECT card, the value ARTGENR should be specified for the substitutable
parameter PGMSAVE.
5.2.2.7 Cost Considerations
The following example provides an estimate of the cost of executing
ARTLNGP (AQ0110) and then compiling and link editing ARTGENR (AQ0120) using
the cataloged procedure AQRTM20. AQRTM20 was executed on an IBM 370/168 for
this example.
Size of skeleton program: 1,097 records
Number of retrieval specifications: 4 records
Size of generated program: 1,122 records
CPU time: 4.2 seconds
I/O time: 27.8 seconds
Total time: 37.4 seconds
Estimated cost: $5.85
5.2.2.8 Related Programs and Procedures
ARTLNGP (AQ0110) must always be executed in conjunction with ARTGENR
(AQ0120). The procedure AQRTM10 executes both of these programs, while
AQRTM20 executes ARTLNGP (AQ0110) and AQRTM30 executes ARTGENR (AQ0120).
227
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 30
Release Date: 4/30/79
Update #: . 24
Record Position
1
10
14
16
25
34
40
43
52
61
68
73
- 8
9
- 13
- 15
- 23
24
- 32
33
- 39
- 42
- 50
51
- 59
60
- 67
- 72
- 80
Field Length
8
1
4
2
8
1
8
1
6
3
8
1
8
1
7
5
8
Description
Card type
Unused
Language keyword
Unused
COBOL member name
Unused
Mode keyword
Unused
List option
Unused
User-defined data member name
Unused
User-defined subroutine member name
Unused
Generated load module name
Unused
Sequence number
Figure 5.2.2-a. AQDHS-II Retrieval Control Card
228
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 31
Release Date: 4/30/79
Update #: 24
Card Type: Identifies the type of control card.
Valid Codes: $$SELECT - Specifies the beginning of a retrieval request.
$$END - Specifies the end of a retrieval request and must
appear alone on the card.
Field Length: 8 characters.
Language Keyword: Identifies the type of retrieval language to be used.
Valid Code: USER - Retrieval specifications will be COBOL language
statements.
blank - Indicates that AQDHS-II retrieval language
specifications will be used.
Field Length: 4 characters.
COBOL Member Name: Indicates the name of a COBOL copy member residing in a
partitioned data set and containing COBOL language statements. A
copy member can be used for USER retrievals or in conjunction with a
user-defined data member and user-defined subroutine member.
Valid Code: blank - Specifies that the COBOL retrieval statements will
be placed after the $$SELECT card.
member name - Specifies the name of the member of an
external source library where the COBOL
retrieval statements reside. These COBOL
statements must have been stored in the
external source library under this member name
prior to the execution of the retrieval.
Field Length: 8 characters.
(Page 1 of 4)
Figure 5.2.2-b. Definition of AQDHS-II Retrieval Control Card Fields
229
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 32
Release Date: 4/30/79
Update #: 24
Mode Keyword: Identifies the retrieval mode.
Valid Codes: blank - Standard answer file is to be created.
SLIDING - Sliding average answer file is to be created.
The sliding average answer file contains
additional records to those meeting the retrieval
specifications. These records provide the
wraparound capability for calculating sliding
averages. The sliding average program ASTSLAV
(AQ0180) is described in Section 5.3.4.
Field Length: 8 characters.
List Option: Identifies whether or not the retrieved records are to be
printed.
Valid Codes: LIST - print all retrieved records.
NOLIST - Print no records.
blank - Print no records.
Field Length: 6 characters.
User-Defined Data Member Name: Identifies the name of a member in an external
source library containing a COBOL 01-level data structure. This
data member is used to define variables for user-defined sub-
routines, and it must be used in conjunction with a COBOL member,
user-defined subroutines, and AQDHS-II retrieval language specifica-
tions.
Valid Codes: blank - No user-defined data will be used.
member name - The member of an external source library
which is to be copied into the working-
storage section and assigned the label, 01
(Page 2 of 4)
Figure 5.2.2-b - Continued. Definition of AQDHS-II
Retrieval Control Card Fields
230
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 33
Release Date: 4/30/79
Update #: 24
USER-DATA-STRUCTURE, when the retrieval
program is generated.
Field Length: 8 characters.
User-Defined Subroutine Member Name: Identifies the name of a member in an
external source library containing a user-defined subroutine. The
user-defined subroutine can be invoked only by the user-written
COBOL statements defined in the COBOL member (columns 16-23). The
user-defined subroutine must be a closed subroutine; i.e., it cannot
call any other subroutines. This option must be used in conjunction
with a user-defined data member name, a COBOL member name and
AQDHS-II retrieval language specifications.
Valid Codes: blank - No user-defined subroutine will be used.
member name - The name of the member of an external source
library which contains the subroutine to be
copied.
Field Length: 8 characters.
Generated Load Module Name: Specifies the user-defined load module name when
the procedure AQRTM20 is used to create and store the load module of
a generated retrieval program. When this field is used, the name
specified must also be used for the substitutable parameter,
PGMSAVE, in the job stream for procedure AQRTM20.
Valid Code: blank - The name ARTGENR will be used for the generated load
module.
load module name - Must be seven characters or less
consisting of the letters A-Z and the
digits 0-9 and beginning with a letter.
(Page 3 of 4)
Figure 5.2.2-b - Continued. Definition of AQDHS-II
Retrieval Control Card Fields
231
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 34
Release Date: 4/30/79
Update #: 24
Field Length: 7 characters.
Sequence Number: An optional entry to allow the retrieval specification cards
to be numbered sequentially. No sequence checking is performed by
ARTLNGP (AQ0110).
Field Length: 8 characters.
(Page 4 of 4)
Figure 5.2.2-b - Continued. Definition of AQDHS-II
Retrieval Control Card Fields
232
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 35
Release Date: 4/30/79
Update #: . 24
Data Names for AQDHS-II and COBOL Language Retrievals
Data Name
ACTION-CODE
AGENCY
AQCR
AREA-CODE
COMPOSITE-KEY-3
COMPOSITE-PERIOD
COMPOSITE-SAMPLES
COMPOSITE-TIME-CODE
COMPOSITE-TYPE
COUNTY-CODE
DATA-FIELD*
DAY-CODE
FORM-CODE
IDENT-KEY
KEY-1
KEY-2
Field Length
1
1
3
4
6
2
2
1
1
4
See Figure 5.2.2-d
2
1
37
22
9
Data Name
KEY-3
METHOD-CODE
MONTH
NBR-OF-READINGS
PARAMETER-CODE
PROJECT
RECORD-STATUS-FLAG
SITE
SLAMS-ID
START-HOUR
STATE
STATUS-FLAG*
TIME-CODE
UNIT-CODE
YEAR
Field Length
6
2
2
2
5
2
1
3
1
2
2
1
1
2
2
Data Name
DECIMAL-CODE*
KEY-l-A
RPTING-SECTION*
Data Names for COBOL Language Retrievals Only
Field Length
1
20
6
Repeating data names.
Figure 5.2.2-c. Valid Retrieval Data Names
233
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 36
Release Date: 4/30/79
Update #: 24
ACTION-CODE: Indicates the last action performed on the master file record.
Valid Codes: 2 - Add
3 - Change
Field Length: 1 character.
AGENCY: Identifies the agency responsible for the sampling site.
Valid Codes: See Appendix A, Table 1.
Field Length: 1 character.
AQCR: Identifies the AQCR (Air Quality Control Region) in which the sampling
site is located.
Valid Codes: 001-247
Field Length: 3 characters.
AREA-CODE: Identifies the geographical area in which the sampling site is
located.
Valid Codes: Contact the EPA Regional Office for the valid codes.
Field Length: 4 characters.
COMPOSITE-KEY-3: Identifies, as a group the following fields:
COMPOSITE-PERIOD
COMPOSITE-SAMPLES
COMPOSITE-TYPE
COMPOSITE-TIME-CODE
Field Length: 6 characters,
COMPOSITE-PERIOD: Identifies tht period during which the composite sample was
taken.
1
Figure S.2.2=dt Definition of Retrieval Data Names
234
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 37
Release Date: 4/30/79
Update #: 24
Valid Codes: 01 - 04 Quarterly and Seasonal Composite
01 - 12 Monthly Composite
01 - 52 Weekly Composite
00 Annual Composite
Field Length: 2 characters.
COMPOSITE-SAMPLES: Indicates the number of individual samples that were
composited.
Field Length: 2 characters.
COMPOSITE-TIME-CODE: Indicates the interval at which the individual
composited samples were taken.
Valid Codes: SAROAD time codes are used; see Appendix A, Table 3. The
only valid composite time codes are 1-9, A, and B.
Field Length: 1 character.
COMPOSITE-TYPE: Indicates the interval for which the samples were composited.
Valid Codes: 1 - Quarterly Composite
2 - Seasonal Composite
3 - Monthly Composite
4 - Weekly Composite
5 - Annual Composite
Field Length: 1 character.
COUNTY-CODE: Identifies the county in which the sampling site is located.
Field Length: 4 characters.
(Page 2 of 8)
Figure 5.2.2-d - Continued. Definition of Retrieval Data Names
235
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 38
Release Date: 4/30/79
Update #: 24
*DATA-FIELD: The value of the sample taken.
Valid Codes: When DATA-FIELD is used in COBOL retrievals, it only refers
to the four-digit reading and does not incorporate the
decimal code; however, when DATA-FIELD is used in AQDHS-II
Retrieval Language, it refers to the value of the sample,
taking into account the decimal code. When DATA-FIELD is
used as the subject name in an AQDHS-II language retrieval,
the object name may be DATA-FIELD or any numeric literal
within apostrophes, positive or negative, with or without a
decimal point.
DAY-CODE: The day of the month on which the sample was taken.
Field Length: 2 characters.
'DECIMAL-CODE (COBOL Language Only): Indicates the position of an assumed
decimal within the four-character reading 1n the master file record.
Valid Codes: 0, 1, 2, 3, 4
Field Length: 1 character.
FORM-CODE: Indicates which transaction format was used to create the master
file record.
Valid Codes: 1 - Form 1
2 - Form 2
3 - Form 3
Field Length: 1 character.
*A repeating field.
(Page 3 of 8)
Figure 5.2.2-d - Continued. Definition of Retrieval Data Names
236
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 39
Release Date: 4/30/79
Update #: 24
IDENT-KEY: Identifies, as a group, the following fields:
KEY-1
KEY-2
KEY-3
Field Length: 37 characters.
KEY-1: Identifies, as a group, the following fields:
STATE
AQCR
COUNTY-CODE
AREA-CODE
SITE
AGENCY
PROJECT-CODE
TIME-CODE
YEAR
Field Length: 22 characters.
KEY-l-A (COBOL Language Only): Identifies, as a group, the following fields:
STATE
AQCR
COUNTY-CODE
AREA-CODE
SITE
AGENCY
PROJECT
TIME-CODE
Field Length: 20 characters.
(Page 4 of 8)
Figure 5.2.2-d - Continued. Definition of Retrieval Data Names
237
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 40
Release Date: 4/30/79
Update #: 24
KEY-2: Identifies, as a group, the following fields:
PARAMETER-CODE
METHOD-CODE
UNIT-CODE
Field Length: 9 characters.
KEY-3: Identifies, as a group, the following fields:
MONTH
DAY-CODE
START-HOUR
Field Length: 6-characters.
METHOD-CODE: Identifies both the collection method and the analysis method
for the parameter being measured.
Field Length: 2 characters.
MONTH: The month of the year during which the sample was taken.
Field Length: 2 characters.
NBR-OF-READINGS: Indicates the number of readings or samples contained in the
master file record.
Field Length: 2 characters.
PARAMETER-CODE: Identifies the parameter being measured.
Valid Codes: Refer to the AEROS Manual Series, Volume V: AEROS Manual
of Codes for a full list of currently accepted parameter
codes.
Field Length: 5 characters.
(Page 5 of 8)
Figure 5.2.2-d - Continued. Definition of Retrieval Data Names
238
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 41
Release Date: 4/30/79
Update #: 24
PROJECT: Identifies the project iji association with which the sample was
taken.
Valid Codes: See Appendix A, Table 2.
Field Length: 2 characters.
RECORD-STATUS-FLAG:
Valid Codes:
Field Length:
Indicates the SAROAD submission status and anomaly
screening status of the record.
S All readings in the record have been submitted to
SAROAD, but one or more non-null readings have not
undergone anomaly screening.
T All readings in the record have been submitted to
SAROAD and all non-null readings have undergone anomaly
screening.
N One or more readings in the record have not been
submitted to SAROAD, and one or more non-null readings
have not undergone anomaly screening.
V One or more readings in the record have not been
submitted to SAROAD, but all non-null readings have
undergone anomaly screening.
X Record has been flagged for deletion, all readings are
null.
1 character.
*RPTING-SECTION (COBOL Language Only): Identifies, as a group, the following
fields:
STATUS-FLAG
DECIMAL-CODE
DATA-FIELD
Field Length; 6 characters.
*A repeating field.
6 of 8)
Figure i.2.2-d - Continued. Definition of Retrieval Data Names
239
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 42
Release Date: 4/30/79
Update #: . 24
SITE: Identifies the site at which the sample was taken.
Field Length: 3 characters.
SLAMS-ID: Indicates whether the sampling site is a State and Local Air
Monitoring Station (SLAMS) or a National Air Monitoring Station
(NAMS) associated with the site.
Field Length: 1 character.
START-HOUR: The hour at which the first sample was taken.
Valid Codes: See Appendix A, Table 3.
Field Length: 2 characters.
STATE: Indicates the state (or other geographic division) in which the
sampling site is located.
Field Length: 2 characters.
*STATUS-FLAG: Indicates the status of the reading.
Valid Codes: A Reading has been added since submission to SAROAD and
has not undergone anomaly screening.
C Reading has been changed since submission to SAROAD and
has not undergone anomaly screening.
S Reading has been submitted to SAROAD but has not
undergone anomaly screening.
B Reading has been added since submission to SAROAD and
has undergone anomaly screening.
D Reading has been changed since submission to SAROAD and
has undergone anomaly screening.
*A repeating field.
(Page 7 of 8)
Figure 5.2.2-d - Continued. Definition of Retrieval Data Names
240
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 43
Release Date: 4/30/79
Update #: . 24
T Reading has been submitted to SAROAD and has undergone
anomaly screening.
Field Length: 1 character.
TIME-CODE: Indicates the interval at which the samples were taken.
Valid Codes: See Appendix A, Table 3.
Field Length: 1 character.
UNIT-CODE: Indicates the units in which the parameter was measured.
Valid Codes: See Appendix A, Table 4 for a partial list and
the AEROS MANUAL SERIES, Volume V: AEROS Manual of Codes
for a complete list of currently accepted units codes.
Field Length: 2 characters.
YEAR: The year in which the sample was taken.
Field Length: 2 characters.
(Page 8 of 8)
Figure 5.2.2-d - Continued. Definition of Retrieval Data Names
241
-------
AODHS-II RETRIEVAL LANGUAGE PROCESSOR PROGRAM - DIAGNOSTIC REPORT
PAGE
NAME* ARTLMCP CAoottO)
LEVELS 1-00
LAST WDATE *s 24
(DAME DWr'HHPJII»«JI.II>l OCTOBER 31, 1978
IlttffOT tCgHlfMOL CARDS}:
SSSELECT
WEAK
= '79'
= '01'
= '75'
AND
OR
SSEDSOD
(NUMBER m croiTRfflL CARDS RE ADI
MUKIBBR Wf RETRIEVAL SKELETON RECORDS READ:
IK0MBER (OF RETRIEVAL SOURCE RECORDS WRIT TEN I
[NUMBER OF CEmiBITIOUAL MESS AGES I
m vsmm MESSAGES:
m Asuntv MESSAGES:
5
1,147
1,192
0
0
0
Figure 5.2.2-e. Diagnostic Report
(/>
j» i
o •-«
o •-•
i-i 00
o co
3> X> CO
so m m
— I — I o
— . i— wi
3»
>o ro
o •
i-1 ro
cz 30 -o
•o n at
o. — > to
o> n> n>
c* O)
O) CO -fi
n> -P«
Ol
<-h
ro o>
co
o
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 45
Release Date: 4/30/79
Update #: 24
Record Position
1 -
28 -
69 -
72 -
22
23
24
25
26
27
67
68
71
80
Field Length
22
1
1
1
1
1
40
1
3
9
Description
Subject name
Unused
Negation flag
Unused
Relational operator
Unused
Object name
Unused
Boolean operator
Unused
Figure 5.2.2-f. AQDHS-II Retrieval Language Specifications
243
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 46
Release Date: 4/30/79
Update #: . 24
Subject Name: Specifies the name of the field in the AQDHS-II master file
record to be compared with the literal or the master file field name
specified by the object name.
Valid Codes: Only those fields listed in Figure 5.2.2-c can be used.
The spelling, including hyphen, must match exactly.
Field Length: 22 characters.
Negation Flag: Indicates whether the Boolean NOT condition is in effect.
Valid Codes: N - Boolean NOT is in effect.
space - Boolean NOT is not in effect.
Field Length: 1 character.
Relational Operator: Indicates the relationship to be tested between the
subject name and the object name.
Valid Codes: = equal
< less than
> greater than
Field Length: 1 character.
Object Name: A literal to be compared against the master file field specified
by the subject name, or the name of a master file field to be
compared against the master file field specified by the subject
name (e.g., subject name = object name).
Valid Codes: If a literal 1s used, 1t must be enclosed 1n apostrophes.
The length of the literal must be exactly the same as the
field length of the data name being compared (see Figure
5.2.2-d). If the name of a field from the master file 1s
used, 1t must match exactly one of the names listed 1n
(Page 1 of 2)
Figure 5.2.2-g. Definition of AQDHS-II Retrieval Language
Specification Fields
244
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 47
Release Date: 4/30/79
Update #: 24
Figure 5.2.2-c. However, It must not be enclosed in
apostrophes.
Field Length: 40 characters.
Boolean Operator: Identifies the type of connector used between the relation-
ship specified on this control card and that specified on the next
card.
Valid Codes: AND - Indicates that both relationships must be true in
order for the entire relationship to be true.
OR - Indicates that if either relationship is true, the
entire relationship is true.
blank - Indicates that there is no connector, and there-
fore, that there 1s no further specification.
Field Length: 3 characters.
(Page 2 of 2)
Figure 5.2.2-g - Continued. Definition of AQDHS-II Retrieval Language
Specification Fields
245
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 48
Release Date: 4/30/79
Update #: 24
Truth Value of
Relationship #1
Truth Value of
Relationship #2
Truth Value of
Relationship jl AND Relationship #2
False
False
True
True
False
True
False
'True
False
False
False
True
Truth Value of
Relationship #1
False
False
True
True
Truth Value of
Relationship #2
False
True
False
True
Truth Value of
Relationship #1 OR Relationship
False
True
True
True
Truth Value
of Relationship
Truth
Value
True
False
False
True
Figure 5.2.2-h. Truth Values for Boolean Expressions
246
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 49
Release Date: 4/30/79
Update #: . 24
((( A ) B ) C )
The least inclusive pair of parentheses is the pair around the letter A,
the second least inclusive set includes the letters A and B, and the most
inclusive set in this example includes letters A, B, and C. Thus, the order
of evaluation is from A to B to C.
((( A ) B ) (( C ) D ) E )
In this set both A and C have the least most inclusive pair; therefore,
the order of operation is left to right on the same level of parentheses.
That 1s, the order of operation 1n the above example is from A to C to B to D
to E.
Figure i.2.2-1. Examples of Parenthetical Expressions
247
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
\RTLNGP (AQ0110)
Page 50
Release Date: 4/30/79
Update #: 24
Type of Retrieval
AQDHS-II Retrieval Language
COBOL retrieval with COBOL statements
in retrieval specification card file
COBOL retrieval with COBOL statements
in COBOL copy member
COBOL retrieval with COBOL statements
in COBOL copy member which uses user-
defined data definitions and
user-defined subroutine
Option Fields on $$SELECT Card
O)
Q.
>v
H-
-o
(O
R
R
R
R
i
-a
&_
Q
jg
>«j
QJ
s^C
O)
m
(O
3
CD
C
(O
N
R
R
N
O)
E
•z.
^
O)
£
O)
2:
J
o
CQ
O
o
N
N
R
R
TU
i.
>^
01
0)
"O
O
0
0
0
c
o
•r^
4_)
Q.
O
^>
•i—
0
0
0
OJ
^
fO
2:
S-
CD
o
E
O)
2:
(D
03
O
-o
QJ
C
"P—
C|_
QJ
*U
1
i-
o:
t4_
o
01
c.
e~*.
O
-M
*
N
N
N
N Not allowed
0 Option^-/
R Required
* If the mode keyword is blank (standard retrieval), batching of retrievals is
allowed. If the mode keyword is SLIDING (sliding average retrieval),
batching of retrievals is not allowed.
Figure 5.2.2-j. Retrieval Options
248
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 51
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME: AQRTM20
REVISION LEVEL: 1-00
LA3T UPDATE »l 24
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO CREATE AN AODHS-1I GENERATED
RETRIEVAL PROGRAM AND THEN COMPILE THE LINK-EDIT THF. PROGRAM
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQRTM20 PROC PROJECTS'CM.EPALMH.A087.CDHS.HU.AQS',
// PROGRAM=ARTLNGP,
// TEMP=SYSOA,
// PGMSAVEsARTDFLT,
// MEMBER=ARTSKEL,
// UUT=A
//*
//COMPILE EXEC PGMz&PROGRAM,
// RFGION=70K,
// TIME=(1,0)
//*
//* PRODUCE AQOHS-II RETRIEVAL PROGRAM
//*
//STEPLIB DD PSNAME=&PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// ()ISP = (SHR,PASS)
// DD I)SNAME = SYS1.COHLIB,
// DI3P=(SHR,PASS)
//*
//* INPUT DATA SET - RETRIEVAL PROGRAM SKELETON
//*
//AQSINPGM DD DSNAME=RPROJECT..SOURCE(&MEMHER),
// VOLUME=(PRIVATE,RETAIN),
// l)I3P = (SHR,PASS)
//*
//* INPUT DATA SET - RETRIEVAL SPECIFICATION CARDS
//*
//AC1SINPUT DD DDNAME=INPUT,
// DCR=RLKSIZE=BO
//*
//* OUTPUT DATA SEF - GENERATED RETRIEVAL PROGRAM
//*
//AQSRTRVR DD IJNIT=&TF.MP,
// DISP=(NEW,PASS),
// SPACF.= (TRK,(5,2),RLSE),
// DSNAME=&&PROGRAM,
// DCB=BLKSIZEs3360
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//AQSPRINT DD SYSOUTs&OUT
//*
//* OUTPUT DATA SETS • SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUT=&UUT
//*
//S'YSOUT DD SYSOUT=ROUT
oooooioo
00000200
00000300
OOOOO'IOO
00000500
00000600
00000700
00000800
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003HOO
00003900
OOOO'IOOO
00004100
00004200
P0004300
00004400
00004500
00004000
00004700
00004800
00004900
00005000
00005100
OOOOS200
00005300
00005400
OOOOSSOO
00005600
00005700
00005800
(page 1 of 3)
Figure 5.2.2-k. Cataloged Procedure AQRTM20
249
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 52
Release Date: 4/30/79
Update #: 24
//SYSDBOUT 00 3YSOUT=»OUT
//*
//SYSDTERM 00 3YSOUT=&OUT
//*
//SYSUDUMP 00 SYSOUTs&OUT
//*
//COBOL EXEC PGMsIKFCBLOO,
// PARM='NOSEQ,NOSOURCE,SUPMAP,LIB,3IZExJ14K,HUF=30K,STATE,FLOWr10',
// REGION»200K,
// TIME=C2,0)
//*
//* COMPILE RETRIEVAL PROGRAM
//*
//*
//» INPUT DATA SET - SOURCE LIBRARY
//*
//SYSLIB OD DSNAMEa&PROJECT..SOURCE,
// VOLUMEsCPRIVATE,RETAIN),
// OI3P=(SHR,PASS)
//*
//* INPUT DATA SET - COBOL RETRIEVAL PROGRAM SOURCE CODE
//*
//SYSIN DO DSNAMEB&&PROGRAM,
// DISP=(OLD,DELETE)
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//SYSPRINT DO SYSOUTs&OUT
//*
//* OUTPUT DATA SET • COBOL RETRIEVAL PROGRAM OBJECT CODE
//SYSLIN 00 UNITs&TEMP,
// Dl3f'e(NEW,PASS),
// SPACE=(TRK,(5,2),RLSE),
// DSNAME=&&OBJMOD
//*
//* UTILITY DATA SETS
//*
//SYSUT1 00 UNIT=&TtMP,
3PACE=(TRK,(50,100))
//*
//SYSUT2
//*
//3YSUT3
//SY3UT«
//*
//LKED
DO UNITsUTEMP,SEP=SYSUTl),
SPACt=(TRK,(50,100))
DO UNITs(RThMP,SEP=(SYSUTl»SYSUT2)),
SPACE=(THK,(50,100))
DD UNITsUTEMP,SEPs(SYSUTl,SYSUT2,SYSUT3)),
3PACE=(TRK,(50,100))
\
EXEC PGMsItWL,
// PARMs'LIST,LET,XREF',
// COND=(5,LT,COBOL),
// REGIONslOOK,
// TIMts(l,0)
//*
//* LINK-EDIT RETRIEVAL
00005900
00006000
00006100
00006200
00006300
00006000
00006500
00006600
00006700
00006ROO
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
ooooaooo
OOOOB100
00008200
00008300
00008400
00008500
00008600
00006700
00008800
00008900
00009000
,00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010UOO
00010500
00010600
00010700
00010800
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
(page 2 of 3)
Figure 5.2.2-k - continued. Cataloged Procedure AQRTM20
250
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 53
Release Date: 4/30/79
Update #: 24
//*
//*
//* INPUT DATA SET - AUTO-CALL LIBRARY
DD DSNAME=&PRUJECT..LOAD,
VOLUME=(PR1VATE, RETAIN),
DISP=(SHH,PASS)
DD DSNAMEaSYSl.CUBLIB,
DISPc(SHR,PASS)
//SYSLIB
//
//
//*
//* INPUT DATA SET - COBOL RETRIEVAL PROGRAM OBJECT CODE
//*
//SYSLIN OD DSNAMEsR&OBJMODi
// DISP=(OLD,DELETE)
// DD DDNAME=INPUT,
// DCB=BLKSIZt=80
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//SYSPRINT DD 3YSOUT=&OUT
//*
//* OUTPUT DATA SET - COBOL RETRIEVAL PROGRAM LOAD MODULE
//*
//SYSLMOD DO VOLUMta(PRIVATE,RE TAIN),
// DISP=(OLD,PASS),
// DSNAME=&PROJECT..LOADUPGMSAVE)
//*
//* UTILITY DATA SET
//*
//SYSUT1 DD UNITn&TEMP,
// SPACF.= (TRK,(10,5))
//*
00011700
00011600
00011<»00
oooieooo
oooiaioo
00012200
00012300
00012UOO
00012500
00012600
00012700
00012ROO
00012900
00013000
00013100
00013200
00013300
00013400
00013SOO
00013600
00013700
00013BOO
00013900
00011000
00014100
00014200
00014300
00014400
00014*00
00014600
00014700
(page 3 of 3)
Figure 5.2.2-k - continued. Cataloged Procedure AQRTM20
251
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.2
RETRIEVAL
ARTLNGP (AQ0110)
Page 54
Release Date: 4/30/79
Update #: 24
Parameter
Name
Default
Value
Description
PROJECT
'CN.EPALMH.A087,
CDHS.HQ.AQS1
PROGRAM
TEMP
PGMSAVE
MEMBER
OUT
ARTLNGP
SYSDA
ARTDFLT
ARTSKEL
A
Highest-level index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
FTMSTRAA would be the full data set name of
an AQDHS-II master file)
Retrieval language processor program
Unit type for temporary work space
Output load module member name
Retrieval program skeleton
SYSOUT class for all print files
Figure 5.2.2-1. Substitutable Parameters for AQRTM20
252
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 1
Release Date: 4/30/79
Update #: 24
5.2.3 GENERATED RETRIEVAL PROGRAM - ARTGENR (AQ0120)
5.2.3.1 Description
ARTGENR (AQ0120), the generated retrieval program, is the second of two
AQDHS-II programs used to retrieve data from the AQDHS-II master file. The
retrieval language processor program, ARTLNGP (AQ0110), generates ARTGENR
(AQ0120), and must, therefore, be executed first. All retrieval requests and
options are specified on control cards and retrieval specification cards input
to ARTLNGP (AQ0110) (see Section 5.2.2.2).
The retrieval process may be performed two ways. The first is to execute
the procedure AQRTM10 (see Section 5.7). This procedure executes ARTLNGP
(AQ0110), then compiles, link-edits, and executes ARTGENR (AQ0120); ARTGENR
(AQ0120) is not saved. The second method allows for the generated retrieval
program to be saved for future runs (on other AQDHS-II master files). Two
procedures are used in this method; they may be run together in one job stream
or at different times. The first of these procedures, AQRTM20, executes '
ARTLNGP (AQ0110), then compiles, link-edits, and saves the generated retrieval
load module (see Section 5.2.2.5). The second procedure, AQRTM30, executes
the stored retrieval load module (see Section 5.2.3.5). This load module
corresponds to ARTGENR, but a different name should be used so that more than
one retrieval can be stored.
Further discussion of the AQDHS-II retrieval specifications, including
sample retrievals, can be seen in Section 5.2.2.2.
5.2.3.2 File Formats
ARTGENR (AQ0120) uses one input file, the AQDHS-II master file. See
Figure 4.5.3-a for the master file format.
253
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 2
Release Date: 4/30/79
Update #: 24
There are three files which are output from ARTGENR (AQ0120): a retrieved
answer file, an optional listing of the answer file, and a diagnostic report.
The answer file format is the same as that of the AQDHS-II master file;
however, the sliding average answer file can only be input to the sliding
average program ASTSLAV (AQ0180). See Figure 5.2.3-a for an example of the
diagnostic report and Figure 5.2.3-b for an example of the answer file listing.
5.2.3.3 Options
No option card is input to ARTGENR (AQ0120). The optional features of the
retrieval (such as the answer file listing and the type of answer file to be
produced are specified on the $$SELECT control card input to the retrieval
language processor program, ARTLNGP (AQ0110). See Section 5.2.2.2 for a
complete description of the $$SELECT card.
5.2.3.4 Error Messages
ARTGENR 001 ABORT - MASTER FILE CONTAINS NO RECORDS
Meaning: The input master file as specified in the user-supplied JCL
contains no records; therefore, the run was terminated.
Action: Correct the file name and resubmit the job.
ARTGENR 002 CONDITIONAL - ANSWER FILE CONTAINS NO RECORDS
Meaning: No records were found fitting the criteria specified in the
retrieval statements.
Action: Check the retrieval statements for accuracy if some records
should have been retrieved. Correct any errors and resubmit the
job.
254
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 3
Release Date: 4/30/79
Update #: 24
5.2.3.5 Cataloged JCL
The cataloged procedure AQRTM30 executes a stored generated retrieval
load module and produces an answer file. This load module must have first
been created and stored using the cataloged procedure AQRTM20. Information on
AQRTM20 can be found in Section 5.2.2.5.
5.2.3.5.1 JCL listing - Figure 5.2.3-c contains a listing of the cataloged
procedure AQRTM30, which executes the program ARTGENR (AQ0120).
5.2.3.5.2 Cross-reference of DP names and files
Program Name: ARTGENR (AQ0120)
DD Name
File Description
Input/Output
AQSMASTR
AQSANSWR
AQSPMSTR
AQSPRINT
AQDHS-II master file
Retrieved answer file
Answer file listing
Diagnostic report
Input
Output
Output
Output
5.2.3.5.3 - User-supplied JCL - To execute the cataloged procedure AQRTM30,
the user must supply job accounting information, data set names of the
AQDHS-II master file and the answer file, and the data set name of the stored
retrieval load module. See Figure 5.2.3-d for a description of the
procedure's substitutable parameters.
5.2.3.5.4 - Sample run stream - The following run stream uses the procedure
AQRTM30 to execute the retrieval load module ARTGEN1. ARTGEN1 was created and
stored by the procedure AQRTM20 (see Section 5.2.2.5.4 for the run stream).
This retrieval will select all records for state 12 and site 001. The master
file is 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQFINAL1 and the answer file is
255
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 4
Release Date: 4/30/79
Update #: 24
'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.RTANSR36'. See Figure 5.2.3-a for sample
output.
// EXEC AQRTM30,
// PROGRAM=ARTGEN1,
// MSTRFIL=AQFINAL,
// ANSWRFL=RTANSR36
5.2.3.6 Warnings and Special Instructions
When ARTLNGP (AQ0110) is run and encounters an ABORT error ARTGENR
(AQ0120) will execute if following it, but will not produce a valid answer
file. Generally, the error message 'ARTGENR 001 ABORT - MASTER FILE CONTAINS
NO RECORDS' will be printed. When this occurs, correct the error from ARTLNGP
(AQ0110) and resubmit the job.
The language processor program ARTLNGP (AQ0110) must always be run prior
to running the generated retrieval program ARTGENR (AQ0120). The two programs
may be run together using the procedure AQRTM10 or the generated retrieval
module may be stored and run at a later date, using procedures AQRTM20 and
AQRTM30.
The answer file is only a subset of the master file; any changes made to
the answer file during the retrieval process are not reflected in the master
file.
5.2.3.7 Cost Considerations
The following estimates are for the execution, on an IBM 370/168, of the
sample run stream shown in Section 5.2.3.5.4 and illustrate the cost of
executing AQRTM30.
256
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 5
Release Date: 4/30/79
Update #: 24
Size of AQDHS-II master file:
Size of answer file:
CPU time:
I/O time:
Total time:
291 records
1 record
.1 second
3.7 seconds
3.8 seconds
Estimated cost:
$1.07
5.2.3.8 Related Programs and Procedures
The cataloged procedure AQRTM10 should be used to perform one-time
retrievals. It executes the retrieval language processor program, ARTLNGP
(AQ0110), then compiles, link-edits, and executes the generated retrieval
program, ARTGENR (AQ0120). After the retrieval has been completed, the
generated retrieval program is deleted. For additional information on
AQRTM10, see Section 5.7.
257
-------
AUDHS-I1 GENERATED RtlRILVAL PRUGHAM - DIAGNOSTIC REPORT
PAKE
PROGRAM NAME: ARTGENR (AQ0120)
REVISION LEVEL: i-oo
LAST UPDATE U: 24
DATE INCORPORATED: OCTOBER 31, l<»/8
NUMBER OF MASTER FILE RECORDS READ:
NUMBER OF ANSWER FILE RECORDS WRITTEN:
NUMBER OF CONDITIONAL MESSAGES:
NUMBER OF ABORT MESSAGES:
331
118
0
0
ro
en
00
Figure 5.2.3-a. Diagnostic Report
3 o :>
> 3» JC3
TJ CO
C= 3> l
r- o HI
3> o »-i
— 1 m
•-• in
o
-O £T> CO
30 m m
O z* o
£n m —i
50 30 HI
3> J> o
73
m
30 H-.
ro
CD
en
ro
co
ex
Qi
«o
0<
«/>
n>
O>
=«»=
CJ
Ol
c+
ro n>
co
o
vo
-------
AQDHS-II MASU.R FILt DUMP
FIXED SEGMENT
22T
REPEATING DA1A
ACTION
ro
en
3al702980000100aA06B7M 11019
101010100 20T00035S09991S0999IS0999IS0999I 309901 T0096/4S09991509"') I 3099
9130999130999^00025509991309991809991309991309991309991100000
22T 341702980000100aAObB77111019
101020100 21TOOlSbTOOaSST 00455T00055 TOO455 T004b5TOO«5MOOT00455T00455T00455T0011910045ST00455T00455TOO«y;i
22T 3417104B00001003A06B77424019
101010100 31T10000T01500S0999IS09991309991S0999IT10000309991S049913099
9IS0999IS0999IT10012S0999IS0999IS09991S0999IS0999IT10034S0999IS0999130999IS
22T 3417104800001003AObB77<)24019
101020100 24309991S09991S09991S0999130999II1Jbl3309991 S09991S0999I3099
91S0999IT1000i)S0999lS09991309991S0999JS0999I T I 012BS09991S0999 [S0999 I Rf>9991S
22T 3al710QB00001003A06B77a2a019
1010J0100 26S0999IT10113S0999IS0999IS0999IS0999IS09991T1007«SO''t*9IS099
9IS0999IS09991S0999IT10076S09991S0999IS09991S09991509991110113.S09991SU990 IS
21S 371863020226099SA05177633011
118080000 21S20000S20000S20000S20000S20000S20000S20000S200 025^0 003S?00
36S20072S20091Sd0078S2008bS2010BS20072S09991S200i6S20010Sf?OOOIS20000S20l)OOS
21S 3718b302022b099SAOS177b33011
118080500 2«S20000S2000or,^OOOOS^OOOOSf>OOOOS^0
93S200b2S201iaS2010dS200b6S2007aS200«aS200'lbS?OOi; 15«!000 n3
21S 371Bb302022bO<>9SA05177b33011
118080600 21S20000S20000S20000S20000S20000S20001S20010S200J0320036:i200
3BS200BflS2013»S20130S2009b5200<18S200b2S20070S2rf03B320012S20001S20000S?OOOOS
21S 371Bb302022b099540bl77b33011
118080700 2flO(iO.S
21S 371Bb302022b0995AOS177b33011
11BOB0800 2«S20000S^0000320000S20000S2000IISPOO023200) 20030.S2UObHS200
9BS20121S20|37S20lq DC
"O tO
f= 3> i
r- o H-I
> o •-<
—« m
•— co
o co
o z
tn m
m — i
Z 70
3D t-<
ro
o
co
m
o
5"
ro
•
co
C 70 T3
-O ft) O)
O. —• (O
01 ro n>
C* Ql
n> w -»j
a>
=«5
o
Oi
c+
ro n>
co
o
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 8
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME! AORTM30
REVISION LEVEL! 1-00
LAST UPDATE «t 2H
DATE INCORPORATED! OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO RETRIEVE DATA FROM THE AQDHS-II
MASTER FILE BY EXECUTING A GENERATED AQDHS-II RETRIEVAL PROGRAM
THAT HAS i)EEN PREVIOUSLY COMPILED AND LINK-EDITED
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQRTM30 PROC f'R(JJECT='CN.EPALMH.A087.CDHS.HO.AQS',
// PROGRAMsRXRETRGO,
// TIME1='1,0',
// MSTRFILsAQMASTER,
// ANSWRFL=AQANSWER,
// UN1T=3330,
// SERIAL=CDHSPK,
// DISP='NfcW,CATLG,DELETE',
// SPCUNITsTRK,
// PRIMARYs20,
// SECNORYslO,
// OUT=A
//*
//*
//RETRIEVE EXEC PGMs&PROGRAM,
// REGIONalOOK,
// T1ME=(RTIME1)
//*
//* RETRIEVE ANSWER FILE FROM MASTER FILE
//*
//STEPLIB DD DSNAME=ftPROJECT,.LOAD,
// VOLUM£s(PRIVATE,RETAIN),
// D1SP=(SHR,PASS)
// DD DSNAMfcsSYSl.COBLlB,
// DISP=(SHR,PAS5)
//*
//* INPUT DATA SET - MASTER FILE
//*
//AQSMASTR DD OSNAMEs&PRUJECT..DATA.&M3TRFIL,
// VOLUME=(PRIVATE,RETAIN),
// OISP=(SHR,PASS)
//*
//* OUTPUT DATA SET - ANSWER FILE
//*
//AOSANSWR DD UNIT=RUNIT,
// VOLUME=(PRIVATE,KETAIN,SERsRSERIAL),
// DlSf'=(RDISP),
// SPACE=(R3PCUNIT,(&PRIMARY,RStCNDRY),RLSE),
// DSNAMts&PROJECT..DATA.RANSWRFL
//*
//* OUTPUT DATA SET - ANSWER FILE CONFIRMATION LISTING
//*
//ANSPMSTK DD SYSOUT = RflUT
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
00000100
00000200
00000300
00000400
OOOOObOO
00000600
00000700
oooooaoo
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
ooooieoo
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005SOO
00005600
00005700
00005800
(page 1 of 2)
Figure 5.2.3-c. Cataloged Procedure AQRTM30
260
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 9
Release Date: 4/30/79
Update #: 24
//AOSPRINT DO SYSOUTs&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPR1NT DO SYSOUT=RUUT
//*
/XSYSOUT
//*
//SYSDBOUT DO SYSOUT=&OUT
//*
//SYSDTERM DD SYSOUT=iOUT
//*
//SYSUDUMP DO SYSOUT=iOUT
//*
DD SYSOUT=dUUT
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006600
00006900
00007000
00007100
00007200
(page 1 of 2)
Figure 5.2.3-c - continued. Cataloged Procedure AQRTM30
261
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.2.3
GENERATED RETRIEVAL
PROGRAM ARTGENR (AQ0120)
Page 10
Release Date: 4/30/79
Update #: 24
Parameter
Name
Default
Value
Description
PROJECT 'CN.EPALMH.A087.
CDHS.HQ.AQS1
PROGRAM ARTDFLT
TIME1
MSTRFIL
ANSWRFL
UNIT
'1,0'
AQMASTER
AQANSWER
3330
SERIAL CDHSPK
DISP 'NEW,CATLG,DELETE'
SPCUNIT TRK
PRIMARY 20
SECNDRY 10
OUT A
Highest-level index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
AQMASTER would be the full data set name of
an AQDHS-II master file)
Stored retrieval load module (created by
AQRTM20)
Time allocated for execution of retrieval
Lowest-level index of master file
Lowest-level index of answer file
Unit type upon which the answer file is to
res i de
Volume serial number of volume to which
answer file is to be written
Disposition of answer file
Units in which space for answer file is to
be allocated
Primary space allocation for answer file
Secondary space allocation for answer file
SYSOUT class for all print files
Figure 5.2.3-d. Substitutable Parameters for AQRTM30
262
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: 24
5.3. STATISTICAL ANALYSIS
5.3.1 INTRODUCTION
There are two AQDHS-II statistical reports: the statistical analysis
report and the sliding average report. This section discusses how these
reports are produced.
5.3.1.1 Statistical Analysis Report
The AQDHS-II statistical analysis report is patterned after the SAROAD
statistical analysis report. The AQDHS-II statistical analysis report may be
produced using air quality data from the AQDHS-II master file or any AQDHS-II
answer file.
The user is afforded many options in the production of the statistical
analysis report: the maximum number of lines to be printed per page can be
specified; the user can specify a page break to be generated either when the
state code changes or when any change in the site key occurs; the user can
specify a statistical analysis by month, quarter, year, or total time period
(earliest to latest dates contained in the input file). Since the statistical
analysis package can be processed using any answer file, the user can retrieve
specific data from the master file (refer to Section 5.2) prior to execution
of the statistical analysis package. This allows the user to perform a
statistical analysis of selected data from the master file.
The statistical analysis package processes all records in the input mas-
ter or answer file. The data is grouped according to site key (state, AQCR,
county, area, site, agency, and project codes) and parameter key (parameter,
263
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
method, and units codes). The data is further grouped by year, quarter, or
month if a yearly, quarterly, or monthly report is being generated.
For each group of data, the following statistics are produced: percent
of the possible observations (readings) recorded for the time period; number
of observations; minimum detectable value; minimum observation; 10th, 30th,
50th, 70th, 90th, 95th, and 99th percentiles; maximum observation; second
maximum observation; third maximum observation; arithmetic mean; arithmetic
standard deviation; geometric mean; and geometric standard deviation. The
means and the standard deviations may be truncated before being printed; thus,
the right-most digit of these statistics may be one too low. Also, the
percentiles will be computed using a normalized frequency distribution when
the difference between the minimum and maximum observations is very large;
thus, in these cases there may be a slight error in the percentiles.
Four programs make up the statistical analysis package: the master
file sort program, ASRMSTR (AQ0140); the preliminary statistics program,
ASTPRLM (AQ0190); the statistical analysis program, ASTMSST (AQ0200); and the
statistical report program, ARPMSST (AQ0270). A system flowchart of the
statistical analysis package is shown in Figure 5.3.1-a.
The master file sort program, ASRMSTR (AQ0140), is executed using the
STAT option to sort the input master or answer file into site key/parameter
key/date order. Execution of ASRMSTR (AQ0140) is necessary if the input
master or answer file contains data from more than one calendar year and a
total time period report is being produced or if the input answer file was
produced by a batched retrieval. Execution of ASRMSTR (AQ0140) is strongly
recommended if the input master or answer file contains data from more than
one calendar year and a monthly, quarterly, or yearly report is being
produced; if the file is so sorted, all statistics for a given site/parameter
key combination will appear together in the report. Execution of ASRMSTR
264
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 3
Release Date: 4/30/79
Update #: 24
(AQ0140) is not necessary if the input master or answer file does not contain
data from more than one calendar year. (Refer to Section 6.4.2.5.4 for
examples of runs in which the master or answer file must be sorted and in
which the master or answer file need not be sorted.)
The preliminary statistics program, ASTPRLM (AQ0190), reads the sorted
master or answer file and the parameter file, performs preliminary analyses,
and produces two temporary files that are passed to ASTMSST (AQ0200). The
option card read by ASTPRLM (AQ0190) specifies whether a monthly, quarterly,
yearly, or total time period report is to be produced.
The statistical analysis program, ASTMSST (AQ0200), reads the temporary
files produced by ASTPRLM (AQ0190), performs further statistical analyses;
and produces a temporary file which is used by ARPMSST (AQ0270) to produce the
report.
The statistical report program, ARPMSST (AQ0270), reads the temporary
file passed from ASTMSST (AQ0200) and prints the statistical analysis report.
The option card read by ARPMSST (AQ0270) specifies the maximum number of lines
to be printed on each page and whether a page break is to be generated when
the state code changes or when any change in the site key occurs.
Refer to the following sections for a detailed discussion of each of the
programs used in the statistical analysis procedure: ASRMSTR (AQ0140),
Section 5.6; ASTPRLM (AQ0190), Section 5.3.2; ASTMSST (AQ0200), Section 5.3.3;
ARPMSST (AQ0270), Section 6.4.1.
ASRMSTR (AQ0140) is executed by the cataloged procedure AQSRM10, which is
discussed in Section 5.6.2.5. ASTPRLM (AQ0190), ASTMSST (AQ0200), and ARPMSST
(AQ0270) are executed by the cataloged procedure AQRPM10, which is discussed
265
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 4
Release Date: 4/30/79
Update #: 24
in Section 6.4.2.5. Examples of job streams to produce statistical analysis
reports are presented in Section 6.4.2.5.4.
5.3.1.2 Sliding Average Report
The AQDHS-II sliding average programs provide the user with a sliding
(i.e., running or moving) average of readings from the AQDHS-II master file.
This sliding average is of interest to the user because air quality standards
for some pollutants are expressed in terms of averages that cannot be exceeded
more than once per year. For example, the carbon monoxide level exceeds
federal standards if an eight-hour average of 10 mg/m^ is exceeded more than
once per year.
Unlike the statistical analysis report, the current AQDHS-II sliding
average report does not duplicate the sliding average reports in SAROAD. The
SAROAD sliding average reports are produced for certain combinations of
pollutants and sampling intervals. The AQDHS-II sliding average report can be
produced for any parameter and sampling interval combination existing in the
AQDHS-II master file. The user can, however, execute the AQDHS-II sliding
average programs using certain options that will produce the same information
as is produced by the SAROAD sliding average reports.
Six steps must be executed to produce a sliding average report: the
retrieval language processor program, ARTLNGP (AQ0110); the COBOL compiler;
the linkage editor; the generated retrieval program, ARTGENR (AQ0120); the
sliding average program, ASTSLAV (AQ0180); and the master file detailed report
program, ARPMSTR (AQ0230). Figure 5.3.1.-b presents a flowchart of the
sliding average programs. These programs are briefly discussed below.
ARTLNGP (AQ0110) 1s executed using the SLIDING option. The retrieval
specifications Input to ARTLNGP (AQ0110) should specify which data from the
266
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 5
Release Date: 4/30/79
Update #: 24
master file is to be included in the sliding average report. The user can
minimize the size and expense of the sliding average report by coding
retrieval specification statements to select only the data in which he is
specifically interested.
ARTLNGP (AQ0110) produces a diagnostic report and a source module for
ARTGENR (AQ0120). This source module will be tailored to the retrieval
specifications read by ARTLNGP (AQ0110) and must be compiled and link edited
to produce a load module for ARTGENR (AQ0120) which is then executed.
When ARTGENR (AQ0120) is executed, it will process the master file,
select those records satisfying the retrieval specifications, and produce a
sliding average answer file and a diagnostic report. It will also produce a
listing of the answer file if the retrieval specifications input to ARTLNGP
(AQ0110) include the LIST option.
The sliding average answer file and an option card are input to ASTSLAV
(AQ0180). The option card specifies the interval size of the sliding average.
For example, if an interval of three is specified and hourly data is being
processed, each reading is averaged with the readings for the two previous
hours. The option card also specifies whether more than 50% or at least 75%
of the readings in each interval must be present before an average for the
interval is computed. ASTSLAV (AQ0180) calculates the averages and produces a
sliding average values file and a diagnostic report.
The sliding average values file is input to ARPMSTR (AQ0230), which also
reads the parameter file, the site file, the parameter standards file, and an
option card.
267
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 6
Release Date: 4/30/79
Update #: 24
The option card may specify a DISPLAY option (i.e., print only those
averages that are less than, equal to, or greater than a specified value) or
it may be omitted. If the option card is omitted, all averages are printed.
ARPMSTR (AQ0230) produces a diagnostic report and the sliding average
%
report. Examples of the sliding average report are shown in Figure 6.2.2"-b.
The information in the headings is obtained from the parameter, parameter
standards, and site files.
Refer to the following sections for a detailed discussion of each of the
sliding average programs: ARTLNGP (AQ0110), Section 5.^.2; ARTGENR (AQ0120),
Section 5.$?3; ASTSLAV (AQ0180), Section 5.3.4; ARPMSTR (AQ0140), Section
u.a. o
5.6-.2. An example which illustrates the computation of sliding averages is
presented in Section 5.3.4.1.
268
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 7
Release Date: 4/30/79
Update #: 24
/ AQDHS-II
[ MASTER FILE OR
ANSWER FILE
/SORTED AQDHS-II/
' MASTER FILE OR
ANSWER FILE
I
OPTION CARD
SPECIFYING STAT OPTION
ASRMSTR (AQ0140)
MASTER FILE SORT PROGRAM
1
DIAGNO
REPOR
^ ^
AQDHS-II
PARAMETER
FILE
OPTION CARD
ASTPRLM (AQ0190)
PRELIMINARY STATISTICS PROGR/
PRELIMINARY
(STATISTICS FILE
(Temporary)
RAW DATA /
FILE
(Temporary)
DIAGNOSTIC
REPORT
(page 1 of 2)
Figure 5.3.1-a. Statistical Analysis System Flowchart
269
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 8
Release Date: 4/30/79
Update #: 24
ASTMSST (AQ0200)
STATISTICAL ANALYSIS PROGRAM
STATISTICS/
FILE
(Temporary) \
DIAGNOSTIC i
REPORT
OPTION CARD i
ARPMSST (AQ0270)
STATISTICAL REPORT PROGRAM
STATISTICAL ANALYSIS
REPORT
(page 2 of 2)
Figure 5.3.1-a - Continued. Statistical Analysis System Flowchart
270
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 9
Release Date: 4/30/79
Update #: 24
RETRIEVAL SPECIFICATIONS
SPECIFYING SLIDING OPTION
ARTLNGP (AQ0110)
RETRIEVAL LANGUAGE
PROCESSOR PROGRAM
/GENERATED RETRIEVAL/
PROGRAM SOURCE '
V MODULE \
COBOL COMPILE
AND LINK EDIT
MASTER
FILE
ARTGENR (AQ0120)
GENERATED RETRIEVAL
PROGRAM
T
SLIDING AVERAGE
ANSWER FILE
©
DIAGNOSTIC
REPORT
/RETRIEVAL SKELETON
PROGRAM
\ ARTSKEL (AQ0120) \
DIAGNOSTIC
REPORT
SLIDING AVERAGE
ANSWER FILE
LISTING (Optloj
(Page 1 of 2)
Figure 5.3.1-b, Sliding Average Flowchart
271
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.1
STATISTICAL ANALYSIS
INTRODUCTION
Page 10
Release Date: 4/30/79
Update #: 24
0
OPTION
CARD
ASTSLAV (AQ0180)
SLIDING AVERAGE
PROGRAM
/SLIDING AVERAGE
VALUES
V FILE
AQDHS-II /
PARAMETER i
FILE \
AQDHS-II
SITE
FILE
DIAGNOSTIC
REPORT
AQDHS-II
PARAMETER
STANDARDS
FILE
OPTION
CARD
r
ARPMSTR (AQ0230)
MASTER FILE DETAILED REPORT
PROGRAM
SLIDING
AVERAGE
REPORT
DIAGNOSTIC
REPORT
(Page 2 of 2)
Figure 5.3.1-b - Continued. Sliding Average Flowchart
272
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 1
Release Date: 4/30/79
Update #: 24
5.3.2 PRELIMINARY STATISTICS PROGRAM: ASTPRLM (AQ0190)
5.3.2.1 Description
ASTPRLM (AQ0190) is executed prior to the statistical analysis program,
ASTMSST (AQ0200), and the statistical report program, ARPMSST (AQ0270). In
most instances, ASTPRLM (AQ0190) will be executed after ASRMSTR (AQ0140).
ASTPRLM (AQ0190) reads the AQDHS-II master file, or any AQDHS-II answer file,
and an option card and converts the master/answer file to a FORTRAN-compatible
file. Preliminary statistical analyses are performed and two temporary
FORTRAN-compatible output files are passed to ASTMSST (AQ0200). A diagnostic
report which contains audit trail information is also provided for the users.
The statistics computed by ASTPRLM (AQ0190) are the maximum reading,
second maximum reading, third maximum reading, and minimum reading. Since
ASTPRLM (AQ0190) must process each reading in the input master/answer file and
convert it to a FORTRAN-compatible format, these statistics are computed by
ASTPRLM (AQ0190) to reduce the number of times a reading is processed and thus
reduce costs. The minimum detectable value, beginning and ending dates for
each set of data processed, and the average of the decimal point indicators
for all readings are included in each set. These statistics are passed to
ASTMSST (AQ0200) in the preliminary statistics file, which is one of the
temporary files passed to ASTMSST (AQ0200).
The readings from the input master or answer file are passed to ASTMSST
(AQ0200) in the raw data file, which is the other temporary file passed
to ASTMSST (AQ0200). ASTMSST (AQ0200) performs further statistical analyses
on these readings.
273
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 2
Release Date: 4/30/79
Update #: . 24
5.3.2.2 File Formats
Inputs to this program are an AQDHS-II master file or answer file, the
associated parameter file, and an option card. See Figure 4.5.3-a for the
master file format, Figure 4.2.2-c for the parameter file format, and Section
5.3.2.3 for a discussion of the option card.
Sorting of the input master or answer file prior to Its use by ASTPRLM
(AQ0190) 1s (1) required if either the Input master or answer file contains
data from more than one calendar year and the TOTAL option (refer to 5.3.^.3)
is specified or the Input answer file was produced by a batch retrieval, (2)
strongly recommended 1f the Input master or answer file contains data from
more than one calendar year and the MONTH, QUARTER, or YEAR option (refer to
5.3.2.3) is specified, and (3) unnecessary 1f the Input master or answer file
contains data from only one calendar year and 1s 1n the standard sequence.
The sorting can be accomplished by executing the master file sort program,
ASRMSTR (AQ0140), using the STAT option (see Section 5.6.2, Master File Sort
Program). The required order of the input master or answer file 1s shown 1n
Figure 5.6.2-e.
Output consists of a diagnostic report and two temporary files: a raw
data file and a preliminary statistics file. The diagnostic report contains
update messages, diagnostic messages, and summary statistics. An example of
the diagnostic report 1s shown in Figure 5.3.2-a. The raw data file and the
preliminary statistics file are FORTRAN-compatlble files that are passed to
ASTMSST (AQ0200). The raw data file contains the readings from the input
master or answer file. The preliminary statistics file contains the following
statistics for each set of data processed: maximum reading, second maximum
reading, third maximum reading, minimum reading, minimum detectable value,
beginning and ending dates of the readings, and the average of the decimal
point indicators for all readings.
274
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 3
Release Date: 4/30/79
Update #: 24
5.3.2.3 Options
The option card input to ASTPRLM (AQ0190) affects the execution of
ASTPRLM (AQ0190), ASTMSST (AQ0200), and ARPMSST (AQ0270) by specifying whether
the statistical analysis is done by month, by quarter, by year, or for the
total time period.
The data in the input master or answer file is grouped by site key and
parameter key. Under the TOTAL option, no further grouping of the data is
done and the statistical analysis for each site/parameter key combination
is performed based on all readings reported for that site/parameter key
combination.
If the MONTH, QUARTER, or YEAR option is specified, the data is further
grouped by month, quarter, or year, respectively, and a statistical analysis
is performed for each month, quarter, or year for each site/parameter key
combination. If the MONTH option is specified, all records containing
quarterly readings are bypassed.
The TOTAL option is specified by entering TOTAL on the option card. It
is the default option if either a blank option card or no option card is used.
The MONTH, QUARTER, and YEAR options are specified by entering the option
desired on the option card. If an invalid option is used, the execution of
ASTPRLM (AQ0190) will be aborted and no statistical analysis done. See Figure
5.3.2-b for the format of the option card.
5.3.2.4 Error Messages
ASTPRLM 001 ABORT - NO INPUT RECORDS
Meaning: The input master or answer file contains no records; therefore,
the run was terminated.
Action: Verify that the correct file was input.
275
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 4
Release Date: 4/30/79
Update #: 24
ASTPRLM 002 ABORT - INVALID OPTION CARD
Meaning: The option card is invalid; therefore, the run was terminated.
Action: Correct the option card and resubmit.
ASTPRLM 003 ABORT - NUMBER OF PARM FILE RECORDS EXCEEDS MAXIMUM ALLOWED
Meaning: ASTPRLM (AQ0190) has been incorrectly modified: the maximum
number of parameters specified in the program is larger than
the size of the parameter array; therefore, the run was
terminated.
Action: See Appendix C for instructions on correctly increasing the
size of the array.
ASTPRLM 004 ABORT - PARM ARRAY OVERFLOW
Meaning: The input parameter file contains more records than can be
stored in the parameter array; therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the size of the
array.
ASTPRLM 005 ABORT - NO MATCH FOUND ON PARAMETER FILE FOR PARAMETER KEY
xxxxxxxxx
Meaning: A parameter-feey of xxxxxxxxx was found in the input master or
answer file, but no matching parameter key was found in the
parameter file; therefore, the run was terminated.
Action: Determine which file is in error. The parameter file can be
corrected using ASRPARM (AQ0150) and AEMPARM (AQ0070). The
master file can be corrected using AEDMSTR (AQ0060), ASRINTR
(AQ0130), and AFMMSTR (AQ0100). Resubmit after the incorrect
file has been corrected.
276
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 5
Release Date: 4/30/79
Update #: 24
ASTPRLM 006 ABORT - INVALID TIME CODE ENCOUNTERED
(xxxxxxxxxxxxxxxxxxxxxxxxxxx)
Meaning: An invalid time code was found in the input master or answer
file, xxxxxxxxxxxxxxxxxxxxxxxxxxx is the state-AQCR-county-
area-site-agency-project-time-year-parameter-method-units codes
key. Therefore, the run was terminated.
Action: Correct the master or answer file using AEDMSTR (AQ0070),
ASRINTR (AQ0130), and AFMMSTR (AQ0100) and resubmit.
ASTPRLM 007 CONDITIONAL - x,xxx,xxx MASTER FILE RECORDS WITH QUARTERLY DATA
WERE BYPASSED
Meaning: This message is printed only when the MONTH option is in
effect. It informs the user of the number of master file
records that contained quarterly data and were therefore
bypassed.
Action: None
5.3.2.5 Cataloged JCL
ASTPRLM (AQ0190) should always be executed in conjunction with ASTMSST
(AQ0200) and ARPMSST (AQ0270). The cataloged procedure AQRPM10 executes all
three programs. This procedure is discussed in Section 6.4.2.5.
5.3.2.6 Warnings and Special Instructions
As released by NADB, execution of ASTPRLM (AQ0190) will be aborted if the
input AQDHS-II parameter file contains more than 200 records. If a parameter
file with more than 200 records is to be used, ASTPRLM (AQ0190) must be
modified in accordance with the instructions detailed in Appendix C.
277
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 6
Release Date: 4/30/79
Update #: 24
Sorting of the input master or answer file prior to use by ASTPRLM
(AQ0190) is (1) required if the input master or answer file contains data
from more than one calendar year and the TOTAL option (refer to 5.3.2.3) is
specified or if the input answer file was produced by a batch run, (2)
strongly recommended if the input master or answer file contains data from
more than one calendar year and the MONTH, QUARTER, or YEAR option (refer to
5.3.2.3) is specified, and (3) unnecessary if the input master or answer file
contains data from only one calendar year and is in the standard sequence.
The sorting can be accomplished by executing the master file sort program,
ASRMSTR (AQ0140), using the STAT option (see Section 5.6.2, Master File Sort
Program). The required order of the input master or answer file is shown in
Figure 5.6.2-e.
5.3.2.7 Cost Considerations
The following estimates are for the execution of ASTPRLM (AQ0190) on an
IBM 370/168:
Size of AQDHS-II master file: 198 records
Size of output preliminary statistics file: 122 records
Size of output raw data file: 308 records
CPU time: 1.4 seconds
I/O time: 6.8 seconds
Total time: 8.2 seconds
Estimated cost: $2.16
5.3.2.8 Related Programs and Procedures
ASTPRLM (AQ0190) should always be executed in conjunction with ASTMSST
(AQ0200) and ARPMSST (AQ0270). The cataloged procedure AQRPM10 executes all
three programs (see Section 6.4.2.5).
278
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 7
Release Date: 4/30/79
Update #: . 24
5.3.2.8 Related Programs and Procedures
ASTPRLM (AQ0190) should always be executed in conjunction with ASTMSST
(AQ0200) and ARPMSST (AQ0270). The cataloged procedure AQRPM10 executes all
three programs (see Section 6.4.2.5).
The cataloged procedure AQSRM10 can be used to execute ASRMSTR (AQ0140)
whenever ASTPRLM (AQ0190) requires a sorted input master or answer file (see
Section 5.6.2).
279
-------
AQDHS-II PRELIMINARY STATISTICS PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME! ASTPRLM (AQ0190)
REVISION LEVELl 1-00
LAST UPOA1E *J 2«
INCURPORATEDl OCTOBER 31, 1978
OPTION IN EFFECT: TOTAL
NUMBER OF MASTER FILE RECORDS READ:
NUMBER OF MASTER FILE RECORDS WITH COMPOSITE DATA:
NUMBER OF STATISTICS RAW DATA FILE RECORDS WRITTEN:
NUMBER OF PRELIMINARY STATISTICS FILE RECORDS WRITTEN:
NUMBER OF DIAGNOSTIC MESSAGES!
6
0
10
5
0
ro
CO
o
Figure 5.3.2-a. Diagnostic Report
3 O >
5 3> JO
Z —I O
>-> > rc
-o co
<=. > :
r~ o i—i
> O «-H
-H m
i—i oo
O co
en
3» ~O CO
co TO m
—( m o
V£>
o >
CO
o
CO
-< CO
•
co ro
•u
D.
n>
=»=
ro
-Pi
73
n>
m
Q)
CU
co
o
•—I
IO
o>
CO
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.2
PRELIMINARY STATISTICS
ASTPRLM (AQ0190)
Page 9
Release Date: 4/30/79
Update #: 24
Column
#1
[OPTION]
1. The specified option must begin in column 1.
2. There can be no spaces between the letters of the option word.
3. The only valid option words are TOTAL, MONTH, QUARTER, and YEAR,
Figure 5.3.2-b. Option Card Format
281
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.3
STATISTICAL ANALYSIS
PROGRAM ASTMSST (AQ0200)
Page 1
Release Date: 4/30/79
Update #: 24
5.3.3 STATISTICAL ANALYSIS PROGRAM - ASTMSST (AQ0200)
5.3.3.1 Description
ASTMSST (AQ0200) is executed after the preliminary statistics program,
ASTPRLM (AQ0190), and before the statistical report program, ARPMSST (AQ0270).
ASTMSST (AQ0200) reads two temporary files produced by ASTPRLM (AQ0190),
performs statistical analyses, and produces a temporary file which is passed
to ARPMSST (AQ0270). ASTMSST (AQ0200) is coded in ANS FORTRAN.
ASTMSST (AQ0200) operates under the option specified on the option card
read by ASTPRLM (AQ0190). That option determines whether the statistical
analysis report printed by ARPMSST (AQ0270) will be a monthly, quarterly,
yearly or total time period report. Refer to Section 5.3.3.3 for a discussion
of these options.
The two input files are a preliminary statistics file which contains the
results of the statistical analyses performed by ASTPRLM (AQ0190) and a raw
data file which contains the non-null readings from the master or answer file
.read by ASTPRLM (AQ0190). The data on the raw data file has been grouped by
site and parameter key and, if appropriate for the option in effect, by month,
quarter, or year. For each group of data, the following statistics are
computed: percent of possible observations (readings) recorded for the time
period; number of observations; 10th, 30th, 50th, 70th, 90th, 95th, and 99th
percentiles; arithmetic mean; arithmetic standard deviation, geometric mean;
and geometric standard deviation. The following formulas are used to compute
the means and standard deviations (X-j is an observation, n is the number of
observations):
282
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.3
STATISTICAL ANALYSIS
PROGRAM ASTMSST (AQ0200)
Page 2
Release Date: 4/30/79
Update #: 24
Arithmetic mean:
X =
+ X2 + ... + Xn
Arithmetic standard deviation:
2>i
1=1
n - 1
1/2
X2
X2+... + Xn )2
n - 1
283
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.3
STATISTICAL ANALYSIS
PROGRAM ASTMSST (AQ0200)
Page 3
Release Date: 4/30/79
Update #: 24
Geometric mean:
1-1
Xn « e
In X + In X + ... + In X
n
n
= e
Geometric standard deviation:
n-1
1/2
\
In the computation of the geometric mean and geometric standard deviation,
half of the minimum detectable observation is substituted for all observations
that are less than the minimum detectable value. (The number of times this
substitution is done is printed in the statistical analysis report.) This
technique is the same technique used in the SAROAD statistical analysis
program. Since the natural logarithm function cannot be applied to
284
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.3
STATISTICAL ANALYSIS
PROGRAM ASTMSST (AQ0200)
Page 4
Release Date: 4/30/79
Update #:• 24
non-positive values, the geometric mean and geometric standard deviation are
only computed if all readings in the group of data being analyzed are positive
or if the minimum detectable value is positive.
5.3.2.2 File Formats
Input to this program consists of two temporary files passed from ASTPRLM
(AQ0190): the preliminary statistics file and the raw data file. See Section
5.3.2.2 for additional information on these files.
Output consists of a diagnostic report (see Figure 5.3.3-a) and a
temporary file passed to ARPMSST (AQ0270). This temporary file is referred to
as a statistics file; it contains the statistics computed by ASTPRLM (AQ0190)
and ASTMSST (AQ0200).
5.3.3.3 Options
ASTMSST (AQ0200) operates under the option specified on the option card
read by ASTPRLM (AQ0190). Refer to Section 5.3.2.3 for a detailed discussion
of this option card.
5.3.2.4 Error Messages
ASTMSST 001 DISASTER - NO HEADER RECORD ON INPUT STATISTICS FILE
Meaning: The preliminary statistics file has no header record;
therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for further
assistance.
285
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.3
STATISTICAL ANALYSIS
PROGRAM ASTMSST (AQ0200)
Page 5
Release Date: 4/30/79
Update #: 24
ASTMSST 002 DISASTER - NO HEADER RECORD ON INPUT DATA FILE
Meaning: The raw data file has no header record; therefore the run was
terminated.
Action: Contact personnel at the National Air Data Branch for further
assistance.
ASTMSST 003 ABORT - NO DATA ON INPUT STATISTICS FILE
Meaning: The preliminary statistics file contains only a header record
and a trailer record, therefore, the run was terminated.
Action: Insure that the correct AQDHS-II master or answer file was
input to ASTPRLM (AQ0190); rerun ASTPRLM (AQ0190).
ASTMSST 004 ABORT - NO DATA ON INPUT DATA FILE
Meaning: The raw data file contains only a header record and a trailer
record; therefore, the run was terminated.
Action: Insure that the correct AQDHS-II master or answer file was
input to ASTPRLM (AQ0190); rerun ASTPRLM (AQ0190).
ASTMSST 005 DISASTER - INPUT STATISTICS AND DATA FILES DO NOT CORRESPOND
Meaning: The key information on the preliminary statistics and raw data
files do not match; therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for further
assistance.
ASTMSST 006 DISASTER - INVALID AVERAGE DEC PT IND, KEY INFO IS
XXXXXXXXXXXXXXXXXXXXXX-YYYYYYY
Meaning: The preliminary statistics file contains an invalid average
decimal point indicator; therefore, the run was terminated.
XXXXXXXXXXXXXXXXXXXX is the state, AQCR, county, area, site,
286
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.3
STATISTICAL ANALYSIS
PROGRAM ASTMSST (AQ0200)
Page 6
Release Date: 4/30/79
Update #: 24
agency, project, and time code key and YYYYYYYYY is the
parameter, method, and units code key of the erroneous record.
Action: Contact personnel at the National Air Data Branch for further
assistance.
ASTMSST 007 DISASTER - INPUT STATISTICS FILE TERMINATED BEFORE INPUT
DATA FILE
Meaning: The preliminary statistics file terminated before the raw data
file; therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for further
assistance.
ASTMSST 008 DISASTER - INPUT DATA FILE TERMINATED BEFORE INPUT
STATISTICS FILE
Meaning: The raw data file terminated before the preliminary statistics
file; therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for further
assistance.
5.3.3.5 Cataloged JCL
ASTMSST (AQ0200) should always be executed in conjunction with ASTPRLM
(AQ0190) and ARPMSST (AQ0270). The cataloged procedure AQRPM10 will executes
all three programs. This procedure is discussed in Section 6.4.2.5.
5.3.3.6 Warnings and Special Instructions
There are no warnings and no special instructions.
287
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.3
STATISTICAL ANALYSIS
PROGRAM ASTMSST (AQ0200)
Page 7
Release Date: 4/30/79
Update #: 24
5.3.3.7 Cost Considerations
The following estimates are for the execution of a test run of ASTMSST
(AQ0200) on an IBM 370/168:
Size of input data file: 308 records
Size of input preliminary statistics file: 122 records
Size of output statistics file: 360 records
CPU time: 2.0 seconds
I/O time: 5.3 seconds
Total time: 7.3 seconds
Estimated cost: $3.09
5.3.3.8 Related Programs and Procedures
ASTMSST (AQ0200) is always executed in conjunction with ASTPRLM (AQ0190J
and ARPMSST (AQ0270). The cataloged procedure AQRPM10 executes all three
programs.
288
-------
AQOH3-I1 STATISTICAL. ANALYSIS PROGRAM - DIAGNOSTIC REPORT
PAGE I
PROGRAM NAMEt ASTMSST (AQOZOO)
REVISION LEVELJ 1-00
LAST UPDATE »i ZH
DATE INCORPORATED! OCTUBFR 31, 1978
NUMBER OF STATISTICS RAM DATA FILE RECORDS READ!
NUMBER OF PRELIMINARY STATISTICS FILE RECORDS READ:
NUMBER UF STATISTICS FILE RECORDS MRITTENl
36
6
12
V£>
Figure 5.5.3-a. Diagnostic Report
3: o
—• >
-
o
x
co
3>
o i-i
o •->
i-i 00
o oo
-o co co
zo —I m
o
o
en
co
co
co
co o
-H Z
t-H
o en
i— co
•
*> co
3> co
-O !-•
o co
ro
o
o
C 3D -O
"O O> O>
f^ «^ 11^
O> oo
=«»=
ro
co
o
VO
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 1
Release Date: 4/30/79
Update #: . 24
5.3.4 SLIDING AVERAGE PROGRAM - ASTSLAV (AQ0180)
5.3.4.1 Description
The sliding average program, ASTSLAV (AQ0180), is used to calculate
values for a sliding average report; it does not, however, duplicate the
sliding average reports in SAROAD. The file input to ASTSLAV (AQ0180) must be
a sliding average answer file created by a SLIDING mode retrieval (see Section
5.2.2.2). The records on the sliding average answer file have been changed to
indicate that they are sliding average records; in addition, there are extra
records in the file to provide a wraparound capability (such as at the
beginning of a year, month, or day that has been retrieved). An option card
is also input to ASTSLAV (AQ0180) to indicate the size of the sliding average
Interval (see Section 5.3.4.3).
The file output by ASTSLAV (AQ0180) contains sliding average values
as calculated by the program. This file must be Input to ARPMSTR (AQ0230),
the master file detailed report program, to produce the sliding average
report.
The formula used for the sliding average computation is:
J-1
S1 = -1
m j=i - m + 1
where:
Si = the ith sliding average
m = the interval over which the average is computed
R = the value of the reading
j = index to the position of R in the series of readings.
290
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 2
Release Date: 4/30/79
Update #: 24
The nth sliding average in the output file is the average of the nth reading
in the input file and the (m-1) preceding readings in the input file. All
reading positions in the output file will contain a computed sliding average
value, provided a sufficient number of readings were contained in the master
file. If a sliding average for a reading cannot be computed due to
insufficient data, the corresponding output position is set to (9998) which
causes *** to be printed in that position by the master file detailed report
program, ARPMSTR (AQ0230). The actual number of readings required to
calculate the sliding average is determined by the interval for computation
specified by the user on the option card. The interval selected by the user
A of £ ou/o. / -fro
must be less than the maximum number of readings that can be contained in a
master file record. Thus the maximum interval size will depend upon the type
of data as specified by the time code (see Section 5.3.4.3).
ASTSLAV (AQ0180) computes sliding average values for all data that is
entered into the program; therefore, the user should retrieve the particular
data for which he needs a sliding average file and should then execute ASTSLAV
(AQ0180) on that answer file rather than on the entire master file. For
example, if the user wants to see a report of three-hourly averages for hourly
data of TSP (total suspended particulates) , he should retrieve that data
prior to executing ASTSLAV (AQ0180). Should he retrieve all TSP data and not
specify only hourly TSP data to be retrieved, the report will show averages
for the user specified interval regardless of time code of the raw data. If
the master file is large, a much larger (and more expensive) report than
desired could be produced unless the user first makes a judicious retrieval.
The following example illustrates the calculations performed by ASTSLAV
(AQ0180), the wraparound technique, and the minimum number of readings
required, as well as proper use of the retrieval for sliding average.
Suppose a three-hourly average of SOg data (parameter 42401) for 1979 is
needed. First, a retrieval is run to select hourly data for parameter 42401
291
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 3
Release Date: 4/30/79
Update #: 24
and year 1979. The retrieval specifications (as defined in Section 5.2.2) are
as follows:
$$SELECT SLIDING
YEAR = '79' AND
PARAMETER-CODE = '42401' AND
TIME-CODE = '!'
$$END
Five records satisfied the retrieval criteria; these records are for the days
January 1, 2, 31 and February 1, 3. In addition to these records, special
wraparound records were generated (with null-value readings) for January 30,
1979 and February 2, 1979. Also the record for December 31, 1978 (which does
not meet the retrieval criteria) was retrieved and flagged as a wraparound
record. The readings for the retrieved records are shown in Figure 5.3.4-a.
The generated wraparound records are not shown.
Next, program ASTSLAV (AQ0180) is run; an Interval of three is specified
on the option card. The first record in the input sliding average answer file
is December 31, 1978; this is a wraparound record and is held for use in
computing sliding average values for January 1, 1979.
Using the specified interval of 3, the first sliding average value (for
hour 0) is computed using hours 22 and 23 from December 31 and hour 0 from
January 1. All three values are 0; thus, the resulting sliding average value
is 0. The second sliding average value uses hour 23 from December 31 (reading
0), plus the first two readings from January 1, (readings 0 and .1). The sum
of these readings is .1; this is divided by 3 (the interval size), giving
.0333 as the computed sliding average value for hour 1. The sliding average
program computes the proper decimal code to allow for four significant digits
to be output and the computed sliding average value is rounded to four
significant digits. Sliding average values are calculated in this manner for
the remaining hours of January 1; for hour 14, January 1, the readings for
292
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 4
Release Date: 4/30/79
Update #: 24
hours 12, 13, and 14 (.6, .8, and .4), give a sum of 1.8, yielding a sliding
average value of .6.
For hour 0 of January 2, hours 22 and 23 of January 1 and hour 0 of
January 2 are used. Since all three readings are 0, the calculated sliding
average value 1s 0. The readings contain null values (shown as - on the
figure) for hours 3 thru 8 of January 2. Since at least two readings must be
non-null to calculate a three-Interval average, there are not enough readings
to calculate a value for hour 4 (hours 2, 3, and 4 are needed, only 2 1s
non-null). Hour 9 average requires hours 7, 8, and 9, but only 9 1s non-null.
(For hours 5, 6, 7, and 8 all required readings are missing.) These
noncalculable values are shown 1n Figure 5.3.4-b as *; the actual reading 1n
the output file 1s 9998 and will be printed as *** 1n the detailed report.
i
For the first hour (0) of January 31, the last two readings from the
record for January 30 must be used. January 30 was a wraparound record
created by the retrieval and contains only null-value readings (as there was
no such record on the master file). Thus no value can be calculated for hour
0, since two of the necessary values are null. For hour 1, hour 23 of January
30 (a null reading) plus hours 0 and 1 of January 31 (.5 and .5) are used,
giving a sum of 1.0 and a sliding average value of .3333.
Figure 5.3.4-b shows the sliding average values as output by ASTSLAV
(AQ0180), with the exception that 9998 is output in the file where * is shown
on the figure.
5.3.4.2 File Formats
Two files are input to ASTSLAV (AQ0180): an AQDHS-II sliding average
answer file and an option card. The sliding average answer file must be
created by the retrieval procedure using the SLIDING mode (see Section
293
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 5
Release Date: 4/30/79
Update #: 24
5.2.2.2). The format of this file is the same as that of the standard
AQDHS-II master file (see Figure 4.5.3-a).
The option card is used to specify the sliding average interval; for
additional information on the options, see Section 5.3.4.3.
The program produces two output files: a sliding average values file and
a diagnostic report. The sliding average values file is in the same format as
the standard AQDHS-II master file (see Figure 4.5.3-a); it is used by ARPMSTR
(AQ0230), the master file detailed report program, to produce the sliding
average report. The diagnostic report produced by ASTSLAV (AQ0180) gives run
statistics including numbers of input records, output records, and errors.
See Figure 5.3.4-c for a sample of this report.
5.3.4.3 Options
An option card must be entered to specify the sliding average interval.
The format of this option card is shown in Figure 5.3.4-d. The word AVERAGE
is required on the card, followed by a number from 2 to 31. This number
indicates the interval (m, or number of readings) for which the sliding
average value is to be calculated. As an example, suppose the interval value
is three: to calculate a sliding average value, the corresponding input
reading plus the previous two input readings (a total of three) are used.
Further information on interval size can be found in Section 5.3.4.1.
To calculate the sliding average value for reading n over interval m does
not require that all m-1 preceding readings be present in the input file.
Column 21 of the option card allows the user to select whether 75% of the
m readings (code S) or (m + l)/2 readings (code A) are required. If neither
option for the required number of readings is specified, or if an invalid
294
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 6
Release Date: 4/30/79
Update #: 24
value is entered, the default value A is assumed. Figure 5.3.4-e lists, by
interval number, the number of readings required for each of these options.
All records read by ASTSLAV (AQ0180) are processed for sliding average
values; however, a check is made on the time code of each record to determine
if the interval number specified on the option card is greater than the
maximum interval size for that time code. A chart of maximum interval size
for each time code is shown in Figure 5.3.4-f.
5.3.4.4 Error Messages
ASTSLAV 001 ABORT - ANSWER FILE IS NOT A SLIDING AVERAGE FILE
Meaning: ASTSLAV (AQ0180) can only process a sliding average answer file
produced by a SLIDING mode retrieval procedure (see Section
5.2.2.2). Therefore, the run was terminated.
Action: Insure that the input file has been created by the retrieval
procedure using the SLIDING option on the $$SELECT card and
resubmlt the job.
ASTSLAV 002 ABORT - CONTROL CARD MISSING
Meaning: The option card must be included to specify the interval size.
The run was terminated.
Action: Input the option card and resubmlt the job.
ASTSLAV 003 ABORT - NON-NUMERIC INTERVAL ON CONTROL CARD
Meaning: The interval specified on the option card must be numeric, and
must be between the values 2 and 31, inclusive. The run was
terminated.
Action: Correct the control card and resubmit the job.
295
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 7
Release Date: 4/30/79
Update #: 24
ASTSLAV 004 ABORT - INTERVAL SPECIFIED LESS THAN 2 OR GREATER THAN 31
Meaning: The interval specified on the option card must not be less than
2 or greater than 31. The run was terminated.
Action: Correct the option card and resubmit the job.
ASTSLAV 005 ABORT - SLIDING AVERAGE RECORD REQUIRED
Meaning: The program has found an input record that is not a sliding
average record. This can happen if a standard answer file has
been concatenated to a sliding average answer file. The run
was terminated.
Action: Insure that the input file contains only sliding average file
records and resubmit the job.
ASTSLAV 006 ABORT - SLIDING AVERAGE ANSWER FILE CONTAINS NO DATA
Meaning: There were no records in the input file; therefore, the run was
terminated. This could have happened because the retrieval
specifications were too restrictive and no records were
selected; also, the retrieval may have been terminated prior to
writing the answer file, £r because of an error in the
retrieval procedure.
Action: Examine the retrieval specifications and resubmit both the
retrieval and sliding average procedures.
ASTSLAV 007 ABORT - SLIDING AVERAGE STATEMENT INVALID OR MISSING
Meaning: The statement identifier AVERAGE is misspelled or missing;
therefore, the run was terminated.
Action: Correct the control card and resubmit the job.
ASTSLAV 008 ABORT - SYNTAX REQUIRES NUMERIC PARAMETER BETWEEN 2 AND 31
Meaning: An invalid interval was specified; therefore, the run was
terminated.
Action: Correct the option card and resubmit the job.
296
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 8
Release Date: 4/30/79
Update #: . 24
ASTSLAV 009 CONDITIONAL - INTERVAL SPECIFIED EXCEEDS MAX READINGS - SKIPPING
TO NEXT SAMPLE
Meaning: The interval specified exceeds the maximum allowed for the time
code. No sliding average values are computed until a record is
encountered which has a different Key I/Key 2 combination. See
Figure 5.3.4-f for allowed interval sizes by time code.
Action: If a sliding average is required for the record in question^rwr,
a smaller interval must be specified. For a small answer file,
the option card should be changed and the job rerun. For a
large answer file, rerun the retrieval, selecting only the
skipped records, and then run the sliding average program (with
the changed option card) on that answer file.
ASTSLAV 010 CONDITIONAL - OPTION FOR NUMBER OF READINGS REQUIRED INVALID - 50%
USED
Meaning: An invalid value has been specified for the required number of
readings; therefore, ASTSLAV (AQ0180) was executed using the
default value A.
Action: No action is needed unless the SAROAD value of 75% is required;
if so, correct the option card and resubmit the job.
5.3.4.5 Cataloged JCL
5.3.4.5.1 JCL listing - The cataloged procedure AQSTM20 executes the sliding
average program ASTSLAV (AQ0180). See Figure 5.3.4-g for a listing of this
procedure.
5.3.4.5.2 Cross-reference of DP names and files
Program Name: ASTSLAV (AQ0180)
297
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 9
Release Date: 4/30/79
Update #: 24
DP Name File Description Input/Output
AQSINPUT Option card Input
AQSMASTR AQDHS-II sliding average answer file Input
AQSVALUE Sliding average values file Output
AQSPRINT Diagnostic report Output
5.3.4.5.3 User-supplied JCL - To execute the cataloged procedure AQSTM20, the
user can expect to supply job accounting information and names of the input
sliding average answer file and the output sliding average values file. An
option card is required to specify the interval number. See Figure 5.3.4-h
for a description of the substitutable parameters for the procedure.
5.3.4.5.4 Sample run stream -The following run stream is from the AQDHS-II
baseline test run series. A sliding average answer file 'CN.EPALMH.A087.CDHS.
HQ.AQS.DATA.RTANSR421 is input along with an option card specifying an
interval of 3 and a default to "A" for the required number of readings. The
sliding average values file produced is 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
ITSLDA431.
// EXEC AQSTM20,
// MSTRFIL=RTANSR42,
// ANSWRFL-ITSLDA43
// AVERAGE,INPUT DD *
AVERAGE 3
/*
The diagnostic rtport resulting from this run is shown in Figure 5.3.4-c.
Costs of this run are shown 1n Section S.3.4,7.
398
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 10
Release Date: 4/30/79
Update #: 24
5.3.4.6 Warnings and Special Instructions
A sliding average retrieval must be run prior to running ASTSLAV
(AQ0180). It is recommended that this retrieval be as specific as possible so
that only the desired records are retrieved, thus keeping the cost of running
ASTSLAV (AQ0180) down. The master file detailed report program ARPMSTR
(AQ0230) must be run after ASTSLAV (AQ0180) to actually print the sliding
average report. A specific retrieval will also reduce the quantity of output
from ARPMSTR (AQ0230). See Section 7.2.6 for a detailed example showing
retrieval, sliding average calculation, and report. Note that the sliding
average value file should only be used as input to ARPMSTR (AQ0230); it should
not be input to any other program.
The option card indicating the desired averaging interval is required.
Insure that this interval number is valid for the time-code of the data on the
input file (see Figure 5.3.4-f).
A minimum number of readings in a specified interval is required to
compute the sliding average. The value of this minimum is determined by the
option card (see Section 5.3.4.3).
5.3.4.7 Cost Considerations
The following estimates reflect the cost of executing the sample run
stream in Section 5.3.4.5.4 on an IBM 370/168:
Number of input records: 110 records
Number of output records: 55 records
CPU time: 2.0 seconds
I/O time: 5.3 seconds
Total time: 7.3 seconds
Estimated cost: $2.30
299
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 11
Release Date: 4/30/79
Update #: 24
The cost of running the sliding average program and a subsequent sliding
average detailed report can be greatly reduced by making the required Initial
retrieval as restrictive as possible. Thus, 1f you are only Interested 1n
seeing a sliding average report for SOg three-hourly data for January 1979,
make all of those requirements part of the retrieval specifications. (See
Section 5.3.4.1 for an example of retrieving January 1979 hourly SOg data.)
5.3.4.8 Related Programs and Procedures
The retrieval programs ARTLNGP (AQ0110) and ARTGENR (AQ0120) must be run
prior to running ASTSLAV (AQ0180). These retrieval programs may be executed
using the cataloged procedure AQRTM10 (see Section 5.7) or the cataloged
procedures AQRTM20 and AQRTM30 (see Section 5.2). After executing ASTSLAV
(AQ0180), the master file detailed report program, ARPMSTR (AQ0230), should be
run to print the sliding average report. Details on procedure AQRPM20, which
executes ARPMSTR (AQ0230) can be found 1n Section 6.2.3.5.
300
-------
CO
o
HOUR
1979
Ian. 1
2
31
Feb. 1
3
0
0
0
.5
.7
0
1
.1
0
.5
.7
0
2
0
0
.6
.6
0
3
0
-
.7
.5
0
4
0
-
.7
.4
0
5
0
-
.6
.4
0
6
0
-
.6
.4
0
7
0
-
.6
.7
0
8
0
-
.8
.9
-
9
.1
.5
1.1
1.0
-
10
.4
.6
1.1
1.1
-
11
.4
.7
1.3
1.2
-
12
.6
.7
1.3
1.4
-
13
.8
.8
1.3
1.3
0
14
.4
1.0
1.4
1.2
0
15
.4
1.1
1.2
1.2
.2
16
.5
1.0
1.1
.8
.4
17
.5
1.1
1.1
.7
.4
18
.2
1.0
.9
.7
.6
19
.1
1.1
1.0
.7
.6
20
0
.9
.9
.7
.7
21
0
.8
.8
.7
.3
22
0
.8
.8
.8
0
23
0
.7
.7
.7
0
- Indicates the value Is null (9999)
Figure 5.3.4-a. Example input - Sliding Average Answer Records
3 O
-v co
<=. 3> I
l~ O «-i
I» O •-•
—I m
1-1 co
O co
f* CO CO
co i— m
— I •— « o
co o — t
— . •&• en
j> < •
jo m co
o 30 •
(-• Ja -P»
00 CD
CD m
o
o
•ya
•o to o>
o. "-1 tn
o> ID n
rt- fu
m v» •-•
m ro
=«=
.. o
ft
ro CD
CO
o
-------
2 O >
^ > s
: > i
i— • c~) i—i
• o i—i
< m
l-H CO
O co
CO
o
ro
1979
Jan. 1
2
31
Feb. 1
3
HOIK
0
0
0
*
.7333
t
1
0333
0
3333
.7
0
2
0
0
.5333
.6667
0
3
0
0
.6
.6
0
4
0
6667
.5
0
5
0
.6667
.4667
0
6
0
.6333
.4
0
7
0
.6
.5
0
8
0
.6667
,6667
0
9
.0333
.8333
.8667
10
.1667
.3667
1.0
1.0
11
.3
.6
1.167
1.167
12
.3333
.6667
1.233
1.2
13
.6
.7333
1.3
1.3
14
.6
.8333
1.333
1.333
0
15
.5333
.9667
1.3
1.3
.0667
16
.4333
1.033
1.233
1.233
.2
17
.4667
1.033
1.133
1.133
.2667
18
.4
1.067
1.033
1.033
.4667
19
.2667
1.0
1.0
1.0
.5333
20
.1
1.0
.9667
.9333
.6333
21
.0333
9333
.9
.9
.5333
22
0
.8333
.8333
.8333
.3333
23
0
.7667
.7333
.7667
.1
* Indicates that the sliding average cannot be calculated (9998)
> co co
co i— m
—I •—i o
co o —I
•^ 3=« en
jO m co
o 20 •
CO O
o m
-a
o
70
d 70 -*3
•o (0 tu
a. —« «a
c* o>
n> co
CU
ro
Figure 5.3.4-b. Example Output - Sliding Average Value Records
co
o
VO
-------
o
to
AOOHS-II SLIDING AVERAGE PROGRAM - DIAGNOSTIC REPORT
PAGE
INA.HC3 ASfSLAV (AQ0180)
IU.VEL: i-oo
*: z«
D*It IIHt'ORraRAfEros HJCTOBER 31, 1*76
OPTIONS IT] (EFFiCT! AVERAGE 3
o «-«
o •-<
i— i oo
O co
CD
OF SLIDJWE AVERAGE ANSWER RECORDS READ:
IOF SLIDING AVERASE VALUE RECORDS HRITIENt
WUMBEK !»' tiRSfOBS OEItCftO:
167
157
0
co
— i
co
i—
3>
co oo
r— m
•-! o
CD
en
.o m co
o ?o •
t-> 3> -P>
00 O
o m
73
o
Figure 5.3.4-c. Diagnostic Report
73
n>
o.
01
CO
o
to
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 15
Release Date: 4/30/79
Update #: . 24
Column
#1
Column
#9
_V
Column
#21
AVERAGE
XX
The options must be specified in the indicated fields, subject to the
following rules:
1. XX must be a number (m) between 2 and 31 specifying the interval over
which the average is computed.
2. Y specifies the minimum number of readings required. The valid
values for Y are:
S - Use the SAROAD value of 75% of readings required,
A - Use the AQDHS-II value of (m + l)/2 readings required where
m is the interval size specified in columns 9 and 10.
Figure 5.3.4-d. Option Card Format
304
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 16
Release Date: 4/30/79
Update #: 24
Interval
Required # of Readings
AQDHS-II Option
SAROAD Option
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
2
3
3
4
4
5
5
6
6
7
7
8
8
9
9
10
10
11
11
12
12
1
2
3
3
4
5
6
6
7
8
9
9
10
11
12
12
13
14
15
15
16
17
(Page 1 of 2)
Figure 5.3.4-e. Required Number of Readings for Interval Size
305
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 17
Release Date: 4/30/79
Update #: 24
Interval
Required # of Readings
24
25
26
27
28
29
30
31
AQDHS-II Option
13
13
14
14
15
15
15
16
SAROAD Option
18
18
19
20
21
21
22
23
Figure i.3t4-e
2 of 2)
Contlnuedt Required Number of Readings for Interval S1ie
306
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 18
Release Date: 4/30/79
Update #: 24
AQDHS-II Time Code
Time Interval
Maximum Interval Size
1
2
3
4
5
6
7
8
9
A
B
C
1 hour
2 hour
3 hour
4 hour
6 hour
8 hour
12 hour
Dai ly
Weekly
Monthly
Quarterly
Composite
24
12
8
6
4
3
2
28,29,30, or 31 depending on month
5
12
4
Not applicable
Figure 5.3.4-f. Maximum Interval Size By Time Code
307
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 19
Release Date: 4/30/79
Update I: 24
//*
//*
PROCEDURE NAME! AQSTM20
REVISION LEVELJ 1-00
LAST UPDATE HI 24
DATE INCORPUKATEDI OCTOBER 31,1976
THIS PROCEDURE ALLOWS THE USER TO PRODUCE AN AQDHS-II SLIDING
AVtKAGE VALUES FILE FROM AN AQDHS-II SLIDING AVERAGE ANSWER
FILE
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQSTM20 PHOC PROJECTo'CN.EPALMH.A067.CDHS.HQ.AOS',
// PROGRAMtASTSLAV,
// fIMElB'3,0',
// ANSRFILsAGANSSLD,
// VALUFILBAOMSTSLO,
// UNIT»3330,
// StRlAL«CDHSPK,
// OISPa'NEW,PASS,DELETE',
// SPCUNITaTRK,
// PRIMARY»20,
// SECNDRYslO,
// OUT»A
//*
//AVERAGE EXEC fGMs&PROGRAM,
// RF.GIONB60K,
// TIMEs(&TIM£l)
//*
//* COMPUTE SLIDING AVERAGE VALUES FILE FROM
//* SLIDING AVERAGE ANSWER FILE
//*
//STEPLIB DD DSNAMEs»PROJECT,,LOAD,
// VOLUME=(PRIVATF.,RETAIN),
// DISP»(SHH,PASS)
// DD DSNAMEsSYSl.COBLIB,
// DISPB(SMR,PA3S)
//*
//* INPUT DATA SET - SLIDING AVERAGE CALCULATION OPTIONS
//*
//AQSINPUT DD DDNAMLoOPTIONS,
// DCO=BLK3IZE»80
//*
//* INPUT DATA SET - SLIDING AVERAGE ANSWER FILE
//*
//AQSMASTR DD DSNAMEs&PROJECT,.DATA.&ANSRFIL,
// DISPe(SHR,PASS),
// VOLUMEs(PRIVATE,RETAIN)
//*
//* OUTPUT DATA SET - SLIDING AVERAGE VALUES FILE
//*
//AQ3VALUE DD DI3P = UDISP),
// VOLUMt.s (PRIVATE,RETAIN, 3ERHSERIAL),
// UNITsRUNIT,
// SPACto(HSPCUNIT,(iPRIMARY,iSECNDRY),RL8E),
I)3NAMCB&PK(|JECT,.DATA,IIVALUFIL
//*
//* OUTPUT DATA SET
DIAGNOSTIC MESSAGES
00000100
00000200
00000300
00000400
00000500
00000600
00000700
00000600
00000900
00001000
oooonoo
00001200
00001300
00001400
00001SOO
00001600
00001700
ooooiaoo
00001900
00002000
00002100
00002200
00002300
00002400
00002SOO
00002600
00002700
00002HOO
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
OOOOJflOO
00003900
00004000
00004100
00004200
00004300
00004400
00004SOO
00004600
00004700
00004600
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005600
(Page 1 of 2)
Figure 5.3.4-g. Cataloged Procedure AQSTM20
308
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 20
Release Date: 4/30/79
Update f: 24
//AfJSPRINT DD SYSOUTe&OUT
//*
//• OUTPUT DATA SE1S • SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUT'&OUT
//*
//SY30UT DO SYSOUTi&OUT
//*
/V3YSDHOUT OD SY30UT»iOUT
//*
//SY3DTERM DO 3Y30UT«40UT
//*
//SYSUDUMP DD SYSOUT«&OUT
//*
OOOObPOO
00006000
00006100
00006200
00006300
00006400
00006SOO
00006600
00006700
00006600
00006900
00007000
00007100
00007ZOO
00007300
(Page 2 of 2)
Figure 5.3.4-g - continued. Cataloged Procedure AQSTM20
309
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.3.4
SLIDING AVERAGE PROGRAM
ASTSLAV (AQ0180)
Page 21
Release Date: 4/30/79
Update #: . 24
Parameter
Name
PROJECT
Default
Value
Description
DISP
SPCUNIT
PRIMARY
SECNDRY
OUT
'CN.EPALMH.A087.
CDHS.HQ.AQS"
PROGRAM
TIME1
MSTRFIL
ANSWRFL
UNIT
SERIAL
ASTSLAV
•3.0'
AQANSSLD
AQMSTSLD
3330
CDHSPK
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.RTANSRAA would
be the full data set name of an AQDHS-II answer
file)
Sliding average program
Time (in minutes, seconds) allocated for
execution of ASTSLAV
Lowest-level index of sliding average answer
file
Lowest-level index of sliding average values
file
Unit type to which output sliding average
values file is to be written
Volume serial ID to which sliding average
values file is to be written
'NEW, PASS, DELETE1 Disposition of sliding average values file
TRK Units in which space is to be allocated for the
sliding average values file
20 Primary space allocation for sliding average
values file
10 Secondary space allocation for sliding average
values file
A SYSOUT class for all print files
Figure 5.3.4-h. Substitutable Parameters for AQSTM20
310
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.1
MASTER FILE ARCHIVAL AND
MERGING INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: 24
5.4 AQDHS-II MASTER FILE ARCHIVAL AND MERGING
5.4.1 INTRODUCTION
The master file archival program, AMSARCH (AQ0215), provides the AQDHS-II
user with the capability to archive data from the master file. Archival of
data 1s advisable 1f the master file contains data that no longer requires
updating and/or 1s not generally Included 1n reports produced from the master
file. By archiving this static data, the user reduces the size of the active
(or volatile) master file and thereby reduces the cost of storing and
processing the active master file.
The master file archival flowchart 1s shown 1n Figure 5.4.1-a. AMSARCH
(AQ0215) separates the records 1n the Input master file Into two classes:
records containing data prior to or equal to the date specified on the option
card and records containing data after the date specified on the option card.
Records of the former type are written to the archived master file whereas
records of the latter type are written to the new (active) master file.
Closely related to the process of archiving data from the master file 1s
the process of merging two distinct master files. The master file merge
program, AMSMERG (AQ0210) provides the AQDHS-II user with the capability to
merge two distinct master files.
One example of the use of AMSMERG (AQ0210) 1s the merging of two archived
master files. Suppose that an archived master file has been created that
contains all data prior to or equal to 1971 and that the active file
contains all data from 1972 or later. To archive 1972 data, the active master
file would be Input to AMSARCH (AQ021S) with the appropriate option card,
producing the new active master file containing all data dated after 1972 and
an archived master file containing all 1972 data. Then the two archived
master files (1971 and prior, and 1972 files) would be Input to AMSMERG
311
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.1
MASTER FILE ARCHIVAL AND
MERGING INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
(AQ0210) to produce an archived master file containing all data prior to
or equal to 1972.
Two examples of the use of AMSMERG (AQ0210) are the merging of the
archived and active master files and the merging of answer files that were
extracted from the archived and active master files. Suppose the archived
master file contains all data prior to or equal to 1972 and the active master
file contains all data after 1972. To produce a report for all sulfur dioxide
data for the years 1971 through 1974, a retrieval (see Section 5.2) could be
run against both the archived and active master files to select 1971 through
1974 sulfur dioxide data. Then the two answer files would be input to AMSMERG
(AQ0210) to produce a merged answer file which would in turn be used to
produce the desired report.
The master file merge flowchart is shown in Figure 5.4.1-b. AMSMERG
(AQ0210) merges the two input master files into one output master file and
produces a diagnostic report.
Detailed discussions of AMSMERG (AQ0210) and AMSARCH (AQ0215) are in
Sections 5.4.2 and 5.4.3, respectively.
AMSARCH (AQ0215) may be executed using the cataloged procedure AQMSM20,
which is discussed in Section 5.4.3.5. A sample job stream to archive data
from the master file is shown in Section 5.4.3.5.4.
AMSMERG (AQ0210) may be executed using the cataloged procedure AQMSM10,
which is discussed in Section 5.4.2.5. A sample job stream to merge two
distinct master files is shown in Section 5.4.2.5.4.
312
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.1
MASTER FILE ARCHIVAL AND
MERGING INTRODUCTION
Page 3
Release Date: 4/30/79
Update #: 24
AQDHS-II
MASTER FILE
NEW AQDHS-II
MASTER FILE
OPTION CARD
AMSARCH (AQ0215)
MASTER FILE
ARCHIVAL PROGRAM
ARCHIVED
MASTER FILE
DIAGNOSTIC
REPORT
Figure 5.4.1-a. Master File Archival Flowchart
313
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.1
MASTER FILE ARCHIVAL AND
MERGING INTRODUCTION
Page 4
Release Date: 4/30/79
Update #: 24
FIRST
AQDHS-II
MASTER FILE
SECOND
AQDHS-II
MASTER FILE
AMSMERG (AQ0210)
MASTER FILE
MERGE PROGRAM
MERGED AQDHS-II
MASTER FILE
DIAGNOSTIC
REPORT
Figure 5.4.1-b. Master File Merge Flowchart
314
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.2
MASTER FILE MERGE PROGRAM
AMSMERG (AQ0210)
Page 1
Release Date: 4/30/79
Update #: . 24
5.4.2 MASTER FILE MERGE PROGRAM - AMSMERG (AQ0210)
5.4.2.1 Description
AMSMERG (AQ0210) creates a single AQDHS-II master file from two separate
AQDHS-II master files. The two input master files can also be answer files-
produced by a retrieval, archived master files, or any other combination"
of two files in master file format; however, the files must not contain" -
records that have identical keys and they must be in correct master file
sequence. The merged AQDHS-II master file will contain all the records from
both files and it will be in correct master file sequence.
5.4.2.2 File Formats
The input to AMSMERG (AQ0210) consists of two separate AQDHS-II master
files in correct master file sequence. See Figure 4.5.3-a for the master file
format.
AMSMERG (AQ0210) produces an AQDHS-II master file (in correct master file
sequence),and a diagnostic report. The diagnostic report consists of the
update messages and the input and output file record counts. A sample of the
diagnostic report is shown in Figure 5.4.2-a.
5.4.2.3 Options
There are no options.
5.4.2.4 Error Messages
AMSMERG 001 ABORT - IDENT KEY='identification key1 IS FOUND ON BOTH FILES
Meaning: Records with identical keys were found in both files and
program execution was terminated.
315
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.2
MASTER FILE MERGE PROGRAM
AMSMERG (AQ0210)
Page 2
Release Date: 4/30/79
Update f: 24
Action: Delete the undesired duplicate record from one of the Input
files and resubmit the job.
AMSMERG 002 ABORT - FILE #1 OUT OF SEQUENCE
Meaning: Input file #1 1s out of sequence or contains records with
duplicate keys. Therefore, program execution was terminated.
.Action: Sort input file #1 into the proper sequence using program
.-.'." ASRMSTR (AQ0140). Verify that there are no records with
duplicate keys in the file. If there are, correct the error
and resubmit the job.
AMSMERG 003 ABORT - FILE #2 OUT OF SEQUENCE
Meaning: Input file #2 is out of sequence or contains records with
duplicate keys. Therefore, program execution was terminated.
Action: Sort input file #2 into the proper sequence using program
ASRMSTR (AQ0140). Verify that there are no records with
duplicate keys in the file. If there are, correct the error
and resubmit the job.
5.4.2.5 Cataloged JCL
5.4.2.5.1 JCL listing - AMSMERG (AQ0210) can be run by executing the
cataloged procedure AQMSM10. See Figure 5.4.2-b for a listing of this
procedure.
5.4.2.5.2 Cross-reference of DP names and files
Program Name: AMSMERG (AQ0210)
DP Name File Description
OLDAQ1
OLDAQ2
NEWMSTR
AQSPRINT
Input AQDHS-II master file #1
Input AQDHS-II master file #2
Merged AQDHS-II master file
Diagnostic report
Input/Output
Input
Input
Output
Output
316
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.2
MASTER FILE MERGE PROGRAM
AMSMERG (AQ0210)
Page 3
Release Date: 4/30/79
Update #: 24
5.4.2.5.3 User-supplied JCL - The user must specify the data set names of
the input and output master files. See Figure 5.4.2-c for a description of
the procedure's substitutable parameters.
5.4.2.5.4 Sample run stream - The following run stream would produce the
AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.NEWMSTR' from the input
master files 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.RTANSR07' and 'CN.EPALMH.A087.
CDHS.HQ.AQS.DATA.RTANSR08':
// EXEC AQMSM10,
// INFILE1=RTANSR07,
// INFILE2=RTANSR08,
// NEWMSTR=NEWMSTR
5.4.2.6 Warnings and Special Instructions
AMSMERG (AQ0210) checks each input AQDHS-II master file for proper master
file sequence and duplicate record keys. If there is a sequence error or a
duplicate record key, a message will be printed indicating which input file
the error occurred in and program execution will be terminated. In addition
to the sequence check of each input file, there is a sequence check that
compares the record keys from each input file to determine if there are
duplicate records in the files. If duplicate records are present, an error
message will be printed and program execution will be terminated.
5.4.2.7 Cost Considerations
A^ run of AMSMERG (AQ0210) was executed on an IBM 370/168 using two
input test master files. The following estimates are from that test run:
317
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.2
MASTER FILE MERGE PROGRAM
AMSMERG (AQ0210)
Page 4
Release Date: 4/30/79
Update #: 24
Input master file #1:
Input master file #2:
Merged master file:
CPU time:
I/O time:
Total time:
291 records
20 records
311 records
0.3 seconds
5.3 seconds
5.6 seconds
Estimated cost:
5.4.2.8 Related Programs and Procedures
$1.32
See Section 5.4.3 Master File Archival Program AMSARCH (AQ0215),
318
-------
AQOHS-II MASTER FILE MERGE PROGRAM - DIAGNOSTIC REPORT
PAGE I
PROGRAM NAME I AMSMERG (A00210)
REVISION LEVEL! 1-00
LAST UPDATE *: 34
DATE INCORPORATED! OCTOBER 31 r 1<»78
INPUT FILE t CONTAINS!
INPUT FILE 2 CONTAINS:
OUTPUT FILE CONTAINS!
2 RECORDS
2 RECORDS
4 RECORDS
CO
Figure 5.4.2-a. Diagnostic Report
3 O
—• > n:
-o co
C > I
r~ o »-i
3> O i-i
-H m
•-. co
O co
^ 3 CO
3 5 m
co co o
o
30 O
T|
<-^ I-H cn
j» r— •
jO m -
O «
ro 3 ro
-o
•ya
o
o
-o n> 01
Q. — • «3
O>
rl- O*
n>
CO
o
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.2
MASTER FILE MERGE PROGRAM
AMSMERG (AQ0210)
Page 6
Release Date: 4/30/79
Update #: 24 -
//• PROCEDURE NAME! AQMSM10
//* REVISION LEVEL! 1-00
//* LAST UPDATE *! 24
//* DATE INCORPORATED! OCTOBER 31,1978
//*
//•
THIS PROCEDURE ALLOWS THE USER TO MERGE TWO DISTINCT AQDHS-II
MASTER FILES
//AQMSM10 PROC PROJECTION. EPALMH.A087.CDHS.HQ.AQS',
//
//
//
//
//
PROGRAMaAMSMERG,
REGIONH80K,
INFILEl'AQMSTARC,
INFILE2«AQMSTWRK,
NEKMSTRcAQNEHMST,
OISP1«'SHR,PA3S',
DISP2«'SHR,PASS',
DISP3»'NE*,CATLG,DELETE',
OUTsA,
UNIT13330,
VOL»CDHSPK,
TIME1«'1,0',
SPUNIT'TRK,
PRK20,
SECsJO
//
//*
//MERGE
//
//*
//* MERGE TWO AQDHS-II MASTER FILES
EXEC PGMXPROGRAM,
TIME«(&TIME1),
REGIONstREGIONl
//STEPLIB DD DSNI&PROJECT..LOAD,
// DISP«(SHR,PASS),
// VOLUME»(PRIVATE,RETAIN)
// DD DSN*SYS1.COBLIB,
DI3P«(3HR,PA3S)
//*
//*
INPUT DATA SET • AQDHS-II MASTER FILE
//OLDAQ1 DD DSNV&PROJECT..DATA.UNFILE1,
// DISPe(tDISPl),
// VOLUME»(PRIVATE,RETAIN)
INPUT DATA SET - AQDHS-II MASTER FILE
DD DSNstPROJECT..DATA.»INFILE2,
DISPX&DISP2),
VOLUMEXPRIVATE,RETAIN)
//*
//*
//OLDAQ2
//
//
//*
//* OUTPUT DATA SET - MERGED AQDHS-II MASTER FILE
//*
//NEMMSTR DD D3Ns&PROJECT..DATA.tNEHM3TR,
// VOL*SER*IVOL,
// UNITitUNIT,
// SPACEB(tSPUNIT,(tPRI,tSEC),RLSE),
00000100
00000200
00000300
00000400
00000500
00000600
00000700
00000800
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
Figure 5.4.2-b. Cataloged Procedure AQMSM10
(page 1 of 2)
320
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.2
MASTER FILE MERGE PROGRAM
AMSMERG (AQ0210)
Page 7
Release Date: 4/30/79
Update #: 24
//*
DISP>UDI3P3)
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//•
//AQSPRINT DD SYSOUT«»OUT
//*
//• OUTPUT DATA SETS • SYSTEM OPERATION
//•
//SYSPRINT DD SY30UT=IOUT
//*
//SYSOUT DD SYSOUT«*OUT
//*
//3Y3DBOUT DD SYSOUT«»OUT
//*
X/SYSDTERM DD 3Y30UT«40UT
//•
X/SYSUDUMP DD SYSOUT«tOUT
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
00007400
00007SOO
00007600
-
Figure 5.4.2-b Cataloged Procedure AQMSM10
(page 2 of 2)
321
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.2
MASTER FILE MERGE PROGRAM
AMSMERG (AQ0210)
Page 8
Release Date: 4/30/79
Update #: 24
Parameter
Name
Default
Value
Description
PROJECT 'CN.EPALMH.A087.
CDHS.HQ.AQS'
PROGRAM AMSMERG
REGION1 80K
INFILE1 AQMSTARC
INFILE2 AQMSTWRK
NEWMSTR AQNEWMST
OUT A
UNIT 3330
VOL CDHSPK
TIME1 '1,0'
SPUNIT TRK
PRI 20
SEC 10
DISP1 'SHR.KEEP'
DISP2 'SHR,KEEP'
DISP3 'NEW.CATLG,DELETE'
Highest-level Index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
NEWMSTR would be the full data set name of
an AQDHS-II master file)
Master file merge program
Region size allocated for execution of
AMSMERG
Lowest-level index of input master file #1
Lowest-level index of input master file #2
Lowest-level index of merged master file
SYSOUT class for all print files
Unit type to which merged master file is
to be written
Volume ID to which merged master file is
to be written
Time allocated for execution of AMSMERG
Units in which space for merged master
file is to be allocated
Primary space allocation for merged master
file
Secondary space allocation for merged
master file
Disposition of input master file #1
Disposition of input master file #2
Disposition of merged master file
Figure 5.4.2-c. Substitutable Parameters for AQMSM10
322
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 1
Release Date: 4/30/79
Update #: 24
5.4.3 MASTER FILE ARCHIVAL PROGRAM - AMSARCH (AQ0215)
5.4.3.1 Description
AMSARCH (AQ0215) creates two distinct master files from an input AQDHS-II
master file: a new AQDHS-II master file and an archived AQDHS-II master
file. Record selection for the output master files is based on an option date
supplied by the user. Master file records are selected for the new master
file if the date of the master file record is greater than or equal to the
specified option date; otherwise, the record is selected for the archived
master file.
AMSARCH (AQ0215) allows the user to reduce the size of his working master
file by archiving the oldest year(s) of data. By reducing the size of the
master file, the user will reduce operating expenses as well as the run time
of all programs that access this file.
5.4.3.2 File Formats
Input to AMSARCH (AQ0215) consists of a master file and an option card.
See Figure 4.5.3-a for the format of the master file.
AMSARCH (AQ0215) produces a new master file, an archived master file, and
a diagnostic report. A sample diagnostic report is shown in Figure 5.4.3-a.
5.4.3.3 Options
The user must enter an option card specifying the option date. This date
is a two-digit number representing the beginning year for records in the new
master file; no records from the beginning of the specified option year
through the current year will be archived.
323
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 2
Release Date: 4/30/79
Update #: 24
The option date must appear in columns 1 and 2 of the option card; it
must be numeric and greater than 59. If the option date is invalid, or if no
option card is submitted, an error message will be printed and program
execution will be terminated. See Figure 5.4.3-b for the option card format.
5.4.3.4 Error Messages
***
AMSARCH 001 ABORT - INVALID YEAR SPECIFIED
Meaning: Either no option card is present, or the specified option date
is not numeric or not greater than 59. Therefore, the run was
terminated.
Action: Correct the error and resubmit the job.
5.4.3.5 Cataloged JCL
5.4.3.5.1 JCL listing - AMSARCH (AQ0215) can be run by executing the
cataloged procedure AQMSM20. See Figure 5.4.3-c for a listing of this
procedure.
5.4.3.5.2 Cross-reference of DD names and files
Program Name: AMSARCH (AQ0215)
DD Name
AQSMASTR
AQSINPUT
AQSARCMS
AQSNEWMS
AQSPRINT
File Description
AQDHS-II master file
Option card
Archived AQDHS-II master file
New AQDHS-II master file
Diagnostic report
Input/Output
Input
Input
Output
Output
Output
5.4.3.5.3 User-supplied JCL - The user must specify the data set names for
the input master file, the new master file, and the archived master file. The
324
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 3
Release Date: 4/30/79
Update #: 24
user must also enter an option card specifying the option date. See Figure
5.4.3-d for a description of the procedure's substitutable parameters.
5.4.3.5.4 Sample run stream -The following run stream from the AQDHS-II
baseline test run series produces the new AQDHS-II master file 'CN.EPALMH.
A087.CDHS.HQ.AQS.DATA.NEWMF11 and the archived master file 'CN.EPALMH.A087.
CDHS.HQ.AQS.DATA.ARCMF11 from the AQDHS-II master file 'CN.EPALMH.A087.CDHS,
HQ.AQS.DATA.FTMSTRAA1.
// EXEC AQMSM20,
// MSTRFIL=FTMSTRAA,
// NEWMSTR=NEWMF1,
// ARCMSTR=ARCMF1
//ARCHIVE.OPTIONS DD *
77
/*
5.4.3.6 Warnings and Special Instructions
Since the option date is the only criterion for archiving master file
records, the'user must submit a valid option card with the execution deck. If
no option card or an invalid option card is submitted, program execution
will be terminated.
5.4.3.7 Cost Considerations
A test run .of AMSARCH (AQ0215) was executed on an IBM 370/168 using a
test AQDHS-II master file as input. The following estimates are from that
test run:
325
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 4
Release Date: 4/30/79
Update #: 24
Input AQDHS-II master file:
New AQDHS-II master file:
Archived AQDHS-II master file:
CPU time:
I/O time:
Total time:
291 records
5 records
286 records
0.5 seconds
6.0 seconds
6.5 seconds
Estimated cost:
$1.45
5.4.3.8 Related Programs and Procedures
The master file merge program, AMSMERG (AQ0210), can be executed to merge
an archived master file with a working master file whenever the user needs to
access the complete data set. AMSMERG (AQ0210) can also be executed to merge
a newly archived master file with a previously archived master file. See
Section 5.4.2 for a discussion of AMSMERG (AQ0210).
326
-------
CO
ro
AQDHS-II MASTER FILE ARCHIVAL PROGRAM - DIAGNOSTIC REPORT
PAGE 1
PROGRAM NAME: AMSARCH (A00215)
REVISION LtVELt 1-00
LAST UPDATE «:
DATE INCORPORATED: OCTOBER 31. i'7B
ALL DATA PRIOR TU 1966 IS ARCHIVED
OLD MASTER COUNT: 367
NEM MASTER COUNT: 341
ARCHIVED MASTER COUNT: Zb
Figure 5.4.3-a. Diagnostic Report
-o co
cr 3> i
i— o t-i*
3> O •-»«
—I m
i—i co
o co
co co o
m 1-1
o
o
K3 3>
t-* •yo
en o
«-i en
r~ •
m -i^
to
o>
to
to v> en
n>
ro
o>
co
o
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 6
Release Date: 4/30/79
Update #: 24
Column Column
#1 #2
YY
Figure 5.4.3-b. Option Card Format
328
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 7
Release Date: 4/30/79
Update #: 24
PROCEDURE NAMEl AOMSM20
REVISION LEVELl 1-00
L»ST UPDATE #: 21
DATE INCORPORATED! OCTOBER 31,1978
THI3 PROCEDURE ALLOWS THE USER TO ARCHIVE A PERIOD OF DATA
FROM THE AQDHS-1I MASTER FILE
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQMSM20 PROC PROJECT»'CN.EPALMH.A087.CDHS.HO.AOS',
// PRUGRAMsAMSARCH,
// REG=100K,
// MSTRFILsARMASTER,
// NENMSTRaAQMSTWRK,
// ARCMSTRaAOMSTARC,
// UNIT1=3330,
StRl=CDHSPK,
SER2=CDHSPK,
UISP1 = 'NEW, C»TLG, DELETES
DISP2= 'NEW, CATLG, DELETE',
SPCUNIT=TRK,
SEClslO,
HRIZ'IO,
// OUT«A
//ARCHIVE EXEC PGM=&PROGRAM,
// HEi;10N=&KEG,
// TIME=(1,0)
//*
//* ARCHIVE DATA FROM THE MASTER FILE
//STEPLIB DO DSNAME=&PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// I>ISP=(3HR,PASS)
//*
//* INPUT DATA SET - OPTION CARD
//*
//AOSINPUT DO UDNAME=OPTIONS,
// DCB=RLKSIZE=80
//*
//• INPUT DATA SET - CURRENT MASTER fILE
//*
//AOSMASTK 1>D DSNAME = &PROJECT..DAT A.&MSTRF!L,
// VllLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//• OUTPUT DATA SET - ARCHIVED MASTER FILE
//*
//AQSARCMS UD UNITs&UNlTI,
// VOLUME=(t'HIVATE,RETAIN,SER = &3ER|),
// l)ISI'=UDISPl),
// SPACE=(&SPCUN1T,(RPKI1,RSEC1),RLSE),
// DSNAME = RPRUJECT..f)ATA.&ARCMSTR
//*
00000100
00000200
00000300
00000100
00000500
00000600
00000700
oooooeoo
00000900
00001000
00001100
00001200
00001300
00001UOO
OOOOlbOO
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002bOO
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003100
00003500
00003600
00003700
00003800
00003900
00001000
00001100
00001200
00001300
oooonoo
00001500
00001600
00001700
00001800
00001900
00005000
00005100
00005200
00005300
00005100
00005500
00005600
00005700
00005800
(page 1 of 2)
Figure 5.4.3-c. Cataloged Procedure AQMSM20
329
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 8
Release Date: 4/30/79
Update #: 24
//* OUTPUT DATA SET • NEW MASTER FILE
//*
X/AOSNEWMS 00 UNIT»&UNIT2,
// VOLUME"(PRIVATE,RETAIN,3ER«»SER2),
// UISP«UDI3P2),
// 3PAC£.«(ISPCUNIT,(»PRI2,»SEC2),RLSE),
// OSNAMEHPROJECT. .DATA.iNEWMSTR
//*
//* OUTPUT DATA SET • MESSAGES
//*
//AOSPRINT DO SVSOUT'lOUT
//»
//* OUTPUT DATA SETS • SYSTEM OPERATION
//•
//SYSPP.JNT DO SVSOUTilOUT
//*
//SYSUDUMP DO SYSOUTHOUT
//*
//SYSDROUT DD SYSOUTKOUT
//*
//8YSOTEHM DO SYSOUTitOUT
//•
//8YSOUT DO SYSOUTHOUT
//*
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006SOO
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007600
00007900
00009000
00006100
00006200
Figure 5.4.3-c - continued.
(page 2 of 2)
Cataloged Procedure AQMSM20
330
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 9
Release Date: 4/30/79
Update #: . 24
Parameter
Name
PROJECT
PROGRAM
REG
MSTRFIL
NEWMSTR
ARCMSTR
UNIT1
UNIT2
SERIAL1
SERIAL2
DISP1
DISP2
SPCUNIT
PRI1
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS'
AMSARCH
100K
AQMASTER
AQMSTWRK
AQMSTARC
3330
3330
CDHSPK
CDHSPK
1 NEW,CATLG,DELETE'
'NEW,CATLG,DELETE'
TRK
10
Description
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQMASTER would
be the name of the AQDHS-II master file)
Program to archive an AQDHS-II master file
Region size allocated for execution of AMSARCH
Lowest-level index of input AQDHS-II master file
Lowest-level index of new AQDHS-II master file
Lowest-level index of archived AQDHS-II master
file
Unit type to which archived AQDHS-II master file
is to be written
Unit type to which new AQDHS-II master file is
to be written
Volume ID to which archived AQDHS-II master file
is to be written
Volume ID to which new AQDHS-II master file is
to be written
Disposition of archived AQDHS-II master file
Disposition of new AQDHS-II master file
Units in which space is to be allocated for
archived AQDHS-II master file
Primary space allocation for archived AQDHS-II
master file
(Page 1 of 2)
Figure 5.4.3-d. Substitutable Parameters for AQMSM20
331
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.4.3
MASTER FILE ARCHIVAL
AMSARCH (AQ0215)
Page 10
Release Date: 4/30/79
Update #: 24
Parameter Default
Name Value
PRI2
SEC1
SEC2
OUT
10
10
10
Description
Primary space allocation for new AQDHS-II master
file
Secondary space allocation for archived AQDHS-II
master file
Secondary space allocation for new AQDHS-II
master file
SYSOUT class for all print files
(Page 2 of 2)
Figure 5.4.3-d - Continued. Substitutable Parameters for AQMSM20
332
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.1
FILE CONVERSION
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: 24
5.5 FILE CONVERSION
5.5.1 INTRODUCTION
There are five AQDHS-II programs whose primary purpose is the conversion
of files: the SAROAD to AQDHS-II conversion program, ACVSARD (AQ0010); the
master file COBOL to FORTRAN format conversion program, ACVMFOR (AQ0020); the
parameter file COBOL to FORTRAN format conversion program, ACVPFOR (AQ0030);
the anomaly screening master file conversion program, ACVANOM (AQ0040); and
the units code conversion program, ACVUNIT (AQ0050).
ACVSARD (AQ0010) and ACVANOM (AQ0040) are always executed in conjunction
with particular AQDHS-II programs to accomplish specific purposes. ACVSARD
(AQ0010) is executed when SAROAD format transactions are to be used to create
or update the AQDHS-II master file. The relation of ACVSARD (AQ0010) to the
maintenance of the master file is discussed in Section 4.1.4. A detailed
discussion of ACVSARD (AQ0010) is presented in Section 5.5.2. ACVANOM
(AQ0040) is executed when the master file is to be screened for anomalous
readings. The relation of ACVANOM (AQ0040) to the master file anomaly
screening process is discussed in Section 6.4.1. A detailed discussion of
ACVANOM (AQ0040) is presented in Section 5.5.5.
ACVMFOR (AQ0020) and ACVPFOR (AQ0030) are included in the AQDHS-II system
solely for the benefit of those users who have user-written programs coded in
FORTRAN that access data from the master file and/or parameter file; neither
of these programs is used elsewhere in AQDHS-II. Both ACVMFOR (AQ0020) and
ACVPFOR (AQ0030) produce FORTRAN-compatible files; that is, files which may be
input to programs coded in ANS FORTRAN.
The COBOL to FORTRAN format conversion flowcharts for the master file and
parameter file are shown in Figures 5.5.1-a and 5.5.1-b, respectively.
ACVMFOR (AQ0020) converts the master file to FORTRAN-compatible format and
333
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.1
FILE CONVERSION
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
ACVPFOR (AQ0030) converts the parameter file to FORTRAN-compatible format;
both programs produce a diagnostic report.
Detailed discussions of ACVMFOR (AQ0020) and ACVPFOR (AQ0030) are
presented in Sections 5.5.3 and 5.5.4, respectively.
ACVMFOR (AQ0020) may be executed using the cataloged procedure AQCVM10,
which is discussed in Section 5.5.3.5. A sample run stream to convert the
master file to FORTRAN-compatible format is presented in Section 5.5.3.5.4.
ACVPFOR (AQ0030) may be executed using the cataloged procedure AQCVP10, which
is discussed in Section 5.5.4.5. A sample run stream to convert the
parameter file to FORTRAN-compatible format is presented in Section 5.5.4.5.4.
ACVUNIT (AQ0050) is used to change the units in which the readings in the
master file or in any answer file are expressed. All readings in the input
master or answer file may be converted to either standard units or
user-specified units, as defined in the parameter file. The file with the
converted readings has the same format as the master file and may, therefore,
be used to produce any AQDHS-II report. For example, the user could produce a
statistical analysis of a specific pollutant for a given year in standard
units by retrieving all data for the pollutant and year, then processing the
retrieved data through ACVUNIT (AQ0050) before producing the statistical
analysis report.
The units code conversion flowchart is shown in Figure 5.5.1-c. ACVUNIT
(AQ0050) converts the units in the master file or in any answer file to either
standard units or user-specified units, depending upon the option specified.
It also produces a diagnostic report. The parameter file is accessed for the
appropriate conversion factors, thus accuracy and completeness of the
parameter file is of paramount importance. Note that the output answer file
with converted readings may be out of the normal master file sort order
because the units code has been changed.
334
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.1
FILE CONVERSION
INTRODUCTION
Page 3
Release Date: 4/30/79
Update #: 24
A detailed discussion of ACVUNIT (AQ0050) is presented in Section 5.5.6.
ACVUNIT (AQ0050) can be executed using the cataloged procedure AQCVM20,
which is discussed in Section 5.5.6.5. A sample run stream to convert the
units of a master file is shown in Section 5.5.6.5.4.
335
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.1
FILE CONVERSION
INTRODUCTION
Page 4
Release Date: 4/30/79
Update #: 24
AQDHS-II
MASTER FILE OR
ANSWER FILE
ACVMFOR (AQ0020)
MASTER FILE COBOL TO
FORTRAN FORMAT CONVERSION PROGRAM
FORTRAN-COMPATIBLE
MASTER FILE OR
ANSWER FILE
DIAGNOSTIC
REPORT
Figure 5.5.1-a. Master File COBOL to FORTRAN Format Conversion Flowchart
336
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.1
FILE CONVERSION
INTRODUCTION
Page 5
Release Date: 4/30/79
Update #: 24
AQDHS-II
PARAMETER
FILE
ACVPFOR (AQ0030)
PARAMETER FILE COBOL TO
FORTRAN FORMAT CONVERSION PROGRAM
FORTRAN-COMPATIBLE
PARAMETER FILE
DIAGNOSTIC
REPORT
Figure 5.5.1-b. Parameter File COBOL to FORTRAN Format Conversion Flowchart
337
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.1
FILE CONVERSION
INTRODUCTION
Page 6
Release Date: 4/30/79
Update #: 24
AQDHS-II
MASTER FILE OR
ANSWER FILE
AQDHS-II
PARAMETER
FILE
ACVUNIT (AQ0050)
UNITS CODE
CONVERSION PROGRAM
ANSWER FILE WITH
CONVERTED READINGS
OPTION CARD
(Optional)
DIAGNOSTIC
REPORT
Figure 5,5.1-c. Units Code Conversion Flowchart
338
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 1
Release Date: 4/30/79
Update #: 24
5.5.2 SAROAD TO AQDHS-II CONVERSION PROGRAM - ACVSARD (AQ0010)
5.5.2.1 Description
ACVSARD (AQ0010) converts SAROAD transactions to AQDHS-II transactions.
There are three formats for the SAROAD transactions: Form 1, Form 2, and Form
3. Figure 5.5.2-a describes these formats. The Form 1 transactions are used
to enter hourly data, the Form 2 transactions to enter daily or multiple-
parameter data, and the Form 3 transactions to enter multiple-station data.
The Form 2 transactions can also be used to enter composite data. These
SAROAD formats correspond to the AQDHS-II Form 1, Form 2, and Form 3
transactions, so that a SAROAD transaction is converted to its respective
AQDHS-II transaction. The SAROAD transactions, unlike the AQDHS-II
transactions, do not have individual action codes; an action card precedes
each group of transactions to indicate whether they are add, change, or delete
transactions. Once the transactions have been converted to AQDHS-II format,
they can be edited and used to update the AQDHS-II master file. Those users
who code their input transactions on SAROAD load sheets must use ACVSARD
(AQ0010) to convert those transactions before they are input to the master
file transaction edit program AEDMSTR (AQ0060).
5.5.2.2 File Formats
There are two input files to ACVSARD (AQ0010). The first is the file
containing the SAROAD transactions. The formats for these transactions are
given in Figure 5.5.2-a, and descriptions of each field are given in Figure
*AS£®£ W&Kjx&fj, 4T^MV'4. Uct?''*'•"•- fes? •' ^4
5.5.2-b. See Appe*»i4*-e-for samples of the SAROAD load sheets.
339
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 2
Release Date: 4/30/75
Update #: 24
The SAROAD action card (see Figure 5.5.2-c) is used to indicate the
action code to be used for the transactions following that action card. It
consists of an identifier and a one-digit action code. The identifier is
always '$'; the action code can be either 1 (delete), 2 (add), or 3 (change).
More than one action card can be used in a single run of ACVSARD (AQ0010); an
action code is in effect for all SAROAD transactions following it until
another action card is read. A value of 4 for the action code indicates that
the status flag code should be set to 'S', implying that the transactions have
already been sent to SAROAD. The $4 action card should only be used in
conjunction with a $2 (add) action card and is in effect for the remainder of
the program execution.
The second input file is an option card (see Figure 5.5.2-d). This card
allows the user to specify whether the transactions are to be listed (LIST
option) or not (NOLIST option). See Section 5.5.2.3 for further information
on the options.
ACVSARD (AQ0010) produces two output files. The first is a file
containing the AQDHS-II format transactions which have been converted from the
input SAROAD transactions. The formats for the AQDHS-II transactions can be
seen in Figure 4.5.1-a. A diagnostic report is also produced; see
Figure 5.5.2-e for an example of this report.
5.5.2.3 Options
The user enters an option card to determine whether or not a confirmation
listing of the transactions will be printed. If the LIST option is specified,
a listing of each input SAROAD transaction and the corresponding AQDHS-II
transaction will be produced. If the NOLIST option is specified, no listing
will be produced. See Figure 5.5.2-d for the format of the option card.
340
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 3
Release Date: 4/30/7<
Update #: 24
If the option card is omitted, or if the option is invalid, the default
option NOLIST will be in effect.
5.5.2.4 Error Messages
ACVSARD 001 ERROR - INVALID ACTION CODE, SKIPPING TO NEXT ACTION CARD
Meaning: The only valid action codes are 1 (delete), 2 (add), 3
(change), and 4 (sent). All transactions are read and ignored
until a valid action card is read.
Action: If the transactions were not processed correctly due to this
error, correct the action card and resubmit the job.
ACVSARD 002 ERROR - NON-NUMERIC ACTION CODE, SKIPPING TO NEXT ACTION CARD
Meaning: The only valid action codes are 1 (delete), 2 (add), 3
(change), and 4 (sent). All transactions are read and ignored
until a valid action card is read.
Action: If the transactions were not processed correctly due to this
error, correct the action card and resubmit the job.
ACVSARD 003 ERROR - INVALID SAROAD FORM NUMBER, CARD REJECTED
Meaning: The valid SAROAD form numbers are 1, 2, and 3.
Action: Correct the form number and resubmit the job.
ACVSARD 004 ERROR - NON-NUMERIC SAROAD FORM NUMBER, CARD REJECTED
Meaning: The valid SAROAD form numbers are 1, 2, and 3.
Action: Correct the form number and resubmit the job.
ACVSARD 005 ERROR - NON-NUMERIC START HOUR, CARD REJECTED
Meaning: The start hour must be numeric. The valid start hours are
shown in Appendix A, Table 3.
Action: Correct the start hour and resubmit the job.
341
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 4
Release Date: 4/30/79
Update #: 24
ACVSARD 006 ERROR - START HOUR INCOMPATIBLE WITH TIME CODE, CARD REJECTED
Meaning: The start hour was not valid for the time code on the
transaction. See Appendix A, Table 3 for a table of valid
start hour/time code combinations.
Action: Correct start hour and/or time code and resubmit the job.
ACVSARD 007 ERROR - INVALID TIME CODE, CARD REJECTED
• Meaning: The time code was invalid. See Appendix A, Table 3 for valid
time codes.
Action: Correct time code and resubmit the job.
ACVSARD 008 CONDITIONAL - INVALID OPTION CARD, DEFAULT (NOLIST) USED
Meaning: An invalid option was specified; therefore, the default option
NOLIST was used.
Action: No action is necessary if it is acceptable to have no listing
of transactions; otherwise, correct the option card and
resubmit the job.
ACVSARD 009 CONDITIONAL - NO OPTION CARD, DEFAULT OPTION (NOLIST) USED
Meaning: No option card was entered; therefore, the default option
NOLIST was used.
Action: No action is necessary if it is acceptable to have no listing
of transactions; otherwise, include an option card and resubmit
the job.
5.5.2.5 Cataloged JCL
5.5.2.5.1 JCL listing - The SAROAD to AQDHS-II conversion program, ACVSARD
(AQ0010), is executed by the procedure AQCVT10, shown in Figure 5.5.2-f.
342
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 5
Release Date: 4/30/71
Update #: 24
5.5.2.5.2 Cross-reference of DP names and files
Program Name: ACVSARD (AQ0010)
DP Names
AQSOPTIN
AQSAROAD
AQSTRANS
AQSPRINT
File Description
Option card
SAROAD transactions
AQDHS-II transactions
Diagnostic report
Input/Output
Input
Input
Output
Output
5.5.2.5.3 User-supplied JCL -To execute the cataloged procedure AQCVT10, the
user must supply the SAROAD transactions and output JCL Information for the
AQDHS-II transactions. An option card can also be specified. See Figure
5.5.2-g for a description of the procedure's substltutable parameters.1
5.5.2.5.4 Sample run stream - The following run stream from the baseline test
run series reads SAROAD Input transactions and an option card and outputs
the AQDHS-II transactions Into a data set named 'CN.EPALMH.A087.HQ.AQS.DATA.
AQTRANS'.
// EXEC AQCVT10
//CONVERT.INPUT DD *
(SAROAD transactions)
/*
//CONVERT.OPTIONS DD *
NOLIST
/*
//CONVERT.OUTPUT DD UNIT-3330.VOL-SER-CDHSPK,
// DISP-(NEW,CATLG,DELETE),
// SPACE"(TRK,(10,5),RLSE),
// DSN-CN.EPALMH.A087.HQ.AQS.DATA.AQTRANS
343
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 6
Release Date: 4/30/79
Update #:. 24
5.5.2.6 Warnings and Special Instructions
The fields of the SAROAD and AQDHS-II transactions are similar except for
the value of the time code field. See Appendix A, Table 3 for a comparison of
these values. The user is cautioned to code SAROAD time code values when
running ACVSARD (AQ0010) since the program converts the time code from SAROAD
values to AQDHS-II values.
The number of AQDHS-II transactions produced by ACVSARD (AQ0010) may not
equal the number of valid input SAROAD transactions. The reason for this is
that the SAROAD transaction contains 12 readings for Form 1 data while the
AQDHS-II transaction contains only eight. Thus, one day of one-hour readings
(24 values) requires two SAROAD transactions and three AQDHS-II transactions.
Similarly, one day of two-hour readings (12 values) needs one SAROAD
transaction and two AQDHS-II transactions.
SAROAD transactions which are flagged as being in error will not be
converted to AQDHS-II transactions. These erroneous transactions should be
corrected and entered into another run of ACVSARD (AQ0010).
The action cards entered with the SAROAD transaction must contain a valid
code ($l-delete, $2-add, $3-change, or $4-sent). The $4 action card is only
used in conjunction with the $2 card and indicates that the transactions have
previously been sent to SAROAD. The $4 card is in effect for all transactions
following it during that execution of ACVSARD (AQ0010). If a $1, $2, or $3
card occurs after a $4 card, the transactions that follow that card will be
converted and flagged as sent; however, the only transactions which are
flagged as sent will be accepted by the master file transaction edit program,
AEDMSTR (AQ0060), are the add transactions. The other three action code
cards are in effect only until the next action card (other than $4) is read.
344
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 7
Release Date: 4/30/7$
Update #: 24
5.5.2.7 Cost Considerations
The following information is taken from the execution on an IBM 370/168
of the sample test run shown in Section 5.5.2.5.4 and provides an estimate of
the cost of executing ACVSARD (AQ0010):
Number of SAROAD transactions: 540 transactions
Number of AQDHS-II transactions: 553 transactions
CPU time: 1.1 seconds
I/O time: 15.7 seconds
Total time: 16.8 seconds
Estimated cost: $3.50
This test run used the NOLIST option. The cost would have been higher
had the LIST option been used. To reduce computer costs, it is recommended
that the NOLIST option be used. Note that NOLIST is the default option if no
option is specified.
5.5.2.8 Related Programs and Procedures
After running ACVSARD (AQ0010), the cataloged procedure AQEMM10 can be
run. This procedure executes AEDMSTR (AQ0060), the master file transaction
edit program; ASRINTR (AQ0130), the master file internal transaction sort
program; and AFMMSTR (AQ0100), the master file maintenance program. See
Section 4.6.1 for more information on this procedure.
Two procedures - AQEDT10, which executes AEDMSTR (AQ0060), and AQFMM10,
which executes ASRINTR (AQ0130) and AFMMSTR (AQ0100) - may be run in place of
AQEMM10 if desired. AEQDT10 is discussed in Section 4.5.1.5, and AQFMM10 is
discussed in Sectin 4.5.3.5.
345
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 8
Release Date: 4/30/7S
Update #: 24
Column #
SAROAD Transaction - Form 1 (Hourly Data)
Field Length
Data Type
Description
2
4
8
12
15
17
19
21
23
28
30
33
37
41
45
49
53
57
61
65
69
73
77
1
- 3
- 7
- 10
11
- 13
14
- 16
- 18
- 20
- 22
- 27
- 29
- 31
32
- 36
- 40
- 44
- 48
- 52
- 56
- 60
- 64
- 68
- 72
- 76
- 80
1
2
4
3
1
2
1
2
2
2
2
5
2
2
1
. 4
4
4
4
4
4
4
4
4
4
4
4
Numeric
Alphanumeric
Numeric
Numeric
Alphabetic
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeri c
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Figure 5.5.2-a. SAROAD Transaction
Form Code
State Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Month
Day
Start Hour
Parameter Code
Method Code
Units Code
Decimal Code
Reading
Reading
Reading
Reading
Reading
Reading
Reading
Reading
Reading
Reading
Reading
Reading
(Page 1 of 4)
Formats
346
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 9
Release Date: 4/30/7<
Update #: 24
SAROAD Transaction - Form 2 (Daily or Multiple-Parameter Data)
Column #
Field Length
Data Type
Description
2
4
8
12
15
17
19
21
23
28
30
33
37
51
65
79
1
- 3
- 7
- 10
11
- 13
14
- 16
- 18
- 20
- 22
- 27
- 29
- 31
32
- 36
- 50
- 64
- 78
- 80
1
2
4
3
1
2
1
2
2
2
2
5
2
2
1
4
14
14
14
2
Numeric
Alphanumeric
Numeric
Numeric
Alphabetic
Numeric
Alphanumeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Form Code
State Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Month
Day
Start Hour :
Parameter Code
Method Code
Units Code
Decimal Code
Reading
Repeat Columns 23-36
Repeat Columns 23-36
Repeat Columns 23-36
Unused
(Page 2 of 4)
Figure 5.5.2-a - Continued. SAROAD Transaction Formats
347
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 10
Release Date: 4/30/7S
Update #: 24
SAROAD Transaction - Form 2 Composite Data
Column #
1 - 16
17 - 18
19 - 20
21
22
23 - 80
Field Length
16
2
2
1
1
58
Data Type
Numeric
Numeric
Numeric
Alphanumeric
Description
Same as Form 2
(non-composite)
Composite Period
Composite Number of
Samples
Composite Type
Composite Time Code
Same as Form 2
(non-composite)
Figure 5.5.2-a - Continued.
(Page 3 of 4)
SAROAD Transaction Formats
348
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 11
Release Date: 4/30/79
Update #: 24
SAROAD Transaction - Form 3
(Multiple-Station Data)
Column #
Field Length
Data Type
2
5
8
13
15
18
20
22
24
26
30
33
37
50
63
76
1
- 3
4
- 6
7
- 12
- 14
- 16
17
- 19
- 21
- 23
- 25
- 29
- 32
- 36
- 49
- 62
- 75
- 80
1
2
1
2
1
5
2
2
1
2
2
2
2
4
3
4
13
13
13
5
Numeric
Alphanumeric
Alphabetic
Numeric
Alphanumeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Description
Form Code
State Code
Agency Code
Project Code
Time Code
Parameter Code
Method Code
Units Code
Decimal Code
Year
Month
Day
Start Hour
Area Code
Site Code
Reading
Repeat Columns 24-36
Repeat Columns 24-36
Repeat Columns 24-36
Unused
Figure 5.2.2-a - Continued.
(Page 4 of 4)
SAROAD Transaction Formats
349
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 12
Release Date: 4/30/79
Update #: 24
Action Code: Indicates whether the record is to be added, changed, or
deleted from the master file and appears on the action card which is
input with the SAROAD transactions to ACVSARD (AQ0010).
Valid Codes: 1 - Delete
2 - Add
3 - Change
4 - Flagged as sent to SAROAD
Field Length: 1 character
Agency Code: Identifies the agency responsible for these readings.
Valid Codes: See Appendix A, Table 1. Also, the code must be in the
site file.
Field Length: 1 character
Area Code: Identifies the area in which the sampling site is located.
Valid Codes: The code must be in the site file.
Field Length: 4 characters
Composite Number of Samples: Indicates the number of individual samples that
were included to obtain the composite sample.
Field Length: 2 characters
Composite Period:
taken.
Valid Codes:
Identifies the period during which the composite sample was
01 - 04 Quarterly and Seasonal Composite
01 - 12 Monthly Composite
01 - 52 Weekly Composite
00 Annual Composite
Figure 5.5.2-b.
(Page 1 of 5)
Description of SAROAD Transaction Fields
350
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 13
Release Date: 4/30/79
Update #: 24
Field Length: 2 characters
Composite Time Code: Indicates the Interval at which the individual
composite sample was taken.
Valid Codes: The SAROAD time codes should be used. See Appendix A,
Table 3 for the proper codes.
Field Length: 1 character
Composite Type: Indicates the Interval of the composite sample.
Valid Codes: 1 - Quarterly Composite
2 - Seasonal Composite
3 - Monthly Composite
4 - Weekly Composite
5 - Annual Composite
Field Length: 1 character
Day: The day of the month on which the sample was taken.
Field Length: 2 characters
Decimal Code: Indicates the number of digits in the reading to the right of
the decimal point.
Valid Codes: 0-4
Field Length: 1 character
(Page 2 of 5)
Figure 5.5.2-b - Continued. Description of SAROAD Transaction Fields
351
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 14
Release Date: 4/30/75
Update #: 24
Form Code: Indicates which transaction format is being used.
Valid Codes: 1 - Form 1
2 - Form 2
3 - Form 3
Field Length: 1 character
Method Code: Identifies both the collection method and the analysis method
for the parameter being measured.
Valid Codes: The code must be in the parameter file.
Field Length: 2 characters
Month: The month of the year during which the sample was taken.
Field Length: 2 characters
Parameter Code: Identifies the parameter being measured.
Valid Codes: Refer to AEROS Manual Series, Volume V: AEROS Manual of
Codes for a full list of currently accepted parameter
codes. Also, the code must be in the parameter file.
Field Length: 5 characters
Project Code: Identifies the project associated with the sample.
Valid Codes: See Appendix A, Table 2. Also, the code must be in the
site file.
Field Length: 2 characters
Reading: The value of the sample taken.
Valid Codes: This field can contain either positive or negative data;
however, either type must be right-justified within the
(Page 3 of 5)
Figure 5.5.2-b - Continued. Description of SAROAD Transaction Fields
352
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 15
Release Date: 4/30/79
Update #: 24
Field Length:
field. Also, if the reading is negative, it must adhere to
the following format: -ddd where d is any digit 0-9.
See Appendix A, Table 5 for a list of parameters which may
have negative readings.
4 characters
Site Code: Identifies the site at which the sample was taken.
Valid Codes: The code must be in the site file.
Field Length: 3 characters
Start Hour: On Form 1 transactions, the hour at which the first reading was
taken. On Form 2 and Form 3 transactions, the hour at which the
sample was taken.
Valid Codes: See Appendix A, Table 3.
Field Length: 2 characters
State: Indicates the state in which the sampling site is located.
Valid Codes: The code must be in the site file.
Field Length: 2 characters
Time Code: Indicates the interval at which the samples were taken.
Valid Codes:
Field Length:
See Appendix A, Table 3. The SAROAD time code should be
used since SAROAD time codes are converted to AQDHS-II time
codes by ACVSARD (AQ0010).
1 character
Units Code: Indicates the units in which the parameter was measured.
Valid Codes: See Appendix A, Table 4 for a partial list. Also, the code
must be in the parameter file.
Field Length: 2 characters
(Page 4 of 5)
Figure 5.5.2-b - Continued. Description of SAROAD Transaction Fields
353
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 16
Release Date: 4/30/79
Update #: 24
Year: The year in which the sample was taken.
Valid Codes: The year must be greater than or equal to 60,
Field Length: 2 characters
(Page 5 of 5)
Figure 5.5.2-b - Continued. Description of SAROAD Transaction Fields
354
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 17
Release Date: 4/30/79
Update #:. 24
Column #
1
2
3-80
Field Length
1
1
78
Data Type
Alphanumeric
Numeric
Description
Identifier - value $
Action code
Unused
Figure 5.5.2-c. Action Card Format
355
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 18
Release Date: 4/30/79
Update f: 24
Column
#1
V
NOLIST
or
Column
'#1
V
LIST
The specified option must be punched beginning In column #1 with no spaces
between the letters.
Figure 5.5.2-d. Option Card Format
356
-------
co
en
SARUAU 10 AQDHS-II CONVERSION PROGRAM - DIAGNOSTIC RtPORT
PAGE
PROGRAM NAME: ACVSARD (AQ0010)
REVISION LEVEL: 1-00
LAST UPDATE *: 2fl
DATE INCORPORATED: OCTOBER 31, 1976
OPTIUN IN EFFECT: NULIST
7373000997AOS27707010015101110720001
«•« ACVSARD 003 ERROR - INVALID SAROAD FORM NUMBER, CARD REJECTED
373000997A05277070100a3101110720001
*** ACVSARD 091 ERROR - NON-NUMERIC SAROAD FORM NUMBER, CARD REJECTED
I373000997AOSD7707010013101110720001
*•• ACVSARD 007 ERROR - INVALID TIME CODE, CARD REJECTED
1373000997AOS2770701 013101110720001
**• ACVSARD OOb ERROR - NON-NUMERIC START HOUR, CARD REJECTED
NUMBER OF INPUT SAROAD TRANSACTIONS: 657
NUMBER OF JACTION CARDS! 1
NUMBER OF AQDHS-II TRANSACTIONS HRITIEN: 970
NUMBER OF DIAGNOSTIC MESSAGES: «
Figure 5.5.2-e. Diagnostic Report
3 O 3>
3» 3» XD
Z — I O
•-• 3» OC
-o co
C= J» I
T— o •-•
3> r> •-•
o
3>
O
co
J*
30
co
t* m
30 r>
o — «
f* •-«
O O
o "o
I— 3C
o co
•*-* i
en
•
en
ro
•D (D Of
o. — <
eo
o
to
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 20
Release Date: ,4/30/79
Update #: 24
PROCEDURE NAME: AQCVTJO
REVISION LEVEL: 1-00
LAST UPDATE «: 24
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO CONVERT SAROAD FORMAT
TRANSACTIONS TO AQOHS-II FORMAT TRANSACTIONS
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQCVT10 PROC PROJECT='CN.EPALMH,A067.CDHS.HQ.Af)S',
// PROGRAM=ACVSARD,
// OUT=A
//*
//CONVERT EXEC PGM=RPROGRAM,
// REGION=60K,
// TIME=(3,.0)
//*
//* CONVERT SAROAD INPUT FORMAT TO AUDHS INPUT FORMAT
//*
//STEPLIB DD DSNAME=RPROJECT.,LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
// DD DSNAME=SYS1.COBL1B,
tt VOLUME=(PRIVATE,RETAIN),
// DISPe(SHR,PASS)
//*
//* INPUT DATA SET - EDIT OPTIONS CONTROL CARD
//*
//AOSOPTIN DD DDNAME=OPTIONS,
// DCB=DLKS1ZE=80
//*
//* INPUT DATA SET - SAROAD TRANSACTIONS
//*
//AQSAROAD DD DDNAME=INPUT,
// DCB=DLK3IZE=80
//*
//* OUTPUT DATA SET - AQDHS-II TRANSACTIONS
//*
//AOSTRANS OD DDNAME=OUTPUT
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//AOSPRINT DD SYSOUT = &f)UT
//*
//* OUTPUT DATA SETS • SYSTEM OPERATION
//*
//SYSPRINT DO SYSOUT=ROUT
//*
//SYSOUT
//*
//SYSDBOUT
//*
//SYSDTERM 1)0 SYSLHITaROUT
DD SYSOUT=&OUT
DD SYSUUT=&OUT
//*
//SYSUDUMP
//*
DD SYSOUT=&OUT
00000100
00000200
00000300
OOOOO'JOO
00000500
00000600
00000700
ooooneoo
00000900
00001000
00001100
ooooiaoo
00001300
00001400
00001500
00001600
00001700
00001HOQ
00001900
ooooaooo
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002BOO
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
OOOOSOOO
00005100
0000520(1
00005300
000054QO
00005500
00005600
00005700
Figure 5.5.2-f. Cataloged Procedure AQCVT10
358
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.2
SAROAD TO AQDHS-II
ACVSARD (AQ0010)
Page 21
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROGRAM
OUT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ACVSARD
A
Description
Highest-level index of data set names (e.g.,
'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.FTMSTRAA
would be the full data set name of the
AQDHS-II master file)
SAROAD to AQDHS-II conversion program
SYSOUT class for all print files
Figure 5.5.2-g. Substitutable Parameters for AQCVT10
359
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 1
Release Date: 4/30/79
Update #: 24
5.5.3 MASTER FILE COBOL TO FORTRAN FORMAT CONVERSION PROGRAM - ACVMFOR
(AQ0020)
5.5.3.1 Description
ACVMFOR (AQ0020) is a file format conversion program. It is intended for
the user who has ANS FORTRAN programs which use data from the AQDHS-II master
file. Prior to executing user-written FORTRAN programs, the user can execute
ACVMFOR (AQ0020) to generate a FORTRAN-compatible file containing the data
from the AQDHS-II master file. ACVMFOR (AQ0020) can also be used to convert
any AQDHS-II answer file to FORTRAN-compatible format.
As expected, the FORTRAN-compatible master file contains more physical
records than the input master file. It has a header record as well as a
trailer record; moreover, each record from the AQDHS-II master file is split
into one to four output records. This splitting is required because an
AQDHS-II master file consists of variable-length records which store up to a
maximum of 31 readings whereas the FORTRAN-compatible master file consists of
fixed-length records which store ten readings. All readings from an AQDHS-II
master file record are stored in a set of FORTRAN-compatible records which
have the same,key fields and are sequenced by the record sequence field. Each
set starts with a record sequenced by 'A1, followed by 'B', and so on. Two
different AQDHS-II master file records generate two different sets of
FORTRAN-compatible records.
5.5.3.2 File Formats
Input to ACVMFOR (AQ0020) consists of an AQDHS-II master file or answer
file (refer to Figure 4.5.3-a).
360
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 2
Release Date: 4/30/79
Update #: 24
Output consists of a FORTRAN-compatible master file whose format is
shown-in Figure 5.5.3-a. A diagnostic report which has the standard update
messages and summary statistics is also produced. See Figure 5.5.3-b for a
sample of the diagnostic report.
5.5.3.3 Options
There are no options.
5.5.3.4 Error Messages
ACVMFOR 001 ERROR - NO INPUT RECORDS • OUTPUT UNUSABLE
3
Meaning: There are no records in the specified input master file; thus,
the output file consists only of a header record and a trailer
record.
Action: Specify a valid master file and resubmit.
5.5.3.5 Cataloged JCL
5.5.3.5.1 JCL listing - ACVMFOR (AQ0020) can be run by executing the
cataloged procedure AQCVM10. See Figure 5.5.3-c for a listing of this
procedure.
5.5.3.5.2 Cross-reference of DP names and files
Program Name: ACVMFOR (AQ0020)
DP Name File Description Input/Output
AQSMASTR AQDHS-II master file or answer file Input
AQSMFORT FORTRAN-compatible master file Output
AQSPRINT Diagnostic report Output
361
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 3
Release Date: 4/30/79
Update #: 24
5.5.3.5.3 User-supplied JCL - To execute the cataloged procedure AQCVM10,
the user can expect to supply job accounting Information and the data set
names of the Input AQDHS-II master file and the output FORTRAN-compatlle
master file. See Figure 5.5.3-d for a description of the procedure's
substltutable .parameters.
5.5.3.5.4 Sample run stream - The following run stream would produce a
FORTRAN-compatlble master file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
FORTMSTR1 from the Input AQDHS-II master file named 'CN.EPALMH.A087.CDHS.HQ.
AQS.DATA.AQSFILE1.
// EXEC AQCVM10
// MSTRFIL=AQSFILE,
// MSTRFOR=FORTMSTR
5.5.3.6 Warnings and Special Instructions
There are no warnings and special instructions.
5.5.3.7 Cost Considerations
The following estimates are for the execution of ACVMFOR (AQ0020) on an
IBM 370/168:
Size of AQDHS-II master file: 20 records
Size of FORTRAN-compatlble master file: 64 records
CPU time: .2 second
I/O time: 6.4 seconds
Total time: 6.6 seconds
Estimated cost: $1.04
362
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 4
Release Date: 4/30/79
Update #: 24
5.5.3.8 Related Programs and Procedures
Since an AQDHS-II master file is not readable to an ANS FORTRAN program,
ACVMFOR (AQ0020) is designed to convert the AQDHS-II master file to a FORTRAN-
compatible format. Any user-written FORTRAN program that accesses the master
file can be designed to utilize the FORTRAN-compatible master file produced by
ACVMFOR (ACV0020). ACVMFOR (ACV0020) would be executed prior to the execution
of any such user-designed FORTRAN program.
Currently, there are no AQDHS-II programs or procedures to use the file
created by ACVMFOR (AQ0020). This program provides the user a means of
accessing his file with his own FORTRAN program.
363
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 5
Release Date: 4/30/79
Update I: . 24
Record Position
1
2
3
4
5 - 8
9 - 10
11 - 13
14 - 17
18 - 21
22 - 24
25
26 - 27
28
29 - 30
31 - 35
36 - 37
38 - 39
40 - 41
42 - 43
44 - 45
46
47 - 56
57 - 58
59
60
61 - 64
Field Length
1
1
1
1
4
2
3
4
4
3
1
2
1
2
5
2
2
2
2
2
1
10
2
1
1
4
Description
Record Sequence
Action Code
Form Code
Record Status Flag
Reserved Area
State Code
AQCR
County Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Parameter Code
Method Code
Unit Code
Month Code
Day Code
Start Hour
SLAMS/NAMS ID
Reserved Area
Number of Readings
Status Flag
Decimal Code
Reading
Occurs 1 to 10
times
Figure 5.5.3-a. FORTRAN-compatlble Record Format
364
-------
AUDHS-II HASItR FILE COBOL TO FORTRAN CONVERSION PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME I ACVMFUR IAQOOZO)
REVISION LEVELS 1-00
LAST UPDATE *l 2«
DATE INCORPORATED! OCTOBER 31 • 1978
WXHER OF FILE RECORDS READ: 331
NUMBER OF FILE RECORDS WRITTENI 707
NUMBER OF ERRORS DETECTED: 0
0»
tn
Figure 5.5.3-b. Diagnostic Report
3 O
r> •-•
m
o to
CD
2 O CO
x> o m
O CD <->
m CD —i
o 01
o jo
10 J>
o
ro
o
CZ 30 -O
T3 CD 0»
O. — • (O
Oi fl> O>
c* Oi
O> M <7k
o>
c*
ro ID
to
o
IO
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 7
Release Date: 4/30/79
Update #: . 24
PROCEDURE NAME: AQCVMIO
REVISION LEVtL: 1-00
LAST UPDATE »l 24
DATE INCORPORATED I OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE UStR TO CREATE A FORTRAN-COMPATIBLE
FILE OF AQDHS-II MASTER FILE RECORDS FOR INPUT TO USER-WRITTEN
FORTRAN PROGRAMS
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQCVMIO PROC PROJECT='CN.EPALMH.A087.CDH3.HQ.AQ3',
// PROGRAMsACVMFOR,
// TlMEls'1,0',
// M3TRHL=AQMASTER,
// MSTRHJR=AOFORMST,
// UNIT=3330,
// 3ERIAL=CDHSPK,
// DISPs'NEW,PASS,DELETE',
// SPCUN1T=TRK,
// PRIMARY=20,
// SECNDRY=10,
// OUT=A
EXEC PGM=RPRUGRAM,
TIMEs(STIMF.l)
//*
//CONVERT
//*
//* PRODUCE A FORTRAN-COMPATIBLE FILE
//*
//STEPLIB DD OSNAMfc=&PROJECT..LOAD,
// VOLUHE=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
// DD DSNAME=SYS1.COBLIB,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - AQDHS MASTER FILE
//*
//AQ3MASTR DD DSNAMEa&PROJECT..DATA.RMSTRFIL,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//*
//* OUTPUT DATA SET - FORTRAN-COMPATIBLE STATISTICS FILE
//*
//AQSMFOKT DD IJNIT = 8,UNIT,
// VOLUf1E=(PRIVATE,RETAIN,SER=RSERIAL),
// DISP=(&DISP),
// SPACE=(&SPCUNIT,(&PRIMARY,&SECNDRY),RLSE),
// DSNAME = &PROJECT.,DATA.(tMSTRFOR
//*
//* OUTPUT DATA SET - MESSAGE LISTING
//*
//AGSPRINT DD SYSOUT=&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DO 3YSOUT=40UT
//*
//SYSOUT DD SYSOUT = &(JUT
00000100
00000200
OOOOOJOO
00000400
00000500
00000600
00000700
00000800
00000900
00001000
00001100
00001200
00001300
ooooiaoo
00001500
OOOOlhOO
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002000
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00000100
ooooWoo
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005)00
OOOOS200
00005300
00005400
00005SOO
00005600
00005700
00005800
(page 1 of 2)
Figure 5.5.3-c. Cataloged Procedure AQCVMIO
366
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 8
Release Date: 4/30/79
Update #: 24
it*
//3YSDBOUT
//*
//3Y30TERM
//*
//3Y3UDUMP
//*
DD 3YSOUT9&UUT
Dl> SYSOUTs&OUT
DO 3Y30UT=&OUT
00005900
00006000
00006100
00006200
00006300
00006400
00006500
Figure 5.5.3-c - continued.
367
(page 2 of 2)
Cataloged Procedure AQCVM10
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.3
COBOL TO FORTRAN
PROGRAM ACVMFOR (AQ0020)
Page 9
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROGRAM
SERIAL
DISP
SPCUNIT
PRIMARY
SECNDRY
OUT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ACVMFOR
TIME1
MSTRFIL
MSTRFOR
UNIT
'1,0'
AQMASTER
AQFORMST
3330
CDHSPK
'NEW.PASS,DELETE1
TRK
20
10
A
Description
Highest-level index of data set names
Master file COBOL to FORTRAN format
conversion program
Time allocated for execution of ACVMFOR
Lowest-level index of master file
Lowest-level index of FORTRAN-compatible
file
Unit type to which output FORTRAN-
compatible file is to be written
Volume ID to which output FORTRAN-
compatible file is to be written
Disposition of output FORTRAN-compatible
file
Units in which space for output FORTRAN-
compatible file is to be allocated
Primary space allocation for output
FORTRAN-compatible file
Secondary space allocation for output
FORTRAN-compat i ble file
SYSOUT class for all print files
Figure 5.5.3-d. Substitutable Parameters for AQCVM10
368
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.4
COBOL TO FORTRAN
PROGRAM ACVPFOR (AQ0030)
Page 1
Release Date: 4/30/79
Update #: 24
5.5.4 PARAMETER FILE COBOL TO FORTRAN FORMAT CONVERSION PROGRAM - ACVPFOR
(AQ0030)
5.5.4.1 Description
ACVPFOR (AQ0030) converts the AQDHS-II parameter file to a FORTRAN-
compatible file that can be used as input to FORTRAN programs; it is intended
for the user who has ANS FORTRAN programs which use data from the AQDHS-II
parameter file. Prior to executing his FORTRAN programs, the user can execute
ACVPFOR (AQ0030) to convert the parameter file to a FORTRAN-compatible
format.
The data fields in a converted record are the same as in the input file
with the exception of the 'minimum detectable' data field. The minimum
detectable is represented in the COBOL parameter file as a signed four-digit
number; the decimal position for this number is indicated in a separate
field. When the file is converted to the FORTRAN-compatible format, the
minimum detectable is represented by a ten-character field containing the sign
('-' if negative, blank if positive), the decimal point, and the actual
numerical value.
Additionally, a header record containing zeroes and a trailer record
containing nines are appended to the converted file. The header record of
zeros signifies that this file is FORTRAN-compatible and should not be used
in maintenance activities, and the trailer record provides an end of file for
those computer systems which do not recognize COBOL end-of-files.
5.5.4.2 File Formats
The input to ACVPFOR (AQ0030) is the AQDHS-II parameter file. See Figure
4.2.2-c for a description of the parameter file format.
369
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.4
COBOL TO FORTRAN
PROGRAM ACVPFOR (AQ0030)
Page 2
Release Date: 4/30/79
Update #: 24
Output consists of a FORTRAN-compatible parameter file and a diagnostic
report containing an input count, an output count, and an error count. See
Figure 5.5.4-a for a description of the converted parameter file format and
Figure 5.5.4-b for an example of the diagnostic report.
5.5.4.3 Options
There are no options.
5.5.4.4. Error Messages
*** ACVPFOR 001 ERROR - NO INPUT RECORDS, OUTPUT UNUSABLE
Meaning: The input AQDHS-II parameter file contains no records;
therefore, the output file contains only a header record and a
trailer record.
Action: Check the input AQDHS-II parameter file to insure that it is
the proper file. Correct the error and resubmit the job.
5.5.4.5 Cataloged JCL
5.5.4.5.1. JCL Listing - ACVPFOR (AQ0030) can be run by executing the
cataloged procedure AQCVP10. See Figure 5.5.4-c for a listing of this
procedure.
5.5.4.5.2 Cross-reference of DP names and files
Program Name: ACVPFOR (AQ0030)
DP Name File Description Input/Output
AQSPARMK AQDHS-II parameter file Input
AQSPARMF Converted parameter file Output
AQSPRINT Diagnostic report Output
370
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.4
COBOL TO FORTRAN
PROGRAM ACVPFOR (AQ0030)
Page 3
Release Date: 4/30/79
Update #: . 24
5.5.4.5.3 User-supplied JCL - The user must supply the data set names of the
input AQDHS-II parameter file and the output converted parameter file. See
Figure 5.5.4-d for a description of the procedure's substitutable parameters.
5.5.4.5.4 Sample run stream - The following run stream would produce the
FORTRAN-compatible parameter file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.FPARMFIL'
from the AQDHS-II parameter file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.CPARMFIL1:
// EXEC AQCVP10,
// PARMFIL=CPARMFIL,
// PARMFFL=FPARMFIL
5.5.4.6 Warnings and Special Instructions
To insure that a usable output file is created, the user must input a
valid AQDHS-II parameter file to ACVPFOR (AQ0030).
5.5.4.7 Cost Considerations
A test run of ACVPFOR (AQ0030) was executed on an IBM 370/168 using a
test AQDHS-II parameter file. The following estimates are for that
test run:
AQDHS-II parameter file: 44 records
Converted parameter file: 46 records
CPU time: 0.1 second
I/O time: 3.2 seconds
Total time: 3.3 seconds
Estimated cost: $0.93
371
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.4
COBOL TO FORTRAN
PROGRAM ACVPFOR (AQ0030)
Page 4
Release Date: 4/30/79
Update #: 24
5.5.4.8 Related Programs and Procedures
An AQDHS-II parameter file cannot be read by an ANS FORTRAN program.
ACVPFOR (AQ0030) 1s designed to convert the AQDHS-II parameter file to a
FORTRAN-compatlble format. Any user-written FORTRAN program that accesses the
parameter file can be designed to utilize the FORTRAN-compatlble parameter
file produced by ACVPFOR (AQ0030). ACVPFOR (AQ0030) would be executed prior
to the execution of any such user-designed FORTRAN program.
372
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.4
COBOL TO FORTRAN
PROGRAM ACVPFOR (AQ0030)
Page 5
Release Date: 4/30/79
Update *: 24
Record Field
1
6
8
10
5
7
9
19
20
Description
Parameter Code
Method Code
Unit Code
Minimum Detectable
Decimal Position
Type
Numeric
Numeric
Numeric
Numeric (signed)
Numeric
Figure 5.5.4-a. Format of the Converted Parameter File
373
-------
AQDHS-II PARAMETER FILE COBOL TO FORTRAN CONVERSION PROGRAM • DIAGNOSTIC REPORT
PAGE
PROGRAM NAME! ACVPFOR (400030)
REVISION LEVELI 1-00
LAST UPDATE ffl 2U
DATt INCORPORATED: OCTOBER 31. l<>78
NUMBER OF FILE RECORDS READ! Ill
NUMHER OF FILE RECORDS WRITTEN: Hi
NUMI1ER OF ERRORS DETECTED: 0
CO
Figure 5.5.4-b. Diagnostic Report
2 O >
> > JO
Z — I O
i-. > o:
~o co
o i-«
r> i-i
i— i CO
o co
-o o co
^ o m
o oo o
CD O -H
5O I— I-H
s» o
3> en
o -n •
< O en
•
O
O
co
o
d TO T3
T3 »1> Ol
Q. — • IQ
O» rt) (0
e+ Oi
=«=
O)
o
Ol
no ro
co
o
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.4
COBOL TO FORTRAN
PROGRAM ACVPFOR (AQ0030)
Page 7
Release Date: 4/30/79
Update #: 24
//*
//*
//*
//*
//*
//*
//*
//*
//*
PROCEDURE NAMFl AQCVP10
REVISION LEVEL! 1-00
LAST UPDATE »l ?4
DATE INCORPnRATEDl OCTOBER 31,197fl
THIS PROCEDURE ALLOWS Tilt. USER TO CREATE A FORTRAN-
OF AUDHS-II PARAMETER HLE INFORMATION FOR INPUT TO
FORTRAN PROGRAMS
//*
//AQCVP10 PROC PROJECTa'CN,EPALMH.AOe7.CDH3.HO.AQ3',
// PROGRAMsACVPFOR,
// PARMFlLaAQPARMFL,
// PARMFURsAQFORPRM,
// UNITS3330,
// SERIALsCDHSPK,
// D1SP«'NEW,PASS,DELETE',
// SPCUNIT-TRK,
// SECNDRYsS,
// l)UT«A
//*
//SENTINEL EXEC PGMniPRfJGRAM,
// REGKINS60K,
// TIMEe(l,0)
//*
//* CONVERT PARAMETER FILE TO FORTRAN-COMPATIBLE FORMAT
//*
//STEPLIB DD DSNAME=&PROJECT..LOAD,
// VULUME«(PRIVATE,RETAIN),
// 1>ISP=(SHR,PASS)
// DD DSNAME=SY31,COBLIH,
// DlSPe(SHR,PASS)
//*
//* INPUT DATA SET - PARAMETER FILE
//*
//AOSPARMK DD DSNAMEa&PROJECT..DATA.&PAKMFIL,
// VOLUME=(PRIVATE,RETAIN),
// DISPs(SHR,PASS)
//* OUTPUT DATA SET - FORTRAN-COMPATIBLE PARAMTER FILE
//*
//A03PARMF DO UNIT=iUNIT,
// VOLUMES(PRIVATE,RETAIN,SERs&SEHIAL),
// DISP=(&01SP),
// SPACEs(K,SPCUNIT, (RPRIMARY, iSECNDRY ) ,RLSE),
// DSNAMF.3&PRUJECT..DATA.&PARMFOH
//*
//* OUTPUT DATA SET - MESSAGE LISTING
//*
//AQSPRINT DD SYSOUTa&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//SYSPRINT
//*
//3Y30UT
//*
//3Y3DBOUT
//*
//3Y3DTERM DD 3YSQUT»&OUT
//*
//3Y3UDUMP
//*
DD SYSOUT8&QUT
OD SYSOUTxJUUT
DD SYSOUT'&OUT
DD 3Y80UT-&OUT
U0000100
00000200
00000300
00000400
OOOOObOO
00000600
COMPATIBLE FILE00000700
USER-WRITTEN 00000800
00000900
00001000.
00001100
00001200
00001300
00001400
00001SOO
00001600
00001700
00001600
00001900
00002000
00002100
00002200
00002300
00002400
00002SOO
00002600
00002700
00002BOO
00002900
00003000
00003100
00003200
00003300
00003400
OOOOiSOO
00003600
00003700
00003600
00003900
00004000
00004100
00004200
00004300
00004400
00004500
OOOQ'4600
00004700
00004800
00004900
00005000
OOOOS100
00005200
OOOOS300
OOOOS400
0000r>500
00005600
00005700
OOOOS600
OOOOS900
00006000
00006100
00006200
00006300
00006400
00006500
Figure 5.5.4.C. Cataloged Procedure AQCVP10
375
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.4
COBOL TO FORTRAN
PROGRAM ACVPFOR (AQ0030)
Page 8
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROGRAM
PARMFIL
PARMFFL
UNIT
SERIAL
DISP
SPCUNIT
PRIMARY
SECONDRY
OUT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS'
ACVPFOR
AQPARMFL
AQFORPRM
3330
CDHSPK
'NEW,PASS,DELETE1
TRK
10
5
A
Description
Highest-level index of data set names
(e.g., the full data set name of the AQDHS-II
parameter file is 'CN.EPALMH.A087.CDHS.HQ.
AQS.DATA.HTPARMAA')
Parameter file COBOL to FORTRAN format
conversion program
Lowest-level index of AQDHS-II parameter
file
Lowest-level index of converted parameter
file
Unit type to which the converted parameter
file will be written
Volume ID to which the converted parameter
file will be written
Disposition of the converted parameter
file
Units in which space for the converted
parameter file is to be allocated
Primary space allocation for the converted
parameter file
Secondary space allocation for the
converted parameter file
SYSOUT class for all print files
Figure 5.5.4-d. Substitutable Parameters for AQCVP10
376
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 1
Release Date: 4/30/79
Update #: 24
5.5.5 ANOMALY SCREENING MASTER FILE CONVERSION PROGRAM - ACVANOM (AQ0040)
5.5.5.1 Description
ACVANOM (AQ0040) is the first of two programs used to screen the AQDHS-II
master file for readings that are anomalous and, therefore, potentially in
error. The anomaly screening report program, ARPANOM (AQ0320), must be executed
after ACVANOM (AQ0040) to complete the anomaly screening process.
Anomaly screening of the AQDHS-II master file is accomplished by subjecting
the readings in the file to various anomaly screening tests. Presently, only
non-null readings that fall into one of the categories listed in Figure 5.5.5-a
are screened for anomalies.
All non-null hourly readings which fall into one of the categories in
Figure 5.5.5-a are subjected to the gap test by ACVANOM (AQ0040). All other
anomaly screening tests are performed by ARPANOM (AQ0320). The gap test is
discussed below.
The gap test is a probabilistic approach to evaluating any gaps in the
frequency distribution of hourly data readings; it is performed on hourly
readings for an entire month. Before performing the gap test, readings for
ozone, total oxidants, sulfur dioxide, and nitrogen dioxide are converted to
parts per hundred million and readings for carbon monoxide are converted to
parts per million. The resulting values are truncated to integer values. A gap
of length k in these integer values is defined as k consecutive integers not
assumed by any of the values.
The probability of each gap is computed and the data is judged to contain
one or more anomalous readings if the probability of any gap is less than 0.01.
The probability of a gap of length k with n data points above the gap is e~nXk.
377
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 2
Release Date: 4/30/79
Update #: 24
This expression for the probability was derived assuming the exponential
frequency distribution as the underlying frequency distribution for the
readings. In the expression e-nXk, X is a constant assuming one of two values;
i.e., the gap test is performed twice, using two separate values of X. To test
for internal consistency of the data,
In (.5/.05)
A =
x - y
where x » the calculated 95th percentile of the data being tested
y • the calculated 50th percentile of the data being tested.
To test for consistency with expected values,
s
In (.5/.001)
X
x - y
where x • a value that the data should not exceed more than one time in a
thousand (i.e., an assumed 99.9th percentile). The values used are
75 parts per million for carbon monoxide, 100 parts per hundred
million for sulfur dioxide, 60 parts per hundred million for nitrogen
dioxide and 50 parts per hundred million for ozone and total
oxidants. These values were provided by the Monitoring and Data
Analysis Division, Office of Air Quality Planning and Standards,
Environmental Protection Agency.
y • the calculated 50th percentile of the data being tested.
When using the first x value, the gap test should identify readings that differ
grossly from other readings 1n the month. When using the second x value, the
gap test should Identify months of readings that, as a whole, differ grossly
378
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 3
Release Date: 4/30/79
Update #: 24
from expected values (for example, months in which all decimal point indicators
are incorrect).
5.5.5.2 File Formats
ACVANOM (AQ0040) uses three input files: the AQDHS-II master file, the
AQDHS-II parameter file, and an option card. See Figure 4.5.3-a for the
master file format, Figure 4.2.2-c for the parameter file format and Section
5.5.5.3 for a discussion of the option card.
There are three output files produced by ACVANOM (AQ0040): a new AQDHS-II
master file, a temporary file of readings to be screened, and a diagnostic
report.
The output master file differs from the input master file only in the
values of the status flags for the records and individual readings. Figure
5.5.5-b details the status flags for records and Figure 5.5.5-c details the
status flags for readings. It should be noted that only non-null readings
which fall into one of the categories listed in Figure 5.5.5-a are subjected to
the anomaly screening tests. Any reading that is null (9999 or 9998) or does
not fall into one of those categories will never be screened or be flagged as
having undergone anomaly screening. Additionally, three previous months of
daily readings are needed as a basis for screening a given month of daily data.
Thus the first three months of daily readings for a given site key and
parameter key will not be flagged on the new master file as having undergone
anomaly screening.
The status flags enable the anomaly screening programs, ACVANOM (AQ0040)
and ARPANOM (AQ0320), to perform the anomaly screening tests only on data that
has not been previously screened. Tests that involve more than one reading
(for example, the gap test which is based on a month of hourly readings) will
be performed if any reading in the appropriate group of data has not undergone
anomaly screening. Data that undergoes anomaly screening will not be subjected
to the anomaly screening tests during subsequent executions of ACVANOM (AQ0040)
379
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 4
Release Date: 4/30/79
Update #: 24
and ARPANOM (AQ0320). The record status flag Increases efficiency since
ACVANOM (AQ0040) can bypass or process a master file record based upon
the value of the record status flag. ACVANOM (AQ0040) 1s one of three AQDHS-II
programs that affect the status flags, the other two being the AQDHS-II master
file maintenance program, AFMMSTR (AQ0100), and the AQDHS-II to SAROAD
conversion program, ARPSARD (AQ0220).
The temporary file produced by ACVANOM (AQ0040) 1s passed to ARPANOM
(AQ0320). Since ARPANOM (AQ0320) 1s coded 1n FORTRAN, this file 1s
FORTRAN-compatlble. It consists of fixed-length records of 115 characters and
contains readings from the master file which satisfy the following criteria:
(1) they fall Into one of the categories listed 1n Figure 5*5.5-a; (2) they are
contained 1n master file records having one or more non-null readings that have
not been previously screened; (3) for dally readings, there are at least three
previous months of readings with the same site and parameter keys; and (4) they
are contained 1n master file records having one or more non-null readings that
exceed the nominal values listed 1n Figure 5.5.5-d. (When the FLAG LOW option
1s specified, the last criterion 1s waived for dally readings.) The readings
in this temporary file are expressed 1n both their original format and (for
non-null readings) in the standard units specified on the parameter file. The
file also contains certain statistics (see Section 6.4.3.1, Shewhart Test) used
by ARPANOM (AQ0320) in screening daily readings, as well as record-key
Information for each month of hourly readings which falls the gap test.
The diagnostic report consists of update messages, program statistics, and
error messages. It also lists the option in effect. See Figure 5.5.5-e for a
sample printout and Section 5.5.5.4 for a listing of the error messages.
5.5.5.3 Options
ACVANOM (AQ0040) has two options - FLAG LOW and NO FLAG LOW. These
options control the selection of daily data to be included in the temporary
380
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 5
Release Date: 4/30/79
Update #: 24
file produced by ACVANOM (AQ0040). When the NO FLAG LOW option 1s 1n effect,
dally data must satisfy only the four criteria listed 1n Section 5.5.5.2; when
the FLAG LOW option 1s 1n effect, dally data must satisfy only the first three
criteria. Furthermore, when the NO FLAG LOW option 1s 1n effect, the Shewhart
test performed by ARPANOM (AQ0320) can Identify only unusually high dally data,
whereas unusually high or low dally data can be Identified when the FLAG LOW
option 1s 1n effect.
The FLAG LOW option 1s specified by entering FLAG LOW on the option
card; NO FLAG LOW 1s specified by entering NO FLAG LOW. See Figure 5.5.5-f
for the format of the option card. NO FLAG LOW 1s the default option whenever
no option card or a blank option card 1s entered.
5.5.5.4 Error Messages
ACVANOM 001 CONDITIONAL - NO INPUT RECORDS
Meaning: The Input master file contains no records.
Action: Verify that the correct file was Input.
ACVANOM 002 ABORT - PARAMETER TABLE OVERFLOW
Meaning: The number of parameter file records in the parameter file for
pollutants that fall into the categories in Figure 5.5.5-a is
greater than the maximum allowed.
Action: See Appendix C for instructions on increasing the allowed size.
ACVANOM 003 ABORT - NUMBER OF PARAMETER CODE RECORDS EXCEEDS MAXIMUM ALLOWED
Meaning: ACVANOM (AQ0040) attempted to enter more parameter file records
than the parameter table can hold.
Action: See Appendix C for instructions on increasing the allowed size
of the parameter file.
381
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 61
Release Date: 4/30/79
Update t: 24
ACVANOM 004 ABORT - NO MATCH FOUND ON PARAMETER FILE FOR ZZZZZZZZZ
Meaning: A record was found in the master file containing parameter-
method-unit key ZZZZZZZZZ, but no record was found in the
parameter file for this parameter-method-unit key.
Action: Verify that the correct input files were used. If the master
file is in error, correct using programs AEDMSTR (AQ0060),
ASRINTR (AQ0130), and AFMMSTR (AQ0100). If the parameter file
is in error, correct using programs ASRPARM (AQ0150) and
AEMPARM (AQ0070). After appropriate corrections have been
made, re-execute ACVANOM (AQ0040).
ACVANOM 005 ABORT - INVALID OPTION SPECIFIED
Meaning: The option on the option card is invalid.
Action: Correct or delete the option card. Re-execute ACVANOM
(AQ0040).
ACVANOM 006 CONDITIONAL - STD UNITS CONV FAC OF ZERO ENCOUNTERED, SCREENING
NOT PERFORMED (XXXXXXXXXXXXX-YYYYYY-ZZZZZZZZZ)
Meaning: A zero standard units conversion factor was found in the
parameter file for parameter-method-unit key ZZZZZZZZZ; the
master file record containing readings for this parameter-
method-unit key was bypassed. (XXXXXXXXXXXXX is the state-
area-site-agency-project-time codes and YYYYYY is the year-
month-day of the bypassed master file record.)
Action: Modify the parameter file using programs ASRPARM (AQ0150) and
AEMPARM (AQ0070) to enter a non-zero standard units conversion
factor for parameter-method-unit key ZZZZZZZZZ. Re-execute
ACVANOM (AQ0040).
382
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 7
Release Date: 4/30/79
Update #: 24
ACVANOM 007 CONDITIONAL - READING(S) > 9999.9999 IN STD UNITS, SCREENING NOT
PERFORMED (XXXXXXXXXXXXX-YYYYYY-ZZZZZZZZZ)
Meaning: One or more readings in the master file record exceed 9999.9999
when converted to standard units (XXXXXXXXXXXXX is the state-
area-site-agency-project-time codes, YYYYYY is the year-month-day
and ZZZZZZZZZ is the parameter-method-unit key). This record is
bypassed.
Action: Examine the readings in this record to insure that all are
correct. Any readings found to be in error should be corrected
using AEDMSTR (AQ0060), ASRINTR (AQ0130), and AFMMSTR (AQ0100).
5.5.5.5 Cataloged JCL
ARPANOM (AQ0320) should always be executed in conjunction with ACVANOM
(AQ0040). See Section 6.4.3.5 for a discussion of the cataloged procedure
AQRPM45, which executes both programs.
5.5.5.6 Warnings and Special Instructions
To screen the AQDHS-II master file, both ACVANOM (AQ0040) and ARPANOM
(AQ0320) must be executed successfully.
All readings subjected to anomaly screening tests are converted to standard
units by using the appropriate standard units conversion factor from the
AQDHS-II parameter file. Thus it is imperative that the standard units
conversion factors on the parameter file are correct. Execution of ARPPARM
(AQ0240) will permit verification of entries in the parameter file.
Records causing error 'ACVANOM 006' or 'ACVANOM 007' are not subjected to,
nor included in, any anomaly screening tests.
383
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 8
Release Date: 4/30/79
Update #: 24
Any readings identified in the reports from ARPANOM (AQ0320) as being
anomalous should be verified. Any readings found to be in error should be
corrected using AEDMSTR (AQ0060), ASRINTR (AQ0130), and AFMMSTR (AQ0100). The
skeleton transactions created by ARPANOM (AQ0320) may be used to create the
necessary master file transactions. The user is cautioned to save all printed
anomaly screening reports until all anomalous data has been checked and verified
.or changed. If anomalous data has been verified, it is recommended that this
verification be forwarded to the user's Regional Office when this data is
submitted to SAROAD.
When ACVANOM (AQ0040) is executed, the reading and record status flags in
the master file are appropriately changed to indicate which readings have been
screened. Data that has been screened will not be subjected to anomaly
screening again. However, if a screened reading is subsequently changed using
AEDMSTR (AQ0060), ASRINTR (AQ0130), and AFMMSTR (AQ0100) then both the reading
status flag and the record status flag are reset and the changed reading is
screened during the next execution of ACVANOM (AQ0040) and ARPANOM (AQ0320).
No reading in the master file is changed or deleted by the anomaly
screening programs. The user bears the sole responsibility of changing any
values found to be in error.
The anomaly screening tests are applied only to non-null readings which
fall into one of the categories listed in Figure 5.5.5-a. Other readings are
not subjected to anomaly screening tests. Furthermore, the anomaly screening
programs cannot be expected to identify all erroneous readings among those
categories since a reading can be in error without being judged anomalous.
Thus, one cannot assume that readings that pass the anomaly screening tests are
valid. The anomaly screening programs are only tools to improve the quality
of data in the AQDHS-II master file.
384
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 9
Release Date: 4/30/79
Update #: 24
The FLAG LOW option is not recommended for ordinary use for two reasons.
First, the major concern in air quality data is valid high readings which exceed
the standards. The FLAG LOW option identifies readings that are classified
anomalous even though they may be considerably below the standards. Secondly,
the FLAG LOW option may identify a large quantity of readings as being
anomalous.
There is no distinction between low and high Shewhart test failures in the
anamoly screening report for daily data.
5.5.5.7 Cost Considerations
The following estimates are for the execution of ACVANOM (AQ0040) on an IBM
370/168:
Size of AQDHS-II master file:
Size of output file written
to ARPANOM (AQ0320):
CPU time:
I/O time:
Total time:
8479 records
978 records
1 minute 35.5 seconds
25.7 seconds
2 minutes 1.2 seconds
Estimated cost:
$18.36
5.5.5.8 Related Programs and Procedures
ACVANOM (AQ0040) should always be executed in conjunction with ARPANOM
(AQ0320). The cataloged procedure AQRPM45 will execute both programs.
385
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 10
Release Date: 4/30/79
Update #: 24
Pollutant
Sampling
Interval
Parameter
Code
AQDHS-II
Time Code
Total Suspended Particulate
Carbon Monoxide
Sulfur Dioxide
Sulfur Dioxide
Nitrogen Dioxide
Nitrogen Dioxide
Total Oxidants
Ozone
Daily
Hourly
Hourly
Daily
Hourly
Daily
Hourly
Hourly
11101
42101
42401
42401
42602
42602
44101
44201
8
1
1
8
1
8
1
1
Figure 5.5.5-a. Categories of Data Subjected to Anomaly Screening Tests
386
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 11
Release Date: 4/30/79
Update #: 24
Record Status Flags
One or more non-null
readings in the record
have not undergone
anomaly screening
All non-null readings
in the record have
undergone anomaly
screening
All readings in the
record have been
submitted to SAROAD
and one or more readings
are non-null
One or more readings
in the record have
not been submitted
to SAROAD and one or
more readings are non-null
All readings are null
Figure 5.5.5-b. Status Flags for Records, AQDHS-II Master File
387
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 12
Release Date: 4/30/79
Update #: . 24
Reading Status Flags
Reading has not
undergone
anomaly screening
Reading has undergone
anomaly screening
Reading has been added, not
submitted to SAROAD
Reading has been changed,
not submitted to SAROAD
Reading has been submitted
to SAROAD
Figure 5.5.5-c. Status Flags for Readings, AQDHS-II Master File
388
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 13
Release Date: 4/30/79
Update #: 24
Pollutant
Total Suspended Partlculate
Carbon Monoxide
Sulfur Dioxide
Sulfur Dioxide
Nitrogen Dioxide
Nitrogen Dioxide
Total Oxldants
Ozone
Parameter Code Sampling Interval
11101
42101
42401
42401
42602
42602
44101
44201
Dally
Hourly
Hourly
Dally
Hourly
Dally
Hourly
Hourly
Value
260 yg/m3
20 mg/m3
650 yg/m3
365 yg/m3
225 yg/m3
100 yg/m3
100 yg/m3
100 yg/m3
Figure 5.5.5-d.
Nominal Values for Categories of Data to be
Screened for Anomalies
389
-------
AQDHS-H ANOMALY SCREENING MASTER FILE CONVERSION PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ACVANOM (AQ0040)
REVISION LEVELS 1-00
LAST UPDATE VI 21
INCORPORATED: OCTOBfcR 31, 1978
OPTION IN EFFECT: LOW SHEWHAP.T TfcST
*»* ACVANOM 007 CONDITIONAL - READING(S) > 9999.9999 IN STD UNITS, SCREENING NOT PERFORMED (3400020010051-760303-42*1011«07)
NUMBER OF MASTER FILE RECORDS READ:
NUMBER OF MASTER FILE RECORDS WRITTEN;
NUMBER OF MASTER FILE RECORDS CONTAINING DATA TO RE SCREENED!
NUMBER UF RECORDS PASSED TO PROGRAM ARPANOMi
NUMBER OF ABORT MESSAGES:
NUMBER OF CONDITIONAL MESSAGES:
341
311
62
146
0
1
CO
10
O
Figure 5.5.5-e. Diagnostic Report
> > JO
Z -H O
i-t 3> :r
•o co
C > I
r~ o •—<
> O I-"
—I m
i—i CO
o oo
o
-o :> co
73 z m
O O O
£D 3 —I
3> Co on
O O •
< JO cn
3» m •
z m en
O z
c: TO
-a n>
Q. —•
01 n>
rt O)
n> w>
=«:
•• O
DJ
o>
n>
co
o
VO
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.5
ANOMALY SCREENING
PROGRAM ACVANOM (AQ0040)
Page 15
Release Date: 4/30/79
Update #: 24
Column Column
#1 #8
V
_y
FLAG LOW
Column
#1
V
Column
#11
V
NO FLAG LOW
Figure 5.5.5-f. Format for the Option Card for ACVANOM (AQ0040)
391
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 1
Release Date: 4/30/79
Update #: 24
5.5.6 UNITS CODE CONVERSION PROGRAM - ACVUNIT (AQ0050)
5.5.6.1 Description
The units code conversion program ACVUNIT (AQ0050) allows the user the
option of producing reports in the same units as the EPA standards or in units
of his own choosing. The program reads each AQDHS-II master file record (or
an answer file in master file format) and creates a new master file record,
changing the units code field to the optional code specified. Each data
reading in the record is then converted to the new units using the conversion
factor stored in the parameter file.
If no record appears in the parameter file for a given parameter code in
the master file, or if no conversion factor is present in the parameter file,
an error message will be printed and no conversion will take place.
Any of the reports in the AQDHS-II system can be run on a converted
master or answer file. However, the converted file should be sorted before
running the reports since changing the units code has changed a sort-key field
(see Section 5.6.2 Master File Sorter).
5.5.6.2 File Formats
There are three input files to ACVUNIT (AQ0050). The first is an option
card (see Figure 5.5.6-a). This card allows the user to specify which type of
units code conversion he wants performed: STD or USER. The STD option
indicates that the EPA standard units for that parameter/method code
combination will appear in the new master file. The USER option indicates
that units specified by the user in the parameter file will appear in the
new master file. The second input file is the parameter file (see Figure
392
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 2
Release Date: 4/30/79
Update #: . 24
4.2.2-c for the file format). This file should contain units code and
conversion factor information for all parameter/method/units code combinations
on the master file. The third input file is the AQDHS-II master file (see
Figure 4.5.3-a for the file format) or an answer file obtained by running a
retrieval. This input master or answer file is not altered by ACVUNIT
(AQ0050); a separate, converted file is produced.
There are two output files produced by ACVUNIT (AQ0050). The first is an
answer file in master file format (see Figure 4.5.3-a) which contains data
values converted to the specified units. This file may be out of sequence
since the units code field (a sort-key field) has been changed. The master
file sort program ASRMSTR (AQ0140) can be run on this answer file to generate
a file in correct sort order (see Section 5.6.2). The second output file is a
diagnostic report (see Figure 5.5.6-b).
5.5.6.3 Options
The user enters an option card to determine which units code will be used
for the conversion. There are two options (see Figure 5.5.6-a): STD or USER.
The STD option denotes that the EPA standard units code will be used for each
parameter/method code combination. The USER option specifies that a user-
chosen units code will be used.
For both options, the units code and conversion factor information for a
given parameter/method code must be present on the parameter file before an
actual conversion is made. If the information is not present, an error
message will be printed and no conversion will be made. If you choose the
USER option, it is your responsibility to supply the conversion factor in
the parameter file.
If no option card is entered, or if the option is invalid, the default
value of STD will be used.
393
-------
AODHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 3
Release Date: 4/30/79
Update #: 24
5.5.6.4 Error Messages
ACVUNIT 001 ABORT - PARAMETER TABLE OVERFLOWED
Meaning: The input parameter file contains too many entries for the
parameter table size which is set at 200. Therefore, the run
was terminated.
Action: If this set size is too small, increase the size as necessary
See Appendix C for instructions on increasing the allowed
table size.
ACVUNIT 002 CONDITIONAL - NO OPTION CARD - DEFAULT OF STANDARD USED
Meaning: Although no option card was input, the program was
executed using the 'STD' option.
Action: If the 'USER1 option is desired, enter USER on the option card
and resubmit the Job.
ACVUNIT 003 CONDITIONAL - INVALID OPTION CARD - DEFAULT OF STANDARD USED
Meaning: Although an invalid option card was input, the program was
executed using the 'STD1 option.
Action: If the 'USER' option is desired, enter USER on the option card
and resubmit the job.
ACVUNIT 004 CONDITIONAL - CONVERTED DATA FIELD TOO LARGE - RESULT IS INVALID
Meaning: The data value calculated was greater than 9999. A value of
9999 will appear in the output answer file.
Action: The user may want to specify a different units code and
conversion factor in the parameter file.
ACVUNIT 005 CONDITIONAL - CONVERTED DATA FIELD TOO SMALL - RESULT IS INVALID
Meaning: The data value calculated was smaller than 0.0001. A value of
zero will appear in the output answer file.
Action: The user may want to specify a different units code and
conversion factor in the parameter file.
394
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 4
Release Date: 4/30/79
Update #: 24
ACVUNIT 006 ABORT - LEVEL 77 DATA FIELD "NBR-OF-PARMS" INCREASED BEYOND
PARM TABLE SIZE
Meaning: The program has been incorrectly modified to increase the
parameter table. Therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
ACVUNIT 007 ABORT - BAD-PARAMETER TABLE OVERFLOWED
Meaning: The table of parameters which are not found on the parameter
file has exceeded its capacity.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
ACVUNIT 008 ABORT - LEVEL 77 DATA FIELD "TABLE-MAX" INCREASED BEYOND
BAD-PARM-TABLE SIZE
Meaning: The program has been incorrectly modified to increase the
missing parameters table. Therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
Two special error messages may be printed at the end of the program.
Each message will be printed along with a listing of the parameters to which
it refers.
ACVUNIT 009 THE FOLLOWING PARAMETER/METHOD/UNIT CODE COMBINATIONS WERE NOT ON
THE PARAMETER FILE
Meaning: The parameter/method/unit code combinations listed were on the
master file but were not on the parameter file used. No
conversion was made for these codes.
Action: If necessary, update the parameter file to include the listed
parameter/method/unit code combinations, then resubmit the
job.
395
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 5
Release Date: 4/30/79
Update #: 24
ACVUNIT 010 THE FOLLOWING PARAMETER/METHOD/UNIT CODE COMBINATIONS HAD NO
CONVERSION FACTOR ON THE PARAMETER FILE
Meaning: The parameter/method/unit code combinations listed were on the
master file but did not have a conversion factor on the
parameter file used. No conversion was made for these codes.
Action: If necessary, update the parameter file to include
conversion factors for the listed parameter/method/unit code
combinations, then resubmit the job.
5.5.6.5 Cataloged JCL
5.5.6.5.1 JCL listing - ACVUNIT (AQ0050) may be run by executing the
cataloged procedure AQCVM20. See Figure 5.5.6-c for a listing of this
procedure.
5.5.6.5.2 Cross-reference of DD names and files
Program Name: ACVUNIT (AQ0050)
DD Name File Description
AQSMASTR
AQSPARMK
AQSOPTIN
AQSANSWR
AQSPRINT
AQDHS-II master file
Parameter file
Option card
Answer file in master file format
Diagnostic report
Input/Output
Input
Input
Input
Output
Output
5.5.6.5.3 User-supplied JCL - The user must specify the data set names of the
input master (or answer) file, the input parameter file, and the output answer
file. Additionally, the user should include an option card to specify the
type of conversion he wants performed - STD or USER. See Figure 5.5.6-d for
a description of the procedure's substitutable parameters.
396
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 6
Release Date: 4/30/79
Update #: 24
5.5.6.5.4 Sample run stream -The run stream listed below 1s from the baseline
test run series. It performs a USER conversion of the AQDHS-II master file
'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQFINAL1, using the parameter file
'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.PARM1, and cataloging the answer file under
the name 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.CONVMF1. Sample output from this
test run is shown in Figure 5.5.6-b.
// EXEC AQCVM20,
// MSTRFIL=AQFINAL,
// ANSWRFL=CONVMF,
// PARMKFL=PARM
//CONV.OPTIONS DD *
USER
/*
5.5.6.6 Warnings and Special Instructions
Prior to running ACVUNIT (AQ0050), the user should insure that his
parameter file contains all necessary parameter/method/unit code combinations
and conversion factors. The contents of the parameter file can be seen by
executing the parameter file detailed report program ARPPARM (AQ0240) (see
Section 6.2.4).
ACVUNIT (AQ0050) attempts to convert all readings on the master file. If
reports are needed in special units only for certain parameters, records for
those parameters should be retrieved from the master file and the units code
conversion run on that answer file.
The converted answer file may be out of order since the units code field
(a sort-key field) has been changed. The master file sort program ASRMSTR
(AQ0140) should be run after running the units code conversion if file order
is important for the desired report (see Section 5.6.2).
397
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 7
Release Date: 4/30/79
Update #: 24
5.5.6.7 Cost Considerations
The following estimates are for the execution of ACVUNIT (AQ0050) on an
IBM 370/168:
Number of master file records: 13 records
Number of readings converted: 98 readings
Number of readings not converted: 6 readings
CPU time: .2 seconds
I/O time: 3.4 seconds
Total time: 3.6 seconds
Estimated cost: $1.07
On an IBM-370 computer, the cost ranged from $.84 to $1.68 for a file
with 114 records (700 readings). The cost differential was due to the number
of errors encountered (1 at the low end, 215 at the upper end).
Obviously, the cost of converting a file increases with the size of the
file. Therefore, do not convert the entire master file unless absolutely
necessary. Instead, retrieve those records which must be converted (see
Section 5.2 Retrieval) and run the units code conversion on that answer file.
This will reduce the cost of both the conversion and the subsequent report.
398
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 8
Release Date: 4/30/79
Update #: . 24
Column
#1
V
STD
or
Column
#1
USER
The option specified must be punched beginning 1n Column #1 with no spaces
between the letters.
Figure 5.5.6-a. Option Card Format
399
-------
AUOHS-II UNITS CODE CONVERSION PROGRAM - DIAGNOSTIC RFPORf
PAGE
PROGRAM NAMLl ACVUNIT (A00050)
REVISION LEVEL: 1-00
LAST UPDATE Hi 278
OPTION IS UStR
NUMBER OF INPUT RECORDS:
NUMBER OF OUTPUT RECORDS:
NUMBER OF ERRORS DETECTED:
NUMBER OF READINGS CONVERTED:
NUMBER OF READINGS TOD LARGE:
NUMBER OF READINGS TOO SMALL:
NUMBER OF RECORDS WITH READINGS CONVERTED:
NUMBER OF RECORDS »UTH READINGS TOO LARGE:
NUMBER OF RECORDS WITH READINGS TOO SMALL:
Si
22
0
U4
0
0
22
0
0
o
o
Figure 5.5.6-b. Diagnostic Report
o >
—I O
J> IE
CO
O t-i
o •—
m
co
CO
£T>
-o c oo
XJ z m
O •— i O
O — I — I
50 CO •-«
> o
202
o
;> o en
m •
01
o •
o 01
o
<
m
*-* -yo
3> CO
XD •-•
O O
O -Z.
in
o
•o
CL
a>
rt
fl>
K
n>
to
o>
ft)
o
o>
rt
co
o
VO
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 10
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME: AOCVM20
REVISION LEVEL: i-oo
LAST UPDATE «: 20
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO CONVERT ALL READINGS IN AN
AQDHS-II MASTER FILE TO STANDARD OR USER DEFINES UNITS
//*
//*
//*
//*
//*
//*
//»
//*
//*
//*
//AQCVM20 PROC PRUJECT='CN.EPALMH.A087.CDHS.HQ.AQS',
// PROGRAMrACVUNIT,
// MSTRFIL=AQMASTER,
// ANSWRFL=AQMSTUCV,
// PARMFIL=AQPARMFL,
// UNIT=3330,
// SERIAL=CDHSPK,
// DISP='NEW,CATLG,DELETE',
// SPCUNIT=TRK,
// PRIMARY=20,
// SECNDRY=10,
// ()UT = A
//*
//CONV EXEC PGMs&PROGRAM,
// TIME=(1,0)
//*
//* CONVERTS DATA FROM MASTER FILE TO SPECIFIED UNITS
//*
//STEPLIB DD DSNAME=&PROJECT..LOAD,
// VOLUME*(PR1VATE,RETAIN),
// DlSPa(SHR,PASS)
//*
//* INPUT DATA SET - AQDHS-II MASTER FILE
//*
//AQSMASTR DD OSNAME=RPROJECT..DATA.&MSTRFIL,
// VOLUME=(PRIVA'TE, RETAIN),
// DISP=(SKR,PASS)
//*
//* INPUT DATA SET - PARAMETER CODE FILE
//*
//AOSPARMK DD DSNAME=&PROJECT..DATA.&PARMFIL,
// VOLUME=(PRIVAT£,RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - OPTION CARD
//*
//AOSINPUT DD DDNAMEsOPTIUNS,
// DCB=BLKSIZE=flO
//*
//» OUTPUT DATA SET - ANSWER FILE WITH CONVERTED DATA VALUES
//*
//AOSANSWR DD OSNAME = &PROJECT . .DATA.8.ANSWRFL,
// VOLUME=(PRIVATE,HETA1N,SLR=KSERIAL),
// SPACE=(&SPCUN1T,(&PRIMARY,&SFCMDRY))
//*
//* OUTPUT DATA StT - DIAGNOSTIC MESSAGES
00000100
00000200
00000300
00000000
00000500
00000600
00000700
ooooonoo
00000900
00001000
00001100
00001200
00001300
00001000
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002000
00002500
00002600
00002700
00002HOO
00002900
00003000
00003100
00003200
00003300
00003000
00003500
00003600
00003700
00003800
00003900
00000000
00000100
00000200
00000.400
oooooaoo
00000500
00000600
00000700
OOOOOHOO
00000900
00005000
00005100
00005200
00005300
00005000
00005500
00005600
00005700
00005800
(page 1 of 2)
Figure 5.5.6-c. Cataloged Procedure AQCVM20
401
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 11
Release Date: 4/30/79
Update #: 24
//*
//AQSPRINT DO SYSOUTs&UUT
//*
//* OUTPUT DATA SET - SYSTEM OPERATIONS
//*
//SYSPRINT DO SYSUUTs&OUT
//*
//SYSOUT DO SYSUUTs&OUT
//*
//SYSDBOUT DO SYSOUTa&OUT
//SYSUDUMP DO SYSOUTsiOUT
//*
//SYSDTERM DD SYSOUT=iOUT
//*
00005900
00006000
00006100
00006200
00006300
00006400
00006SOO
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
(page 2 of 2)
Figure 5.5.6-c - continued. Cataloged Procedure AQCVM20
402
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.5.6
UNITS CODE CONVERSION
PROGRAM ACVUNIT (AQ0050)
Page 12
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS'
PROGRAM
MSTRFIL
ANSWRFL
PARMKFL
UNIT
ACVUNIT
AQMASTER
AQMSTUCV
AQPARMFL
3330
SERIAL CDHSPK
DISP 'NEW,CATLG,DELETE1
SPCUNIT TRK
PRIMARY 20
SECNDRY 10
OUT A
Description
Highest-level index of data set names (e.g.
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQMASTER
would be the full data set name of the
AQDHS-II master file)
Units code conversion program
Lowest-level index of master file
Lowest-level index of answer file
Lowest-level index of parameter file
Unit type to which answer file is to
be written
Volume serial number of volume to which
answer file is to be written
Disposition of answer file
Units in which space for answer file is to
be allocated
Primary space allocation for answer file
Secondary space allocation for answer file
SYSOUT class for all print files
Figure 5.5.6-d. Substitutable Parameters for AQCVM20
403
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.1
MASTER FILE SORTING
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: . 24
5.6 MASTER FILE SORTING
5.6.1 INTRODUCTION
The master file maintenance program, AFMMSTR (AQ0100), produces a master
file in the standard sort sequence (i.e. the records are ordered by the master
file sequence key shown in figure 4.5.3-a). Also, any answer file produced
from a master file by a non-batched retrieval is in master file standard sort
sequence. However, some AQDHS-II reports require that the input master file
be sorted in an order other than the standard sort sequence. The master file
sort program, ASRMSTR (AQ0140), allows the user to sort the master file or
answer file into the sort sequences required to produce the statistical
analysis report, the inventory by site report, and the inventory by pollutant
report.
Answer files produced by batched retrievals are not sorted by the
retrieval programs. ASRMSTR (AQ0140) allows the user to sort an answer file
by batch number, i.e., to group together the records selected by each of the
batched retrievals. Furthermore, the user may sort the answer file from
batched retrievals so that records selected by each of the batched retrievals
are sorted into the order required to produce the statistical analysis report,
the inventory by site report, or the inventory by pollutant report.
Only a master file in the standard sort sequence may be used as input to
the master file maintenance program, AFMMSTR (AQ0100). When a master file is
sorted into any order other than the standard sort sequence by ASRMSTR
(AQ0140), the input master file (in standard sort sequence) should be
retained. Thus, it should never be necessary to sort the master file into the
standard sort sequence. However, ASRMSTR (AQ0140) does enable the user to
sort the master file or any answer file into the standard sort sequence. This
capability allows the user to restore a master file to the standard sort
404
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.1
MASTER FILE SORTING
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
se.quence. For example, an answer file created by ACVUNIT (AQ0050), the units
code conversion program, can be restored to standard sort sequence.
The master file sort flowchart is shown in Figure 5.6.1-a. ASRMSTR
(AQ0140) sorts the input master or answer file according to the order
specified on the option card. A diagnostic report is produced.
A detailed discussion of ASRMSTR (AQ0140) is presented in section 5.6.2.
ASRMSTR (AQ0140) may be executed using the cataloged procedure AQSRM10,
which is discussed in Section 5.6.2.5. A sample job stream for sorting a
master file is shown in Section 5.6.2.5.4. A sample job stream in which an
answer file from batched retrievals is sorted is shown in section 7.2.7. It
should be noted that AQRPM35, the cataloged procedure for producing the
inventory by site report, and AQRPM40, the cataloged procedure for producing
the inventory by pollutant report, contain steps to sort the input master or
answer file, since sorting is always required before producing the inventory
by site or inventory by pollutant report. However, AQRPM10, the cataloged
procedure for producing the statistical analysis report, does not include a
step for sorting the input master or answer file , as sorting is not always
required before producing the statistical analysis report. Sample run streams
for producing the inventory by site, inventory by pollutant, and statistical
analysis reports are shown in Sections 6.4.4.5.4, 6.4.5.5.4, and 6.4.2.5.4,
respectively.
405
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.1
MASTER FILE SORTING
INTRODUCTION
Page 3
Release Date: 4/30/79
Update #: 24
AQDHS-II
MASTER FILE OR
ANSWER FILE
OPTION CARD
ASRMSTR (AQ0140)
MASTER FILE SORT PROGRAM
/ SORTED AQDHS-II
MASTER FILE OR
V ANSWER FILE
DIAGNOSTIC
REPORT
Figure 5.6.1-a. Master File Sort Flowchart
406
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 1
Release Date: 4/30/79
Update #: 24
5.6.2 MASTER FILE SORT PROGRAM - ASRMSTR (AQ0140)
5.6.2.1 Description
ASRMSTR (AQ0140) sorts an AQDHS-II master or answer file into the various
sequences required by the AQDHS-II report programs. A master or answer file
must be sorted prior to the execution of the following programs: the
preliminary statistics program, ASTPRLM (AQ0190), the inventory by site report
program, ARPINVS (AQ0280); and the inventory by pollutant report program
ARPINVP (AQ00290). ASTPRLM (AQ0190) and ARPINVS (AQ0280) require that the
master or answer file be sorted by site code; however, ARPINVP (AQ0290)
requires that the file be sorted by parameter code. Also, batched retrieval
answer files must be sorted prior to being input to any of the report
programs. In addition to these sorts, ASRMSTR (AQ0140) can sort an out-of-
sequence master or answer file into the standard master file sequence.
5.6.2.2 File Formats
Input to ASRMSTR (AQ0140) consists of an AQDHS-II master or answer file
and an option card. See Figure 4.5.3-a for the format of the master file.
For a detailed description of the option card, refer to Section 5.6.2.3.
Output from this program consists of the sorted AQDHS-II master or answer
file and a diagnostic report. The format for the output master or answer file
is the same as that of the input file; however, the sequence of the file
records may have been changed. The various sequences into which the master
file may be sorted are described in detail in the next section. An example of
the diagnostic report is shown in Figure 5.6.2-a.
407
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 2
Release Date: 4/30/79
Update #: 24
5.6.2.3 Options
The options specify the sequence into which the -the master or answer file
is to be sorted. The option card has two fields, which are represented in
Figure 5.6.2-b as '[one]' and '[two]'. By entering BATCH in the first field
(i.e., card columns 1 through 5), the BATCH option can be specified to sort
the master or answer file into the sequence shown in Figure 5.6.2-c. This
option is used to sort batched retrieval answer files; the field should be
left blank for other types of input files.
In the second field (i.e., card columns 7 through 10), PARM, SITE, STAT,
or STND can be entered. Also, the field could be left blank. The PARM
option sorts the master or answer file by parameter code into the sequence
shown in Figure 5.6.2-d, whereas the SITE and STAT options sort the master or
answer file by site code. The sort sequence for the SITE and STAT options is
shown in Figure 5.6.2-e. The STND option sorts the file into the standard
master file sequence; i.e., the sequence created by the master file
maintenance program, AFMMSTR (AQ0100). Figure 5.6.2-f shows the sort
sequence for the STND option.
Any of the four second-field options may be used in conjunction with the
BATCH option or by themselves. The result of combining the BATCH option with
either the PARM, SITE, STAT, or STND option is the addition of one field, the
batch retrieval code (see Figure 5.6.2-c), at the top of the respective sort
sequence. This ability to combine the two types of options allows the user to
'separate' the batched retrieval answer files while sorting them into the
sequence required for a particular report.
If no option card is entered, the default of STND is assumed. The run
will be aborted if an invalid word appears in either of the option fields or
if both fields are blank. That is, a blank option card will be considered
invalid and cause the run to abort.
408
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 3
Release Date: 4/30/79
Update #: 24
5.6.2.4 Error Messages
ASRMSTR 001 ABORT - INVALID OPTION SPECIFIED
Meaning: Either an invalid option word is contained in columns 1 through
5 or 7 through 10 of the option card, or both fields are blank.
Therefore, the run was terminated.
Action: Correct the option card and resubmit the job.
5.6.2.5 Cataloged JCL
5.6.2.5.1 JCL listing - ASRMSTR (AQ0140) is executed by the cataloged
procedure AQSRM10. See Figure 5.6.2-g for a listing of this procedure.
5.6.2.5.2 Cross-reference of DD names and files
Program Name: ASRMSTR (AQ0140)
DD Name
File Description
Input/Output
AQSINPUT AQDHS-II master file
AQSOPTIN Option card
SORTWK01 Sort work file
AQSOUTPT Sorted AQDHS-II master file
AQSPRINT Diagnostic report
Input
Input
Internal
Output
Output
5.6.2.5.3 User-supplied JCL -To execute the cataloged procedure AQSRM10, the
user must supply the job accounting information and the data set names of the
AQDHS-II master file and the sorted AQDHS-II master file. See Figure 5.6.2-h
for a description of the procedure's substitutable parameters. The user must
also supply an option card to specify the desired sort sequence.
409
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 4
Release Date: 4/30/79
Update #: 24
5.6.2.5.4 Sample run stream - The following run stream would produce a sorted
AQDHS-II master file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.TSPG72S. The
input AQDHS-II master file is named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.TSPG72,
the SITE sort sequence is specified.
// EXEC AQSRM10,
// MSTRFIL=TSPG72,
// SORTFIL=TSPG72S
//SORT.OPTIONS DO *
SITE
/*
5.6.2.6 Warnings and Special Instructions
The run will be aborted if card columns 1 through 5 or 7 through 10 of
the option card contain anything other than the valid option words for a
particular field, or if both fields are blank. The standard option (STND) is
the default when an option is not specified by the user.
Note that the COBOL sort verb is used in this program; therefore, the
collating sequence for alphanumeric fields is determined by the computer at
the user's particular installation.
In addition to the diagnostic report produced by ASRMSTR (AQ0140),
messages generated by the sort-merge package will be printed. The format and
content, as well as the physical location, of these messages depend upon the
user's particular installation.
The file produced by ASRMSTR (AQ0140) may have records with duplicate
keys if,the input file was produced by the units code conversion program,
ACVUNIT (AQ0050). Also the file produced by ASRMSTR (AQ0140) may not contain
all the data on the current active master file if the input file was produced
410 v
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 5
Release Date: 4/30/79
Update #: 24
by a retrieval. Thus the file produced by ASRMSTR (AQ0140) should not be used
as input to a master file maintenance activity unless the user is sure that
the file produced by ASRMSTR (AQ0140) reflects a valid, current master file.
5.6.2.7 Cost Considerations
The following estmates are for the execution of ASRMSTR (AQ0140) on an
IBM 370/168:
Number of sorted master file records: 13 records
CPU time: .4 seconds
I/O time: 9.9 seconds
Total time: 10.3 seconds
Estimated cost: $1.65
5.6.2.8 Related Programs and Procedures
ASRMSTR (AQ0140) can be executed by the cataloged procedure AQSRM10 which
is described in Section 5.6.2.5. ASRMSTR (AQ0140) can also be executed in
conjunction with ARPINVS (AQ0280) or ARPINVP (AQ0290). Section 6.4.4.5
describes the cataloged procedure AQRPM40, which executes both ASRMSTR
(AQ0140) and ARPINVS (AQ0280); Section 6.4.5.5 describes the cataloged
procedure AQRPM35, which executes ASRMSTR (AQ0140) and ARPINVS (AQ0280).
411
-------
AODHS-II MASTER FILE SORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ASRHSTR (AQOiaO)
REVISION LEVELI 1-00
LAST UPDATE *l Za
DATE INCORPORATED: OCTOBER 31. 1978
SORT OPTION SPECIFIED:
STAT
NUMBER OF INPUT RECORDS READ!
NUMBER OF MASTER RECORDS WRITTEN:
NUMBER OF DIAGNOSTIC MESSAGES:
ro
Figure 5.6.2-a. Diagnostic Report
2 O >
> > <0
•Z. -H <=>
-• > OC
-o co
<=. > I
i— o •—i
3> o •->
—I m
•—• CO
O CO
CD
73 CO O
2 —I —I
co m >-i
—I 73 O
73 Z
XD
O
•-I (ft
co ro
O
73
O
TO
C 73
T3 (t>
Q. — i
D> n>
r+ Oi
n> c/>
O)
(Q
n>
ro
o>
co
o
VO
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 7
Release Date: 4/30/79
Update #: . 24
Columns
#1 #5
Columns
#7 #10
V v y y
[ONE] [TWO]
The options must be specified 1n the Indicated fields; all other columns
must contain blanks.
Figure 5.6.2-b. Option Card Format
413
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
Record Position
1
8-9
10 - 12
13 - 16
17 - 20
21 - 23
24
25 - 26
27
28 - 29
30 - 34
35 - 36
37 - 38
39 - 40
41 - 42
43 - 44
SECTION 5.6.2 Page 8
MASTER FILE SORT PROGRAM Release Date: 4/30/79
ASRMSTR (AQ0140) Update #: 24
Description Sort Order
Batch Retrieval Code Ascending
State Code Ascending
AQCR Code Ascending
County Code Ascending
Area Code Ascending
Site Code Ascending
Agency Code Ascending
Project Code Ascending
Time Code Ascending
Year Ascending
Parameter Code Ascending
Method Code Ascending
Units Code Ascending
Month Ascending
Day Ascending
Start Hour Ascending
Figure 5.6.2-c. Sort Sequence for BATCH Option
414
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
Record Position
30 - 34
35 - 36
8 - 9
10 - 12
13 - 16
17 - 20
21 - 23
24
25 - 26
27
28 - 29
37 - 38
39 - 40
41 - 42
43 - 44
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Description
Parameter Code
Method Code
State Code
AQCR Code
County Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Units Code
Month
Day
Start Hour
Page 9
Release Date: 4/30/79
Update #: 24
Sort Order
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Figure 5.6.2-d. Sort Sequence for PARM Option
415
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
Record Position
8-9
10 - 12
13 - 16
17 - 20
21 - 23
24
25 - 26
30 - 34
35 - 36
37 - 38
27
28 - 29
39 - 40
41 - 42
43 - 44
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Description
State Code
AQCR Code
County Code
Area Code
Site Code
Agency Code
Project Code
Parameter Code
Method Code
Units Code
Time Code
Year
Month
Day
Start Hour
Page 10
Release Date: 4/30/79
Update #: 24
Sort Order
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Figure 5.6.2-e. Sort Sequence for SITE and STAT Option
416
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
Record Position
8-9
10 - 12
13 - 16
1.7 - 20
21 - 23
24
25 - 26
27
28 - 29
30 - 34
35 - 36
37 - 38
39 - 40
41 - 42
43 - 44
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Description
State Code
AQCR Code
County Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Parameter Code
Method Code
Units Code
Month
Day
Start Hour
Page 11
Release Date: 4/30/79
Update #: 24
Sort Order
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Ascending
Figure 5.6.2-f. Sort Sequence for STND Option
417
-------
AQDHS-II SECTION 5.6.2
DATA ACCESSING AND MASTER FILE SORT PROGRAM
MANIPULATION ASRMSTR (AQ0140)
//*
//* PROCEDURE NAME! AQSRM10
//* REVISION LEVELJ 1-00
//* LAST UPDATE #1 24
//* DATE INCORPORATED! OCTOBER 31,1976
//*
//*
//* THIS PROCEDURE ALLOWS THE USER TO SORT THE AQDHS-II
//*
//*
//AQSRM10 PROC PROJECT='CN.EPALMH.A087.CDHS.MQ.AOS'r
// PROGRAMsASRMSTR,
// TIME1='|,0»,
// MSTRFILsAQMASTER,
// SORTFILsAQMSTSRT,
// UNIT=3330,
// SERIAL=CDHSPK,
// DISP='NtW,PASS',
// SPCUNIT=TRK,
// PRIMARY=20,
// SECNDRYslO,
// SORUNITsCYL,
// WORKSPCaSO,
// OUT=A,
// TEMPsSYSDA
//*
//SORT EXEC PGMs&PROGRAM,
// REGION=100K,
// TIMEs(STIMEl)
//*
//* SORT MASTER FILE
//*
//STEPLIB DD OSN=&PROJECT..LOAD,
// VOLUME=(PRIVATE, RETAIN)*
// DISP=(SHR,PASS)
//SORTLIH DD DSNAME=SYS1.SDRTL1B,
// OISP=(SHR,PASS)
//*
//SORTWK01 DD UNIT=&TEMP,
// 3PACE=(&SOHUNIT, (&WORK3PC),,CONTIG)
//*
//SORTWK02 DD UNIT=RTEMP,
// SPACE=(&SORUNIT,(RWORKSPC),,CUNTIG)
//*
//SORTWK03 DD UNIT=RTEMP,
// SPACEs(&SORUNIT, (&WORKSPC), ,CUNTIG)
//*
//* INPUT DATA SET - MASTER FILE
//*
//AOSINPUT DD DSNAME=RPROJECT..DATA.RMSTRFIL»
// VULUME=O'RIVATE, RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - OPTION CARDS
//*
//AOSOPTIN DD DDNAMEsOPTIONSr
// DCBsHLKSIZt=eO
//*
Page 12
Release Date: 4/30/79
Update #: .24
00000100
00000200
00000300
00000000
OOOOO'jOO
00000600
00000700
MASTER FILE. 00000600
00000900
00001000
00001100
00001«>00
00001300
00001400
00001SOO
00001600
00001700
OOOOIHOO
00001900
00002000
00002100
00002200
00002300
00002400
00002SOO
00002600
00002700
00002600
00002900
00003000
00003100
00003200
00003300
00003400
00003SOO
00003600
00003700
OOOOiHOO
00003900
00004000
00004100
00004200
00004300
00004400
00004SOO
00004600
00004700
00004HOO
00004900
00005000
OOOOS100
00005200
00005300
OOOOS400
00005500
00005600
00005700
OOOOSBOO
Figure 5.6.2-g.
(Page 1 of 2)
Cataloged Procedure AQSRM10
418
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 13
Release Date: 4/30/79
Update #: 24
//* OUTPUT
//*
//AOSOUTPT
//*
//* OUTPUT
//*
//AQSPRINT
//*
//* OUTPUT
//*
//SYSPRINT
//*
//SYSOUT
//*
//SYSDBOUT
//*
//SYSDTERM
//*
//SYSUDUMP
//*
DATA SET • SORTED MASTER FILE
DO
UNlTsdUNIT,
VOLUME=SERs&SERIAL»
DISP=(&DISP),
SPACE= (&SPCUNIT, (aPRIMARYr&SECNDHY))
DATA SET - DIAGNOSTIC MESSAGES
DO SYSOUT=&OUT
DATA SET - SYSTEM OPERATION
DO SYSUUTs&OUT
DO 3YSOUT=&OUT
DD SYSOUTs&OUT
DO SYSOUT=ROUT
DD SYSOUT=RUUT
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006800
00006900
00007000
00007100
oooo7aoo
00007300
00007100
00007500
00007600
00007700
00007BOO
00007900
00008000
00008100
oooosaoo
Figure 5.6.2-g - Continued.
(Page 2 of 2)
Cataloged Procedure AQSRM10
419
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.6.2
MASTER FILE SORT PROGRAM
ASRMSTR (AQ0140)
Page 14
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROGRAM
TIME1
MSTRFIL
SORTFIL
UNIT
SERIAL
DISP
SPCUNIT
PRIMARY
SECNDRY
SORUNIT
WORKSPC
OUT
TEMP
Default
Value
'CN.EPALMH.A087,
CDHS.HQ.AQS1
ASRMSTR
•1.0'
AQMASTER
AQMSTSRT
3330
CDHSPK
'NEW,PASS1
TRK
20
10
CYL
50
A
SYSDA
Description
Highest-level Index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
FTMSTRAA would be the full data set name of
the AQDHS-II master file)
Master file sort program
Time allocated for execution of ASRMSTR
Lowest-level index of unsorted master file
Lowest-level index of sorted master file
Unit type to which sorted master file is to
be written
Volume serial number of the volume to which
the sorted master file is to be written
Disposition of sorted master file
Units in which space for sorted master file
is to be allocated
Primary space allocation for sorted master
file
Secondary space allocation for sorted master
file
Units in which space for the sort work file
is to be allocated
Number of units to be allocated for the sort
work space
SYSOUT class for all print files
Unit type for temporary work space
Figure 5.6.2-h. Substitutable Parameters for AQSRM10
420
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.7.1
RETRIEVAL PROCEDURE
AQRTM10
Page 1
Release Date: 4/30/79
Update #: 24
5.7 MULTI-PROGRAM PROCEDURES
5.7.1 RETRIEVAL PROCEDURE - AQRTM10
5.7.1.1 Cataloged JCL
The cataloged procedure AQRTM10 executes the retrieval language processor
program, ARTLNGP (AQ0110), then compiles, link*edits, and executes the
generated retrieval program5ARTGENR (AQ0120). The load module for the
generated retrieval program is not saved. For information on the cataloged
procedure AQRTM20, which executes the retrieval language processor program,
then compiles, link-edits, and saves the generated retrieval load module, see
Section 5.2.2.5. Information on the cataloged procedure AQRTM30, which
executes the retrieval load module stored by AQRTM20 can be found in Section
5.2.3.5. Information on ARTLNGP (AQ0110) and ARTGENR (AQ0120) can be found in
Section 5.2.
5.7.1.1.1 JCL listing - Figure 5.7.1-a contains a listing of the cataloged
procedure AQRTM10.
5.7.1.1.2 Cross-reference of DD names and files
Program Name: ARTLNGP (AQ0110)
DD Name
File Description
Input/Output
AQSINPGM
AQSINPUT
AQSRTRVR
AQSPRINT
Retrieval skeleton program
Retrieval specification cards
Retrieval source program
Diagnostic report
Input
Input
Output
Output
421
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.7.1
RETRIEVAL PROCEDURE
AQRTM10
Page 2
Release Date: 4/30/79
Update #: 24
Program Name: ARTGENR (AQ0120)
DD Name
File Description
Input/Output
AQSMASTR
AQSANSWR
AQSPMSTR
AQSPRINT
AQDHS-II master file
Retrieved answer file
Answer file listing
Diagnostic report
Input
Output
Output
Output
5.7.1.1.3 User-supplied JCL - To execute the cataloged procedure AQRTM10, the
user must supply job accounting information and the data set names of the
AQDHS-II master file and the answer file. See Figure 5.7.1-b for a
description of the procedure's substitutable parameters. The retrieval
specification cards must also be supplied.
5.7.1.1.4 Sample run stream - The following run stream uses the procedure
AQRTM10; it is from AQDHS-II the baseline test run series. The input AQDHS-II
master file is 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQ102076' and the output
answer file is 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.S02G79'. The answer file is
to be cataloged so that is may be used in later runs. All records for 1979 or
later with parameter code 42401 (S02) will be retrieved.
// EXEC AQRTM10,
// MSTRFIL=AQ102076,
// ANSWRFL=S02G79,
// DISP='NEW,CATLG,DELETE1
//COMPILE.INPUT DD *
$$SELECT
PARAMETER-CODE = '42401' AND
YEAR N < '79'
$$END
/*
422
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.7.1
RETRIEVAL PROCEDURE
AQRTM10
Page 3
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME: AURTM10
REVISION LEVEL: i-oo
LAST UPDATE *: 24
OATt INCORPORATED: OCTOBER 31,1<»78
THIS PROCEDURE ALLOWS THE USER TO CREATE AN AQDHS-II GENERATED
RETRIEVAL PROGRAM, COMPILE AND LINK-EDIT THE PROGRAM, AND THEN
RETRIEVE DATA FROM THE AQDHS-II MASTER KILE
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AQRTMIO PROC PROJECT='CN.ErALMH.A087.CDHS.HU.AQS',
// PROGRAM=ARTLNGP,
// TIMr.l = '20,0',
// TEMP=SYSOA,
// MSTRFIL=AUMASTER,
// ANSWRFL=AQANSWER,
// UNIT=3330,
// SERIAL=CDHSPK,
// DISP='NtW,PASS,DELETE',
// SPCUNIT=TRK,
// PRIMARY=20,
// 8ECNDRY=10,
// MEMBERsARTSKEL,
// OUT=A
//*
//COMPILE EXEC PGM=«,PROGRAM,
// REGION=70K,
// TIMF = U,0)
//*
//* PRODUCE AQDHS-II RETRIEVAL PROGRAM
//*
//STEPLIB DO DSNAME=RPROJECT,.LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
// DO DSNAMEsSYSl.COBLIB,
// DISP=(SHR,PASS)
//*
//» INPUT DATA SET - RETRIEVAL PROGRAM SKELETON
//*
//AQSINPGM DD PSNAMEs&PROJECT.,SOURCE(&MEMBER),
// VOLUMEs(PRIVATE,RETAIN),
// PISP=(SHP,PASS)
//*
//* INPUT DATA SET - RETRIEVAL SPECIFICATION CARDS
//*
//AQSINPUT DO ODNAMEsINPUT,
// DC»=BLKSIZE=80
//*
//* OUTPUT DATA SET - GENERATED RETRIEVAL PROGRAM
//*
//AQSRTRVR 00 UMIT=RTEMP,
// DISP=(NfW,PASS),
// SPACE=(TRK,(5,2),RLSE),
// nSNAMEsS&PROGRAM,
// OCB=OLKSIZEs3360
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
00000100
00000200
00000300
OOOOOUOO
00000500
00000600
00000700
oooooeoo
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
ooooaaoo
00002300
00002«00
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003100
00003500
00003600
00003700
00003000
00003900
OOOOUOOO
00004100
OOOOU200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
(page 1 of 4)
Figure 5.7.1-a. Cataloged Procedure AQRTMIO
423
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.7.1
RETRIEVAL PROCEDURE
AQRTM10
Page 4
Release Date: 4/30/79
Update #: 24
//*
//AQSPRINT DO SYSOUTs&OUT
//*
//* OUTPUT DATA SETS • SYSTEM OPERATION
//*
//SYSPRINT DO SYSOUTs&OUT
//*
//SYSOUT DO SYSOUTs&OUT
//*
//SYSDBOUT DO SYSOUTs&OUT
//*
//SYSOTERM DO 3YSOUT=ROUT
//*
//3YSUDUMP DO SYSOUT=&OUT
//*
//COBOL EXEC PGMsIKFCBLOO,
// PARMs'S12Esll4K,BUFs30K,NOSE(J,NOSOURCE,SUPMAP,LIb,STATE,FLUW*10',
// REGIONS175K,
// T1ME=(2,0)
//*
//* COMPILE RETRIEVAL PROGRAM
//*
//*
//* INPUT DATA SET - SOURCE LIBRARY
//*
//SYSLIB OD DSNAMEs&PROJECT..SOURCE,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - COBOL RETRIEVAL PROGRAM SOURCE CODE
//*
//SYSIN DO DSNAMES&&PROGRAM,
// DlSPz(t)LD,DELETE)
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//.SYSPRINT DO SYSOUT=ROUT
//*
//* OUTPUT DATA SET • COBflL RETRIEVAL PROGRAM OBJECT CODE
//*
//SYSLIN OD UNITsKTfcMP,
// OISPs(NEW,PASS),
// SPACE=(TRK,(5,2),RLSE),
// DSNAMEsR&OBJMOD
//*
//* UTILI1Y DATA SETS
//*
//SYSUT1 DU UNITs&TEMP,
// SPACEs(TRK,(50,100))
//*
//SYSUT2
DO UNITs(&TEMP,StP=SYSUTt),
[,(50,100)}
//*
//3YSUT3
//
//*
//SYSUT4
00 UNITs(&TKMP,SEP=(SYSUTl,SYSUT2)),
SPACE=(TRK,(50,100))
OD UNIT=(&TLMP,SEPs(SYSUTl,SYSUT2,SYSUT3)),
SPAChs(TRK,(50,100))
0000b900
00006000
00006100
00006200
00006300
00006100
00006500
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
00006000
00006100
00008200
00008300
00008400
00006500
00008600
OOOOH700
00008600
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
000)0300
00010400
00010500
00010600
000)0700
00010800
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
(page 2 of 4)
Figure 5.7.1-a - continued. Cataloged Procedure AQRTM10
424
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.7.1
RETRIEVAL PROCEDURE
AQRTM10
Page 5
Release Date: 4/30/79
Update #: 24
//*
//LKED EXEC PGM=IEWL,
// PARM='LIST,LET,XREF',
// COND=(5,LT,COO(IL),
// HEGION=100K,
// TIME=(1,0)
//*
//* LINK-EDIT RETRIEVAL
//*
//*
//* INPUT DATA SET - AUTO-CALL LIBRARY
//SYSLIB DO DSNAME=&PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DlSP=(SHrt,PASS)
// DD DSNAME=SYS1.COBLIB,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - COBOL RETRIEVAL PROGRAM OBJECT CODE
//*
//SYSLIN DD DSNAMEs&RUHJMUD,
// DISP=(OLD,DELETE)
// DD DDNAME=INPUT,
// UCH=HLKSIZt=80
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//SYSPRINT DO SYSOUT=ROUT
//*
//* OUTPUT DATA SET - COBOL RETRIEVAL PROGRAM LOAD MODULE
//*
//SYSLMOO DO UNIT=&TEMP,
// OISP=(MOD,PASS),
// SPACE=CTRK,(10,5,1)),
// DSNAME=&&LOADMOD(RETRIEVE)
//*
//* UTILITY DATA SET
//*
//SYSUT1 DD UNIT=&TEMP,
// SPACE=(TRK,(10,5))
//*
//RETRIEVE EXEC PGM=*.LKED.SYSLMUD,
// COMD=((5,LT,COBOL),(5,LT,LKED)),
// REGIf)N=60K,
// TIME=(&TIME1)
//*
//* RETRIEVE ANSWER FILE FROM MASTER FILE
//*
//STEPLIB 01) DSNAME = *PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// I)ISP=(SHR,PASS)
// DO DSNAMt=SYSl.COBLIB,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - MASTER FILE
//*
//AQSMASTH DD DSNAME=&PRUJECT..DATA.RMSTRFIL,
// VOLUME=(PRIVATE,RETAU4),
// t)ISP=(SHH,PASS)
00011700
ooonnoo
00011900
0001r?000
00012100
00012200
00012300
00012400
00012500
00012^00
00012700
00012HOO
00012900
00013000
00013100
00013200
00013300
00013400
00013500
00013600
00013700
00013800
00013900
00014000
00014100
00014200
00014300
00014400
00014500
00014600
00014700
00014800
00014900
00015000
00015100
00015200
00015300
00015400
00015500
00015600
00015700
00015800
00015900
00016000
00016100
00016200
00016300
00016400
00016500
00016600
00016700
00016800
00016900
00017000
00017100
OU017200
00017300
00017400
(page 3 of 4)
Figure 5.7.1-a - continued. Cataloged Procedure AQRTM10
425
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.7.1
RETRIEVAL PROCEDURE
AQRTM10
Page 6
Release Date: 4/30/79
Update #: 24
//*
//* OUTPUT DATA SET - ANSWER FILE
//*
//AQSANSWR DD UNITs&UNIT,
// VOLUMEs(PRIVATE,RETAIN,SERs&SERIAL),
// DISPs(iDISP),
// SPACES (&SPCUNIT,(iPRIMARY,mCNDRY),RLSE),
// DSNAME8&PROJECT..DATA.&ANSWRFL
//*
//* OUTPUT DATA SET • ANSWER FILE CONFIRMATION LISTING
//*
//AOSPMSTR DD 3YSUUT=&OUT
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//AOSPRINT DD SYSOUTs&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPHINT DD SY3UUT«SOUT
//*
//SYSOUT
//*
//SY3DBOUT
//*
//SY3DTERM DD SYSOUTr&oUT
//*
//SYSUDUMP DD SYSOUTs&OUT
//*
//DELETE EXEC PGMsIEFBRlfl,
// REGION=4K,
// TIME=(0,S)
//LOADMOD DD DSNAMt"=&&LOADMOD,
// DISP=(OLO,DELETE)
//*
DD SYSOUT=&OUT
DD SYSOUTsSOUT
00017500
00017600
00017700
00017600
00017900
00010000
oooinioo
00018200
OOOIQ300
0001H400
00018500
00016600
00018700
00016800
00018900
00019000
00019100
00019200
00019300
00019400
00019500
00019600
00019700
00019800
00019900
00020000
00020100
00020200
00020300
00020400
00020500
00020600
00020700
00020600
00020900
(page 4 of 4)
Figure 5.7.1-a - continued. Cataloged Procedure AQRTM10
426
-------
AQDHS-II
DATA ACCESSING AND
MANIPULATION
SECTION 5.7.1
RETRIEVAL PROCEDURE
AQRTM10
Page 7
Release Date: 4/30/79
Update #: . 24
Parameter
Name
PROJECT
SERIAL
DISP
SPCUNIT
PRIMARY
SECNDRY
MEMBER
OUT
Default
Value
'CN.EPALMH.A087,
CDHS.HQ.AQS1
PROGRAM
TIME1
TEMP
MSTRFIL
ANSWRFL
UNIT
ARTLNGP
'20,0'
SYSDA
AQMASTER
AQANSWER
3330
CDHSPK
'NEW,PASS.DELETE'
TRK
20
10
ARTSKEL
A
Description
Highest-level index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
AQMASTER would be the full data set name
of an AQDHS-II master file)
Retrieval language processor program
Time for execution of generated retrieval
program
Unit type for temporary work space
Lowest-level index of master file
Lowest-level index of answer file
Unit type to which the answer file is to
be written
Volume serial number of volume to which
answer file is to be written
Disposition of answer file
Units in which space for answer file is to
be allocated
Primary space allocation for answer file
Secondary space allocation for answer file
Retrieval skeleton program
SYSOUT class for all print files
Figure 5.7.1-b. Substitutable Parameters for AQRTM10
427
-------
AQDHS-II
REPORTS
SECTION 6.1
INTRODUCTION
Page 1
Release Date: 4/30/79
Update f: 24
6.0 REPORTS
6.1 INTRODUCTION
AQDHS-II provides the user with the capability to produce many reports.
These reports can be categorized as (1) file listings, which present the
contents of files with little or no accompanying analysis; (2) EPA-requ1red
reports; and (3) summary reports, which present the results of various
analyses of files.
428
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 1
Release Date: 4/30/79
Update I: . 24
6.2 FILE LISTINGS
6.2.1 INTRODUCTION
The master file or any answer file may be listed using the master file
formatted dump program, ARPDUMP (AQ0310), or the master file detailed report
program, ARPMSTR (AQ0230).
ARPDUMP (AQ0310) lists the master or answer file, record by record, with
appropriate Identifying headers. It 1s primarily used to verify the contents
of the master file, especially when Investigating a suspected AQDHS-II
malfunction.
ARPMSTR (AQ0230) lists the master or answer file 1n a format suitable for
a management report. Appropriate headings are printed, Including narrative
descriptions from the parameter, site, and parameter standards files. The
readings from the master or answer file are printed 1n table form with
appropriate row and column headings. Also, a limited amount of statistics are
computed and printed.
ARPMSTR (AQ0230) Is also used 1n producing the sliding average report,
which 1s discussed in Section 5.3.1.2.
The master file formatted dump flowchart and master file detailed report
flowchart are shown 1n Figures 6.2.1-a and 6.2.1-b, respectively. Both
ARPDUMP (AQ0310) and ARPMSTR (AQ0230) provide a listing of the master file or
any answer file; ARPMSTR (AQ0230) accesses the parameter, site, and parameter
standards files in addition to the master or answer file. ARPMSTR (AQ0230)
produces a diagnostic report, whereas ARPDUMP (AQ0310) prints the Information
usually contained in a diagnostic report at the beginning and end of the
formatted dump.
429
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
Detailed discussions of ARPDUMP (AQ0310) and ARPMSTR (AQ0230) are
presented in Sections 6.2.2 and 6.2.3, respectively.
ARPDUMP (AQ0310) can be executed using the cataloged procedure AQRPM25,
which is discussed in Section 6.2.2.5. A sample run stream to produce a dump
of a master file is shown in Section 6.2.2.5.4. ARPMSTR (AQ0230) can be
executed using the cataloged procedure AQRPM20, which is discussed in Section
6.2.3.5. Sample run streams to produce a detailed report of the master file
are shown in Section 6.2.3.5.4. A sample run stream using ARPMSTR (AQ0230) in
the production of a sliding average report is shown in Section 7.2.6.
The auxiliary files (the parameter, parameter standards, and
site files) may be listed using the parameter file detailed report program,
ARPPARM (AQ0240); the parameter standards file detailed report program,
ARPSTND (AQ0250); and the site file detailed report program, ARPSITE (AQ0260),
respectively.
Figures 6.2.1-c, 6.2.1-d, and 6.2.1-e present the parameter file detailed
report flowchart, the parameter standards file detailed report flowchart, and
the site file detailed report flowchart. ARPPARM (AQ0240) and ARPSTND
(AQ0250) produce diagnostic reports, whereas ARPSITE (AQ0260) prints the
information usually contained in the diagnostic report at the beginning and
end of the site file detailed report. Additionally, ARPSITE (AQ0260) sorts
the site file information so that the sites are listed in the same order as
they occur in the master file. .
Detailed discussions of ARPPARM (AQ0240), ARPSTND (AQ0250), and ARPSITE
(AQ0260) are presented in Sections 6.2.4, 6.2.5, and 6.2.6, respectively.
ARPPARM (AQ0240) can be executed using the cataloged procedure AQRPP10,
which is discussed in Section 6.2.4.5. A sample run stream to list the
430
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 3
Release Date: 4/30/79
Update #: 24
parameter file is shown in Section 6.2.4.5.4. ARPSTND (AQ0250) can be
executed using the cataloged procedure AQRPD10, which is discussed in Section
6.2.5.5. A sample run stream to list the parameter standards file is shown in
Section 6.2.5.5.4. ARPSITE (AQ0260) can be executed using the cataloged
procedure AQRPS10, which is discussed in Section 6.2.6.5. A sample run stream
to list the site file is shown in Section 6.2.6.5.4.
431
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 4
Release Date: 4/30/79
Update #: . 24
AQDHS-II MASTER
FILE OR
\ ANSWER FILE
OPTION CARD
(Optional)
ARPDUMP (AQ0310)
MASTER FILE FORMATTED
DUMP PROGRAM
MASTER FILE
FORMATTED DUMP
Figure 6.2.1-a. Master File Formatted Dump Flowchart
432
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 5
Release Date: 4/30/79
Update #: 24
AQDHS-II
(MASTER FILE OR|
ANSWER FILE
OPTION CARD
(Optional)
AQDHS-II
PARAMETER
FILE
/AQDHS-II
PARAMETER
VSTANDARDS FILE'
ARPMSTR (AQ0230)
MASTER FILE DETAILED
REPORT PROGRAM
MASTER FILE
DETAILED REPORT]
DIAGNOSTIC
REPORT
Figure 6.2.1-b. Master File Detailed Report Flowchart
433
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 6
Release Date: 4/30/79
Update #: . 24
/ AQDHS-II
PARAMETER
\ FILE
ARPPARM (AQ0240)
PARAMETER FILE
DETAILED REPORT PROGRAM
PARAMETER FILE
DETAILED REPORT!
DIAGNOSTIC
REPORT
Figure 6.2.1-c. Parameter File Detailed Report Flowchart
434
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 7
Release Date: 4/30/79
Update #: . 24
AQDHS-II
PARAMETER
STANDARDS FILE
ARPSTND (AQ0250)
PARAMETER STANDARDS
DETAILED REPORT PROGRAM
PARAMETER STANDARDS
FILE DETAILED
REPORT.
DIAGNOSTIC
REPORT
Figure 6.2.1-d. Parameter Standards File Detailed Report Flowchart
435
-------
AQDHS-II
REPORTS
SECTION 6.2.1
INTRODUCTION
Page 8
Release Date: 4/30/79
Update f: 24
AQDHS-II
SITE FILE
ARPSITE (AQ0260)
SITE FILE DETAILED
REPORT PROGRAM
SITE FILE
DETAILED REPORT
SORT WORK
FILE
(Temporary)
Figure 6.2.1-e. Site File Detailed Report Flowchart
436
-------
AQDHS-II
REPORTS
SECTION 6.2.2
MASTER FILE DUMP PROGRAM
ARPDUMP (AQ0310)
Page 1
Release Date: 4/30/79
Update #: 24
6.2.2 MASTER FILE FORMATTED DUMP PROGRAM - ARPDUMP (AQ0310)
6.2.2.1 Description
ARPDUMP (AQ0310) produces a formatted dump of the AQDHS-II master file;
I.e., a listing with Identifying headings of all the fields 1n each master
file record, as the records appear 1n the file. ARPDUMP (AQ0310) may also be
used to produce a formatted dump of any AQDHS-II answer file. This formatted
dump provides the user a means of verifying Information contained 1n a master
or answer file and Isolating Invalid data.
6.2.2.2 File Formats
Input to ARPDUMP (AQ0310) consists of an AQDHS-II master or answer file
and an option card. See Figure 4.5.3-a for the format of the master file.
Output consists solely of a printed report containing the master file
dump, and the standard update and statistics messages. See Figure 6.2.2-a for
an example of this report.
6.2.2.3 Options
The maximum number of lines per printed page can be specified by the user
1n card columns one and two of the option card. This option can reduce the
the amount of paper used by those users who have the standard 11 x 14 output
forms and the ability to print eight lines per Inch. The line specification
on the option card should be a number between 10 and 88. If an Invalid option
or no option card 1s entered, the default option of 55 lines per page 1s
assumed.
See Figure 6.2.2-b for the format of the option card.
437
-------
AQDHS-II
REPORTS
SECTION 6.2.2
MASTER FILE DUMP PROGRAM
ARPDUMP (AQ0310)
Page 2
Release Date: 4/30/79
Update #: 24
6.2.2.4 Error Messages
No error messages are printed.
6.2.2.5 Cataloged JCL
6.2.2.5.1 JCL listing - ARPDUMP (AQ0310) is executed by the cataloged
procedure AQRPM25. See Figure 6.2.2-c for a listing of this procedure.
6.2.2.5.2 Cross-reference of DP names and files
Program name: ARPDUMP (AQ0310)
DP Name File Description Input/Output
AQSMASTR AQDHS-II master or answer file Input
AQOPTIN Option card file Input
AQSPRINT Print file Output
6.2.2.5.3 User-supplied JCL -To execute AQRPM25, the user can expect to
supply job accounting information; the data set name of the input AQDHS-II
master or answer file; and, optionally, an option card. See Figure 6.2.2-d
for a description of the procedure's substitutable parameters.
6.2.2.5.4 Sample run stream -The following run stream would produce a dump of
the master file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.INMSTR'. A maximum of
80 lines per page is specified for the report.
438
-------
AQDHS-II
REPORTS
SECTION 6.2.2
MASTER FILE DUMP PROGRAM
ARPDUMP (AQ0310)
Page 3
Release Date: 4/30/79
Update #: 24
// EXEC AQRPM25,
// MSTRFIL=INMSTR
//DUMP.OPTIONS DD *
80
/*
6.2.2.6 Warnings and Special Instructions
The maximum number of lines specified on the option card must be between
10 and 88. If an invalid option or no option card is entered, the default
option of 55 lines per page is assumed.
6.2.2.7 Cost Considerations
The following estimates are for the execution of ARPDUMP (AQ0310) on an
IBM 370/168:
Size of AQDHS-II master file: 13 records
CPU time: .1 seconds
I/O time: 5.0 seconds
Total time: 5.1 seconds
Estimated cost: $ .88
439
-------
AGDHS-II MASTER FILE FORMATTED DUMP
PAGE
PROGRAM NAME: AKPDUMP (AQ03IO)
REVISION LEVEL: 1-00
LAST UPDATE #! 2
m o
T3 O
o z
70 CO
—I i
co i—"
TO
T3
o
3 co
5> rn
co o
—I —I
m i—i
o
co o
i—« CTl
m ro
ro
o -3.
O
£T3
-a
CL
o>
r+
n>
=*=
ro
TO -o
fD Cu
—• to
fl> (D
CU
CO -P>
n>
a
CU
co
o
-------
AODHS-II MASTER FILE FORMATTED DUMP
PAGE
ACTION Cs 2
PARAMETER C=
FORM C = 2 STATE »= 34 AOCR* 136 COUNTYi 1780 AREAs 0003
. 43502 METHOD c= 91 UNITS cs 01 REC MONTHS 59 REC DAYS o
SUBMIT STATUSs S READINGS APPEAR AS FOLLOWS: STATUS-FLAG BLANK DEdMAL-C
S 1 0023 *»
SITEz 002 AGENCY= G PROJECTS 04
) START HOURs 52 SLAMSs
)DE BLANK READING BLANK **
NBR OF READINGS IS 01
REC YEARe 60
ESg.
PARAMETER Cs 62101 METHOD Cs 20 UNIT. .
SUBMIT STATUS: S READINGS APPEAH AS FOLLOWS: ...
0 9000 ** S 0 9100 •• S 0 9200 ** S 0 9300 «« S 0
AOCRs 186 COUNTYs 3020 AREAs 3000 SITEs 997 AGENCYs A PROJECTS 05
UNIfS Cs IS RiC: MONTfis'oi REC OSYs'Ol "START HOURs~66 SLAMSs NBR'OF READINGS IS 12
~ ' ~ " STATUS-FLAG BLANK DECIMAL-CODE BLANK READING BLANK »*
REC YEARs 63
0 9901 «« S 0 9<9
9400 «* S 0 9500 ** S 0 9600 •• S 0 9700 ** S 0 9800 •* S 0 9900 *«
9000 •* S
ACTION Cs 2 FORM Cs 1 STATE «« 37 AOCR= 186 COUN..- _v
PARAMETER C= 62101 METHOD C= 20 UNITS Cs 15 REC MONTHS
UMTSAUs" i - .. - __».•_-•__..
3020 AREAs 3000
He 01 REC DAYS
9961 ** S I 9902 **
D N S A PEA SFLOS SAU- LAG B A K DEC M
0 «• S 1 9200 ** S 1 9300 ** S 1 9400 *• S 1
2 02
L C DE
>SOO «*
SITEs 997 AGENCYs A PROJECTS 05 TIM£= 2 REC YEARs 63
START HOURs 00 SLAMSs NBR OF READINGS IS 12
BAKRAIGBAK*
S 1 9600 »* S 1 9700 ** S 1 9800 •* S 1 9900 **
TIMEs 2 RE
READINGS IS
YEARs 63
ACTION Cs 2 FORM Cs 1 STATE «s 37 AOCRs 186 COUNTYs 3020 AREAs 3000 S1TE= 997 AGENCYs A PROJECT: 05
PARAMETER Cs 62101 METHOD C« 20 UNITS C= IS REC MONTH: 01 REC DAY= 03 START HOURs 00 SLAMSs NBR OF
SUBMIT STATUS^ S READINGS APPEAR AS FOLLOWS: STATUS-FLAG BLANK DECIMAL-CODE BLANK READING BLANK »«
S 2 9000 ** S 2 9100 *• S 2 9200 ** S 2 9300 •* S 2 9400 ** S 2 9500 ** S 2 9600 «» S 2 9700 ** S 2 9600 •* S 2 9900 ••
S 2 9901 *• S 2 9902 •*
ACTION^ 2=
AREAS 3000 SITE= 997
. _ FORM C= 1 STATE «: 37 AQCRs 186 COUNTY: 3020
PARAMETER C= 62101 METHOD C= 20 UNITS C: 15 REC MONTH: '
SUBMIT STATUSs S READINGS APPEAH AS FOLLOWS; STATUS-FLAG __
S 3 9000 »» S 3 9100 ** S 3 9200 «* S 3 9300 ** S 3 9400
S 3 9901 *• S 3 9902 **
ACTION C: 2 FORM Cs I STATE «: 37 AQCRs 186 COUNTYs 3020 AREAs 3000 SITE* 997 AGENCYs A PROJECTS 05 TIMEs 2 REC YEARs 63
~ RAMETER Cs 62101 METHOD C= 20 UNITS Cs 15 REC MONTH= 01 REC DAYs OS START HOURs 00 SLAMS= NBR OF READINGS IS 12
01 REC DAYs 04 START HOURs 00 SI
BLANK DECIMAL-CODE BLANK READING B
00 ** S 3 9500 ** S 3 9600 «* S 3
AGENCY* A PRUJECT= 05 TIMEs 2 REC YEAR* 63
SLAMS= NBR OF READINGS IS 12
"LANK *»
9700 ** S 3 9800 •* S 3 9900 *•
PARAMETER Cs
SUBMIT STATUS: S
S 4 9000 •* S 4
S 4 9901 *• S 4
READINGS APPEAH AS FOLLOWS:
9100 *• S 4 9200 •* S 4 9300 ** S 4
9902 •«
STATUS-FLAG BLANK DECIMAL-CODE
9400 »* S 4 9500 **
BLANK READING
S 4 9600 *• S 4
LANK **
9700 ** S 4
9800 ** S 4 9900 *•
ACTION Cs 2 FORM Cs 2 STATE «= 37 AUCR= 186 COUNTY: 3020 AREAs 3000 SITE: 997 AGENCYs A PROJECTS 05
PARAMETER Cs 61202 METHOD Cs 21 UNITS Cs 28 REC MONTHS 02 REC DAY: 01 START HOURs 00 SLAMS:
SUBMIT STATUS: S READINGS APPEAR AS FOLLOWS: STATUS-FLAG BLANK DECIMAL-CODE BLANK HEADING BLANK **
S 1 9222 ** S 4 9555 **
ACTION C: 2 FORM C= 2 STATE «s 3/ AQCR: 186 COUNTY: 3020 AREAs 3000 SITE: 997 AGENCY: A PROJECT: 05
PARAMETER C: 62101 METHOD C= 20 UNITS C: 15 REC MONTH: 02 REC DAY: 01 START HOUR: 00 SLAMS: NBR OF
SUBMIT SIAIUSs S READINGS APPEAR AS FOLLOWS: STATUS-FLAG BLANK DECIMAL-CODE BLANK READING BLANK ••
S 2 0333 •• S 0 9666 **
._ TIMFs 8
NBR OF READINGS IS 02
REC YEARS 63
ACTION Cs 2 FORM Cs 2 STATE 0s 37 AOCR: 186 COUNTYs 3020 AREA: 3000 SITEs 997 AGENCY: A PROJECT: 05
PARA"ETER C: 62103 METHOD C: 20 ONUS C: 15 REC MONTH: 02 REC DAY: 01 START HOUR: 00 SLAMS: NBR OF
SUBMIT STATUS: S READINGS APPEAH AS FOLLOWS: STATUS-FLAG BLANK DECIMAL-CODE BLANK HEADING BLANK **
S 0 9111 •* S 3 9444 *•
ACTION Cs 2 FORM Cs 3 STATE »- 37 AUCR: 186 COUNTYs 3020 AREA: 3000 SITEs 998 AGENCY: A PROJECT: 05
PARAMETER C: 61202 METHOD C= 21 UntlTS C: 28 REC MONTH: 01 REC DAYs 01 START HOUR: 00 SLAMS: NBR OF
SUBMIT STATUSs S HEADINGS APPEAH AS FOLLOWS: STATUS-FLAG BLANK DECf
S 1 1111 «* S 1 1122 *• S 1 1124 ** S 1 1124 • *
CIMAL-CODE BLANK READING BLANK «*
TIME= 8
READINGS
TIMEs 8
READINGS
TIME = B
READINGS
ACTION C= 2 FORM Cs 3 STATE »= 37 AOCRs 186 COUNTYs 3020 AREAs 3020
PARAMETER t= 61202 METHOD Cs 21 UNITS Cs 28 REC MONTHS 01 REC OAYs 01
SUBMIT STATUSs S READINGS APPEAR AS FOLLOWS: STATUS-FLAG BLANK DECIMAL-CODE
S 1 0511 «* S 1 0510 •• S 1 0510 *» S 1 0510 **
AGENCY:
PROJECTS 05 -, - .
.. ._ IS: NBR OF READINGS
BLANK READING BLANK **
SITE: 996
START HOUR: 00 SLAMS:
TIME: B
RE«
ACTION Cs 2 FORM Cs 3 STATE *s 37 AUCRs 186 COUNTYs 3020 AREAs 3140
PARAMETER C= 61202 METHOD Cs 21 UNITS Cs 28 REC MONTHS 01 ---
SUBMIT STATUSs S READINGS APPEAR AS FULLUUS: STATUS-FLAG BLANK
S 1 0000 ** S 1 0000 *» S 1 -0020 *» S 1 -0020 **
REC DAYs 01
ECIMAL-CODE
SITE= 992 AGENCY: A PROJECT: 05
START HOUR: 00 SLAMSs NBR OF
BLANK READING BLANK ••
ACTION C= 2 FORM Cs 3 STATE *- 37 AQCR: 186 COUNTY: 3020 AREA: 3140 SITE: 994 AGENCY: A PROJECT: OS
PARAMETER Cs 61202 METHOD Cs 21 UNITS Cs 28 REC MONTHS 01 REC OAY= 01 START HOURs 00 SLAMSs NBR OF
SOBMIT STATUS: S HEADINGS APPEAH AS FOLLOWS: STATUS-FLAG BLANK DECIMAL-CODE BLANK READING BLANK •*
S 1 -0017 *• S 1 -0018 »» S 1 -0018 »* S 1 -0018 «•
TIMEs B
READINGS
HMEs B
READINGS
REC YEARs 63
IS 02
REC YEARs 63
IS 02
REC YEARs 63
IS 04
REC YEARs 63
IS 04
REC YEARs 63
IS 04
REC YEARs 63
IS 04
NUMBER OF RECORDS READ:
NUMBER OF RECORDS DUMPED:
1*
PROGRAM NAME: ARPOUMP (AQ0310)
REVISION LEVEL: 1-00
LAST UI'DATE 1; 2u
DATE INCORPORATED: OCTOBER 31, 1"»78
Figure 6.2.2-a - continued. Master File Formatted Dump
(page 2 of 2)
m o
-o o
O DC
•yo co
-H I
i—i
•O CO O
O —I —I
cz m •—«
3 -yo o
o
co
•-• CT>
I- •
m ro
•
o ro
o 3
•yo
o
CT5
-o n>
Q. —'
o> ro
r+ Q)
(D CO
tt>
ro tt>
CO
O
n>
-------
AQDHS-II
REPORTS
SECTION 6.2.2
MASTER FILE DUMP PROGRAM
ARPDUMP (AQ0310)
Page 6
Release Date: 4/30/79
Update #: 24
XX
XX is the maximum number of lines to be printed per page.
Figure 6.2.2-b. Format of the Option Card for ARPDUMP (AQ0310)
442
-------
AQDHS-II
REPORTS
SECTION 6.2.2
MASTER FILE DUMP PROGRAM
ARPDUMP (AQ0310)
Page 7
Release Date: 4/30/79
Update #: 24
//*
PROCEDURE NAME I AURPN25
REVISION LEVEL: 1-00
LAST UPDATE 01 24'
DATE INCORPORATED» OCTOBER 51,1978
THIS PROCEDURE ALLOWS THE USER TO GENERATE A FORMATTED DUMP OF
THE AODHS-II MASTER FILE
//*
//*
//*
//*
//*
//*
//*
//*
//AQRPM25 PROC PROJECT='CN.EPALMH,A087.CDHS.HQ.AOS',
// PROGRAMcARPDUMP,
// TIME1='1,0',
// MSTRHL = AQMASTER,
// OUT=A
//*
//DUMP EXEC PGM=&PROGRAM,
// TIMEs(&TIMEl)
//*
//* DUMP PROGRAM FOR THE AQDHS-II MASTER FILE
//*
//STEPLIB DD DSN=&PROJECT..LOAD,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - AQDHS-II MASTER FILE
//*.
//AQSMASTR DO DSNs&PROJECT . .DATA. J.MSTRFIL,
// DISP«(SHR,PA3S)
//*
//* INPUT DATA SET - CONTROL CARD
//*
//AQOPTIN DD DDNAME=OPTIONS,
// OCB=BLKSIZE=80
//*
//* OUTPUT DATA SET - MASTER FILE DUMP
//*
//AOSPR1NT DD SYSOUT=&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATIONS
//*
//SYSPRINT DD SYSOUT=&OUT
//*
//SYSUDUMP DD SYSOUT=&OUT
//*
//SYSDTERM DD SYSOUTsMJUT
//*
//SY3DBOUT DD SYSOUTs&OUT
//*
//3YSOUT DD SYSOUTs&OUT
//*
00000100
00000200
00000300
00000400
00000500
00000000
00000700
ooooonoo
00000900
00001000
00001100
00001200
00001300
00001400
00001500
OOOOlhOO
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
OOOOSOOO
Figure 6.2.2-c. Cataloged Procedure AQRPM25
443
-------
AQDHS-II
REPORTS
SECTION 6.2.2
MASTER FILE DUMP PROGRAM
ARPDUMP (AQ0310)
Page 8
Release Date: 4/30/79
Update f: 24
Parameter
Name
PROGRAM
TIME1
MSTRFIL
OUT
Default
Name
Description
PROJECT 'CN.EPALMH.A087.CDHS.HQ.AQS' Highest-level Index of data set
ARPDUMP
'1,0'
AQMASTER
A
names
Master file formatted dump program
Time allocated for execution of
ARPDUMP
Lowest-level Index of Input master
file
SYSOUT class for all print files
Figure 6.2.2-d. Substitutable Parameters for AQRPM25
444
-------
THE AIR QUALITY DATA HANDLING SYSTEM USER'S GUIDE
450/4-79-009
Part 2
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 1
Release Date: 4/30/79
Update #: 24
6.2.3 MASTER FILE DETAILED REPORT PROGRAM - ARPMSTR (AQ0230)
6.2.3.1 Description
ARPMSTR (AQ0230) produces, a detailed report of the AQDHS-II master (or
answer) file, using Information from the parameter, site, and parameter
standards files for report headings. The report is organized so that the data
for each parameter measured at a given site is printed on a separate page.
The amount of data printed on a page is dependent on the time-code of the
master file record. For hourly data, one month of data is shown on two pages,
with the hours of the day as columns across and the days of the months as rows
down (see Figure 6.2.3-a, pages 1 and 2 ); other less-than-daily data is
printed one page per month (hours as columns, days as rows, (see Figure
6.2.3-a, pages 3 through 8). For daily, weekly, monthly, quarterly, and
composite data, one year of data is shown per page, (see Figure 6.2.3-a, pages
9 through 13).
Both standard and sliding average value (that is, files output by the
sliding average program, ASTSLAV (AQ0180)) files may be used as input to
ARPMSTR (AQ0230). The formats of the sliding average reports are shown 1n
Figure 6.2.3-b.
An option card is entered to allow the user to select two options. The
first option is to determine the summary type; MEAN and SUM are the values
allowed for this option. See samples of the mean reports in Figure 6.2.3-a
and the sum reports in Figure 6.2.3-c. The display option allows the user to
determine which values should be printed on the report. Default values are
MEAN for summary and DISPLAY N > 9997 (or all non-null readings) for display.
Information on the options can be found in Section 6.2.3.3.
445
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 2
Release Date: 4/30/79
Update #: . 24
6.2.3.2 File Formats
ARPMSTR (AQ0230) uses five input files: (1) the AQDHS-II master file
(format shown in Figure 4.5.3-a), (2) the parameter file (format shown in
Figure 4.2.2-c), (3) the site file (format shown in Figure 4.3.2-a), (4) the
parameter standards file (format shown in Figure 4.4.2-a), and (5) an option
card. See Section 6.2.3.3 for a discussion of the option card.
Two print files are output by ARPMSTR (AQ0230): a diagnostic report
(shown in Figure 6.2.3-d) and the detailed report (shown in Figures 6.2.3-a,
6.2.3-b, and 6.2.3-c).
6.2.3.3 Options
The detailed report produced by ARPMSTR (AQ0230) can either be a standard
or a sliding average report; however, this option is determined by the type of
file entered and hot by the option card. Sliding average value files output
by the sliding average program, ASTSLAV (AQ0180), are flagged as such and
automatically produce a sliding average report (see Figure 6.2.3-b); all other
master or answer files produce a standard detailed report.
A card is input ARPMSTR (AQ0230) to allow the user to choose two options:
the summary option and the display option. The summary option allows the user
to specify the type of summary columns and rows to be printed; it may only be
used for standard reports.
There are two summary options that can be specified: MEAN and SUM. When
the MEAN option is specified, the number of readings, the maximum reading, and
the mean are printed for each column and row. MEAN is the default value for
the summary option; that is, if no option is specified, the MEAN option will
be used. Examples of the MEAN option report are shown in Figure 6.2.3-a.
446
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 3
Release Date: 4/30/79
Update #: 24
When the SUM option is specified, the number of readings and the
sum of the readings are printed for each row; no column totals are printed.
Examples of the SUM option report are shown in Figure 6.2.3-c.
The display option allows the user to specify a numeric criterion for
readings to be printed. The criterion is specified by a statement consisting
of a keyword, an optional negation flag, a relational operator, and a
threshold value, in that order. Each element of the display option statement
must be preceded and followed by at least one blank. The definitions of the
elements of the statement are as follows:
Keyword: DISPLAY
Negation Flag: N or blank
Relational Operator: >, =, or < (greater than, equal to, or less than)
Specified Value: A number in the range -999 to 9997. (Leading
zeroes in front of the decimal are not required.
The decimal point should always be coded - if it
is omitted, it will be assumed to be right
justified in the field.)
The default value for the display option is DISPLAY N > 9997; i.e., print
all readings that are not greater than 9997. When the default is in effect,
all readings except 9998 and 9999 will be printed. A reading of 9998 is a
special value indicating that not enough readings were present to calculate
the sliding average value; asterisks, '***', will be printed wherever this
value occurs (see Section 5.3.4.1). A data field containing 9999 indicates a
null-value.
If no option card is included in the execution deck, the default options
of MEAN and DISPLAY N > 9997 will be in effect. See Figure 6.2.3-e for the
format of the option card.
447
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 4
Release Date: 4/30/79
Update #: 24
6.2.3.4 Error Messages
ARPMSTR 001 ABORT - ANSWER FILE CONTAINS NO DATA
Meaning: There were no records in the input AQDHS-II master (or answer)
file. It is possible that the retrieval request was overly
restrictive and no records qualified. Another possibility is
that the wrong file name was used in the JCL. In either case,
the run was terminated and no report was produced.
Action: Examine the file names in the JCL and any retrieval specifica-
tions used; correct as necessary and resubmit the job.
ARPMSTR 002 ABORT - IDENTIFIER NOT RECOGNIZED
Meaning: The correct options were not used on the option card; the
valid identifiers are DISPLAY, MEAN, and SUM. The run was
terminated and no report was produced.
Action: Correct the option card and resubmit the job.
/
ARPMSTR 003 CONDITIONAL - OPTION CARD MISSING FOR STD ANSWER FILE - ASSUME
MEAN REPORT
Meaning: No option card defining the summary type was specified. The
default of MEAN was used for the report.
Action: No action is necessary, unless the SUM option is desired. If
so, enter SUM on the option card and resubmit the job.
ARPMSTR 004 ABORT - SYNTAX REQUIRES RELATIONAL OP (<,=,>)
Meaning: The relational operator for the display statement is missing,
improperly coded, or out of sequence on the option card. The
run was terminated and no report was produced.
Action: Check the display statement for correct format and syntax.
Correct the error and resubmit the job.
448
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 5
Release Date: 4/30/79
Update #: . 24
ARPMSTR 005 ABORT - INVALID USE OF DISPLAY STMT WITH NULL READING
Meaning: The display statement logic would have caused all valid
readings to be suppressed. (An example of an Invalid statement
is DISPLAY N < 9999.) The run was terminated and no report was
produced.
Action: Correct the display statement and resubmit the job.
ARPMSTR 006 ABORT - PARM TABLE OVERFLOW CONSULT USER GUIDE FOR CORRECTIVE
ACTION
Meaning: The number of records in the input parameter file exceeds the
limit of 200 imposed by the parameter table size in the
program. Therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the allowed table
size.
ARPMSTR 007 ABORT - SYNTAX REQUIRES NEGATIVE SYMBOL (N) OR RELATIONAL OP
«.-,>)
Meaning: Something other than the negation operator (N) or the rela-
tional operator (<,=,>) precedes the specified numeric value in
the display statement. Therefore, the run was terminated.
Action: Check the display statement for correct format and syntax.
Correct the error and resubmit the job.
ARPMSTR 008 ABORT - SYNTAX ERROR ON OPTION CARD
Meaning: The option card contains one or more invalid words; the only
valid words are DISPLAY, SUM, and MEAN. Therefore, the run was
terminated.
Action: Correct the option card and resubmit the job.
ARPMSTR 009 ABORT - DISPLAY STMT PARAMETER NOT NUMERIC
Meaning: The threshold value used in the display'Statement on the option
449
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 6
Release Date: 4/30/79
Update #: 24
Action:
card is not a number in the range of -999 to 9997; therefore,
the run was terminated.
Correct the display threshold value and resubmit the job.
ARPMSTR 010 ABORT - MEAN STMT MAY NOT BE USED WITH SLIDING AVG INPUT
Meaning: The summary option is not allowed for a sliding average report;
therefore, the run was terminated and no report was produced.
Action: Delete MEAN from the option card or if a sliding average file
was not the expected input, check the JCL to insure that the
specified master file name is correct. Resubmit the job.
ARPMSTR Oil ABORT - SUM STMT MAY NOT BE USED WITH SLIDING AVG INPUT
Meaning: The summary option is not allowed for a sliding average report;
therefore, the run was terminated and no report was produced.
Action: Delete SUM from the option card or if a sliding average file
was not the expected input, check the JCL to insure the master
file name is correct. Resubmit the job.
ARPMSTR 012 ERROR - INTERVAL CODE CONVERSION ERROR - EXECUTION CONTINUES
Meaning: The sliding average interval (as output by ASTSLAV (AQ0180),
the sliding average program) cannot be converted to a
two-digit number (valid intervals are 2-31), and zero is
substituted; however, the output report is useable.
Action: Save the input files, the run stream, the compile of ARPMSTR,
and the output and contact the National Air Data Branch for
assistance.
ARPMSTR 013 ABORT - OUTPUT FILE CONTAINS NO DATA
Meaning: The input file contained no records and no report was printed.
One possible cause could be that the name of the master file in
the JCL is incorrect. Another possible cause is that, if the
report follows a retrieval, the retrieval specifications were
too restrictive and no records were selected.
450
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 7
Release Date: 4/30/79
Update #: 24
Action: Verify that the JCL names and/or the retrieval specifications
are correct; if errors are found, correct them and resubmit the
job.
ARPMSTR 014 ABORT - SITE TABLE OVERFLOW CONSULT USER GUIDE FOR CORRECTIVE
ACTION
Meaning: The number of records in the input site file exceeds the limit
of 200 imposed by the site table in the program. Therefore,
the run was terminated.
Action: See Appendix C for instructions on increasing the allowed table
size.
ARPMSTR 015 ABORT - STANDARDS TABLE OVERFLOW CONSULT USER GUIDE FOR CORRECTIVE
ACTION
Meaning: The number of records in the input standards file exceeds the
limit of 200 imposed by the parameter standards table in the
program. Therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the allowed table
size.
ARPMSTR 016 ABORT - MEAN AND SUM ARE MUTUALLY EXCLUSIVE OPTIONS
Meaning: Both MEAN and SUM are values for the summary option and both
cannot be selected for a given run; therefore, the run was
terminated.
Action: Select the option desired, delete the other word from the
option card, and resubmit the job.
ARPMSTR 017 ABORT - LEVEL 77 DATA FIELD "NBR OF PARMS" INCREASED BEYOND PARM-
TABLE SIZE
Meaning: ARPMSTR (AQ0230) has been incorrectly modified to increase the
parameter table; therefore, the run was terminated.
451
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 8
Release Date: 4/30/79
Update #: 24
Action: See Appendix C for Instructions on correctly increasing the
allowed table size.
ARPMSTR 018 ABORT - LEVEL 77 DATA FIELD "NBR-OF-SITES" INCREASED BEYOND SITE-
TABLE SIZE
Meaning: ARPMSTR (AQ0230) has been incorrectly modified to increase the
parameter table; therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
ARPMSTR 019 ABORT - LEVEL 77 DATA FIELD "NBR-OF-STANDARDS" INCREASED BEYOND
STANDARD-TABLE SIZE
Meaning: ARPMSTR (AQ0230) has been incorrectly modified to increase the
parameter standards table; therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
6.2.3.5 Cataloged JCL
6.2.3.5.1 JCL listing - Figure 6.2.3-f contains a listing of the cataloged
procedure AQRPM20, which executes ARPMSTR (AQ0230).
6.2.3.5.2 Cross-reference of DP names and files
Program Name: ARPMSTR (AQ0230)
DP Name File Description Input/Output
AQSMASTR AQDHS-II master (or answer) file Input
AQSINPUT Option card Input
AQSPARMC Parameter file Input
AQSSITES Site file Input
452
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 9
Release Date: 4/30/79
Update #: 24
DP Name File Description Input/Output
AQSTNDRD Parameter standards file Input
AQSPRINT Diagnostic report Output
AQSREPTS Detailed report Output
6.2.3.5.3 User-supplied JCL - To execute the cataloged procedure AQRPM20, the
user must supply a job card, an option card, and names for the AQDHS-II master
(or answer) file, the parameter file, the parameter standards file, and the
site file. See Figure 6.2.3-g for a description of the procedure's
substltutable parameters.
6.2.3.5.4 Sample run streams - Three run streams from the baseline test
series are used to Illustrate ARPMSTR (AQ0230). In all three, the parameter
file 1s 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.PARMFILE1, the site file 1s
'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.SITEFILE1, and the parameter standards file
1s 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.STANFILE'.
The first example uses a display option of 'DISPLAY N > 50' and the
default summary option MEAN. The Input master file 1s 'CN.EPALMH.A087.CDHS.
HQ.AQS.DATA.AQ1029C6V The execution JCL for this example 1s:
// EXEC AQRPM20,
// MSTRFIL=AQ1029C6
//REPORT.OPTIONS DD *
DISPLAY N > 50
/*
453
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 10
Release Date: 4/30/79
Update #: 24
The second example uses the master file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
RTANSR41'. The options are SUM and 'DISPLAY > .1'. The execution JCL for
this example is:
// EXEC AQRPM20,
// MSTRFIL=RTANSR41
//REPORT.OPTIONS DD *
SUM DISPLAY > .1
/*
The third example uses a sliding average value file, 'CN.EPALMH.A087.
CDHS.HQ.AQS.DATA.ITSLDA451 as input. No summary option is allowed; the
display option is 'DISPLAY > -10'. The execution JCL for this run is:
// EXEC AQRPM20,
// MSTRFIL=ITSLDA45
//REPORT.OPTIONS DD *
DISPLAY > -10
/*
6.2.3.6 Warnings and Special Instructions
The report produced by ARPMSTR (AQ0230) can be very lengthy and expensive
to generate. If one expects a very large report, it is recommended that the
substitutable parameter for execution time be increased and the time and page
limits set appropriately on the job card. At many computer installations,
there is a limit set for the maximum number of pages which cannot be exceeded,
even by a page limit on the job card, without special approval. See your
computer systems people for information on this limit at your installation.
454
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 11
Release Date: 4/30/79
Update #: 24
To reduce the size of the report (and thus the cost), it is recommended
that a retrieval be run to select only those records which need to be printed.
Information on retrievals can be found in Section 5.2.
The parameter, site, and parameter standards files are used to obtain
information for the page headings. If no information is available on these
files for a given page of the report, the heading fields involved will be
printed as spaces. It is to your advantage to have the information on these
auxiliary files complete and up to date so that the report will contain as
much valid information as possible.
The option card is not required; the default values are MEAN and DISPLAY
N > 9997. However, if an option card is entered, all information must be
correct or the program execution will be terminated and no report printed.
6.2.3.7 Cost Considerations
The following statistics are from the execution of example 1 on an IBM
370/168 as shown in Section 6.2.3.5.4 and provide an estimate of the cost of
executing ARPMSTR (AQ0230).
Size of input master file: 223 records
Number of detailed report pages printed: 88 pages
CPU time: 5.5 seconds
I/O time: 10.3 seconds
Total time: 15.8 seconds
Estimated cost: $2.67
455
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 12
Release Date: 4/30/79
Update #: . 24
The report generated can be very lengthy, making the program expensive to
run. To keep costs at a minimum, it is recommended that a retrieval be run to
select only those records which need to be printed. See Section 5.2 for
information on retrievals.
6.2.3.8 Related Programs and Procedures
ARPMSTR (AQ0230) can be run in conjunction with many of the other
programs in the system. Section 7.0 provides examples of some of these runs
including retrieval and detailed report; batched retrieval, sort and detailed
report; and sliding average retrieval, sliding average program, and detailed
report.
456
-------
STATE! OKLAHOMA (37)
AQDHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
UO
AQCRl 186 AGENCYl EPA - ATMOSPHERIC SURVEILLANCE
COUNTY: 3020 PROJECT: SPECIAL STUDIES
AREA: 2260 PARAMETER: SOLAR RADIATION
SITE: 995 UNITS: LANGLEYS
SKIATOOK LAKE, TULSA, TULSA CO.
COLLECTION METH: INSTRUMENTAL YEAR: 1977
ANALYSIS METHOD! PYRANOMETER MONTH: AUGUST
SAMPLING INTERVAL! 01 HOURS MIN DETl 1
SAROAD KEY: 372260995A0518 UNITS CODE: 18
KEY-ll 3718630202260995A05177 KEY-21 633011118 KEY-3: 060400
DAY
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
NO
MEAN
MAX
00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
01
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
02
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
03
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
04
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
HOUR
05
0.00
0.01
0.01
0.02
0.02
0.02
0.01
0.02
0.00
0.00
0.01
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0042
0.02
06
0.00
0.12
0.10
0.15
0.14
0.15
0.16
0.03
0.04
0.04
0.08
0.11
0.08
0.01
0.12
0.03
0.03
0.05
0.10
0.03
0.06
0.10
0.10
0.11
0.02
0.02
0.10
0.12
28
.0785
0.16
07
0.02
0.42
0.30
0.44
0.30
0.48
0.46
0.25
0.20
0.18
0.38
0.27
0.06
0.40
0.05
0.18
0.20
0.40
0.32
0.24
0.36
0.32
0.10
0.07
0.20
0.24
26
.263
0.48
08
0.03
0.50
0.36
0.72
0.68
0.68
0.70
0.52
0.31
0.42
0.40
0.66
0.40
0.16
0.70
0.10
0.32
0.42
0.67
0.45
0.68
0.43
0.68
0.74
0.04
0.24
0.51
0.6S
28
.4703
0.74
09
0.36
0.93
0.38
0.98
0.98
0.96
0.80
0.32
0.51
0.14
0.89
0.94
0.59
0.16
0.97
0.16
0.54
0.24
0.88
0.84
0.70
0.86
0.96
1.00
0.05
0.32
0.83
0.72
28
.6432
1.00
10
0.72
0.62
0.88
1.21
1.21
1.16
1.09
0.48
0.73
0.03
1.16
1.06
0.21
1.12
0.20
1.08
0.51
0.84
0.63
0.84
1.10
1.14
1.22
0.08
0.42
1.06
1.16
27
.8133
1.22
11
0.91
.14
.38
.34
.37
.26
.23
0.91
0.85
0.14
1.31
1.27
0.17
1.16
0.18
0.76
.02
.21
.10
.16
.26
.38
.09
.40
.30
.08
26
.9761
1.38
Figure 6.2.3-a. Mean Report
(page 1 of 13)
73 >
m .o
-o o
o a:
•yo oo
—i i
00 >—I
TO m m
o —i o
cr> > —i
TO >—i i—«
> r— o
2 m z
o
3> en
TO TO •
TO m ro
2 -o •
oo o oo
o
ro
CO
o
: TO -o
•o o> &
a. —• to
D) n> to
t+ o>
a> (/>>—>
n> oo
=«=
.. o
Oi
ro n>
OO
o
—I
VO
-------
STATE: OKLAHOMA (37)
AQOHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
AQCRl 186 AGENCYl EPA - ATMOSPHERIC SURVEILLANCE
COUNTYl 3020 PROJECT| SPECIAL STUDIES
AREA: 2260 PARAMETER: SOLAR RADIATION
SITE: 995 UNIT3I LANGLErS
3K1ATOOK LAKE, TULSA, TULSA CO.
COLLECTION METHI INSTRUMENTAL YEAR: 1977
ANALYSIS METHOD: PYRANOMETER MONTH: AUGUST
SAMPLING INTERVAL: 01 HOURS MIN DETt 1
SAROAD KEY: 372260995A0518 UNITS CODE: 18
KEY-U 3718630202260995A05177 KEY-2: 633011118 KEY-3: 080400
DAY
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
NO
MEAN
MAX
12 13
0.78 0.86
.02 0.66
.30 0.96
.43 1.36
.44 f.42
.31 1.33
.19 1.41
0.63 O.S2
0.54 0.44
0.05 0.18
1.30 0.64
1.33 .30
1.23 .08
0.22 .35
1.16 .52
0.40 .40
1.38 .16
0.76 .16
0.98 .08
1.33 .24
1.03 .92
0.98 .00
1.24 .12
1.41 .30
0.18 .18
0.80 .84
1.24 .18
1.22 .12
28 28
.9957 .9189
1.44 1.42
14
1.08
0.74
0.48
1.16
1.22
1.08
1.23
0.59
0.35
0.42
1.11
1.15
0.89
0.52
0.28
0.90
1.10
1.08
1.12
0.84
1.02
1.08
1.14
0.30
0.62
1.04
1.02
27
.8725
1.23
IS
0.72
0.44
0.52
0.97
0.92
0.93
0.73
0.32
0.40
0.54
0.53
0.93
0.74
0.40
0.31
0.20
0.84
0.93
0.90
0.76
0.70
0.88
0.84
0.90
0.14
0.76
0.84
0.82
28
.676
0.97
16
0.46
0.70
0.66
0.70
0.72
0.21
0.23
0.29 ,
0.42
0.02
0.64
0.62
0.20
0.19
0.10
0.58
0.59
0.52
0.58
0.58
0.61
0.61
0.66
0.12
0.56
0.52
0.58
27
.4692
0.72
HOUR
17
0.36
0.21
0.38
0.38
0.39
0.39
0.26
0.13
0.16
0.33
0.00
0.35
0.10
0.30
0.12
0.03
0.30
0.33
0.31
0.38
0.38
0.30
0.24
0.28
0.06
0.20
0.28
0.28
28
.2589
0.39
18
0.10
0.08
0.12
0.10
0.11
0.11
0.07
0.03
0.05
0.06
0.02
0.08
0.03
0.12
0.03
0.00
0.06
0.08
0.13
0.12
0.06
0.07
0.07
0.06
0.02
0.08
0.07
0.05
28
.0721
0.13
19
0.01
0.04
0.01
0.02
0.01
0.00
0.01
0.01
0.00
0.02
0.00
0.01
0.00
0.01
0.01
0.00
0.01
0.01
0.02
0.02
0.00
0.02
0.00
0.00
0.00
0.00
0.00
0.00
28
.0085
0.04
20
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
21
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
'0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
22
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
28
.0
0.00
23
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
0.00
26
.0
0.00
NO.
0
0
0
23
24
24
24
24
24
24
24
24
23
24
22
24
24
24
23
23
24
24
24
23
24
24
24
24
24
24
24
665
MEAN
.2566
.3079
.3263
.4558
.4545
.4406
.3991
.2079
.2029
.1221
.3187
.3581
.3483
.1204
.2954
.0804
.3217
.2975
.372
.3762
.343
.3654
.4041
.4363
.0575
.2229
.382
.3775
.3097
Figure 6.2.3-a - continued. Mean Report
(page 2 of 13)
41
MAX
.08
.14
.38
.43
.44
.33
.41
.91
.65
.54
.31
.33
.27
.52
.16
.40
.38
.16
.08
.33
.10
.16
.26
.41
.30
.84
.30
.22
1.44
-0
•yo
0
CD
J>
3
•yo
•o
CO
—1
•yo
^^
-o
o
ro
CO
0
*-^
c:
•o
0.
{+
to
=*fc
• •
ro
yo
m
-o
O
73
-H
co
o
rn
—i
I— 4
m
0
33
m
o
TO
— i
•yo
o>
tt>
Oi
(/I
n>
o
o>
rt-
n>
co
o
:>
JO
o
JC
CO
1
1-1
CO
m
o
o
z
.
ro
co
-o
OI
i— •
^^
-------
«.o
STATE:
AQCR:
COUNTY:
AREA:
SITE:
YADKIN
DAY
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
37
C 1
28
NO
MEAN 1
MAX
NORTH CAROLINA (34) AQDHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
169 AGENCY: EPA - ATMOSPHERIC SURVEILLANCE COLLECTION METHI TAPE SAMPLER
0960 PROJECT: EPISODE MONITORING ANALYSIS METHOD: TRANSMITTANCE
0001 PARAMETER: SOILING INDEX (COH/1000LF) SAMPLING INTERVAL: 02 HOURS
001 UNITS: COHS/1000 LINEAR FEET SAROAD KEY: 340001001A0616
RD., FAYETTEVILLE, CUMBERLAND CO. KEY-U 3416909600001001A06274 KEY-2:
HOUR
01 03 05 07 09 11 13 15 17 19
0.1 0.1 0.2 0.3 0.5 0.8 0.3 2.1
0.2 0.2 0.4 0.6 1.0 1.6 2.6 4.2
0.5 0.5 1.0 1.5 2.5 4.0 1.5 0.5
0.8 0.8 1.6 2.4 4.0 1.4 0.4 1.8
2.1 2.1 4.2 1.3 0.5 1.8 2.3 4.1
3.7 3.7 2.8 1.7 4.5 1.2 0.7 1.9
6666666600
.233 1.233 1.7 1.3 2.167 1.8 1.3 2.433
3.7 3.7 4.2 2.4 4.5 4.0 2.6 4.2
Figure 6.2.3-a - continued. Mean Report
PAGE 21
YEAR: 1974
MONTH: FEBRUARY
MIN DET: .01
UNITS CODEl 09
112018109 KEY-31 020101
21 23 NO, MEAN MAX
8 .55 2.1
0
0
8 1.35 4.2
0
0
0
8 1.5 4.0
0
0
0
8 1.65 4.0
0
0
0
0
0
8 2.3 4.2
0
0
0
0
0
0
0
0
0
0 2.525 4.5
0 0 48
1.646
4.5
(page 3 of 13)
•^
73
O
73
2
73
•o
CO
— )
73
i
o
ro
CO
0
*— '
5—
-o
Q.
Co
cfr
*
ro
73
m
~O
o
73
— )
CO
0
m
-H
t—t
i—
m
o
73
m
o
73
—\
73
n
CD
O>
(0
o
o>
CD
^
CO
o
VO
^
•O
=c
co
i
^
co
m
o
^^
o
z
.
ro
co
"U
Q>
n>
on
-------
STATE.: NORTH CAROLINA (51)
AOOHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
22
AQCR: 169 AGENCY: EPA - ATMOSPHERIC SURVEILLANCE
CUUNTY: O9t,o PROJECT: EPISODE MONITORING
AREA: 0001 PARAMETER: TOTAL SETTLED PARTICIPATE
SITE: 001 UNITS: TONS/SQUARE MILt-MONTH
YADKIN RD., FAYETTEVILLE, CUMBERLAND CO.
COLLECTION METH: BUCKET; JAR YEAR: 1974
ANALYSIS METHOD: GRAVIMETRIC (APCA) MONTH: MARCH
SAMPLING INTERVAL! 03 HOURS MIN DET: 1.43
SAROAD KEY: 340001001A0616 UNITS CODE: 90
KEY-II 3416909600001001A06374 KEY-21 211017190 KEY-3: 03010?
DAY
01
02
03
04
05
06
07
08
09
10
11
12
13
14
16
17
IB
19
20
21
22
23
24
25
26
NO
MEAN
MAX
02
0.01
0.01
0.02
0.03
0.05
0.06
0.13
0.21
0.33
0.04
0.37
0.41
12
.1408
0.41
OS
0.01
•0.01
0.02
0.03
0.05
0.08
0.13
0.21
0.33
0.04
0.37
0.41
12
.1408
0.41
08
0.02
0.02
0.04
0.06
0.10
0.16
0.26
0.42
0.18
0.10
0.28
0.38
12
.1663
0.42
HOUR
11
0.03
0.03
0.06
0.09
0.15
0.24
0.39
0.13
0.02
0.15
0.17
0.32
12
.1483
0.39
14 .
0.05
0.05
0.10
0.15
0.25
0.40
0.15
0.05
0.20
0.25
0.45
0.20
12
.1916
0.45
17
0.08
0.08
0.16
0.24
0.40
0.14
0.04
0.18
0.22
0.40
0.12
0.02
12
.1733
0.40
20
0.03
0.03
0.26
0.39
0.15
0.04
0.19
0.23
0.42
0.15
0.07
0.22
12
.1616
0.42
23
0.21
0.21
0.42
0.13
0.05
0.18
0.23
0.41
0.14
0.05
0.19
0.24
12
.205
0.42
NO.
6
0
8
0
0
6
0
0
0
8
0
8
8
8
8
0
0
6
0
0
0
8
8
0
0
6
96
MEAN
.055
.055
.135
.14
.15
.165
.19
.23
.23
.1475
.2525
.275
.1667
MAX
0.21
0.21
0.42
0.39
0.40
0.40
0.39
0.42
0.42
0.40
0.45
0.41
0.45
Figure 6.2.3-a - continued. Mean Report
(page 4 of 13)
m jo
-o o
O :r
yo co
—I i
CO •—<
-o o co
yo m m
O —I o
tn 3> —I
yo •—• i—<
•» I" O
yo yo •
-o m ro
3: -o •
co o co
o
ro
co
o
•a n> tu
a. —• «a
o» n n>
c+ o»
» c/» i-«
to o)
=»»=
.. o
o>
c+
ro n>
co
O
-------
STATE: NORTH CAROLINA
AQCRl 169
AGENCY:
AQDHS-U AIR QUALITY DATA REPORT
DISPLAY N>9997
EPA - ATMOSPHERIC SURVEILLANCE COLLECTION METH: INSTRUMENTAL
PAGE
23
YEAR: 1974
COUNTY: 0960 PROJECT: EPISODE MONITORING
AREA: 0001 PARAMETER: CARBON MONOXIDE
SITE.: 001 UNITS: M-GMS/H3 (25DEG C,1013 M-BARS)
YADKIN RD., FAYETTEVILLE, CUMBERLAND CO.
PRIMARY
FEDERAL STANDARD 10.000 UG/M3 (0 C) 8 HR. MAX, 1 PER YR.
STATE STANDARD 10,000 UG/M3 (25 C), 8 HR. MAX, 1 PER YR.
ANALYSIS METHOD: NONDISPEKSIVE INFRA-RED MONTH! APRIL
SAMPLING INTERVAL: oo HOURS MIN DETI .575
SAROAD KEY: 340001001A0616 UNITS CODE: OS
KEY-l: 3416909600001001A06474 KEY-2: 421011105 KEY-il 000103
SECONDARY
10,000 UG/M3 (0 C) 8 HR. MAX, 1 PER YR.
10,000 UG/M3 (25 C) 8 HR. MAX, 1 PER YR.
30 3>
m jo
~o o
O 3C
30 CO
CO HH
DAY
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
NO
MEAN
MAX
03
0.001
0.001
0.002
0.003
0.005
0.008
0.013
0.021
0.033
0.004
0.037
0.041
12
.014
0.041
07
0.001
0.001
0.002
0.003
0.005
0.008
0.013
0.021
0.033
0.004
0.037
0.041
12
.014
0.041
HOUR
11
0.002
0.002
0.004
0.006
0.010
0.016
0.026
0.042
0.018
0.010
0.028
0.038
12
.0168
0.042
IS
0.003
0.003
0.006
0.009
0.015
0.024
0.039
0.013
0.002
0.015
0.017
0.032
12
.0148
0.039
19
0.005
0.005
0.010
0.015
0.025
0.040
0.015
O.OOS
0.020
0.025
0.045
0.020
12
.0191
0.045
23
0.008
0.008
0.016
0.024
0.040
0.014
0.004
0.018
0.022
0.040
0.012
0.002
12
.0173
0.040
NO.
6
6
6
6
0
0
0
6
0
6
0
0
0
0
0
0
0
6
6
6
0
0
6
0
0
6
6
72
MEAN
.0033
.0033
.0066
.01
.0166
.0183
.0183
.02
.0213
.0163
.0293
.029
.0160
MAX
0.008
0.008
0.016
0.024
0.040
0.040
0.039
0.042
0.033
0.040
0.045
0.041
0.045
~O O CO
•yo m m
o — I o
o 3> — i
3D «-••-•
> i— o
m ro
-o •
o co
5
co
£
o
ro
CO
o
•o n> o>
o. — ' ua
at to n
<•+ o»
n v> >-'
n> ~>J
o
o>
ro
Figure 6.2.3-a - continued. Mean Report
(page 5 of 13)
CO
o
-------
STATE: NORTH CAROLINA (34)
cn
ro
AODHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
24
AUCRS 169 AGENCY: EPA - ATMOSPHERIC SURVEILLANCE
COIWV: 0960 PROJECT: EPISUDE MONITORING
AREA: 0001 PARAMETER: CARBON DIOXIDE
SITh: 001 UNITS: M-GMS/M3 (25DEG C,1013 M-BARS)
YAOKIN RD., FAYETTEVILLE, CUMBERLAND CO.
DAY
01
02
03
04
05
06
07
08
09
10
11
12
13
11
15
16
17
IB
19
20
21
22
23
24
25
2b
27
28
29
30
NO
MEAN
MAX
04
.0001
.0001
.0002
.0003
.0005
.0008
.0013
.0021
.0033
.0004
.0037
.0041
12
.0014
.0041
HOUR
10
.0001
.0001
.0002
.0003
.0005
.0008
.0013
.0021
.0033
.0004
.0037
.0041
12
.0014
.0041
16
.0002
.0002
.0004
.0006
.0010
.0016
.0026
.0042
.0018
.0010
.0028
.0038
12
.0016
.0042
22
.0003
.0003
.0006
.0009
.0015
.0024
.0039
.0013
.0002
.0015
.0017
.0032
12
.0014
.0039
HO.
4
0
0
0
0
0 .
0
0
0
4
4
4
4
0
0
0
0
4
4
4
4
4
0
0
0
4
0
0
0
4
48
MEAN
.0001
.0001
.0003
.0005
.0008
.0014
.0022
.0024
.0021
.0008
.0029
.0038
.0014
MAX
.0003
.0003
.0006
.0009
.0015
.0024
.0039
.0042
.0033
.0015
.0037
.0041
.0042
COLLECTION METH: GAS BUBBLER YEAR: 1974
ANALYSIS METHOD: PHENOLPHTHALEIN MONTH: MAY
SAMPLING INTERVAL! 06 HOURS MIN DETI 1.8
SAROAD KEY: 340001001A0616 UNITS CODE: 05
KEY-l: 3416909600001001A06574 KEY-2: 421029105 KEY-3: 050104
Figure 6.2.3-a - continued. Mean Report
(page 6 of 13)
CO
"O C3 CO
73 m m
o —I o
O > —I
3O I—1 fH
3> I— O
2 m z
o
3> (ft
•ya 73 •
T3 m ro
3 ^o •
co o co
—I 70
73 —)
O
ro
co
o
CZ 73 -O
•a «B cu
a. —• to
cu ro fo
r+ CU
n> M i->
a> oo
=«=
cu
rl-
ro a>
CO
o
-4
vo
-------
STATE: HURTH CAROLINA (34)
AODHS-I1 AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
25
AOCR: 169 AGENCY: EPA - ATMOSPHERIC SURVEILLANCE
COUNTY: 0960 PROJECT; EPISODE MONITORING
AREA: 0001 PARAMETER: SULFUR DIOXIDE
SITE: 001 UNITS: U-GMS/M3 (ODEG C, 1013 M-BARS)
YADKIN RD., FAYETTEVILLE, CUMBERLAND CO.
PRIMARY
FEDERAL STANDARD 365 UG/M3 (25 C) 24 HOUR MAXIMUM, 1 PER YEAR
STATE STANDARD 60 UG/H3 (25 C) ANNUAL ARITHMETIC MEAN
COLLECTION METH: DAVIS INSTRUMENT YEAR: 1974
ANALYSIS METHOD: SEQUENTIAL-CONDUCTOMETRIC MONTH: JUNE
SAMPLING INTERVAL: oa HOURS MIN OET: 28.6
SAROAD KEY: 340001001A0616 UNITS CODE: 02
KEY-l: 3416909600001001A06674 KEY-2: 424013302 KEY-3: 060105
SECONDARY
1300 UG/M3 (0 C), 3 HR. MAX.,I PER YR
0.4 PARTS/MILLION, 3 HR.MAX, I PER YEAR
DAY 05
01
02
03
04
05
06
07
08
09
10
£ >«
CO 12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
HOUR
13
21
NO.
MEAN
NO 12 12 12
MEAN 1.408 1.408 1.683
MAX 4.1 4.1 4.2
36
1.500
MAX
0.1
0.1
0.2
0.3
0.5
0.8
1.3
2.1
3.3
0.4
3.7
4.1
0.1
0.1
0.2
0.3
0.5
0.8
1.3
2.1
3.3
0.1
3.7
a.i
0.2
0.2
o.a
0.6
1.0
1.6
2.6
a. 2
1.8
1.0
2.8
3.8
3
3
3
3
3
3
3
3
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
3
0
3
0
3
0
3
.1333
.1333
.2666
.4
.6666
1.067
1.733
2.8
2.B
.6
3.4
4.
0.2
0.2
0.4
0.6
1.0
1.6
2.6
4.2
3.3
1.0
3.7
4.1
4.2
Figure 6.2.3-a - continued. Mean Report
(page 7 of 13)
m wO
•o o
O DC
73 co
co •-«
"o o co
73 m pi
o —I o
cr> f* —I
73 i—i »—«
^ I— O
> CD
73 73 •
co o co
—I 73
73 -\
O
IV3
CO
O
•o n> at
a. — • to
o> n to
e+ 0>
(D
VO
=*=
ro
CU
CO
o
-------
STATE: NORTH CAROLINA (34)
AUDHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
169 AGENCY: EPA - ATMOSPHERIC SURVEILLANCE
COUNTY: cmo PROJECT: EPISOPE MONITORING
AREA: 0001 PARAMETER: NITROGEN DIOXIDE
SITE: 001 UNITS: PARTS PER MILLION (VOL/VOL)
YADKIN RD., FAYETTEVILLE, CUMBERLAND CO.
PRIMARY
FEDERAL STANDARD O.OS PARTS/MILLION, ANNUAL ARITHMETIC
STATE STANDARD 0.03 PARTS/MILLION, ANNUAL ARITHMETIC
COLLECTION METH: GAS BUBBLER YEAR: 1974
ANALYSIS METHOD: SALTZMANdOOML TU+ORIFIC) MONTH: JULY
SAMPLING INTERVAL: 12 HOURS MIN DET: .0027
SAROAD KEY: 340001001A0616 UNITS CODE: 07
KEY-II 3416909600001001A06774 KEY-2: 426028207 KEY-3: 070106
SECONDARY
MEAN o.os PARTS/MILLION, ANNUAL ARITHMETIC MEAN
MEAN 0.03 PARTS/MILLION, ANNUAL ARITHMETIC MEAN
m jo
-o o
o i
50 00
—I :
to i—i
HOUR
DAY
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
NO
MEAN
MAX
06
0.01
0.01
0.02
0.03
0.05
0.08
0.13
0.21
0.33
0.04
0.37
0.41
12
.1408
0.41
18
0.01
0.01
0.02
0.03
0.05
0.08
0.13
0.21
0.33
0.04
0.37
0.41
12
.1408
0.41
NO.
2
0
2
0
2
0
2
0
0
0
0
0
0
2
0
0
0
0
0
2
0
2
0
2
0
2
0
2
0
2
2
24
MEAN
.01
.01
.02
.03
.Ob
.08
.13
.21
.33
.04
.37
.11
.1408
MAX
0.01
0.01
0.02
0.03
0.05
0.08
0.13
0.21
0.33
0.04
0.37
0.41
0.41
TO m m
O ~H O
O > —I
TO •—i •—>
> I— O
3
co
70
o
ro
CO
o
Q.
Qi
(D
=«*=
ro
•*»
70
m
ro
•
co
m
at
CO
Oi
-o
O)
ro
o
Figure 6.2.3-a - continued. Mean Report
(page 8 of 13)
co
o
-------
STATE: OKLAHOMA
AUCR: 184
COUNTY: 0600
AREA: 0001
SITE: 234
(37) AODHS-11 AIR QUALITY DATA
AGENCY: STATE
PROJECT: SPECIAL STUDIES
PARAMETER: TOTAL SUSPENDED PARTICULATE
DISPLAY N>9997
COLLECTION
REPORT
METH:
ANALYSIS METHOD:
HI-VOL
GRAVIMETRIC
SAMPLING INTERVAL: DAILY
UNITS: U-GMS/M3 (25DEG C,1013 M-BARS) SAROAO KEY:
MCALISTER RD., NORMAN, CLEVELAND CO.
FEDERAL STANDARD
STATE STANDARD
DAY JAN
01
02
03
04
AC
V J
06
07
08
09
10
11
12
CT> 13
cn 14 66
15
16
17
18 67
19
20
21 40
22
23
24
25 45
26
27
28 52
29
30
31
NO 5
MEAN 54.
MAX 67
PRIMARY
370001234F0518
KEY-l: 3716406000001234F05671 KEY-2: 111019101
75 UG/M3 (25 C) ANNUAL GEOMETRIC MEAN
250 UG/M3 (25 C) 24 HOUR MAXIMUM, 1
'MONTH
FEB MAR APR MAY JUN
101 60
60
168
7 n Q./I
1 U jM
177
38 38
51
40 76
42 37
99
80 83
62 77
51 52
48 71
63 51
73
70 68
40
113
45
103
56786
70.2 71.5 74.14 79.38 54.5
101 103 177 168 71
PER YEAR
60
120
JUL AUG
Qft
7V
62
59
77
89
31
30
52
38
57
10
58.5 56.
90
44
n 4.
MO
31
72
39
22
89
95
56
48
63
66
87
13
31
95
UG/M3 (25
UG/M3 (25
SEP
56
SO
57
59
74
44
7
34
35
19
34
39
12
42.33
74
SECONDARY
C) ANNUAL GEOMETRIC
C) 24 HOUR MAXIMUM,
YEAR: 1971
MIN DETl
UNITS CODE:
PAGE
1
01
34
KEY-3: 010100
MEAN
1 PER YEAR
OCT NOV DEC NO.
17 35
34
7ft
1 V
37
52
54 38
43
50
20
11
35
37
37
23
32 24
13 5
37. 33.6 21
70 38
2
25
o
Ol
CD
^
CO
0
vo
JO
\*J
co
l_
•— '
CO
m
o
— t
32
CD
ro
co
-X3
0)
(Q
ro
-------
STATE: OKLAHUHA (57)
AQOHS-IJ AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
59
AQCR: 166
CUUNTV: 3020
AREA: 3020
SITE: 996
SPERRY, TULSA,
MEEK JAN
01
02
03
04
OS
NO 0
MEAN
MAX
en
ci
AGEI
PRO
PAR
UNI
TULSA
FtB
.0500
500
50.0
0.500
.0500
5
110.1
500
EPA - ATMOSPHERIC SURVEILLANCE
: SPECIAL STUDIES
PARAMETER! LAPSE RATE
PEG. CENTIGRADE/100 M
COLLECTION METHl INSTRUMENTAL YEARl 1965
ANALYSIS METHODl ELEC. / MACH. AVG. L2-LI
SAMPLING INTERVAL: MEEKLY MIN DETl -99.0
SAROAD KEY: 373020996AOS18 UNITS CODE: 26
KtY-U 3718630203020996A05965 KEY-21 612022128 KEY-3: 020200
MAR
APR
MONTH
MAY JUN
JUL
AUG
SEP
OCT
NOV
DEC
NO.
MEAN
MAX
.05 .0500
500. 500
50. 50.0
.5 0.500
.05 .0500
110.1
500
m jo
-o o
o oc
•ya in
-H I
CO •—•
~o o c/>
"yo rn m
O —I o
O •> —I
30 >—< >—"
3> I— O
3 3 z
S> en
50 X3 •
-o m ro
GO
O CO
-x>
O
ro
CO
O
Figure 6.2.3-a - continued. Mean Report
(page 10 of 13)
er xi -o
•o n> o»
Q. —• to
tu n n
c* O)
m w ro
• n> ro
=«fc
.. o
fu
c*
ro n>
co
o
vo
-------
STATE: NORTH CAROLINA (j9997
PAGE
73
m
AQCRs 170 AGENCY: EPA - ATMOSPHERIC SURVEILLANCE
COUNTY: 2980 PROJECT: EPISODE MONITORING
AREA: 0001 PARAMETER: OXIDES UF NITROGEN
SITE: 000 UNITS: PARTS PER MILLION (VOL/VOL)
GUM BRANCH HD., JACKSONVILLE, ONSLOW CO.
COLLECTION METH: GAS BUBBLER YEAR: 1973
ANALYSIS METHOD: SALTZMAN METHOD
SAMPLING INTERVAL: MONTHLY MIN DETI .0027
SAKOAD KEY: 340001004A0617 UNITS CODE: 07
KEY-I: 3417029B00001004A06A73 KEY-2: 426039907 KEY-3: 010100
>
jo
o
:E
(/>
—\ :
co •-«
o
73
SITE JAN
004 .0026
FEB
.0025
MAR
.0999
APR
.0023
MONTH
MAY JUN
.0022 .0021
JUL
.0999
AUG
.0023
SEP
.0024
OCT
.0025
NOV
.0026
DEC
.0025
NO.
12
MEAN
.0166
MAX
.0999
•o o co
73 m m
o —) o
CTJ ^ |H
3> I— O
cr>
-vl
73 73 •
-o m ro
3: -o •
c/> o co
-H ?0
30 —I
o
PO
CO
o
ez 73
ex
fu
fu
v>
n>
o
cu
ro n>
0>
=tt=
-o
CU
CQ
n>
ro
co
Figure 6.2.3-a - continued. Mean Report
(page 11 of 13)
CO
o
-J
vo
-------
STATE: NORTH CAROLINA (34)
AODHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
19
AQCR: 166 AGENCY: EPA - ATMOSPHERIC SURVEILLANCE
COUNTY: 2120 PROJECT: EPISODE MONITORING
AREA: 0001 PARAMETER: ALDEHYDE
SITE: 002 UNITS: U-GMS/MS (OUEG c, 1013 M-BARS)
HMY. 301 BUS., SMITHFIELD. JOHNSTON CO.
COLLECTION METH: GAS BUBBLER YEAR: 1972
ANALYSIS METHOD: PARAROSANILINE
SAMPLING INTERVAL: QUARTERLY MIN DET: 5.5
SAROAD KEY: ' 340001002A0616 UNITS CODE: 02
KEY-1: 3416621200001002A06B72 KEY-2: 43S019202 KEY-3: 010100
QUARTER
SITE
002
1ST
11.9
2ND
12.8
3RD
13.2
4TH NO.
10.1 4
MEAN
12.
MAX
13.2
00
Figure 6.2.3-a - continued. Mean Report
(page 12 of 13)
73 f*
m d
-o o
o re
TO CO
—i i
CO !-•
~O CJ CO
•yo m m
O — I O
O 3> — I
TO •— « •— t
^ I— O
5c m z
-o m ro
2 -o •
CO O CO
co
O
.
•o m o>
a. — • «a
01
v>
n>
a>
«-»•
n>
=»»:
.. o
a>
c*
ro re
CO
o
10
n>
ro
-------
STATE.: NURTH CAROLINA (34)
AQDHS-II AIR QUALITY DATA REPORT
DISPLAY N>9997
PAGE
-o o
o :c
70 CO
—i i
CO i-t
AQCR: 136 AGENCY: COUNTY
COUNTY: ITBO PROJECT* COMPLAINT INVESTIGATION
AREA: 0003 PARAMETERS FORMALDEHYDE
SITE.: 002 UNITS: U-GMS/MS (25DEG c.iois M-BARS)
HEIDSVILLE HWY., GREENSBORO. GUILFORD CO.
COLLECTION METH: GAS BUBBLER YEAR: I960
ANALYSIS METHOD: CHROMATROPIC ACID
SAMPLING INTERVAL: COMPOSITE MIN OETl .5
SAROAD KEY: 34000300360413 UNITS CODE: 01
KEY-1: 34136I7800003002G04C60 KEY-2: 435029101 KEY-3: 590052
COMPOSITE TYPE: ANNUAL
PD RDING SAMPLES TIME-CODE
00
2.3
52
-p.
O*
10
NO 1
MEAN 2.3
MAX 2.3
•O O CO
?o m m
O —I O
CD 3> -H
JO i—i i—i
Jg I— O
3E m -z.
3O 5O •
-o m ro
CO
o
•yo
o
ro
co
o
er TO -o
•a n> o>
a. — • ta
o» n> n>
c* o»
a) ro
a> en
=*=
Oi
ro
Figure 6.2.3-a - continued. Mean Report
(page 13 of 13)
CO
o
-------
STATE! HAWAII (12)
AQDHS-II AIR QUALITY DATA REPORT - SLIDING AVERAGE INTERVAL
DISPLAY >0.5
PAGE
AQCRl 060 AGENCY: EPA - EFFECTS RESEARCH
COUNTY! 0140 PROJECT: POPULATION-ORItNTED SURV.
AREA! 0001 PARAMETER: WIND DIRECTION
SITE: 003 UNITS: DEGREES (COMPASS)
WAIKIKI, HONOLULU, HONOLULU CO.
COLLECTION MtTH: INSTRUMENTAL YEAR: 1973
ANALYSIS METHOD: ELEC. OR MACHINE AVERAGE MONTH: SEPTEMBER
SAMPLING INTERVAL: 01 HOURS MIN DET: 1.0
SAROAD KEY! 12000J003C0106 UNITS CODE: 14
KEY-l: 1206001400001003C01173 KEY-2: 611025014 KEY-3: 091200
DAY
01
02
03
04
05
06
07
08
09
10
11
12
00
01
02
03
04
HOUR
05
06
07
06
09
10
11
5.500
5.000
4.333 3.333
2.667
3.333
3.333
3.667 3.333 3.333 3.667
•** INDICATES SLIDING AVERAGE VALUE NOT COMPUTED DUE TO INSUFFICIENT NUMBER OF READINGS IN FILE.
BLANK INDICATES SLIDING AVERAGE VALUE DID NOT MEET DISPLAY CRITERIA OR DID NOT MEET SELECTION CRITERIA.
Figure 6.2.3-b. Sliding Average Report
(page 1 of 2)
70 Js
m jo
-o a
o n:
73 GO
—I i
GO >-<
-o o — I
TO i— i t— •
3> i— o
-o
2
co
o
ro
GO
O
01
TO •
m ro
-o «
o to
13 CD CU
a. —' (o
O) fD fD
rt- O)
cn ro
n> CT>
n>
=»=
ro
Cu
GO
o
VO
-------
STATES HAWAII (12)
AODHS-II AIR QUALITY DATA REPORT - SLIDING AVERAGE INTERVAL *
DISPLAY >O.S
AQCR: 060
COUNTY: 0100
AREA! 0001
SITE: 003
AGENCYt
PROJECT:
PARAMETERI
UNITS:
NAIKIKI, HONOLULU, HONOLULU CO.
EPA » EFFECTS RESEARCH
POPULATION-ORIENTED SURV.
MIND DIRECTION
DEGREES (COMPASS)
COLLECTION METHs INSTRUMENTAL
ANALYSIS METHOD: ELEC. OR MACHINE AVERAGE
SAMPLING INTERVALS 01 HOURS
SAROAD KEY! 120001003C0106
PAGE
YEAR: 1973
MONTH! SEPTEMBER
MIN DETl 1.0
UNITS CODE! la
KEY-!: 1206001400001003C01173 KEY-2S 611025011 KEY-31 091200
DAY
01
02
03
oo
OS
06
07
08
09
10
II
12
12
14
16
HOUR
17
16
20
21
22
23
3.333
3.333
3.000
2.667 2.667 2.333 3.000
3.000
3.333 2.667
3.000
3.000
•** INDICATES SLIDING AVERAGE VALUE NOT COMPUTED DUE TO INSUFFICIENT NUMBER OF READINGS IN FILE.
BLANK INDICATES SLIDING AVERAGE VALUE DID NOT MEET DISPLAY CRITERIA OR DID NOT MEET SELECTION CRITERIA.
Figure 6.2.3-b - continued. Sliding Average Report
(page 2 of 2)
-o o
o in
•yo co
—I i
co »-i
TO a
yo m
o
cn >
•yo >—i •—<
^ r- o
-H O
co
— (
•yo
o
ro
co
o
-o
o
co
c. •yo -o
-o n tu
CL — ' ua
Q) flj O)
<-»• o>
o> ro
(D "^l
Q>
«-»•
ro n>
co
o
-vl
VO
-------
ro
STATE: NORTH CAROLINA (3'10
PAGE
AQCR: 169 AGENCY; EPA - ATMOSPHERIC SURVEILLANCE
COUNTY: 0960 PROJECT: EPISODE MONITORING
AREA: 0001 PARAMETER:
SITE: 001 UNITS:
COLLECTION METH:
ANALYSIS MtTHOD:
SAMPLING INTERVAL! 12 HOURS
SAROAD KEY: 340001001 A0616
YEAR: 1979
MONTH: FEBRUARY
WIN OET:
UNITS CODE: OH
YAPKIN RD., FAYtTTEVILLE, CUMBERLAND CO. KEY-1 : 341690960000 1 00 1 A067/9 KEY-2: 426028208 KEY-3: 020106
PRIMARY SECONDARY
FEDERAL STANDARD JOO UG/M3 (25 C), ANNUAL ARITHMETIC MEAN 100 UG/M3 (25 C), ANNUAL ARITHMETIC MEAN
STATE STANDARD 90 UG/M3 (0 C) ANNUAL ARITHMETIC MEAN 90 UG/M3 (0 C) ANNUAL ARITHMETIC MEAN
DAY
01
02
03
04
05
Ob
07
Ofl
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2b
26
27
28
HOUR
06
10.00
10.00
20.00
30.00
18
10.00
10.00
20.00
30.00
flO.OO
130.0
210.0
330.0
40.00
370.0
410.0
ao.oo
130.0
210.0
330.0
40.00
370.0
410.0
NO.
SUM
20.0000
20.0000
40.0000
60.0000
160.000
260.000
420.000
660.000
RO.OOOO
740.000
B20.000
Figure 6.2.3-c. Sum Report
m
o
73
>
XD
O
00
—I I
GO •— «
70
O
CD
oo
— I
73
JO
O
ro
oo
O
o oo
m m
—I o
m
o
m ro
-O •
o oo
73
a 73
-o to
Q. —•
CD n>
e-i- o>
n «/>
ft>
=*=
.. o
ro o>
-^ ..
oo
o
ro
CO
-------
AODHS-II MASTER FILE DETAILED REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAMEi ARPMSTR (AQOa)O)
REVISION LEVEL: 1-00
LAST UPDATE *: 21
DATE INCORPORATED: OCTOBER 31, 1976
USER-SPECIFUD OPTIONI MEAN DISPLAY N > 9997
NUMBER OF OPTION STATEMENTS READ:
NUMBER OF MASTER FILE RECORDS READ:
NUMBER OF REPORT PAGES WRITTEN:
NUMBER OF ERRORS DETECTED:
2
331
71
0
Co
Figure 6.2.3-d. Diagnostic Report
o
•70
.o
o
co
co «-t
73
O
tn
73
%
-o
2
CO
—(
73
o
ro
CO
o
m
m
o
73
m
o
73
CO
m
o
ro
•
co
a 73 -o
-o n> 01
a. — • to
cu CD n>
t+ o>
n> m ro
n> vo
Cu
ro CD
•£> ••
CO
O
vo
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 30
Release Date: 4/30/79
Update #: . 24
[OPTION-1] [OPTION-2]
The options can appear In any order and in any position on the card with the
following exceptions:
1. There can be only one card.
2. All options must be punched within columns 1 through 72, inclusive.
3. There must be at least one space between the options if both are
specified. A comma may be used as a separator rather than one or
more spaces, and spaces may precede and/or follow the comma.
Figure 6.2.3-e. Option Card Format
474
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 31
Release Date: 4/30/79
Update #:. 24
PROCEDURE NAMES AORPM20
REVISION LEVEL: i-oo
LAST UPDATE »: 24
DATE INCORPORATED; OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO GENERATE A DETAILED LISTING OF
THE AQDHS-II MASTER FILE
//*
//»
//*
//*
//*
//*
//*
//*
//*
//*
//AORPM20 PROC PROJECT='CN.EPALMH. A087.CDHS.HQ. AQS' ,
// PROGRAM=ARPMSTR,
// MSTRFIL=AQMASTER,
// PARMFIL=AQPARMFL,
// SITEFIL=AQSITEFL,
// STANFIL=AQSTANFL,
// REGION1=190K,
// T1ME1='1,0',
// OUT=A
//*
//REPORT EXEC PGM=RPROGRAM,
// REGIONs®IONl,
// TIME=(UIME1)
//*
//* PRODUCE A DETAILED LISTING OF THE MASTER FILE
//*
//STEPLIB DO OSNAME=&PROJECT..LOAD,
// VOLUME=(PR1VATE, RETAIN),
// DISP=(SHR,PASS)
// DD DSNAME=SYS1.COBLIB,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - CONTROL CARD
//*
//AOSINPUT DD DDNAMEaOPTIONS,
// DCB=BLKSIZE=eO
//*
//* INPUT DATA SET - MASTER FILE
//AOSMASTR DD DSNAME=&PROJECT , .DATA.RMSTRFIL,
// VOLUME=(PRIVATE, RETAIN),
// D1SP=(SHR,PASS)
//*
//* INPUT DATA SET • PARAMETER FILE
//*
//AQSPARMC OD PSNAMEe&PROJECT. .OATA. RPARMF IL,
// Vl'LUME=(PRIVATE, RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - SITE FILE
//*
//AOSSITES DD DSNAME=RPROJECT. .DATA.&SI TEFIL,
// VOLUMF.s(PRIVATE, RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA Sf.T - PARAMETER STANDARDS FILE
//*
//AQ3TNDRD DD DSNAHKs&PRflJCCT . .DATA.&STAfJFIL,
00000100
00000200
00000300
00000400
00000500
00000600
00000700
00000800
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003.SOO
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004SOO
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005HOO
(page 1 of 2)
Figure 6.2.3-f. Cataloged Procedure AQRPM20
475
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 32
Release Date: 4/30/79
Update #: 24
it
n*
II* OUTPUT
II*
//AQSPRINT
II*
//AQSRFPT3
II*
//* OUTPUT
It*
//3YSPRINT
II*
//SYSOUT
//SYSDBOUT
II*
//SYSDTERM
II*
//SY3UDUMP
II*
VOLUMEa(PRIVATE,RETAIN),
l)I3P=(3HR,PA9S)
DATA SET - DETAILED REPORT
OD SYSOUTs&OUT
DO SYS()UT=ROUT
DATA SETS - SYSTEM OPERATION
DO 3YSOUTB&OUT
DO 3Y30UT=ROUT
DD SYSOUTa&UUT
UD SYSOUTs&OUT
DO 3Y30UTB&OUT
OOOOS<'00
00006000
00006100
00006200
OOOObiOO
00006400
00006500
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
Figure 6.2.3-f - continued,
(page 1 of 2)
Cataloged Procedure AQRPM20
476
-------
AQDHS-II
REPORTS
SECTION 6.2.3
DETAILED REPORT
PROGRAM ARPMSTR (AQ0230)
Page 35
Release Date: 5/01/80
Update #: 27
Parameter
Name
PROJECT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS'
PROGRAM
MSTRFIL
PARMFIL
SITEFIL
STNDFIL
REGION1
TIME1
ARPMSTR
AQMASTER
AQPARMFL
AQSITEFL
AQSTANFL
190K
'1,0'
OUT
Description
Highest-level of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQMASTER
would be the full data set name of the
AQDHS-II master file)
Master file detailed report program
Lowest-level index of master file
Lowest-level index of parameter file
Lowest-level index of site file
Lowest-level index of parameter standards
file
Region allocated for execution of ARPMSTR
Time in minutes and seconds allocated for
execution of ARPMSTR
SYrOUT class for all print files
Figure 6.2.3-g. Substitutable Parameters for AQRPM20
477
-------
AQDHS-II
REPORTS
SECTION 6.2.4
PARAMETER FILE REPORT
PROGRAM ARPPARM (AQ0240)
Page 1
Release Date: 10/31/81
Update #: 29
6.2.4 PARAMETER FILE DETAILED REPORT PROGRAM - ARPPARM (AQ0240)
6.2.4.1 Description
ARPPARM (AQ0240) produces a formatted listing of the AQDHS-II parameter
file. The contents of each parameter file record are listed on two print
lines and appropriate labels- are printed to identify the individual fields.
6.2.4,2 File Formats
The parameter file is the only input to ARPPARM (AQ0240); for the
parameter file format, see Figure 4.2.2-c. The detailed report is the only
output; see Figure 6.2.4-a for a sample detailed report. Note the indented
line at the bottom of the report page: it contains the parameter key
| information for the first record listed on the page. The footnote line at the
bottom of each page allows the user to easily scan through the report to
locate particular parameters.
6.2.4.3 Options
There are no options.
6.2.4.4 Error Messages
There are no error messages.
6.2.4.5 Cataloged JCL
6.2.4.5.1 JCL 1isting - ARPPARM (AQ0240) can be run by executing the
cataloged procedure AQRPP10. See Figure 6.2.4-b for a listing of this
procedure.
478
-------
AQDHS-II
REPORTS
SECTION 6.2.4
PARAMETER FILE REPORT
PROGRAM ARPPARM (AQ0240)
Page 2
Release Date: 4/30/79
Update #: 24
6.2.4.5.2 Cross-reference of DP names and files
Program Name: ARPPARM (AQ0240)
DP Name File Description Input/Output
AQSPARM AQDHS-II parameter file Input
AQSPRINT Detailed report Output
6.2.4.5.3 User-supplied JCL - To execute AQRPP10, the user will need to
specify the name of the parameter file. See Figure 6.2.4-c for a description
of the procedure's substitutable parameters.
6.2.4.5.4 Sample run stream - The following run stream would generate a
detailed report of the parameter file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
PARM0001':
// EXEC AQRPP10,
// PARMFIL=PARM0001
6.2.4.6 Warnings and Special Instructions
There are no warnings and no special-instructions.
6.2.4.7 Cost Considerations
The following estimates are for the execution of ARPPARM (AQ0240) on an
IBM 370/168:
479
-------
AQDHS-II
REPORTS
SECTION 6.2.4
PARAMETER FILE REPORT
PROGRAM ARPPARM (AQ0240)
Page 3
Release Date: 4/30/79
Update #: 24
Number of records in AQDHS-II parameter file:
CPU time:
I/O time:
Total time:
100 records
0.3 second
2.2 seconds
2.5 seconds
Estimated cost:
$0.54
6.2.4.8 Related Programs and Procedures
Normally, the parameter file report procedure, AQRPP10, will be executed
following an update of the parameter file. AQEMP10 is the parameter file
maintenance procedure; see Section 4.2.2.5 for a discussion of this
procedure.
480
-------
AQDHS-II PARAMETER FILE LISTING
PAGE
REVISION LEVEL: 2-00
LAST UPDATE 8: 29
DATE INCORPORATED: OCTOBER 31,
PARAMETER METHOD UNITS MIN
CODE CODE CODE DET
11101
11101
11201
21101
21101
21101
21101
21101
21101
42101
42101
42101
42101
42101
91
92
81
51
51
71
71
81
81
11
11
11
21
21
01
02
09
90
91
90
91
90
91
05
06
07
05
07
0001
0011
0001
0143
0005
0143
0005
0143
0005
0575
0628
0004
0063
0004
1981
DEC STANDARD UNITS
IND CODE CONV FACTOR
0 01 1.00000
1 01 .91600
2 01 1.00000
2 93 .35030
2 93 10.00000
2 93 .35030
2 93 10.00000
2 93 .35030
2 93 10.00000
3 05 1.00000
3 05 .91600
1 05 1.15000
2 05 1.00000
1 05 1.15000
USER UNITS
CODE CONV FACTOR
01 1.00000
02 l.OOOQO
09 1.00000
90 1.00000
91 1.0000"
90 l.noooo
91 1.00000
90 1.00000
91 1.00000
05 1.00000
06 1.00000
07 1.00000
05 1.00000
07 1.00000
1
PARAMETER DESCRIPTION
UNITS DESCRIPTION
TOTAL SUSPENDED PARTICULATE
U-GKS/M3 (25DEG C.1013 M-BARS)
TOTAL SUSPENDED PARTICULATE
U-GMS/M3 (ODEG C, 1013 M-BARS)
SOILING INDEX (COH/1000LF)
COHS/1000 LINEAR FEET
TOTAL SETTLED PARTICULATE
TONS/SQUARE MILE -MONTH
T^TAL SETTLED PARTICULATE
- 3MS/SQUARE CENTIMETER-MONTH
TOTAL SETTLED PARTICULATE
TONS/SqUARE MILE-MONTH
TOTAL SETTLED PARTICULATE
M-GMS/SQUARE CENTIMETER-MONTH
TOTAL SETTLED PARTICULATE
TONS/SqUARE MILE-MONTH
TOTAL SETTLED PARTICULATE
M-GMS/SQUARE CENTIMETER-MONTH
CARBON MONOXIDE
Mpwc /MT I 9 cnPP f 1 A 1 T M RAD^l
— oTiO/TlJ 1 cDU to I* > 1U 1 J D— OAK 3 /
CARBON MONOXIDE
M-GMS/M3 (ODEG C, 1013 M-BARS)
CARBON MONOXIDE
PARTS PER MILLION (VOL/VOL)
CARBON MONOXIDE
M-GMS/M3 (25DEG C.1013 M-BARS)
CARBON MONOXIDE
PARTS PER MILLION (VOL/VOL)
ANALYSIS METHOD
COLLECTION METHOD
GRAVIMETRIC
HI-VOL
GRAVIMETRIC
MEMBRANE SAMPLE
TRANSMITTANCE
TAPE SAMPLER
GRAVIMETRIC
BUCKET; JAR
GRAVIMETRIC
BUCKET; JAR
GRAVIMETRIC (APCA)
BUCKET; JAR
GRAVIMETRIC (APCA)
BUCKET; JAR
GRAVIMETRIC (ASTM)
BUCKET; JAR
GRAVIMETRIC (ASTM)
BUCKET; JAR
NONDISPERSIVE INFRA-RED
TkicTDI IMFKITAI
Xri.9 1 KUntri I AL
NONDISPERSIVE INFRA-RED
INSTRUMENTAL
NONDISPERSIVE INFRA-RED
INSTRUMENTAL
GAS CHROMATOGRAPHIC
INSTRUMENTAL
GAS CHROMATOGRAPHIC
INSTRUMENTAL
34RM CODE: 11101* METHOD: 91* UNITS CODE: 01** PAGE 0001
REPORTS
-0 T3
TO ^&
0 TO
70 2
3> m
3 —1
rn
~3> TO
TO
T3 <— i
f* l~~
TO m
TO
fa ~O
JC3 0
O TO
ro —1
-p.
0
c: TO
~o ro
Q. — '
o> ro
ft- Ol
ro
ro
•• 0
Ol
ro ro
t — »
o
CO
1 — t
CO
o
3:
CO
1— H
CO
m
o
—1
o
•z.
-------
NUMBER OF PARAMETER FILE RECORDS READ:
NUMBER OF PARAMETER FILE RECORDS LISTED:
PE03RAM-UAME: ARPPARM (AQOZ^O)
REVISION LEVEL: Z-00
LAST UPDATE »: 29
DATE INCORPORATED: OCTOBER 31, 1931
ARPPARM (AQOZ40) SUMMARY MESSAGES
69
89
CO
PO
(Page 2 of 2)
Figure 6.2.4-a - continued. Parameter File Detailed Report
73 3>
m o
-o o
o :c
TO (S>
—I I
OO i—"
o
CD
-o •—i
3=« r—
TO m
3
TO
" ' m
3» -O
JCD O
O 70
m
o
en
•
ro
c:
•a
a.
QJ
r-l-
fD
ro
VJD
IT QJ
—• U3
n> n>
a>
o
QJ
I—•
o
OJ
co
tn
-------
AQDHS-II
REPORTS
SECTION 6.2.4
PARAMETER FILE REPORT
PROGRAM ARPPARM (AQ0240)
Page 6
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME: AQRPP10
REVISION LEVEL: i-oo
LAST UPDATE »: 2«
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO PRODUCE A DETAILED LISTING OF
THIS AQDHS-II PARAMETER FILE
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AORPP10 PROC PROJCCTs'CN.EPALMH.A087.CDHS.HO.AQS',
// PROGRAMsARPPARM,
// TIME1='2,0',
// PARMFIL=AQPARMFL,
// I)UT = A
//*
//METHPRT EXEC PGMs&PROGRAM,
I/ TIMEs(&TIMEl)
//*
//* LISTING OF AQDHS-II PARAMETER FILE WITH APPROPRIATE HEADINGS
//* AND FOOTNOTES
//*
//STEPLIB DD DSNAMEs&l'ROJECT..LOAD,
// VOLUMEs(PRIVATE,RETAIN),
// DISP=(SHH,PASS)
//*
//* INPUT DATA SET - PARAMETER FILE
//*
//AOSPARM DD DSNAMEsRPROJECT..DATA.&PARMFIL,
// VOLUMEs(PRIVATE,RETAIN),
// DISPa(SHR,PASS)
//*
//* OUTPUT DATA SET - PARAMETER FILE LISTING
//*
/VAOSPRINT DD SYSOUT=&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUTs&OUT
//*
//SYSOUT DD SYSUUT=RUUT
//*
//SYSOBOUT DD SYSOUTs&OUT
//*
//SYSDTERM DD SYSOUT=ROUT
//*
/XSYSUDUMP DD SYSOUT=fcOUT
//*
00000100
00000200
00000300
00000400
00000500
00000600
00000700
00000800
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003SOO
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
Figure 6.2.4.b. Cataloged Procedure AQRPP10
483
-------
AQDHS-II
REPORTS
SECTION 6.2.4
PARAMETER FILE REPORT
PROGRAM ARPPARM (AQ0240)
Page 7
Release Date: 4/30/79
Update #: 24
Parameter
Name
Default
Value
Description
PROJECT 'CN.EPALMH.A087,
CDHS.HQ.AQS1
PROGRAM
TIME1
PARMFIL
OUT
ARPPARM
'2,0'
AQPARMFL
A
Highest-level index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
AQPARMFL would be the full data set name of
the parameter file)
Parameter file report program
Time allocated for execution of ARPPARM
Lowest-level index of parameter file
SYSOUT class for all print files
Figure 6.2.4-c. Substitutable Parameters for AQRPP10
484
-------
AQDHS-II
REPORTS
SECTION 6.2.5
PARAMETER STANDARDS FILE
ARPSTND (AQ0250)
Page 1
Release Date: 4/30/79
Update #: 24
6.2.5 PARAMETER STANDARDS FILE DETAILED REPORT PROGRAM - ARPSTND (AQ0250)
6.2.5.1 Description
ARPSTND (AQ0250) produces a detailed report of the AQDHS-II parameter
standards file. The report is in a columnized format which includes headings
and a footnote feature. The footnote appears at the bottom right-hand side of
each page and contains the parameter code, state code, and standard number
of the first parameter standard record appearing on that page. The footnote
also contains the report page number.
6.2.5.2 File Formats
The AQDHS-II parameter standards file, is the only input to ARPSTND
(AQ0250). This file is not checked for sequence errors by this program;
therefore, the report will be in the same sequence as the AQDHS-II parameter
standards file. See Figure 4.4.2-a for a description of the record format for
the parameter standards file.
The report output by the program contains the detailed listing and
diagnostic messages. See Figure 6.2.5-a for a sample of this report.
6.2.5.3 Options
There are no options.
6.2.5.4 Error Messages
There are no error messages.
6.2.5.5 Cataloged JCL
485
-------
AQDHS-II
REPORTS
SECTION 6.2.5
PARAMETER STANDARDS FILE
ARPSTND (AQ0250)
Page 2
Release Date: 4/30/79
Update #: 24
6.2.5.5.1 JCL listing - ARPSTND (AQ0250) is executed by the cataloged
procedure AQRPD10. See Figure 6.2.5-b for a listing of this procedure.
6.2.5.5.2 Cross-reference of DP names and files
Program Name: ARPSTND (AQ0250)
DP Name File Description Input/Output
PARMSTDS AQDHS-II parameter standards file Input
AQSPRINT Detailed report Output
6.2.5.5.3 User-supplied JCL - The user must specify the data set name of the
AQDHS-II parameter standards file. See Figure 6.2.5-c for a description of
the procedure's substitutable parameters.
6.2.5.5.4 Sample run stream - The following run stream would produce a
detailed report of the AQDHS-II parameter standards file 'CN.EPALMH.A087.CDHS.
HQ.AQS.DATA.HTSTNDAA1:
// EXEC AQRPD10,
// -P-RM5TOS-HTSTNDAA
6.2.5.6 Warnings and Special Instructions
The user should be careful that he submits the current AQDHS-II parameter
standards file to insure an up-to-date report.
486
-------
AQDHS-II
REPORTS
SECTION 6.2.5
PARAMETER STANDARDS FILE
ARPSTND (AQ0250)
Page 3
Release Date: 4/30/79
Update #: 24
6.2.5.7 Cost Considerations
A test run of ARPSTND (AQ0250) was executed on an IBM 370/168 using a
test AQDHS-II parameter standards file as input. The following estimates were
obtained from that test run:
AQDHS-II parameter standards file:
Parameter standards records printed:
CPU time:
I/O time:
Total time:
46 records
46 records
0.2 second
2.6 seconds
2.8 seconds
Estimated cost:
$0.93
6.2.5.8 Related Programs and Procedures
There are no related programs or procedures.
487
-------
viwihr— ** r nnrmrifc. fk*«««(r«iw*nvtfrAhkv*wi*i*U r n w*- •
PROGRAM-NAME: ARPSTND (A00250)
REVISION LEVELI
LAST UPDATE
Hi
1-00
24
DATE INCORPORATED! OCTOBER 31,
*• K
PARK-CODE
11101
11101
11101
11101
11101
42101
12101
12101
^» 12101
00
00 42101
42101
42101
42101
42401
42401
42401
42401
42401
42401
42401
42101
12602
12602
42602
E Y
F/S
F
F
F
S
S
F
F
f
F
S
S
S
S
F
F
F
F
S
S
s
s
F
F
S
**
STD-NBR
01
02
03
01
02
01
02
03
04
01
02
03
04
01
02
03
04
01
02
03
04
01
02
01
1978
**UNIT
01
01
02
02
01
01
02
02
01
01
02
02
01
01
07
07
07
07
01
01
01
01
07
07
07
07
01
02
07
07
01
07
01
07
01
07
07
01
01
07
07
02
02
DESCRIPTION
75 UG/M3 (25 C) ANNUAL GEOMETRIC MEAN
60 UG/M3 (25 C) ANNUAL GEOMETRIC MEAN
75 UG/MJ (0 C) ANNUAL GEOMETRIC MEAN
60 UG/M3 (0 C) ANNUAL GEOMETRIC MEAN
260 UG/M3 (25 C) 24 HOUR MAXIMUM, 1 PER YEAR.
ISO UG/MJ (25 C) 24 HOUR MAXIMUM, 1 PER YEAR.
60 UG/M3 (0 C) ANNUAL GEOMETRIC MEAN
60 UG/MJ (0 C) ANNUAL GEOMETRIC MEAN
250 UG/MJ (25 C) 24 HOUR MAXIMUM, 1 PER YEAR
120 UG/MJ (25 C) 24 HOUR MAXIMUM,! PER YEAR
10,000 UG/MJ (0 C) 8 HR. MAX, 1 PER YR.
10,000 UG/MJ (0 C) 8 HR. MAX, 1 PER YR.
40,000 UG/M3 (25 Cl 1 HR. MAX, 1 PER YR.
40,000 UG/MJ (25 C) 1 HR. MAX, 1 PER YR.
9 PARTS/MILLION , 8 HR MAX, 1 PER YEAR
9 PARTS/MILLION , a HR MAX, i PER YEAR
35 PARTS/MILLION, 1 HR. MAX, 1 PER YR
35 PARTS/MILLION, 1 HR. MAX, 1 PER YR
10,000 UG/MJ (25 C), 8 HR. MAX, 1 PER YR.
10,000 UG/MJ (25 C) 8 HR. MAX, 1 PER VR.
35,000 UG/MJ (25 C) 1 HR. MAX, 1 PER YR.
35,000 UG/MJ (Z5 C) 1 HR. MAX, 1 PER YR.
9 PARTS/MILLION , a HR MAX, i PER YEAR
9 PARTS/MILLION , a HR MAX, i PER YEAR
30 PARTS/MILLION,.! HR. MAX, i PER YR
30 PARTS/MILLION, i HR. MAX, i PER YR
365 UG/MJ (25 C) 24 HOUR MAXIMUM, 1 PER YEAR
1300 UG/M3 (0 C), 3 HR. MAX.,! PER VR
0.14 PARTS PER MILLION 24 HOUR MAX, 1 PER YEAR
0.5 PARTS/MILLION, 3 HR MAX, 1 PER YEAR
80 UG/MJ (25 C), ANNUAL ARITHMETIC MEAN
0.03 PARTS/MILLION, ANNUAL ARITHMETIC MEAN
60 UG/MJ (25 C) ANNUAL ARITHMETIC MEAN
0.4 PARTS/MILLION, 3 HR.MAX, i PER YEAR
360 UG/MJ (25 C) , 24 HR. MAX., 1 PER YEAR
0.03 PARTS/MILLION, ANNUAL ARITHMETIC MEAN
0.09 PARTS/MILLION, 24 HR. MAX., i PER YEAR
100 UG/M3 (25 C), ANNUAL ARITHMETIC MEAN
100 UG/M3 (25 C), ANNUAL ARITHMETIC MEAN
0.05 PARTS/MILLION, ANNUAL ARITHMETIC MEAN
0.05 PARTS/MILLION, ANNUAL ARITHMETIC MEAN
90 UG/M3 (0 C) ANNUAL ARITHMETIC MEAN
90 UG/MJ (0 C) ANNUAL ARITHMETIC MEAN
PARM-CODEl 11101* F/S» F* STD-NBR! 01** PAGE 1
73
m
2
•30
GO
•J-. -Q
•yo ^>
•O 3O
— \ jj
•z. m
0 —1
m
^
XD CO
O — 1
ro ^>
m -z.
o o
*~^ 5*
o
CO
11
t—t
f—
m
e -30
D. — •
oi n>
Ct Ol
ro
CD
=*:
.. 0
O)
ro o>
.p» ..
.£»
CO
O
s
XD
E2
CO
•— <
1—1
CO
m
o
H- 1
O
01
•
ro
•
-o
QJ
IQ
(D
•**
Figure 6.2.5-a. Parameter Standards File Detailed Report
(page 1 of 2)
-------
ARPSTNO (#00250) SUMMARY MESSAGES
PARAMETER STANDARDS RECORDS READ!
PARAMETER STANDARDS RECORDS LISTED:
PROGRAM-NAMEl ARPSTND (AQ02SO)
REVISION LEVEL: 1-00
LAST UPDATE »: 2«
DATE INCORPORATED: OCTOBER Ji. 1976
us
45
00
Figure 6.2.5-a - continued. Parameter Standards File Detailed Report
(page 2 of 2)
m .o
-o o
o ic
70 00
—I I
GO •—'
CO
GO
m
m O
en
43 oo ro
o — I •
ro 3>
-
.
o o
o
oo
O.
O)
c-1-
ro
n>
— •
fD
Cu
(D
ft)
cn
co
o
VO
-------
AQDHS-II
REPORTS
SECTION 6.2.5
PARAMETER STANDARDS FILE
ARPSTND (AQ0250J
Page 6
Release Date: 4/30/79
Update f: 24
//*
//* PROCEDURE NAME! AQRPD10
//• REVISION LEVEL! 1-00
//* LAST UPDATE «: 84
//* DATE INCORPORATED: OCTOBER 31,1978
//*
//* THIS PROCEDURE ALLOWS THE USER TO OBTAIN A DETAILED LISTING OF
//* THE PARAMETER STANDARDS FILE
//*
//*
//AORPD10 PROC I'ROJECT='CN.EPALMH.A067.CDHS.HQ.AQS',
// PROGRAMsARPSTND,
// TIMtl='l,0',
// STANFIL=AQSTANFL,
// OUT=A
//PRTSTDS EXEC PGM=&PROGRAM,
//*
//* LIST PARAMETER STANDARDS FILE WITH APPROPRIATE HEADINGS AND
//* FOOTNOTES
//*
//STEPLIB DD DSNAME = &PRQJF.CT.,LOAD,
// VOLUMEsCPRIVATE,RETAIN),
// DlSPs(SHR,PASS)
//*
//* OUTPUT DATA SET - PARAMETER STANDARDS FILE LISTING
//*
//AOSPRINT DD SYSOUT»»OUT
//*
//* INPUT DATA SET - PARAMETER STANDARDS FILE
//*
//PARMSTDS DD DSNAME=&PROJECT..DATA,IISTANFIL,
// DlSPs(SHR,PASS)
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
X/SYSPRINT DD SYSOUTs&OUT
//*
X/SYSOUT
//*
//SYSDBOUT
//*
//SYSDTEKM
//*
//3YSUDUMP
//*
DD SYSUUTs&OUT
[)D SYSOUTs&OUT
DD SYSOUTs&OUT
Dl> SYSOUTi&OUT
00000100
oooooaoo
00000300
00000400
00000500
OOOOObOO
00000700
00000800
00000900
00001000
00001100
00001800
00001300
OOOOHOO
00001SOO
00001600
00001700
OOOOlflOO
00001900
00002000
00008100
00008800
00008300
00008400
00008500
00008600
00008700
00008BOO
00008900
00003000
00003100
00003800
00003300
00003400
00003SOO
00003600
00003700
00003600
00003900
00004000
00004100
00004800
00004300
00004400
00004500
00004600
00004700
Figure 6.2.5-b. Cataloged Procedure AQRPD10
490
-------
AQDHS-II
REPORTS
SECTION 6.2.5
PARAMETER STANDARDS FILE
ARPSTND (AQ0250)
Page 7
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROGRAM
TIME
STANFFL
OUT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS'
ARPSTND
'1,0'
AQSTANFL
Description
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.STANFILE
would be the full data set name of the
AQDHS-II parameter standards file)
Parameter standards file detailed report
program
Time allocated for execution of ARPSTND
Lowest-level index of AQDHS-II parameter
standards file
SYSOUT class for all print files
Figure 6.2.5-c. Substitutable Parameters for AQRPD10
491
-------
AQDHS-II
REPORTS
SECTION 6.2.6
DETAILED SITE FILE REPORT
PROGRAM ARPSITE (AQ0260)
Page 1
Release Date: 4/30/79
Update #: 24
6.2.6 SITE FILE DETAILED REPORT PROGRAM - ARPSITE (AQ0260)
6.2.6.1 Description
ARPSITE (AQ0260) produces a formatted listing of the records in the
AQDHS-II site file. All information for each record is contained on one line
of the report. The report lists the sites in the same order as they occur in
the AQDHS-II master file.
6.2.6.2 File Formats
The site file to be listed is the only input to ARPSITE (AQ0260); the
detailed report is the only output. The site file format is discussed in
Section 4.3.2.2, an example of the detailed report is shown in Figure 6.2.6-a.
Note that the report page has a footnote to indicate the first site listed on
that page. These footnotes make it easier to locate particular sites in the
report.
6.2.6.3 Options
There are no options.
6.2.6.4 Error Messages
There are no error messages.
6.2.6.5 Cataloged JCL
6.2.6.5.1 JCL listing - ARPSITE (AQ0260) is executed by the cataloged
procedure AQRPS10. See Figure 6.2.6-b for a listing of this procedure.
492
-------
AQDHS-II
REPORTS
SECTION 6.2.6
DETAILED SITE FILE REPORT
PROGRAM ARPSITE (AQ0260)
Page 2
Release Date: 4/30/79
Update #: 24
6.2.6.5.2 Cross-reference of DD names and files
Program Name: ARPSITE
DD Name
File Description
Input/Output
SITEFILE
SORTWK01
AQSPRINT
AQDHS-II site file
Sort work file
Detailed report
Input
Internal
Output
6.2.6.5.3 User-supplied JCL - Normally the only specification that the user
need make to run the site report procedure is the name of the site file
itself. See Figure 6.2.6-c for a description of the procedure's substitutable
parameters.
6.2.6.5.4 Sample run stream - The following run stream would produce a
detailed report of the site file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.SITE00011:
// EXEC AQRPS10,
// SITEFIL=SITE0001
6.2.6.6 Warnings and Special Instructions
The site file maintenance program, AEMSITE (AQ0080), does not have the
capability of listing the site file; therefore, ARPSITE (AQ0260) must be run
to list the contents of the site file.
493
-------
AQDHS-II
REPORTS
SECTION 6.2.6
DETAILED SITE FILE REPORT
PROGRAM ARPSITE (AQ0260)
Page 3
Release Date: 4/30/79
Update #: 24
6.2.6.7 Cost Considerations
Listed below are cost-related data for a particular run of ARPSITE
(AQ0260) on an IBM 370/168:
Number of records in site file:
I/O time:
CPU time:
Total time:
24 records
6.3 seconds
.5 second
6.8 seconds
Estimated cost:
$1.78
6.2.6.8 Related Programs and Procedures
There are no related programs and no related procedures.
494
-------
VO
in
AQDHS-II SITE FILE LISTING
PROGRAM NAME:
ARPSITE
(A00260)
PAGE 1
REVISION LEVEL! 1-00
LAST
DATE
«*
STATE
10
12
12
12
12
12
12
12
12
20
30
30
30
30
30
30
30
30
30
30
30
30
30
37
37
37
37
37
37
37
37
37
37
37
37
37
UPDATE *
: 2o
INCORPORATED: OCTOBER 31
AREA
0001
0001
0001
0001
0001
0001
0001
0001
0001
0001
0002
0003
0003
0001
0003
0003
0002
0002
0001
0003
0002
OC01
0001
0001
2200
2260
2260
3000
3000
3000
3000
3000
3000
3020
3100
3100
KEY
SITE
001
001
002
003
000
005
006
007
008
000
007
002
010
002
000
008
005
003
001
006
001
000
003
230
999
993
995
001
110
127
132
997
998
996
992
990
AGENCY
E
C
C
C
C
C
C
f
C
8
D
G
G
A
G
G
0
D
A
G
0
G
r
F
. 1978
»*
PROJECT
02
01
01
01
01
01
01
01
01
03
05
00
00
06
00
oo
05
05
06
00
05
06
06
05
05
05
05
05
01
02
02
05
05
05
05
05
AOCR COUNTY
009
060
060
060
060
060
060
060
060
108
136
136
165
166
166
167
167
168
169
170
170
170
171
180
186
186
186
186
186
186
186
186
186
186
Iflb
186
Figure
1080
0080
0100
0100
0100
OIQO
0100
0100
0100
0005
1080
1780
3500
2120
0160
2360
2580
1020
0960
1100
2880
2980
0080
ObOO
3020
3020
3020
3020
3020
3020
3020
3020
3020
3020
3020
3020
STATE:
6.2.
SLAMS-ID DESCRIPTION
N.10TH. AVE., JACKSONVILLE, DUVAL CO.
MOUNTAIN ROAD, HILO, HAWAII co.
PEARL HARBOR, HONOLULU, HONOLULU CO.
NAIKIKI, HONOLULU, HONOLULU CO.
SCHOFIELD BARRACKS, HONOLULU CO.
PEARL CITY, HONOLULU CO.
HAHIAHA, HONOLULU CO.
KANEOHE, HONOLULU CO.
KARUA, HONOLULU CO.*
GLACIER DR., CARIBOU, AROOSTOOK CO.
CHERRY ST., WINSTON-SALEM, FORSYTH CO.
REIDSVILLE HHY., GREENSBORO, GUILFOHD CO.
CHIMNEY ROCK, LAKE LURE, RUTHERFORD CO.
HHY. 301 BUS., SMITHFIELD, JOHNSTON CO.
DOHNTOHN BLVD., RALEIGH, HAKE CO.
HHY. 321 N., LINCOLNTON, LINCOLN CO.
TRYON RD., CHARLOTTE, MECKLENBURG CO.
ROANOKE ISLAND, MANTEO, OAKE CO.
YADKIN RD., FAYETTEVILLE, CUMBERLAND CO
COURTHOUSE, KENANSVILLE, DUPLIN COUNTY
HR1GHTSVILLE BEACH, NEN HANOVER CO.
GUM BRANCH RO., JACKSONVILLE, ONSLOH CO
.
BILTMORE ESTATES, ASHEVILLE, BUNCOMBE CO.
MCALISTER RD., NORMAN, CLEVELAND CO.
LIBERTY MOUNDS, TULSA, TULSA CO.
WYNONA, TULSA, TULSA CO.
3KIATOOK LAKE, TULSA, TULSA CO.
TULSA INTERNATIONAL AIRPORT, TULSA, TULSA CO.
TULSA PUBLIC HEALTH, TULSA, TULSA CO.
MOHAHK BLVD, TULSA, TULSA CO.
APACHE ST., TULSA, TULSA CO.
TULSA PUBLIC HEALTH, TULSA, TULSA CO.
TULSA POST OFFICE, TULSA, TULSA CO.
SPERRY, TULSA, TULSA CO.
OCHELATA, TULSA, TULSA CO.
VERA POST OFFICE, TULSA, TULSA CO.
10* AREA: 0001* SITE: 001* AGENCY: E* PROJECT: 02**
(page
6-a. Site File Detailed Report
PAGE 1
1 of 2)
73
m
•o
0
73
OO
73 m
O —1
O f>
S r~
2 m
o
3"
73 GO
-O •— i
CO —I
i— i rn
*n *^n
I-H
-*— s r~
B m
O 73
ro m
§ S
73
CZ 73
"O (D
^"i '
i-*. — •
Oi 0>
c+ 0)
fD
(D
O
CU
ro fl>
*" 4=>
co
0
VO
^
JO
o
CO
_
1— 1
co
m
o
-H
o
CT>
•
ro
CT^
~o
D)
n>
-^
-------
ARPSITE (AQ0260) SUMMARY MESSAGES
SIFt TILE RECORDS READ
SUE FILE RECORDS PRINTED
36
36
PROGRAM NAME: ARPSITE (AU0260)
REVISION LEVEt: 1-00
LAST UPDATE *: 21
DATE INCORPORATED: OCTOBER 31. 1"»78
V£>
Figure 6.2.6-a - continued. Site File Detailed Report
(page 2 of 2)
rn jo
-o o
o a:
73 CO
CO 1-1
-o o co
^ m m
O —I o
O > -H
TO i—i i—i
> r- o
j£ m z
o
73
-o
co
co .
•-i ro
•—• m CT»
JO
o TO
ro m
CTI -o
o o
—• 73
C 33 -O
T3 fO B)
Q. —« to
O) (B fD
<-t CU
n> c/> cn
n>
=«=
.. o
Ol
c+
ro ro
co
O
—I
to
-------
AQDHS-II SECTION 6.2.6
REPORTS DETAILED SITE FILE REPORT
PROGRAM ARPSITE (AQ0260)
//*
//* PROCEDURE NAME: AQRPS10
//* REVISION LEVEL: 1-00
//* LAST UPDATE *t 24
//* DATE INCORPORATED: OCTOBER 31,1978
//*
//*
Page 6
Release Date: 4/30/79
Update #: 24
00000100
00000200
00000300
00000400
00000500
00000600
00000700
//* THIS PROCEDURE ALLOWS THE USER TO PRODUCE A DETAILED LISTING OOOOOHOO
//* OF THE AUDHS-II SITE FILE
//*
//*
//AQRPS10 PRUC PROJECT='CN.EPALMH.A087.CDHS.HU.AQS',
// PROGRAM=ARPSITE,
// T I"F 1 = * 1 > 0 ' »
// SITEFIL=AQSITEFL,
// OUT=A,
// TEMP=SYSDA,
// WORKSPC=50
//*
//PRINT EXEC PC;M=&PRUGRAM,
// TI^E3 (&T1ME 1 ) ,
// KEGION=100K
//*
00000900
00001000
00001 100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
//* LIST SITE FILE WITH APPROPRIATE HEADINGS AND FOOTNOTES 00002400
//*
//STEPLIB DD DSNAME=*PKOJECT..LUAD,
// VULUMK=(PRIVATE, RETAIN),
// DISP=(SHR,PASS)
//SORTLIB DD OSNAMC=SYS1 .SORTLIB,
// DISP=(SHR,PASS)
//*
//* SORT WORK FILES
//*
//SORTWK01 DD UNIT = *,TEMP,
// SPACE=(CYL, (&WORKSPC), ,CONTIG)
//*
// SPACE=
-------
AQDHS-II
REPORTS
SECTION 6.2.6
DETAILED SITE FILE REPORT
PROGRAM ARPSITE (AQ0260)
Page 7
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROGRAM
SITEFIL
TIME1
TEMP
WORKSPC
OUT
Default
Value
'CN.EPALMH.A087,
CDHS.HQ.AQS1
ARPSITE
AQSITEFL
'1, O1
SYSDA
50
Description
Highest-level index of data set names
Site file detailed report program
Lowest-level index of site file
Time allocated for execution of ARPSITE
Unit type for temporary work space
Number of units to be allocated for the
sort work space
SYSOUT class for all print files
Figure 6.2.6-c. Substitutable Parameters for AQRPS10
498
-------
AQDHS-II
REPORTS
SECTION 6.3
ERA-REQUIRED REPORTS
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: 24
6.3 EPA-REQUIRED REPORTS
6.3.1 INTRODUCTION
Federal law requires the submission of air quality data to EPA for
inclusion in the SAROAD data base. AQDHS-II provides the user with the
capability to automatically generate SAROAD quarterly reports from the
AQDHS-II master file by executing the AQDHS-II to SAROAD conversion program,
ARPSARD (AQ0220).
The AQDHS-II to SAROAD conversion flowchart is shown in Figure 6.3.1-a.
ARPSARD (AQ0220) converts readings from the master file to SAROAD transaction
format. Only readings that have not previously been submitted to SAROAD and
that are dated prior to or equal to the date on the option card for ARPSARD
(AQ0220) are converted to SAROAD transaction format. Readings that are to be
added to the SAROAD data base are placed in the SAROAD add file and readings
that are to replace or delete previously submitted readings are placed in the
SAROAD change file. A new master file (indicating the new submission status
of the readings) and a diagnostic report are produced.
A detailed discussion of ARPSARD (AQ0220) is presented in Section 6.3.2.
ARPSARD (AQ0220) can be executed using the cataloged procedure AQRPM05,
which is discussed in Section 6.3.2.5. A sample run stream for generating
SAROAD data from the master file is shpwn in Section 6.3.2.5.4.
499
-------
AQDHS-II
REPORTS
SECTION 6.3
ERA-REQUIRED REPORTS
INTRODUCTION
Page 2
Release Date: 4/30/79
Update #: 24
OLD AQDHS-II
MASTER FILE
I
OPTION CARD
(Optional)
ARPSARD (AQ0220)
AQDHS-II TO SAROAD
CONVERSION PROGRAM
/
NEW AQDHS-II [ /SAROAD \
MASTER
FILE 1 1 ADD )
v wy
/SAROAD\
( CHANGE )
VFILE^/
DIAGNOSTIC
REPORT
^_^-^"
Figure 6.3.1-a. AQDHS-II to SAROAD Conversion Flowchart
500
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 1
Release Date: 4/30/79
Update #: 24
6.3.2 AQDHS-II TO SAROAD CONVERSION PROGRAM - ARPSARD (AQ0220)
6.3.2.1 Description
ARPSARD (AQ0220) provides the user with the capability of periodically
extracting new or changed data from the AQDHS-II master file for inclusion in
the SAROAD data base. Only data which have not been previously sent to SAROAD
are sent. All data which have been previously sent to SAROAD but have been
changed or deleted are sent as a change transaction. All new data are sent as
an add transaction.
AQDHS-II handles user-specified deletes on the master file by changing the
reading to a null value and setting the status flag to change. These deletes
are then included in the change transaction file which is generated for SAROAD.
When the DELETES option of the SAROAD editor (NA067) is invoked, it considers
any null reading (9999) as a delete even though they appear in the change file.
Therefore, it is important that the AQDHS-II user indicate to his regional
office that his change file, or tape, was created by AQDHS-II and that the
SAROAD editor program should be run using the DELETES option.
As each reading is sent to SAROAD, its associated reading status flag is
changed to indicate that it has been sent. This change occurs as follows: if
the reading status flag is 'A1 or 'C', it is changed to 'S' and if the reading
status flag is 'B1 or 'D', it is changed to T. A reading status flag of 'S1
indicates that the reading has been sent to SAROAD, but it has not undergone
anomaly screening. A reading status flag of 'T' indicates that the reading
has been sent to SAROAD and it has undergone anomaly screening.
There is a submission status flag associated with each record which is
different from the reading status flags. This flag is used by certain programs
to indicate whether or not the readings have been sent to SAROAD, whether or
not the readings have undergone anomaly screening, and whether or not the
501
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 2
Release Date: 4/30/79
Update #: . 24
record contains any non-null readings. Therefore, it is necessary for ARPSARD
(AQ0220) to update this flag as follows: if the record submission flag is
'V, it is changed to 'T' and if it is 'N', it is changed to 'S1. Records
having a submission status flag of 'X1 are deleted from the master file after
being processed by ARPSARD (AQ0220).
Refer to Figure 5.5.5-b for a description of the record submission flag
and Figure 5.5.5-c for a description of the reading status flag.
6.3.2.2 File Formats
Input to this program consists of the AQDHS-II master file and an option
card. See Figure 4.5.3-a for a description of the master file format and
Section 6.3.2.3 for a discussion of the option card.
Output consists of a new AQDHS-II master file, a SAROAD add file, a
SAROAD change file, and a diagnostic report.
The output AQDHS-II master file differs from the input master file in
that the submission status flags and the reading status flags have been
changed as necessary. The output master file might also contain fewer records
than the input master file since some records may have been deleted.
The output SAROAD files contain SAROAD format transactions. The SAROAD
add file begins with a '$2' action card followed by all add transactions, if
any; the SAROAD change file begins with a '$3' action card followed by all
change transactions, if any. The '$2' and '$3' action cards indicate that the
respective files were created by AQDHS-II and what action is to be performed
by the Regional Office on the transactions following them. See Figure 5.5.2-a
for a description of the SAROAD transaction format.
502
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 3
Release Date: 4/30/79
Update #: 24
See Figure 6.3.2-a for a sample diagnostic report. Although the output
transactions are normally written to tapes and are not listed in this report,
they are listed as a sample in Figure 6.3.2-b.
6.3.2.3 Options
The option card for ARPSARD (AQ0220) is used to supply the program with a
date to be used in selecting records from the AQDHS-II master file. All
records dated on or prior to the option date will be selected for processing;
e.g., a record dated January 1979 (7901) would be selected for processing if
the option date were January 1979 (7901). No record dated after the option
date would be selected for SAROAD processing. If no option card is submitted,
or if the option date is invalid, all records would be processed by this
program.
The selection date is coded in columns 1 through 4 of the option card; it
consists of the year and month, in that order. Refer to Figure 6.3.2-c for a
description of the option card format.
6.3.2.4 Error Messages
There are no error messages.
6.3.2.5 Cataloged JCL
6.3.2.5.1 JCL listing - ARPSARD (AQ0220) can be run by executing the
cataloged procedure AQRPM05. See Figure 6.3.2-d for a listing of this
procedure.
503
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAO REPORT
PROGRAM ARPSARD (AQ0220)
Page 4
Release Date: 4/30/79
Update #: 24
6.3.2.5.2 Cross-reference of DP names and files
Program Name: ARPSARD (AQ0220)
DP Name File Description
AQSMASTR AQDHS-II master file
AQSOPTIN Option card
AQSNEWMS New AQDHS-II master file
AQSADDFL SAROAD add file
AQSCHGFL SAROAD change file
AQSPRINT Diagnostic report
Input/Output
Input
Input
Output
Output
Output
Output
6.3.2.5.3 User-supplied JCL - An option card may be submitted with the run to
insure that the user sends to SAROAD only that data collected prior or equal
to a certain date. An option card is not necessary if the user wishes to
process the entire AQDHS-II master file for SAROAD selection. If no option
card is present, the default is to submit all appropriately flagged data in
the master file. The user must supply the data set names for the AQDHS-II
master file, the SAROAD add file, the SAROAD change file, and the new AQDHS-II
master file, as well as tape information for the add and change files. See
Figure 6.3.2-e for a description of the procedure's substitutable parameters.
6.3.2.5.4 Sample run stream - The following run stream would produce a tape
containing the SAROAD add file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.ADDTRAN', a
tape containing the SAROAD change file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
CHGTRAN1, and the new AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
NEWMASTR1 from the AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
OLDMASTR':
// EXEC AQRPM05,
// OLDMSTR=OLDMASTR,
// NEWMSTR=NEWMASTR,
// ADDFILE=ADDTRAN,
504
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 5
Release Date: 4/30/79
Update #: 24
// CHNGEFL=CHGTRAN
//SUBMIT.OPTION DD *
7902
/*
6.3.2.6 Warnings and Special Instructions
You should indicate to your Regional Office that the SAROAD add and
change files were created by AQDHS-II, and that the SAROAD editor program
(NA067) should be executed using the 'DELETES' option.
If no option card for ARPSARD (AQ0220) is submitted, all AQDHS-II master
file records will be selected for SAROAD selection processing.
6.3.2.7 Cost Considerations
A test run of ARPSARD (AQ0220) was executed on an IBM 370/168 using a
test AQDHS-II master file. The following estimates are from that test run:
Input AQDHS-II master file:
Output AQDHS-II master file:
Number of add transactions:
Number of change transactions:
Number of add readings:
Number of change readings:
CPU time:
I/O time:
Total time:
Estimated cost:
2140 records
2140 records
9852 transactions
0 transaction
9852 readings
0 reading
12.0 seconds
12.5 seconds
24.5 seconds
$4.04
505
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 6
Release Date: 4/30/79
Update #: 24
6.3.2.8 Related Programs and Procedures
There are no related programs or procedures.
506
-------
AODH3-II TO 3ARUAO CONVERSION PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ARPSARO (AQ0220)
REVISION LEVELI 1-00
LAST UPDATE «l 24
DATE INCORPORATED: OCTOBER Ji, 1978
DATE OF 12 79 USED FOR 3AROAD SELhCTIUN CRITERIA
NUMBER OF FILE RECORDS READ:
NUMBER OF MASTER FILE RECORDS DELETED USING THE CHANGE OPTION!
NUMBER OF FILE RECORDS KRITTENl
NUMBER OF ADD TRANSACTIONS SUBMITTED TO SAROACi:
NUMBER OF CHANGE TRANSACTIONS SUBMITTED TO SAROADi
NUMBER OF ADD READINGS SUBMITTED TO SAKO»Dl
NUMBER OF CHANGE READINGS SUBMITTED TO SAROAOl
3
50
m
o
CT>
—1 •
O 00
co ro
£
o
o
O 73
ro m
ro -o
o o
%—g' JQ
\3 n o>
CL —' ID
QI n n>
Cu
«/> —i
fD
O>
ro
.pa.
O
CU
CO
o
•—I
VO
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 8
Release Date: 4/30/79
Update #: 24
*2 ADO TRANSACTIONS CHEATED BY AUDHS
U20001001COH W101004240133021 ooo 001 ooo ooo ooo ooo ooo ooo ooo 001 ooa 001
U20001001C01179010H24240133021 006 ooa 004 ooa oos oos ooa 001 ooo ooo ooo ooo
1120001001C011790102004240133021 000 000 000 005 006 007
1120001001C011790102124240133021 007 006 010 Oil 010 Oil 010 Oil 009 OOS 006 007
1120001001C011790131004240133021 005 005 006 007 007 006 006 006 006 Oil Oil 013
H20001001C011790131124240133021 013 013 014 012
U20001001C01179020100424013302I 007 007 006 005 004 004 004 007 009 010 Oil 012
1120001001C011790201124240133021 014 013 012 012 006 007 007 007 007 007 006 007
U2000t001C011790
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 9
Release Date: 4/30/79
Update #: 24
Column
#1 #4
YYMM
1. Replace YY with the selection year.
2. Replace MM with the selection month.
Figure 6.3.2-c. Option Card Format
509
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 10
Release Date: 4/30/79
Update #: 24
//*
//*
//*
//*
//*
//*
//»
//*
//*
//*
//*
//AQRPM05 PRQC PROJECT='CN,EPALMH.A087.CDHS.HQ.AQS',
// PROGRAM=ARP3ARD,
PROCEDURE NAME: AQRPM05
REVISION LEVEL: i-oo
LAST UPDATE «: 24
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO GENtRAGE THE QUARTERLY REPORT
FROM AUDHS-II TO SAROAD AND TU CREATE A NEW AQDHS-II MASTER FILE
WITH THE STATUS FLAGS SET APPROPRIATELY
//
//
//
//*
//SUBMIT
OLDMSTRsAQMASTER,
NEWMSTR=AQMSTSNT,
UNIT1=3330,
UNIT2=2400,
UNIT3=2400,
SERIAL1=CDHSPK,
SERIAL2=ADDTPE,
SERIAL3=CHGTPE,
D1SP1 ='NEW,CATLG,DELETE',
D1SP2='NEW,KEEP',
DISP3='NEW,KEEP',
SPCUNIT=TRK,
PRIMARY=20,
SECNDRY=10,
ADDFILt=ADDFILE,
CHNGtFL=CHNGEFL,
LABN(11 = 1,
LABN02=1,
LABCK1=BLP,
LABCK2=BLP,
OUT = A
EXEC PGMriPROGRAM,
PEGION=60K,
TIME=(6,0)
//*
//* CONVERT AQDHS-II MASTER FILE TO SAHOAD INPUT FORMAT
//*
//STEPLIB DD DSNAME=£PROJECT..LOAD,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
// DD D3NAME=SYS1.COBLIB,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - OPTION CARD FILE
//*
//AOSOPTIN DD DDNAME=UPTION,
// DCB=BLKS1ZE=80
//*
//* INPUT DATA SET - OLD AC1DHS-I1 MASTER FILE
//*
//AQSMASTR DD DSNAME = filPROJECT . .OAT A.ROLDM3TK,
// VDLUMfc=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//*
00000100
00000200
00000300
00000400
00000500
00000600
00000700
00000800
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
(page 1 of 2)
Figure 6.3.2-d. Cataloged Procedure AQRPM05
510
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 11
Release Date: 4/30/79
Update #: 24
//* OUTPUT
II*
//AOSNEWMS
II
II
II
II
//*
//* OUTPUT
II*
//AQSADDFL
II
II
II
II
II*
II
II*
II* OUTPUT
II*
//AQSCHGFL
II
II
II
II
II*
II
II*
II* OUTPUT
II*
//AQSPRINT
II*
II* OUTPUT
II*
//SYSPRINT
II*
//SYSOUT
II*
//SYSDBOUT
II*
//SYSDTERM
II*
//SYSUDUMP
II*
DATA SET - NEW AtlDHS-II MASTER FILE
DO UNIT=&UNIT1,
VOLUME=(PRIVATE, RETAIN, SER=&SERIAL1),
DISP=UI)ISP1),
SPACE=(&SPCUNIT, (&PRIMARY,RSECNDRY),RLSE),
DSNAME=&PROJECT..DATA.&NEWMSTR
DATA SET - SAROftD ADD FILE
DO UNITrfcUNIT2,
VOLUME=SER=&SEPIAL2,
DISP=C&OISP2),
LABELs(&LABN01,RLABCKl)»
RING=IH, CHANGE TO USER SPECIFICATIONS
DSNS&PROJECT..DATA.&ADDFILE
DATA SET - SAROAD CHANGE FILE
DD UNIT=RUNIT3,
VULUME=SER=&SERIAL3,
D1SP»(&1)ISPJ),
DCB=(RECFM=FB,LRECL=BO,HLKSIZE=<4000),
K1NG=IN, CHANGE TO USER SPECIFICATIONS
DSN=RPROJECT..DATA.&CHNGEFL
DATA SET - DIAGNOSTIC MESSAGES
DD 8YSt)UT = 8,OUT
DATA SETS - SYSTEM OPERATION
DD SYSUUT=&OUT
DD SYSOUT=&OUT
DD SYSOUT=RUUT
DD SYSOUTs&OUT
DD SYSOUTsROUT
00005900
00006000
00006100
00006200
00006300
00006400
OOOOfcbOO
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
00007400
0000/500
00007600
00007700
00007600
00007900
OOOORflOO
oooonioo
00006200
OOOOR300
OOOOB400
ooooasoo
OOOOB600
OOOOH700
OOOOR000
00006900
00009000
00009100
00009200
00009300
00009^00
00009500
00009600
00009700
00009BOO
00009900
00010000
00010100
00010200
(page 2 of 2)
Figure 6.3.2-d continued. Cataloged Procedure AQRPM05
511
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 12
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PROGRAM
OLDMSTR
NEWMSTR
UNIT1
UNIT2
UNIT3
SERIAL1
SERIAL2
SERIALS
DISP1
DISP2
DISP3
SPCUNIT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ARPSARD
AQMASTER
AQMSTSNT
3330
2400
2400
CDHSPK
ADDTPE
CHGTPE
1 NEW,CATLG,DELETE'
'NEW,KEEP1
'NEW,KEEP1
TRK
Description
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQMASTER would
be the full data set name of the AQDHS-II
master file
AQDHS-II to SAROAD conversion program
Lowest-level index of current AQDHS-II master
file
Lowest-level index of new AQDHS-II master file
Unit type to which new AQDHS-II master file
will be written
Unit type to which SAROAD add file is to be
written
Unit type to which SAROAD change file is to be
written
Volume ID to which new AQDHS-II master file is
to be written
Volume ID to which SAROAD add file is to be
written
Volume ID to which SAROAD change file is to
be written
Disposition of new AQDHS-II master file
Disposition of SAROAD add file
Disposition of SAROAD change file
Units in which space for the new AQDHS-II
master file is to be allocated
(Page 1 of 2)
Figure 6.3.2-e. Substitutable Parameters for AQRPM05
512
-------
AQDHS-II
REPORTS
SECTION 6.3.2
AQDHS-II TO SAROAD REPORT
PROGRAM ARPSARD (AQ0220)
Page 13
Release Date: 4/30/79
Update #: 24
Parameter
Name
PRIMARY
SECNDRY
ADDFILE
CHNGEFL
LABN01
LABN02
LABCK1
LABCK2
OUT
Default
Value
20
10
ADDFILE
CHNGEFL
1
1
BLP
BLP
Description
Primary space allocation for the new AQDHS-II
master file
Secondary space allocation for the new
AQDHS-II master file
Lowest-level index of SAROAD add file
Lowest-level index of SAROAD change file
Tape sequence order of the SAROAD add file
(i.e., the SAROAD add file will be the first
data set on the tape)
Tape sequence order of the SAROAD change file
Type of tape labeling for the SAROAD add file
Type of tape labeling for the SAROAD change
file
SYSOUT class for all print files
(Page 2 of 2)
Figure 6.3.2-e - Continued. Substitutable Parameters for AQRPM05
513
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 1
Release Date: 4/30/79
Update #: 24
6.4 SUMMARY REPORTS
6.4.1 INTRODUCTION
The AQDHS-II summary reports are reports in which data has been
summarized through some type of statistical analysis. This introduction
discusses these reports. Following the introduction are detailed discussions
of the programs that produce the summary reports.
6.4.1.1 Statistical Reports
AQDHS-II allows the user to produce two statistical reports: the
statistical analysis report and the sliding average report. These reports are
discussed in Section 5.3.1, statistical analysis.
6.4.1.2 Anomaly Screening Report
The purpose of the anomaly screening report is to identify to the user
readings in the master file that are anomalous (irregular) and should be
verified by the user. The anomaly screening programs do not delete or alter
readings in the master file; it is the user's responsibility to delete or
correct any readings identified as anomalous.
Only the following readings are subjected to anomaly screening tests:
hourly readings for carbon monoxide,-sulfur dioxide, nitrogen dioxide, total
oxidants, and ozone; and daily readings for total suspended particulate,
sulfur dioxide, and nitrogen dioxide. Hourly readings are subjected to:
(1) the maximum value test, which identifies unusually high readings; (2) the
adjacent hourly difference test, which identifies pairs of consecutive
readings that differ by an unusually large amount; (3) the spike test, which
identifies sets of three consecutive readings 1n which the middle reading 1s
unusually larger or smaller than the other two readings; (4) the modified
514
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 2
Release Date: 4/30/79
Update #: .24
Dixon ratio test, which identifies days in which the largest or two largest
hourly readings are unusually large in comparison to the other hourly readings
in the day; and (5) the gap test, which identifies months of hourly readings
that contain significant gaps in the data. Daily readings are subjected to
the Shewhart test.
The user should verify all data identified as anomalous in the anomaly
screening report. For all tests other than the gap test, the data that fails
the tests are printed in the anomaly screening report. For data that fails
the gap test, only the key information for the data is printed in the report.
Thus, it may be necessary to retrieve and list the data from the master file
that fails the gap test. Fortunately, data that fails the gap test usually
also fails one of the other tests, thereby causing the anomalous data to be
printed in the anomaly screening report.
The anomaly screening flowchart is shown in Figure 6.4.1-a. The anomaly
screening master file conversion program, ACVANOM (AQ0040), selects data from
the master file that is to be screened, converts it to FORTRAN-compatible
format, and passes this data to the anomaly screening report program, ARPANOM
(AQ0320). ACVANOM (AQ0040) also performs the gap test and outputs records in
the temporary file passed to ARPANOM (AQ0320) to identify those months of data
that fail the gap test. ACVANOM (AQ0040) produces a diagnostic report and a
new master file. The new master file is a duplicate of the old master file
except that the status flags have been changed appropriately (see Figures
5.5.5-b and 5.5.5-c). ARPANOM (AQ0320) performs all anomaly screening tests
but the gap test and produces the anomaly screening report, a diagnostic
report, and a file of skeleton master file transactions. The skeleton
transactions may be used in correcting data that the user determines is
incorrect.
515
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 3
Release Date: 4/30/79
Update #: .24
Upon each execution of the anomaly screening programs, only data that has
been added to or changed in the master file since the last execution of the
anomaly screening programs is subjected to the anomaly screening tests.
Detailed discussions of ACVANOM (AQ0040) and ARPANOM (AQ0320) are
presented in Sections 5.5.5 and 6.4.3, respectively.
The anomaly screening programs can be executed using the cataloged
procedure AQRPM45, which is discussed in Section 6.4.3.5.1. Sample run
streams to screen the master file are shown in Section 6.4.3.5.4.
6.4.1.3 Inventory by Site and Inventory by Pollutant Reports
The inventory by site and inventory by pollutant reports summarize data
from the master file or an answer file. Data is grouped by site, parameter,
year, and time code; the minimum reading, maximum reading, number of readings,
and arithmetic mean is computed for each group of data. The inventory by site
report is in order by site whereas the inventory by pollutant report is in
order by parameter.
The inventory by site and inventory by pollutant report flow charts are
shown in Figures 6.4.1-b and 6.4.1-c, respectively. The input master or
answer file must be sorted by the master file sort program, ASRMSTR (AQ0140),
before either report can be produced. The PARM option is used for the
inventory by pollutant report, the SITE option for the inventory by site
report. The inventory by site report program, ARPINVS (AQ0280), and the
inventory by pollutant report program, ARPINVP (AQ0290), use the sorted master
or answer file, the parameter file, and the site file to generate the report.
Neither program produces a separate diagnostic report but includes the
information normally included in a diagnostic report at the beginning and end
of the output report.
516
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 4
Release Date: 4/30/79
Update #: 24
Detailed discussions of ARPINVS (AQ0280) and ARPINVP (AQ0290) are
presented in Sections 6.4.4 and 6.4.5.
The inventory by site report may be generated using the cataloged
procedure AQRPM35, which is discussed in Section 6.4.4.5. A sample run stream
to generate an inventory by site report is shown in Section 6.4.4.5.4. The
inventory by pollutant report may be generated using the cataloged procedure
AQRPM40, which is discussed in Section 6.4.5.5. A sample run stream to
generate an inventory by pollutant report is shown in Section 6.4.5.5.4.
6.4.1.4 Master File Summary Report
The master file summary report summarizes data from the master file or
an answer file. Data is grouped by site, parameter, and year; the number
of readings, number of non-null readings, minimum reading, maximum reading,
second and third maximum readings, and arithmetic mean are computed for each
group of data.
The master file summary report flowchart is shown in Figure 6.4.1-d. The
master file summary report program, ARPMSBR (AQ0300), produces the master file
summary report using only the master file or answer file as input. No
separate diagnostic report is generated, but the information normally included
in a diagnostic report is printed at the beginning and the end of the master
file summary report.
A detailed discussion of ARPMSBR (AQ0300) is presented in Section 6.4.6.
ARPMSBR (AQ0300) can be executed using the cataloged procedure AQRPM30,
which is discussed in Section 6.4.6.5. A sample run stream to produce a
master file summary report is shown in Section 6.4.6.5.4.
517
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 5
Release Date: 4/30/79
Update #: 24
6.4.1.5 Parameter Exception and Site Exception Reports
The parameter exception report lists the parameters that occur in the
master file or in any answer file but do not exist in the parameter file. The
site exception report lists the sites that occur in the master file or in any
answer file but do not exist in the site file.
The parameter exception report and site exception report flowcharts are
shown in Figures 6.4.1-e and 6.4.1-f, respectively. The parameter
exception report program, ARPPMEX (AQ0330), produces the parameter exception
report using the master or answer file and the parameter file. The site
exception report program, ARPSMEX (AQ0340), produces the site exception report
using the master or answer file and the site file. Both programs produce a
diagnostic report and skeleton transactions. The skeleton transactions may be
used in adding the exceptions to the parameter or site file.
Detailed discussions of ARPPMEX (AQ0330) and ARPSMEX (AQ0340) are
presented in Sections 6.4.7 and 6.4.8, respectively.
ARPPMEX (AQ0330) can be executed using the cataloged procedure AQRPP20,
which is discussed in Section 6.4.7.5. A sample run stream to generate a
parameter exception report is shown in Section 6.4.7.5.4. ARPSMEX (AQ0340)
can be executed using the cataloged procedure AQRPS20, which is discussed in
Section 6.4.8.5. A sample run stream to generate a site exception report is
shown in Section 6.4.8.5.4.
518
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 6
Release Date: 4/30/79
Update #: 24
fOLD AQDHS-II/
MASTER
FILE
AQDHS-II,
MASTER
FILE
ANOMALY
SCREENING
REPORJ
AQDHS-II
PARAMETER
FILE
ACVANOM (AQ0040)
ANOMALY SCREENING MASTER
FILE CONVERSION PROGRAM
DATA TO BE
SCREENED FOR
ANOMALIES
(Temporary)
ARPANOM (AQ0320)
ANOMALY SCREENING
REPORT PROGRAM
/ SKELETON /
[MASTER FILE
\TRANSACT I ONS\
OPTION CARD
(Optional)
DIAGNOSTIC
REPORT
DIAGNOSTIC
REPORT
Figure 6.4.1-a. Anomaly Screening Flowchart
519
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 7
Release Date: 4/30/79
Update #: .24
AQDHS-II
MASTER FILE
OR ANSWER FILE
CARD
SPECIFYING THE
SITE OPTION
MASTER FILE OR
ANSWER FILE
IN SITE ORDER
(Temporary)
ASRMSTR (AQ0140)
MASTER FILE
SORT PROGRAM
T
SORT WORK /
FILE
(Temporary^
1
DIAGNOSTIC
REPORT
AQDHS-II
PARAMETER
FILE
AQDHS-II
SITE
FILE
ARPINVS (AQ0280)
INVENTORY BY
SITE REPORT PROGRAM
INVENTORY BY
SITE REPORT
Figure 6.4.1-b. Inventory by Site Report Flowchart
520
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 8
Release Date: 4/30/79
Update #: .24
AQDHS-II
MASTER FILE
OR ANSWER FILE
CARD
SPECIFYING THE
PARM OPTION
MASTER FILE
OR ANSWER FILE
IN PARAMETER ORDER
(Temporary)
ASRMSTR (AQ0140)
MASTER FILE
SORT PROGRAM
I
AQDHS-II
PARAMETER
FILE
ARPINVP (AQ0290)
INVENTORY BY POLLUTANT
REPORT PROGRAM
INVENTORY BY
POLLUTANT
REPORT
SORT WORK /
FILE
(Temporary)y
DIAGNOSTIC
REPORT
_-^
AQDHS-II
SITE
FILE
Figure 6.4.1-c. Inventory by Pollutant Report Flowchart
521
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 9
Release Date: 4/30/79
Update #: 24
AQDHS-II
MASTER FILE OR
ANSWER FILE
ARPMSBR (AQ0300)
MASTER FILE SUMMARY
REPORT PROGRAM
MASTER FILE
SUMMARY REPORT
Figure 6.4.1-d. Master File Summary Report Flowchart
522
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 10
Release Date: 4/30/79
Update #: 24
AQDHS-II
MASTER FILE OR
ANSWER FILE
AQDHS-II
PARAMETER
FILE
ARPPMEX (AQ0330)
PARAMETER EXCEPTION
REPORT PROGRAM
PARAMETER
EXCEPTION
REPORT
/
SKELETON
I PARAMETER FILE
\ TRANSACTIONS
DIAGNOSTIC
REPORT
Figure 6.4.1-e. Parameter Exception Report Flowchart
523
-------
AQDHS-II
REPORTS
SECTION 6.4
SUMMARY REPORTS
Page 11
Release Date: 4/30/79
Update #: 24
C AQDHS-II
MASTER FILE OR
ANSWER FILE
SITE
EXCEPTION
REPORT
AQDHS-II
SITE
FILE
OPTION CARD
(Optional)
ARPSMEX (AQ0340)
SITE EXCEPTION
REPORT PROGRAM
SKELETON
SITE FILE
TRANSACTIONS
DIAGNOSTIC
REPORT
Figure 6.4.1-f. Site Exception Report Flowchart
524
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 1
Release Date: 4/30/79
Update #: 24
6.4.2 STATISTICAL REPORT PROGRAM - ARPMSST (AQ0270)
6.4.2.1 Description
ARPMSST (AQ0270) is executed after the preliminary statistics program,
ASTPRLM (AQ0190), and the statistical analysis program, ASTMSST (AQ0200), to
produce the statistical analysis report which contains the results of the
statistical analyses performed by ASTPRLM (AQ0190) and ASTMSST (AQ0200). Note
that all three programs must be executed to perform a statistical analysis of
an AQDHS-II master or answer file. In addition, some of the options which can
be specified for ASTPRLM (AQ0190) require that the master or answer file be
sorted by ASRMSTR (AQ0140) prior to performing the statistical analysis. All
the statistics for a given time period (either month, quarter, year, or total
time period, depending on the option specified in ASTPRLM (AQ0190), within a
given site/parameter key data group are printed on one line of the report.
6.4.2.2 File Formats
The primary input file to ARPMSST (AQ0270) is the temporary statistics
file created by ASTMSST (AQ0200). Since prose descriptions of the sites and
parameters are included in the output report, the site and parameter files
auxiliary to the master or answer file which this report describes are also
/
required as input. An option file is the only other input file.
The report itself is the only output file. Column headings for the
various statistical items appear at the beginning of each new site block on
the report; these headings are separated from the rest of the printed
information by dashed lines. Within the site group, each parameter sub-group
is distinguished from the others by a two-line heading which indicates the
parameter, method of collection and analysis, units, and the time interval at
which the readings were collected for that sub-group. Each line within the
parameter sub-group is labeled, on the left side, with the time period during
525
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 2
Release Date: 4/30/79
Update #: 24
which the readings were accumulated. This time period labeling does not occur
in the total-time-period statistical report, since there is no break on time
time change. Examples of the report produced by ARPMSST (AQ0270) are
presented in Figure 6.4.2-a.
6.4.2.3 Options
There are two fields on the option card for ARPMSST (AQ0270). For the
format of this option card, see Figure 6.4.2-b. The first option field should
contain the page-break option. If this field contains the value FULL, a full
page break will occur after each new site is encountered; if it contains the
value BRIEF, two dashed lines will be printed to provide the break between
lines to allow new column headings and site descriptions to be printed. The
examples in Figure 6.4.2-a show statistical analysis reports printed with the
FULL option. Figure 6.4.2-c shows a statistical analysis report printed with
the BRIEF option.
The second option field should contain the line-maximum option. The
two-digit numeric value present in this field specifies the maximum number of
lines to be printed per report page.
If the page-break field is blank or invalid, the default option FULL will
be in effect. If the line-maximum field is blank or invalid, a maximum of 64
lines per page will be assumed. If no option card is entered, both default
values are assumed.
6.4.2.4 Error Messages
ARPMSST 001 ABORT - SITE TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II site file exceeds the
limit imposed by the site table in the program; therefore, the
run was terminated.
526
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 3
Release Date: 4/30/79
Update #: 24
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
ARPMSST 002 ABORT - PARM TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II parameter file exceeds
the limit imposed by the parameter table in the program;
therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
ARPMSST 003 ABORT - STATISTICS FILE EMPTY
Meaning: There are no records in the input statistics file; therefore,
no report can be generated.
Action: The problem probably lies with the master or answer file that
was input to ASTPRLM (AQ0190). If this file contains no data,
a valid master or answer file must be chosen and the four
programs - ASRMSTR (AQ0140), ASTPRLM (AQ0190), ASTMSST
(AQ0200), and ARPMSST (AQ0270) - rerun.
ARPMSST 004 WARNING - OPTION CARD MISSING: DEFAULT VALUES ARE 64 LINES PER
PAGE AND FULL SITE BREAK
Meaning: Because no option card was present in the job stream, the
default options were used to generate the statistics report.
Action: None, if the user is satisfied with the format of the report.
ARPMSST 005 WARNING - COLUMN 1 - INVALID OR MISSING SITE BREAK OPTION - FULL
BREAK OPTION USED
Meaning: The page-break field on the option card either was left blank
or contained a character string other than BRIEF or FULL. The
report was generated using the FULL option.
527
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 4
Release Date: 4/30/79
Update #: 24
Action: If the BRIEF option is desired, correct the option card and
rerun the statistical analysis job stream.
ARPMSST 006 WARNING - COLUMN 7 - INVALID OR MISSING LINE MAXIMUM OPTION - 64
LINES PER PAGE USED
Meaning: The line-maximum field on the option card was either left blank
or contained non-numeric characters. The report was generated
with a maximum of 64 lines per page.
Action: If a line maximum other than 64 is desired, correct the option
card by inserting the desired maximum value in columns seven
and eight and rerun the statistical analysis job stream.
ARPMSST 007 ABORT - LEVEL 77 DATA FIELD "SITE-MAX" INCREASED BEYOND SITE-TABLE
SIZE
Meaning: A user modification was made to ARPMSST (AQ0270) to change the
capacity of the site table. However, only one of the two
required line changes was made. Therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
ARPMSST 008 ABORT - LEVEL 77 DATA FIELD "PARM-MAX" INCREASED BEYOND PARM-TABLE
SIZE
Meaning: A user modification was made to ARPMSST (AQ0270) to change
the capacity of the parameter table. However, only one of the
two required line changes was made. Therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
528
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 5
Release Date: 4/30/79
Update #: 24
6.4.2.5 Cataloged JCL
6.4.2.5.1 JCL listing - ARPMSST (AQ0270) can be run by executing the
cataloged procedure AQRPM10. This procedure also executes the preliminary
statistics program, ASTPRLM (AQ0190), and the statistical analysis program,
ASTMSST (AQ0200). See Figure 6.4.2-d for a listing of this procedure.
6.4.2.5.2 Cross-reference of DP names and files
Program Name: ASTPRLM (AQ0190)
DP Name File Description
AQSMASTR AQDHS-II master file
AQSPARMC AQDHS-II parameter file
AQSOPTIN Option card
AQSENTNL FORTRAN-compatible data file
passed to ASTMSST (AQ0200)
AQSSTATS FORTRAN-compatible statistics file
passed to ASTMSST (AQ0200)
AQSPRINT Diagnostic report
Program Name: ASTMSST (AQ0200)
Input/Output
Input
Input
Input
Output
Output
Output
DD Name
FORTRAN
Unit
Number
File Description
Input/Output
FT07F001 7 Statistics file from ASTPRLM (AQ0190) Input
FT08F001 8 Data file from ASTPRLM (AQ0190) Input
529
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 6
Release Date: 10/31/81
Update #: 29
DD Name
FT09F001
FT06F001
FORTRAN
Unit
Number
9
6
Program Name: ASTMSST (AQ0200) - Continued.
File Description
Statistics file passed to
ARPMSST (AQ0270)
Diagnostic report
Program Name: ARPMSST (AQ0270)
DP,Name File Description
AQSTATIS Statistics file from ASTMSST (AQ0220)
AQSPARMS AQDHS-II parameter file
AQSSITES AQDHS-II sorted site file
AQSOPTIN Option card
AQSPRINT AQDHS-II statistical analysis report
Input/Output
Output
Output
Input/Output
Input
Input
Input
Input
Output
6.4.2.5.3 User-supplied JCL - Two option cards can be included in the job
stream when executing the statistical analysis procedure AQRPM10. The first
option card occurs in the step 'PRELIM' which executes ASTPRLM (AQ0190). See
Section 5.3.2.3 for a description of the format and possible values of this
option card. The second option card is in the step PRINTS which executes
ARPMSST (AQ0270). See Section 6.4.2.3 for a description of the format and
valid options of this card. In addition, the user must specify the data set
names of the master, parameter, and sorted site files. See Figure 6.4.2-e for
a description of the procedure's substitutable parameters.
530
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 7
Release Date: 10/31/81
Update #: 29
6.4.2.5.4 Sample run streams - The first run stream shown produces a
statistical report of the AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.
DATA.ONLY19771 (Assume this file contains only data from the calendar year
1977.) A monthly analysis period is chosen, and the report is formatted with
the FULL page-break option and a line-maximum of 55 lines per page. Note that
the master file does not need to be pre-sorted because it contains only one
year's worth of data.
// EXEC AQRPM10,
// MSTRFIL=ONLY1977,
// PARMFIL=PARM77,
// SITEFIL=SITE77
//PRELIM.OPTIONS DO * .
MONTH
/*
//PRINTS.OPTIONS DO *
FULL 55
/*
The second sample run stream produces a statistical report of the
AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.ALL1970S1. A yearly
analysis period is chosen, and the report format incorporates the BRIEF
page-break option and the default line-maximum of 64 lines per page. Because
the master file contains data for more than one year, a pre-sort is used; the
run stream includes this pre-sort (procedure AQSRM10 executing ASRMSTR
(AQ0140) with the STAT option).
// EXEC AQSRM10,
// MSTRFIL=ALL1970S,
// SORTFIL=SRT1970S
//SORT.OPTIONS DD *
531
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 8
Release Date: 4/30/79
Update #: 24
STAT
/*
// EXEC AQRPM10,
// MSTRFIL=SRT1970S,
// PARMFIL=PARM70S,
// SITEFIL=SITE70S
//PRELIM. OPTIONS DD *
YEAR
/*
//PRINTS. OPTIONS DD *
BRIEF
/*
The last run stream produces another statistical report of the AQDHS-II
master file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.ALL1970S'. No option card is
present for the preliminary statistics program, so the default option TOTAL is
used. No report format option card is present, so the page-break and
line-maximum default options of FULL and 64 lines per page are used. Since
the total -time-period option is used on a multi-year file, the master file
pre-sort is required.
// EXEC AQSRM10,
// MSTRFIL=ALL1970S,
// SOR.TFIL=SRT1970S
//SORT. OPTIONS DD *
STAT
/*
//
EXEC AQRPM10,
MSTRFIL=SRT1970S,
PARMFIL=PARM70S,
SITEFIL=SITE70S
532
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 9
Release Date: 4/30/79
Update #: 24
6.4.2.6 Warnings and Special Instructions
The preceding sample run streams demonstrate the master file sorting
requirements for different combinations of file content and analysis period.
To produce a more meaningful statistical report, any master file which
contains more than one calendar year's worth of data should be pre-sorted.
Output files from the sort program, the preliminary statistics program,
and the statistical analysis program are set up in the procedures as temporary
files. Therefore, the entire statistical analysis procedure (including the
pre-sort, if needed) must be rerun to regenerate the report.
6.4.2.7 Cost Considerations
The following estimates are for the execution of ARPMSST (AQ0270) on an
IBM 370/168:
Number of input records: 360 records
Number of report pages: 18 pages
CPU time: 1.7 seconds
I/O time: 5.0 seconds
Total time: 6.7 seconds
Estimated cost: $1.47
6.4.2.8 Related Programs and Procedures
Programs that are executed with ARPMSST (AQ0270) in the statistical
analysis procedure, AQRPM10, include the preliminary statistics program
ASTPRLM (AQ0190) (see Section 5.3.2) and the statistical analysis program
ASTMSST (AQ0200) (see Section 5.3.3). The master file sort program ASRMSTR
(AQ0140) is discussed in Section 5.6.2; the procedure that invokes the master
file sort program is AQSRM10.
533
-------
AGDHS-IJ STATISTICAL ANALYSIS REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM-NAME: ARPMSST (AQ0270)
REVISION LCVELl t-00
LAST UPDATE ft 24
DATE. INCORPORATED: OCTOBER 31, 1978
OPTION CARD IMAGE:
60
*«* ARPMSST 005 WARNING - COLUMN 1 - INVALID OR MISSING SITE BREAK OPTION - FULL BREAK OPTION USED
PRINTING OPTIONS CHOSEN ARE FULL SITE BREAK AND 60 LINES PER PAGE
cn
CO
Figure 6.4.2-a.
(page 1 of 5)
Examples of the Statistical Analysis Report with Full Option
m a
-o o
o IE
•yo co
-H I
co i—'
•o co co
•yo — i m
O f> o
O — I —)
5O HH I— I
> CO O
O CTl
co TO
co m
o
ro
o
•yo
ro
Q.
O>
r+
fD
n>
— '
(D
Q)
n>
o>
tQ
(D
t— '
o
Cu
rt
ro n>
co
o
1O
-------
AQOHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 9.2
Release Date: 5/01/80
Update 8: 27
This page left blank intentionally.
533.2
-------
AQOHS-I1 STATISTICAL ANALYSIS REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM-NAME: ARPMSST (AQ0270)
REVISION LEVEL: 4-00
LAST UPDATE tt: Z<)
DATE INCORPORATED: OCTOBER 31,
1981
«** ARPMSST 00^ WARNING - OPTION CARD MISSING: DEFAULT VALUES ARE 6* LINES PER PAGE AND FULL SITE BREAK
cn
CO
(Page 1 of 5)
Figure 6.4.2-a, Examples of the Statistical Analysis Report with Full Option
33 3>
m o
*^O C3
o z
33 CO
CO t-i
O
CD
TO
-o
STATISTI
SECTION 6
O
? *
CO TO
co n
—I -o
o
••—^ ?3
I> —I
O
r\j
2
Q.
O)
n>
=«=
XI
ns
fD
Ol
to
m
o
Ol
PO n>
o
co
(—•
oo
-o
cu
to
fD
o
-------
AODHS-II STATISTICAL ANALYSIS REPORT
ANALYSIS BY MONTH
PAGE 7
STATE (34): NORTH CAROLINA
SITE CODE: 34-000 1-004-A-06
AGENCY/PROJECT: A06
POLLUTANT NAME
POLLUTANT-HETHOD-INTERVAL-UNI TS
PCT NBR M1M MIN
YR/MON OBS UBS DETEC OBS
TOTAL SUSPENDED PARTICULATE
11101-91-8-01
76/10 16.1 5 .000 31.00
76/11 13.3 4 .000 6.000
76/12 16.1 5 .000 30.00
77/01 12.9 4 .000 0.0
77/02' 85.7 24 .000 65.00
SULFUR DIOXIDE
42401-91-8-01
76/07 16.1 5 5.000 0.0
in OXIDES OF NITROGEN
CO 42603-99-A-07
01 73/01 100.0 0.002 0.002
73/02 100.0 0.002 0.002
73/03 100.0 0.002 0.099
73/04 100.0 0.002 0.002
7-3/05 100.0 0.002 0.002
f3/06 100.0 0.002 0.002
73/07 100.0 0.002 0.099
73/08 100.0 0.002 0.002
73/09 100.0 0.002 0.002
73/10 100.0 0.002 0.002
73/11 100.0 0.002 0.002
73/12 100.0 0.002 0.002
Figure 6.4.2-a -
AGENCY TVPEi EPA - ATMOSPHERIC SURVEILLANCE COUNTY(2980)
SITE AODR: GUM BRANCH RO.,
METHOD OF COLLECTION AND ANALYSIS
CODE
PERCENTILES
10 30 SO 70 90 95 99
HI-VOL - GRAVIMETRIC
31. 43. 45. 62. 63. 63. 63.
6. 39. 39. 62. 124. 124. 124.
30. 34. 53. 71. 81. 81. 81.
0. 25. 25. 35. 964. 964. 964.
455. 455. 455. 455. 455. 455. 455.
JACKSONVILLE, ONSLUM CO.
INTERVAL UNITS
MAX
OBS
63.00
124.0
81.00
964.0
455.0
62
62
71
35
45
2ND
MAX
.00
.00
.00
.00
5.0
GAS BUBBLER - PARAROSANILINE-SULFAMIC
0. 0. 0. 0. 28. 28. 28.
28.00
0.
0
GAS BUBBLER - SALTZHAN METHOD
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.099 0.099 0.099 0.099 0.099 0.099 0.099
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.099 0.099 0.099 0.099 0.099 0.099 0.099
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002 0.002 0.002 0.002 0.002 0.002 0.002
0.002
0.002
0.099
0.002
0.002
0.002
0.099
0.002
0.002
0.002
0.002
0.002
continued. Examples of the Statistical
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
3RD
MAX
DAILY
45.00
39.00
53.00
25.00
455.0
DAILY
0.0
MONTHLY
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Analysis
ARIT ARIT
MEAN ST DEV
U-GMS/M3
48.80 13.60
57.75 49.78
53.80 22.33
256.0 472.2
424.7 102.7
U-6M3/HJ
5.600 12. 52
PARTS PER
0.002 0.0
0.002 0.0
0.099 0.0
0.002 0.0
0.002 0.0
0.002 0.0
0.099 0.0
0.002 0.0
0.002 0.0
0.002 0.0
0.002 0.0
0.002 0.0
(page
GEOM
MEAN
(250EG C,
47.20
36.62
49.94
25.48
396.7
(25 DEG C
4.053
MILLION
0.001
0.001
0.099
0.001
0.001
0.001
0.099
0.001
0.001
0.001
0.001
0.001
TIMES
HALF
GEOM M OET
3T DEV SUB
1013 M-BARS)
1.341 0
3.655 0
1.550 0
22.10 1
1.604 0
,1013 M»»ARS
2.945 4
(VOL/VOL)
.000
.000
.000
.000
.000
.000
.000
.000
.000
.000
.000
1.000
2 of 5)
Report with Full
Option
-o
73
o
CD
|
3»
73
3
CO
CO
*—*
2*
o
ro
-«J
o
c
•o
o.
0>
n
• *
ro
73
m
73
co
co
— I
— H
l-*4
CO
0
1—
73
m
o
73
— 1
73
ID
_j
(D
0>
to
to
O
0)
ID
CO
0
— 1
JO
o
-T-
co
1
1— 1
1—1
CO
m
o
— I
1-^
o
o>
V
.
ro
^
Ol
(0
ID
I— »
»— •
-------
AQOHS-II STATISTICAL ANALYSIS REPORT
ANALYSIS BY QUARTER
STATt (34): NORTH CAROLINA
PACE
SITE CODE: 31-0001-001-A-06
AGENCY/PROJECT: AO&
AGENCY TYPE: EPA
ATMOSPHERIC SURVEILLANCE CUUNTYC0960)
SITE ADDR: YADKIN RO., FAYETTEVILLE, CUMBERLAND CO.
POLLUTANT NAME METHOD OF COLLECTION AND ANALYSIS
POLLUTANT-METHOD-INTERVAL-UNITS COUE
PCT N9R MIN MIN PERCENTILES
YR/QTR DBS OBS DETEC DBS 10 30 50 70 90 95
99
MAX
OBS
2ND
MAX
INTERVAL
3RD
MAX
UNITS
ARIT ARIT
MEAN ST DEV
TIMES
HALF
GEOM GEOM M DET
MEAN ST DEV SUB
SULFUR DIOXIDE
12101-31-1-01
79/1 0.1
DAVIS INSTRUMENT - HYDROGEN PEROXIDE HOURLY
3 26.20 37.00 37. 37. 37. 9928. 9928. 9928. 9928. 9928. 37.00 37.00
U-GMS/M3 (25DEG C,10I3 M-BARS)
3331. 5710. 238.6 25.21 0
OXIDES OF NITROGEN
12603-11-7-07
79/1 12.2 22 0.010 0.010
INSTRUMENTAL - CHEMILUMINESCENCE 12 HOURS PARTS PER MILLION (VOL/VOL)
0.01 0.03 0.05 0.21 0.37 0.11 0.11 0.110 0.110 0.370 0.111 0.153 0.065 3.911 0
en
CO
Figure 6.4.2-a - continued.
(page 3 of 5)
Examples of the Statistical Analysis Report with Full Option
73 >
o ac
70 CO
CO I— l
-o co co
73 —I m
O
'yo >—• >—•
> co o
o
> O CTl
73 3=> •
co 73 ro
co m
—I -o
O
— ?3
O
ro
1—i
o
C 33
•a rp
ex —•
o> n>
c+ &
O) CA
o
a;
ro n>
•^ ..
co
o
VD
ro
-------
ADDMS-II STATISTICAL ANALYSIS REPORT
ANALYSIS FOR TOTAL TIMt PERIOD
STATE (31)1 NORTH CAROLINA
PAGt
SITE CODE: 31-0001-001-A-06 AGENCY TYi'El MM - ATMOSPHERIC SURVEILLANCE
AGENCY/PROJECT! A06 SITE AODHES3I YADKIN HiiAf)
COUNTY: 0960
CITYI
POLLUTANT NAME METHOD OF COLLECTION AND ANALYSIS
POLLUTANT-METHOD-INTERVAL-UNITS CODE 3A"i'ui\G DATES
PCT NBR MIN MJi| PERCENTILES
003 083 DETEC 003 10 30 SO 70 10 95
99
MAX
OUS
2ND
MAX
INTERVAL
3RD
MAX
UNITS
AHIT
MEAN
ARIT
3T DEV
GEOM
MEAN
HALF
GEOM M OET
ST DEV SUB
SULFUR DIOXIDE
42101-11-1-01
12.'3
26.20 37.00
OAVI3 iriST'iijMEM - HYDROGEN PEROXIDE HOURLY
03/28//'* TO 03/29/79
37. 37. 37. 1121. 'njfl. 9928. 9928. 9929. 37.00 37.00
12 HOURS
U-GMS/M3 (25DEG C,1013 M-BARS)
3331. 5710. 238.6 2i.2« 0
PARTS PER MILLION (VOL/VOL)
OXIDES OF NITROGEN IU3 rmjMENTAL - CHEMILIJMINE3CENCE
«2603-l'4-7-07 02/01/M TO 02/28/79
12.9 2'l 0.010 O.OJO 0.01 o.il3 O.n'i 0.21 0.37 O.'ll O.'ll O.'IIO O.'HO 0.370 0.110 0.1«7 0.069 3.763 0
Cr
co
Figure 6.4.2-a - continued.
(Page 4 of 5)
Examples of the Statistical Analysis Report with Full Option
m -O
-o o
O 3C
73 CO
—t I
CO <->
PROGR
ARPMSST
AQ02
CO CO
—I m
3=- O
—I —I
CO O
—I Z
»—H
O O1
> •
I— *>
.
73 PO
m
-o
o
?3
—I
Q.
o>
rp
=*»=
^3 T3
m o>
—• U3
fD fD
Cu
in HJ
(T) CO
tn
O
co
o
-------
ARPMSST (AQ0270) SUMMARY MESSAGES
PAGE
NUMBER OF INPUT RECORDS:
NUMBER OF SITE FILE RECORDS READ:
NUMBER OF ERRORS:
NUMBER OF OUTPUT PAGES:
PROGRAM-NAME: ARPMSST (AQ0270)
REVISION LEVEL: 4-00
LAST UPDATE 8: £9
DATE INCORPORATED: OCTOBER 31, 1981
42
85
1
9
Ul
GO
CO
(Page 5 of 5)
Figure 6.4.2-a - continued. Examples of the Statistical Analysis Report with Full Option
m o
-o O
O :c
73 GO
—I I
GO i—i
"O GO GO
;o —I rn
O 3> <~>
CD —I —I
JO i—i •—i
> oo o
> o
JO
-O
I— -P"
GO jo ro
GO m
o
JO
o
no
CL
cu
fD
=«=
JO
m
n>
cu
o>
o
CU
o
GO
i—>
oo
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 15
Release Date: 4/30/79
Update #: 24
Column 1 Column 7
[OPTION-1] [OPTION-2]
PAGE-BREAK LINE-MAXIMUM
OPTION OPTION
The content of the option card for the statistical report option card
is subject to the following restrictions:
1. The page-break option, if present, must begin in column 1. The
only valid values are BRIEF or FULL.
2. The line-maximum option, if present, must be a two-digit number and
begin in column 7.
Figure 6.4.2-b. Option Card Format
539
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 21
Release Date: 10/31/81
Update #: 29
Parameter
Name
PROJECT
PROG1
PROG2
PROG3
MSTRFIL
Default
Name
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ASTPRLM
ASTMSST
ARPMSST
TESTFM1
PARMFIL
SITEFIL
SPCUNT1
HTPARMAA
HTSITEAA
TRK
SPCUNT2
PRI1
SEC1
PRI2
SEC2
TRK
20
10
20
10
Description
Highest-level index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
TOTAL is the full data set name of the
waste file)
Preliminary statistics program
Statistical analysis program
Statistical report program
Lowest-level index of master file input to
ASTPRLM
Lowest-level index of parameter file
Lowest-level index of sorted site file
Units in which space for temporary output
files from ASTPRLM is to be allocated
Units in which spare for temporary output
file from ASTMSST is to be allocated
Primary space allocation for each temporary
output file from ASTPRLM
Secondary space allocation for each
temporary output file from ASTPRLM
Primary space allocation for temporary
output file from ASTMSST
Secondary space allocation for temporary
output file from ASTMSST
(page 1 of 2)
Figure 6.4.2-3. Substitutable Parameters for AQRPM10
540
-------
AQDHS-II SECTION 6.4.2
REPORTS STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
//*
//* PROCEDURE NAME; AORPM10
//* REVISION LEVEL! 1-00
//* LAST UPDATE ftl 2S
//* DAtE INCORPORATED! OCTOBER 31,1978
//*
Page 17
Release Date: 4/30/79
Update #: . 24
00000100
00000200
00000300
00000400
00000^00
00000600
//* THIS PRUCEDURE ALLOWS THE USER TU GENERATE A STATISTICAL ANALYSIS 00000700
//* REPORT
//*
//*
//AURPM10 PRUC PROJECT='CN.EPALMH.A087.CDHS.HQ.AOS',
// PROGlsASTPRLM,
// PRUG2=ASTMSST,
// PROG3=ARPMSST,
// MS1RF1L=AOMSTSRT,
// PARMFIL=AQPARMFL»
// SITEFIL=AQSITEFL,
// SPCUNT1=TRK,
// SPCUNT2=TRK,
// PRI1=20,
// SfcCl=10,
// PH12S20,
// SEC2=10,
// BLKSlZt=1300,
// TJME1='1,0',
// TIME2='1»0',
// • TIME3='1,0',
// UUTsA
//*
//PRELIM. EXEC PGMs&PROGl,
// TlMt=(&TIMEl)
//*
//* PREFORM PRELIMINARY STATISTICAL ANALYSIS
//*
//STEPLIB DO DSNAME=fcPROJECT.,LOADf
// VOLOMEs(PRIVATE, RETAIN),
// l)I3P=(SHR,PASS)
// UD DSNAMt. = SYSl.COBLIB,
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - MASTER FILE
//*
//AUSMASTR UD DSNAME3&PRCIJECT..DATA.&MSTRML,
// VOLUME=(PR1VATE, RETAIN),
// l)ISH = (SHH,PASS)
//*
//* INPUT DATA SET - PARAMETER FILE
//*
//AUSPAHMC Dl) USUAMES&PHOJECT..DATA.&PARMFIL,
// VOLU'-1E=(PRlVAtC, RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - OPTIONS CONTROL CARD
//*
//AQSOPT1N DD |)ONAME=OPTIONS,
// l)CH=ULKSlZEsHO
//*
//» OUTPUT DATA SE1 - FORTRAN-COMPATIBLE FILE CONTAINING
00000800
00000900
00001000
00001100
00001200
00001300
OOOOHOO
00001500
00001600
00001700
00001BOO
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004SOO
00004600
00004700
00004800
00004900
OOOOSOOO
00005100
00005200
00005300
OOOObUOO
OOOOSbOO
00005600
00005700
00005600
(page 1 of 4)
Figure 6.4.2-d. Cataloged Procedure AQRPM10
541
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 18
Release Date: 4/30/79
Update #: 24
//*
ABBREVIATED MASTER FILE RECORDS
//AQSRDATA DO UNIT=SYSDA,
// DISP=(NtW, PASS, DELETE),
// SPACES (&SPCUNT1,(&PRU,&SEC1),RLSE),
// DSNAMES&&DATAFIL
//*
//* OUTPUT DATA SET - FORTRAN-COMPATIBLE .STATIST ICS FILE
//*
//AQSSTATS DO IJN1T=SYSOA,
// D1SP=CNEW, PASS, DELETE),
// SPACES (&SPCUNTl,(&PRlt,&SECl),RLSE),
// DSNAMEsS&STATFIL
//*
//* OUTPUT DATA SET - MESSAGE LISTING
//*
//AQSPRINT OD SYSOUT = 8,UUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUT=&OUT
//*
//SYSOUT UU SYSOUT=8.0UT
//*
//SYSDBUUT DO SYSOUT=&OUT
//*
//SYSDTERM DD SYSOUT=&OUT
//*
//SYSUDUMP DD SYSUUT=&OUT
//*
//ANALYZE EXEC PGM=8,PROUa,
// REG10N=100K,
// TIME=(HTIME2)
//*
//* PERFORM STATISTICAL ANALYSIS Of READINGS IN MASTER FILE
//*
//STEPLIB DO I)3NAME=&PRUJECT..LUAD,
// VOLUME=(PR1VATL, RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - STAT FILE FROM ASTPRLM
//*
//FT07F001 DD DSNAHE=&&STATF 1L,
// DISP=(SHR, DELETE, DELETE)
//*
//* INPUT DATA SET - DATA FILE FHUM ASTPRLM
//*
//FT08F001 DD OSNAME = tliDAT ATIL,
// VULUME=(PRIVATt, RETAIN),
// OISP=(SHR,DELtTE, DELETE)
//*
//* OUTPUT DATA SET - STATISTICS FILE
//*
//FT09F001 DO UNI T=SYSI)A,
// DISP=CNtf.', PASS, DELETE),
// SPACE=USPCUNT2, UPR12, &SEC2) ,KL3E) ,
// DStiAMt = 8,iiSTAT()lJT,
// DCO=(Rttf M=Fb,LRLCL=lOO,bLK3IZL = i
OOOOS900
00006000
OOOObtOO
00006?00
00006300
00006400
00006500
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
opooeooo
00008100
00006200
OOOOH300
ooooeuoo
00006500
00008600
OOOOB700
00008600
00008900
00009000
00009100
00009200
00009300
00009000
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010100
00010500
00010600
00010700
00010HOO
00010900
00011000
00011100
00011200
00011300
00011400
OOOllbOO
OOOllhOO
Figure 6.4.2-d - Continued.
(page 2 of 4)
Cataloged Procedure AQRPM10
542
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 19
Release Date: 4/30/79
Update #: . 24
//*
//* OUTPUT DATA SET - DIAGNOSTIC MESSAGES
//*
//FT06F001 00 SYSOUT=&UUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DO SYSOl)T = &t)UT
//»
//SYSUDUMP 00 SYSUUT=&OUT
//*
//FT03F001 DO 3YSOUT=&OUT
//*
//PRINTS LXEC PG*
// TIME=UTIME3)
//*
//* LIST OATA ANALYSIS STATISTICS FILE
//*
//STEPLIb 00 l)SNAML = &PROJt.CT..LUAD,
// VOLUME=(PRIVAU, RETAIN),
// OISP=(SHR,PASS)
// 00 OSNAME=SYS1.COBL1Q,
// DISP=(SHR,PASS)
//*
//* INPUT OATA SET - STATISTICS FILE FROM ASTMSST
//*
//AOSTATIS 00 DSNAMEslUSTATOUT,
// OlSr=(SHR,OELtTL,OCLEtE)
//*
//* INPUT OATA SfcT - PARAMETER FILE
//»
//AQSPARMS DO DSNAME = &PROJEC T . .DATA.&PAHMUL,
// VOLUME=(PRIVATE, RETAIN),
// OISP=(SHR,PASS)
//*
//* INPUT OATA SET - SITE FILE
//*
//A(JS3ITE3 DO DSNAME=&PKOJECT..DATA.&SITEFIL,
// VOLUME=(PKIVATh, RETAIN),
// OISr=(SHR,PASS)
//*
//* INPUT OATA SET - CONTROL CARO
//*
//AOSOPTIN 00 ODNAME=tlPTION3,
// OCRsULKS12E=HO
//*
//* OUTPUT UATA SET - STATISTICAL ANALS1S REPURT
//*
//AUSPRINI 00 SYSOUT=SUUT
//*
//* OUTPUT UATA SETS - SYS1LM OPERATION
//*
//SYSPRINT OD
//*
//SYSOUT 00
//*
//SYSDBOUT l)u SYSDUTsKOUT
00011700
00011800
00011VOO
oootaooo
00012100
00012200
00012iOO
00012400
00012500
00012600
00012700
00012HOO
00012900
00013000
00013100
00013200
OOOIiJOO
00013000
00013500
00013600
00013700
00013800
00013900
00010000
00011100
00014200
00014300
00014400
00014500
00014600
00014700
00014800
00014900
00015000
00015100
00015200
00015300
00015400
00015500
00015600
00015700
00015HOO
00015900
00016000
00016100
00016200
00016300
00016400
00016500
00016600
00016700
00016HOO
00016900
00017000
ooomoo
00017200
00017300
00017400
Figure 6.4.2-d - Continued.
(page 3 of 4)
Cataloged Procedure AQRPM10
543
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 20
Release Date: 4/30/79
Update #: . 24
//*
//SYSDTEKM
//*
//SYSUUUMP
//*
DU SYSOUT=&UUT
00 SYSOUT=&OUT
00017500
00017600
00017700
00017600
00017900
(page 4 of 4)
Figure 6.4.2-d - Continued. Cataloged Procedure AQRPM10
544
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 21
Release Date: 4/30/79
Update #: . 24
Parameter
Name
PROJECT
PROG1
PROG2
PROG3
MSTRFIL
PARMFIL
SITEFIL
SPCUNT1
Default
Name
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ASTPRLM
ASTMSST
ARPMSST
TESTFM1
HTPARMAA
HTSITEAA
TRK
SPCUNT2
PRI1
SEC1
PRI2
SEC2
TRK
20
10
20
10
Description
Highest-level index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
TOTAL is the full data set name of the
waste file)
Preliminary statistics program
Statistical analysis program
Statistical report program
Lowest-level index of master file input to
ASTPRLM
Lowest-level index of parameter file
Lowest-level index of site file
Units in which space for temporary output
files from ASTPRLM is to be allocated
Units in which space for temporary output
file from ASTMSST is to be allocated
Primary space allocation for each temporary
output file from ASTPRLM
Secondary space allocation for each
temporary output file from ASTPRLM
Primary space allocation for temporary
output file from ASTMSST
Secondary space allocation for temporary
output file from ASTMSST
(page 1 of 2)
Figure 6.4.2-e. Substitutable Parameters for AQRPM10
545
-------
AQDHS-II
REPORTS
SECTION 6.4.2
STATISTICAL REPORT
PROGRAM ARPMSST (AQ0270)
Page 22
Release Date: 4/30/79
Update #: 24
Parameter
Name
BLKSIZE
TIME1
TIME2
TIMES
OUT
Default
Name
4000
•l.O1
'1.0'
'l.O1
A
Description
Block size for output statistics file
from ASTMSST
Time allowed to execute ASTPRLM
Time allowed to execute ASTMSST
Time allowed to execute ARPMSST
SYSOUT class for all print files
(Page 2 of 2)
Figure 6.4.2-e - Continued. Substitutable Parameters for AQRPM10
546
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 1
Release Date: 4/30/79
Update #: 24
6.4.3 ANOMALY SCREENING REPORT PROGRAM - ARPANOM (AQ0320)
6.4.3.1 Description
The anomaly screening report program, ARPANOM (AQ0320), is the second of
two programs used to screen the AQDHS-II master file for values that are
anomalous and are, therefore, potentially in error. ARPANOM (AQ0320) is
executed after the anomaly screening master file conversion program, ACVANOM
(AQ0040). ARPANOM (AQ0320) is coded in FORTRAN.
Anomaly screening of the AQDHS-II master file is accomplished by
subjecting readings on the master file to various statistical screening tests.
Only non-null readings which fall into one of the categories listed in Figure
6.4.3-a are screened. ACVANOM (AQ0040) selects readings to be screened,
performs the gap test on hourly readings, produces a new AQDHS-II master file,
and produces a file which is passed to ARPANOM (AQ0320). Refer to Section
5.5.5 for program operating instructions for ACVANOM (AQ0040).
ARPANOM (AQ0320) subjects all the data on the file passed from ACVANOM
(AQ0040) to the appropriate anomaly screening tests. (Refer to Section
5.5.5.2.) Hourly readings are subjected to the pattern tests (maximum value
test, adjacent hourly difference test, spike test, and modified Dixon ratio
test) in addition to the gap test that is performed by ACVANOM (AQ0040). Daily
readings are subjected to the Shewhart test.
The anomaly screening tests performed by ARPANOM (AQ0320) are discussed
below.
547
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 2
Release Date: 4/30/79
Update #: 24
Pattern Tests (Hourly Data) - There are four pattern tests: the maximum
value test, the adjacent hourly difference test, the spike test, and the
modified Dixon ratio test. The adjacent hourly difference test, the spike
test, and the modified Dixon ratio test are applied only if one of the readings
on which the test is based exceed 100 yg/m^ for ozone and total oxidants, 20
mg/m3 for carbon monoxide, 225 yg/m3 for nitrogen dioxide and 650 yg/m^ for
sulfur dioxide.
Maximum value test - Readings that exceed an upper limit are
judged anomalous. The upper limit is based on the pollutant, time of
year, time of day, and geographic location. These upper limits are
presented in Figure 6.4.3-b.
Adjacent hourly difference test - Any reading that differs from
the reading for an adjacent hour by more than a specified limit is
judged anomalous. The limit is based on the pollutant, time of year,
time of day, and geographic location. These limits are presented in
Figure 6.4.3-c.
Spike test - A spike is a reading that is higher than both the
preceding and following readings or lower than both the preceding and
following readings. If a spike occurs in the readings Xj, X^+i, and X-j+2,
then the following values are computed:
1. The absolute differences: |X-j+i - X
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 3
Release Date: 4/30/79
Update #: 24
3. If the middle reading is low, the percentages by which the
outer readings exceed the middle reading:
Xi+2 -
x 100 and x 100
The data is judged anomalous if both absolute differences exceed
a maximum value or if both percentage differences exceed a maximum value.
These values are presented in Figure 6. 4. 3-d.
Modified Dixon ratio test - This test is applied if there are
valid readings for at least 18 hours and the coefficient of variation
of the readings (i.e., standard deviation divided by mean) is greater
than 0.75. The data is ordered lowest to highest. Letting xj represent
the lowest value and xn represent the highest value, the following ratio
is computed:
xn - xn~2
r =
The data is judged anomalous if this ratio exceeds 0.55. This test
is not applied to readings for carbon monoxide.
Shewhart Test (Daily Data) - In order to apply the Shewhart test to a
particular month of data, certain statistics relating to that month and three
previous months of data are required: the range (the difference between the
highest and the lowest values) and mean of the readings in the month being
tested, the mean of the ranges of the three previous months, the mean of the
means of the three previous months, and the number of non-null readings in the
three previous months. These statistics are prepared by ACVANOM (AQ0040) using
the three most previous months for which data is available. Upper control
limits (UCL) and lower control limits (LCL) are computed for the range and
mean as shown below.
549
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 4
Release Date: 4/30/79
Update #: 24
For range,
for mean,
UCLR
LCLR = D3R
UCLx"
LCLy
+
- A2R
where R = range of month being tested
R = mean of three previous monthly ranges
X = mean of month being tested
s
A = mean of three previous monthly means
A2» D3> and D4 vary depending upon the number of non-null
readings in the three previous months (refer to Figure 6.4.3-e).
The data is judged anomalous if R exceeds UCLR or X exceeds UCLy . Also,
if the user so specifies, via the FLAG LOW option on the control card read by
ACVANOM (AQ0040), the data will be judged anomalous if R is below LCLR or X is
below LCLy.
6.4.3.2 File Formats
The temporary file passed from ACVANOM (AQ0040) is the only input file
to ARPANOM (AQ0320). See Section 5.5.5.2 for a discussion of this file.
There are four output files produced by ARPANOM (AQ0320): a diagnostic
report, an anomaly screening report for hourly readings, an anomaly screening
report for daily readings, and a file of skeleton transactions.
The diagnostic report consists of update messages, program statistics, and
error messages. It also lists the option in effect. See Figure 6.4.3-f for
a sample printout and Section 6.4.3.4 for a listing of the error messages.
550
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 5
Release Date: 4/30/79
Update #: 24
The anomaly screening report for hourly readings identifies hourly
readings that fail one or more anomaly screening tests and are thereby judged
anomalous. The report also includes the key information required for columns 1
through 32 of the AQDHS-II master file transactions necessary to change the
readings identified as anomalous. Since the gap test is based on an entire
month of hourly readings, only key information is printed for gap test
failures. For failures of the Dixon ratio test, the maximum value test, the
adjacent hourly difference test, and the spike test, the key information is
accompanied by the readings (in their original format) from the AQDHS-II master
file record Containing the anomalous data. The Dixon ratio test is based upon
an entire day of hourly readings; the specific data causing failure of the test
is not identified. The spike test is based upon three consecutive non-null
readings; the readings causing failure of the test are flagged in the report
with an S. The adjacent hourly difference test is based upon two consecutive
non-null readings; the readings causing failure of the test are flagged in the
report with an A. The maximum value test is based upon individual non-null
readings; the reading causing failure of the test is flagged in the report with
an M.
For gap test failures, entries for day (columns 19 and 20), start hour
(columns 21 and 22), and decimal point indicator (column 32) are question marks
in the report since the specific anomalous values cannot be identified. For
failures of the other hourly anomaly screening tests, the entry for start hour
1s 'XX1 and the entry for decimal point indicator is '*'. The appropriate
start hour for the various readings is printed below the 'XX' entry. (For
example, all readings printed 1n the first row for a given day have a start
hour of '00'.) The decimal point Indicator for each reading 1s printed with
the reading.
See Figure 6.4.3-g for a sample printout of this type of anomaly
screening report.
551
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 6
Release Date: 4/30/79
Update #: 24
Data .that fails any of the anomaly screening tests should be verified.
Readings found to be in error should be corrected using AEDMSTR (AQ0060),
ASRINTR (AQ0130), and AFMMSTR (AQ0100). Since the readings causing failure of
the gap test are not printed in the report, it may be necessary to retrieve and
list the raw data in question by executing ARTLNGP (AQ0110), ARTGENR (AQ0120),
and ARPMSTR (AQ0230).
The anomaly screening report for daily readings identifies the daily
readings that fail the Shewhart test and are thereby judged anomalous. There
is no distinction between low and high Shewhart test failures in the report.
The report includes the key information required for columns 1 through 32 of
the AQDHS-II master file transactions necessary to change the readings
identified as anomalous, as well as the readings (in their original format)
from the AQDHS-II master file record containing the anomalous data. Since the
Shewhart test is based upon an entire month of daily readings, the specific
data causing a Shewhart test failure cannot be identified. The entry for day
(columns 19 and 20) is '**' and the entry for decimal point indicator (column
32) is '*'. The decimal point indicator for each reading is printed with the
reading.
See Figure 6.4.3-h for a sample printout of this type of anomaly screening
report.
Data that fails the Shewhart test should be verified. Readings found to
be in error should be corrected using AEDMSTR (AQ0060), ASRINTR (AQ0130), and
AFMMSTR (AQ0100).
The file of skeleton transactions produced by ARPANOM (AQ0320) contains
skeleton transactions which may be used in creating AQDHS-II master file
transactions to change any erroneous readings in the master file. One
skeleton transaction will be included for each master file record determined to
contain one or more anomalous readings. Only columns 1 through 32 and 80 of
the skeleton transaction are filled in. Entries that cannot be determined by
552
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 7
Release Date: 4/30/79
Update #: 24
ARPANOM (AQ0320) are represented by question marks. See Figure 6.4.3-i for
the format of these skeleton transactions.
Before the skeleton transactions can be used to update the master file,
the user must complete those skeleton transactions which he has determined are
needed for updating his master file. Anomalous data that has been verified as
correct should not be changed; consequently, the associated skeleton
transaction should be discarded. The user may need to duplicate certain
skeleton transactions; e.g., if more than one reading needs to be corrected in
a given record, or if readings from more than one day need to be corrected in a
month of hourly readings which failed the gap test. Question marks in a
skeleton transaction indicate that the field which has question marks in it
must be replaced by the appropriate information for that field (e.g., day,
start hour, and/or decimal code). The correct reading should be entered in the
appropriate position in columns 33 through 36 for daily readings or in columns
33 through 64 for hourly readings. See Section 4.5.1.1 for complete
information on master file transactions. Note that the skeleton transactions
for hourly readings are form-1 transactions and the skeleton transactions for
daily readings are form-2 transactions.
6.4.3.3 Options
Options for ARPANOM (AQ0320) are specified via a control card read by
ACVANOM (AQ0040). Refer to Section 5.5.5.3 for the format of this control
card.
The 'low Shewhart1 option is triggered by FLAG LOW on the control card
read by ACVANOM (AQ0040). This option causes daily data to be compared to the
lower control limits as well as the upper control limits by the Shewhart test
(refer to Section 6.4.3.1). Use of this option is not recommended for general
use (refer to Section 6.4.3.6).
553
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 8
Release Date: 4/30/79
Update #: 24
The 'no low Shewhart' option is triggered by NO FLAG LOW on the control
card read by ACVANOM (AQ0040) or by a blank or missing control card. This
option causes daily data to be compared only to upper control limits by the
Shewhart test (refer to Section 6.4.3.1).
Note: Once either option is executed., that data is flagged and will not
be subjected to anomaly screening again unless the flags are
reset.
6.4.3.4 Error Messages
ARPANOM 001 DISASTER - INVALID OR MISSING HEADER RECORDS ON INPUT FILE
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
invalid or missing header records.
Action: Call NADB.
ARPANOM 002 ABORT - INVALID OPTION
Meaning: The option card read by ACVANOM (AQ0040) was invalid.
Action: Correct or delete the option card and re-execute ACVANOM
(AQ0040) and ARPANOM (AQ0320).
ARPANOM 003 DISASTER - INPUT FILE CONTAINS DATA NOT TO BE SCREENED
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320)
contains data which does not fall into one of the categories in
Figure 6.4.3-a.
Action: Call NADB.
ARPANOM 004 ABORT - INVALID STATE CODE (XXXXXXXXXXXXX-YYYYYY-ZZZZZZZZZ).
Meaning: A master file record has an Invalid state code. (Note: this
error can only occur when screening readings for sulfur .
dioxide.) XXXXXXXXXXXXX 1s the state-area-slte-agency-project-
554
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 9
Release Date: 4/30/79
Update #: 24
time codes, YYYYYY is the year-month-day, and ZZZZZZZZZ is the
parameter-method-unit codes of the record causing the error.
Action: Correct the master file using AEDMSTR (AQ0060), ASRINTR
(AQ0130), and AFMMSTR (AQ0100). Re-execute ACVANOM (AQ0040)
and ARPANOM (AQ0320).
ARPANOM 005 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
ARPANOM 006 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
ARPANOM 007 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
ARPANOM 008 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
6.4.3.5 Cataloged JCL
ARPANOM (AQ0320) should always be executed in conjunction with ACVANOM
(AQ0040). The JCL presented in this section is used to execute both programs.
555
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 10
Release Date: 4/30/79
Update #: 24
6.4.3.5.1 JCL listing - Figure 6.4.3-j contains a listing of the cataloged
procedure AQRPM45.
6.4.3.5.2 Cross-reference of DD names and files
Program Name: ACVANOM (AQ0040):
DD Name File Description
AQSOLDMF Input AQDHS-II master file
AQSNEWMF Output AQDHS-II master file
AQSOPTIN Option card file
AQSPARM AQDHS-II parameter file
AQSANOMF Temporary file passed to ARPANOM (AQ0320)
AQSPRINT Anomaly screening master file conversion program
diagnostic report
Program Name: ARPANOM (AQ0320):
Note: Since ARPANOM (AQ0320) is coded in FORTRAN, the DD names are
machine-dependent. The DD names listed here are for IBM 360/370
computers. The FORTRAN device numbers are provided in parentheses
after the listed DD names.
Input/Output
Input
Output
Input
Input
Output
Output
DD Name
FT06F001 (6)
FT07F001 (7)
FT08F001 (8)
File Description
Anomaly screening report program
diagnostic report
Anomaly screening report for hourly
readings
Anomaly screening report for daily
readings
Input/Output
Output
Output
Output
556
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 11
Release Date: 4/30/79
Update #: 24
DP Name
FT09F001 (9)
FT10F001 (10)
File Description
Temporary file received from ACVANOM
(AQ0040)
Skeleton transactions
Input/Output
Input
Output
6.4.3.5.3 User-supplied JCL - To execute the cataloged procedure AQRPM45, the
user can expect to supply job accounting information (job card), names of input
and output AQDHS-II master files, the name of the AQDHS-II parameter file, and
the name of the skeleton transaction file produced by ARPANOM (AQ0320). Other
JCL elements likely to be supplied by the user are the time parameters. See
Figure 6.4.3-k for a description of the procedure's substitutable parameters.
5.5.5.5.4 Sample run streams - The following run stream would screen the
AQDHS-II master file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.MF1102781. The new
AQDHS-II master file is named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.MF1105781. The
AQDHS-II parameter file is 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.PF0903781. The
skeleton transaction file produced by ARPANOM (AQ0320) is named 'CN.EPALMH.A087.
CDHS.HQ.AQS.DATA.ST1105781.
// EXEC AQRPM45,OLDMSTR='MF110278'8
// NEWMSTR='MF110578',
// PARMFIL='PF090378',
// SKEL='ST110578'
The following run stream accomplishes the same functions as the preceding
run stream with these modifications: the FLAG LOW option is specified, the file
passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) is cataloged and named
'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.TF1105781, the skeleton transaction file
produced by ARPANOM (AQ0320) is written to punched cards rather than disk, and
the time specification for ACVANOM (AQ0040) is three minutes.
557
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 12
Release Date: 4/30/79
Update #: 24
// EXEC AQRPM45,OLDMSTR='MF110278',
// NEWMSTR='MF110578',
// PARMFIL='PF090378',
// TIME1=3,
// DISP3='NEW,CATLG',
// DISP4='OLD,KEEP'
//CONVERT.OPTIONSDD *
FLAG LOW
/*
//CONVERT.AQSANOMF DD DSNAME=CN.EPALMH.A087.CDHS.HQ.AQS.DATA.TF110578,
// UNIT=3330,
// VOL=(PRIVATE,SER=CDHSPK)
//REPORT.FT09F001 DD DSNAME=CN.EPALMH.A087.CDHS.HQ.AQS.DATA.TF110578
//REPORT.FT10F001 DD SYSOUT=B
6.4.3.6 Warnings and Special Instructions
To screen the AQDHS-II master file, both ACVANOM (AQ0040) and ARPANOM
(AQ0320) must be executed successfully.
All readings subjected to anomaly screening tests are converted to standard
units by using the appropriate standard units conversion factor from the
AQDHS-II parameter file. Thus it is imperative that the standard units
conversion factors on the parameter file are correct. Execution of ARPPARM
(AQ0240) will permit verification of entries in the parameter file.
Records causing error 'ACVANOM 006' or 'ACVANOM 007' are not subjected to,
nor included in, any anomaly screening tests.
558
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 13
Release Date: 4/30/79
Update #: 24
Any readings identified in the reports from ARPANOM (AQ0320) as being
anomalous should be verified. Any readings found to be in error should be
corrected using AEDMSTR (AQ0060), ASRINTR (AQ0130), and AFMMSTR (AQ0100). The
skeleton transactions created by ARPANOM (AQ0320) may be used to create the
necessary master file transactions. The user is cautioned to save all printed
anomaly screening reports until all anomalous data has been checked and verified
or changed. If anomalous data has been verified, it is recommended that this
verification be forwarded to the user's Regional Office when this data is sub-
mitted to SAROAD.
When ACVANOM (AQ0040) is executed, the reading and record status flags in
the master file are appropriately changed to indicate which readings have been
screened. Data that has been screened will not be subjected to anomaly
screening again. However, if a screened reading is subsequently changed using
AEDMSTR (AQ0060), ASRINTR (AQ0130), and AFMMSTR (AQ0100) then both the reading
status flag and the record status flag are reset and the changed reading is
screened during the next execution of ACVANOM (AQ0060) and ARPANOM (AQ0320).
No reading in the AQDHS-II master file is changed or deleted by the
anomaly screening programs. The user bears the sole responsibility of changing
any values found to be in error.
The anomaly screening tests are applied only to non-null readings which
fall into one of the categories in Figure 6.4.3-a. Other readings are not
subjected to anomaly screening tests. Furthermore, the anomaly screening
programs cannot be expected to Identify all erroneous readings among those
categories since a reading can be in error without being judged anomalous.
Thus, one cannot assume that readings that pass the anomaly screening tests are
valid. The anomaly screening programs are only tools to improve the quality of
data 1n the AQDHS-II master file.
559
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 14
Release Date: 4/30/79
Update #: 24
The FLAG LOW option is not recommended for ordinary use for two reasons.
First, the major concern in air quality data is valid high readings which exceed
the standards. The FLAG LOW option identifies readings that are classified
anomalous even though they may be considerably below the standards. Secondly,
the FLAG LOW option may identify a large quantity of readings as being
anomalous.
There is no distinction between low and high Shewhart test failures in the
anamoly screening report for daily data.
6.4.3.7 Cost Considerations
The following estimates are for the execution of ARPANOM (AQ0320) on an IBM
370/168:
Size of input file from ACVANOM (AQ0040) 978 records
CPU time 3.4 seconds
I/O time 5.6 seconds
Total time 9.0 seconds
Estimated cost $7.11
6.4.3.8 Related Programs and Procedures
ARPANOM (AQ0320) should always be executed in conjunction with ACVANOM
(AQ0320). The cataloged procedure AQRPM45 will execute both programs.
560
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 15
Release Date: 4/30/79
Update #: . 24
Sampling Parameter
Pollutant Interval Code
Total Suspended Particulate Daily 11101
Carbon Monoxide Hourly 42101
Sulfur Dioxide Hourly 42401
Sulfur Dioxide Daily 42401
Nitrogen Dioxide Hourly 42602
Nitrogen Dioxide Daily 42602
Total Oxidants Hourly 44101
Ozone Hourly 44201
AQDHS-II
Time Code
8
1
1
8
1
8
1
1
Figure 6.4.3-a. Categories of Data to be Subjected to Anomaly Screening Tests
561
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 16
Release Date: 4/30/79
Update #: .24
Pollutant
Ozone and
Total Oxidants
Carbon Monoxide
Nitrogen Dioxide
Sulfur Dioxide
Stratification
May - October, 10 a.m. - 5 p.m.
May - October, 6 p.m. - 9 a.m.
November - April, 10 a.m. - 5 p.m.
November - April, 6 p.m. - 9 a.m.
6 a.m. - 10 a.m., 4 p.m. - 8 p.m.
11 a.m. - 3 p.m., 9 p.m. - 5 a.m.
EPA Regions 1, 5, 6, 7
EPA Regions 2, 3, 4
EPA Regions 8, 9, 10
Maximum Value*
1000 ug/m3
750 ug/m3
500 ug/m3
300 ug/m3
75 mg/m3
50 mg/m3
1200 ug/m3
2600 ug/m3
1300 ug/m3
800 ug/m3
*Source: Monitoring and Data Analysis Division, Office of Air Quality
Planning and Standards, Environmental Protection Agency.
Figure 6.4.3-b. Test Values for the Maximum Value Test
562
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 17
Release Date: 4/30/79
Update #: 24
Pollutant
Ozone and
Total Oxidants
Carbon Monoxide
Nitrogen Dioxide
Sulfur Dioxide
Stratification
May - October, 10 a.m. - 5 p.m.
May - October, 6 p.m. - 9 a.m.
November - April, 10 a.m. - 5 p.m.
November - April, 6 p.m. - 9 a.m.
EPA Regions 1, 5, 6, 7
EPA Regions 2, 3, 4
EPA Regions 8, 9, 10
Maximum Difference*
300 ug/m3
200 ug/m3
250 ug/m3
200 ug/m3
25 mg/m3
500 ug/m3
500 ug/m3
300 ug/m3
200 ug/m3
*Source: Monitoring and Data Analysis Division, Office of Air Quality
Planning and Standards, Environmental Protection Agency.
Figure 6.4.3-c. Test Values for the Adjacent Hourly Difference Test
563
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 18
Release Date: 4/30/79
Update #: 24
Pollutant
Ozone and
Total Oxidants
Carbon Monoxide
Nitrogen Dioxide
Sulfur Dioxide
Maximum Absolute* Maximum Percentage*
Stratification Difference Difference
10 a.m. - 5 p.m.
6 p.m. - 9 a.m.
200 yg/m3
100 yg/m3
20 mg/m3
200 yg/m3
yg/m3
300%
300%
500%
300%
*Source: Monitoring and Data Analysis Division, Office of Air Quality
Planning and Standards, Environmental Protection Agency.
Figure 6.4.3-d. Test Values for the Spike Test
564
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 19
Release Date: 4/30/79
Update #: 24
Shewhart Test Coefficients
Number of Readings
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20 or more
A2
1.88
1.02
0.73
0.58
0.48
0.42
0.37
0.34
0.31
0.29
0.27
0.25
0.24
0.22
0.21
0.20
0.19
0.19
0.18
D3
0.00
0.00
0.00
0.00
0.00
0.08
0.14
0.18
0.22
0.26
0.28
0.31
0.33
0.35
0.36
0.38
0.39
0.40
0.41
D4
3.27
2.57
2.28
2.11
2.00
1.92
1.86
1.82
1.78
1.74
1.72
1.69
1.67
1.65
1.64
1.62
1.61
1.60
1.59
*Source: Grant, Eugene L., Statistical Quality Control. 3rd edition (New
York: McGraw-Hill Book Company), p. 562.
Figure 6.4.3-e. Shewhart Test Coefficients
565
-------
AOOHS-II ANOMALY SCREENING REPORT- PROGRAM. -1 DIAGNOSTIC REPORT
PAGE I
tn
cn
PROGRAM NAME: ARPANOM (AQ0320)
REVISION LEVtLl l-OO
LAST UPDATE *: ZH
INCORPORATED: OCTOBER 31, 1970
OPTION IN EFFECTS LOrt SHEHHART TEST
NUMBER Of INPUT RECORDS I 146
NUMBER OF IMPUT RECORDS CONTAINING HOURLY DATA: SS
NUMBER OF INPUT RECORDS CONTAINING DAILY DATA! 88
NUMBER OF INPUT HEADER RECORDS: 2
NUMBER OF INPUT TRAILER RECORDS: 1
NUMBER OF TIMES MAXIMUM VALUE TEST FAILED! 10
NUMBER OF TIMES ADJACENT HOURLY DIFFERENCE TEST FAILED: la
NUMBER OF TIMES SPIKE TEST FAILED: 3
NUMBER OF TIMES DIXON RATIO TEST FAILED! 5
NUMBER OF TIMES GAP TEST FAILED: 6
NUMBER OF TIMES SHEWHART TEST FAILED: la
NUMBER OF OUTPU1 SKELETON TRANSACTIONS: 27
Figure 6.4.3-f. Diagnostic Report
m
-o
o
TO
—t
oo •— <
(S>
~a 3s> co
•yo -z. m
o o o
en 3 -i
30 3» 1-1
> t— o
2 -< Z
J» CO
5O O •
o z:
—. en
£ so
o m
co -o
ro o
o yo
m co
c: TO -o
•O
Q. — < (O
=*:
.. O
O)
<-t
rvs ro
CJ
o
ro
o
-------
en
en
AUDHS-1I ANOMALY SCREENING
0 00 0000 001 1 11 1 11 11 12 22 22222 22 33 3 REAOINGSCFORMAT
1 23 4567 890 1 23 4 56 78 90 12 34567 89 01 2 CC33 CC37
1-10-0001-OOL-E-02-1-71-06-77-77-42401-11-07-*
1-12-0001-003-C-01-1-78-04-I5-XX-42I01-11-05-*
00 1
08 0
16 1
1-12-0001-003-C-01-1-78-04-77-77-42101-11-05-*
1-12-0001-OOS-C-01-1-78-OI-S1-XX-4210I-1 1-06-*
00 0
08 0
16 1
1-12-0001-003-C-01-1-78-11-22-XX-42602-14-07-*
00 3
08 3
16 3
1-12-0001-003-C-01-1-78-H-77-77-42602-14-07-*
1-12-0001-003-C-01-I-78-I2-30-XX-426Q2-14-07-*
00 3
08 3
16 3
1-12-0001-003-C-OI-1-78-12-77-77-42602-14-07-*
* DECIMAL PT INDICATORS ARE LISTED HITH READINGS
»• TEST CODES (PRINTED HELOM READINGS)! AsADJACENT
Figure 6.4.3-g.
0290 1 0170
9999 1 0690
A
0170 1 0170
9999 0 9999
9999 0 9999
0040 1 0003
0360 3 0345
0900 3 0840
M AH
0380 3 0440
015S 3 0150
0155 3 0170
4550 3 0600
AMS AS
REPORT FUR HOURLY
IS N XXXX
CC41
1 0170
1 0230
A
1 0230
0 9999
1 0034
1 0002
A
3 0340
3 0400
A
3 0385
3 0150
3 0150
3 0405
HOURLY DIFFERENCE TEST
Anomaly Screening
READINGS
WHERE N=DECIMAL
CC45 CC49
1
1
I
0
1
1
3
3
3
3
3
3
0170
0340
0230
9999
0031
5747
AMS
0335
0320
0350
0155
0160
0290
1 0120
1 0170
1 0460
A
0 9999
1 0022
1 8045
AMS
3 0350
3 0340
3 0335
3 0150
3 0240
3 0270
, MsMAXIMUM VALUE
Report
PT INDICATOR,
CC53
1 0120 1
1 0170 1
1 0920 I
AM
0 9999 0
1 0024 1
1 5747
AMS
3 0375 3
3 0330 3
3 0330 3
3 0150 3
3 0290 3
3 0250 3
TEST, S»SPIKE
PAGE 1
XXXXSREADIIJG) D R GAP
CC57 CC61 TEST TEST
0230
0120
0800
AM
9999
0026
0385
A
0340
0340
0150
0290
0250
TEST
FAIL
N/A
1 0290
1 0120
1 0290
A
MIL
N/A
0 9999
1 0029
N/A
3 0760
AM
3 0390
3 0340
FAIL
FAIL
3 0145
3 0335
AS
3 0260
FAIL
for Hourly Readings
-o
yo
0
CD
•yo
2
•yo
Z
2
•^
j^
O
co
ro
o
c=
X>
o.
o>
rt
0>
..
ro
yo
rn
HQ
O
yo
co
J,
Jjg
0
2
p—
-<
co
yo
1 ' i
m
HH
22
£T>
•yo
m
1Q
0
yo
yo
(0
n>
fu
n>
o
Q)
CD
co
o
IO
.£,
-/""^
o
IT
co
i
i— i
co
m
o
—i
i— i
o
CD
-^
CO
~Q
(XI
ua
(D
ro
i— •
-------
en
cn
A'Jl>HS-II ANOMALY SCREENING REPORT FOR DAILY READINGS
PAGE 1
0 00 0000 001 111111 11 12 22 22222 22 33 3 SHENHT
1 23 1567 890 1 23 1 56 78 90 12 31567 89 01 2 DAYS RtADINGSCFUHMAT IS N XXXX WHERE N«DECIMAL PT INDICATOR, XXXX=READING) TEST
2-31-000 1-001-A-06-8-77-01-*
«-00-11101-91-Ol-» 1-80 0035 0 9999 0 9999 0 9999 0 9999 0 9999 0 0961
9-16 0 9999 0 9999 0 9999 0 9999 0 0025 0 9999 0 9999
17-20 0 9999 0 9999 0 9999 0 0000
2-31-0001-OOl-A-06-8-77-02-«»-00-11101-91-01-* 1-80 0155 0 0155 0 0155 0 0155 0 0155 0 0155 0 0155
2-31-000 1-003-A-06-8-76-I 2-*
2-31-000 1-003-A-06-8-7 7-0 1-*
0 9999 FAIL
0 9999
0 0155 FAIL
9-16 0 0155 0 0155 0 0155 0 0065 0 0155 0 0155 0 0155 0 0155
17-21 0 0155 0 0119 0 0155 0 0155 0 0155 0 0155 0 0155
0-00-12101-91-01-* 1-80 1500 0 9999 0 9999 0 9999 0 9999 0 9999 0 9999
9-16 0 9999 0 9999 0 9999 0 9999 0 9999 1 0000 0 9999
17-21 0 9999 0 9999 0 9999 |j" QQ|ql 0 9999 0 9999 0 9999
25-26 0 9999 1 0000 7
•-00-12101-91-01-* 1- 8 1 0000 0 1500 0 9999 /O 9999 0 9999 0 9999 1 0000
9-16 0 9999 0 9999 0 9999 / 0 9999 1 0012 0 9999 0 9999
17-21 0 9999 0 9999 1 0031 / 0 9999 0 9999 0 9999 0 9999
25-31 1 0000 0 9999 0 9999 / 0 9999 0 9999 0 9999 1 0000
2-31-0001-003-A-06-8-77-03-»«-00-12101-91-01-» 1-80 9999 1 0113 0 9999/ 0 9999 0 9999 0 9999 0 9999
• DECIMAL PT INDICATORS ARE
** DAY VARIES, VALID ENTRIES
9-16 0 9999 0 9999 0 9999/ JJ. 9999 0 9999 1 0076 0 9999
17-21 0 9999 0 9999 0 9999 jl 0113J 0 9999 0 9999 0 9999
25-26 0 9999 0 9150 / '' " ' N\
•' N
LISTED WITH READINGS /
ARE 1 THRU 31 / N
/ •
/ \
The 'DAYS' column indicates [Decimal points are
the days for the readings [with the readings.
printed on each line. For
example, 1.4 is the reading
for January 20, 1977.
Figure 6.4.3-h. Anomaly Screening Report for Daily Readings
0 0155
0 9999 FAIL
0 9999
0 9999
0 9999 FAIL
0 9999
0 9999
1 0071 FAIL
0 9999
0 9999
printed!
i
-o
O
£D
73
S
^>
73
^
Z
O
*-~*
"j»
jQ
0
co
ro
o
c:
•a
QL
01
0+
(0
!f
INJ
-p.
73
m
^3
o
73
CO
§
0
*
a
o>
m
• *
co
O
J.,
JO
o
*T^
co
-
CO
p-pl
0
-H
i— t
O
o*»
•
f*
CO
^
Ol
IQ
n>
ro
ro
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 23
Release Date: 4/30/79
Update #: 24
Record Position
1
2-3
4-7
8-10
11
12 - 13
14
15-16
17 - 18
19 - 20
21 - 22
23 - 27
28 - 29
30 - 31
32
33 - 79
80
Field Length
1
2
4
3
1
2
1
2
2
2
2
5
2
2
1
47
1
Description
Form Code
State Code
Area Code
Site Code
Agency Code
Project Code
Time Code
Year
Month
Day (?? if unknown)
Start Hour (?? if unknown)
Parameter Code
Method Code
Units Code
Decimal Code (? if unknown)
Unused
Action Code (should be 3 to
indicate change)
Figure 6.4.3-i. Record Format for Skeleton Transactions
from ARPANOM (AQ0320)
569
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 24
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME: AORPM45
REVISION LEVEL: 1-00
LAST UPDATE Hi 24
DATE INCURPORATtD: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO SCREEN THE AOCHS-1I MASTER
FOR ANOMALOUS DATA AND TO PRODUCE A NEW AODHS-1I MASTER FJLE
THE STATUS FLAGS SET APPROPRIATELY
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AORPM45 PROC PROJECT='CN.EPALMH,A087.CDHS.HO.AOS',
// PROG1=ACVANOM,
// PROG2=ARPANOM,
// TIMEls'2,0',
// TIME2='1,0',
// OLDMSTR=AOOLDMST,
/t
/f
PARMFRsAQPARMFL,
SKEL='ANOM.SKEL',
l)ISPl = 'OLD,KEEP,KEEP',
1 DISP2='NEW,CATLG',
I)ISP3='NEW,PASS',
// DISP4r'OLD,DELETE',
// UNIT1=DISK,
// UNIT2=DISK,
// SER1=CDHSPK,
// SER2=CDHSPK,
// PRI1=SO,
// SEC1=20,
// PRI2S10,
// SECi!=5,
// PRI3=4,
// SEC3=2,
// SPUNlTJsTRK,
// 3PUNIT2=TRK
//*
//* REFLAG MASTER FILE AND PRODUCE FORTRAN-COMPATIBLE FILE
//*
//CONVERT EXEC PGMs&PROGl,
//*
//STEPLIB DD DSNAMEs*PROJECT..LOAD,
// VULUM£s(PRIVATE,RETAIN),
// UlSPs(SHR,PA8S)
// DD DSNAMEsSYSl.COBLIB,
// DlSPaSHR
//*
//* INPUT DATA SET - OLD MASTER FILE
//*
//AOSOLDMF DD DSNAME=iPROJECT..PATA.&OLDMSTR,
// VOLUMEa(PRIVATE,RETAIN),
// PISP=UD1SP1)
//*
//* OUTPUT DATA SET - NLW MASTER ULt
//*
//AQSNF.WMF DO DSNAMEsRPROJEC!. .DAT A.f
00000100
00000200
00000300
00000400
ooooosoo
OOOOObOO
00000700
FILE OOOOOBOO
WITH 00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003ROO
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
(page 1 of 3)
Figure 6.4.3-j. Cataloged Procedure AQRPM45
570
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 25
Release Date: 4/30/79
Update #: .24
//
VOLUME=(PRIVATE,SER=ISER1),
DISPa(&DlSP2),
UNITs&UNITI,
SPACE= USPUNIT1,(&PRI1,&SEC1),RLSE)
//* INPUT DATA SET - OPTION CARD
//*
//AQSOPTIN DO DDNAME=OPTIONS,
// DCO=BLKSIZE=80
//*
//* OUTPUT DATA SET - FORTRAN-COMPATIBLE FILE
//*
//AQSANOMF OD DSNAME=&RANOM,
// DISP=(&DISP3),
// UNIT=SYSDA,
ft SPACE= (&SPUNIT1,(&PRI2,RSEC2),RLSE)
//*
//* INPUT DATA SET - PARAMETER FILE
//*
//AQSPARM Dl) OSNAME=HPROJECT. .DATA.&PARMFIL,
// VOLUMEaPRIVATE,
// DISP=(&DISP1)
//*
//» OUTPUT DATA SET - DIAGNOSTICS
//*
//AQSPRINT DD SYSUUT=A
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSUUT=A
//*
//SYSOUT DD SYSOUT=A
//*
//SYSDBOUT DD SYSOUT=A
//*
//SYSOTERM 00 SYSOUT=A
//*
//SYSUDUMP DD SYSOUT=A
//* PRODUCE ANOMALY SCREENING REPORT
//*
//REPORT EXEC PGM=&PRO<;a,
// COND=(0,NE),
// f!Mts(&TIME2)
//*
//STEPLIH OD DSN=RPROJECT..LOAD,
// VOLUMEsPRIVATE,
// OISP=(SHN,PASS)
//*
//* INPUT DATA SET - FROM PREVIOUS STEP
//*
//FT09F001 DD DSNAME=&&ANOM,
// VOLUMEsPRIVATE,
//*
//* OUTPUT DATA SET - DIAGNOSTICS
//*
//FT06F001 DD SY3()UT = A,
OOOOS900
00006000
00006100
00006300
00006300
00006400
00006SOO
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
00008000
00008100
00008200
00008300
00008400
00008300
00008600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
00010HOO
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
Figure 6.4.3-j - continued.
(page 2 of 3)
Cataloged Procedure AQRPM45
571
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 26
Release Date: 4/30/79
Update #: 24
//*
//* OUTPUT
//*
//FT07F001
//*
//* OUTPUT
//*
//FT08F001
//*
//* OUTPUT
//FT10F001
//*
//* OUTPUT
//*
//FT03F001
//*
//SYSPRINT
//*
//SYSUDUMP
//*
DCBt(RECFM=FRA,LRECI_alJ3,BLKSHE=133)
DATA SET - ANOMALY REPORT FOR HOURLY HEADINGS
DO SYSOUT=A,
DCB=(RECFM=FBA,LRECL=133,BLKSIZE=133)
DATA SET - ANOMALY REPORT FOR DAILY READINGS
OD SYSOUT=A,
DCB=(RECFM=FHA,LRECL=133,BLK3IZE=133)
DATA SET - SKELETON TRANSACTIONS
DO DSNAME=RPROJECT..DATA.&SKEL,
VOLUME=(PRIVATEfSER=&SEH2)i
DISPB(&DISP2),
UNIT=&UN1T2,
SPACEs(&SPUNIT2,(RPR 13,&SEC3),RLSE)
DATA SETS - SYSTEM OPERATION
DO SYSOUT=A
DD SYSOUTsA
DO SYSOUTsA
00011700
00011800
00011900
00012000
00012100
00012200
00012300
00012400
00012500
00012600
00012700
00012800
00012900
00013000
00013100
00013200
00013300
00013400
00013500
00013600
00013700
00013600
00013900
00014000
00014100
00014200
00014300
00014400
(page 3 of 3)
Figure 6.4.3-j - continued. Cataloged Procedure AQRPM45
572
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 27
Release Date: 4/30/79
Update #: 24
Parameter Name Default Value
PROJECT
PROG1
PROG2
TIME1
TIME2
OLDMSTR
NEWMSTR
PARMFIL
SKEL
DISP1
DISP2
DISP3
DISP4
UNIT1
UNIT2
SER1
SER2
PRI1
3330
CDHSPK
CDHSPK
50
Description
Highest-level index of data set names
Anomaly screening master file conversion
program
Anomaly screening report program
Time allocated for execution of ACVANOM
Time allocated for execution of ARPANOM
Lowest-level index of input master file
Lowest-level index of output master file
Lowest-level index of parameter file
Lowest-level index of skeleton transactions
Disposition of input master file
Disposition of output master file
Disposition of temporary file output from
ACVANOM
Disposition of temporary file input to ARPANOM
Unit type to which output master file is to be
written
Unit type to which skeleton transactions are
to be written
Volume ID to which output master file is to be
written
Volume ID to which skeleton transactions are
to be written
Primary space allocation for output master
file
(Page 1 of 2)
Figure 6.4.3-k. Substitutable Parameters for AQRPM45
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ACVANOM
ARPANOM
'2,0'
'1.0'
AQOLDMST
AQNEWMST
AQPARMFL
'ANOM.SKEL1
'OLD,KEEP,KEEP1
'NEW.CATLG1
'NEW,.PASS'
'OLD,DELETE'
3330
573
-------
AQDHS-II
REPORTS
SECTION 6.4.3
ANOMALY SCREENING REPORT
PROGRAM ARPANOM (AQ0320)
Page 28
Release Date: 4/30/79
Update #: 24
Parameter Name Default Value
SEC1
PRI2
SEC2
PRI3
SEC3
SPUNIT1
SPUNIT2
20
10
5
4
2
TRK
TRK
Description
Secondary space allocation for
output master file
Primary space allocation for temporary file
Secondary space allocation for temporary file
Primary space allocation for skeleton
transactions
Secondary space allocation for skeleton
transactions
Units in which space for output master file
and temporary file is to be allocated
Units in which space for skeleton transactions
is to be allocated
(Page 2 of 2)
Figure 6.4.3-k - continued. Substitutable Parameters for AQRPM45
574
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 1
Release Date: 4/30/79
Update #: .24
6.4.4 INVENTORY BY SITE REPORT PROGRAM - ARPINVS (AQ0280)
6.4.4.1 Description
ARPINVS (AQ0280) is a report program designed to describe the contents of
the AQDHS-II master file in primary order by site-related fields and in
secondary order by pollutant-related fields. The report generated by this
program produces a one-line summary for each group of records which have the
same site-related fields, pollutant-related fields, year, and time codes.
6.4.4.2 File Formats
Input to ARPINVS (AQ0280) consists of an AQDHS-II master file and its
associated site and parameter files. See Figure 4.5.3-a for the master file
format and Figure 4.2.2-c for the parameter file format. The input master file
must be sorted into the sequence shown in Figure 5.6.2-e prior to its use by
this program. This sorting can be accomplished by executing the master file
sort program ASRMSTR (AQ0140) using the SITE option (see Section 5.6.2, Master
File Sort Program).
Output consists of the printed report and a diagnostic messages report.
The following statistics are given for each site-pollutant-year group: (1)
the number of actual (non-null) readings among all the records in the group,
(2) the minimum and maximum readings observed 1n the group, and (3) the
average value of all non-null readings in the group. A sample of this output
is shown 1n Figure 6.4.4-a.
6.4.4.3 Options
There are no options.
575
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 2
Release Date: 4/30/79
Update #: 24
6.4.4.4 Error Messages
ARPINVS 001 ABORT - SITE FILE OVERFLOW: NUMBER OF SITE FILE RECORDS EXCEEDS
PROGRAM STORAGE SPACE
Meaning: There are more records in the site file than the table (defined
in the program) can accommodate; therefore, the run was
terminated.
Action: Increase the size of the table in the program accordingly.
Refer to Appendix C for instructions on changing the size of
the table.
ARPINVS 002 ABORT - PARAMETER FILE OVERFLOW: NUMBER OF PARAMETER FILE RECORDS
EXCEEDS PROGRAM STORAGE SPACE
Meaning: There are more records in the parameter file than the table
(defined in the program) can accommodate; therefore, the run
was terminated.
Action: Increase the size of the table in the program accordingly.
Refer to Appendix C for instructions on changing the size of
the table.
ARPINVS 003 ABORT - LEVEL 77 DATA FIELD "NBR-OF-PARMS" INCREASED BEYOND
PARM-TABLE SIZE
Meaning: The 77-1evel data item "NBR-OF-PARMS" does not coincide with
the size of the parameter table defined in the program;
therefore, the run was terminated.
Action: Refer to Appendix C for instructions on changing the 77-level
data item.
ARPINVS 004 ABORT - LEVEL 77 DATA FIELD "NBR-OF-SITES" INCREASED BEYOND
SITE-TABLE SIZE
Meaning: The 77-level data item "NBR-OF-SITES" does not coincide with
576
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 3
Release Date: 4/30/79
Update #: 24
the size of the site code table defined in the program;
therefore, the run was terminated.
Action: Refer to Appendix C for instructions on changing the 77-level
data item.
6.4.4.5 Cataloged JCL
6.4.4.5.1 JCL listing - ARPINVS (AQ0280) can be run by executing the cataloged
procedure AQRPM35. This procedure also executes the master file sort program
ASRMSTR (AQ0140). See Figure 6.4.4-b for a listing of this procedure.
6.4.4.5.2 Cross-reference of DP names and files
Program Name: ASRMSTR (AQ0140)
DD Name
File Description
Input/Output
AQSINPUT
AQSOPTIN
SORTWK01
AQSOUTPT
AQSPRINT
AQDHS-II master file
Option card
Sort work file
Sorted AQDHS-II master file
Diagnostic report
Input
Input
Input/output
Output
Output
Program Name: ARPINVS (AQ0280)
DD Name File Description
AQSMASTR Sorted AQDHS-II master file
AQSPARM AQDHS-II parameter file
AQSSITES AQDHS-II site file
AQSPRINT Inventory by site report and diagnostic
messages
Input/Output
Input
Input
Input
Output
577
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 4
Release Date: 4/30/79
Update #: 24
6.4.4.5.3 User-supplied JCL - The SITE option of the master file sort program
ASRMSTR (AQ0140) must be specified so that the master file will be sorted in
the correct order for the site inventory. See Section 5.6.2.3 for additional
information on this option card. In addition, the user must specify the data
set names of the input master, parameter, and site files. See Figure 6.4.4-c
for a description of the procedure's substitutable parameters.
6.4.4.5.4 Sample run stream - The following run stream from the baseline test
run series produces a site inventory of the AQDHS-II master file 'CN.EPALMH.
A087.CDHS.HQ.AQS.DATA.AQMASTER1:
// EXEC AQRPM35,
// MSTRFIL=AQMASTER,
//SORT.OPTION DD *
SITE
/*
6.4.4.6 Warnings and Special Instructions
To insure that a useable site inventory report is produced, the user
should be careful to input the appropriate files. If the AQDHS-II
master file is not sorted prior to running the program, the report will be
fragmented with multiple entries for each site. If the user refers to
auxiliary parameter or site files that do not contain all the parameters or
sites on the master file, the resulting site report will contain valid data
but some of the parameter or site description fields will be blank.
6.4.4.7 Cost Considerations
The following estimates are for the execution of ARPINVS (AQ0280) on an
IBM 370/168:
578
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 5
Release Date: 4/30/79
Update #: 24
Sorted AQDHS-II master file:
CPU time:
I/O time:
Total time:
291 records
0.7 second
3.3 seconds
4.0 seconds
Estimated cost:
$0.88
6.4.4.8 Related Programs and Procedures
This program must be run in conjunction with ASRMSTR (AQ0140) in order
to insure a properly summarized report. The cataloged procedure AQRPM35
executes both programs.
579
-------
AUDHS-II INVENTORY BY SITE REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ARPINVS (AQ0280)
REVISION LEVEL: 1-00
LAST UPDATE #: 24
DATE INCORPORATED: OCTOBER 31, 1978
in
CO
o
Figure 6.4.4-a. Inventory by Site Report
(page 1 of 3)
m jo
-o o
O 3C
•yo in
—t i
co «-•
-O i-i
73 z m
o •«= c~>
cs m — i
30 Z •-•
> — I O
302
TJ DO
•< co
CO HH
o m
ro ^o
oo o
o 7>
cr 30 -o
•O (D Oi
Q. —• (O
01 n> n>
C* 01
CD I/I C7>
CD
=»=
.. O
Ol
c*
ro CD
CO
CD
VO
-------
AIR QUALITY DAIA REPORT - INVENTORY HY SITE
STATE: 37 AQCRt 186 COUNTY: 3020
AREA AGENCY LOCATION POLLUTANT POL-HTH
SITE PROJ NAME NAME CODE
2260995 AOS SKIATOOK LAKE, TULSA, TULSA CO SOLAR RADIATION 6330111
3000997 AOS SKIATOOK LAKE, TULSA, TULSA CD NIIN^EIHAHL HrnPOCARBONS 4310211
LAPSE RATE 6120221
TEMPERATURE 6210120
DEW POINT 6210320
3000998 AOS SKIATOOK LAKE. TULSA, TULSf CO LAPSE RATE 6120221
3020996 AOS SKIATOOK LAKE, TULSA, TULSA CO (LAPSE RATE 6120221
cn
GO
!-•
3140992 AOS SKIATOOK LAKE, TULSA, 1ULSA CO LAPSE RATE 6120221
3140994 AOS SKIATOOK LAKE, TULSA, TULSA CU LAPSE RATE 6120221
SULAR RADIATION 6330111
PAGE
UN
CD
18
07
?8
15
1C
1 J
2R
28
28
28
18
TM
cn
1
C
1
2
1
R
7
R
"
B
8
9
B
R
9
B
R
9
B
8
9
1
YFAR
1977
1975
1974
1977
1977
1963
1963
1963
1963
1963
1"»65
1965
1963
1965
1965
1963
1965
1965
1963
1965
1965
1977
MUM
DHS
1379
1
168
1
12
2
60
2
2
a
18
5
4
18
5
4
IR
5
.4
18
5
1240
Ml (4
cms
o.oooo
0.0400
0.0000
0.9800
-1.0100
0.9555
0.9000
93.3300
*
111.1000
0.0020
0.0023
51.0000
0.0027
0.0500
-2.0000
-56.0000
-56.0000
-1.8000
-50.0000
-9.0000
0.0000
11
MAX
OHS
,
0
6
.4400
.0400
.0000
0.9800
1
922
9902
9666
9111
'III
112
57
23
51
500
500
0
-0
-0
-1
-0
-0
1
.1700
.2000
.0000
.0000
.0000
.4000
.0000
.0000
.1000
.0000
.0000
.0000
.0008
.0056
.7000
.0009
.0009
.3300
ARITH
Mf AN
0.2823
0.0400
1.6687
0.9800
0.2541
461.5777
2116.7010
4879.6650
4560.2220
112.0250
6.1731
5.0655
51.0250
41.7980
110.1200
-1.0000
-4.6922
-12.3334
-1.7750
-6.4RI5
-I.9R21
0.2762
(page 2 of 3)
Figure 6.4.4-a - continued. Inventory by Site
Report
-0
•yo
o
•yo
^>
^
^>
•yo
"O
•— i
<
CO
^^
>»
JO
o
ro
00
o
CL
E.
o>
<•+
CD
=*=
. .
ro
•yo
m
•^
o
•yo
—t
co
i— i
=|
m
^»
—4
O
yo
oo
~*
co
i— i
—{
m
•yo
m
-o
o
•yo
—\
•yo
to
to
Ol
i/i
tt>
o
Ol
CD
^
co
o
— 1
10
•f,
JO
o
:r
co
i
1—4
»— I
co
m
o
—I
i— i
o
z
o\
•
-p»
^
-o
Ol
(0
o>
^nj
-------
ARP1NVS (A002<)0) SUMMARY MESSAGES
PAGE
NUMBER OF INPUT RECORDS!
NUMBER OF ABORT MESSAGES I
331
0
PROGRAM NAME! ARPINVS (AQ0280)
REVISION LEVEL: i-oo
LAST UPDATE »: in
PATE INCORPORATED! OCTOBER 31, l<»78
CJl
CO
ro
Figure 6.4.4-a - continued. Inventory by Site Report
(page 3 of 3)
73
m
o
73
CO
-O 1—1 CO
X) z m
O < O
cr> m — i
;o z •—
*> — i o
3 o -z.
T3 DO
<; co
CO I— l
o m
ro -o
oo o
O 73
c: 73 -o
•o n> o
CL —« (Q
O) o> ro
f+ Ol
ft) en oo
n>
=»=
o
Ol
r+
ro
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 9
Release Date: 4/30/79
Update #: .24
PROCEDURE NAMEl AURPM35
REVISION LEVELJ 1-00
LAST UPDATE #! 24
DATE INCORPORATED: OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO PRODUCE A SITE
AQDHS-II MASTER FILE
//*
//*
//«
//*
//*
//*
//*
//*
//*
//*
//AQRPM35 PROC PROJECT='CN.EPALMH.AOB7.CDHS.HQ.AQS',
// PROG1=ASRMSTR,
// PR()G2 = ARPINVS,
// TIMEI='l,0'i
// TIME2='1,0',
// MS1RFIL=AQMASTER,
//
SITEFILsAllSITEFL,
SPCUNIT=TRK,
PRIMARY=SO,
SECNDRY=20,
TEMP=SYSI)A,
SORTSPC=50,
OUT=A
EXEC PGMr&PROGl,
TIME=(RT1ME1)
//*
//SORT
//*
//* SORT MASTER FILE INTO SITE INVENTORY SEQUENCE
OD DSN=RPROJECT..LOAD,
VOLUMES(PR IVATE,RETA IN),
DISP=(SHR,PASS)
DD OSNsSYSl.SORTLIB,
DISP=(SHR,PASS)
//STEPLIH
//
//SORTLIB
//*
X/SORTWK01 DD UNIT=&TEMP,
// SPACE=(RSPCUNIT,HSORTSPC,,CONTIG)
//*
//SORTWK02 DD UNIT=&TEMP,
// SPACC= (&SPCUNIT,&Sf)RTSPC,,C()NTIG)
//*
//SPRTWK03 DD UNIT=RTEMP,
// SPACE=(&SPCUNIT,RSORTSPC,,CONTIG)
//*
//* INPUT DATA SET - UNSORTED MASTER FILE
//*
//AOSINPUT DD DSN=SPROJECT..DATA.&MSTRFIL,
// DISP=((.)LD,KEF.P)
//*
//* INPUT DATA SET - OPTION CARD
//*
//AQSOPTIN DD ODNAME=(JPTION,
//*
//* OUTPUT DATA SET - SORTED MASTER FILE
//*
//AOSOUTPT DD UNIT=&TEMP,
00000100
00000200
00000300
00000400
00000500
00000600
INVENTORY (IF THE 00000700
OOOOOHOO
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
ooooinoo
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004BOO
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005/00
00005800
(page 1 of 3)
Figure 6.4.4-b. Cataloged Procedure AQRPM35
583
-------
AQDHS-II SECTION 6.4.4
REPORTS INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
// DISP=(NEW, PASS, DELETE),
// SPACE=(&SPCUNIT, ((PRIMARY, &SECNDRY),RLSE),
// DSN=5&MSTRSORT,
// DCB=(RECFM=VB,LRECL=194,HLKSIZE=1556)
//*
//* OUTPUT DATA SET • DIAGNOSTIC REPORT
//*
//AQSPRINT DD SYSOUT=&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUT=&OUT
//*
//SYSOUT DD SYSOUT=M)UT
//*
//SYSDBOUT DD SYSOUT=&OUT
//*
//SYSDTERM DD SYSOUT=&OUT
//*
//SYSUDUMP DD SYSOUT=ROUT
//*
//*
//REPORT EXEC PGM=&PROG2,
// TIME=(&T1ME2)
//*
//* SITE INVENTORY REPORT PROGRAM
//*
//STEPLIB DD DSN=fcPROJECT..LOAD,
// VOLUMEe(PRIVATt, RETAIN),
// DISP=(SHR,PASS)
//*
//* INPUT DATA SET - AUDHS-1I MASTER FILE (SORTED)
//*
//AQSMASTR DD DSNAME=RRMSTRSORT,
// DISP=(OLD,PASS)
//*
//* INPUT DATA SET - PARAMETER FILE
//*
//AQSPARM DD DSNAME = &PROJECT..DATA.&PARMHL,
// VOLUME=(PRIVATE, RETAIN),
// D1SP=(SH»,PASS)
//*
//* INPUT DATA SET - SITE FILE
//*
//AQSSITES DD DSNAME=RPRUJECT . .DATA.&S1TEFIL,
// VOLUME=(PRIVATE, RETAIN),
// DISP=(3HR,PASS)
//*
//* OUTPUT DATA SET - SITE INVENTORY REPORT
//*
//AQSPRINT DO SYSOUT = 8,OUT
//*
//* OUTPUT DATA SET - SYSTEM OPERATIONS
//*
//SYSPRINT DD SYSOUT=&OUT
//*
//SYSOUT DD SYSOUTs&OUT
//*
Page 10
Release Date: 4/30/79
Update #: 24
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
OOOOHOOO
00008100
00008200
00008300
00008400
00008500
00008600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
00010800
00010900
0001 1000
00011100
0001 1200
0001 1300
00011400
00011500
0001 1600
(page 2 of 3)
Figure 6.4.4-b - continued. Cataloged Procedure AQRPM35
584
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 11
Release Date: 4/30/79
Update #: .24
//SYSDBOUT 00 SYSOUT=iOUT
//*
//SYSUDUMP 00 SYSOUTs&UUT
//*
//SYSDTERM 00 SYSOUTe&OUT
//*
00011700
00011800
00011900
00012000
00012100
00012200
Figure 6.4.4-b - continued.
(page 3 of 3)
Cataloged Procedure AQRPM35
585
-------
AQDHS-II
REPORTS
SECTION 6.4.4
INVENTORY BY SITE REPORT
PROGRAM ARPINVS (AQ0280)
Page 12
Release Date: 4/30/79
Update #: 24
Parameter
Name
PROJECT
PRIMARY
SECNDRY
TEMP
SORTSPC
OUT
Default
Value
'CN.EPALMH.A087,
CDHS.HQ.AQS'
PROG1
PROG2
TIME1
TIME2
MSTRFIL
PARMFIL
SITEFIL
SPCUNIT
ASRMSTR
ARPINVS
'1,0'
•1.0'
AQMASTER
AQPARMFL
AQSITEFL
TRK
50
20
SYSDA
50
A
Description
Highest-level index of data set names (e.g.,
CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQMASTER
would be the full data set name of an
AQDHS-II master file)
Master file sort program
Inventory by site report program
Time allocated for execution of ASRMSTR
Time allocated for execution of ARPINVS
Lowest-level index of input master file
Lowest-level index of input parameter file
Lowest-level index of input site file
Units in which space for sorted master file
and temporary sort file is to be allocated
Primary space allocation for sorted master
file
Secondary space allocation for sorted .master
file
Device type for temporary sort file
Space allocation for temporary file
SYSOUT class for all print files
Figure 6.4.4-c. Substitutable Parameters for AQRPM35
586
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 1
Release Date: 4/30/79
Update #: 24
6.4.5 INVENTORY BY POLLUTANT REPORT PROGRAM - ARPINVP (AQ0290)
6.4.5.1 Description
ARPINVP (AQ0290) is a report program designed to describe the contents of
the AQDHS-II master file in primary order by pollutant-related fields and in
secondary order by site-related fields. The report generated by this program
produces a one-line summary for each group of records which have the same
pollutant-related fields, site-related fields, year, and time codes.
6.4.5.2 File Formats
Input to this program consists of an AQDHS-II master file and its
associated parameter and site files. The input master file must be sorted
into the sequence shown in Figure 5.6.2-d prior to its use by this program.
This sorting can be accomplished by executing the master file sort program
ASRMSTR (AQ0140) using the PARM option (see Section 5.6.2, Master File Sort
Program). This sorting is necessary because the report is arranged primarily
by pollutant-related fields, while the master file is ordered primarily by
site-related fields.
Output consists solely of the printed report. The following statistics
are given for each pollutant-site-year group: (1) the number of actual
(non-null) readings among all the records in the group, (2) the minimum and
maximum observations in the group, and (3) the average value of the readings.
A sample of this output is shown in Figure 6.4.5-a. Summary statistics for
the report include an input record count and an output line count.
6.4.5.3 Options
There are no options.
587
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 2
Release Date: 4/30/79
Update #: .24
6.4.5.4 Error Messages
ARPINVP 001 ABORT - POLLUTANT TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II parameter file exceeds
the limit of 200 imposed by the parameter code table in the
program; therefore, the run was terminated.
Action: Either decrease the size of the input parameter file or
increase the size of the parameter code table in the program
(see Appendix C: Program Modification).
ARPINVP 002 ABORT - SITE TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II site file exceeds the
limit of 200 imposed by the site code table in the program;
therefore, the run was terminated.
Action: Either decrease the size of the input site file or increase the
size of the site code table in the program (see Appendix C:
Program Modification).
ARPINVP 003 ABORT - LEVEL 77 DATA FIELD "PARM-MAX" INCREASED BEYOND PARM-
TABLE SIZE
Meaning: In an attempt to increase the size of the parameter table in
the program, the user has changed only one of the two pertinent
lines of code; therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the size of the
parameter table.
ARPINVP 004 ABORT - LEVEL 77 DATA FIELD "SITE-MAX" INCREASED BEYOND SITE-
TABLE SIZE
Meaning: In an attempt to increase the size of the site table in the
program, the user has changed only one of the two pertinent
•lines of code; therefore, the run was terminated.
588
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 3
Release Date: 4/30/79
Update #: .24
Action: See Appendix C for instructions on increasing the size of
the site table.
6.4.5.5 Cataloged JCL
6.4.5.5.1 JCL listing - ARPINVP (AQ0290) may be run by executing the
cataloged procedure AQRPM40. This procedure also executes the master file
sort program ASRMSTR (AQ0140). See Figure 6.4.5-b for a listing of this
procedure.
6.4.5.5.2 Cross-reference of DD names and files
Program Name: ASRMSTR (AQ0140)
DD Name
AQSINPUT
AQSOPTIN
AQSOUTPT
AQSPRINT
File Description
AQDHS-II master file
Option card
Sorted master file
Diagnostic report
Program Name: ARPINVP (AQ0290)
DD Name
AQSMASTR
AQSPRMFL
AQSSITFL
AQSPRTFL
File Description
Sorted master file
Parameter file
Site file
Pollutant inventory
Input/Output
Input
Input
Output
Output
Input/Output
Input
Input
Input
Output
589
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 4
Release Date: 4/30/79
Update #: 24
6.4.5.5.3 User-supplied JCL - The option card in the sort step must be
present for the file to be sorted in the correct order for the pollutant
inventory. The value to be placed in columns 6 through 9 of the option card
is 'PARM1. In addition, the user must specify the data set names of the input
master, parameter, and site files. See Figure 6.4.5-c for a description of
the procedure's substitutable parameters.
6.4.5.5.4 Sample run stream - The following run stream would produce a
pollutant inventory of the AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.
AQFINAL1:
// EXEC AQRPM40,
// MSTRFIL=AQFINAL,
// PARMFIL=HTPARMAA,
// SITEFIL=HTSITEAA
//SORT.OPTION DD *
PARM
/*
6.4.5.6 Warnings and Special Instructions
To insure that a useable pollutant inventory is produced, the user should
be careful to input the appropriate files. If the AQDHS-II master file is not
sorted prior to running the program, the report will be fragmented with
multiple entries for each pollutant. If the user refers in his JCL to an
auxiliary file that does not contain all the parameters or sites on his master
file, he will still obtain a pollutant report with valid data but will find
that some of his parameter or site description fields are blank.
590
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 5
Release Date: 4/30/79
Update #: 24
6.4.5.7 Cost Considerations
The following estimates are for the execution of ARPINVP (AQ0290) on an
IBM 370/168:
Size of AQDHS-II master file:
Size of parameter file:
Size of site file:
CPU time:
I/O time:
Total time:
291 records
99 records
24 records
1.9 seconds
3.4 seconds
5.4 seconds
Estimated cost:
$1.16
591
-------
AIR QUALITY DATA REPORT
INVENTORY BY POLLUTANT
PAGE
PROGRAM NAME! ARPINVP (AQ0290)
REVISION LEVEL! 1-00
LAST UPDATE »! 24
DATE INCORPORATED! OCTOBER 31, 197B
POL-MTH
CODE
POLLUTANT
NAME
STATE-AQCR-CNTY- AG-
AREA-SITE CODES PRJ
LOCATION
NAME
YEAR TIME UNIT
CODE CODE
MUM
ORS
MIN
OHS
MAX
OBS
ARITH
MEAN
1110191 TOTAL SUSPENDED PARTICIPATE
4240131 SULFUR DIOXIDE
3416909600001001 A06 YADMN RD., FAYtTTEVILLE, CU 1965 1
1979 1
3416909600001001 A06 YADKIN RD., FAYETTEVILLE, CU 1965 1
1979 1
Ui
VO
ro
Figure 6.4.5-a. Inventory by Pollutant Report
01 8 1.000 9021. 2130.5
01 16 1.000 9021. 1068.0
01 3 37.00 9928. 3334.0
01 3 37.00 9928. 3334.0
(page 1 of 2)
73 >
m XD
-o o
o re
•73 GO
CO H-l
«—i CO
=z m
73 Z i-i
> —I O
3 O Z
-V V3 4*
•—•-<•
•z. en
< -o
-V O
VO
o
<=. yo -o
~o n> o>
o. —'
-------
ARPINVP (AQ0290) SUMMARY MESSAGES
PAGE.
73 >
m JO
-o o
O 3C
X) co
-H I
oo •-'
INPUT RLCORO COUNT:
OUTPUT LINE CUUNTs
PROGRAM NAME: ARPINVP (A00290)
REVISION LEVEL: 1-00
LAST UPDATE «: 2«
DATE INCORPORATED: OCTOBER 31, 1'78
in
VO
"O 1-1
^3 z m
o <= o
tn m — i
30 Z •-«
> — I O
2 O Z
77
3> -< cn
O3
-o o
o
ro
vo
o
cn
CL
0(
ft)
&>
O)
(D
Figure 6.4.5-X - continued. Inventory by Pollutant Report
(page 2 of 2)
B
oo
o
-•J
vo
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 8
Release Date: 4/30/79
Update #: 24
PROCEDURE NAMES AORPM40
REVISION LEVEL: 1-00
LAST UPDATE *: 24
DATE INCORPORATED! OCTOBER 31,1978
THIS PROCEDURE ALLOWS THE USER TO PRODUCE A POLLUTANT
INVENTORY OF THE AflDHS-II MASTER FILE
EXEC PGMsfcPROGl,
TIHE = (UIME1)
//*
//*
//*
//*
//*
//*
//*
//*
//*
//*
//AORPMUO PROC PROJECT='CN.EPALMH.A087.CDHS.HO.AQS',
// PROGlsASRMSTR,
// f'ROG2sARPINVP,
// TIMEls'1,0',
// TIME2s'l,0',
// MSTRFIL=AOMASTER,
// PARMFIL=AQPARMFL,
// SITEFILeAQSITEK,
// SPCUMIT=TRK,
// PRIMARY=SO,
// SECNDRY=20,
// TEMPsSYSDA,
// SD«TSPCs50,
// OUT=A
//*
//SORT
//*
//* SORT MASTER FILE INTO POLLUTANT INVENTORY SEQUENCE
//*
//STEPLIB DD DSfl=KPROJECT,,LOAD,
// VOLUMF.= (PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//SORTLIB Dl) DSN = 3YS1 .SORTLIB,
// OISP=(SHR,PASS)
//*
//SORTWK01
//*
//SORTHK02
//*
//SORTrtKOS
//*
//* INPUT DATA SET - UMSORTED MASTER FILE
//*
//AOSINPUT DD DSN=RPR{|JF.CT..DATA.&MSTRFIL,
// DISP=(OLD,KEEH)
//*
//* INPUT DATA SET • OPTION CARD
//*
//AQSOPTIN DO DDNAME=OPTION,
// DCBsDLKSIZE«flO
//*
//« OUTPUT DATA SET - SORTED MASTER FILE
//*
//A030UTPT DO UNIT=UEMP,
DO IJNITs&TEMP,
3PACE=(&SPCUNIT,RSORTSPC,,CUNTIG)
DD UNIT=&TEMP,
3PACE= (8,3PCUNIT,&30RTSPC,,CONTIG)
DD UNITsRTEMP,
SPALEs(&SPCUNIT,RSORTSPC,,CONTIG)
00000100
00000200
00000300
00000400
00000500
00000600
(PARAMETER) 00000700
00000800
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002600
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004600
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
Figure 6.4.5-b.
(page 1 of 3)
Cataloged Procedure AQRPM40
594
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 9
Release Date: 4/30/79
Update #: 24
01SP=(NEW,PASS,DELETE),
SPACEs(iSPCUNIT,(&PRIMARY,&SFCNDRY),RLSE),
= t«,MSTRSORT,
= VB,LRECL=l9
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 10
Release Date: 4/30/79
Update #: 24
//SYSDTERM
//*
//SYSUDUMP
//*
DO SYSOUT =
DO 3YSOUT=&OUT
00011700
00011800
00011900
00012000
Figure 6.4.5-b - continued.
(page 3 of 3)
Cataloged Procedure AQRPM40
596
-------
AQDHS-II
REPORTS
SECTION 6.4.5
INVENTORY BY POLLUTANT
PROGRAM ARPINVP (AQ0290)
Page 11
Release Date: 4/30/79
Update #: .24
Parameter
Name
Default
Value
Description
PROJECT
PROG1
PROG2
MSTRFIL
PARMFIL
SITEFIL
SPCUNIT
PRIMARY
SECONDRY
TEMP
SORTSPC
'CN.EPALMH.A087,
CDHS.HQ.AQS1
ASRMSTR
ARPINVP
AQMASTER
AQPARMFL
AQSITEFL
TRK
50
20
SYSDA
50
OUT
TIME1
TIME2
A
'1,0'
'1,0'
Highest-level index of data set names
Program to sort master file
Program to produce pollutant inventory
Lowest-level index of unsorted master file
Lowest-level index of parameter file
Lowest-level index of site file
Units in which space for all new files is
to be allocated
Primary space allocation for sorted
master file
Secondary space allocation for sorted
master file
Unit type for temporary work space
Number of units to be allocated for the
sort work space
SYSOUT class for all print files
Time allocated for execution of ASRMSTR
Time allocated for execution of ARPINVP
Figure 6.4.5-c. Substitutable Parameters for AQRPM40
597
-------
AQDHS-II
REPORTS
SECTION 6.4.6
MASTER FILE SUMMARY REPORT
PROGRAM ARPMSBR (AQ0300)
Page 1
Release Date: 4/30/79
Update #: .24
6.4.6 MASTER FILE SUMMARY REPORT PROGRAM - ARPMSBR (AQ0300)
6.4.6.1 Description
ARPMSBR (AQ0300) produces a master file summary report. This summary
report compacts the data from an input master or answer file into a report
consisting of one line of information for all the records in each site-
parameter combination for one year. Each line in the listing describes the
particular data group in terms of the number, the range, and the average value
of its readings.
6.4.6.2 File Formats
Input to ARPMSBR (AQ0300) consists of an AQDHS-II master or answer file.
Refer to Figure 4.5.3-a for the master file record format.
The output produced by this program consists of the printed master file
summary report and a printed diagnostic report. See Figure 6.4.6-a for a
sample of the master file summary report and Figure 6.4.6-b for a sample of
the diagnostic report.
6.4.6.3 Options
There are no options.
6.4.6.4 Error Messages
There are no error messages.
6.4.6.5 Cataloged JCL
598
-------
AQDHS-II
REPORTS
SECTION 6.4.6
MASTER FILE SUMMARY REPORT
PROGRAM ARPMSBR (AQ0300)
Page 2
Release Date: 4/30/79
Update #: 24
6.4.6.5.1 JCL listing - ARPMSBR (AQ0300) is executed by the cataloged
procedure AQRPM30. See Figure 6.4.6-c for a listing of this procedure.
6.4.6.5.2 Cross-reference of DP names and files
Program Name: ARPMSBR (AQ0300)
DP Name File Description Input/Output
AQSMASTR AQDHS-II master or answer file Input
AQSPRINT Master file summary report and diagnostic report Output
6.4.6.5.3 User-supplied JCL - To execute the cataloged procedure AQRPM30, the
user must supply the job accounting information and the data set name of the
AQDHS-II master or answer file. See Figure 6.4.6-d for a description of the
procedure's substitutable parameters.
6.4.6.5.4 Sample run stream - The following run stream from the AQDHS-II
baseline test series would produce a master file summary report of the
AQDHS-II master file 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.AQFINAL1:
// EXEC AQRPM30,
// MSTRFIL=AQFINAL
6.4.6.6 Warnings and Special Instructions
No error conditions are checked by this program; however, for the report
to represent a summary by year for each site-parameter combination, the input
master or answer file must be in standard master file sort sequence (see
Figure 5.6.2-f). If the master or answer file is not in standard sequence, it
599
-------
AQDHS-II
REPORTS
SECTION 6.4.6
MASTER FILE SUMMARY REPORT
PROGRAM ARPMSBR (AQ0300)
Page 3
Release Date: 4/30/79
Update #: 24
should be resorted by ASRMSTR (AQ0140) using the STND option prior to the
execution of ARPMSBR (AQ0300). See Section 5.6.2 for information on ASRMSTR
(AQ0140).
6.4.6.7 Cost Considerations
The following estimates are for the execution of ARPMSBR (AQ0300) on an
IBM 370/168.
Number of master file records: 291 records
Output line count: 118 lines
Total number of readings: 2,937 readings
Total number of non-null readings: 2,546 readings
Non-null readings percentage: 87%
CPU time: 1.7 seconds
I/O time: 3.2 seconds
Total time: 4.9 seconds
Estimated cost: $1.44
6.4.6.8 Related Programs and Procedures
There are no related programs or procedures.
600
-------
SITt-KtY
1004910BOOOOIOOIE021
1206001400001003CO11
2010800450001004B038
3413617800003002C04C
3416621200001002A06A
3416621200001002A060
3416909600001001A062
34169096U0001001A063
3416909600001001A064
g341 690960000100 IA065
3416909600001001A 066
34I6909600001001A067
341702B8U00020010051
3417029HOOOOI004A06A
3417029800001004A068
3417104800001003A068
3718406000001234F058
3718630202?60995A051
371B630203000997A05C
3718630203000997A051
3718630203000997AO'5a
AIR QUALITY DATA REPORT - TOTALS BY YEAR FOR EACH
YCAR
71
73
70
60
72
73
•j i
1 3
f ••
73
72
72
74
74
74
74
74
74
76
73
76
76
77
76
77
71
77
75
74
77
63
PARM-KtY
424011107
611025014
621012215
4350291 0 1
435029101
435029101
t • 3f\31l 3D
61 eOc3 1 do
426039907
4350192U2
621032217
112018109
211017190
421011105
421029105
424013302
426028207
424011407
426039907
111019101
424019101
111019101
424019101
424019101
111019101
633011118
431021 107
431021107
612022128
621012015
NOR OF
RDGS
712
24
37
1
7
29
10
4
2
48
96
72
48
36
24
168
12
79
29
44
112
81
326
1392
1
168
12
60
Figure 6
NBR OF
NON-NULL
712
24
3
1
7
29
1
4
1
48
96
72
48
36
24
155
12
14
5
28
19
16
93
1379
1
168
12
60
.4.6-a.
MIN
RDGS
0.0000
2.0000
-1.2000
2. 3000
0.7000
0.2000
• i *» n ft
— 1 . 3UUU
0,0094
10.1000
-1 .0000
0.1000
0.0100
0.0010
0.0001
0.1000
0.0100
•0.0000
0.0021
6.0000
0.0000
0.0000
0.0000
0.0000
7.0000
0.0000
0 . 0400
0.0000
-1.0100
0.9000
Master File
MAX
2.4800
6.0000
-0.5000
2T/I t\ A
• 3000
a. 6000
a. 9000
• t n on
1 , JU V V
0 , 0094
13.2000
-1 .0000
4.5000
0.4500
0.0450
0.0042
4.2000
0.4100
5840.0000
0.0999
124.0000
28.0000
964.0000
1500,0000
9450.0000
177.0000
1.4400
0. 0400
6.0000
1.1700
9902.0000
SITE-PARAMETER GROUP
2ND
MAX
2.4800
5.0000
-1.1000
4.4000
4.9000
12.8000
**********
4.2000
0.4200
0.0420
0.0041
4.1000
0.4100
1.2000
0,0999
81.0000
0.0000
455.0000
21.6000
1500.0000
168.0000
1.4300
5.0000
0.9000
9901 .0000
Summary Report ^page
3RD
MAX
2.0100
5.0000
-1.2000
3.9000
4.9000
11.9000
4.2000
0.4200
0.0410
0.0041
4.1000
0.3700
0.8550
0.0026
71.0000
0.0000
455.0000
3.8000
361.3000
113.0000
1.4200
5.0000
0.7900
9900.0000
1 of 2)
PAGE 1
MEAN
0.15087
3.33333
-0.9J333
2YA Ann
* JU VVV
2.84286
3.02414
*»1 XflflAfl
1 « J VU VU
Oonouo
9 VV~** V
12.00000
-1 . 00000
1.64583
0.16875
0.01606
0.00150
1.50000
0.14083
37.73848
0.01865
53.14286
5.60000
400.64286
80.73158
711.01250
54.79570
0,28236
0 04000
1.66825
0.2S417
2116.70106
-o
73
0
CD
73
73
-o
3
co
CO
73
JO
o
co
O
O
.a
"g^
S-
=*=
ro
73
m
-o
o
73
CO
3
co
—1
m
73
-n
r~
m
CO
j[ITT
3E
-<
73
m
-o
o
73
—\
73
O>
V>
m
o
O*
^
co
o
2
•j..
JO
0
n:
oo
HH
•"*
co
m
o
—I
t—t
o
z
-p>
•
o>
-o
(U
-------
ARPMSBR (AQ0300) SUMMARY MtSSAGtS
PAGE
73 J>
m o
-o o
o :c
TO CO
—I I
CO 1-H
INPUT RECORD COUNT 331
OUTPUT LINE COUNT! 64
TOTAL NUMBER OF READINGS: 5,017
TOTAL NUMBER OF NON-NULL READINGS! 4,434
NON-NULL READINGS PERCENTAGE: BBX
PROGRAM NAME: ARPMSBK UOOJOO)
REVISION LEVEL: 1-00
LAST UPDATE »t 24
DATE INCORPORATED: OCTOBER Jlr 1970
70
O
2 CO
^ m
CO O
30 m KH
f> 70 O
O
INJ
•-• CT>
CO CO CT>
oo cz
O
CO
o
o
m
CI 73
TJ n>
fi __i 'O
01 m a>
Q»
rt>
=»=
ro
to
cu
cn
Figure 6.4.6-a - continued. Master File Summary Report
(page 2 of 2)
CO
o
VO
-------
AQDHS-1I MASTER FILE SUMMARY REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME! ARPMSBR (AQ0300)
REVISION LEVEL! 1-00
LAST UPDATE »l 29
DATE INCORPORATED! OCTOBER Jlr
O
co
Figure 6.4.6-b. Diagnostic Report
70 >
m o
•o o
O DC
•yo to
to i—i
O
tn
3 co
5 m
to o
m i— i
„ o
HI Ot
to
co c:
XD -<
o
to 73
o m
o -o
^ o
•Q n> B)
o. — ' 10
o> n n>
n>
=«=
ro
cr>
Oi
to
O
VO
-------
AQDHS-II SECTION 6.4.6
REPORTS MASTER FILE SUMMARY REPORT
PROGRAM ARPMSBR (AQ0300)
//*
//* PROCEDURE NAME: AQRPM30
//* REVISION LEVEL: i-oo
//* LAST UPDATE *l 24
//* DATE INCORPORATED: OCTOBER 31,1978
//*
Page 7
Release Date: 4/30/79
Update #: .24
00000100
00000200
00000300
00000400
00000500
00000600
//* THIS PROCEDURE ALLOWS THE USER TO GENERATE A SUMMARY REPORT FRUM 00000700
//« THE A8DHS-II MASTER FILE
//*
//*
//AQRPM30 PROC PROJECT='CN.EPALMH,A087.CDHS.HQ.AOS',
// PROGRAM=ARPMS8R,
// MSTRriL=AOMA3TER,
// TIMEls'1,0',
// OUTsA
//*
//REPORT EXEC PGMsfU'ROGRAM,
// REGIONslSOK,
// TIME=(RTIME1)
//*
//* PRODUCE A SUMMARY REPORT FROM THE MASTER FILE
//*
//STEPLIB DD DSNAM,Ea&PROJECT..LOAD,
// VOLUMEs(pR!VATE, RETAIN),
// DISPs(SHR,PASS)
// DD DSNAMF.oSYSl.COULIBf
// Dl3Ps(3HR,PASS)
//*
//* INPUT DATA SET - MASTER FILE
//*
//AQSMASTR DD DSNAMf.sRpROJECT . .DATA.ftMSTRFlL,
// VOLUME=(PRIVATE, RETAIN),
// DI3P=(SHR,PA3S)
//*
//* OUTPUT DATA SET - BRIEF REPORT LISTING
//*
//AOSPRINT DD SYSOUTs&OUT
//*
//* OUTPUT DATA SE1S - SYSTEM OPERATION
//*
//SYSPR1NT DD 8YSOUT = 8-OUT
//*
//SYSOUT DD SYSOUTs&OUT
//*
//SYSDBOUT OD SYSOUTs&OUT
//*
//SYSDTERM DD SYSOUTsftOUT
//*
//SYSUDUMP DO SYSOUTs&UUT
//*
OOOOOAOO
00000900
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001BOO
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003ROO
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
Figure 6.4.6-c. Cataloged Procedure AQRPM30
604
-------
AQDHS-II
REPORTS
SECTION 6.4.6
MASTER FILE SUMMARY REPORT
PROGRAM ARPMSBR (AQ0300)
Page 8
Release Date: 4/30/79
Update #: .24
Parameter
Name
PROJECT
PROGRAM
MSTRFIL
TIME1
OUT
Default
Value
'CN.EPALMH.A087,
CDHS.HQ.AQS1
ARPMSBR
AQMASTER
'1,0'
A
Highest-level Index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
AQMASTER would be the full data set name of
the AQDHS-II master file)
Master or answer file summary report program
Lowest-level Index of Input master or answer
file
Time (minutes, seconds) allocated for
execution of ARPMSBR
SYSOUT class for all print files
Figure 6.4.6-d. Substltutable Parameters for AQRPM30
605
-------
AQDHS-II
REPORTS
SECTION 6.4.7
PARAMETER EXCEPTION REPORT
PROGRAM ARPPMEX (AQ0330)
Page 1
Release Date: 4/30/79
Update #: 24
6.4.7 PARAMETER EXCEPTION REPORT PROGRAM - ARPPMEX (AQ0330)
6.4.7.1 Description
ARPPMEX (AQ0330) produces an exception report of the parameter, method,
and unit code combinations which are found in the master file but not in the
parameter file. For those combinations not found in the parameter file,
ARPPMEX (AQ0330) creates skeleton transactions which may be used to facilitate
the addition of these exceptions to the parameter file.
It is necessary for certain fields to be filled in by the user before
these transactions can be used as input to ASRPARM (AQ0150) and AEMPARM
(AQ0070). Refer to the following sections for information on the skeleton
transaction requirements.
6.4.7.2 File Formats
Input to ARPPMEX (AQ0330) consists of an AQDHS-II master file and its
associated parameter file. See Figure 4.5.3-a for the master file format and
Figure 4.2.2-c for the parameter file format.
ARPPMEX (AQ0330) produces three output files: a parameter exception
report, a skeleton transaction file, and a diagnostic report. A sample of the
<\ parameter exception report is shown in Figure 6.4.7-a. It lists the
parameter, method, and unit code combinations that were missing from the
parameter file or simply indicates that none were missing.
A set of three skeleton transactions for each parameter exception found
in the master file is created to aid the user in updating the parameter file.
A complete set of transactions is needed to add one parameter, method, and
unit code combination to the parameter file. The format of the skeleton
transactions is shown in Figure 6.4.7-b. These transactions do not contain
606
-------
AQDHS-II
REPORTS
SECTION 6.4.7
PARAMETER EXCEPTION REPORT
PROGRAM ARPPMEX (AQ0330)
Page 2
Release Date: 4/30/79
Update #: 24
all the necessary information required for valid parameter file transactions.
If the skeleton transactions are to be added to the parameter file, the user
should supply the correct information for all of the blank fields in the
skeleton transactions. However, only the following four fields are required
to be filled in by the user: (1) the minimum detectable, (2) the decimal
code, (3) the standard units code, and (4) the standard units conversion
factor. Refer to Section 4.2.2 for specific information about valid parameter
file transactions and how they are used with program, AEMPARM (AQ0070). A
sample of the diagnostic report is shown in Figure 6.4.7-c.
6.4.7.3 Options
There are no options.
6.4.7.4 Error Messages
ARPPMEX 001 ABORT - LEVEL 77 DATA FIELD "NBR-OF-PARMS" INCREASED BEYOND
PARAMETER-TABLE SIZE
Meaning: The level 77 data field 'NBR-OF-PARMS1 has been increased
without increasing the size of the parameter table.
Action: See Appendix C for instructions on correctly increasing the
size of the parameter table.
ARPPMEX 002 ABORT - PARMAMETER-TABLE AREA OVERFLOW
Meaning: Either the number of parameter file records exceeds the
program's storage space as defined in the parameter table, or
the size of the parameter table has been increased without
increasing the value of the level 77 data field 'NBR-OF-PARMS1.
Action: See Appendix C for instructions on correctly making the
necessary changes.
607
-------
AQDHS-II
REPORTS
SECTION 6.4.7
PARAMETER EXCEPTION REPORT
PROGRAM ARPPMEX (AQ0330)
Page 3
Release Date: 4/30/79
Update #: 24
ARPPMEX 003 ABORT - EXCEPTION-PARAMETER-TABLE AREA OVERFLOW
Meaning: Either the number of new parameter, method, and unit code
combinations exceeds the program's storage space as defined in
the exception parameter table, or the size of the exception
parameter table has been increased without increasing the
value of the level 77 data field 'NBR-OF-EXCP'.
Action: See Appendix C for instructions on correctly making the
necessary changes.
ARPPMEX 004 ABORT - LEVEL 77 DATA FIELD "NBR-OF-EXCP" INCREASED BEYOND
EXCEPTION-PARAMETER-TABLE SIZE
Meaning: The level 77 data field 'NBR-OF-EXCP' has been increased
without increasing the size of the exception parameter table.
Action: See Appendix C for instructions on correctly increasing the
size of the exception parameter table.
6.4.7.5 Cataloged JCL
6.4.7.5.1 JCL listing - ARPPMEX (AQ0330) is executed by the cataloged
procedure AQRPP20. See Figure 6.4.7-d for a listing of this procedure.
6.4.7.5.2 Cross-reference of DD names and files
Program Name: ARPPMEX (AQ0330)
DD Name
File Description
Input/Output
AQSMASTR
AQSPARMS
AQSREPRT
AQSTRANS
AQSPRINT
AQDHS-II master file
AQDHS-II parameter file
Parameter exception report
Skeleton transaction file
Diagnostic report
Input
Input
Output
Output
Output
608
-------
AQDHS-II
REPORTS
SECTION 6.4.7
PARAMETER EXCEPTION REPORT
PROGRAM ARPPMEX (AQ0330)
Page 4
Release Date: 4/30/79
Update #: 24
6.4.7.5.3 User-supplied JCL - To execute procedure AQRPP20, the user must
supply the job accounting information and the data set names of the AQDHS-II
master file, the AQDHS-II parameter file, and the skeleton transaction file
produced by ARPPMEX (AQ0330). See Figure 6.4.7-e for a description of the
procedure's substitutable parameters.
6.4.7.5.4 Sample run stream - The following run stream would produce a
skeleton transaction file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.PARMSKTR'.
The input master file is named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.FLAMSTR' and
the input parameter file is named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.PARM11'.
// EXEC AQRPP20,
// MSTRFIL=FLAMSTR,
// PARMFIL=PARM11,
// SKELTRN=PARMSKTR
6.4.7.6 Warnings and Special Instructions
ARPPMEX (AQ0330) produces a skeleton transaction file of those parameter,
method, and units code combinations which are found in the master file but are
not currently in the parameter file. If the user wants to use these
transactions to update the parameter file, certain fields must have the
appropriate information filled in. Generally, it would be best if the user
supplied the correct information for all of the blank fields in the skeleton
transactions. However, there are only four fields which must be filled in by
the user: (1) the minimum detectable, (2) the decimal code, (3) the standard
units code, and (4) the standard units conversion factor.
It may not always be necessary to add the missing parameter, method, and
unit code combinations to the parameter file. For example, the monitoring of
a specific parameter may have been previously terminated, causing the user to
delete that parameter from the parameter file. However, the data on the
609
-------
AQDHS-II
REPORTS
SECTION 6.4.7
PARAMETER EXCEPTION REPORT
PROGRAM ARPPMEX (AQ0330)
Page 5
Release Date: 4/30/79
Update #: .24
master file for that parameter could be retained on the master file and
eventually archived. These parameters will be shown as exceptions where
ARPPMEX (AQ0330) is run; however, there is no need to add them to the
parameter file, unless the user wishes to produce reports using the
description field portion of the parameter file.
The run will abort if the number of parameter file records or the number
of parameter exceptions exceed the program's storage space. Refer to Appendix
C for a detailed discussion of the program modifications required to increase
this space.
6.4.7.7 Cost Considerations
The following estimates are for the execution of ARPPMEX (AQ0330) on an
IBM 370/168:
Number of master file records:
Number of parameter file records:
Number of parameter exceptions:
Number of skeleton transactions:
CPU time:
I/O time:
Total time:
8,479 records
100 records
5 exceptions
15 transactions
5.2 seconds
23.4 seconds
28.6 seconds
Estimated cost:
$4.74
6.4.7.8 Related Programs and Procedures
Each transaction in the skeleton transaction file can be filled in and
the completed file used as input to ASRPARM (AQ0150), the parameter file
transaction sort program, and AEMPARM (AQ0070), the parameter file maintenance
program. See Sections 4.2.1 and 4.2.2.
610
-------
PARAMETER CODE.
61202
METHOD CODE
21
AQOH3-II PARAMETER EXCEPTION REPORT
LIST OF PARAMETERS MISSING FROM AQDHS-II PARAMETER FILE
UNIT CODE
28
PAGt
Figure 6.4.7-a. Parameter Exception Report
•T3 O
CD 3C
•yo co
—I i
CO i—i
•o -o co
30 3» m
O 73 O
CD 3=» -H
•yo 2 i—i
5> m o
30
-o m
-o x
2 o
m m
x -o
o
co -yo
co m
O -X3
«—' o
•yo
en
c. -ya 13
-o ft) ID
Q. —• oa
o> n> ro
r* 0»
ro w> o>
n>
=«=
.. o
O)
rt
ro (D
CO
o
-------
AQDHS-II
REPORTS
SECTION 6.4.7
PARAMETER EXCEPTION REPORT
PROGRAM ARPPMEX (Aq0330)
Page 7 :
Release Date: 4/30/79
Update #: .24
Column #
Field Length
Description
1
2-6
7 - 8
9-10
11 - 79
80
1
5
2
2
69
1
Card Type (value is 1, 2, or 3)
Parameter Code
Method Code
Unit Code
Filler
Action Code (value is A)
Figure 6.4.7-b. Skeleton Transactions Format
612
-------
AQDHS-II PARAMETER EXCEPTION REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE 1
PROGRAM NAME; ARPPMEX (AQ0330)
REVISION LEVEL: i-oo
LAST UPDATE #: ZH
INCURPURAUD: OCTOBER 31. 1<>78
m £2
-o o
o ;c
•ya to
-H i
to »-«
NUMBER OF MASTER RECORDS READ: 331
NUMBER OF PARM FILE RECORDS READl 89
NUMBER OF PARAMETER EXCEPTIONS: I
NUMBER OF PARM FILE TRANSACTIONS CREATED: 3
o
cr>
•
-O to
j» m
"TO o
f> —i
-s. •—
m o
01
»—•
to
~o
•o
m .»*
x*
o -J
JO
o
CO
to
o
<=. -yo -o
-a n> 01
O- —• to
Ol fl> fl>
n>
(V
o
Ol
n>
oo
Figure 6.4.7-c. Diagnostic Report
to
o
—i
to
-------
AQDHS-II
REPORTS
SECTION 6.4.7
PARAMETER EXCEPTION REPORT
PROGRAM ARPPMEX (AQ0330)
Page 9
Release Date: 4/30/79
Update #: 24
PROCEDURE NAME: AQRPP20
REVISION LEVEL: 1-00
LAST UPDATE *: 2
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 1
Release Date: 4/30/79
Update #: 24
6.4.8 SITE EXCEPTION REPORT PROGRAM - ARPSMEX (AQ0340)
6.4.8.1 Description
ARPSMEX (AQ0340) produces an exception report of those sites (i.e.,
state, area, site, agency, and project codes) which are in the master file but
are not in the site file. A file containing skeleton transactions is created
to facilitate updating the site file to include these site exceptions.
6.4.8.2 File Formats
Input to ARPSMEX (AQ0340) consists of an AQDHS-II master file, an
AQDHS-II site file, and an option card.
Output consists of the printed site exception report, the skeleton
transaction file, and a printed diagnostic report. See Figure 6.4.8-a for a
sample exception report.
The format of the skeleton transactions is illustrated in Figure 6.4.8-b.
Only the key fields (state, area, site, agency, and project codes) of the
missing sites are included in the skeleton transactions. The remaining fields
(AQCR, COUNTY, SLAMS-ID, and description) must be coded by the user before the
skeleton transactions can be used to update the site file. For additional
information on site file transactions, see Section 4.3.2.
The following statistics are included in the diagnostic report: (1) the
number of master file records read, (2) the number of site file records read,
(3) the number of skeleton transactions created, and (4) the number of missing
sites printed in the site exception report. See Figure 6.4.8-c for a sample
diagnostic report.
617
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 2
Release Date: 4/30/79
Update #: 24
6.4.8.3 Options
The maximum number of lines per printed page can be specified by the user
in card columns one and two of the option card. (Those users who use standard
11 X 14 inch output forms and have the ability to print eight lines per inch
will find this option useful in reducing the amount of paper they use.) If no
option card is entered, or an invalid line count is specified, a default of 62
lines per page is assumed. See Figure 6.4.8-d for the format of the option
card.
6.4.8.4 Error Messages
ARPSMEX 001 CONDITIONAL - INVALID OPTION CARD - DEFAULT OPTION (62 LINES PER
PAGE) ASSUMED/so
Meaning: Either a non-numeric character or an integer less than 20 was
specified in columns one through two of the option card.
The default of 62 lines per page was assumed.
Action: None.
ARPSMEX 002 ABORT - EMPTY SITE FILE
Meaning: The input site file contains no records; therefore, the run was
terminated.
Action: Specify a valid site file and resubmit the run.
ARPSMEX 003 ABORT - SITE FILE OVERFLOW
Meaning: The site file contains more records than the maximum allowed
by the program; therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the size allowed
for the site file.
618
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 3
Release Date: 4/30/79
Update #: 24
ARPSMEX 004 ABORT - EMPTY MASTER FILE
Meaning: The input master file contains no records; therefore, the run
was terminated.
Action: Specify a valid master file and resubmit the run.
ARPSMEX 005 ABORT - 'MISSING-SITE1 TABLE OVERFLOW
Meaning: The number of missing sites exceeds the maximum allowed by the
program; therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the size allowed
for the site file.
ARPSMEX 006 ABORT - LEVEL 77 DATA FIELD 'NBR-OF-SITES' INCREASED BEYOND
SITE-TABLE SIZE
Meaning: The limit for the number of records in the site file has been
increased, but the working-storage allocation for the site
table has not been increased correspondingly. Therefore, the
run was terminated.
Action: See Appendix C for instructions on increasing the size of the
site table.
ARPSMEX 007 ABORT - LEVEL 77 DATA FIELD 'MISSING-SITE-MAX1 INCREASED BEYOND
MISSING-SITE-TABLE SIZE
Meaning: The limit for the number of missing sites has been increased,
but the working-storage allocation for the missing-site table
has not been increased correspondingly. Therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the size of the
missing-site table.
6.4.8.5 Cataloged JCL
619
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 4
Release Date: 4/30/79
Update #: 24
6.4.8.5.1 JCL listing - ARPSMEX (AQ0340) can be run by executing the
cataloged procedure AQRPS20. See Figure 6.4.8-e for a listing of this
procedure.
6.4.8.5.2 Cross-reference of DP names and files
Program Name: ARPSMEX (AQ0340)
DP Name
AQSMASTR
AQSSITES
AQSOPTIN
AQSPRINT
AQSDIAG
AQSTRANS
File Description
AQDHS-II master file
AQDHS-II site file
Option card file
Exception report
Diagnostic report
Skeleton transaction file
Input/Output
Input
Input
Input
Output
Output
Output
6.4.8.5.3 User-supplied JCL -To execute the cataloged procedure AQRPS20, the
user must supply job accounting information; the data set names of the
AQDHS-II master file, AQDHS-II site file, and skeleton transaction file; and
an option card. See Figure 6.4.8-f for a description of the procedure's
substitutable parameters.
6.4.8.5.4 Sample run stream - The following run stream would produce a
skeleton transaction file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.SITESKTR1
from the master file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.INMSTR1 and the
site file named 'CN.EPALMH.A087.CDHS.HQ.AQS.DATA.INSITE1. The site exception
report generated by this run will have a maximum of 62 lines per page.
// EXEC
AQRPS20,
MSTRFIL=INMSTR,
SITEFIL=INSITE,
620
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 5
Release Date: 4/30/79
Update #: 24
// SKELTRN=SITESKTR
//EXCPRP.OPTIONS DD *
62
/*
6.4.8.6 Warnings and Special Instructions
ARPSMEX (AQ0340), as released by NADB, can only accommodate a site file
containing 200 or fewer records and can handle at most 200 site exceptions.
If you require larger capacities, see Appendix C for the modifications which
must be made to your source module for ARPSMEX (AQ0340).
If an option card is submitted, it must specify no fewer than 20 lines to
be printed per page.
The site file is assumed to be in the correct sort sequence as generated
by the site file maintenance program AEMSITE (AQ0080).
6.4.8.7 Cost Considerations
The following estimates are for executing ARPSMEX (AQ0340) on an IBM
370/168:
Size of AQDHS-II master file:
Size of AQDHS-II site file:
Size of exception report:
Size of skeleton transaction file:
CPU time:
I/O time:
Total time:
291 records
21 records
2 records
2 records
.3 second
8.5 seconds
8.8 seconds
Estimated cost:
$1.36
621
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 6
Release Date: 4/30/79
Update #: 24
6.4.8.8 Related Programs and Procedures
Each skeleton transaction created by ARPSMEX (AQ0340) can be completed
and the file used to update the AQDHS-II site file. See Section 4.3.2 for
information on the site file maintenance program AEMSITE (AQ0080).
622
-------
AODHS-H SITE EXCEPTION REPORT
LIST OF SITES MISSING FROM AOOHS-II SITE FRt
PAGE
STATE CODE
10
AREA CODE
0001
SITE CODE
001
AGENCY
E
PROJECT
01
ro
co
Figure 6.4.8-a. Site Exception Report
m
-o
o
73
CO
co •-«
"o co oo
73 >— i m
O — I O
en rn — (
70 i— i
Ja m O
S x z
o
3> m en
co i— i •
3 O oo
> -o
JO O
O 33
co —i
T3
O.
Oi
=«»:
n>
— '
n
CU
n>
m
o
O)
rl-
ro n>
-P> ••
co
o
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 8
Release Date: 4/30/79
Update #: .24
Record Position Field Length
1 -
3 -
7 -
11 -
13 -
16 -
21 -
2
6
9
10
12
15
19
20
80
2
4
3
1
2
3
4
1
60
Description
State Code
Area Code
Site Code
Agency Code
Project Code
AQCR Code
County Code
SLAMS/NAMS ID
Description
Site Key
Information to be
filled in by user
Figure 6.4.8-b. Site File Skeleton Transaction Format
624
-------
AQOHS-I1 SITt EXCEPTION REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ARPSHEX (AQ0340)
REVISION LEVEL: i-oo
LAST UPOftlt «: 24
DATE INCORPORATED: OCTUBER 31, 1976
OPTION IN EFFECT: 62 LINES PER PAGE
NUMBER OF MASTER FILE RECORDS:
NUMBER OF SITE FILE RECORDS!
NUMBER OF MISSING SITES PRINTED IN REPORT:
NUMBER OF SKELETON TRANSACTIONS GENERATED:
331
36
1
1
CTl
ro
en
Figure 6.4.8-c. Diagnostic Report
•ys as.
m JO
-o o
O DC
•ya GO
—\ i
GO i—i
~O GO CO
•yo t-t rn
O —I o
O m —|
•yo i—i
3> m o
3 x z
o
~3> m eri
30 T3 •
-0—1-1^
(/> HH •
2 O 00
•73
^-* m
J» -o
JO O
O X3
X3 fD OJ
f> —t 10
O) fD fD
rt B>
=«=
.. o
Oi
r+
ro ft)
CO
o
VO
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 10
Release Date: 4/30/79
Update #: 24
Column
V
XX
XX specifies the maximum number of lines per printed page;
it must be numeric and greater than or equal to 20
Figure 6.4.8-d. Option Card Format
626
-------
AQDHS-II SECTION 6.4.8
REPORTS SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
//*
//* PROCtOURE NAMLt AORPS20
//* REVISION LEVEL! 1-00
//* LAST UPDATE #1 24
//* DATE INCORPORATED: OCTOBER 31,1978
//*
//*
Page 11
Release Date: 4/30/79
Update #: 24
00000100
00000200
00000300
00000400
00000500
OOOOObOO
00000700
//* THIS PROCEDURE ALLOMS THE USER TO LIST THE SITES IN THE AODHS-1I OOOOOflOO
//* MASTER FILE THAT DO NOT APPEAR ON THE AODHS-II SITE FILE 00000900
//*
//*
//AQRPS20 PROC PROJECT='CN.tPALMH.A087.CDHS,HQ.AQS',
// PROGRAM=ARPSMEX,
// REGION1=100K,
// MSTRHL = AOMASTER,
// SITEFIL = AOSITF.FL,
// SKELTRN=SITESKTR,
// OUT=A,
// UNIT=3330,
// SERIAL=CDHSPK,
// D1SP='NEW,CATLG, DELETE',
// SPCUNIT=TRK,
// PRIMARYalO,
// StCNDRY=10,
// TIME1='1»0'
//EXCPRP EXEC PGMs&PROGRAM,
// TIME=(&TIM£1),
// REGIONs®IONl
//*
//* PRODUCE SITE EXCEPTIONS REPORT
//*
//STEPLIB DD DSN = &PR(1JECT..LOAD,
// DISP=(SHR,PASS)>
// VOLUME=(PRIVATE, RETAIN)
//*
//* INPUT DATA SET - MASTER FILE
//*
//AOSMASTR DD DSN=&PROJECT . .DATA.&HSTHFILi
// DISP=(SHR,PA33),
// VOLUME=(PR1VATE, RETAIN)
//*
//* INPUT DATA SET • SITE FILE
//*
//AOSSITtS DD DSN=RPROJECT..DATA.RSITEFIL,
// DISP=(SHR,PASS),
// VHLUME=(PRIVATE, RETAIN)
//*
//* INPUT DATA SET - OPTIONS CARD
//*
//AOSOPTIN DD DDNAMfcsOPTIDNS,
// DCB=HLKSIZE=80
//*
//* OUTPUT DATA SET - DIAGNOSITC MESSAGES
//*
//AQSDIAG DD SYSHUT=&UUT
//*
//* OUTPUT DATA SLT - LISTING OK MISSING SITKS
//*
00001000
00001100
00001200
00001300
00001400
00001500
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002500
00002600
00002700
00002HOO
00002900
00003000
00004100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
nooosooo
00005100
0000b200
00005300
00005400
00005500
00005600
00005700
00005800
Figure 6.4.8-e.
(page 1 of 2)
Cataloged Procedure AQRPS20
627
-------
AQDHS-II
REPORTS
SECTION 6.4.8
SITE EXCEPTION REPORT
PROGRAM ARPSMEX (AQ0340)
Page 12
Release Date: 4/30/79
Update #: .24
//AQSPRINI 00 SYSC)UT
//*
//* OUTPUT DATA SET - SITE TRANSACTIONS GENERATED
//* FOR MISSING SITES
//*
//AQSTRANS DO UNITsRUNlT,
// VOL=(PRIVATE,RETAIN,SER=RSERIAL)r
// DISP = UDISP),
// SPACE=USPCUNIT,(&PRIMARY,&3ECNDRY)fRLSE),
// OSN=&PKOJECT..OATA.RSKELTRN
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//3YSPRINT DO SYSOUT=&OUT
//*
//SYSOUT DD SYSOUT=&OUT
//*
//SYSDBOUT DD SYSOUT=&OUT
//*
//SYSDTERM DD SYSOUT=&OUr
//*
X/SYSUDUMP DD SYSOUT=&OUT
//*
00005900
00006000
OOOOblOO
00006200
00006300
00006400
00006500
00006600
00006700
00006BOO
00006900
00007000
00007100
00007^00
00007300
00007100
00007500
00007600
00007700
00007800
00007900
00008000
00008100
Figure 6.4.8-e - continued.
(page 2 of 2)
Cataloged Procedure AQRPS20
628
-------
AQDHS-II
FILE CREATION AND
MAINTENANCE
Section 6.4.9
VIOLATION OF STANDARDS
PROGRAM ARPVSTD (AQ0350)
Page 28
Release Date: 5/01/80
Update #: 27
Parameter
Name
PROJECT
PROGRAM
MSTRFIL
PARMFIL
STANFIL
SITESRT
SORUNIT
SORTSPC
TEMP
REGION1
TIME1
OUT
Default
Value
'CN.EPALMH.A087.
CDHS.HQ.AQS1
ARPVSTD
AQMASTER
AQPARMFL
AQSTANFL
AQSTESRT
CYL
10
SYSDA
200K
'1,0'
Description
Highest-level index of data set names
(e.g., CN.EPALMH.A087.CDHS.HQ.AQS.DATA.
AQMASTER would be the full data set name
of an AQDHS-II master file)
Violations of standards report program
Lowest-level index of master file
Lowest-level index of parameter file
Lowest-level index of parameter standards
file
Lowest-level index of sorted site file
Units in which space for the sort work
file is to be allocated
Number of units to be allocated for the
sort work space
Unit type for temporary work space
Region allocated for execution of ARPVSTD
Time in minutes and seconds allocated for
execution of ARPVSTD
SYSOUT class for all print files
Figure 6.4.9-g. Substitutable Parameters for AQRPM50
629.28
-------
AQDHS-II
REPORTS
SECTION 6.5.1
SLAMS REPORT
INTRODUCTION
Page: 1
Release Date: 10/31/81
Update #: 29
6.5 STATE AND LOCAL AIR MONITORING SITES (SLAMS) REPORT
6.5.1 INTRODUCTION
Federal law requires the annual submission of statistical data for state
and local air monitoring (SLAMS) sites. AQDHS-II provides the user with the.
capability of producing a report to meet this requirement.
The AQDHS-II SLAMS report contains EPA-mandated statistical data for six
criteria pollutants: total suspended particulate (TSP), lead (Pb), carbon
monoxide (CO), sulfur dioxide ($03), nitrogen dioxide (N02), and ozone (03).
The statistics include number of observations, arithmetic and geometric means,
maximum readings, 3-hour and 24-hour averages, number of exceedances of
standards, and frequency distributions, with only those "statistics that are
mandated for any given pollutant being calculated for that pollutant. The
data for each pollutant is reported by site and monitoring information, with
the report itself ordered by pollutant code.
The report consists of six sections (one for each pollutant) with three
formats per section. The first format is a list of all method code
descriptions in the parameter file for the pollutant; the second format
contains the statistics for the pollutant; and the third format contains the
frequency distributions.
A tape report can also be produced, consisting of a transaction file
containing 2 types of transactions per pollutant. The type 1 transactions
contain the statistics; the type 2 transactions contain the frequency
distributions.
Three programs make up the SLAMS report package: the SLAMS retrieval
program, ARTSLAM (AQ0375); the SLAMS statistical analysis program, ASTSLAM
629.29
-------
AQDHS-II
REPORTS
SECTION 6.5.1
SLAMS REPORT
INTRODUCTION
'age: 2
telease Date: 10/31/81
Update #: 29
(AQ0380); and the SLAMS report program; ARPSLAM (AQ0390). A system flowchart
of the SLAMS report package is shown in Figure 6.5.1-a.
ARTSLAM (AQ0375) retrieves data from the AQDHS-II master, parameter, and
sorted site files and creates two temporary files: a FORTRAN-compatible data
file to be passed to ASTSLAM (AQ0380) and a site data file to be passed to
ARPSLAM (AQ0390). The option card read by ARTSLAM (AQ0375) specifies the year
for which a SLAMS report is to be produced.
ASTSLAM (AQ0380) reads the temporary data file passed from ARTSLAM
(AQ0375), performs the statistical analyses, and produces a temporary
statistics file, which is passed to ARPSLAM (AQ0390).
ARPSLAM (AQ0390) reads the temporary statistics file passed from ASTSLAM
(AQ0380) and generates a formatted, hard copy report of the statistical data.
It can also generate a transaction file for a tape report of the data. The
option card read by ARPSLAM (AQ0390) specifies a run date to be printed on the
report.
Refer to the following sections for a detailed discussion of each of the
programs used to produce the SLAMS report: ARTSLAM (AQ0375)., Section 6.5.2;
ASTSLAM (AQ0380), Section 6.5.3; and ARPSLAM (AQ0390), Section 6.5.4.
The SLAMS report is produced by executing the cataloged procedure
AQRPM55. Refer to Section 6.5.4.5 for a detailed discussion of AQRPM55 and a
sample run stream.
629.30
-------
AQDHS-II
REPORTS
SECTION 6.5.1
SLAMS REPORT
INTRODUCTION
Page: 3
Release Date: 10/31/81
Update #: 29
AQDHS-II
MASTER
FILE
AQDHS-II
PARAMETER
FILE
/ AQDHS-II
SORTED
SITE FILE
OPTION CARD
SPECIFYING
REPORT YEAR
ARTSLAM (AQ0375)
SLAMS RETRIEVAL PROGRAM
DATA /
FILE I
(Temporary^
ASTSLAM (AQ0380)
SLAMS STATISTICAL
ANALYSIS PROGRAM
STATISTICS
FILE
k(Temporary)
1
0
/ SITE DATA /
WL4i
DIAGNOSTIC
REPORT
DIAGNOSTIC
REPORT
(Page 1 of 2)
Figure 6.5.1-a. SLAMS Report System Flowchart
629.31
-------
AQDHS-II
REPORTS
SECTION 6.5.1
SLAMS REPORT
INTRODUCTION
Page: 4
Release Date: 5/01/81
Update #: 28
AQDHS-II
PARAMETER
FILE
OPTION CARD
(Optional)
ARPSLAM (AQ0390)
SLAMS REPORT PROGRAM
SLAMS
TRANSACTION
FILE
DIAGNOSTIC
REPORT
(Page 2 of 2)
Figure 6.5.1-a - continued. SLAMS Report System Flowchart
692.32
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 1
Release Date: 10/31/81
Update #: 29
6.5.2 SLAMS Retrieval Program - ARTSLAM (AQ0375)
6.5.2.1 Description
ARTSLAM (AQ0375) is the first of three programs used to produce the
AQDHS-II State and Local Air Monitoring Sites (SLAMS) report. The SLAMS
statistical analysis program, ASTSLAM (AQ0380), and the. SLAMS report program,
ARPSLAM (AQ0390), must be executed after ARTSLAM (AQ0375) to produce the
report.
ARTSLAM (AQ0375) reads the AQDHS-II master, parameter, and sorted site
files and retrieves data for a user-specified year for six criteria pollutants
in the categories listed in Figure 6.5.2-a. The retrieved data is reformatted
and sorted, producing two temporary files: a FORTRAN-compatible file
containing master and parameter file data, which is passed to ASTSLAM
(AQ0380), and a file containing site file data, which is passed to ARPSLAM
(AQ0390).
6.5.2.2 File Formats
ARTSLAM (AQ0375) uses four input files: the AQDHS-II master file, the
AQDHS-II parameter file, the AQDHS-II sorted site file, and an option card.
See Figure 4.5.3-a for the master file format, Figure 4.2.2-c for the
parameter file format, Figure 5.6.3-a for the sorted site file format, and
Section 6.5.2.3 for a discussion of the option card.
Three output files are produced by ARTSLAM (AQ0375): a temporary data
file, a temporary site data file, and a diagnostic report.
The temporary data file, which is passed to ASTSLAM (AQ0380), is
FORTRAN-compatible since ASTSLAM (AQ0380) is coded in FORTRAN. It consists of
fixed-length records of 120 characters and contains a specific year's readings
• 629.33
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 2
Release Date: 10/31/81
Update #: 29
from the input master file for the pollutants and sites required by the SLAMS
report. Each record in this file also contains the minimum detectable reading
and the standard units conversion factor, as contained in the input parameter
file, for the parameter/method/units code of the readings in the record. The
file is sorted by parameter, site, time code, and date.
The temporary site data file, which is passed to ARPSLAM (AQ0390), is a
standard COBOL file consisting of fixed-length records of 227 characters. It
contains selected site file data for each parameter/method/site combination in
the temporary data file. This file is sorted by parameter and site.
Both temporary files contain header records; the temporary data file also
contains a trailer record.
The diagnostic report consists of update messages, program statistics,
and error messages. It also lists the options in effect. See Figure 6.5.2-b
for a sample diagnostic report.
6.5.2.3 Options
.The user must enter an option card specifying the option date. This date
is a two-digit number representing the year for which a SLAMS report is to be
generated. The option date must be numeric and must appear in columns 1 and 2
of the option card. If the option date is not numeric, or if no option card
is submitted, an error message will be printed and program execution will be
terminated.
The user can also specify a warning message suppression option. Warning
messages will be printed in the diagnostic report if 'FLAGW is specified;
they will be suppressed if 'NOFLAGW is coded or if this option is omitted.
For the format of the option card, see Figure 6.5.2-c.
629.34
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page:' 3
Release Date: 10/31/81
Update #: 29
6.5.2.4 Error Messages
ARTSLAM 001 ABORT - MASTER FILE CONTAINS NO RECORDS
Meaning: There are no records in the input master file; therefore, the
run was terminated.
Action: Review the JCL to determine whether or not a valid master file
was specified; if not, correct the JCL and resubmit the run.
ARTSLAM 002 CONDITIONAL - FORTRAN FILE CONTAINS ONLY HEADER AND TRAILER
RECORDS
Meaning: No data was retrieved from the master file; therefore, the
temporary data file contains no records.
Action: Determine whether or not the program produced an abort
message; if so, correct the error and resubmit the run. If
there is no abort message, verify that the master file contains
data that should have been retrieved; if so, verify that the
parameter file contains matching records for all the
parameter/method/units codes that would have been retrieved.
If the parameter file doesn't contain the necessary records,
update it and resubmit the run.
ARTSLAM 003 ABORT - PARAMETER TABLE OVERFLOW
Meaning: ARTSLAM (AQ0375) has been incorrectly modified: the maximum
number of parameters specified in the program is larger than
the size of the parameter array; therefore, the run was
terminated.
Action: See Appendix C for instructions on correctly increasing the
size of the array.
ARTSLAM 004 ABORT - NUMBER OF PARM FILE RECORDS EXCEEDS MAXIMUM ALLOWED
Meaning: The input parameter file contains more records than can be
stored in the parameter array; therefore, the run was
terminated.
629.35
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 4
Release Date: 10/31/81
Update #: 29
Action: See Appendix C for instructions on increasing the size of the
array.
ARTSLAM 005 ABORT - INVALID YEAR SPECIFIED
Meaning: A non-numeric value was specified for the option date, or no
option date was specified; therefore, the run was terminated.
Action: Specify a valid year for the option date and resubmit the run.
ARTSLAM 006 WARNING - NO MATCHING SITE RECORD FOR MASTER FILE RECORD [record
key]
Meaning:. The input site file does not contain a record to match the
retrieved master file record whose key is printed in this
message. A dummy record was created for this record in the
temporary site data file; it contains only the key information.
Action: If the descriptive site information is desired, update the
site file and resubmit the run.
ARTSLAM 007 WARNING - SITE RECORD XXXXXXXXXXXX HAS NO DATA FOR PARAMETER/
METHOD YYYYYZZ
Meaning: The input site file record whose key is XXXXXXXXXXXX matches a
retrieved master file record but has no data for the parameter/
method code YYYYYZZ, which is the parameter/method code of the
master file record. A dummy record was created for this record
in the temporary site data file; it contains only the key
information.
Action: If the descriptive site information is desired, update the site
file and resubmit the run.
ARTSLAM 008 CONDITIONAL - MASTER-SITE FILE CONTAINS ONLY HEADER RECORD
Meaning: No data was retrieved from the master file; therefore, the
temporary site data file contains no records.
Action: See error message ARTSLAM 002.
629.36
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 5
Release Date: 10/31/81
Update #: 29
ARTSLAM 009 CONDITIONAL - MISSING OR INVALID FLAGW OPTION - NOFLAGW ASSUMED
Meaning: An invalid warning suppression option, or no warning
suppression option, was specified; therefore, the default
option, NOFLAGW, was assumed.
Action: If any warning messages were produced and a listing of them is
desired, correct the option card and resubmit the run.
ARTSLAM 010 ERROR - NO MATCHING PARM RECORD FOR MASTER RECORD [record key] -
DATA IGNORED
Meaning: The input parameter file does not contain a record to match the
master file record whose key is printed in this message;
therefore, the master file record was not retrieved.
Action: To insure that an accurate and complete SLAMS report is
produced, update the parameter file and resubmit the run.
ARTSLAM Oil ABORT - NO OPTION CARD
Meaning: No option card was included in the runstream; therefore, the
run was terminated.
Action: Include a valid option card and resubmit the run.
6.5.2.5 Cataloged JCL
ARSTLAM (AQ0375) must always be executed in conjunction with ASTSLAM
(AQ0380) and ARPSLAM (AQ0390). See Section 6.5.4.5 for a discussion of the
cataloged procedure AQRPM55, which executes all three programs.
6.5.2.6 Warnings and Special Instructions
In order for ARTSLAM (AQ0375) to retrieve all the data necessary for a
complete and accurate SLAMS report, the parameter and site files must contain
records to match the master file records. If there is no record in the
parameter file to match a retrieved master file record, the master file record
629.37
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 6
Release Date: 10/31/81
Update #: 29
is bypassed and its data is not included in the statistical analyses
performed by ASTSLAM (AQ0380) and is not included in the report produced by
ARPSLAM (AQ0390). Also, the readings in a retrieved master file record are
converted to standard units by using the standard units conversion factor from
the matching parameter file record; thus, it is imperative that the standard
units conversion factors in the parameter file be correct.
If there is no record in the site file to match a retrieved master file
record, or if there is a matching site file record which does not contain the
necessary parameter/method information, the master file record will still be
retrieved, but the report produced by ARPSLAM (AQ0390) will lack the
descriptive information for that site.
Execution of ARPPARM (AQ0240) and ARPSITE (AQ0260) will permit
verification of entries in the parameter and site files, respectively.
Note that the COBOL sort verb is used in this program; therefore, the
collating sequence for alphanumeric fields is determined by the computer at
the user's particular installation.
In addition to the diagnostic report produced by ARTSLAM (AQ0375),
messages generated by the sort-merge package will be printed. The format and
content, as well as the physical location, of these messages depend upon the
user's particular installation.
6.5.2.7 Cost Considerations
The following estimates are for the execution of ARTSLAM (AQ0375) on an
IBM 370/168:
Size of master file: 12,336 records
Size of parameter file: 84 records
Size of, sijte file: 21 records
629.38
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 7
Release Date: 10/31/81
Update #: 29
Size of temporary data file:
Size of temporary site file:
CPU time:
I/O time:
Total time:
Estimated cost:
19,293 records
37 records
1.24 seconds
28.15 seconds
29.39 seconds
$13.66
6.5.2.8 Related Programs and Procedures
ARTSLAM (AQ0375) must always be executed in conjunction with ASTSLAM
(AQ0380) and ARPSLAM (AQ3090). The cataloged procedure AQRPM55 executes all
three programs.
629.39
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 8
Release Date: 10/31/81
Update #: 29
Pollutant
Total Suspended
Participate (TSP)
Lead (Pb)
Carbon Monoxide (CO)
Sulfur Dioxide (503)
Nitrogen Dioxide (N02)
Ozone (03)
Parameter Sampling AQDHS-II AQDHS-II
Code Interval(s) Time Code(s) SLAMS Codes
11101
12128
42101
42401
42602
44201
Daily
Daily
Hourly
Hourly
Daily
Hourly
Daily
Hourly
8
8
1
1
8
1
8
1
1,2
1,2
1,2
1,2
1,2
1,2
1,2
1.2
Figure 6.5.2-a. Categories of Data Retrieved by ARTSLAM (AQ0375)
629.40
-------
AQDHS-II SLAMS RETRIEVAL PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ARTSLAM (AQ0375)
REVISION LEVEL: 2-00
LAST UPDATE »: £9
DATE INCORPORATED: MAY 1, 1981
OPTIONS IN EFFECT: YEAR = 1980
NOFLAGW
no
^O
•
-pi
NUMBER OF MASTER FILE RECORDS READ:
NUMBER OF PARAMETER FILE RECORDS READ:
NUMBER OF SITE FILE RECORDS READ:
NUMBER OF FORTRAN FILE RECORDS WRITTEN:
NUMBER OF MASTER-SITE FILE RECORDS WRITTEN:
NUMBER OF CONDITIONAL MESSAGES:
NUMBER OF ABORT MESSAGES:
NUMBER OF WARNING MESSAGES:
NUMBER OF ERROR MESSAGES:
3,308
95
101
13,043
360
0
0
3,308
0
Figure 6.5.2-b. Diagnostic Report
73 J>
rn JT
x> t
o :
73 CO
—I I
CO •—i
CO CO
I— m
3> O
3 -
CO >
o m
co <
~J 3=
in r-
13
73
O
O
73
CTl
ro
c: 73 -v
~o ro o>
CL —' IQ
Qt ro ro
r* CU
ro '
ro
no a>
10 ..
o
^-^
CO
I—•
c»
-------
AQDHS-II
REPORTS
SECTION 6.5.2
SLAMS RETRIEVAL PROGRAM
ARTSLAM (AQ0375)
Page: 10 •
Release Date: 10/31/81
Update #: 29
Column #1 Column #4
I I
YY
FLAGW
NOFLAGW
The options are subject to the following restrictions:
1. The option date (YY) must be specified in columns 1-2; it must be
numeric.
2. The warning suppression option can be left blank or specified beginning
in column 4.
Figure 6.5.2-c. Option Card Format for ARTSLAM (AQ0375)
629.42
-------
AQDHS-II
REPORTS
SECTION 6.5.3
SLAMS STATISTICAL ANALYSIS
PROGRAM ASTSLAM (AQ0380)
Page: .1 ••::
Release Date: 10/31/81
Update #:- 29
6.5.3 SLAMS Statistical Analysis Program - ASTSLAM (AQ0380)
6.5.3.1 Description
ASTSLAM (AQ0380) is executed after the SLAMS retrieval program, ARTSLAM
(AQ0375), and before the SLAMS report program, ARPSLAM (AQ0390). ASTSLAM
(AQ0380) reads the temporary data file produced by ARTSLAM (AQ0375), performs
various statistical analyses, and produces a temporary statistics file, which
is passed to ARPSLAM (AQ0390). ASTSLAM (AQ0380) is coded in ANSI FORTRAN
using a modular, top-down coding technique.
The input file is a temporary data file consisting of raw data for the
requested year and six criteria pollutants. The pollutants which are
currently recognized by ASTSLAM (AQ0380) are total suspended particulate
(11101), lead (12128), carbon monoxide (42101), sulfur dioxide (42401),
nitrogen dioxide (42602), and ozone (44201).
The data in the temporary data file has been sorted by parameter and site
key. Separate analyses are performed for each pollutant; these analyses are
discussed below.
Total Suspended Particulate (TSP)
The following statistics are calculated for total suspended particulate:
. number of daily observations
. annual geometric mean
. number of exceedances of the 24-hour primary National
Ambient Air Quality Standard (NAAQS)
. number of exceedances of the 24-hour secondary NAAQS
In addition, a frequency distribution of 24-hour average concentrations
is produced for the following ranges:
629.43
-------
AQDHS-II
REPORTS
SECTION 6.5.3
SLAMS STATISTICAL ANALYSIS
PROGRAM ASTSLAM (AQ0380)
Page: 4
Release Date: 5/01/81
Update #: 28
. number of hourly observations
. number of daily observations
. annual arithmetic mean
. 1st and 2nd 1-hour maximums and their date and time of
occurrence
. 1st and 2nd 24-hour maximums and their date of occurrence
In addition, a frequency distribution for 1-hour values is produced for
the following ranges:
0.00 ppm to 0.04 ppm
0.05 ppm to 0.08 ppm
0.09 ppm to 0.12 ppm
0.13 ppm to 0.16 ppm
0. 17 pprn to 0.20 ppm
0.21 pprn to 0.24 ppm
0.25 ppm to 0.28 pprn
greater than 0.28 ppm
Ozone
The following statistics are calculated for ozone:
. number of hourly observations
. four highest daily maximums and their date and time of
occurrence
. number of exceedances of the daily maximum 1-hour primary
NAAQS
In addition a frequency distribution for the daily maximums is produced
for the following ranges:
629.46
-------
AQDHS-II
REPORTS
SECTION 6.5.3
SLAMS STATISTICAL ANALYSIS
PROGRAM ASTSLAM (AQ0380)
Page: 5 ^
Release Date: 10/31/8
Update #: 29
0.00 ppm to 0.04 ppm
0.05 ppm to 0.08 ppm
0.09 ppm to 0.12 ppm
0.13 ppm to 0.16 ppm
0.17 ppm to 0.20 ppm
0.21 ppm to 0.24 ppm
0.25 ppm to 0.28 ppm
greater than 0.28 ppm
6.5.3.2 File Formats
Input to this program consists of a temporary data file passed from
ARTSLAM (AQ0375). See Section 6.5.2.2 for additional information on this
file. Output consists of a diagnostic report (see Figure 6.5.3-a) and a
temporary file passed to ARPSLAM (AQ0390). This temporary file is referred to
as a .SLAMS statistics file and contains the statistics computed by ASTSLAM
(AQ0380).
6.5.3.3 Options
There are no options for this program.
6.5.3.4 Error Messages
ASTSLAM 001 ABORT - NO DATA ON INPUT DATA FILE
Meaning: The run data contains only a header and a trailer record;
therefore, program execution was terminated.
Action: Insure that ARTSLAM (AQ0375) has retrieved a usable temporary
data file.
629.47
-------
AQDHS-II
REPORTS
SECTION 6.5.3
SLAMS STATISTICAL ANALYSIS
PROGRAM ASTSLAM (AQ0380)
Page: 6 •
Release Date: 10/31/8
Update i: 29
6.5.3.5 Cataloged JCL
ASTSLAM (AQ0380) must always be executed in conjunction with ARTSLAM
(AQ0375) and ARPSLAM (AQ0390). The cataloged procedure AQRPM55 will execute
all three programs. This procedure is discussed in Section 6.5.4.5.
6.5.3.6 Warnings and Special Instructions
This program should always be run in conjunction with ARTSLAM (AQ0375)
and ARPSLAM (AQ0390) to insure that a proper report will be produced.
This report should be generated and submitted to EPA as directed by law.
6.5.3.7 Cost Considerations
The following example provides an estimate of the cost of executing
ASTSLAM (AQ0380) on an IBM 370/168.
Size of temporary data file: 19,293 records
Size of temporary statistics file: 72 records
CPU time: 1.58 seconds
I/O time: 47.76 seconds
Total time: 49.34 seconds
Estimated Cost: $15.80
6.5.3.8 Related Programs and Procedures
ASTSLAM (AQ0380) must be executed in conjunction with ARTSLAM (AQ0375)
and ARPSLAM (AQ0390). See Section 6.5.2 for a discussion of ARTSLAM (AQ0375)
and Section 6.5.4 for a discussion of ARPSLAM (AQ0390).
629.48
-------
AQDHS-II SLAMS ANALYSIS PROGRAM - DIAGNOSTIC REPORT
PAGE 1
PROGRAM NAME: ASTSLAM (AQ0380)
REVISION LEVEL: 2-00
LAST UPDATE 8: 29
DATE INCORPORATED: OCTOBER 31, 1981
RECORDS IN:
RECORDS OUT
13043
716
t\>
•p.
ID
Figure 6.5.3-a. Diagnostic Report
-o
Q.
CU
rt-
fD
70 >
m o
-o o
o 3:
73
—I i
CO I-H
O J»
CT5 3
TO GO
3 00
> 3=-
00 —I
—I •-<
OO CO
I— —I
3 O
-—• f—
o -z.
00 J>
oo r-
o -<
OO
l«-4
OO
70
!L
ro
Cu
01
o
CU
r+
n>
o
OO
I—"
oo
OO
m
O
en
•
on
•
OO
cu
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 2
Release Date: 10/31/81
Update #: 29
6.5.2.2 for a description of the site data file format, and Figure 4.2.2-c for
a description of the parameter file. See Section 6.5.4.3 for a discussion of
the option card.
Output from the program consists of the SLAMS transactions, the SLAMS
report, and a diagnostic report.
The SLAMS transactions contain the same information as the report and are
generally written to a magnetic tape. There are two types of transactions
generated for each break in key information, with the exception of lead data,
which generates only type 1 transactions. The type 1 transactions contain
such data as the number of readings detected, geometric or arithmetic means,
and maximum readings. The type 2 transactions contain distributions of the
readings over various intervals. See Figure 6.5.4-a for a description of the
SLAMS transaction formats.
The SLAMS report is primarily ordered by the pollutant code and,
therefore, is divided into a maximum of six sections. Two types of report
formats are generated for each pollutant, with the exception of lead, which
has only one report format. In addition, all method code descriptions
contained in the parameter file for a reported pollutant are also included in
each pollutant section of the report. Therefore, each pollutant section of
the report is divided into three segments, with the exception of lead, which
has only two segments. The page numbering scheme of the report reflects this
type of segmentation with segment 0 containing method code descriptions,
segment 1 containing report format 1, and segment 2 containing report format
2. The page numbering for a given pollutant section is 0.0001, 0.0002, ...,
O.nnnn, 1.0001, 2.0001, 1.0002, 2.0002, ..., l.nnnn, 2.nnnn. The user should
note that any given page of report format 1 is immediately followed by the
corresponding page of report format 2. This is because a page of report
format 2 contains data for the same site(s) as the corresponding page of
report format 1. See Figure 6.5.4-b for a sample SLAMS report.
629.51
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 1
Release Date: 10/31/81
Update #: 29
6.5.4 SLAMS REPORT PROGRAM - ARPSLAM (AQ0390)
6.5.4.1 Description
ARPSLAM (AQ0390) is the third of three programs used to produce the
AQDHS-II State and Local Air Monitoring Sites (SLAMS) report. It generates a
formatted report of the statistical data output from the SLAMS statistical
analysis program, ASTSLAM (AQ0380), for submittal to EPA. It can also
generate transactions from the statistical data. See Section 6.5.3 for a
discussion of ASTSLAM (AQ0390).
The report contains statistical data for six criteria pollutants: total
suspended particulate .(11101), lead (12128), carbon monoxide (42101), sulfur
dioxide (42401), nitrogen dioxide (42602), and ozone (44201). The data for
each pollutant is reported by site and monitoring information, which includes
county code, area code, site code, agency code, project code, and method code.
Descriptive information is extracted from the temporary site file which is
passed from the SLAMS retrieval program, ARTSLAM (AQ0375). This information
includes city name, county name, site address, and reporting organization
code.
The report also contains descriptive information for all method codes
contained in the user's AQDHS-II parameter file for each of the six
pollutants. This information is reported by method code prior to each
pollutant report and includes the analysis method and the collection method.
6.5.4.2 File Formats
Input to ARPSLAM (AQ0390) consists of the temporary statistics file
passed from ASTSLAM (AQ0380), the corresponding temporary site data file
passed from ARTSLAM (AQ0375), the AQDHS-II parameter file, and an option card.
See Section 6.5.3.2 for a description of the statistics file formats, Section
\~~~"
629.50
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 3
Release Date: 5/01/81
Update #: 28
The diagnostic report contains counts of the input and output files, the
number of pollutants in the report, the total number of report pages, and the
number of errors detected. This report also contains the program update
messages and any error messages generated during the run. See Figure 6.5.4-c
for a sample diagnostic report.
6.5.4.3 Options
The option card for ARPSLAM (AQ0390) allows the user to enter a run date
to be printed on the report. The date should be entered as MMDDYY (month,
day, year) in columns 1 through 6 of the option card. If the option card is
not present, or if the date is not numeric, an error message will be printed
and no run date will appear in the SLAMS report. See Figure 6.5.4-d for a
description of the option card.
An alternative method of obtaining a run date is coded in the program for
computers that have the ACCEPT command capability. This capability allows the
program to retrieve the date directly from the computer, thereby making it
unneccesary for the user to enter an option card in the run stream. See
Section 6.5.4.6 for instructions on implementing this capability.
6.5.4.4 Error Messages
ARPSLAM 001 ERROR - NO OPTION CARD PRESENT OR OPTION DATE NOT NUMERIC,
NO DATE FOR REPORT
Meaning: There was no option card in the run stream, or the date on
the option card was not numeric.
Action: If a run date is desired on the report, enter an option
card with the current date and resubmit the job.
639.52
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 4 - • f
Release Date: 10/31/81
Update #: 29
ARPSLAM 002 DISASTER - EXPECTING RECORD TYPE 1, BUT TYPE 1 NOT PRESENT,
CALL NADB
Meaning: A type 2 record in the input statistics file has no
matching type 1 record; therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSLAM 003 DISASTER - NO RECORD TYPE 2 OR RECORD KEYS NOT EQUAL, CALL
NADB
Meaning: No matching record type 2 was found for a type 1 record,
or the type 2 record following the type 1 record did not
match; therefore, the run was terminated.
.Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSLAM 004 DISASTER - NO HEADER RECORD IN SITE-DATA FILE, CALL NADB
Meaning: The site data file passed from ARTSLAM (AQ0375) has no
header record; therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSLAM 005 ABORT - NO RECORDS PRESENT IN SITE-DATA FILE
Meaning: The site data file passed from ARTSLAM (AQ0375) contains
no records; therefore, the run was terminated.
Action: Check the diagnostic report form ARTSLAM (AQ0375) to
insure that records were written to the site data file.
ARPSLAM 006 DISASTER - PREMATURE END OF SITE-DATA FILE, CALL NADB
Meaning: An end-of-file condition has been detected for the site
data file but not for the statistics file. Since there
should be a site data file record for every pair of
statistics file records, the run was terminated.
629.53
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 5
Release Date: 10/31/81
Update #: 29
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSLAM 007 DISASTER - PREMATURE END OF STATISTICS FILE, CALL NADB
Meaning: An end-of-file condition has been detected for the
statistics file but not for the site data file; therefore,
the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSLAM 008 DISASTER - SITE DATA KEY DOES NOT MATCH STATISTICS KEYS, CALL
NADB
Meaning: A matching site data record was not found for the pair of
statistics records that was being processed; therefore,
the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSLAM 009 ERROR - NO PARM FILE RECORDS FOR POLLUTANT XXXXX, NO METHOD
DESCRIPTION LISTED
Meaning: No parameter/method information for pollutant XXXXX was
found in the parameter file; therefore, there were no
method descriptions listed for this pollutant.
Action: Insure that the proper file is being used and that data
for pollutant XXXXX is in the file.
6.5.4.5 Cataloged JCL
ARPSLAM (AQ0390) must always be executed in conjunction with ARTSLAM
(AQ0375) and ASTSLAM (AQ0380). The JCL presented in this section is used to
execute all three programs.
629.54
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 56 "•• ;
Release Date: 10/31/81
Update #: 29
6.5.4.5.1 JCL listing - The SLAMS report can be produced by executing the
cataloged procedure AQRPM55. This procedure executes ARTSLAM (AQ0375),
the SLAMS retrieval program; ASTSLAM (AQ0380), the SLAMS statistical
analysis program; and ARPSLAM (AQ0390), the SLAMS report program. See
Figure 6.5.4-e for a listing of this procedure.
6,5.4.5.2 Cross-rreference of DP names and files
Program Name: ARTSLAM (AQ0375)
DP Name
AQSMASTR
AQSPARMC
AQSTESRT
AQSOPTIN.
SORTWK01
AQSFRTRN
AQSMSSTE
AQSPRINT
File Description
AQDHS-II master file
AQDHS-II parameter, file
AQDHS-II sorted site file
Option card
Sort work file
Temporary data file passed
to.ASTSLAM (AQ0380.)
Temporary site data file
passed to ARPSLAM (AQ0390)
Diagnostic report
Input/Output
Input
Input
Input
Input
Internal
Output
Output
Output
Program Name: ASTSLAM (AQ0380)
DP Name
FT08F001
FT09F001
FT06F001
File Description
Temporary file received
from ARTSLAM (AQ0375)
Temporary statistics file
passed to ARPSLAM (AQ0390)
Diagnostic report
Input/Output
Input
Output
Output
629.55
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 7
Release Date: 10/31/81
Update #: 29
Program Name: ARPSLAM (AQ0390)
DD Name
File Description
Input/Output
AQSSTAT
AQSSITE
AQSPARM
AQSOPTN
AQSLAMS
AQSPRNT
AQSDIAG
Temporary statistics file Input
received from ASTSLAM
(AQ0380)
Temporary site data file Input
received from ARTSLAM
(AQ0375)
AQDHS-II parameter file Input
Option card Input
SLAMS transaction file Output
SLAMS report Output
Diagnostic report Output
6.5.4.5.3 User-supplied JCL - To execute the cataloged procedure
AQRPM55, the user can expect to supply job accounting information (job card),
and the data set names of the master, parameter, and sorted site files. See
Figure 6.5.4-f for a description of the procedure's substitutable parameters.
6.5.4.5.4 Sample run stream - The following run stream would produce a
SLAMS report for 1980 for the AQDHS-II master file 'CN.EPALMH.A087.CDHS.
HQ.AQS.DATA.AQMSTR11, using the AQDHS-II parameter file 'CN.EPALMH.A087.
CDHS.HQ.AQS.DATA.AQPARM1' and the AQDHS-II sorted site file 'CN.EPALMH.
A087.CDHS.HQ.AQS.DATA.AQSRST11.
// EXEC AQRPM55,
// MSTRFIL=AQMSTR1,
// PARMFIL=AQPARM1,
// SITESRT=AQSRST1
629.56
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 8 • ~ >
Release Date: 10/31/81
Update #: 29 :
//RETRIEVE.OPTIONS DD *
80
//REPORT.OPTIONS DD *
050181
/*
6.5.4.6 Warnings and Special Instructions
In order to activate the ACCEPT command, certain program modifications
must be made prior to compiling the program. These changes are as follows:
Change the following statements (on or about sequence numbers 164400
through 164800) from:
* ACCEPT REPORT-DATE FROM DATE.
* MOVE REPORT-MONTH TO RUN-MONTH.
* MOVE REPORT-DAY TO RUN-DAY.
* MOVE REPORT-YEAR TO RUN-YEAR.
PERFORM OPTIONS-CONTROL THRU OPTIONS-CONTROL-END.
to:
ACCEPT REPORT-DATE FROM DATE.
MOVE REPORT-MONTH TO RUN-MONTH.
MOVE REPORT-DAY TO RUN-DAY.
MOVE REPORT-YEAR TO RUN-YEAR.
* PERFORM OPTIONS-CONTROL THRU OPTIONS-CONTROL-END.
An asterisk in column 7 indicates that a line of code is actually a
comment and will not be translated into machine code by the compiler.
The first four lines will be translated by the compiler if the asterisks are
removed. The fifth line will be treated as a comment if an asterisk is placed
629.57
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 9
Release Date: 10/31/81
Update #: 29
in column 7 of that line. In the original code, the first four lines will be
treated as comments and the fifth line will be translated; in the modified
code, the first four lines will be translated and the fifth line will be
treated as a comment.
The cataloged procedure AQRPM55 specifies the SLAMS transaction file as a
DUMMY file;'therefore, no tape report is created. The JCL to create the tape
report is contained in AQRPM55 as comments and can be activated by the user;
however, the tape report cannot be accepted by EPA in fulfillment of the SLAMS
reporting requirements.
6.5.4.7 Cost Considerations
The following example provides an estimate of the cost of executing
ARPSLAM (AQ0390) on an IBM 370/168.
Size of statistics file: 72 records
Size of site data file: 37 records
Size of parameter file: 44 records
Size of output SLAMS transactions: 66 records
Total report pages: 19 pages
CPU time: .04 second
I/O time: .43 second
Total time: .47 second
Estimated Cost:
$0.19
6.5.4.8 Related Programs and Procedures
ARPSLAM (AQ0390) must be executed in conjunction with ARTSLAM (AQ0375)
and ASTSLAM (AQ0380). See Section 6.5.2 for a discussion of ARTSLAM (AQ0375)
and Section 6.5.3 for a discussion of ASTSLAM (AQ0380).
629.58
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 10
Release Date: 5/01/81
Update #: 28
Fields Common to All Transactions
Column # Fiel.d Length Data Type
1 1
2-6 .5
7-8 2
9-12 4
13-16 4
17-19 . 3
20 1
21-22 2
23-24 2
25-27 3
28 - 55 28
56 - 83 28
84 - 124 . 41
125 1
1-26 - 2 IB 93
Numeric
Numeric
Numeric
Numeric
Numeric
Numeric
Alphabetic
Numeric
Numeric
Alphanumeric
Alphanumeric
Alphanumeric
Alphanumeric
Description
Transaction Type (1)
Parameter Code
State Code
County Code
Area Code
Site Code
Agency Code
Project Code
Method Code
Key
Fields
Reporting Organization
County Name
City Name
Site Address
Not Used
Filler
(Page 1 of 8)
Figure 6.5.4-a. SLAMS Transaction Formats
629.59
-------
SLAMS REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ARPSLAM (AQ0390)
REVISION LEVEL: 2-00
LAST UFCATE «: 29
DATE INCORPORATED: OCTOBER 31, 1981
NUMBER OF STATISTICS RECORDS READ:
NUMBER OF SITE DATA RECORDS PWD:
NUMBER OF PARAMETER RECORDS .-E. j;
NUMBER OF SLAMS RECORDS WRITTEN:
NUMBER OF POLLUTANTS REPORTED:
TOTAL NUMBER OF REPORT PAGES:
NUMBER OF WARNINGS DETECTED:
NUMBER OF CONDITIONALS DETECTED:
NUMBER OF ERRORS DETECTED:
NUMBER OF ABORTS DETECTED:
NUMBER OF DISASTERS DETECTED:
718
360
Si
718
4
61
0
0
0
0
0
CTl
ro
o
Figure 6.5.4-c. Diagnostic Report
-o O
O 3C
50 OO
-H I
CO I-H
O
OO
CO CO
i— rn
3= o
CO t— i
PO
m
O
73
70
O
O
73
•g. 2.
Qi
r* DJ
to
n>
=«:
o
DJ
INS n>
VO ••
o
CO
I—'
CO
Ol
n>
OO
--J
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 38
Release Date: 5/01/81
Update #: 28
Column 1
V
MMDDYY
Replace MMDDYY with the month, day, and year to be printed on the SLAMS
report as the run date.
Figure 6.5.4-d. Option Card
629.87
-------
AQDHS-II
REPORTS
SECTION 6.5.4 Page: 39 •
SLAMS REPORT PROGRAM Release Date: 10/31/81
ARPSLAM (AQ0390) Update #: 29
//* 00000100
//» PROCEDURE NAME: AQRPMS5 00000200
//» REVISION LEVEL: 2-00
//* LAST UPDATE 3: 29
00000300
00000400
//* DATE INCORPORATED: OCTOBER 31, 1981 00000500
//»
//*
00000600
00000700
//* THIS PROCEDURE GENERATES A SLAMS REPORT 00000800
//* FROM AN AQDHS-II MASTER FILE 00000900
//»
//*
00001000
00001100
//AQRPM55 PROC PROJECT='CN.EPALMH.A087.CDHS.HQ.AQS' , 00001200
// PROG1=ARTSLAM, 00001300
// PROG2=ASTSLAM, 00001400
// PROG3=ARPSLAM, 00001500
// REGION1=200K,
// REGION2=100K,
// REGICN3=100K,
// TIME1='5,0',
// TIME2='2,0',
// TIME3='2,0',
00001600
00001700
00001800
00001900
00002000
00002100
// MSTRFIL=AQMASTER, 00002200
// PARMFIL=AQPARMFL, 00002300
// SITESRT=AQSRSITE, 00002400
//* SLAMTAP=AQSLAMTP, 00002500
// DISP1='OLD, KEEP, KEEP', 00002600
// DISP2='NEW,PASS' , 00002700
// DISP3='OLO, DELETE', 00002800
//* DISP4='NEW,KEEP', 00002900
// TEMP=SYSDA,
//* UNIT1=TAPE,
00003000
00003100
//* SERIAL1=AQTAPE, 00003200
// SFUNIT1=CYL,
// SPUNIT2=TRK,
// SPUNIT3=eYL,
// SPUNIT4=TRK,
// PRI1=50,
// P3I2=20,
// FRI3=50,
// FRI4=10,
// SEC1=10,
// SEC2=10,
// SEC4MO,
//* LABLNO=1,
//* LABLCK=BLP,
// OUT=A
//*
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
//* THIS STEP RETRIEVES MASTER FILE AND SITE FILE DATA 00004800
//*
//RETRIEVE EXEC PGM=JPROG1,
00004900
00005000
// REGION=SREGION1, 00005100
// TIME=UTIME1)
//*
00005200
00005300
//STEPLIB DD DSNAME=4PROJECT..LOAD, 00005400
// VOLUME=( PRIVATE, RETAIN), 00005500
// DISP=(SHR,PASS) 00005600
// DD DSNAME=SYS1.COBLIB, 00005700
// DISP=(SHR,PASS) 00005800
//* 00005900
//SORTLIB DD DSNAME=SYS1 .SORTLIB, 00006000
// D1SP=(SHR,PASS) 00006100
(Page 1 of 4)
Figure 6.5.4-e. Cataloged Procedure AQRPM55
629.88
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 40/ •
Release Date:
Update #: 29
10/31/81
//*
//* INPUT DATA SET - MASTER FILE
//*
//AQSMASTR DD DSNAME=SPROJECT..DATA.&MSTRFIL,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(&DISP1)
//*
//* INPUT DATA SET - PARAMETER FILE
//»
//AQSPARMC DD DSNAME=SPROJECT..DATA.&PARMFIL,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(8DISP1)
//*
//* INPUT DATA SET - SORTED SITE FILE
//*
//AQSTESRT DD DSNAME=&PROJECT..DATA.SSITESRT,
// VOLUME=(PRIVATE,RETAIN),
// DISP=UDISP1)
//«
//* INPUT DATA SET - OPTION CARD
//*
//AQSOPTIN DD DDNAME=OPTIONS,
// DCB=BLKSIZE=80
//*
//« OUTPUT DATA SET - MASTER FILE DATA TO BE PASSED TO ASTSLAM
//*
//AQSFRTRN OD DSNAME=4&MFOATA,
// DISP=UDISP2),
// UNIT=&TEMP,
// SPACE=(SSPUNIT1, ( &PRI1 , SSEC1) ,RLSE )
//*
//* OUTPUT DATA SET - SITE FILE DATA TO BE PASSED TO ARPSLAM
//«
//AQSMSSTE DD DSNAME=*SSFDATA,
// DISP=(iDISP2),
// UNIT=&TEMP,
// SPACE=(SSPUNIT2,(SP3I2,4SEC2),RLSE)
//*
//* SORT WORK FILES
//*
//SORTWK01 DD UNIT=&TEMP,
// SPACE=(SSPUNIT3,(&PRI3),.CONTI6)
//*
//SORTWK02 DD UNIT=STEMP,
// SPACE=(SSPUNIT3,(4PRI3),.CONTIG)
//*
//SORTWK03 DD UNIT=STEMP,
// SPACE=(&SPUNIT3,(4PRI3),,CONTIG)
//*
//* OUTPUT DATA SET - DIAGNOSTICS
//*
//AQSPRINT 00 SYSOUT=40UT
//»
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT OD SYSOUT=SOUT
//*
//SYSOUT DD SYSOUT=&OUT
//SYSDBOUT DD SYSOUT=SOUT
00006200
00006300
00006400
00006500
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
00008000
00008100
00008200
00008300
00008400
00006500
00006600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
00010600
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
00011700
00011800
00011900
0001200C
00012200
(Page 2 of 4)
Figure 6.5.4-e - continued. Cataloged Procedure AQRPM55
629.89
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 41
Release Date: 10/31/81
Update #: 29
//SYSDTERM DD SYSOUT=SOUT 00013300
//* 00012400
//SYSUDUMP DD SYSOUT=&OUT 00012500
//* 00012600
//* THIS STEP CALCULATES STATISTICS 00012700
//« 00012SOO
//STAT EXEC PGM=SPROG2> 00012900
// REGION=SREGION2, 00013000
// TIME=(4TIME2) 00013100
//* 00013200
//STEPLIB DD DSNAME=«PROJECT..LOAD, 00013300
// VOLUME=
-------
AQDHS-II
REPORTS
SECTION 6.5.4
SLAMS REPORT PROGRAM
ARPSLAM (AQ0390)
Page: 42 '•
Release Date:
Update #: 29
10/31/81
//AQSSITE DD DSNAME=&&SFDATA,
// DISP=UDISP3>
//*
//* INPUT DATA SET - PARAMETER FILE
//*
//AQSPARM DD DSNAME=fcPROJECT. .DATA.iPARMFIL,
// VOLUME=(PRIVATE,RETAIN),
// DISP=(8DISP1)
//*
//* INPUT DATA SET - OPTION CARD
//*
//AQSOPTN DD DDNAME=OPTIONS,
// DCB=BLKSIZE=80
//*
//* OUTPUT DATA SET - SLAMS TAPE
//»
//AQSLAMS DD DUMMY
V/*AQSLAMS DD UNIT=&UNIT1,
//* VOLUME=(PRIVATE,RETAIN,SER=&SERIAL1),
//* DISP=(4DISP4),
//» DCB=(DSORG=PS,RECFM=FB,LRECL=218,BLKSIZE='f360),
//* LABEL=(&LABLNO,SU5LCK),
//» RIHG=IN, CHANGE TO USER SPECIFICATIONS
//* DSNAME=£PROJECT. .DATA.4SLAMTAP
//*
//* OUTPUT DATA SET -. DIAGNOSTICS
//«
//AQSDIAG DD SYSOUT=&OUT
//*
//* OUTPUT DATA SET - SLAMS REPORT
//*
//AQSPRNT DD SYSOUT=&OUT
//*
//* OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSOUT DD SYSOUT=40UT
//*
//SYSPRINT DD SYSOUT=SOUT
//*
//SYSDBOUT DD SYSOUT=SOUT
//*
//SYSUDUMP DD SYSOUT=&OUT
//*
//SYSDTERM DD SYSOUT=SOUT
//*
00018400
00018500
00018600
00018700
00018800
00018900
00019000
00019100
00019200
00019300
00019400
00019500
00019600
00019700
00019800
00019900
00020000
00020100
00020200
00020300
00020400
00020500
00020600
00020700
00020800
00020900
00021000
00021.100
00021200
00021300
00021400
00021500
00021600
00021700
00021800
00021900
00022000
00022100.
00022200
00022300
00022400
000225CO
00022600
00022700
00022800
(Page 4 of 4)
Figure 6.5.4-e - continued. Cataloged Procedure AQRPM55
629.91
-------
AQDHS-II
REPORTS
SECTION 6.5.4 Page: 45 •
SLAMS REPORT PROGRAM Release Date: 10/31/81
ARPSLAM (AQ0390) Update #: 29
Parameter Name Default Value Description
SPUNIT4 TRK
PRI1 50
PRI2 20
PRI3 50
PRI4 10
SEC1 10
SEC2 10
SEC4 10
LABLNO 1
LABLCK BLP
OUT A
Units in which space for
temporary statistics file is
to be allocated
Primary space allocation for
temporary data file
Primary space allocation for
temporary site data file
Primary space allocation for
sort work space
Primary space allocation for
temporary statistics file
Secondary space allocation for
temporary data file
Secondary space allocation for
temporary site data file
Secondary space allocation for
temporary statistics file
Relative file number for the
SLAMS transaction file
Label type for the SLAMS
transaction file
SYSOUT class for all print
files
(Page 3 of 3)
Figure 6.5.4-f - continued. Substitutable Parameters for AQRPM55
629.94
-------
AQDHS-II
REPORTS
SECTION 6.6.1
STANDARDS REPORT
INTRODUCTION
Page: 1
Release Date: 10/31/81
Update #: 29
6.6 STANDARDS REPORT
.6.6.1 INTRODUCTION
The AQDHS-II standards report c.ontains statistical data for five criteria
pollutants: total suspended particulate (TSP), lead (Pb), carbon monoxide
(CO), sulfur dioxide (S02), and nitrogen dioxide (N02). The statistics
include number of observations; arithmetic and geometric means; maximum
readings; 3-hour, 8-hour, and 24-hour running averages; and number of
exceedances of standards, with only those statistics that are valid for any
given pollutant being calculated for that pollutant. The data for each
pollutant is reported by site and monitoring information, with the report
itself ordered by pollutant code.
The report consists of nine formats. E.ach of the pollutants requires one
or more of these report formats, depending on the statistical data produced
for it.
Three programs make up the standards report package: the standards
retrieval program, ARTSTDS (AQ0400); the standards statistical analysis
program, ASTSTDS (AQ0410); and the standards report program, ARPSTDS (AQ0420).
A system flowchart of the standards report package is shown in Figure
6.6.1-a.
ARTSTDS (AQ0400) retrieves data from the AQDHS-II master, parameter, and
sorted site files and creates two temporary files: a FORTRAN-compatible data
file to be passed to ASTSTDS (AQ0410) and a site data file to be passed to
ARPSTDS'(AQ0420). The option card read by ARTSTDS (AQ0400) specifies the
years for which a standards report is to be produced.
ASTSTDS (AQ0410) reads the temporary data file passed from ARTSTDS
(AQ0400), performs the statistical analyses, and produces a temporary
statistics file, which is passed to ARPSTDS (AQ0420).
629.95
-------
AQDHS-II
REPORTS
SECTION 6.6.1
STANDARDS REPORT
INTRODUCTION
Page: 2
Release Date: 10/31/81
Update #: 29
ARPSTDS (AQ0420) reads the temporary statistics file passed from ASTSTDS
(AQ0410) and generates a formatted report of the statistical data. The option
card read by ARPSTDS (AQ0420) specifies a run date to be printed on the
report.
Refer to the following sections for a detailed discussion of each of the
programs used to produce the standards report: ARTSTDS (AQ0400), Section
6.6.2; ASTSTDS (AQ0410), Section 6.6.3; and ARPSTDS (AQ0420), Section 6.6.4.
The standards report is produced by executing the cataloged procedure
AQRPM60. Refer to Section 6.6.4.5 for a detailed discussion of AQRPM60 and a
sample run stream.
629.96
-------
AQDHS-II
REPORTS
SECTION 6.6.1
STANDARDS REPORT
INTRODUCTION
Page: 3
Release Date: 10/31/81
Update #: 29
AQDHS-11
MASTER
FILE
AQDHS-II
PARAMETER
FILE
AQDHS-II
SORTED
SITE FILE
/OPTION CARD
SPECIFYING
REPORT YEARS
ARTSTDS (AQ0400)
STANDARDS RETRIEVAL PROGRAM
(DATA7
F.LE
(Temporary)\
SITE DATA /
FILE i
(Temporary)
DIAGNOSTIC
REPORT
•ASTSTDS (AQ0410)
STANDARDS STATISTICAL
ANALYSIS PROGRAM
STATISTICS /
FILE I
L( Temporary) \
DIAGNOSTIC
REPORT
(Page 1 of 2)
Figure 6.6.1-a. Standards Report System Flowchart
629.97
-------
AQDHS-II
REPORTS
SECTION 6.6.1
STANDARDS REPORT
INTRODUCTION
Page: 4
Release Date: 10/31/81
Update #: 29
0 0
AQDHS-11
PARAMETER
FILE
OPTION CARD
(Optional)
ARPSTDS (AQ0420)
STANDARDS REPORT PROGRAM
STANDARDS
REPORT
DIAGNOSTIC/
REPORT I
(Page 2 of 2)
Figure 6.6.1-a - continued. Standards Report System Flowchart
629.98
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: ;'l
Release Date: 10/31/81
Update #: 29
6.6.2 Standards Retrieval Program - ARTSTDS (AQ0400)
6.6.2.1 Description
ARTSTDS (AQ0400) is the first of .three programs used to produce the
AQDHS-II standards report- The standards statistical analysis program,
ASTSTDS (AQ0410), and the standards report program, ARPSTDS (AQ0420), must be
executed after ARTSTDS (AQ0400) to,.produce the report.
ARTSTDS (AQ0400) reads the AQDHS-II master, parameter,.and sorted site
files and retrieves .data for user-specified years for five criteria pollutants
in the categories listed in Figure 6.6.2-a. The retrieved data is reformatted
and sorted, producing two temporary files: a FORTRAN-compatihle file
containing master and parameter file data, which is passed to 'ASTSTDS
(AQ0410), and a file containing site .file.data,--.which is passed to ARPSTDS
(AQ0420).
6.6.2.2 File Formats
ARTSTDS (AQ0400) uses four input files: the AQDHS-II master file, the
AQDHS-II parameter file, the AQDHS-II sorted site file, and ,an option card.
See Figure 4.5.3-a for the master file format,. Figure 4.2.2-c for the
parameter file format, Figure 5.6.3-a for the sorted site file format, and
Section 6.6.2.3 for a discussion of .the option card.
Three output files are produced by ARTSTDS (AQ0400): a temporary data
file, a temporary site data file, and a diagnostic report.
The temporary data file, which is passed to ASTSTDS (AQ0410)., is
FORTRAN-compatible since ASTSTDS (AQ0400) -is coded in FORTRAN. It consists of
fixed-length records of 120 characters and conta-ins the requested years'
629.99
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 2
Release Date: 10/31/81
Update #: 29
readings from the input master file for the criteria pollutants. Each record
in this file also contains the minimum detectable reading and the standard
units conversion factor, as contained in the input parameter file, for the
parameter/method/units code of the readings in the record. The file is sorted
by parameter, site, year, time code, month, and day.
The temporary site data file, which is passed to ARPSTDS (AQ0420), is a
standard COBOL file consisting of fixed-length records of 227 characters. It
contains selected site file data for each parameter/method/site combination in
the temporary data file. This file is sorted by parameter and site.
Both temporary files contain header records; the temporary data file also
contains a trailer record.
The diagnostic report consists of update messages, program statistics,
and error messages. It also lists the options in effect. See Figure 6.6.2-b
for a sample diagnostic report.
6.6.2.3 Options
The user must enter an option card specifying the option dates. These
dates are two-digit numbers.representing the first year and the last year for
which a standards report is to be generated. The option dates must be numeric
and must appear in columns 1 and 2 and columns 4 and 5, respectively, of the
option card. If either option date is not numeric, if the second date is less
than the first, or if no option card is submitted, an error message will be
printed and program execution will be terminated. Note that if a report for
only one year is desired, that year must be specified for both the first and
the 1ast option date.
The user can also specify a warning message suppression option. Warning
messages will be printed in the diagnostic report if 'FLAGW is specified;
they will be suppressed if 'NOFLAGW is coded or if this option is omitted.
629.100
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 3 •'.-
Release Date: 10/31/81
Update #: 29
For the format of the option card, see Figure 6.6.2-c.
6.6.2.4 Error Messages
ARTSTDS 001 ABORT - MASTER FILE CONTAINS NO RECORDS
Meaning: There are no records in the input master file; therefore, the
run was terminated.
Action: Review the JCL to determine whether or not a valid master file
was specified; if not, correct the JCL and resubmit the run.
ARTSTDS 002 CONDITIONAL - FORTRAN FILE CONTAINS ONLY HEADER AND TRAILER
RECORDS
Meaning: No data was retrieved from the master file; therefore, the
temporary data file contains no records.
Action: Determine whether or not the program produced an abort
message; if so, correct the error and resubmit the run. If
there is no abort message, verify that the master file contains
data that should have been retrieved; if so, verify that the
parameter file contains matching records for all the
parameter/method/units codes that would have been retrieved.
If the parameter file doesn't contain the necessary records,
update it and resubmit the run.
ARTSTDS 003 ABORT - PARAMETER TABLE OVERFLOW
Meaning: ARTSTDS (AQ0400) has been incorrectly modified: the maximum
number of parameters specified in the program is larger than
the size- of the parameter array; therefore, the run was
terminated.
Action: See Appendix C for instructions on correctly increasing the
size of the array.
629.101
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 4
Release Date: 10/31/81
Update #: 29
ARTSTDS 004 ABORT - NUMBER OF PARM FILE RECORDS EXCEEDS MAXIMUM ALLOWED
Meaning: The input parameter file contains more records than can be
stored in the parameter array; therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the size of the
array.
ARTSTDS 005 ABORT - INVALID TIME PERIOD SPECIFIED
Meaning: A non-numeric value was specified for one or both of the option
dates, the second option date is less than the first, or no
option date was specified; therefore, the run was terminated.
Action: Specify valid option dates and resubmit the run.
ARTSTDS 006 WARNING - NO MATCHING SITE RECORD FOR MASTER FILE RECORD [record
key]
Meaning: The input site file does not contain a record to match the
retrieved master file record whose key is printed in this
message. A dummy record was created for this record in the
temporary site data file; it contains only the key information.
Action: If the descriptive site information is desired, update the
site file and resubmit the run.
ARTSTDS 007 WARNING - SITE RECORD XXXXXXXXXXXX HAS NO DATA FOR PARAMETER/
METHOD YYYYYZZ
Meaning: The input site file record whose key is XXXXXXXXXXXX matches a
retrieved master file record but has no data for the parameter/
method code YYYYYZZ, which is the parameter/method code of the
master file record. A dummy record was created for this record
in the temporary site data file; it contains only the key
information.
Action: If the descriptive site information is desired, update the site
file and resubmit the run.
629.102
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 5-- ' •
Release Date: 10/31/81
Update #: 29
ARTSTDS 008 CONDITIONAL - MASTER-SITE FILE CONTAINS ONLY HEADER RECORD
Meaning: No data was retrieved from the master file; therefore, the
temporary site-data file contains no records.
Action: See error message ARTSTDS 002.
ARTSTDS 009 CONDITIONAL - MISSING OR INVALID FLAGW OPTION - NOFLAGW ASSUMED
Meaning: An invalid warning suppression option, or no warning
suppression option, was specified; therefore, the default
option, NOFLAGW, was assumed.
Action: If any warning messages were produced and a listing of them is
desired, correct the option card and resubmit the run.
ARTSTDS 010 ERROR - NO MATCHING PARM RECORD FOR MASTER RECORD [record key] -
DATA IGNORED
Meaning: The input parameter file does not contain a record to match the
master file record whose key is printed in this message;
therefore, the master file record was not retrieved.
Action: To insure that an accurate and complete .standards report is
produced, update the parameter file and resubmit the run.
ARTSTDS Oil ABORT - NO OPTION CARD
Meaning: No option card was included in the runstream; therefore, the
run was terminated.
Action: Include a valid option card and resubmit the run.
6.6.2.5 Cataloged JGL
ARTSTDS (AQ0400) must always be executed in conjunction .with ASTSTDS
(AQ0410) and ARPSTDS (AQ0420). See Section 6.6.4.5 for a discussion of the
cataloged procedure AQRPM60, which.executes all three programs.
629.103
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 6
Release Date: 10/31/81
Update #: 29
6.6.2.6 Warnings and Special Instructions
In order for ARTSTDS (AQ0400) to retrieve all the.data necessary for a
complete and accurate standards report, the parameter and site files must
contain records to match the master file records. If there is no record in
the parameter file to natch a retrieved master file record, the master file
record is bypassed and its data is not included in the statistical analyses
performed by ASTSTDS (AQ0410) and is not included in the report produced by
ARPSTDS (AQ0420). Also, the readings in a retrieved master file record are
converted.to standard units by using the standard units conversion factor from
the matching parameter file record; thus, it is imperative that the standard
units conversion .factors in the parameter file be correct.
If there is no record in the site file to match a retrieved master file
record, or if there is a matching site file record which does not contain the
necessary parameter/method information, the master file record will still be
retrieved, but the report produced by ARPSTDS (AQ0420) will lack the
descriptive information for that site.
Execution of ARPPARM (AQ0240) and ARPSITE (AQ0260) will permit
verification of entries in the parameter and site files, respectively.
Note that the COBOL sort verb is used in this program; therefore, the
collating sequence for alphanumeric fields is determined by the computer at
the user's particular installation.
In addition to the diagnostic report produced by ARTSTDS (AQ0400),
messages generated by the sort-merge package will be printed. The format and
content, as well as the physical location, of these messages depend upon the
user's particular installation.
629.104
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 7 7
Release Date: 10/31/81
Update #: 29
6.6.2.7 Cost Considerations
The following estimates are for the execution of ARTSTDS (AQ0400) on an
IBM 370/168:
Size of master file: 2,117 records
Size of parameter file: 84 records
Size of site file: 11 records
Size of temporary data file: 7,736 records
Size of temporary site file: 19 records
CPU time: . 12.38 seconds
I/O time: 13.00 seconds
Total time: 25.38 seconds
Estimated cost: $5.48
6.6.2.8 Related Programs and Procedures.
ARTSTDS (AQ0400) must always be executed in conjunction with ASTSTDS
(AQ0410) and ARPSTDS (AQ0420). The cataloged procedure AQRPM60 executes all
three programs.
629.105
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 8
Release Date: 10/31/81
Update #: 29
Parameter Sampling AQDHS-II
Pollutant Code Interval(s) Time Code(s)
Total Suspended
Particulate (TSP)
Lead (Pb)
Carbon Monoxide (CO)
Sulfur Dioxide (S02)
Nitrogen Dioxide (N02)
11101
Daily
12128
42101
42401
42602
Daily
Hourly
Hourly
Daily
Hourly
Daily
8
1
1
8
1
8
Figure 6.6.2-a. Categories of Data Retrieved by ARTSTDS (AQ0400)
629.106
-------
CTl
r\>
•
i — •
o
-vl
Tl
U3
c
m
?^
CTl
INJ
I
?"
C3
DJ
in
3
o
to
c~f
— '•
O
TO
fD
-O
0
-s
r*
PROGRAM NAME: ARTSTDS (AQ0400)
REVISION LEVEL: 1-00
LAST UPDATE »: 29
DATE INCORPORATED: OCTOBER 31,
AQDHS-II STANDARDS RETRIEVAL PROGRAM - DIAGNOSTIC REPORT PAGE 1
1981
OPTIONS IN EFFECT: YEAR = 1960 THROUGH 1985 NOFLAGW
NUMBER OF MASTER FILE RECORDS
READ: 2,117
NUMBER OF PARAMETER FILE RECORDS READ: 8
—1
CO
— 1
O
co
^— ^
^>
JO
o
0
. o
cr
T3
CL
o>
<-••
rt>
=
—^
to
01
CO
a
OP
?.
i— >
o
co
i — »
oo
^
•g
T"
CO
1
I— (
t— 4
CO
m
o
—i
CD
Z
CTl
cn
ro
-o
Ol
tn
(V
• •
VO
-------
AQDHS-II
REPORTS
SECTION 6.6.2
STANDARDS RETRIEVAL
PROGRAM ARTSTDS (AQ0400)
Page: 10
Release Date: 10/31/81
Update #: 29
Column #1 Column #4 Column #7
I I I
Yl
Y2
TFLAGW
[NOFLAGW
The options are subject to the following restrictions:
1. The option date Yl must be specified in columns 1-2; it must be
numeric.
2. The option date Y2 must be specified in columns 4-5; it must be numeric
and greater than or equal to the option date Yl.
3. The warning suppression option can be left blank or specified beginning
in column 7.
Figure 6.6.2-c. Option Card Format for ARTSTDS (AQ0400)
629.108
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
>ROGRAM ASTSTDS (AQ0410)
Page: 1
Release Date: 10/31/81
Update #: 29
6.6.3 Standards Statistical Analysis Program'- ASTSTDS (AQ0410)
6.6.3.1 Description
. ASTSTDS (AQ0410). is executed after the standards retrieval program,
ARTSTDS (AQ0400), arid before the standards report program, ARPSTDS (AQ0420).
ASTSTDS (AQ0410) reads the temporary data file produced.by ARTSTDS (AQ0400),
performs-various statistical1 analyses, and produces .a temporary statistics
file, which is passed to ARPSTDS (AQ0420)<. ASTSTDS (AQ0410) is coded in ANSI
FORTRAN using a modtiTar, top-down coding- technique.
The input file is a temporary data file consisting of raw data for the
requested years and five criteria pollutants'. The: pollutants which are
currently recognized by ASTSTDS (AQ0410-) are total suspended particulate
(11101), lead (12128), carbon monoxide (42101), sulfur dioxide (42401), and
nitrogen dioxide (42'602).
The data in' the temporary data file has been sorted by parameter and site
key. Separate analyses are performed for each pollutant; these analyses are
discussed below.
Total Suspended Particulate (TSP)
The following statistics are calculated for total suspended particulate
daily data:
. th'e number of non^-null observations in each month
. the maximum observation in each month
. the geometric mean of the observations during each month
. the number of non-null observations in the year
. the percent of days during the year with non-null observations
. the geometric mean of the observations during the year
. the geometric standard deviation of the observations during the
year
629.109
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
'ROGRAM ASTSTDS (AQ0410)
Page: 2
Release Date: 10/31/81
Update #: 29
the number of observations during the year which exceeded the
primary standard
the number of observations during the year which exceeded the
secondary standard
Lead (Pb)
The following statistics are calculated for lead daily data on a monthly
basis:
. the number of non-null observations in each quarter
. the maximum observation in each quarter
. the arithmetic mean of the observations during each quarter
. the number of days during the year with non-null observations
. the percent of days during the year with non-null observations
. the number of quarterly means which exceeded the primary standard
Carbon Monoxide (CO)
The following statistics are calculated for carbon monoxide hourly data
on a monthly basis:
. the number of non-null observations during each day
. the arithmetic mean of the observations during each day
. the number of non-null observations for each hour of the day
during the month
. the maximum of the observations for each hour of the day
during the month
. the mean of the observations for each hour of the day during the
month
. the number of hours during the month with non-null observations
. the percent of hours during the month with non-null observations
. the arithmetic mean of the observations during the month
. the standard deviation of the observations during the month
. the number of observations which exceeded the primary standard
629.110
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
PROGRAM ASTSTDS (AQ0410)
Page: 3r
Release Date: 10/31/81
Update #: 29
The following statistics are calculated for the daily maxima of the •
carbon monoxide hourly data on an annual basis:
. the number of days with non-null data in each month
. the maximum observation during each month
. the arithmetic mean of the daily maxima during each month
. the number of days during the year with non-null data
. the percent of days during the year with non-null data
. the arithmetic mean of the daily maxima during the year
. the standard deviation of the daily maxima during the year
. the number of daily maxima which exceeded the primary standard
The following statistics a.r.e calculated for the the 8-hour sliding
averages of the carbon monoxide hourly data on a monthly basi.s::
. the number of non-null averages during the day
. the maximum of the averages during the day
. the number of non.-null averages for each hour of the.day during
the month
. the maximum of the averages for each hour of the day during the
month
. the number of non-null averages during the month
. the percent of hours during the month with non-null averages
. the number of averages during the month which exceeded the primary
standard
. the number of non-overlapping averages during the month which
exceeded the primary standard
The following statistics are calculated for the daily maxima of the 8-
hour sliding averages of carbon monoxide hourly data on an annual basis:
. the number of days with non-null averages in each month
. the maximum average during each month
629.111
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
'ROGRAM ASTSTDS (AQ0410)
Page: 4
Release Date: 10/31/81
Update #: 29
. the number of hours during the year with non-null averages
. the percent of hours during the year with non-null averages
. the number of days on which an average exceeded the primary
standard
. the number of non-overlapping averages which were also daily
maxima and exceeded the primary standard
Sulfur Dioxide ($02)
The following statistics are calculated for sulfur dioxide hourly data on
a monthly basis:
. the number of non-null observations during each day
. the arithmetic mean of the observations during each day
. the number of non-null observations for each hour of the day
during the month
. the maximum of the observations for each hour of the day during
the month
. the arithmetic mean of the observations for each hour of the day
during the month
. the number of hours during the month with non-null observations
. the percent of hours during the month with non-null observations
. the arithmetic mean of the observations during the month
. the standard deviation of observations during the month
The following statistics are calculated for the daily maxima of the
sulfur dioxide daily data on an annual basis:
. the n'umber of days in each month with non-null data
. the maximum observation in each month
. the arithmetic mean of the daily maxima for each month
. the number of days during the year with non-null data
. the percent of the days during the year with non-null data
629.112
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
>ROGRAM ASTSTDS (AQ0410)
Page:- 51 . "
Release Date: 10/31/81
Update #: 29
. the arithmetic mean of the daily maxima during ttie year
. the standard deviation of the daily maxima during the year
The following statistics are calculated for the 3-hour sliding averages
of the. sulfur dioxide 'hourly data on a monthly basis:
. the number of non-null averages during each day
. . the maximum average during each day
. the number of non-null averages for each hour of the day during
the month
. the maximum average for each hour of the day during the month
. the number of non-null averages during the month
. the percent of hours during the month with non-null averages
. the number of averages during the month .which exceeded the
secondary standard
. the number of non-overlapping averages during the month which
exceeded the secondary standard
The following statistics are calculated for the daily maxima of the 3-
hour sliding averages on an annual basis:
. the number of days with non-null averages in each month
. the maximum.of the averages during each month
. the number of hours during the -year with non-null averages
. the percent of hours during the year with non-null averages
. the number of days on which an average exceeded the secondary
standard
. the number of non-overlapping averages which were also daily
maxima and.exceeded the secondary standard
629.. 113
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
PROGRAM ASTSTDS (AQ0410)
Page: 6
Release Date: 10/31/81
Update #: 29
The following statistics are calculated for the 24-hour sliding averages
of the sulfur dioxide hourly data on a monthly basis:
. the number of non-null averages during each day
. the maximum of the averages during each day
. the number of non-null averages for each hour of the day during
the month
. the maximum of the averages for each hour of the day during the
month
. the number of non-null averages during the month
. the percent of hours during the month with non-null averages
. the number of averages during the month which exceeded the primary
standard
. the number of non-overlapping averages during the month which
exceeded the primary standard
The following statistics are calculated for the daily maxima of the
24-hour sliding averages on an annual basis:
. the number of days with non-null averages in each month
. the maximum average during each month
. the number of hours during the year with non-null averages
. the percent of hours during the year with non-null averages
. the number of days on which an average exceeded the primary
standard
. the number of non-overlapping averages which were also daily
maxima and exceeded the primary standard
The following statistics are calculated for sulfur dioxide daily data on
an annual basis:
. the number of non-null observations in each month
. the maximum observation in each month
629.114
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
PROGRAM ASTSTDS (AQ0410)
Page: 7
Release Date: 10/31/81
Update #: 29
. the arithmetic mean of the observations during each month
. the number of days during the year with non-null observations
. the percent of days during the year with non-null observations
. the arithmetic mean of the observations during the year
. the standard deviation of the observations during the year
Nitrogen Dioxide (N02)
The following statistics are calculated for nitrogen dioxide hourly data
on a monthly basis:
. the number of non-null observations during each day
. the maximum of the observations during each day
. the number of non-null observations for each hour of the day
during the month
. the maximum of*the observations for each hour of the day during
the month
. the arithmetic mean of the observations for each hour of the day
during the month
. the number of hours during the month with non-null observations
. the percent of hours during the month with non-null observations
. the arithmetic mean of the observations during the month
. the standard deviation of the observations during the month
. the number of observations during the month which exceeded the
primary standard
The following statistics are calculated for the daily maxima of nitrogen
dioxide hourly data on an annual basis:
. the number of days in each month with non-null data
. the maximum observation in each month
629.115
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
>ROGRAM ASTSTDS (AQ0410)
Page: 8
Release Date: 10/31/81
Update #: 29
. the arithmetic mean of the daily maxima for each month
. the number of days during the year with non-null data
. the percent of days during the year with non-null data
. the arithmetic mean of the daily maxima during the year
. the standard deviation of the daily maxima during the year
The following statistics are calculated for nitrogen dioxide daily data
on an annual basis:
. the number of non-null observations in each month
. the maximum observations in each.month
. the arithmetic mean of the observations during each month
. the number of non-null observations in the year
. the percent of days during the year with non-null observations
. the arithmetic mean of the observations during the year
. the standard deviation of the observations during the year
6.6.3.2 File Formats
Input to this program consists of a temporary data file passed from
ARTSTDS (AQ0400). See Section 6.6.2.2 for additional information on this
file. Output consists of a diagnostic report (see Figure 6.6.3-a) and a
temporary file passed to ARPSTDS (AQ0420). This temporary file is referred to
as a standards statistics file and contains the statistics computed by ASTSTDS
(AQ0410).
6.6.3.3 Options
There are no options for this program.
629.116
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
PROGRAM ASTSTDS (AQ0410)
Page: 9
Release Date: 10/31/81
Update #: 29
6.6.3.4 Error Messages
ASTSTDS 001 ABORT - INPUT FILE HAS NO DATA
Meaning: The temporary data file contains only a header and a trailer
record; therefore, program execution was terminated.
Action: Insure that ARTSTDS (AQ0400) has retrieved a usable temporary
data file.
ASTSTDS 002 DISASTER - MONTH XX IS INVALID
INPUT REC: [record]
Meaning: The month field of the input record is non-numeric or contains
a number greater than 12 or less than 1. The entire input
record is shown on the sec'ond line of the message. Program
execution was terminated*,
Action: Contact personnel at the National Air Data Branch for
assistance.
ASTSTDS 003 DISASTER - UNEXPECTED POLLUTANT CODE XXXXX
INPUT REC: [record]
Meaning: The pollutant field of the input record contains an
unrecognized (not TSP, Pb, CO, S02, or N02) or out of
sequence pollutant code. The entire input record is shown on
the second line of the .message. Program execution was
terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ASTSTDS 004 DISASTER - TIME CODE SHOULD BE 8, NOT X
INPUT REC: [record]
Meaning: The time code of input records for this pollutant should be
eight. The value in the record, indicated here by X, is shown.
The entire input record is shown on the second line of the
message. Program execution was terminated.
629.117
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
PROGRAM ASTSTDS (AQ0410)
Page: 10
Release Date: 10/31/81
Update #: 29
Action: Contact personnel at the National Air Data Branch for
assistance.
ASTSTDS 005 DISASTER - MISSING RECORD FOR [codes]
INPUT REC: [record]
Meaning: The program was expecting a record with the pollutant-method-
state-county- area- site- agency-project-year- time-month-day codes
and sequence number shown on the first line of the message, but
found the record shown on the second line. Program execution
was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ASTSTDS 006 DISASTER - NUMBER OF READINGS X GREATER THAN 8
INPUT REC: [record]
Meaning: The field of the input record which is supposed to show the
number of readings in the record contains a number, indicated
here by X, greater than 8, although there is not room for more
than eight readings in the record. The entire input record is
shown on the second line of the message. Program execution was
terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ASTSTDS 007 DISASTER - TIME CODE SHOULD BE 1, NOT X
INPUT REC: [record]
Meaning: The time code of input records for this pollutant should be
one. The value in the record, indicated here by X, is shown.
The entire input record is shown on the next line. Program
execution was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
629.118
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
'ROGRAM ASTSTDS (AQ0410)
Page: 11
Release Date: 10/31/81
Update #: 29
ASTSTDS 008 DISASTER - DAY XX IS INVALID .
INPUT REC: [record] .
Meaning: The day field of the input record is non-numeric or contains
a number greater than 31 or less than 1. The entire input
record is shown on the second line of the message. Program
execution was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ASTSTDS 009 DISASTER - NEGATIVE READING INPUT REC: [record]
Meaning: The input record contains a negative value in a reading field.
The entire input record is shown on the second line of the
message. Program execution was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
6.6.3.5 Cataloged JCL
ASTSTDS (AQ0410) must always be executed in. conjunction with ARTSTDS
(AQ0400) and ARPSTDS (AQ0420). The cataloged procedure AQRPM60 will execute
all three programs. This procedure is discussed in Section 6.6.4.5.
6.6.3.6 Warnings and Special Instructions
This program should always be run in conjunction with ARTSTDS (AQ0400)
and ARPSTDS (AQ0420) to insure that a proper report will be produced.
629.119
-------
AQDHS-II
REPORTS
SECTION 6.6.3
STANDARD STAT. ANALYSIS
>ROGRAM ASTSTDS (AQ0410)
Page: 12
Release Date: 10/31/81
Update #: 29
6.6.3.7 Cost Considerations
The following example provides an estimate of the cost of executing
ASTSTDS (AQ0410) on an IBM 370/168.
Size of temporary data file:
Size of temporary statistics file:
CPU time:
I/O time:
Total time:
Estimated Cost:
6.6.3.8 Related Programs and Procedures
7,736 records
16,297 records
42.60 seconds
3.21 seconds
45.81 seconds
$17.34
ASTSTUS (AQ0410) must be executed in conjunction with ARTSTUS (AQ0400)
and ARPSTDS (AQ0420). See Section 6.6.2 for a discussion of ARTSTDS (AQ0400)
and Section 6.6.4 for a discussion of ARPSTDS (AQ0420).
629.120
-------
PROGRAM NAME: ASTSTDS (AQ0410)
REVISION LEVEL: 1-00
LAST UPDATE «: 29
DATE INCORPORATED: 10/31/81.
NUMBER OF TSP READINGS PROCESSED: 851
NUMBER OF LEAD READINGS PROCESSED: 908
NUMBER OF CO READINGS PROCESSED: 24636
NUMBER OF HOURLY SC2 READINGS PROCESSED: 13199
NUMBER OF DAILY S02 READINGS PROCESSED:, 66
NUMBER OF HOURLY N02 READINGS PROCESSED: 16161
NUMBER OF DAILY N02 READINGS PROCESSED:, 628
TOTAL NUMBER OF OUTPUT RECORDS: 16297
Oi
ro
vo
ro
-5
ID
C-i
•
CTl
•
CO
I
OJ
o
en
O
TD
O
73 >
m jO
-o o
o :c
73 (/)
—I I
GO •—'
73
O
O
CO CO
CO CO
co
o -<
4* CO
O CO
CTl
CO
r JQ "^
~O fD DJ
Q. —' tra
OJ fD fD
r+ Oi
=«:
(D
a co
O)
r\i CD
o
co
>—'
oo
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 1
Release Date: 10/31/81
Update #: 29
6.6.4 STANDARDS REPORT PROGRAM - ARPSTDS (AQ0420)
6.6.4.1 Description
ARPSTDS (AQ0420) is the last of three programs used to produce the
AQDHS-II standards report. It generates a formatted report of the statistical
data output from the standards statistical analysis program, ASTSTDS (AQ0410).
See Section 6.6.3 for a discussion of ASTSTDS (AQ0410).
The standards report contains statistical data for five criteria
pollutants: total suspended particulate (11101), lead (12128), carbon
monoxide (42101), sulfur dioxide (42401), and nitrogen dioxide (42602). There
are nine different types of report formats to handle the following nine types
of statistical data passed to ARPSTDS (AQ0420) by ASTSTDS (AQ0410):
1. One-hour values
2. One-hour maximums
3. Three-hour running averages
4. Maximum of three-hour running averages
5. Eight-hour running averages
6. Maximum of eight-hour running averages
7. Twenty-four-hour running averages
8. Maximum of twenty-four-hour running averages
9. Daily values
Each of the pollutants requires one or more of these report formats, depending
on the statistical data produced for it. See Section 6.6.3 for a listing of
the statistical data produced for each pollutant.
The standards report is organized so that the data for each parameter/
method combination is reported by state, county, area, site, agency, project,
year, and units. When there is more than one type of statistical data for a
629.122
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 2 ! ; 2
Release Date: 10/31/81
Update #: 29
parameter/method/site combination, the different types of statistical data
will be reported in the appropriate formats. The different report formats are
printed in the order in which the types of statistics are listed above. For
.example, the statistical data for the pollutant nitrogen dioxide (42602) may
contain one-hour values, -one-hour maximums, and daily values; for a given
site, all the one-hour values would be reported first, followed by the
one-hour maximums, followed by the daily values.
Each report page contains either one month (hourly data) or one year
(daily data) of a particular type of statistical data for a criteria pollutant
measured at a given site. The information for the report headings is obtained
from the temporary site data file and the parameter file. Figure 6.6.4-a
contains samples of the possible report formats generated for each of the five
pollutants.
The diagnostic report contains counts of the input files, the number of
pollutants in the report, the total number of report pages, and the number of
aborts, disasters, and warnings detected. This report also contains the
program update messages and any diagnostic messages generated during the run.
See Figure 6.6.4-b for a sample diagnostic report.
6.6.4.2 File Formats
Input to ARPSTDS (AQ0420) consists of the temporary statistics file
passed from ASTSTDS (AQ0410), the corresponding temporary site data file
passed from ARTSTDS (AQ0400), the AQDHS-II parameter file, and an option .card.
See Section 6.6.3.2 for a description of the statistics file formats, Section
6.6.2.2 for a description of the site data file format, and Figure 4.4.2-c for
a description of the parameter file. See Section 6.6.4.3 for a discussion of
the option card.
Output from the program consists of the standards report (see Figure
6.6.4-a) and the diagnostic report (see Figure 6.6.4-b).
W9..123
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 3
Release Date: 10/31/81
Update #: 29
6.6.4.3 Options
The option card for ARPSTDS (AQ0420) allows the user to enter a run date
to be printed on the report. The date should be entered in columns 1 through
18 of the option card. If the option card is not present in the run stream,
or if a date is not specified in the correct columns, a warning message will
be printed and no run date will appear in the standards report. See Figure
6.6.4-c for a description of the option card.
An alternative method of obtaining a run date is coded in the program for
computers that have the ACCEPT command capability. This capability allows the
program to retrieve the date directly from the computer, thereby making it
unneccesary for the user to enter an option card in the run stream. See
Section 6.6.4.6 for instructions on implementing this capability.
6.6.4.4 Error Messages
ARPSTDS 001 WARNING - NO OPTION CARD PRESENT OR NO DATE SPECIFIED ON CARD,
NO DATE FOR REPORT
Meaning: There was no option card in the run stream, or the option card
did not have a date specified in the correct columns.
Action: If a run date is desired on the report, enter an option card
with the current date and resubmit the job.
ARPSTDS 002 DISASTER - STATISTICS RECORD KEY DOES NOT MATCH SITE RECORD KEY
Meaning: A matching site data record was not found for the statistics
record being processed; therefore, the run was terminated.
Action: If ARTSTDS (AQ0400) and ASTSTDS (AQ0410) ran successfully,
contact personnel at the National Air Data Branch for
assistance.
629.124
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 4
Release Date: 10/31/81
Update #: 29
ARPSTDS 003 ABORT - STATISTICS FILE OR SITE DATA FILE CONTAINS NO DATA
Meaning: Either the statistics file passed from ASTSTDS (AQ0410) or the
site data file passed from ARTSTDS (AQ0400) contains no
records; therefore, the run was terminated.
Action: Check the diagnostic reports from ARTSTDS (AQ04QO) and ASTSTDS
(AQ0410) to Insure that records were written to both the
statistics file and the site data file.
ARPSTDS 004 ABORT - HEADER RECORDS OF STATISTICS FILE AND SITE DATA FILE DO
NOT MATCH
Meaning: The header records of the input statistics file and site data
file were not created during the same execution of ARTSTDS
(AQ0400).
Action: Make sure that the temporary data file and site data file
created by ARTSTDS (AQ0400) were used by ASTSTDS (AQ0410) and
ARPSTUS (AQ0420); and that the temporary statistics file
created by ASTSTUS (AQ0410) was used by AKPSTDS (AQU420).
ARPSTDS 005 DISASTER - INVALID YEAR, MONTH, OR DAY SPECIFIED, CALL NADB
Meaning: The input statistics record contains an invalid date;
therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSTDS 006 ABORT - PARM TABLE OVERFLOW. CONSULT USERS GUIDE FOR CORRECTIVE
ACTION
Meaning: The number of records in the input parameter file exceeds the
limit of 200 imposed by the parameter table size in the
program. Therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the allowed table
size.
629.125
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 5
Release Date: 10/31/81
Update #: 29
ARPSTDS 007 ABORT - LEVEL 77 DATA FIELD "NBR OF PARMS" INCREASED BEYOND
PARM-TABLE SIZE
Meaning: ARPSTDS (AQ0420) has been incorrectly modified to increase the
parameter table; therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
ARPSTDS 008 DISASTER - PREMATURE END OF STATISTICS FILE, CALL NADB
Meaning: An end-of-file condition has been detected for the statistics
file while processing data for a particular pollutant, site,
and time code combination; the run was terminated.
Action: If ARTSTUS (AQ0400) and ASTSTDS (AQ0410) ran successfully,
contact personnel at the National Air Data Branch for
assistance.
ARPSTDS 009 DISASTER - NO MATCHING PARAMETER FILE RECORD, CALL NADB
Meaning: No parameter/methoci/unit information to match the parameter/
method/unit of the statistics record was found in the parameter
file; therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSTDS 010 DISASTER - NEW STATISTICS RECORD KEY NOT EXPECTED, CALL NADB
Meaning: The site or date information of the statistics record has
changed while processing data for a particular pollutant, site,
and time code combination; the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSTDS Oil DISASTER - EXPECTING RECORD TYPE 1, BUT TYPE 1 NOT PRESENT
Meaning: ARPSTDS (AQ0420) is expecting to process a statistics record
with a record type of 1; however, the statistics record has a
record type of 2 or 3. Therefore, the run was terminated.
629.126
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 6
Release Date: 10/31/81
Update #: 29
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSTDS 012 DISASTER - EXPECTING RECORD TYPE 2, BUT TYPE 2 NOT PRESENT
Meaning: ARPSTDS (AQ0420) is expecting to process a statistics record
with a record type of 2;.however, the statistics record has a
record type of 1 or 3. Therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSTDS 013 DISASTER - EXPECTING RECORD TYPE 3, BUT TYPE 3 NOT PRESENT
Meaning: ARPSTDS (AQ0420) is expecting to process a statistics record
with a record type of 3; however, the statistics'record has a
record type of 1 or 2. Therefore, the run was terminated.
Action: Contact personnel at the National Air Data Branch for
assistance.
ARPSTDS 014 ABORT - HEADER RECORD NOT PRESENT
Meaning: The statistics file passed from ASTSTDS (AQ0410) and/or the
site data file passed from ARTSTDS (AQ0400) have no header
records; therefore, the run was terminated.
Action: If ARTSTDS (AQ0400) and ASTSTDS (AQ0410) ran successfully,
contact personnel at the National Air Data Branch for
assistance.
6.6.4.5 Cataloged JCL
ARPSTDS. (AQ0420) must always be executed in conjunction with ARTSTDS
(AQ0400) and ASTSTDS (AQ0410). The JCL presented in this section is used to
execute all three programs.
629.127
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 7
Release Date: 10/31/81
Update #: 29
6.6.4.5.1 JCL listing - The standards report can be produced by executing the
cataloged procedure AQRPM60. This procedure executes ARTSTDS (AQ0400), the
standards retrieval program; ASTSTDS (AQ0410), the standards statistical
analysis program; and ARPSTDS (AQ0420), the standards report program. See
Figure 6.6.4-d for a listing of this procedure.
6.6.4.5.2 Cross-reference of DD names and files
Program Name: ARTSTDS (AQ0400)
DD Name File Description
AQSMASTR
AQSPARMC
AQSTESRT
AQSOPTIN
SORTWK01
AQSFRTRN
AQSMSSTE
AQSPRINT
AQDHS-II master file
AQDHS-II parameter file
AQDHS-II sorted site file
Option card
Sort work file
Temporary data file passed
to ASTSTDS (AQ0410)
Temporary site data file
passed to ARPSTDS (AQ0420)
Diagnostic report
Program Name: ASTSTDS (AQ0410)
DD Name File Description
FT08F001
FT09F001
FT06F001
Temporary file received
from ARTSTDS (AQ0400)
Temporary statistics file
passed to ARPSTDS (AQ0420)
Diagnostic report
Input/Output
Input
Input
Input
Input
Internal
Output
Output
Output
Input/Output
Input
Output
Output
629.128
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 8
Release Date: 10/31/81
Update #: 29
Program Name: ARPSTDS (AQ0420)
DP Name
AQSFSTAT
AQSMSSTE
AQSPARMC
AQSOPTIN
AQSREPRT
AQSDIAG
File Description
Temporary statistics-file
received from ASTSTDS (AQ0410)
Temporary site data file
received from1 ARTS'TDS (AQ0400)
AQDHS-II parameter file
Option Card
Standards report
Diagnostic report
Input/Output
Input
Input
Input
Input
Output
Output
6.6.4.5.3 User-supplied JCL - To execute the cataloged procedure
AQRPM60, the user can expect to supply job accounting .information (job'card)
and the data set names of the master, parameter, and sorted site files. See
Figure 6.6.4-e for a descripton of the procedure's substitutable-parameters.
6.6.4.5.4 Sample..run stream - The following run stream would produce a
standards report for the years 1975 through 1980 for the AQDHS-TI master file
ICN.EPALMH.A087.CDHS.HQ.AQS.DATA.'AQMSTR1') using the AQDHS-II parameter file
'CN.EPALMH.-A087.CDHS.HQ.AQS.DATA.AQPARM11 and the AQDHS-II sorted site file
1CN.EPALMH.A087.CDHS.HQ.AQS.DATA. AQSRST1'.
// EXEC AQRPM60,
// MSTRFIL=AQMSTR1,
// PARMFIL=AQPARM1,
// SITESRT=AQSRStl
//RETRIEVE.OPTIONS DD *
75 80
//REPORT.OPTIONS DD *
SEPTEMBER 03, 1981
/*
629.129
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 9
Release Date: 10/31/81
Update #: 29
6.6.4.6 Warnings and Special Instructions
In order to activate the ACCEPT command, certain program modifications
must be made prior to compiling the program. These changes are as follows:
1. Change the following statements (on or about sequence numbers 318500
through 320500) so that an asterisk is in column 7:
READ OPTION-FILE
AT END
MOVE TRUE TO END-OPT-FILE-SW.
IF NOT END-OPT-FILE
MOVE OPTION-CARD TO WS-OPTION-CARD
IF OPT-REPORT-DATE IS EQUAL TO SPACES
MOVE SPACES TO HEADER-DATE-SPOT
MOVE WS-OPTION-CARD TO PRINT-DATA
PERFORM PRINT-ROUTINE THRU PRINT-ROUTINE-END -
MOVE ERR-1 TO ERROR-CODE
PERFORM ERROR-ROUTINE THRU ERROR-ROUTINE-END
ELSE
MOVE OPT-REPORT-DATE TO REPORT-DATE-SPOT
MSG-RPT-DATE
MOVE OPTION-MESSAGE TO PRINT-DATA
PERFORM PRINT-ROUTINE THRU PRINT-ROUTINE-END
MOVE BINARY-4 TO LINE-SKIP
ELSE
MOVE SPACES TO HEADER-DATE-SPOT
MOVE ERR-4 TO ERROR-CODE
PERFORM ERROR-ROUTINE THRU ERROR-ROUTINE-END.
2. Change the asterisk in column 7 to a blank in the following
statements (on or about sequence numbers 320600 through 322200):
629.130
-------
AQDHS-II
REPORTS
*
*
*
*
*
*
*
*
*
*
* .
*
*
*
*
SECTION 6.6.4 Page:. 10. .
STANDARDS REPORT PROGRAM Release Date: 10/31/81
ARPSTDS (AQ0420) Update #: 29
ACCEPT IBM-DATE FROM DATE
IF DAY-DIGIT-1
IS EQUAL TO ZERO
MOVE DAY-DIGIT-2 TO T-DAY
MOVE LIT-FIXED-DATE TO FIXED-DATE
MOVE IBM-YEAR TO T-YR
MOVE MONTH-NAME (IBM-MONTH) TO T-MO-DESC
MOVE T-MONTH TO MSG-RPT-DATE
ELSE
RE PORT-DATE-SPOT
MOVE IBM-DAY TO T-DAY-R
MOVE LIT-FIXEU-DATE TO FIXED-DATE-R
MOVE MONTH-NAME (IBM-MONTH) TO T-MO-DESC-R
MOVE IBM- YEAR TO T-YR-R
MOVE T-MONTH-R TO MSG-RPT-DATE
REPORT-DATE-SPOT.
An asterisk in column 7 indicates that a line of code is actually a
comment and will not be translated into machine code by the compiler.
6.6.4.7 Cost Considerations
The following example provides an estimate of the cost of executing
ARPSTDS (AQ0420) on an IBM 370/168.
Size of statistics file:
Size of site data file:
Size of parameter file:
Total report pages:
CPU time:
I/O time:
Total time:
Estimated Cost:
16,297 records
19 records
84 records
164 pages
12.43 seconds
8.57 seconds
21.00 seconds
$4.96
629.131
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 11
Release Date: 10/31/81
Update #: 29
6.6.4.8 Related Programs and Procedures
ARPSTDS (AQ0420) must be executed in conjunction with ARTSTDS (AQ0400)
and ASTSTDS (AQ0410). See Section 6.6.2 for a discussion of ARTSTDS (AQ0400)
and Section 6.6.3 for a discussion of ASTSTDS (AQ0410).
629.132
-------
REPORT DATE: SEPTEMBER 25, 1981
AOOHS-II STANDARDS REPORT FROM JAN 1981 TO DEC
PARTICULATE
DAILY VALUES
1981
PAGE
STATE (35): NORTH DAKOTA
SITE CODE: 35-0720-107
AGEUCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
LOCATION: FALKIRK
COUNTY (07CO): MADISON
SITE ADDR: FALKIRK MINE SITE 82
STATION TYPE (23): SUBURBAN: COMMERICAL
AQCR: 172 SMSA: SMSA
SLAMS/HAMS ID (1): HAMS
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
LATITUDE: N12 D. 12 M. 34 S.
LONGITUDE: W123 D. 12 M. 34 S.
ZONE 14 UTM ZONE: 13
UTM NORTHING: 999.9000 M.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17.2 M.
ELEVATION ABOVE MSL: 10,000 FT.
TIME ZONE: PACIFIC
COLLECTION METHOD: HI-VOL
JANUARY FEBRUARY
.ANALYSIS METHOD: GRAVIMETRIC
MARCH
APRIL
MAY
JUNE
JULY
AUGUST SEPTEMBER OCTOBER NOVEMBER DECEMBER
GO
co
D
A
Y
0
F
M
0
N
T
H
GEO
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
8
MAX
MEAN
134 T
1145*F
15 S
S
1078*M
1000*T
111 M
200+T
16 F
105 S
123 S
34 M
T
N
23 T
F
99 S
89 S
75 M .
10 T
16 W
\00 T
1034*F
1055*5
S
M
9 T
956*14
704*T
704*F
S
24
1145
129
200+5
M
105 T
734*W
123 T
34 F
99 S
2 S
620*M
621*T
89 14
75 T
10 F
14 S
S
M
T
100 W
175+T
15 F
S
S
203+11
1201*T
1509*14
22 T
1345*F
1045»S
22
1509
125
55 S
134 M
T
9 M
1145*T
1078*F
1000*S
111 S
M
9 T
200+W
105 T
123 F
34 S
S
27 M
99 T
89 14
75 T
10 f
S
10 S
100 M
175+T
203+W
1201*T
F
4 S
1509*S
1345*M
1045*T
26
1509
116
75 W
1 T
16 F
S
90 S
200 + M
15 T
37 14
21 T
150 + F
160*3
102 S
M
T
8 W
T
145 F
1123*S
116 S
95 M
9 T
87 W
59 T
98 F
S
S
10 M
113 T
15 W
72 T
24
1123
50
134 F
1145*S
10 S
M
1073*T
1000*14
111 t
200+F
9 S
105 S
123 M
34 T
M
T
77 F
S
99 S
89 M
75 T
10 W
56 T
100 F
1034*S
1055*S
M
T
46 W
956*T
704*F
704*S
S
24
1145
147
619*M
. T
261*14
134 T
260*F
259+S
151+S
66, M
1.145*1
1073*14
150 + T
149 F
45 S
94 S
M
T
H
134 T
155+F
34 S
S
M
135 T
97 W
100 T
F
23 S
55 S
M
T
21
1145
144
260*W
89 T
259+ F
1055XS
151+S
150+M
149 T
51 »
956*T
704*F
45 S
134 S
155 + M
53 T
M
T
F
151+S
179+S
93 M
T
14
160 + T
154+F
207+S
30 S
1378*11
1034*T
14
T
F
23
1378
183
49 S
89 S
1 M
9 T
60 M
T
97 F
90 S
120 S
244+M
88 T
W
53 T
147 F
179+S
15 S
37 M
T
9} M
150+T
160+F
102 S
145 S
1123*M
32 T
H
T
F
S
S
113 M
23
1123
72
260*T
259+14
151+T
150 + F
149 S
72 S
45 M
134 T
155+14
T
F
18 S
151+S
179+n
160 + T
W
T
17 F
154+S
207+S
1378*M
1034*T
1055*14
15 T
956*F
704*5
260*3
259+M
T
12 W
25
1378
157
1000*T
89 F
111 S
1345*S
200+M
105 T
123 M
51 T
1045*F
734*3
34 S
99 M
89 T
53 14
T
F
S
75 S
10 M
93 T
14
T
100 F
175+3
203+S
30 M
1201*T
1509*W
T
F
S
23
1509
156
49 S
203+M
1201*T
1509*14
1345*T
F
, 97 S
1045*S
734*M
620*T
621*W
T
53 f
619*3
261*3
260*M
259+T
M
93 T
151+F
150+S
149 S
45 M
134 T
32 M
T
F
S
S
M
22
1509
241
75 T
1 M
90 T
200+F
15 S
72 S
37. H
150+T
160+W
T
F
18 S
102 S
145 M
H23*T
14
T
17 f
116 S
95 S
87 M
59 T
98 14
15 T
113 F
15 S
72 S
123 M
T
12 14
T
,25
1123
58
TOTAL SAMPLES = 282 MAXIMUM = 1509
GEOMETRIC MEAN = 119 TOTAL PRIMARY EXCEEDANCES = 67
GEOMETRIC STANDARD DEVIATION = 4.40 TOTAL SECONDARY EXCEEDANCES = 115
*** MEAN EXCEEDS PRIMARY STANDARD AND EXCEEDS SECONDARY STANDARD OF
75 AND
60 MICROGRAMS PER CUBIC METER, RESPECTIVELY
* INDICATES ITEM EXCEEDED PRIMARY STANDARD OF
+ INDICATES ITEM EXCEEDED SECONDARY STANDARD OF
260 MICROGRAMS PER CUBIC METER
150 MICROGRAMS PER CUBIC METER
Figure 6. 6. 4. a.
(Pago 1 of 16)
Standards Report
ARPSTDS (AQ0420)
cz
T3
Q.
QJ
fD
=tfe
• .
ro
m
0
70
—1
00
STANDARDS REPORT PROG
70
70
O
oo
I—"
OO
t— •
1
CO
1
1— -t
>— 1
SECTION 6. .6. 4
QJ
to
fD
j_^j -
no
-------
REPORT DATE: SEPTEMBER 25, 1981
AQDHS-II STANDARDS REPORT FROM JAN 1979 TO DEC 1979
LEAD
DAILY VALUES
PAGE
STATE (35 ): NORTH DAKOTA
SITE CODE: 35-0720-103
AGENCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
LOCATION: DAGREEF
COUNTY (0720): MADISON
SITE ADDR: COAL CREEK SITE *3
STATION TYPE (23): SUBURBAN: GOMMERICAL
AQCR: 172 SMSA: SMSA
SLAMS/NAMS ID (1): HAMS
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
LATITUDE: N12 D. 12 M. 34 S.
LONGITUDE: W123 0. 12 M. 34 S.
ZONE 14 UTM ZONE: 13
UTM NORTHING: 999.9000 M.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17.2 M.
ELEVATION ABOVE MSL: 10,000 FT.
TIME ZONE: PACIFIC
COLLECTION METHOD: HI-VOL
JANUARY FEBRUARY
ANALYSIS METHOD: EMISS SPECTRA MUFFLE FURN
MARCH
APRIL
MAY
JUNE
JULY
AUGUST SEPTEMBER OCTOBER NOVEMBER DECEMBER
no
10
1
2
D 3
4
A 5
6
Y 7
8
9
10
0 11
12
F 13
14
15
16
M 17
18
0 19
20
N 21
22
T 23
24
H 25
26
27
28
29
30
31
tt
MAX
ARITH MEAN
0.300 M
0.500 T
1.200 W
0.700 T
1.100 F
1.500 S
1.600 S
1.400 M
0.100 T
0.700 W
1.700 T
2.000 F-
0.300 S
0.200 S
0.900 M
1.000 T
1.300 W
0.700 T
0.900 F
0.500 S
0.300 S
0.100 M
0.700 T
0.900 W
1.000 T
1.500 F
1.800 S
1.300 S
1.000 M
1 .100 T
1.100 W
1.600 T
1.500 F
0.100 S
0.700 S
1.700 M
2.000 T
0.300 W
0.200 T
0.900 F
1.000 S
1.300 S
0.700 M
0.900 T
0.500 N
0.300 T
0.100 F
0.700 S
0.900 S
.000 M
.500 T
.800 W
.300 T
.000 F
.100 S
.100 S
2.300 M
2.000 T
1.500 W
0.0 T
0.700 F
0.100 S
1.200 S
0.500 M
0.600 T
0.400 W
0.100 T
0.700 F
0.700 S
0.0 S
0.300 M
0.200 T
0.900 W
0.0 T
0.300 F
0.700 S
0.900 S
0.500 M
0.300 T
0.100 W
0.700 T
0.900 F
0.0 S
1.500 S
1 .800 M
1.300 T
1.000 W
1.100 T
1.100 F
2.300 S
90
2.300
0.892
0.700 S
1.100 M
1.000 T
1.500 W
1.600 T
1.400 F
0.100 S
0.700 S
1.700 M
2.000 T
0.300 W
0.200 T
0.900 F
1.000 S
1.300 S
0.700 M
0.900 T
0.500 W
0.300 T
0.100 F
0.700 S
0.900 S
1.000 M
1.500 T
1.600 M
1.300 T
1.000 F
1.100 S
1.100 S
2.300 M
0.700 T
0.900 W
.200 T
.000 F
.500 S
.800 S
.300 M
.000 T
1.100 W
1.100 T
2.300 F
0.300 S
0.500 S
1.000 M
0.700 T
1.100 N
1.500 T
1.600 F
1.400 S
0.100 S
0.700 M
1.700 T
2.000 W
0.300 T
0.900 F
1.000 S
1.300 S
0.700 M
0.900 T
0.500 W
0.300 T
0.500 F
4.100 S
1.000 S
0.700 M
1.100 T
1.500 M
1.600 T
1.400 F
0.100 S
0.700 S
1.700 M
2.000 T
0.300 W
0.200 T
0.900 F
1.000 S
1.300 S
0.700 M
0.900 T
0.500 W
0.300 T
0.100 F
0.700 S
0.900 S
.000 M
.500 T
.800 W
.300 T
.000 F
.100 S
91
4.100
1.044
0.900 S
5.000 M
1.000 T
0.700 U
1.300 T
0.700 F
0.900 S
4.600 S
1.700 M
2.000 T
0.500 W
0.300 T
0.500 F
4.700 S
S
M
T
1.000 W
0.700 T
6:200 F
S
S
1.100 M
1.500 T
1.600 M
2.300 T
1.400 F
0.100 S
S
M
T
5.200 W
0.300 T
0.200 F
0.900 S
1.000 S
M
7.600 T
1.300 M
0.700 T
0.900 F
0.500 S
S
3.400 M
0.300 T
0.100 W
0.700 T
0.900 F
S
5.900 S
1.000 M
1.500 T
1.800 H
1.300 T
1.000 F
2.800 S
S
M
T
U
T
10.500 F
1.100 S
0.300 S
0.500 M
1.000 T
0.700 W
4.700 T
1.100 F
1.500 S
1.600 S
M
T
0.700 W
1.400 T
0.100 F
0.700 S
S
M
10.100 T
1.700 U
2.000 T
0.300 F
0.200 S
0.900 S
6.400 M
1.000 T
1.300 W
0.700 T
0.900 F
S
6.800 S
71
10.500
1.946
0.300 M
5.000 T
1.000 W
0.700 T
1.100 F
1.500 S
1.600 S
4.600 M
0.100 T
0.700 W
1.700 T
2.000 F
0.300 S
4.700 S
0.900 M
1.000 T
1.300 W
0.700 T
0.900 F
6.200 S
0.300 S
0.100 M
0.700 T
0.900 M
1.000 T
2.300 F
1.800 S
1.300 S
1.000 M
1.100 T
1.100 M
5.200 T
0.700 F
0.900 S
0.500 S
0.300 M
0.100 T
7.600 M
0.900 T
1.000 F
1.500 S
1.800 S
1.300 M
3.400 T
1.100 W
1.100 T
2.300 F
2.000 S
1.500 S
5.900 M
1.400 T
0.300 M
0.500 T
1.000 F
0.700 S
2.800 S
1.500 M
1.600 T
1.400 U
0.100 T
0.700 F
0.700 S
1.100 S
1.500 M
1.600 T
1.400 U
4.700 T
0.700 F
1.700 S
2.000 S
0.300 M
0.900 T
0.700 M
1.300 T
0.700 F
0.900 S
0.500 S
0.300 M
10.100 T
1.000 M
0.700 T
1.100 F
1.500 S
1.600 S
6.400 M
0.100 T
0.700 W
1.700 T
2.000 F
0.300 S
6.600 S
0.900 M
92
10.100
1.684
TOTAL SAMPLES = 344
MAXIMUM = 10.500
TOTAL PRIMARY EXCEEDANCES =
*«* AT LEAST ONE QUARTERLY MEAN EXCEEDS PRIMARY STANDARD OF 1.500 MICROGRAMS PER CUBIC METER
(Page 2 of 16)
Figure 6.6.4-a - continued. Sample Standards Report
ARPSTDS (AQ0420)
CL
ro
..
S
73
n
~Q
O
;o
— 1
CO
STANDARDS REPORT PROG
73
73
ro
ro
OJ
to
ro
o
O)
ro
i — •
o
CO
1 — t
CO
I—*
^
Jd
a
re
CO
1
h-H
CO
m
c~
c
01
OJ
-------
AQDHS-II STANDARDS REPORT FOR AUGUST 1979
CARBON MONOXIDE
1 HOUR VALUES
PAGE
33
STATE (35): NORTH DAKOTA
ro
i_^
CO
en
SITE CODE: 35-0720-103 LOCATION: DAGPEEF
AGENCY (J): PRIVATE COUNTY (0720): MADISON
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV. SITE ADDR: COAL CREEK SITE «3
CITY POPULATION: 50,000,000 STATION TYPE (23): SUBURBAN: COMMERICAL
AQCR POPULATION: 50,000,000 AQCR: 172 SMSA: SMSA
EPA REGION: 8 SLAMS/NAMS ID ( ):
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
COLLECTION METHOD: INSTRUMENTAL ANALYSIS METHOD: DETECTION TUBE
MONT 1 23456789 10 11 NOON 1 2 3
01 W 6.9 2.9 2.9 0.0 0.0 2.9 0.0 0.0 2.9 10.3 12.6 9.2 10.3 2.9 0.0 0.0
02 T 2.9 2.9 2.9 9.2 16.1 2.9 2.9 2.9 2.9 2;9 2.9 2.9 11.5 10.3 8.0 2.9
03 F 2.9 2.9 2.9 2.9 2.9 9.2 20.7 8.0 2.9 2.9 2.9 2.9 2.9 2.9 2.9 5.7
04S2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9
05 S 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9
06 M 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 6.9 6.9 9.2 19.5 5.7 2.9 12.6
07 T 2.9 2.9 2.9 2.9 2.9 8.0 14.9 8.0 5.7 5.7 2.9 2.9 6.9 12.6 11.5 17.2
08 W 2.9 2.9 6.9 2.9 2.9 2.9 6.9 2.9 0.0 2.9 2.9 2.9 2.9 2.9 2.9 2.9
09 T 2.9 2.9 2.9 2.9 2.9 2.9 0.0 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9
10 F 2.9 2.9 2.9 2.9 2.9 2.9 2.9 6.9 14.9 8.0 5.7 6.9 6.9 10.3 5.7 9.2
11 S18.4 10.3 8.0 10.3 16.1 26.4 26.4 14.9 8.0 25.3 26.4 11.5 13.8 12.6 6.9 2.9
12 S 2.9 2.9 2.9 2.9 6.9 13.8 21.8 9.2 5.7 6.9 2.9 2.9 5.7 5.7 2.9 2.9
13 M 2.9 2.9 5.7 6.9 5.7 27.6 50.6*12.6 8.0 9.2 11.5 10.3 5.7 5.7 2.9 5.7
14 T10.3 2.9 11.5 5.7 5.7 27.6 40.2 11.5 10.3 8.0 6.9 6.9 2.9 2.9 2.9 2.9
15 W C.9 2.9 2.9 2.9 2.9 6.9 23.0 11.5 11.5 9.2 6.9 5.7 5.7 8.0 6.9 5.7
16 T 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 12.6
17 F10.3 6.9 2.9 2.9 2.9 46.0*21.8 2.9 2.9 2.9 2.9 2.9 5.7 2.9 2.9 2.9
18 S 8.0 2.9 2.9 0.0 0.0 2.9 9.2 6.9 2.9 2.9 2.9 0.0 0.0 2.9 0.0 0.0
19 S 2.9 11.5 2.9 2.9 0.0 2.9 5.7 0.0 0.0 0.0 0.0 0.0 2.9 2.9 2.9 2.9
20 M 0.0 0.0 0.0 2.9 2.9 0.0 0.0 5.7 2.9 2.9 2.9 2.9 0.0 2.9 0.0 0.0
21 T 0.0 2.9 0.0 2.9 2.9 0.0 2.9 0.0 2.9 0.0 0.0 2.9 0.0 0.0 2.9 2.9
22 W 2.9 0.0 0.0 0.0 0.0 0.0 0.0 2.9 2.9 2.9 2.9 2.9 2.9 0.0 2.9 5.7
23 T 0.0 2.9 2.9 0.0 2.9 2.9 0.0 2.9
24F2.9 2.9 2.9 0.0 2.9 0.0 2.9 0.0 2.9 2.9 2.9 0.0 0.0 0.0 0.0 2.9
25SO.O 0.0 0.0 0.0 0.0 2.9 2.9 2.9 2.9 2.9 0.0 2.9 2.9 0.0 2.9 2.9
26 S 0.0 0.0 0.0 2.9 0.0 0.0 0.0 2.9 2.9 0.0 0.0 0.0 0.0 0.0 0.0 0.0
27 M 2.9 5.7 2.9 0.0 2.9 0.0 0.0 8.0
28 T 0.0 0.0 2.9 2.9 2.9 2.9 0.0 2.9 2.9 2.9 2.9 £.9 2.9 2.9 2.9 2.9
29 W 2.9 2.9 0.0 0.0 0.0 0.0 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9
30 T 0.0 0.0 0.0 0.0 2.9 2.9 2.9 0.0 2.9 2.9 0.0 0.0 2.9 2.9 2.9 2.9
31 F 0.0 2.9 2.9 2.9 2.9 6.0 8.0 2.9 0.0 0.0 0.0 0.0 2.9 2.9 2.9 2.9
ft 29 29 29 29 29 29 29 29 31 31 31 31 31 31 31 31
MAX 18.4 11.5 11.5 10.3 16.1 46.0 50.6 14.9 14.9 25.3 26.4 11.5 19.5 12.6 11.5 17.2
MEAM 3.5 3.0 2.9 2.9 3.4 7.4 9.7 4.7 3.9 4.7 4.2 3.4 4.5 3.9 3.0 4.3
ZONE
14
LATITUDE:
LONGITUDE
UTM ZONE:
N12 0.
: W123 D.
13
UTM NORTHING: 999
UTM EASTING: 507
4 5
2.9
2.9
0.0
2.9
2.9
2.9
2.9
0.0
0.0
2.9
2.9
2.9
23.0
2.9
2.9
13.8
2.9
0.0
0.0
2.9
2.9
2.9
0.0
2.9
2.9
0.0
2.9
0.0
2.9
2.9
30
23.0
3.1
2
5
2
2
2
2
0
2
2
9
2
2
11
6
2
13
2
2
2
2
2
2
2
2
2
2
2
2
Z
0
2
13
3
6
.9
.7
.9
.9
.9
.9
.0
.9
.9
.2
.9
.9
.5
.9
.9
.8
.9
.9
.9
.9
.9
.9
.9
.9
.9
.9
.9
.9
.9
.0
.9
31
.8
.7
TOTAL SAMPLES = 696 MAXIMUM = 50.6 PERCENT OF POSSIBLE
ARITHMETIC MEAN = 4.4 TOTAL PRIMARY EXCEEDANCES = 3
ARITHMETIC STANDARD DEVIATION = 5.6
» INDICATES ITEM EXCEEDED PRIMARY STANDARD OF 40.5 MILLIGRAMS PER CUBIC METER
(Pa?o 3
ELEVATION
ELEVATION
TIME ZONE
7 8
2.9 2.9
2.9 2.9
2.9 2.9
2.9 2.9
2.9 2.9
2.9 2.9
0.0 2.9
2.9 2.9
6.9 16.1
25.3 17.2
16.1 23.0
2.9 2.9
10.3 10.3
16.1 27.6
2.9 2.9
8.0 2.9
11.5 23.0
13.8 10.3
2.9 2.9
0.0 2.9
0.0 2.9
2:9 2.9
5.7 5.7
2.9 2.9
2:9 10.3
2.9 2.9
0.0 2.9
2.9 2.9
2.9 0.0
0.0 0.0
2.9 2.9
31 31
25.3 27.6
5.2 6.5
12 M
12 M
9000
9000
ABOVE GROUND:
ABOVE MSL: 10
: PACIFIC
9 10
2.9 2.9
2.9 2.9
0.0 2.9
2.9 2.9
2.9 2.9
2.9 9.2
0.0 5.7
2.9 2.9
6.9 6.9
9.2 21.8
8.0 8.0
18.4 2.9
6.9 6.9
6.9 2.9
2.9 5.7
2.9 12.6
9.2 6.9
6.9 11.5
2.9 0.0
0.0 0.0
2.9 2.9
2.9 2.9
6.9 0.0
0.0 2.9
2.9 2.9
2.9 2.9
0.0 2.9
2.9 2.9
0.0 0.0
0.0 0.0
2.9 2.9
31 31
18.4 21.8
4.0 4.6
OBSERVATIONS = 93
11
2.9
2.9
0.0
2.9
2.9
10.3
2.9
2.9
2.9
. 34
. 34
M.
M.
17
,000
f
23
23
23
23
23
23
23
23
23
46.0«23
8.0
2.9
5.7
2.9
2.9
2.9
6.9
2.9
0.0
0.0
0.0
2.9
2.9
0.0
2.9
2.9
2.9
2.9
0.0
0.0
2.9
31
46.0
4.2
0
23
23
23
23
23
23
22
23
23
23
23
23
15
23
23
23
15
23
23
23
23
S.
S.
.2 M.
FT.
MEAN
3.6
4.8
3.9
2.9
2.9
5.4
5.4
3.0
3.7
9.8
13.4
5.8
10.8
9.8
6.0
4.9
8.3
4.1
Z.Z
1.4
1.6
2.1
2.8
1.6
2.3
1.2
2.3
2.5
1.7
1.2
Z.7
TO
m
0
TO
—\
~S> CO
XI —1
CO 32
— 1 O
0 3>
Co TO
O
^~s CO
•O TO
O m
ro o
O TO
-o
TO
0
o
TO
3&
-s
d TO
"O ft)
CX — '
&> fD
rt- Oi
"* fD
=«=
•• 0
Cu
r+
ro fD
o
* — ,
CO
1 — »
CO
ja
.0
CT
"T~
CO
1— <
I— (
CO
m
o
— i
0
01
01
•
-o
fu
to
• •
i—"
*•
7'
of 1C)
Figure 6.6.4-a - continued. Sample Standards Report
-------
AQDHS-II STANDARDS REPORT FROM JAN 1979 TO DEC 1979
CARBON MONOXIDE
1 HOUR MAXIMUMS
PAGE
35
STATE (35): NORTH DAKOTA
SITE CODE: 35-0720-103
AGENCY (J): PRIVATE
LOCATION: DA3REEF
COUNTY (0720): MADISON
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV. SITE AODR: COAL CREEK SITE
CITY POPULATION: 50,000,000
ACCR POPULATION: 50,000,000
EPA REGION: 0
STATION TYPE (23): SUBURBAN
AQCR: 172 SMSA: SMSA
«3
ZONE 14
: COMMERICAL
SLAMS/NAI1S ID (3): OTHER/NOT CLASSIFIED
SUFPOPflKG AGENCY: NCPTH DAKOTA AIR POLLUTION DEPT
LATITUDE: N12
LONGITUDE: W123
UTM ZONE: 13
UTM NORTHING:
UTM EASTING:
ELEVATION ABOVE
ELEVATION ABOVE
0. 12 M. 34
D. 12 M. 34
999.9000 M.
507.9000 M.
GROUND: 17
MSL: 10,000
S.
S.
Z M.
FT.
TIME ZONE: PACIFIC
cn
ro
i-D
h— *
GO
CPi
COLLECTION METHOD: INSTRUMENTAL
JANUARY FEBRUARY
1 57.5*M 21.8 T
2 0.0 T 2.9 F
0 3 2.9 W 2.9 S
4 2.9 T 11.5 S
A 5 O.OF 10. 3 M
6 9.2 S 2.9 T
Y 7 0.0 S 5.7 U
8 0.0 M 18.4 T
9 2.9 T 11.5 F
10 11.5 W 6.9 S
0 11 57.5*T 16.1 S
12 14.9 F 6.9 M
F 13 24.1 S 13.8 T
14 2.9 S 16.1 W
15 32.2 M 2.9 T
16 17.2 T 10.3 F
M 17 17.2 W 5.7 S
18 73.6*T 9.2 S
0 19 41.4*F 51.7*M
20 42.5*S 23.0 T
N 21 9.2 S 42.5»U
22 17.2 M 2.9 T
T 23 14.9 T 41.4*F
24 40.2 W 36.8 S
H 25 20.7 T 12.6 S
26 6.9 F 47.1*M
27 10.3 S 29.9 T
23 18.4 S 2.9 H
29 6.9 M
30 12.6 T
31 16.1 M
S 713 644
MAX 73.6 51.7
MEAN 16.8 16.7
TOTAL SAMPLES = 6136
ARITHMETIC MEAN = 26.6
ARITHMETIC STANDARD DEVIATION =
* INDICATES ITEM EXCEEDED PRIMARY
tIARCH
2.9 T
9.2 F
41.4*3
14.9 S
41.4*M
6.9 T
5.7 M
0.0 T
0.0 F
12.6 S
0.0 S
M
0.0 T
24.1 M
12.6 T
20.7 F
5.7 S
2.9 S
0.0 M
2.9 T
20.7 N
31 .0 T
17.2 F
12.6 S
0.0 S
2.9 M
8.0 T
2.9 W
2.9 T
28.7 F
2.9 S
664
41.4
11.1
33.3
ANALYSIS METHOD: DETECTION
APRIL MAY JUNE
6.9 S 17.2 T 18.4 F
25.3 M 24.1 H 11.5 S
25.3 T 24.1 T 9.2 S
5.7 U 25.3 F 9.2 M
£0.7 T 5.7 S 97.7*T
12.6 F 2.9 S 59.8*W
9.2 S 10. 3 M 48.3*T
9.2 S T 136. 8*F
9.2 M U 69.0*3
14.9 T 2.9 T 131.1*3
9.2 W 54.0*F 135. 7*M
8.0 T 152. 9-S 82.8*T
0.0 F 6.9 S 46.0*W
2.9 S 21.8 M 70.1*T
2.9 S 28.7 T 47.1*F
5.7 M 2.9 M 26.4 S
2.9 T 2.9 T 42.5*S
2.9 W 11.5 F 57.5*M
2.9 T 2.9 S 51.7*T
2.9 F 47.1*S 32.2 N
2.9 S 19.5 tt 42.5*T
0.0 S 11.5 T 47.1»F
0.0 M 34.5 W 46.0*3
6.9 T 32.2 T 27.6 S
20.7 » 5.7 f 70.1*M
2.9 T 18.4 S 171. 3*T
26.4 F 9.2 5 86.2*W
5.7 S 2.9 M 77.0*T
2.9 S 11.5 T 136. 8*F
13.8 M 5.7 U 24.1 S
21.8 T
690 638 680
26.4 152.9 171.3
8.7 21.3 63.7
MAXIMUM = 197.8
TOTAL PRIMARY EXCEEDANCES = 64
TUBE
JULY
37.9 S
85.1*M
42.5*T
25.3 U
59.8*T
60.9*F
19.5 S
72.4*S
93.9*M
82.8*T
43.7*W
94.3*T
70.1*F
26.4 S
31.0 S
89.7*M
69.0*T
161. 0*M
197. 8*T
143. 7*F
62.1*S
71.3*5
126.5*M
74.7*T
44.8*W
46 . 0*T
93.1*F
56.3*3
39.1 S
65.5*M
17.2 T
713
197.8
71.3
AUGUST
12.6 M
16.1 T
20.7 F
2.9 S
2.9 S
19.5 M
17.2 T
6.9 W
16.1 T
46.0*F
26.4 S
21.8 S
50.6*M
40.2 T
23.0 U
13.8 T
46.0*F
13.8 S
11.5 S
5.7 M
2.9 T
5.7 M
6.9 T
2.9 f
10.3 S
2.93
8.0 M
2.9 T
2.9 M
2.9 T
8.0 F
696
50.6
15.2
PERCENT OF
SEPTEMBER OCTOBER NOVEMBER DECEMBER
6.9
6.9
2.9
6.9
5.7
2.9
2.9
0.0
0.0
0.0
0.0
0.0
0.0
0.0
0.0
0.0
14.9
16.1
23.0
32.2
S M
S T
M W
T T
M F
T S
f S
S M
S T
M W
T T
H F
T S
F S
S M
S T
M W
T T
U F
T S
43.7*F S
2.9
16.1
31.0
29.9
9 . 2
8,0
5.7
27.6
21.8
698
43.7
10.6
S M
S T
M W
T T
W F
T S
F S
S M
S T
H
POSSIBLE OBSERVATIONS =
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
H
T
F
70.0
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
W
T
F
S
S
M
T
T
F
S
S
M
STANDARD OF 40.5 MILLIGRAMS PER CUBIC METER
TO
m
"O
O
70
—1
GO
3= GO
TO — |
GO -Z.
O >
GO TO
. — . GO
3»
J^J ^W
O m
PO O
0 70
-H
-o
70
o
CD
TO
g
C 7C
O. — '
Oi fD
r+ OJ
fD
•• O
CU
ro fD
vo
1— •
•^
GO
00
1 — 1
^
o
GO
1
l~^
GO
m
o
— (
o
"Z.
cn
cn
•
-^
f?
id
fD
f— '
cn
(Pane 4 of 16)
Figure 6.6.4-a - continued. Sample Standards Report
-------
ro
AQOHS-II STANDARDS REPORT FOR AUGUST 1979
CARBON MONOXIDE
8 HOUR RUNNING AVERAGE
PAGE
43
STATE (35): NORTH DAKOTA
SITE CODE: 35-0720-103
AGENCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
LOCATION: DAGREEF
COUNTY (0720): MADISON
SITE ADDR: COAL CREEK SITE «3
STATION TYPE (23): SUBURBAN: COMMERICAL
ACCR: 172 SMSA: SNSA
SLAMS/NAMS ID (3): OTHER/NOT CLASSIFIED
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION OEPT
LATITUDE: N12 D. 12 M. 34 S.
LONGITUDE: W123 D. 12 M. 34 S.
ZONE 14 UTM ZONE: 13
UTM NORTHING: 999.9000 M.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17.2 M.
ELEVATION ABOVE MSL: 10,000 FT.
TIME ZONE: PACIFIC
COLLECTION METHOD: INSTRUMENTAL
ANALYSIS METHOD: DETECTION TUBE
MDNT
01 M 9
02 T 2
03 F 3
04 S 1
05 S 2
06 M 2
07 T 4
03 W C
09 T 2
10 F 5
11 S18
12 S 9
13 M 4
14 T10
15 M 8
16 T 3
17 F 8
18 S 9
19 S 6
20 M 1
21 T 0
22 W 2
23 T 2
24 F 3
25 S 1
26 S 3
27 M Z
£8 T 1
29 W 2
30 T 0
31 F 0
.5
.9
.2
.8
.9
.9
.6
.2
.5
.7
1
9.0
2.9
3.2
2.2
2.9
2.9
4.6
2.2
2.9
6.0
2
8.6
2.9
C.9
2 '
2.9
2.9
4.6
3.0
2.9
6.0
3
7.5
3.7
2.9
2.2
2.9
2.9
4.6
3.4
2.9
5.5
4
5.6
5.3
2.9
2.2
2.9
2.9
4.6
3.4
2.9
3.9
5 6 7 8 9 10 11 NOON 1
3.8 2.9 1.9 1.4 2.4 3.6 4.7 6.0 6.0
5.3 5.3 5.3 5.3 5.3 5.3 4.5 4.0 4.9
3.7 5.9 6.5 6.5 6.5 6.5 6.5 6.5 5.7
2.5 2.5 2.9 2.9 2.9 2.9 2.9 2.9 2.9
2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9
2.9 2.9 2.9 2.9 3.4 3.9 4.7 6.8 7.1
5.2 6.0 5.7 6.0 6.4 6.4 6.4 6 .-9 7.5
3.7 3.9 3.9 3.5 3.5 3.0 3.0 3.0 3.0
2.9 2.5 2.5 2.5 2.5 2.5 2.5 2.5 2.5
3.4 2.9 3.4 4.9 5.5 5.9 6.4 6.9 7.8
2
6.0
5.5
3.5
2.9
2.9
7.1
7.0
2.5
2.. 9
8.2
3
6.0
5.5
3.2
2.9
2.9
8.3
8.2
2.5
2.9
8.5
4
6.5
5.9
3.3
2.9
2.9
9.1
8.5
2.9
2.9
7.6
5
5.4
5.9
2.9
2.9
2.9
8.5
8.1
2.5
2.5
6.8
.8*1 9. 7* 19. 5*17. 7*17. 5*19. 7*20. 3*16. 4*15. 1*1 7. 0*1 9. 3*19. 4*19. 1*1 7. 4*14. 9*1 3. 4*14. 2*11.. 0*
.0
.8
.6*
.6
.2
.4
.8
.8
.4
7
.2
.9
.7
.4
.4
.9
.4
.9
.7
.4
9.0
4.8
8.1
8.6
3.2
7.5
8.9
7.8
1.4
1 . 1
1.8
2.9
3.7
1.4
3.1
2.9
1.4
2.9
0.7
0.4
9.0
5.2
8.1
8.1
3.2
6.2
8.9
7.8
1.1
0.7
1.4
3.7
1.1
2.7
1.4
2.5
0.4
0.7
7.3
5.7
7.5
6.5
3.2
5.5
7.5
6.5
1.1
1. 1
1.4
3.0
0.7
2.7
1.8
2.2
0.0
1.1
5.3
6.0
7.0
3.4
3.2
5.5
4.6
5.2
1.1
1. 1
1.1
2.7
0.4
1.4
1.8
1.8
0.4
1.4
6.0 7.8 7.9 8.3 8.8 8.8 8.8 8.6 7.6
7.2 13.2*14.4*15.0*15.8*16.5*17.0*17.0*14.2*
9.6 13.7*14.4*14.4*15.1*14.5*14.7*14.3*11.2*
3.4 5.9 7.0 8.0 8.8 9.3 9.7 10.1 10.2
3.2 2.9 2.9 2.9 2.9 2.9 2.9 2.9 2.9
10.9*12.1*12.1*11.1*10.6*10.6*10.6*11.0* 5.6
3.8 4.1 4.1 3.4 3.4 3.4 3.4 3.4 3.4
4.7 4.0 3.6 3.2 1.8 1.4 1.1 1.4 1.4
0.7 0.7 1.4 1.8 2.2 2.5 2.5 2.2 2.5
1.1 1.4 1.4 1.8 1.4 .4 1.4 1.1 1.1
0.7 0.4 0.7 0.7 1.1 .4 1.8 2.2 2.2
1.9
1.8 2.2 1.8 1.8 1.8 .8 1.8 1.4 1.4
0.7 0.7 1.1 1.4 1..8 .8 2.2 2.5 2.2
1.1 0.7 0.7 1.1 1.1 .1 0.7 0.7 0.7
2.4
2.2 1.8 1.8 2.2 2.5 2.5 2.5 2.5 2.5
1.4 1.4 1.4 1.4 1.4 1.6 2.2 2.5 2.9
0.7 1.1 1.1 1.4 1.8 1.8 1.8 1.8 1.8
2.4 3.4 3.8 3.8 3.4 3.1 2.7 2.7 2.1
5.2
8.3
6.5
8.2
2.9
3.2
2.3
1.1
2.5
1.1
2.5
1.6
1.1
2.2
0.7
2.1
2.9
2.9
1.8
1.4
4.5
7.4
5.5
7.5
4.1
3.2
1.4
1.4
1.8
1.4
2.9
1.8
1.4
2.2
0.4
2.8
2.9
2.9
2.2
1.4
4.3
7.3
4.8
6.9
4.3
3.3
1.2
1.6
1.6
1.2
2.9
2.1
1.2
2.1
0.0
2.8
2.9
2.9
2.1
1.6
3.7
9.3
4.0
6.0
5.8
3.4
1.2
1.6
1.2
1.6
2.9
2.1
0.8
2.1
0.4
2.0
2.9
2.5
2.1
2.1
6
4.0
6.3
2.9
2.9
2.9
6.0
7.7
2.5
2.5
7.3
7.6
3.7
9.3
4.0
5.4
7.4
3.4
1.2
2.1
1.2
2.1
2.9
2.1
0.8
2.5
0.8
2.0
2.9
2.5
2.1
2.5
7
3.1
6.3
2.9
2.9
.2.9
7.1
7.3
2.5
3.0
9.9
8.3
3.7
9.3
5.3
5.0
8.1
4.8
3.2
2.5
0.8
1.6
2.9
2.9
1.2
2.5
1.2
2/0
2.9
2.5
2.1
2.9
8
2.1
5.1
2.9
2.9
2.9
4.7
6.7
2.5
4.9
9
2.1
4.0
2.5
2.9
2.9
4.3
4.9
2.5
5.5
10
2.5
3.3
2.5
2.9
2.9
5.2
4.1
2.5
6.1
11
2.9
3.3
1.6
2.9
2.9
4.6
2.1
2.5
6.1
*
24
24
24
24
24
24
24
24
24
11.4*11.3*13.6*18.8*24
9.6
3.3
9.9
8.9
4.6
8.1
7.7
4.7
2.5
1.2
2.1
2.9
3.3
1.6
3.5
1.6
2.0
2.9
2.1
1.6
2.9
9.0
5.1
10.1
9.4
3.9
8.1
8.7
5.3
2.5
0.8
2.5
3.3
3.9
1.6
3.9
2.1
2.0
2.9
1.6
1.2
2.9
9.1
5.1
9.9
5.1
24
24
10.7*10.7*24
9.4
3.7
9.5
9.4
6.9
2.1
0.8
2.5
3.3
3.9
2.1
3.9
2.5
2.4
2.9
1.2
0.8
2.9
9.4
3.3
8.1
10.1
7.3
1.6
0.6
? 1
2.9
3.9
1.6
3.9
2.9
1.6
2.9
0.6
0.4
2.9
24
24
24
24
24
24
24
24
24
13
24
24
24
13
24
24
24
24
MAX
9.5
6.3
6.5
2.9
2.9
9.1
8.5
3.9
6.1
16.8
20.3
9.0
17.0
15.1
10.2
9.5
12.1
9.8
7.8
2.5
2.5
3.3
3.9
3.7
3.9
3.4
2.9
2.9
2.9
2.2
3.6
9 31 31 29 29 29 29 29 29 29 29 29 29 29 31 31 31 31 31 31 31 31 31 31 31
MAX 18.8 19.7 19.5 17.7 17.5 19.7 20.3 16.4 15.1 17.0 19.3 19.4 19.1 17.4 14.9 13.4 14.2 11.0 9.3 9.9 11.4 11.3 13.6 16.8
TOTAL SAMPLES = 722
MAXIMUM = 20.3
TOTAL PRIMARY EXCEEDANCES =
49
PERCENT OF POSSIBLE OBSERVATIONS = 97.0
TOTAL PRIMARY NON-OVERLAPPING VIOLATIONS =
* INDICATES ITEM EXCEEDED PRIMARY STANDARD OF 10.5 MILLIGRAMS PER CUBIC METER
(Page 5 of 16)
Figure 6.6.4-a - continued. Samole Standards Report
ARPSTDS (AQ0420)
cr
-a
O_
CU
<-t-
7?
ro
10
70
m
"^
o
70
—1
CO
STANDARDS REPORT PROG
70
1
33
— ^
fD
CU
n>
0
CU
tt>
* *
1— »
0
I — »
00
I—"
^
JO
D
rc
co
i
H- 1
SECTION 6.6.4
-o
CU
in
in
• .
CTl
-------
CTl
ro
'O
CO
oo
AQDHS-II S7AHOARDS REPOR7 FROM JAN 1979 70 DEC 1979
CARBON MONOXIDE
MAXIMUM OF 8 HOUR RUNNING AVERAGE
PAGE
S7A7E (35): NOR7H DAK07A
45
SI7E CODE: 35-0720-103
AGENCY (J): PRIVA7E
FROJEC7 (02): 50URCE-ORIEN7ED AMBIEN7 SURV.
CI7Y FOPULA7IOM: 50,000,000
AQCR POFULA7IOII: 50,000,000
EPA PEGIOH: 8
LOCA7ION: DAGREEF
COUN7Y (0720): MADISON
SI7E ADDR: COAL CREEK SI7E «3
S7A7ION 7YPE (23): SUBURBAN: COMMERICAL
AQCR: 172 SMSA: SI1SA
SLAMS/NAMS ID (3): 07HER/N07 CLASSIFIED
SUPFCmitIS AGENCY: HOR7H DAK07A AIR POLLU7ION DEP7
LA7I7UDE: N12 D. 12 M. 34 S.
LONGI7UDE: W123 0. 12 M. 34 S.
ZONE 14 U7M ZONE: 13
U7M NOR7HING: 999.9000 M.
U7M EAS7ING: 507.9000 M.
ELEVA7ION ABOVE GROUND: 17.2 M.
ELEVA7ION ABOVE MSL: 10,000 FT.
7IME ZONE: PACIFIC
COLLEC7ION ME7HOO: INS7RUMEN7AL
JANUARY FEBRUARY
ANALYSIS ME7HOD: DE7EC7ION 7UBE
MARCH
APRIL
MAY
JUNE
JULY
AUGUS7 SEP7EMBER OC70BER NOVEMBER DECEMBER
D
A
Y
0
F
M
0
M
T
H
1
2
3
4
5
6
7
0
9
10
11
12
13
14
15
16
17
18
19
CO
£1
Zi
23
24
25
Zh
27
28
29
30
31
«
MAX
10.9»M
0.0 T
0.4 W
0.4 T
0.0 F
4.8 S
0.0 S
0.0 M
0.4 7
3.2 W
24.8*7
9.0 F
10.2 S
6.3 S
I7.i*n
14.9*7
5.7 W
27.4*7
29.5*F
17.2*5
8.3 S
10.2 M
7.6 T
15.9*W
17.0*7
11.4*F
9.2 S
12.2*3
3.4 M
4.7 7
8.8 W
739
29.5
7.3 T
2.2 F
2.9 S
5.2 S
6.2 M
3.4 T
3.3 W
9.2 T
7.1 F
4.4 S
7.5 S
7.5 M
2.9 T
6.8 W
2.9 T
5.7 F
4.0 S
6.2 S
40.1*M
37.1*T
21.0»W
4.0 T
23.6*F
29.3*3
12.4*S
35.6*M
36.1*7
2.2 W
672
40.1
2.9 T
4.2 F
22.7*3
24.6*3.
£4.1*11
2.3 7
2.5 W
0.7 7
0.0 F
2.2 S
0.0 S
M
0.0 7
8.0 U
7.0 7
5.1 F
5.0 S
1.6 S
0.7 n
2.9 7
7.3 W
8.6 7
6.2 F
6.4 S
2.5 S
2.5 M
3.3 7
2.9 W
2.9 7
12.7*F
11.5*3
690
24.6
3.4 S
5.7 M
10.6*7
4.3 W
6.2 7
7.3 F
5.3 S
3.0 S
4.1 N
4.6 7
4.0 W
3.9 7
0.0 F
0.4 S
2.9 S
3.3 M
2.9 7
2.9 W
2.5 7
2.1 F
2.1 S
1.8 S
0.0 M
3.4 7
8.5 M
6.2 7
11.4*F
10.7*3
2.9 S
3.5 M
720
11.4
6.5 7
12.0*W
15.4*7
11.6*F
5. 1 S
2.9 S
4.6 n
7
W
2.9 7
14.5*F
33.3*3
3.0 S
10.9*M
12.3*7
2.9 W
2.2 7
4.1 F
4.3 S
21.6*3
27.5*M
6.0 7
12.5*W
15.2*7
3.8 F
10.3 S
9.9 S
2.9 M
5.2 7
3.8 W
10.1 7
656
33.3
3.9 F
5.1 S
4.5 S
2.9 M
36.5*7
34 . 1 *W
33.2*7
48.5*F
63.2*3
49.2*3
46.4*11
56.3*7
51.0*W
26.9*7
33.7*F
30.5*3
26.8*3
26.2*M
16.2*7
14.9*W
23.3*7
32.7*F
28.3*3
26.0*S
31.2*M
68.3*7
78.2*W
45.6*7
47.0*F
49.8*3
701
78.2
31.0*3
46.7*M
34.8*7
21.8*W
21.0*7
35.6*F
17.9*3
32.8*3
44.5*M
48.0*7
23.1*W
44.0*7
37.2*F
21.0*3
22.0*3
35.9*M
25.0*7
44.3*M
55.0*7
67.0*F
34.7*3
33.4*3
32.2*M
31.8*7
24.9*W
26.3*7
42.9*F
43.2*3
31.2*3
37.9*M
9.9 7
744
67.0
9.5 W
6.3 7
6.5 F
2.9 S
2.9 S
9.1 M
8.5 7
3.9 W
6.17
18.8*F
20.3*3
9.0 S
17.0*M
15.1*7
10.2 »
9.5 7
12.1*F
9.8 S
7.8 S
2.5 M
2.5 7
3.3 W
3.9 7
3.7 F
3.9 S
3.4 S
2.9 M
2.9 7
2.9 W
2.2 7
3.8 F
722
20.3
2.5 S
3.5 S
2.5 M
3.0 7
2.5 M
2.2 7
2.2 F
0.0 S
0.0 S
0.0 M
0.0 7
0.0 M
0.0 7
0.0 F
0.0 S
0.0 S
7.9 M
7.3 7
7.1 W
14.7*7
22.9*F
5.7 S
4.2 S
13.6*M
13.2*7
7.3 W
3.2 7
3.5 F
9.9 S
11.6*3
720
22.9
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
. F
S
S
M
7
M
7
F
S
S
(1
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
7
M
7
F
S
S
M
707AL SAMPLES = 6364
MAXIMUM = 78.2
707AL PRIMARY EXCEEDANCES =
104
PERCEN7 OF POSSIBLE OBSERVA7IONS = 72.0
707AL PRIMARY HON-OVER.LAPPING VIOLA7IONS
* INDICA7ES I7EM EXCEEDED PRIMARY S7ANDARD OF 10.5 MILLIGRAMS PER CUBIC ME7ER
(Page 6 of 16)
Figure 6.6.4.a - continued. Sample Standards Report
75
ARPSTDS (AQ0420)
c
CL
Oi
=«fc
* *
ro
33
n
-Q
0
33
-H
CO
STANDARDS REPORT PROGRAM
Releas
n>
Q>
fD
i — »
0
CO
00
1 — '
^
d
o
re
CO
1
,— 1
^— I
SECTION 6.6.4
-o
01
in
fD
,_,
^
-------
AODHS-II STANDARDS REPORT FOR APRIL 1979
SULFUROIOXIOE
1 HOUR VALUES
PAGE
54
STATE (35.): NORTH DAKOTA
SITE CODE: 35-0000-104
AGENCY (Jl: CR1VATE
FROJITCT (02): SOWCE-ORIENTED AMBIENT SURV.
CM
PO
10
i— •
CO
rn XZ)
~o O
o re
73 CO
— 1 1
CO >— «
t-H
3=> CO CO
xi —i m
-a 3= o
co -z. — i
— \ CTJ »-H
0 > 0
CO 70 Z.
o
— - co en
.0 73 cn
o m •
.p. -a -p.
ro O
CD 73
*^^ 1
Ig
O
CD
S
"^
T3 m O>
O- — * to
Cu (V CD
rt- Ol
fO in
=*)= t--
C CO
OJ
vo "*
I—"
o
CO
1— •
co
1— '
Figure 6.6.4-a - continued. Sample Standards Report
-------
AQDHS-II STANDARDS REPORT FROM JAM 1979 TO DEC 1979
SULFUR DIOXIDE
1 HOUR MAXIMUMS
PAGE
STATE (35): NORTH DAKOTA
60
ro
to
SITE CODE: 35-0080-10'*
AGENCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
SUPPORTING AGENCY: NORTH DAKOTA
COLLECTION METHOD: INSTRUMENTAL
JANUARY FEBRUARY
1 M T
2 T F
D 3 W S
4 T S
A 5 f M
6 S T
Y 7 S W
8 M T
9 T F
10 M S
0 11 T S
12 F M
F 13 OS T
14 OS W
15 0 M T
16 0 T F
M 17 65 W S
18 0 T S
0 19 F M
20 S T
N £1 S W
£2 M T
T 23 T F
24 W S
H 25 T S
26 F M
27 S T
28 S W
£9 M
30 T
31 W
» 108
MAX 65
MEAN 11
TOTAL SAMPLES = 2753
ARITHMETIC MEAN = 67
ARITHMETIC STANDARD DEVIATION =
AIR POLLUTION
LOCATION: MONTPELIER
COUNTY (0080): MADISON
SITE ADDS: WARREN PETROLEUM
STATION TYPE (23): SUBURBAN:
AGCR: 172 SMSA: SMSA
SLAMS/HAMS ID (3): OTHER/NOT
DEPT
SITE 83
COMMERICAL
LATITUDE:
LONGITUDE
47 16 UTM ZONE:
N12 D.
: W123 D.
13
UTM NORTHING: 999.
UTM EASTING: 507.
CLASSIFIED
ELEVATION
ELEVATION
TIME ZONE
12 M. 34
12 M. 34
9000 M.
9000 M.
ABOVE GROUND: 17
ABOVE MSL
: PACIFIC
: 10,000
S.
S.
.2 M.
FT.
ANALYSIS METHOD: FLAME PHOTOMETRIC
MARCH
T
F
S
S
M
T
M
T
0 F
0 S
0 S
0 M
0 T
0 W
0 T
F
S
S
M
T
W
T
F
S
S
M
T
U
T
F
S
134
0
0
APRIL MAY JUNE
26 S 39 T 157 F
13 M 39 U 262 S
39 T 0 T 65 S
79 W 13 F 39 M
131 T OS 92 T
OF S 92 M
131 S 0 M T
144 S 13 T 79 F
13 M 0 U 262 S
0 T 13 T 118 S
0 W 105 F 0 M
118 T 52 S T
170 F 26 S W
79 S 26 M T
65 S 0 T 52 F
0 M 26 W 26 S
0 T 157 T OS
118 W 13 F M
65 T 105 S T
65 F 13 S W
144 S 39 M T
92 S 65 T 13 F
13 M 262 W OS
39 T 26 T 52 S
39 W 131 F 52 M
0 T 196 S 52 T
13 F 13 S 13 W
131 S 39 M 26 T
105 S 26 T 65 F
39 M 65 W 52 S
65 T
684 694 404
170 262 262
62 52 71
MAXIMUM = 393
79
*** MEAN MEETS PRIMARY STANDARD OF
JULY AUGUST
S
M
T
U
T
F
S
S
M
T
W
T
F
S
S
M
T
M
T
F
S
S
M
T
W
63 T
92 F
65 S
13 S
92 M
52 T
125
92
63
52 W
92 T
13 F
0 S
0 S
328 M
131 T
13 W
288 T
393 F
52 S
262 S
79 M
0 T
0 M
13 T
157 F
183 S
52 S
52 M
52 T
26 M
13 T
328 F
S
S
131 M
118 T
118 W
52 T
262 F
580
393
112
PERCENT OF
SEPTEMBER OCTOBER NOVEMBER DECEMBER
S
S
M
37 T
65 W
T
F
S
S
M
T
W
T
F
S
S
M
T
U
T
F
S
S
M
T
U
T
F
S
S
24
65
51
M
T
N
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
U
T
F
S
S
M
T
W
POSSIBLE OBSERVATIONS = 31
T
F
S
S
M
T
M
T
F
S
S
M
T
U
T
F
S
S
M
T
W
T
F
S
S
M
T
M
T
F
.0
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
s
M
T
M
T
F
S
3
M
T
H
T
F
S
S
M
80 MICROGRAMS PER CUBIC METER
/r>_
o
>
yo
O
CO
TO
rn
-o
0
TO
— )
TO
O
(75
TO
•^
TO
fD
rc>
CU
CO
(0
Cu
rt-
™.
i— '
0
CO
1 — '
oo
1 — t
^
JO
1C
CO
1
t~H
1—1
CO
m
o
—1
t— (
o
•z.
01
CTi
^
-o
OJ
*s
••
1 — '
V£5
Figure f.6.4ra - continued. Sample Standards Report
-------
AQOHS-II STANDARDS REPORT FOR APRIL 1979
SULFUR DIOXIDE
3 HOUR RUNNING AVERAGE
PAGE
STATE (35): NORTH DAKOTA
63
ro
SITE CODE: 35-OOSO-104
AGENCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
SUPPORTING AGENCY: NORTH DAKOTA AIR
COLLECTION METHOD: INSTRUMENTAL
MDNT 12345
01 S 0 4 9 17 17
02 M 0 0 0 0 0 0
03 T 4 4 4 9 9 4
04W04 9 9 9 4
05 T 0 0 0 0 26 48
06 F 0 0 0 0 0 0
07 SO 4 4 4 0 0
03 S 65 87 44 26 4 9
09 M 0 4 4.4 0 0
10 TO 0 0 0 0 0
11 U
12 T 0 17 17 17 0 13
13 F ZZ 17 13 0 0 0
14 S 31 9 9 9 31 35
15 S 13 13 17 13 13 22
16 M 0 0 0 0 0 0
17 TO 0 0 0 0 ' 0
18 W 0 0 0 00 0
19 T 0 4 9 17 26 26
20 F 13 9 9 0 0 0
21 S 17 31 13 13 0 0
22 S 87 92 48 22 9 13
23 M 13 13 13 13 13 13
24 T 13 13 13 13 13 9
25 WO 0 0 0 0 0
A/ T n ft n n n n
CO 1 U U U U U U
** °? c /v ft di n n £±
t./rH H 4 U U H
23 SO 0 0 0 0 0
29 S 4 4 4 0 4 4
30 M 43 35 13 0 O'O
tt 28 29 29 29 29 29
MAX 87 . 92 48 26 31 48
TOTAL SAMPLES = 693
+ INDICATES ITEM EXCEEDED SECONDARY
LOCATION: MONTPELIER
COUNTY (0080):. MADISON
SITE ADDR: WARREN PETROLEUM
STATION TYPE (23): SUBURBAN
AQCR: 172 SMSA: SMSA
SITE 83
: COMMERICAL
47
16
SLAMS/NAMS ID (3): OTHER/NOT CLASSIFIED
POLLUTION
DEPT
LATITUDE: N12 D. 12 M. 34
LONGITUDE: W123 D. 12 M. 34
UTM ZONE: 13
UTM NORTHING: 999.9000 M.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17
ELEVATION ABOVE MSL: 10,000
TIME ZONE: PACIFIC
S.
S.
.2 M.
FT.
ANALYSIS METHOD: FLAME PHOTOMETRIC
6
13
0
0
4
46
0
0
9
0
0
17
57
44
17
0
0
0
22
0
0
13
13
0
0
4
0
29
57
7
4
0
0
0
26
0
0
57
0
0
17
57
39
26
0
0
0
31
0
0
13
13
0
0
0
0
29
57
8 9 10 11 NOON 1
0 0 P 0 0 0
0 0 0 4 4 7
P P 0 0 4 7
0 4 31 31 26 0
26 70 79 100 70 85
000000
444000
70 70 22 4 0 0
000000
000000
9 9 35 70 70 65
61 7 52 39
44 39 44 35 31 9
17 26 22 39 39 31
0 0 0 0 00
000000
0 13 13 13 0 0
44 39 22 9 9 4
0 0 0 0 0 22
000000
13 13 13 13 13 13
13 13 13 13 13 13
0 13 13 13 0 0
On n n n n
u u u u u
44 44 48 9 17 22
000000
0 0 0 0 0 0
29 29 28 28 29 29
70 70 79 100 70 85
MAXIMUM = 100
TOTAL
STANDARD
SECONDARY EXCEEDANCES =
2 3
0 0
7 13
7 7
0 0
20 7
0 0
20 20
0 0
0 0
0 0
7 7
31 13
9 9
9 0
0 0
0 0
0 17
0 0
22 22
0 0
13 13
13 13
/, /.
H <4
0 0
On
U
(. /.
H H
17 13
0 0
0 0
29 29
31 22
4
0
13
4
0
4
0
17
0
0
0
9
17
35
0
0
. 0
52
0
0
4
13
13
0
4
0
0
29
52
PERCENT OF
0 TOTAL
5
0
13
4
P
4
0
22
0
0
0
9
17
31
0
0
0
52
0
17
9
13
13
0
4
4
9
29
52
6
0
9
13
0
0
0
48
0
0
0
9
39
44
0
0
0
74
0
17
9
13
13
t •»
1 J
0
0
17
17
29
74
POSSIBLE
7 8 9 10 U *
0 0 0 0 0 23
4 OP 0 4 24
13 13 0 0 0 24
0 0 P 0 0 24
0 0 00 0 24
0 0 0 0 0 24
65 52 35 13 52 24
0 0 0 0 0 24
0 0 00 0 24
14
0 0 0 0 0 10
9 22 17 17 9 24
48 52 48 52 44 22
31 31 22 13 13 24
0 0 0 0 0 24
0 0 0 0 0 24
0 0 0 0 0 24
79 79 44 4 4 24
0 0 22 26 26 24
17 13 22 22 26 24
52 52 7P 35 74 24
13 13 13 13 13 24
13 13 13 13 13 24
1 "7 i "7 6. n n 9^
1 / 1 / H U U tH
0 0 0 0 0 24
On n n n ?6.
u u u . u C.H
On n n n ?&
u u u u t"
0 0 0 0 0 24
17 13 35 48 70 24
22 17 13 9 4 24
29 29 29 29 29
79 79 70 52 74
OBSERVATIONS = 96.0
SECONDARY NON-OVERLAPPING VIOLATIONS =
MAX
17
13
13
31
100
0
6.5
87
4
0
0
70
61
44
39
0
0
79
44
26
74
92
13
i 7
1 I
13
48
70
48
0
OF 1300 MICROGRAMS PER CUBIC METER
(Page 9
Of
16)
m
XI
o
— i
CO
>• CO
~o iS
CO z
c >
CO 73
^— , CO
~o
ho o
O 73
••— •• — H
-o
^
CD
73
a 73
T3 ft)
Q- — '
cu (D
<-*• Cu
=«=
• • C1
Cu
ro ro
vo ..
o
CO
I—1
oo
,§
o
1C
CO
1
h— *
t— 4
CO
i ' 1
o
—i
o
2:
Ol
CT)
-^
-o
CU
CD
ro
p
Fioure 6.G.4ra - continued. Sample Standards Report
-------
AQDHS-II STANDARDS REPORT FROM JAN 1979 TO DEC 1979
SULFUR DIOXIDE
MAXIMUM OF 3 HOUR RUNNING AVERAGE
PAGE
STATE (35): NORTH DAKOTA
69
SITE CODE: 35-0080-104
AGENCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AGCR POPULATION: 50,000,000
EPA REGION: 8
LOCATION: MONTPELIER
COUNTY (0080): MADISON
SITE ADDS: WARREN PETROLEUM SITE 83
STATICN TYPE (23): SUBURBAN: COMMERICAL
AOCR: 172 SMSA: SMSA
SLAMS/NAMS ID (3): OTHER/NOT CLASSIFIED
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
COLLECTION METHOD: INSTRUMENTAL
LATITUDE: N12 0. 12 M. 34 S.
LONGITUDE: WI23 0. 12 M. 34 S.
47 16 UTM ZONE: 13
UTM NORTHING: 999.9000 M.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17.2 M.
ELEVATION ABOVE MSL: 10,000 FT.
TIME ZONE: PACIFIC
ANALYSIS METHOD: FLAME PHOTOMETRIC
JANUARY FEBRUARY
MARCH
APRIL
MAY
JUNE
JULY
AUGUST SEPTEMBER OCTOBER NOVEMBER DECEMBER
CT>
ro
WD
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
23
29
30
31
S
MAX
M
T
W
T
F
S
S
M
T
W
T
F
0 S
0 S
0 M
0 T
22 W
0 T
F
S
S
M
T
W
T
F
S
S
M
T
W
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
111
22
T
F
S
S
M
T
M
T
0 F
0 S
0 S
0 M
0 T
0 H
0 T
. F
S
S
M
T
W
T
F
S
S
M
T
W
T
F
S
134
0
17 S
13 M
13 T
31 W
100 T
0 F
65 S
87 S
4 M
0 T
0 W
70 T
61 F
44 S
39 S
0 M
0 T
79 W
44 T
26 F
74 S
92 5
13 M
17 T
13 W
0 T
9 F
48 S
70 5
48 M
693
100
22 T
26 »
0 T
4 F
0 S
S
0 M
9 T
0 U
9 T
52 F
44 S
31 S
22 M
0 T
22 W
74 T
22 F
48 S
17 S
26 M
35 T
175 W
17 T
92 F
87 S
13 S
17 M
22 T
52 W
31 T
697
175
65 F
109 S
48 S
31 M
61 T
48 W
T
52 F
153 S
157 S
0 M
T
W
T
35 F
17 S
9 S
M
T
W
T
13 F
4 S
39 S
35 M
44 T
13 M
13 T
48 F
31 S
421
157
0 S
M
T
M
T
F
S
S
M
T
»
T
F
S
S
M
T
W
T
F
S
S
M
T
W
61 T
41 F
31 S
9 S
57 M
.31 T
129
61
32 W
70 T
4 F
4 S
0 S
140 M
151 T
4 N .
170 T
179 F
26 S
109 S
26 M
26 T
0 W
9 T
122 F
83 S
26 S
32 M
25 T
17 M
7 T
124 F
S
S
61 M
39 T
82 M
31 T
100 F
587
179
S
S
M
12 T
39 M
T
F
S
S
M
T
»
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T.
F
S
S
24
39
M
T
W
T
F
S
S
M
T
M
T
f
S
S
M
T
M
T
f
S
S
M
T
U
T
f
S
S
M
T
U
T
F
S
S
M
T
M
T
F
S
S
M
T
»
T
F
S
S
M
T
M
T
F
S
S
M
T
W
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
TOTAL SAMPLES = 2796 MAXIMUM = 179 PERCENT OF POSSIBLE OBSERVATIONS = 31.0
TOTAL SECONDARY EXCEEDANCES = 0 TOTAL SECONDARY NON-OVERLAPPING VIOLATIONS
+ INDICATES ITEM EXCEEDED SECONDARY STANDARD OF 1300 MICROGRAMS PER CUBIC METER
(Pace 10 of 1C)
Fiaure 5.6.4-a - continued. Sample Standards Report
ARPSTDS (AQ0420)
T:
Q.
o>
<-t-
ro
-tfc
• .
ro
vo
73
m
-^
o
'O
oo
STANDARDS REPORT PROGF
S**
g
ro
ro
Oi
co
ro
a
a>
ro
• •
i — '
o
oo
1— »
00
1—"
^
JO
a
31
OO
SECTION 6.6.4
-o
Ol
(O
ro
• *
ro
»— *
-------
AQDHSrll STANDARDS REPORT.FROM JAN ;1979 TO DEC 1979
S U.L:F; U Rt -. "o :,I. 0; X ,,I D,;. E
MAXIMUM OF 24 HOUR RUNNING AVERAGE
PAGE
STATE (35): NORTH DAKOTA
78
SITE CODE: 35-:008,0-104
AGENCY (J): PRIVATE:
PROJECT, (02): .SOURCE-ORIENTED AMBIENT SURV.
CITY .POPULATION: 5.0*000 .,000
.A'fJCR. POPULATION: 50,000,000
ERA REGION: 8 .
: LOCATION :,jt1pNTRE.L-I:ER
'COUNTY: (0,080). HAD.ISPH-
SITE. ADCR: -WARREN PETROLEUM SITE 83
STATION TYPE ..(23;.): SUBURBAN: COMMERICAL
.AQCR: 172 i.-SMSA,: -SMSA,
S.LAMS/NAMS ID (3): OtHER/NOT CLASSIFIED
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
LATITUDE: N12 0. ?12 ;M. 34 S.
'' LONGITUDE: W123 D. 12 M. 34 S.
47 16 .UTM ZONE-U'lS
>UTM NORTHING: ,999..9000 'M.
UTM EASTING: 50-7..9000 M.
ELEVATION ABOVE GROUND: •'1-.7.2.M.
ELEVATION ABOVE'MSL: 10,000 FT.
TIME ZONE: PACIFIC
COLLECTION METHOD: INSTRUMENTAL
ANALYSIS METHOD: FLAME PHOTOMETRIC
< a
fe-
•fe"
JANUARY FEBRUARY
."i
2
S
,4
5
6
t7
8
".9
ib
ii
12
13
1.4
15
i'6
17
18'
19
20
21
22
23
24
25'
26
27
28
29
3b
31
tt
IAX
1 M
T
w
T
•F '
•s-
:'S
»
T
W
T
F
,• S
9 s
0 M
b t
i w
4 T
F
' S
S
M
T
M
T
F
S
s
tl
J;
M
105
. 4
,T
. V
s
s
M
T
W
t
F
S
S
H
T
14
T
F
s
S
M
T
W
T
F
S
S
M
T
ii
"T
MARCH
^
?T
JF
S
:S
M
,J
W
T
,. ,'p.
b s
OS
0 M
,0 T
6 w
6 T
F,
• ' ' s
s
M
T
W
'. • T
F
S
S
M
T
H
t
F,
"s
123
6
APRIL
4 S
3 M
5 J
•9 -H
,"2.5 T
25 F
19 S
is s
14 M
1 t
.-'. W
20 T
• • - 32 F
• .#§•
27 S
12 M
, 0 T
19 W
28 T
15 F
i? s
31 S
14 M
13 T
6 M
2 T
2 1-
5? S
12 S(
i4 M
667
36
MAY
;8 JT
8 M
6 T
:1 F
0 S
;S-
c ri
1 sT
i -w
- •;:? j
14 F,
is "s
J7 S
1;1 M
S J
3 M
20 T
22 F,
'J9 S
17 S
,5 fj
li fl
46 N
38 T
38 F
42 S
:25 S
5 M
i? 3-
i? w
17 t
688
46
JUNE
27 f
3?1 S
3S ^5
16 M
20 iij
24 :W
;T
v '
s
s
M
j
TOTAL SAMPLES = 2656
MAXIMUM,,= 5P
TOTAL PRIMARY EXCEEDAHCES =
PERCENT-OF POSSIBLE OBSERVATIONS =v 30.0
TOTAL PRIMARY NON-OVERLAPPING VIOLATIONS
* INDICATES JtEM EXCEEDED PRIMARY STANDARD OF 365 MICROGRAMS PER CUBIC METER
(Page 12 of 16)
ARPSTDS '(AQ0420)
cr
•a
Q.
05
=«=
ro
' ". " •
?3
-D
0
^
CO
•3=j
CO
m
G>
1
S3
fD
CD
l/l
0,
a,
(D
i — *
o
1— J
po
ii
^
a:
CO
SECTION 6.4i4 - C'-
t3
tiD
fD
ft-
co
;-
ro
vL
5
Figure 6.6.4-a'.- continued }amp"Te Standards Report
-------
AQDHS-II STANDARDS REPORT FROM JAN 1979 TO DEC 1979
SULFUR DIOXIDE
DAILY VALUES
PAGE 135
STATE (35): NORTH DAKOTA
SITE CODE: 35-0720-103
AGENCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
LOCATION: DAGREEF
COUNTY (0720): MADISON
SITE ADDR: COAL CREEK SITE
S.
S.
*3
STATION TYPE (23):
AQCR: 172 SMSA:
SLAMS/NAMS ID ( ):
SUBURBAN:
SMSA
COMMERICAL
SUPPORTINS AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
LATITUDE: N12 D. 12 M.
LONGITUDE: H123 D. 12 M.
ZONE 14 UTM ZONE: 13
UTM NORTHING: 999.9000 M.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17.2 M.
ELEVATION ABOVE MSL: 10,000 FT.
TIME ZONE: PACIFIC
COLLECTION METHOD: BUBBLER
ANALYSIS METHOD: PARAROSANILINE
Ti
ro
'O
I—•
&
CJ1
JANUARY FEBRUARY
1
2
3
4
5
6
7
6
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
23
29
30
31
8
MAX
MEAN
M
T
21 W
T
F
S
S
M
T
U
T
F
S
S
M
T
M
T
F
S
S
M
T
U
T
F
S
S
M
T
W
1
21
21
T
0 F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
W
T
F
S
S
M
T
M
1
0
0
MARCH
T
F
S
0 S
M
T
M
T
F
S
S
M
T
U
T
F
S
S
M
T
U
T
F
S
S
M
T
M
T
F
S
1
0
0
APRIL
S
M
8 T
U
T
F
S
S
M
T
W
T
F
S
S
M
T
W
T
F
S
S
M
T
M
T
F
S
S
M
1
8
8
MAY
T
W
8 T
F
S
S
M
T
M
T
F
S
S
M
T
U
T
F
S
S
M
T
M
T
F
S
S
M
T
W
T
1
8
8
JUNE
F
10 S
S
M
T
W
T
F
S
S
M
T
W
T
F
S
S
M
T
W
T
F
S
S
M
T
M
T
F
S
1
10
10
JULY
S
5 M
T
M
T
F
S
5 S
M
T
U
T
F
3 S
S
M
T
M
T
3 F
S
S
M
T
M
8 T
F
S
S
M
T
5
8
5
AUGUST SEPTEMBER
8 M
T
F
S
S
M
3 T
M
T
F
S
S
3 M
T
M
T
F
S
3 S
M
T
M
T
F
3 S
S
M
T
U
T
3 F
6
8
3
S
S
M
T
M
24 T
F
S
S
M
T
8 M
T
F
S
S
M
8 T
U
T
F
S
S
8 M
T
U
T
F
S
5 S
5
24
10
TOTAL SAMPLES = 22
ARITHMETIC MEAN = 7
ARITHMETIC STANDARD DEVIATION = 6
*** MEAN MEETS PRIMARY STANDARD OF
MAXIMUM = 24
TOTAL PRIMARY EXCEEDANCES =
80 MICROGRAMS PER CUBIC METER
» INDICATES ITEM EXCEEDED PRIMARY STANDARD OF
365 MICROGRAMS PER CUBIC METER
(Page 13 of 16)
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
W
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
T
M
T
F
S
S
M
ARPSTDS (AQ0420)
c:
•a
a.
a.
C+
ro
=*t=
ro
vo
33
m
-o
0
Co
STANDARDS REPORT PROG
70
73
ro
ro
fa
en
ro
QJ
ro
" *
0
CO
1 — *
CO
I—1
^
X3
C3
nc
CO
t— *
SECTION 6.6.4
a>
(O
ro
• »
ro
"^
Figure 6.6.4-a - continued. Sample Standards Report
-------
CTl
AQDHS-II STANDARDS REPORT FOR
SITE CODE: 35-0720-103
AGENCY (J): PRIVATE
N I
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
SUPPORTING AGENCY: NORTH DAKOTA AIR
COLLECTION METHOD: INSTRUMENTAL
MONT 12345
01 S 9 9 28 49 32 21
02 M 34 28 32 34 34 62
03 T 30 32 36 32 34 49
04 W 26 26 24 26 32 36
05 T 26 21 9 9 24 47
06 F 49 55 21 23 83 100
07 S 32 32 9 9 21 28
08 S 21 21 19 19 24 38
09 M 9 21 9 9 9 55
10 T 58 28 55 30 70 135
11 W 9 9 9 9 9 30
12 T 9 9 9 34 56 137
IT c T *> 1Q i O TQ TC Aft
13 r Jc. 07 Oi_ J7 to OO
| f, Q /. T "TA Q O O Q
1H J Mj JO 7777
15 59 9 9 9 9 9
16 M 19 34 21 9 38 141
17 T 9 9 9 28 9 68
18 W 21 32 9 33 38 263
19 T 9 51 21 32 23 323
20 F 73 49 49 70 113 235
21 S 43 9 9 9 26 102
99 C "IA Q Q Q Q Q
Cfc O JO 77777
91 M Q Q O Q 91 77
c j n 7 v 7 7 1 1 //
24 T 53 28 28 23 23 122
26 T 30 99 9 9 28
27 F 21 9 9 9 . 9 43
28 S 34 32 23 9 30 34
29 S 36 23 19 9 9 9
30 M 36 39 9 21 24 100
31 TO 0 0 0 0 0
8 31 31 31 31 .31 31
MAX 73 55 62 70 113 323
MEAN 27 24 19 21 29 80
TOTAL SAMPLES = 713
ARITHMETIC MEAN = 32 .
ARITHMETIC STANDARD DEVIATION =
TROGEN DID
1 HOUR VALUES
LOCATION: DAGREEF
COUNTY (0720): MADISON
SITE ADDR: COAL CREEK SITE 83
JULY 1979
X
I D
E
ZONE
14
STATION TYPE (23): SUBURBAN: COMMERICAL
POLLUTION
6
28
103
47
41
98
94
30
36
47
38
47
154
•*f
9
147
64
133
256
218
68
I O
* 7.
9O7
fcU t
102
73
75
71
43
23
107
0
31
256
82
7
19
49
30
28
21
30
19
9
88
43
47
38
9 1
C i
. 9
45
9
9
9
21
34
nt
DO
38
41
51
9
21
21
51
0
31
83
29
AC5CR: 172 SMSA: SMSA
SLAMS/HAMS ID ( ) :
DEPT
ANALYSIS METHOD: COULOMETRIC
8 9 10 11 NOON 1
23 26 36 45 56 45
47 45 47 47 45 39
47 53 39 36 43 41
28 32 32. 24 26 30
9 23 21 23 21 21
24 21 21 99 23
9 9 9 9 21 19
53 34 118 109 21 9
62 9 9 19 9 21
19 9 9 9 9 9
39 28 71 26 9 9
9 23 113 38 21 132
9 21 19 21 23 51
32 26 9 9 9 9
9 36 21 45 32 24
9 9 62 47 47 30
.9 9 9 9 9 28
9 9 9 0 9 30
49 36 9 9 51 26
21 32 39 19 30 0
39 9 9 21 34 56
9 9 9 68 9 9
9 19 24 19 30 9
9 21 36 28 23 21
49 53 58 55 0 9
000900
31 31 31 31 31 31
62 53 118 109 56 132
22 22 29 26 21 25
2
36
55
39
30
21
21
32
21
23
9
9
23
,
34
30
21
23
9
9
9
28
0
47
9
9
9.
9
9
31
55
20
MAXIMUM = . 323
34
*** MEAN MEETS PRIMARY STANDARD
OF 100
.00 MICROGRAMS PER CUBIC METER
3
39
139
70
32
9
9
. 24
28
55
9
21
21
Q
7
3.9
34
30
24
45
9
9
70
0
75
21
9
24
9
9
31
139
29
4
60
49
47
30
9
24
32
24
21
9
9
26
38
36
9
26
38
9
51
9
43
0
28
30
9
55
0
3Q
60
26
PERCENT OF
5
56
36
39
28
9
23
30
38
9
9
9
9
9 1
£. \
9
9
21
21
43
0
9
9 1
21
0 i
<. 1
30
0
9
88
28
9
0
9
31
83
21
6
30
30
9
9
30
83
9
9
1 Q
1 7
9
0
30
62
28
64
9
9
20
83
23
POSSIBLE
PAGE 155
STATE (35): NORTH DAKOTA
LATITUDE: N12 D. 12 M. 34 S.
LONGITUDE: W123 D. 12 M. 34 S.
UTM ZONE: 13
UTM NORTHING: 999. 9000 M.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17.2 M.
ELEVATION ABOVE MSL: 10,000 FT.
TIME ZONE: PACIFIC
7 8 9 10 11 * MAX
56 62 43 36 32 23 62
62 122 71 41 36 23 139
24 39 41 45 34 23 70
34 30 28 30 24 23 41
23 32 70 43 43 23 98
9 9 21 24 21 23 100
30 26 30 9 9 23 32
94 68 32 36 9 23 118
124 162 85 51 41 23 162
9 9 23 21 9 23 135
21 70 28 43 9 23 71
39 24 45 36 23 154
9Q fl t 6.7 91 11C
7 Ol. H / C i * l->
9Q O O 91 £1
7 7 7 f. O H i
34 49 47 21 23 51
9 23 9 9 25 147
113 71 9 9 23 113
.24 92 9 9 23 263
100 118 79 70 23 323
9 9 9 9 23 235
45 .94 92 94 23 102
117 34 23 923 117
/.Q £,~7 TO TA OT. Om
H7 H f 3C OH CJ tUf
9 39 21 9 23 122
9 62 21 41 23 73
43 36 71 26 23 75
66 152 56 36 23 152
92 53 81 39 23 92
38 9 45 43 23 64
990 0 23 107
9 24 28 9 9 23 28
18 31 31 25 31
124 162 118 92 94
42 50 45 34 27
OBSERVATIONS =95.0
70
m
-o
o
70
— 1
CO
Ja CO
70 — 1
t) 3=
CO "Z.
—\ 0
CO TO
3=>
O m
ro O
CD TO
TO
O
CT3
70
§
c: TO
•D fD
D. — '
r+ Q>
ft)
=tf=
QJ
ro n>
i— •
o
CO
I—1
oo
1— '
>
.0
C3
CO
1
»— 1
,— (
CO
m
o
— I
K-<
Q
CT.
•
O">
•
-o
o>
n>
••
ro
Ul
(Page 14 of i
figure 6.(5.4-a - continued. Sample Standards Report
-------
cn
ro
AQDHS-II STANDARDS REPORT FROM JAN 1979 TO DEC 1979
NITROGEN DIOXIDE
1 HOUR MAXIMUMS
PAGE 161
STATE (35): NORTH DAKOTA
SITE CODE: 35-0720-103
AGENCY (J): PRIVATE
PROJECT (02): SOURCE-ORIENTED AMBIENT SURV.
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
LOCATION: DAGREEF
COUNTY (0720): MADISON
SITE ADDR: COAL CREEK SITE «3
STATION TYPE (23): SUBURBAN: COMMERICAL
AGCR: 172 SMSA: SMSA
SLAMS/NAMS ID (3): OTHER/NOT CLASSIFIED
COLLECTION METHOD: INSTRUMENTAL
JANUARY FEBRUARY
LATITUDE: N12 D. 12 M. 34 S.
LONGITUDE: W123 D. 12 M. 34 S.
ZONE 14 UTM ZONE: 13
UTM NORTHING: 999.9000 H.
UTM EASTING: 507.9000 M.
ELEVATION ABOVE GROUND: 17.2 M.
ELEVATION ABOVE MSL: 10,000 FT.
TIME ZONE: PACIFIC
ANALYSIS METHOD: COULOMETRIC
MARCH
APRIL
MAY
JUNE
JULY
AUGUST SEPTEMBER OCTOBER NOVEMBER DECEMBER
1
3
3
4
5
6
7
8
9
10
11
12
13
1*
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
8
MAX
MEAN
94 11
0 T
9 W
9 T
0 F
9 S
0 S
0 M
9 T
19 W
94 T
24 F
39 S
9 S
53 M
28 T
28 W
120 T
63 F
70 S
9 S
28 M
24 T
66 W
34 T
9 F
9 S
30 S
9 M
21 T
26 M
713
120
31
36 T
9 F
9 S
19 S
9 M
9 T
9 W
30 T
19 F
9 S
26 S
9 M
23 T
26 M
9 T
9 F
9 S
9 S
85 M
33 T
70 W
9 T
68 F
60 S
21 S
77 M
49 T
9 U
644
85
27
9 T
9 F
68 S
24 S
68 M
9 T
9 W
0 T
0 F
21 S
0 S
M
0 T
39 W
21 T
34 F
9 S
9 S
0 M
9 T
34 W
51 T
28 F
21 S
0 S
9 M
9 T
9 U
9 T
47 F
9 S
664
68
19
9 S
41 M
41 T
9 M
34 T
21 F
9 3
9 S
9 M
24 T
9 W
9 T
0 F
9 S
9 S
9 M
9 T
9 U
9 T
9 F
9 S
0 S
0 M
9 T
34 U
9 T
43 F
9 S
9 S
23 M
690
43
15
28 T
39 M
39 T
41 f
9 S
9 5
9 M
T
U
9 T
88 F
250 S
9 S
36 M
47 T
9 U
9 T
19 F
9 S
77 S
32 M
19 T
56 W
53 T
9 F
30 S
9 S
9 M
19 T
9 U
36 T
638
250
35
30 F
19 S
9 S
9 M
160 T
90 W
79 T
224 F
113 S
214 S
222 M
135 T
75 W
115 T
77 F
43 S
70 S
94 M
85 T
53 M
70 T
77 F
75 S
45 S
115 M
280 T
141 W
126 T
224 F
39 S
680
280
104
62 S
139 M
70 T
41 W
98 T
100 F
32 S
118 S
162 M
135 T
71 U
154 T
115 F
43 S
51 S
147 M
113 T
263 W
323 T
235 F
102 S
117 S
207 M
122 T
73 W
75 T
152 F
92 S
64 S
107 M
28 T
713
323
116
21 W
26 T
34 F
9 S
9 S
32 M
28 T
9 »
26 T
75 F
43 S
36 S
83 M
66 T
38 W
23 T
75 F
23 S
19 S
9 M
9 T
9 U
9 T
9 F
9 S
9 S
9 M
9 T
9 M
9 T
9 F
696
83
25
9 S
9 S
9 M
9 T
9 M
9 T
9 F
0 S
0 S
0 M
0 T
0 U
0 T
0 F
0 S
0 S
24 M
26 T
38 U
53 T
71 F
9 S
26 S
51 M
49 T
9 14
9 T
9 F
45 S
36 S
698
71
17
62 M
139 T
70 M
41 T
98 F
100 S
32 S
118 M
162 T
135 M
71 T
154 F
115 S
43 S
51 M
147 T
113 W
263 T
323 F
235 S
102 S
117 M
207 T
122 W
73 T
75 F
152 S
92 S
64 M
107 T
28 M
713
323
116
21 T
26 F
34 S
9 S
9 M
32 T
28 M
9 T
26 F
75 S
43 S
36 M
83 T
66 M
38 T
23 F
75 S
23 S
19 M
9 T
9 M
9 T
9 F
9 S
9 S
9 M
9 T
9 U
9 T
9 F
673
83
26
9 S
9 S
9 M
9 T
9 M
9 T
9 F
0 S
0 S
0 M
0 T
0 M
0 T
0 F
0 S
0 S
24 M
26 T
38 W
53 T
71 F
9 S
26 S
51 M
49 T
9 M
9 T
9 F
45 S
36 S
M
698
71
17
TOTAL SAMPLES = 8220 MAXIMUM =
ARITHMETIC MEAN = 46
ARITHMETIC STANDARD DEVIATION = 56
**» MEAN MEETS PRIMARY STANDARD OF
323
100 MICROGRAMS PER CUBIC METER
PERCENT OF POSSIBLE OBSERVATIONS = 93.0
Figure 6.6.4-a - continued.
(Page 15 of 16)
Sample Standards Report
ARPSTUS (AQ0420)
cr
T3
0.
Qj
rt
fD
=»>:
• •
ro
IO
70
i~f i
-o
o
70
~~t
CO
STANDARDS REPORT PRO
en
70
§
33
fD
fD
CU
C/)
fD
O
OJ
c-t-
fD
) — »
O
CO
1— J
oo
1— <
>
0
DC
CO
1
HH
1— 1
CO
m
o
—i
0
p1
-D
Ol
(£1
fD
• •
PO
a-i
-------
AQDHS-II STANDARDS REPORT FROM JAN 1979 TO DEC 1979
NITROGEN DIOXIDE
DAILY VALUES
PAGE 162
STATE. (35): NORTH DAKOTA
ro
oo
SITE CODE: 35-0720-102
AGEUCY (J): PRIVATE
PROJECT 102): SOURCE-ORIENTED
CITY POPULATION: 50,000,000
AQCR POPULATION: 50,000,000
EPA REGION: 8
LOCATION: ARTCLAIR
AMBIENT SURV.
CO'JNTY (0720):
SITE ADDR: COAL
STATION TYPE (2
MADISON
CREEK SITE *2.
3): SUBURBAN:
ZONE. 14
COMMERICAL
AGCR: 172 SMS A: SMSA
SLAMS/NAMS ID (
1 ) : NAMS
SUPPORTING AGENCY: NORTH DAKOTA AIR POLLUTION DEPT
COLLECTION METHOD: GAS BUBBLER
JANUARY FEBRUARY
1 2111 M 2153 T
2 218 T 11 F
0 3 0 W 2027 S
4 179 T 1830. S
A. 5 164 F 209 M
6 111 S 376 T
Y 7 184 S 197 W
8 212 M 231 T
9 28 T 64 F
10 135 W 166 S
0 11 252 T 167 S
12 2153 F 141 H
F 13 2027 S 19 T
14 1C50 S 183 14
15 209 M 3C9 T
16 376 T 382 f
M 17 197 W 2258 S
18 231 T 2837 S
0 19 64 F 2529 M
20 186 S 1965 T
N 21 16,7 S 141 M
22 141 M 3, T
T 23 19 T 169 F
24 188 M 376 S
H 25 1944 T 28 S
26 1983 F 70 M
27 1797 S 282 T
28. 1324 S 301 14
29 1324 M
30 103 T
31 252 W
* 31 28
MAX 2153 2837
MEAN 650 697
TOTAL SAMPLES = 322
ARITHMETIC MEAN = 501
ARITHMETIC STANDARD DEVIATION
*** MEAN EXCEEDS PRIMARY
MARCH
192 T
273 F
2111 S
3 S
218 M
179 T
164 W
111 T
184 F
212 S
28 S
135 M
231 T
197 W
147 T
226 F
329 S
216 S
169' M
164 T
260 W
284 T
254 F
162 S
168 S
43 M
103 T
252 M
2153 T
2027 F
1830 S
31
2153
424
ANALYSIS METHOD
APRIL MAY
209 S 113 T
376 M 169 14
0 T 9 T
197 M 226 F
231 T 459 S
64 F 273 S
186 S 2111 M
167 S 218 T
14.1 M 179 W
19 T 164 T
188 W 111 F
329 T 184 S
332 F 212 S
2258 S 28 M
2S37 S 135 T
2529 M 231 M
1965 T 197 T
301 W 147 F
290 T 226 S
389 F 329 S
2591 S 216 M
1944 S 169 T
1?33 M 141 14
1797 T 3 T
1324 M 169 F
276 T 376 S
231 F 28 S
167 S 70 M
3 S 282 T
17 M 301 W
192 T
30 31
2837 2111
760 247
: NASN SODIUM
JUNE
273 F
6 S
2111 S
218 M
179 T
164 M
111 T
184 F
212 S
28 S
141 M
3 T
301 W
290 T
389 F
2591 S
1944 S
1983 M
1797 T
1324 M
276 f
231 F
167 S
3 S
17 M
113 T
169 W
226 T
459 F
165 S
30
2591
536
ARSENITE
JULY
252 S
15 M
291 T
262 W
284 T
337 F
301 S
0 S
19 M
188 T
290 W
389 T
2591 F
8 S
S
M,
T
1944 M
141 T
13 F.
S
S
3 M
169, T
376 M
8 T
28 F
70 S
S
M
T
23
2591
348
AUGUST
13 H
329 T
382 F
2258 S
2837 S
M
0 T
2529 W
1965 T
1380 F
212 S
S
19 M
28 T
28 W
226 f
329 F
S
6 S
216 M
169 T
164 M
280 T
284 F
6 S
S
M
T
M
T
0 F
23
2837
594
.LATITUDE:
LONGITUDE:
UTM ZONE:
N12 D. 12 M
M123 D. 12 M
13
UTM NORTHING: 999.9000
UTM EASTING: 507.9000
ELEVATION
ELEVATION
TIME ZONE:
SEPTEMBER OCTOBER
254
162
186
43
103
0
252
2153
2027
19
1880
209
376
19
197
231
64
167.
3
0
17
113
169
226
0
25
2153
356
S 459 M
S 15 T
M 165 W
T 43 T
W 276 F
T 337 S
F 28 S
S 0 M
S 103 T
M 252 M
T 70 T
H 282 F
T 301 S
F 8 S
S M
S T
M H
T 192 T
M 273 F
T 13 S
F S
S M
S 2111 T
M 382 W
T 254 T
W 8 F
T 182 S
F 188 S
S M
S T
»
23
2111
258
ABOVE GROUND:
ABOVE MSL: 10
PACIFIC
. 34 S.
. 34 S.
M,
M.
17.2 M.
,000 FT.
NOVEMBER DECEMBER
13 T
2153 F
2027 S
1880 S
209 M
T
0 M
376 T
197 F
231 S
64 S
M
19 T
186 W
167 T
141 F
19 S
S
6 M
168 T
329 M
382 T
2258 F
2837 S
6 S
M
T
14
T
.F
22
2837
622
2529 S
1965 S
1380 M
167 T
3 M
0 T
17 F
113 S
169 S
M
T'
19 W
226 T
459 F
165 S
S
M
19 T
276 M
337 T
28 F
70 S
282 S
0 M
301 T
192 H
273 T
2111 F
S
0 S
M
25
2529
444
MAXIMUM = 2837
= 749
STANDARD OF
100 MICROGRAMS PER CUBIC METER
/ r» i /- _.r i /• \
70
m
o
^n
s**
—\
CO
> CO
70 — I
*m *i?a
\J J^
GO -z.
— 1 O
CO 70
O
• — - CO
.0 70
o rn
-0 -o
ro O
t , TO
•^^ — |
-a
70
O
CD
70
22
"*"
C TO
•a ro
a. — '
o> ro
r+ Qj
n>
=tfc
.. . o
QJ
ro ro
i — »
0
GO
^
oo
i— >
1=
•§
:c
i
»— 4
1—1
CO
m
— i
»— i
-^
,
01
•
f^
-Q
a>
ro
••
^j
Figure 6.6.4-a - continued. Sample Standards Report
-------
AQOHS-II STANDARDS REPORT PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ARPSTDS (AQ0420)
REVISION LEVEL: 1-00
LAST UPDATE «: 29
DATE INCORPORATED: OCTOBER 31, 1981
REPORT DATE IS: SEPTEMBER 25, 1961
NUMBER OF MASTER FILE RECORDS READ:
NUMBER OF SITE DATA RECORDS READ:
NUMBER OF PARAMETER RECORDS READ:
NUMBER OF POLLUTANTS REPORTED:
NUMBER OF REPORT PAGES WRITTEN:
NUMBER OF ABORTS DETECTED:
NUMBER OF DISASTERS DETECTED:
NUMBER OF WARNINGS DETECTED:
16,297
19
5
164
0
0
0
(ft
PO
UD
Figure 6.6.4-b. Diagnostic Report
70 >
m .Q
-o CJ
O 3C
TO CO
—I I
CO >—I
3=» co co
TO —I m
"^o ^P=» o
CO -Z. —1
—< O HH
a 3=- o
co TO -z.
a
*—•- CO CTi
XO 70 Ol
o m •
PO o
o TO
o
CT5
PO
3?
T3
a.
ro
=«-
PO
o
Cu
PO
O
CO
1—"
c»
Q;
IQ
re
PO
oo
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 29 ^
Release Date: 10/31/81
Update #: 29
Column 1
Column 18
[ run date ]
Enter the month, day, rand year to be printed on the standards report as
the run date in columns 1 through 18.
Figure 6.6.4-c. Option Card
629.150
-------
AQDHS-II
REPORTS
/*
SECTION 6.6.4 Page: 30
STANDARDS REPORT PROGRAM Release Date: 10/31/81
ARPSTDS (AQ0420) Update #: 29
00000100
/* PROCEDURE NAME: AQRPM60 00000200
/* REVISION LEVEL: 1-00 00000300
/* LAST
/* DATE
/*
/*
/* THIS
/* FROM
/*
/*
UPDATE ft: 29 00000400
INCORPORATED: OCTOBER 31, 1981 00000500
00000600
00000700
PROCEDURE GENERATES A STANDARDS REPORT 00000300
AN AQDHS-II MASTER FILE 00000900
00001000
00001100
/AQRPM60 PROC PROJECT='CN.EPALMH.A087.CDHS.HQ.AQS' , 00001200
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/
/*
PROG1=ARTSTDS, 00001300
PROG2=ASTSTDS, 00001400
PROG3=ARPSTOS, 00001500
REGION1 = 200K, -, 00001600
REGION2=100K, 00001700
REGION3=100K, 00001800
TIME1='5,0', 00001900
TIME2='2,0', 00002000
TIME3='2,0', 00002100
MSTRFIL=AQMASTER, 00002200
PARMFIL=AQPARMFL, 00002300
SITESRT=AQSRSITE, 00002400
DISP1='OLD, KEEP, KEEP1 , 00002500
DISP2=1NEM,PASSI , 00002600
DISP3='OLD, DELETE', 00002700
TEMP=SYSDA, 00002800
SPUNIT1=CYL, 00002900
SPUNIT2=TRK, 00003000
SPUNIT3=CYL, 00003100
SPUNIT4=CYL, 00003200
PRI1=50, 00003300
PRI2=20, 00003400
FRI3=50, 00003500
FRI4-50, 00003600
SEC1=10, 00003700
SEC2=10, 00003800
SEC4=10, 00003900
OUT=A 00004000
00004100
/* THIS STEP RETRIEVES MASTER FILE AND SITE FILE DATA 00004200
/*
/RETRIEVE
/
/
/*
/STEPLIB
/
/
/
/
/*
/SORTLIB
/
/*
00004300
EXEC PGM=&PROG1, 00004400
REGION=2REGION1, 00004500
TIME=(&TIME1) 00004600
00004700
DD DSNAME=SPROJECT..LOAD, 00004800
VOLUME=( PRIVATE, RETAIN), 00004900
DISP=(SHR,PASS) 00005000
DD DSNAME=SYS1.COBLIB, 00005100
DISP=(SHR,PASS) 00005200
00005300
DD DSNAME=SYS1. SORTLIB, 00005400
DISP=(SHR,PASS) 00005500
00005600
/* INPUT DATA SET - MASTER FILE 00005700
/*
/AQSMASTR
/
00005800
DD DSNAME=*PROJECT..DATA.*MSTRFIL, 00005900
VOLUME = ( PRIVATE .RETAIN ) , 00006000
DISP-( &DISP1 ) 00006100
(Page 1 of 4)
Figure 6.6.4-d. Cataloged Procedure AQRPM60
629.151
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 31
Release Date:
Update #: 29
•7'
10/31/81
/* INPUT DATA SET - PARAMETER FILE
/*
/AQSPARMC DD DSHAME=8PROJECT. .DATA.8PARMFIL,
/ VOLUME=( PRIVATE, RETAIN),
/ DISP=(8DISP1>
/*
/* INPUT DATA SET - SORTED SITE FILE
/»
/AQSTESRT DD OSNAME=8PROJECT. .DATA.8SITESRT,
/ VOLUME=< PRIVATE, RETAIN),
/ DISP=<«DISP1)
/*
/* INPUT DATA SET - OPTION CARD
/*
/AQSOPTIN DD DDNAME=OPTIONS,
/ DCB=BLKSIZE=80
/*
/* OUTPUT DATA SET - MASTER FILE DATA TO BE PASSED TO ASTSTDS.
/»
/AQSFRTRN OD DSNAME=88MFDATA,
/ &ISP=(8DISP2),
/ . UNIT=8TEMP,
/ SPACE=(8SPUNm,<«PRIl,*SECl),RLSE)
/«
/* OUTPUT DATA SET - SITE FILE DATA TO BE PASSED TO. ARPSTDS
/*
/AQSMSSTE DD DSNAME=i&SFDATA,
/ DISP=(8DISP2),
/ UNIT=STEMP,
/ SPACE = ( SSPUNIT2,( iPRI2,&SEC2) ,RLSE )
/»
/* SORT WORK FILES
/*
/SORTWK01 DD UNIT=STEMP,
/ SPACE=(iSPUNIT3,(«PR-I3),,CONTIG)
/*
/SORTWK02 DD UNIT=iTEMP,
/ SPACE=( 8SPUNIT3, ( 4PRI3 ) , .CONTIG )
/»
/SORTWK03 DD UNIT=4TEMP,
/ SPACE=(frSPUNIT3,(&PRI3),, CONTIG)
/*
/* OUTPUT DATA SET - DIAGNOSTICS
/*
/AQSPRINT DD SYSOUT=SOUT
/*
/* OUTPUT DATA SETS - SYSTEM OPERATION
/*
/SYSPRINT DD SYSOUT=80UT
/SYSOUT
DD SYSOUT=80UT
/SYSDBOUT DD SYSOUT=80UT
/*
/SYSDTERM DD SYSOUT=80UT
/*
/SYSUDUMP DD SYSOUT=80UT
/* THIS STEP CALCULATES STATISTICS
/*
00006200
00006300
00006400
00006500
00006600
00006700
00006600
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
00008000
00008100
00008200
00008300
00006400
00008500
00008600
00008700
00008800
00008900
00009000
00009100
00009200.
00009300
00009400
00009500
00009600
00009700
00009800
00009900.
00010000
00010100
00010200
00010300
00010400
00010500
00010700
00010800
00010900.
00011000.
00011100
OOOM200
00011.300
00011400
00011500
00011600
00011700
00011800
00011900
0001200
0001210
0001220
(Page 2 of
Figure 6.6.4-d - continued. Cataloged Procedure AQRPM60
629.152
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 32
Release Date: 10/31/81
Update #: 29
EXEC PGM=SPROG2,
REGIONS8REGION2,
/STAT
/*
/STEPLIB DD DSNAME=8PROJECT..LOAD,
/ VOLUMES PRIVATE,RETAIN),
/ DISP=(SHR,PASS)
/ DD DSMAME=SYS1.COBLIB,
/ DISP=(SHR,PASS)
/*
/* INPUT DATA SET - MASTER FILE DATA 'FROM ARTSTDS
/*
/FT08F001 DO OSNAME=88HFOATA,
/ DISP=(8DISP3)
/*
/* OUTPUT DATA SET - STATISTICS DATA FILE TO BE PASSED TO ARPSTDS
/*
/FT09F001 DD DSNAME=48MFSTATS,
/ DISP=(8DISP2),
/ UNIT=STEMP,
/ SPACE=(8SPUNIT4,(8PRI4,8SEC4),RLSE),
/ DCB=
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 33
Release Date: 10/31/81
Update #: 29
/AQSMSSTE DD DSNAME=44SFDATA,
/ OISP=(4DISP3)
/»
/* INPUT DATA SET - PARAMETER FILE
/*
/AQSPARMC DD DSNAME=4PROJECT..DATA.4PARMFIL,
"/ VOLUMES PRIVATE, RETAIN),
/ DISP=(40ISP1)
/*
/* INPUT DATA SET - OPTION CARD
/*
/AQSOPTIN DD DDNAME=OPTIONS,
/ DCB=BLKSIZE=80-
/*
/* OUTPUT DATA SET - DIAGNOSTICS
/»
/AQSDIAG DD SYSOUT=40UT
/*
/* OUTPUT DATA SET - STANDARDS REPORT
/*
/AQSREPRT DD SYSOUT=*OUT
/*
/« OUTPUT DATA SETS - SYSTEM OPERATION
/*
/SYSOUT DD SYSOUT=40UT
/*
/SYSPRINT DD SYSOUT=«OUT
/*
/SYSDBOUT DD SYSOUT=SOUT
/*
/SYSUDUMP DD SYSOUT=SOUT
/*
/SYSDTERM DD SYSOUT=40UT
00018400
00018500
00016600
00018700
00018800
00018900
00019000
00019100
00019ZOO
00019300
00019400
00019500
00019600
00019700
00019800
00019900
00020000
00020100
00020200
00020300
00020400
00020500
00020600
00020700
00020800
00020900
00021000
00021100
00021200
00021300
00021400
00021500
00021600
00021700
(Paye 4 of 4)
Figure 6.6.4-d - continued. Cataloged Procedure AQRPM60
629.154
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 34
Release Date: 10/31/81
Update #: 29
Parameter Name
PROJECT
PROG1
PROG2
PROG3
REGION1
RE6ION2
REGIONS
TIME1
TIME2
TIME3
MSTRFIL
PARMFIL
SITESRT
Default Value
'CN.EPALMH.A087.CDHS.
HQ.AQS1
ARTSTDS
ASTSTDS
ARPSTDS
200K
100K
1UOK
'5,0'
'2,0'
'2,0'
AQMASTER
AQPARMFL
AQSRSITE
Description
Highest-level index of data
set names
Standards retrieval program
Standards statistical analysis
program
Standards report program
Region size allocated for
execution of ARTSTDS
Region size allocated for
execution of ASTSTDS
Region size allocated for
execution of ARPSTDS
Time allocated for execution
of ARTSTDS
Time allocated for execution
of ASTSTDS
Time allocated for execution
of ARPSTDS
Lowest-level index of master
file
Lowest-level index of
parameter file
Lowest-level index of sorted
site file
(Page 1 of 3)
Figure 6.6.4-e. Substitutable Parameters for AQRPM60
629.155
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 35
Release Date: 10/31/81
Update #: 29
Parameter Name
DISP1
DISP2
DISP3
TEMP
SPUNIT1
SPUNIT2
.SPUNIT3
SPUNIT4
PRI1
PRI2
PRI3
Default Value
'OLD,KEEP/KEEP'
'NEW,PASS1
'OLD,DELETE1
SYSDA
CYL
TRK
CYL
TRK
50
20
50
Description.
Disposition of master,
parameter, and sorted site
files
Disposition of temporary files
created by ARTSTDS and ASTSTDS
Disposition of temporary files.
read by ASTSTDS and ARPSTUS
Unit type to which temporary
files are to be written
Units in which space for
temporary data file is to be
allocated
Units in which space for
temporary site data file is
to be allocated
Units in which sort work space
is to be allocated
Units in which space for
temporary statistics file is
to be allocated
Primary space allocation for
temporary data file
Primary space allocation for
temporary site data file
Primary space allocation for
sort work space
(Page 2 of 3)
Figure 6.6.4-e - continued. Substitutable Parameters for AQRPM60
629.156
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 36
Release Date: 10/31/81
Update #: 29
Parameter Name
PRI4
SEC1
SEC2
SEC4
OUT
Default Value
10
10
10
10
A
Description
Primary space allocation for
temporary statistics file
Secondary space allocation for
temporary data file
Secondary space allocation for
temporary site data file
Secondary space allocation for
temporary statistics file
SYSOUT class for all print
files
(Page 3 of 3)
Figure 6.6.4-e - continued. Substitutable Parameters for AQRPM60
629.157
-------
AQDHS-II
REPORTS
SECTION 6.6.4
STANDARDS REPORT PROGRAM
ARPSTDS (AQ0420)
Page: 37 i
Release Date: 10/31/81
Update #: 29
This page left blank intentionally.
2y.158
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.1
INTRODUCTION
Page 1
Release Date: 4/30/79
Update #: 24
7.0 INTER-FUNCTIONAL PROCEDURES
7.1 INTRODUCTION
This section provides examples of run streams from the AQDHS-II baseline
test run series in which more than one function is performed. The examples
are discussed briefly and figures showing the run streams are provided.
References are given to specific sections in the Users Guide for more detailed
information on the programs and procedures. The primary emphasis of this
section is to demonstrate how various functions can be linked together in a
single job to accomplish a desired result (by executing several AQDHS-II
Procedures).
630
-------
AQDHS-II
APPENDIX A
Parameter
Number
11101
11101
42101
42101
42101
42401
42401
42401
42401
42601
42601
42601
42601
42602
42602
42602
42602
42603
42603
42603
43101
Units
Code
01
02
05
06
07
01
02
07
08
01
02
07
08
01
02
07
08
01
07
08
01
CODE TABLES
Table A-6. Maximum
Maximum
Value
2000.0
2183.3
115.0
125.5
100.0
5240.0
5720.5
2.0
2000.0
3690.0
40.28.4
3.0
3000.0
3760.0
4104.8
2.0
2000.0
9400.0
5.0
5000.0
9810.0
Page 8'
Release
Update
- £
Date: 4/30/79
#: 24
Values for Parameters
Parameter
Number
43101
43101
43101
43102
43102
43102
43102
44101
44101
44101
44101
44103
44103
44103
44103
44201
44201
44201
44201
61102
Units
Code
05
06
07
01
02
05
07
01
02
07
08
01
02
07
08
01
02
07
08
14 .
Maximum
Value
9.8
1 0.. 7
1.5.0
6540.0
7139.8
6.6
10.0
1372.0
1497.8
0.7
700.0
1372.0
1497.8
0.7
700.0
1372.0
1497.8
0.7
700.0
360.0
733
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 1
Release Date: 4/30/79
Update #: .24
7.2 EXAMPLES
7.2.1 RETRIEVAL AND CONVERSION TO SAROAD TRANSACTIONS.
This retrieval is the same as that discussed in example 1 of Section
5.2.2.2. It is an In-line COBOL retrieval which changes all sent status flags
to add. Such a retrieval might be done if the SAROAD transactions had been
previously sent, but were requested again. If all records on the AQDHS-II
master file are flagged as sent, none would be converted to SAROAD
transactions by ARPSARD (AQ0220), the AQDHS-II to SAROAD conversion program.
Thus, a retrieval must be run to change the flags for the requested records.
Once this retrieval has been run, the answer file is input to ARPSARD
(AQ0220). An option date of 7912 is used to insure that no 1980 or later data
is sent to SAROAD, since in this example only the 1979 data is desired.
Information on the retrieval can be found in Section 5.2 and information
on the retrieval procedure AQRTM10 in Section 5.7.1. Information on ARPSARD
(AQ0220) can be found in Section 6.3.2.
Figure 7.2-a shows the run stream for this example. Note that AQMST04T
is the input master file and TEMPRETR is the retrieved answer file. TEMPSARD
is the output master file and would be used as the current, working master
file since it reflects the latest SAROAD submission status.
7.2.2 RETRIEVAL AND ANOMALY SCREENING
This retrieval is the same as that discussed in example 2 of Section
5.2.2.2. It uses COBOL statements stored in a copy member'to change both
reading and record status flags from screened to not screened. This will
allow all records to be screened for anomalies even though they may have been
screened previously.
631
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 2
Release Date: 4/30/79
Update #: .24
Once the retrieval has been run, the answer file is input to the anomaly
screening procedure, AQRPM45. An option of FLAG LOW is used for the
screening.
Information on the retrieval can be found in Section 5.2 and information
on the retrieval procedure AQRTM10 in Section 5.7.1. Information on anomaly
screening can be found in Sections 5.5.5, 6.4.1 and 6.4.3.
Figure 7.2-b shows the run stream for this example. Note that AQMST04T
is the input master file, AQPARM01 is the input parameter file, and TEMPRETR
is the retrieved answer file. SAVESCRN is the output master file and would be
used as the current, working master file since it reflects the latest anomaly
screening status. The COBOL copy member COPYEXM2 is shown in Figure 7.2-C.
7.2.3 ARCHIVAL AND MERGING
It is economically advantageous to keep only volatile data in the
AQDHS-II master file. Once the data for a year has become static, that data
should be removed from the master file, and may be added to a previously
archived master file. This may be done by running the master file archival
program, AMSARCH (AQ0215) and then using the master file merge program,
AMSMERG (AQ0210), to merge the archived data with the previously archived
file. AMSARCH (AQ0215) is executed by the cataloged procedure AQMSM20 and
AMSMERG (AQ0210) is executed by cataloged procedure AQMSM10.
Information on AMSARCH (AQ0215) is found in Section 5.4.3 and information
on AMSMERG (AQ0210) in Section 5.4.2.
Figure 7.2-d shows the run stream for this example. The year 1966 was
used for the archival. Note that file AQARCM1A is archived from the input
master file AQMST03T and is then merged with the existing archived file
AQARCM01. The resulting two files are the working master file AQMST04T (from
632
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 3
Release Date: 4/30/79
Update #: 24 _.
the archival job step) and the archived file AQARCM02 (from the merge job
step).
7.2.4. RETRIEVAL FROM TWO FILES, MERGING, AND INVENTORY BY POLLUTANT
When data is stored in both a working master file and an archived file,
it may be necessary to report on data stored in both files. This may be done
by retrieving data from both files, merging the two answer files, and using
the merged file for the report.
The desired result of this example is an inventory by pollutant report on
all hourly data with units code 01 (micrograms/cubic meter at 25° C, 1013
millibars) where at least some of the data exceeds the maximum values for TSP
(11101) of 2000 yg/m3 and for S02 (42401) of 5240 ug/m3. Since all such data
is required, it should be retrieved from both the current and the archived
master files. As the same retrieval will be used on both files, the cataloged
procedures AQRTM20 and AQRTM30 will be used so that the generated retrieval
load module can be saved and only the execution of the generated retrieval
load module need be performed twice. Information on AQRTM20 is found in
Section 5.2.2.5 and information on AQRTM30 in Section 5.2.3.5.
The procedure AQMSM10, which executes AQSMEftS (AQ0210), is used to merge
the two answer files. Information on the master file merge program,
-------
•AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 4
Release Date: 4/30/79
Update #: 24
Figure 7.2-e shows the run stream for this example. Note that ARCHRETR
is the answer file retrieved from the archived file AQARCM02 and ACTVRETR is
the answer file from the current master file AQMST04T. These two answer files
are merged to produce the file MERGRETR from which the inventory by pollutant
report is produced. The parameter file AQPARM01 and the site file AQSITE01
are used to provide headings for the report.
7.2.5 RETRIEVAL, CONVERSION TO USER UNITS CODE, AND DETAILED REPORT
The units code conversion program ACVUNIT (AQ0050) is used when reports
are desired in either standard units or in user-specified units. The file
used may be a retrieved answer file, as in the example shown here.
Data for the year 1979 for the parameters nitrogen dioxide (42602) or
oxides of nitrogen (42603) are retrieved as in example 4 of Section 5.2.2.2.1.
The answer file from this retrieval is then input to the units code
conversion program, ACVUNIT (AQ0050), using the USER option. This program
will change the units code of each record to the units code specified by the
user units code in the parameter file for that parameter. Each reading will
then be multiplied by the user units conversion factor from the parameter file
to reflect the change in the units code. If no user units code has been
specified in the parameter file, the units code and readings will not be
converted, but will remain the same as entered. Information on ACVUNIT
(AQ0050) can be found in section 5.5.6. ACVUNIT (AQ0050) is executed by
procedure AQCVM20.
The master file detailed report program, ARPMSTR (AQ0230), is then run on
the file with the converted readings. The SUM option and DISPLAY > - 10
634
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 5
Release Date: 4/30/79
Update #: 24
are used. Information on ARPMSTR (AQ0230), can be found in Section 6.2.3.
Procedure AQRPM20 executes ARPMSTR (AQ0230).
Note that since the units code is part of the key for the AQDHS-II master
file, running ACVUNIT (AQ0050), which alters the units codes, could result in
the output file being out of master file sequence or having duplicate records.
The master file sort program, ASRMSTR (AQ0140), should be run following
ACVUNIT (AQ0050) to insure that the file is printed in correct sequence. See
Section 5.6.2 for information on ASRMSTR (AQ0140). The sort was not run for
this example.
Figure 7.2.-f shows the run stream for this example. Note that TEMPRETR
is the file retrieved from the master file AQMST04T and is converted by
ACVUNIT (AQ0050) to the file UNITCONV, using the parameter file AQPARM01.
This same parameter file, the site file AQSITE01, and the parameter standards
file AQSTND01 are used to provide information for the headings of the detailed
report of UNITCONV.
7.2.6 SLIDING RETRIEVAL, SLIDING AVERAGE CALCULATION, AND SLIDING AVERAGE
REPORT
At least three procedures must be run to produce a sliding average
report. These are the retrieval procedures, AQRTM10 (or alternatively the
procedures AQRTM20 and AQRTM30), the sliding average procedure, AQSTM20, and
the detailed master file report procedure AQRPM20.
A retrieval using the SLIDING option must be run prior to executing the
sliding average program, ASTSLAV (AQ0180). The retrieval shown here, for
hourly data of SOg (42401) with the year not less than 1978, is the same as
that discussed in example 5 of Section 5.2.2.2.1. Information on the
retrieval can be found in Section 5.2.
635
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 6
Release Date: 4/30/79
Update #: 24
Information on ASTSLAV (AQ0180) can be found in Section 5.3.4. In this
example, an interval of eight and the SAROAD option are used.
The master file detailed report program, ARPMSTR (AQ0230) prints a
sliding average report when a sliding average value file is input. No summary
(MEAN or SUM) option may be entered, but a display option can be specified.
In this example, DISPLAY < .9, is specified. Information on ARPMSTR (AQ0230)
can be found in Section 6.2.3.
Figure 7.2-g shows the run stream for this example. Note that TEMPRETR
is the answer file retrieved from the master file AQMST04T and is input to the
sliding average program to produce the sliding average values file TEMPSLAV.
TEMPSLAV is then listed by the master file detailed report program using the
parameter file AQPARM01, the site file AQSITE01, and the parameter standards
file AQSTND01.
7.2.7 BATCHED RETRIEVAL, SORT, AND STATISTICAL ANALYSIS
A statistical analysis is produced using procedure AQRPM45. The file
being analyzed had been retrieved using a batched retrieval and was sorted
using the master file sort procedure AQSRM10 prior to producing the
statistical analysis.
A batched retrieval is run similiar to example 1 of Section 5.2.2.2.3.
Data is selected for three separate sets of retrieval specifications, all for
the first quarter of 1979, but batch one contains hourly data for TSP (11101),
batch two contains hourly data for S02, and batch three contains all data for
NOX.
A batched answer file must be sorted using the BATCH option of the master
file sort program prior to being input to any other programs. Also, any file
should be sorted using the STAT option prior to being input to the statistical
636
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 7
Release Date: 4/30/79
Update #: .24
analysis. Both of these options can be specified in the same execution of the
master file sort program, ASRMSTR (AQ0140). Information on ASRMSTR (AQ0140)
can be found in Section 5.6.2.
The QUARTER option is used for the statistical analysis. Information on
the statistical analysis can be found in Sections 5.3 and 6.4.2.
Figure 7.2-h shows the run stream for this example. Note that TEMPRETR
is the answer file retrieved from the master file AQMST04T. This answer file
is sorted to produce the file TEMPSORT, which is input to the statistical
analysis procedure. The parameter file AQPARM01 is used in the statistical
analysis and, along with the site file AQSITE01 is used to create the
statistical analysis report.
7.2.8 RETRIEVAL AND DETAILED REPORT
S02 (42401) data is tested to determine if the mean value for the record
is greater than 1.0 parts per million (units code of 07). This is an
elementary violation technique although it does not reflect the actual
standard for S02. The retrieval procedure AQRTM10 is used followed by the
master file detailed report procedure AQRPM20.
A retrieval using a user-defined subroutine and user-defined data is run
in this example. As explained in Section 5.2, it is also required that a
COBOL copy member and at least one AQDHS-II retrieval specification be used.
This retrieval is the same as that in example 3 of Section 5.2.2.2.2.
The master file detailed report program ARPMSTR (AQ0230), is run using
the MEAN option and DISPLAY N > 9990. Information on ARPMSTR can be found in
Section 6.2.3.
637
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 8
Release Date: 4/30/79
Update #: 24
Figure 7.2-i shows the run stream for this example. Note that TEMPRETR
is the answer file retrieved from the master file AQMST04T. The parameter
file AQPARM01, the site file AQSITE01, and the parameter standards file
AQSTND01 are used for information for the headings of the detailed report.
All three COBOL copy members used in this example are shown in Figure 7.2-j.
7.2.9 RETRIEVAL, SORT, AND STATISTICAL ANALYSIS
".".v'The statistical analysis procedure, AQRPM10 is run using the YEAR and
BRIEF option. Data to be used was retrieved using AQRTM10, and then were
sorted using the master file sort procedure, AQSRM10.
A retrieval is run to select data for January, 1979 and 1973. This
retrieval is the same as that in example 2 of Section 5.2.2.2.1. Information
on the retrieval can be found in Section 5.2.
The master file sort program, ASRMSTR (AQ0140), must be run using the
STAT option prior to running the statistical analysis. Information on ASRMSTR
(AQ0140) can be found in Section 5.6.2.
The YEAR and BRIEF options are used for the statistical analysis.
Information on this can be found in Sections 5.3 and 6.4.2.
Figure 7.2-k shows the run stream for this example. Note that TEMPRETR
is the answer file retrieved from the master file AQMST04T and is sorted to
produce the file TEMPSORT. The statistical analysis is performed on TEMPSORT
and the statistical analysis report is produced using the parameter file
AQPARM01 and the site file AQSITE01.
638
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 9
Release Date: 4/30/79
Update #: 24
7.2.10 SAROAD TO AQDHS-II CONVERSION AND MASTER FILE MAINTENANCE
Many users maintain their AQDHS-II master file using SAROAD transactions.
This example converts these transactions to AQDHS-II transactions using the
procedure AQCVT10. The procedure AQEMM10 is then run. This procedure edits
and sorts the transactions, then updates the master file.
SAROAD transactions are converted to AQDHS-II format by the SAROAD to
AQDHS-II Conversion Program, ACVSARD (AQ0010). ACVSARD (AQ0010) is invoked by
the cataloged procedure AQCVT10. Information on ACVSARD (AQ0010) can be found
in Section 5.5.2. and information on ACQVT10 in Section 5.5.2.5.
The converted transactions are used to update the AQDHS-II master file by
executing the cataloged procedure AQEMM10. Information on master file
maintenance can be found in Section 4.1.4 and information on AQEMM10 is
Section 4.6.1.
Figure 7.2-1 shows the run stream for this example. The LIST option is
used in the SAROAD to AQDHS-II conversion step and the default options are
used in the master file maintenance step. The converted transactions are
stored in the temporary file &&AQTRANS. AQMST04T is the old master file;
AQPARM01 is the input parameter file; AQSITE01 is the input site file; and
AH11MSTR is the new, updated master file.
639
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 10
Release Date: 4/30/79
Update #: 24
//ADHOC01A EXEC AQRTM10,
// MSTRFILsAQMSTO«T,
// ANSWRFLsTEMPRETR,
// PRIMARY*!r
// SECNDRYsl
//COMPILE.INPUT 00 *
SSSELECT USER
GO TO USER-PARAGRAPH.
USER-REPEAT.
IF DATA-FIELD (SUB) IS NOT EQUAL TO 9999
IF STATUS-FLAG (SUB) IS EQUAL TO '3' OR
STATUS-FLAG (SUB) IS EQUAL TO 'C'
MOVE 'A' TO STATUS-FLAG (SUB)
ELSE
IF STATUS-FLAG (SUB) IS EQUAL TO 'T' OR
STATUS-FLAG (SUB) IS EQUAL TO 'D'
MOVE 'B' TO STATUS-FLAG (SUB).
ADD 1 TO SUB.
USER-REPEAT-END.
EXIT.
USER-PARAGRAPH,
MOVE TRUE TO RECORD-QUALIFIES-SW.
IF YEAR IS EQUAL TO '79'
MOVE 1 TO SUB
PERFORM USER-REPEAT THRU USER-REPEAT-END
NBR-OF-READINGS TIMES
IF RECORD-STATUS-FLAG IS EQUAL TO 'S'
MOVE 'N' TO RECORD-STATUS-FLAG
ELSE
IF RECORD-STATUS-FLAG IS EQUAL TO 'T'
MOVE 'V TO RECORD-STATUS-FLAG.
USER-PARAGRAPH-ENO.
EXIT.
SSEND
/*
//ADHOC01B EXEC AQRPM05,
// OLDMSTRaTEMPRETR,
// NEWMSTRsTEMPSARD,
// DISPls'NEW,PAS3'»
// PRIMARY*!,
// SECNDRYal
(page 1 of 2)
Figure 7.2-a. Example 7.2.1 - Run Stream
640
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 11
Release Date: 4/30/79
Update #: 24
//SUBMIT.AOSAOOFL 00 SYSOUTsA
//SUBMIT.AQSCHGFL DO SYSOUT»A
//SUBMIT.OPTION DO *
7912
/*
(page 2 of 2)
Figure 7.2-a - continued. Example 7.2.1 - Run Stream
641
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 12
Release Date: 4/30/79
Update #: 24
//ADHOC02A EXEC AQRTM10,
// MSTRFIL«AQMST04T,
// ANSWRFLsTEMPRETR,
// PRIMARYal,
// SECNDRVal
//COMPILE. INPUT 00 *
SSSELECT USER COPYEXM2
*$END
/*
//AOHOC02B EXEC AQRPM«5,
// OLDMSTRaTEMPRETRi
// NEWMSTRaSAVESCRN,
// PARMFItaAQPARMOl,
// TIMEiaJ,
//
//
//
// SEC2S4,
// PRI3«i»
// StC3«t
//CONVERT. AQSANUMF 00 OSNaRTI.C«'*.P02069.MCMA3TER. DPR. DATA. FORTANOM,
// DISPa(NEW,CATLG, DELETE )»UNIT«DISK,VOLB3ER8RTI777,SPACE»(TRK, (1,1))
//CONVERT. OPTIONS 00 «
FLAG LOW
/*
//REPORT. FT09F001 DO DISPaOLD,
// D5N5RTI.C44.P02069.MCMASTER. DPR. DATA. FORTANOM
//REPORT. FT10F001 00 SYSOUTM
SEClsl,
Figure 7.2-b. Example 7.2.2 - Run Stream
642
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 13
Release Date: 4/30/79
Update #: .24
GO TO USER-PARAGRAPH.
USER-REPEAT.
IF DATA-FIELD (SUB) NUT EUUAL TO 9999
IF STATUS-FLAG (SUB) LOUAL TO M*
MUVE 'A' TO STATUS-FLAG (SUB)
ELSE
IF STATUS-FLAG (SUB) EOUAL TO '0'
MOVE 'C* TO STATUS-FLAG (SUB)
f.LSE
IF STATUS-FLAG (SUO) EQUAL TO *T*
MUVE *S* TO STATUS-KLAG (SUH),
ADO DINARY-1 TO SUB.
USEK-REPEAT-ENO.
EXIT.
USER-PARAGRAPH,
MUVE TRUE TO RECOPD-QUALIFIES-SW.
MUVE OINARY-l TO SUB.
PtKKjRH USER-REPEAT THRU USER-REPEAT-END
NBR-of--REAoiNGS TIMES.
IF KECORD-STATUS-FLAG EUUAL TO *T*
MUVE 'a* TO RECORD-STATUS-FLAG
ELSE
IF RECORD-STATUS-FLAG EOUAL TO 'V
MOVE 'N' TO RECUKD-STATUS-FLAG.
USER-PARAGRAPH-END.
EXIT.
00000010
00000020
00000030
00000040
00000050
00000060
00000070
OOOOOOBO
00000090
oooootoo
00000110
00000120
00000130
oooooiao
00000150
00000160
00000170
00000180
00000190
00000200
00000210
00000220
00000230
00000240
00000250
00000260
Figure 7.2-c. Example 7.2.2 - COBOL copy member COPYEXM2
643
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 14
Release Date: 4/30/79
Update #: 24
//TEST26A EXEC AOMSM20,
// MSTRFIL=AQMST03T,
// NEWMSTR=AQMST04Tf
// ARCMSTR=AQARCM1A,
// PRIMARYsl,
// SECNDRYol
//ARCHIVE,OPTIONS OD *
66
/*
//TEST26B EXEC AQMSM10,
// N£rtMSTR=AQARCM02,
// INFILE1=AQARCM01,
// INFILE2SAQARCM1A,
// ALLOCs'TRK,(l,l)',
// DISPls'OLD,DELETE,KEEP',
// DISP2s'OLD,DELETE,KEEP*
Figure 7.2-d. Example 7.2.3 - Run Stream
644
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 15
Release Date: 4/30/79
Update #: 24
//ADHOC03A EXEC AQRTM20,
// PGMSAVEaRETRVR
//COMPILE,INPUT DD *
SSSELECT
((PARAMETER-CODE '11101'
DATA-FIELD '2000')
(PARAMETER-CODE '42401'
DATA-FIELD 'S240'))
TIME-CODE »i»
DATA-FIELD '9999'
UNIT-CODE '01'
SSEND
/*
//ADHOC03B EXEC AQRTM30,
// PROGRAMsRETRVR,
// MSTRFIL»AQARCMQ2,
// ANSWRFL»ARCHRET,R»
// DISP«'NEW,PASS'»
// PRIMARr»l,
// 3ECNDRY"!
//ADHOC03C EXEC AORTM30,
// PROGRAM»R£TRVR,
// M3TRFIL»AQMST04T,
// ANSrtRFL«ACTVRETRf
// DISP='NEW,PA33'»
// PRIMARYal,
// 3ECNDRYH
//ADHOC03D EXEC AQMSM10,
// INFILElaARCHRETR*
// INFILE2«ACTVRETR,
// NEriMSTRsMERCRETRf
// ALLOCs'TRK,(l,l)'
//ADHOC03E EXEC AQRPM40,
// MSTRFILaMERGRETR.
// PAKMFIL»AQPARM01i
// 3ITEFIL-AQSITE01
//SORT,OPTION DD *
PARM
RETRVR
AND
OR
AND
AND
AND
AND
Figure 7.2-e. Example 7.2.4 - Run Stream
645
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 16
Release Date: 4/30/79
Update #: 24
//ADHOC04A EXEC AQRTM10,
// MSTRFIL=AQMST04T,
// ANSWRFL»TEMPRETR»
// PRIMARYsl,
// SECNDRYsl
//COMPILE.INPUT 00 *
SSSELECT
YEAR s '79'
(PARAMETER-CODE * '42602'
PARAMETER-CODE » '42603')
SSEND
/*
//ADHOC04B EXEC AOCVM20,
// MSTRFIL«TEMPRETR.
// ANSWRFL»UNITCONV,
// PARMFIL»AQPARM01r
// DISPs'NEW,PASS',
// PRIMARYsl,
// SECNDRYal
//CONV.OPTIONS DO *
USER
/*
//ADHOC04C EXEC AQRPM20,
// MSTRFILsUNITCONV,
// PARMFILsAQPARMOli
// SITEFIL»AQSITE01/
// STANFIL»AQ3TNDOJ
//REPORT.OPTIONS 00 *
SUM DISPLAY > -10
/*
AND
OR
Figure 7.2-f. Example 7.2.5 - Run Stream
646
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 17
Release Date: 4/30/79
Update #: 24
//AOHOCOSA EXEC AQRTMlO,
// MSTRFILSAQMST04T,
// ANSWRFL=T£MPRETR,
// PRIMARY31,
// SECNDRYsl
//COMPILE.INPUT DO *
SSSELECT SLIDING
YEAR N < '78'
PARAMETER-CODE = '«a
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 18
Release Date: 4/30/79
Update #: 24
//ADHOC06A EXEC AQRTMlO,
// MSTRFILSAOMST04T,
// ANSWRFL*TEMPRETR,
// PRIMARYsl,
// SECNDRY*!
//COMPILE.INPUT DD *
SSSELECT
YEAR '79'
MONTH '04'
PARAMETER-CODE '11101'
TIME-CODE '!'
SSSELECT
YEAR '79'
MONTH '04'
PARAMETER-CODE '42401'
TIME-CODE '!'
SSSELECT
YEAR '79'
MONTH '04'
PARAMETER-CODE '42603'
SSEND
/*
//ADHOC06B EXEC AOSRMIO,
// MSTRFIL*TEMPRETR»
// SORTFIHTEMPSORT,
// PRIMARY«1,
// SECNDRY»1
//SORT.OPTIONS DD »
BATCH STAT
/*
//ADHOC06C EXEC AQRPM10*
// MSTRFILaTEMPSORT,
// PARMFIL»AQPARM01»
// SITEFIL'AQSITEOl*
// SEC1«1»
// PRI2»lr
// 3EC2M
//PRELIM.OPTIONS DD *
QUARTER
/•
//PRINTS.OPTIONS DD *
60
AND
AND
AND
AND
AND
AND
AND
AND
Figure 7.2-h. Example 7.2.7 - Run Stream
648
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 19
Release Date: 4/30/79
Update #: .24
//ADHOC07A EXEC AURTM10,
// MSTRFIL=AQMSTO«T,
// ANSWRFL»TEMPRETR,
// PRIMARY=1.
// SECNDRYsl
//COMPILE.INPUT OD *
SSSELECT RPTEST03
YEAR s YEAR
$$ENO
/*
//ADMOC07B EXEC AQRPM20,
// MSTRFIL=TEMPRETR,
// PARMFILsAQPARMOl/
// SITEFILsAQSITEOl,
// STANFILsAQSTNDOl
//REPORT.OPTIONS DO *
MEAN DISPLAY N > 9990
/*
DTTEST03 RPTEST3A
Figure 7.2-i. Example 7.2.8 - Run Stream
649
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 20
Release Date: 4/30/79
Update #: 24
Copy Mer.ibor RPTEST03
MOVE FALSE TO RECORD-UUAHFIES-SW. 00000010
IF PARAMETER-CODE EQUAL TO '42401' 00000020
AND UNIT-CODE EQUAL TO '07' 00000030
MOVE ZERO TO USER-TOTAL-READING 00000040
USER-AVG-KEADING 00000050
USER-NBR 00000060
MOVE BINARY-1 TO SUB 00000070
PERFORM U3ER-CK THRU USER-CK-END NBR-OF-READING3 TIMES 00000080
DIVIDE USER-TOTAL-READING BY USER-NBR 00000090
GIVING USER-AVG-READING 00000100
IF USER-AVG-READING IS GREATER THAN 1 00000110
MOVE TRUE TO RECORD-QUALIFIES-SW. 00000120
Copy Member DTTEST03
01 USER-DATA-STRUCTURE.
02 USER-TOTAL-READING
02 USER-AVG-READING
02 USER-NBR
02 U3ER-OATA-FLD
02 USER-DATA-FLDO
USER-DATA-FLD
02 USER-DATA-FLD1
USER-DATA-FLD
02 USER-DATA-FLD2
USER-DATA-FLD
02 U3ER-DATA-FLD3
USER-DATA-FLD
02 USER-DATA-FLD4
USER-OATA-FLD
02 USER-DATA-FLDX
PIC S9(5)V9(4) VALUE »0.
PIC S9(S)V9(4) VALUE tO.
PIC 99 VALUE 0.
PIC S9«|).
REDEFINES
PIC 39(4).
REDEFINES
PIC S999V9.
REDEFINES
PIC 399V99.
REDEFINES
PIC 39V999.
REDEFINES
PIC SV9999.
PIC S9(4)V9(4).
00000010
00000020
00000030
00000040
00000050
00000060
00000070
00000080
00000090
00000100
00000110
00000120
00000130
00000140
00000150
00000160
Copy Member RPTEST3A
USER-CK.
MOVE DATA-FIELD (SUB) TO USER-DATA-FLD.
IF DECIMAL-CODE (SUB) EQUAL TO o
MOVE USER-DATA-FLDO TO USER-DATA-FLDX
ELSE
IF DECIMAL-CODE (SUB) EQUAL TO 1
MOVE USER-DATA-FLDl TO USER-DATA-FLDX
ELSE
IF DECIMAL-CODE (SUB) EQUAL TO 2
MOVE U3ER-DATA-FLD2 TO USER-DATA-FLDX
ELSE
IF DECIMAL-CODE (SUB) EQUAL TO 3
MOVE USER-DATA-FLD3 TO USER-DATA-FLDX
ELSE
MOVE USER-DATA-FLD4 TO USER-DATA-FLDX.
IF USER-DATA-FLDX IS LESS THAN 9998
ADD 1 TO USER-NBR
ADD USER-DATA-FLDX TO USER-TOTAL-READING.
ADD 1 TO SUB.
USER-CK-END. EXIT.
00000010
00000020
00000030
00000040
00000050
00000060
00000070
00000080
00000090
00000100
00000110
00000120
00000130
00000140
00000150
00000160
00000170
00000180
00000190
00000200
Figure 7.2-j. Example 7.2.8 - COBOL Copy Members
650
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 21
Release Date: 4/30/79
Update #: 24
'79'
'01'
'73'
//ADHOCOBA EXEC AQRTM10,
// . MSTRFILSAQMSTO<»T,
// ANSWRFLSTEMPRETR*
// PRIMARY«1,
// SECNDRY«1
//COMPILE.INPUT DO *
SSSELECT
YEAR
MONTH
YEAR
SSEND
/*
//ADHOC6B EXEC AQSRM10,
// MSTRFIU»TEMPRETR»
// SORTFIL«TEMPSORT»
// PRIMARY-l,
// 3ECNORY«l
//SORT,OPTIONS DD *
STAT
/»
//ADMOC06C EXEC AQRPM10,
// MSTRFIL»TEMPSORT»
// PARMFIL«AQPARM01»
// SITEFIU«AQ3ITE01,
// PRIlsl,
// SECt=l,
// PRI2*1»
// SEC2«1
//PRELIM.OPTIONS DD *
YEAR
/*
//PRINTS.OPTIONS 00 *
BRIEF
/*
AND
.OR
Figure 7.2-k. Example 7.2.9 - Run Stream
651
-------
AQDHS-II
INTER-FUNCTIONAL
PROCEDURES
SECTION 7.2
MULTI-PROCEDURE
EXAMPLES
Page 22
Release Date: 4/30/79
Update #: 24
//ADHOC11A EXEC AQCVT10
//CONVERT.OPTIONS DD *
LIST
/*
//CONVERT.INPUT DD *
$2
/*
//CONVERT.OUTPUT DD DISP=(NEW,PASS),DSNs&&AQTRANSiUNITsSYSDA,
// SPACE=(TRK,(10,1))
//ADHOC11B EXEC AQEMMJO,
// OLDMSTRsAOMSTOflT,
// NEWMSTRsAHUMSTR,
// PARMFILsAQPARMOl,
// SIT£FIL=AQSITE01,
// PRIMARYai,
// SECNDRY»t
//EDIT.INPUT DD DISP=OLD,DSNs&&AQTRAN3
Figure 7.2-1. Example 7.2.10 - Run Stream
652
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 1
Release Date: 4/30/79
Update #: 24
8.0 JCL AND GENERAL TOPICS
8.1 IBM JCL
8.1.1 INTRODUCTION
This section discusses the IBM 360/370 OS JCL used in the baseline
AQDHS-II subsystem. Those users who have other types of hardware and
operating systems will have to modify or replace this JCL and should consult
their systems personnel for specific instructions.
There are three basic types of IBM JCL statements necessary to run the
AQDHS-II programs. These are the JOB, EXEC, and DD statements. All JCL
statements follow a similar format: the first two columns of the card must
contain slashes (//) to denote that the card is a JCL card; an optional name
immediately follows the slashes and may be one to eight characters in length;
the keyword (JOB, EXEC or DD) must be preceded and followed by at least one
space. There are several fields of information specified in these statements,
each field being separated from the preceding one by a comma. All of the
Information must be punched in columns 1-71. See Figure 8.1-a for an
illustration of this format.
If a statement is too long to be punched on one card, the additional
information can be punched on successive continuation cards. Each
continuation card must contain slashes in columns 1 and 2 followed by at least
one space. The Information contained on the card must start between columns 4
through 16, Inclusive. In addition, the last field on the preceding card must
be followed by a comma.
There are three JCL statements that do not follow the general format.
Information on these exceptions can be found 1n Section 8.1,5.
653
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 2
Release Date: 4/30/79
Update #: 24
8.1.2 JOB CARD
A job is a group of JCL statements grouped together into a single run
stream. The JOB card is the first of these statements, and it contains the
accounting information and run parameters that the computer operating system
must have to run the job. Each computer installation has its own standards
for JOB card formats, but a sample format is shown in Figure 8.1-b. Some of
the parameters mentioned here may not be allowed or may be specified
differently at your installation. The user should consult his local computer
systems personnel for details of the JOB card requirements at his
installation. Each job card will generally contain for each keyword an equal
sign and a value. Each field, except the last, must be followed by a comma.
Figure 8.1-c gives a listing of frequently used information fields for JOB
cards.
8.1.3 EXEC CARD
The EXEC card is used to specify the procedure or program to be executed.
In AQDHS-II, all JCL to execute specific programs is included in cataloged
procedures (see Section 8.1.6). More than one EXEC card can be included in a
given job; for example, to run both a retrieval and a detailed report of the
answer file, two EXEC cards would be used, one for the retrieval procedure
AQRTM10 and one for the detailed report procedure AQRPM20.
The cataloged procedures in AQDHS-II contain substitutable parameters to
indicate frequently changed information such as file names and storage
information for new data sets. Values for these substitutable parameters are
specified on the EXEC card. Information on the substitutable parameters for
the cataloged procedures can be found in the program sections of this User's
Guide.
654
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 3
Release Date: 4/30/79
Update #: 24
8.1.4 DD CARD
The DD (Data Definition) card is used to define the data sets associated
with a particular program's execution. The DD card provides information such
as the data set name, the unit type (such as disk or tape), the volume where
the data set resides, the disposition (is the data set old or new; should it
be cataloged, kept, or deleted?). These DD cards are included in the
cataloged procedures, with the most variable information (data set name, space
allocation, disposition, etc.) specified by substitutable parameters. Fields
that may be specified on the DD card are shown in Figure 8.1-d.
In some cases, the user will have to override one or more DD cards in a
cataloged procedure. The cataloged procedures in AQDHS-II contain deferred DD
names for many data sets to eliminate the necessity for overrides. The DD
cards defining option cards and transaction files for AQDHS-II programs are
examples of deferred DD names. For example, in the cataloged procedure
AQRPM20 (see Section 6.2.3.5) which produces the master file detailed report,
the DD card used to define the option card input to ARPMSTR (AQ0230) is as
follows:
//AQSINPUT DD DDNAME=OPTIONS,
// DCB=BLKSIZE=80
To run this procedure, a card must be entered into the run stream to further
define this data set. The required card would be coded as follows:
//REPORT.OPTIONS DD *
Note that REPORT indicates the job step which executes ARPMSTR (AQ0230),
OPTIONS indicates which data set is being defined, and the * indicates that
data (in this case, the option card) will immediately follow the DD card in
the run stream.
655
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 4
Release Date: 4/30/79
Update #: 24
8.1.5 SPECIAL JCL CARDS
There are three special JCL cards: the in-line data set delimiter, the
comment card, and the end-of-job card.
The special control card
/*
is used to indicate the end of an in-line data set, such as transactions,
retrieval specifications, and option cards.
The comment card
//* comment
may be used anywhere in the run stream after the JOB card.
The // card is used to denote the end of a job.
Some installations also require an end-of-file card, but there is no
standard format for it.
8.1.6 CATALOGED PROCEDURES
With the JCL cards described above (JOB, EXEC, DD), it is possible to
write all of the control language statements necessary to run the AQDHS-II
programs. For example, over 200 control statements are required to run a
retrieval. Since 1t would be very time consuming to code all of the JCL
statements each time a program is run, and since there would also be a great
possibility for errors, the JCL to run the AQDHS-II programs has been
organized Into procedures. These procedures are cataloged 1n a systems
library and may be executed by using only a few JCL control statements. The
cataloged procedure which Invokes an AQDHS-II program 1s discussed 1n the
656
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 5
Release Date: 4/30/79
Update #: .24
section relating to that program. A list of the substitutable parameters
associated with the procedure, a brief discussion, and sample job streams are
also provided in that section.
The procedures may be executed directly from the AQDHS-II JCL library, if
a procedure library (PROCLIB) control card immediately follows the JOB card in
the run stream. However, some installations may require that the procedures
be copied into a system procedure library. In this case, no PROCLIB statement
is needed to execute the procedures. The systems personnel at a particular
installation can explain what that installation requires. Please note that if
the procedures are executed from a systems procedure library, any updates to
the AQDHS-II procedures must be made in both the AQDHS-II JCL library and the
system library.
657
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 6
Release Date: 4/30/79
Update #: 24
Columns
1 3
_V
Column
71
-//[name] [keyword]
[information]
Name - one to eight characters
Keyword - DD, EXEC, JOB
Information - consists of several fields separated by commas
Figure 8.1-a. General Format of JCL Statement
658 .
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 7
Release Date: 4/30/79
Update #: 24
/ //[job name] JOB [accounting information],[name],[information]
Job name - name given to job by user. Must be one to eight characters in
length and must begin in column 3
Accounting information - installation-dependent account number (consult
the local systems personnel)
Name - name selected by user to identify run, 1 to 20 characters long
Information - see Figure 8.1-c
Figure 8.1-b. JOB Card Format
659
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 8
Release Date: 4/30/79
Update #: 24
MSGLEVEL Specifies whether all JCL cards should be listed or not.
PRTY Specifies the job priority. These priorities are established by
the installation; consult the local systems personnel for
information.
CLASS Specifies the job class to be used. Job classes determine the
overall priority (and cost schedule) of the job. The user
should consult the local systems personnel for information on
classes used at his installation.
TIME Specifies a time limit for the job. It may be given in minutes
(e.g., TIME=3) or in minutes and seconds (e.g., TIME=(1,30)). If
no value is specified, the installation's default value will be
used. Consult the local systems personnel for information on the
default value.
Figure 8.1-c. JOB Card Information Fields
660
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 9
Release Date: 4/30/79
Update #: 24
DUMMY This parameter is specified for the input master file when running
file maintenance procedures to create initial files. DUMMY
signifies that the data set is not present.
UNIT Specifies the input/output unit. Disk units can be specified by
DISK, 2314, 3330, etc., to denote the specific disk type used.
Tapes may be specified by TAPE or 2400, etc. Consult the local
systems personnel for specific information on the specifications.
DISP Specifies the data set disposition. There are three positional
subparameters within the DISP parameter:
DISP=(current status, normal disposition, abnormal disposition).
One of three values may be specified for current status: NEW, OLD,
or SHR. Their meanings are as follows:
NEW specifies that no data set with the specified name currently
exists.
OLD designates an existing data set and specifies that the step will
be given sole access to the data set.
SHR specifies an existing data set which may be shared with other
jobs running at the same time.
s
The normal disposition 1s used 1f the step proceeds to normal system
completion; the abnormal disposition 1s used 1f the step has an
abnormal system termination. Note that most ABORT errors 1n
(page 1 of 4)
Figure 8.1-d. DD Card Field Specifications
661
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 10
Release Date: 4/30/79
Update #: 24
AQDHS-II will cause the step to terminate prematurely, but will not
cause a system ABORT, and therefore, the normal disposition is still
in effect. The possible values for both dispositions are CATLG,
KEEP, PASS, DELETE, and UNCATLG. Their meanings are as follows:
CATLG, generally used for new permanent data sets, specifies that
the data set will be kept and that an entry will be made in the
system catalog for that data set. Cataloged data sets may be
referred to in later jobs by name and disposition only.
KEEP is used to indicate that a new permanent data set is to be kept
but that no entry will be made in the system catalog. Data sets
written with a disposition of KEEP must be referenced by complete DD
information.
PASS is used to pass the data set to subsequent job steps. The use
of PASS saves time, since the system retains the data set location
and volume information, and the volume containing the data set
remains mounted. PASS may be used for both temporary and permanent
data sets.
DELETE deletes the data set and removes it from the catalog, if
applicable.
UNCATLG removes the data set from the catalog, but does not delete
it.
(page 2 of 4)
Figure 8.1-d - continued. DD Card Field Specifications
662
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 11
Release Date: 4/30/79
Update #: 24
VOL The volume parameter requests a specific volume, such as a tape reel
or a disk pack. VOL must specify the volume serial number for a
data set. It also may be used to specify that the volume is
private, and that a mountable volume is to be retained. This is
denoted by VOL=(PRIVATE,RETAIN,SER=XXXXXX) where XXXXXX is the six
character volume serial number. If only the volume serial number
is to be specified, VOL=SER=XXXXXX may be used.
LABEL Provides label information for the data set. AQDHS-II has been set
up to specify all data sets as unlabeled. If this is not allowed at
a particular installation, all programs in the system for that
installation must be modified to reflect that the data sets are
labeled. The user must consult NADB prior to making such a
modification. Since tapes may contain more than one file, the file
number is also specified in the LABEL parameter; i.e., LABEL=(file
number, type). The value for type is NL for unlabeled data sets and
SL for labeled data sets.
SPACE The space parameter is used on direct access (disk) volumes to
indicate the amount of space to be allocated. Space may be
allocated by tracks (TRK) or cylinders (CYL). Both a primary and
a secondary allocation may be used if the primary space is exceeded,
up to 15 times the secondary allocation may be used. To conserve
space a release (RLSE) parameter may be coded. RLSE requests that
only that space actually used for the data set be kept. As an
example, to allocate ten primary and five secondary tracks with
extra space released, the SPACE parameter would be coded as:
SPACE=(TRK,(10,5),RLSE).
(page 3 of 4)
Figure 8.1-d - continued. DD Card Field Specifications
663
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.1
IBM JCL
Page 12
Release Date: 4/30/79
Update #: 24
SYSOUT Routes a data set to a specific device, such as a printer or a card
punch. Standard values are A for printer, B for card punch.
Consult the local systems personnel for installation values used to
specify special forms, etc.
DCB Specifies the data control block (DCB) parameters, such as the
record and block sizes and record format. This information is not
generally needed for AQDHS-II. The subparameters generally used are
RECFM, LRECL, and BLKSIZE. They are described as follows:
RECFM is used to specify the record format. Values used in AQDHS-II
are V for variable-length records, F for fixed-length records, B for
blocked records. The AQDHS-II master file has RECFM=VB; all other
files for AQDHS-II have RECFM=FB.
LRECL indicates the record length of the file. If needed, this
information can be found on the particular file's record layout in
the User's Guide.
BLKSIZE is used to indicate the block size (in bytes). The number
of records per block may be found in the data division of each
AQDHS-II source program.
(page 4 of 4)
Figure 8.1-d - continued. DD Card Field Specifications
664
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 1
Release Date: 4/30/79
Update #: 24
8.2 UPDATES
8.2.1 INTRODUCTION
Changes are made to the AQDHS-II programs and procedures as necessary to
provide additional capabilities such as new user-oriented reports; to meet
changing EPA requirements, such as changes to EPA standards; and to correct
program "bugs." Some past examples of enhancements include adding the ability
to process negative data and adding a new program to merge two master files.
A change in the transaction edit program was necessitated by a change in the
EPA maximum value check for hydrocarbons. One program "bug" that has been
corrected was the incorrect conversion of hourly data by the SAROAD to
AQDHS-II transaction conversion program.
Whenever changes to the AQDHS-II subsystem are necessary, an update will
be issued by EPA to make that change. The purpose of this and the following
sections is to provide information on installing these updates.
8.2.2 GENERAL UPDATE INFORMATION
8.2.2.1 Update Numbers
Each update is assigned an update number which serves as a means of
identifying a particular program's status. The updates are numbered sequen-
tially starting with 1, i.e., Update 1 was the first update to AQDHS-II.
All programs in the AQDHS-II system print out an update message (see
Figure 8.2-a) at the beginning of their diagnostic report. This update
message includes the program's name, its revision level, the update number,
and the date the update was incorporated in the EPA Baseline system. This
information is necessary for troubleshooting since the update message includes
the update status of the program being executed. Past problems have occured
665
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 2
Release Date: 4/30/79
Update #: . 24
when users compiled new updates but failed to link edit them and also when
users have not installed updates which corrected known problems. In both of
these cases, the update message immediately reveals the problem. The user is
reminded not to remove these update comments since doing so constitutes a
modification to the system; EPA will not provide troubleshooting assistance
for modified systems.
8.2.2.2 Update Package
If only a few changes are necessary, the update will be sent to users on
cards, otherwise the update will be sent on a tape. Each installation should
receive one full copy of the update (tape or cards). An abbreviated listing
of the modified programs will be included in the package. This listing (see
Figure 8.2-b for an example) shows all modifications to the programs, plus the
first and last page of the program source code.
The update package distributed by EPA also contains an update letter (see
Figure 8.2-c), an update packing list (see Figure 8.2-d), and an update veri-
fication form (see Figure 8.2-e). Additional items may be included; they will
be checked on the update packing list. The update letter gives both detailed
information on the modifications made in the update and instructions on in-
stalling the update. If the update is sent on tape, the letter will include
a listing of the files on the tape with information on the number of records
and programs contained in each file. See Figure 8.2-f for an example of a
listing of a tape update. Each update letter contains a paragraph reminding
users that NADB is not responsible for any modifications made to the system
other than those authorized to meet a specific computer system problem.
The update packing list includes information on when the user's update
was copied, the tape number (if applicable), and a checklist of items sent in
the update package. If the update package does not correspond exactly with
those items specified on the packing list, notify NADB for needed items.
666
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 3
Release Date: 4/30/79
Update #: 24
The update packing list also includes information on the hardware and
software used by the installation. This information is necessary to
provide each installation with a suitable update package. If there are any
errors or omissions in this information, please notify NADB.
The update verification form is to be returned to NADB once the update
has been installed. The form provides NADB with information on the update
status of your installation. Such information is vital when problems occur in
your AQDHS-II system, and NADB is contacted for troubleshooting assistance.
Additional personnel at your installation may be on the AQDHS-II mailing
list to receive letters-only copies of updates. These people will receive the
update letter and any updates to the AQDHS-II documentation, but will not
receive the tape or cards to install the update. A checklist for installing
the update is shown in Figure 8.2-g. Details on the installation are found in
Section 8.2.3 through Section 8.2.5.
8.2.3 UPDATE INSTALLATION
The following sections discuss the procedures and systems utilities used
to install an update. It is recommended that updates be installed as soon as
possible. If the update has been sent on a magnetic tape, the tape should be
returned to NADB promptly. If there is a delay in installing the update, copy
it onto your own tape and return the tape sent from NADB. NADB should be
contacted for troubleshooting assistance.
8.2.3.1 IBM Utility IEBUPDTE
The IBM utility IEBUPDTE allows for the addition, deletion, replacement,
and modification of modules in partitioned data sets. AQDHS-II uses
partitioned data sets for both the source and the procedure libraries. The
load library is also a partitioned data set, but changes are made to it by
667
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 4
Release Date: 4/30/79
Update #: 24
compiling and link editing modified programs. A sample listing of an IEBUPDTE
deck is shown in Figure 8.2-h. This deck is provided with each AQDHS-II
update. The update letter lists any changes the user should make in the
update deck prior to running it at his installation.
If the update has been sent on cards, all modifications to the source
library are included to be run in one execution of IEBUPDTE; procedure
modifications are included to be run in a separate execution. If the update
is on a tape, each program is in a separate file on that tape. Each of the
files can be input to a separate run of IEBUPDTE if time and page limits are
small at your installation site; if such limits are not important, all of the
files can be input to one run. The control cards are coded so that each
modified program will be renumbered, beginning with 100 and incrementing by
100.
A listing of each program will be produced and this listing should be
compared with the listing sent in the update package to insure that all
modifications were made correctly and that the program has the correct number
of lines. In addition, the condition code returned by the computer upon
execution of IEBUPDTE should be 0 and a message should be printed indicating
that the source module was altered. See Figure 8.2-i for an example of the
condition codes and Figure 8.2-j for an example of the printed message.
If you have made modifications to the source programs that cause the line
numbers to be different from the baseline version, any updates which change
specific lines of code (as compared to replacing the entire program) must be
examined. Using the abbreviated program listing (see Figure 8.2-b) and a
listing of your source program, change the line numbers in the update deck to
the line numbers of the appropriate lines of code in your source program.
This will insure that the update will be correctly applied to your source
program. For example, if 'MAIN-LOOP.1 is line 1500 of the baseline version,
but is 1502 in your source, the update statement specifying line 1500 must be
668
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 5
Release Date: 4/30/79
Update #: . 24
changed to specify line number 1502. However, if the update replaces the
entire program, the replacement should be made first; any local modifications
can then be made to a copy of the replacement program. Whenever local
modifications are made, a copy of the baseline system must be kept. This copy
will be useful in implementing future updates.
8.2.3.2 Run Stream for IEBUPDTE
The update deck contains all of the necessary JCL statements (excluding
the job card) for executing IEBUPDTE. Upon receipt of the update, process the
update deck through an interpreter on an interpreting keypunch. A listing of
the update deck is included in the update package; the user should verify that
the cards he receives are exactly as listed (see Figure 8.2-h for a sample
listing).
The data set names (DSN=data set name) on the SYSUT1 and SYSUT2 DD cards
must be changed to reflect the user's data set names if they are not
identical. Thus, if the user's source library is 'F734.CDHS.AQS.SOURCE1, the
cards should be changed to the following:
//SYSUT1 DD DSN=F734.CDHS.AQS.SOURCE,DISP=OLD
//SYSUT2 DD DSN=F734.CDHS.AQS.SOURCE,DISP=OLD
If the user's source modules for the AQDHS-II programs differ in name from the
baseline (e.g., if the numeric names rather than the alphanumeric names are
used), those names must be changed on all control statements. Thus, if the
card
./ REPL NAME=ARPMSTR,LIST=ALL
is included in the update deck and the user's version of the master
file detailed report program is stored under the name AQ0230 rather than
ARPMSTR, the card should be changed to
./ REPL NAME=AQ0230,LIST=ALL.
669
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 6
Release Date: 4/30/79
Update #: 24
A job card must be added prior to running the IEBUPDTE run stream. If
several programs are to be modified in one run, specify sufficient time and
page parameters on the job card.
8.2.3.3 Non-IEBUPDTE Updates
Some IBM installations use software packages such as ADR LIBRARIAN or
PANVALET that have their own methods for updating. Installations which use
these packages should consult their systems personnel for information on
installing the EPA-distributed updates.
Non-IBM installations have different utilities to facilitate updating.
For example, UNIVAC has an (PELT processor; CDC, the MODIFY and UPDATE
utilities; and Honeywell, UTILITY. The user should consult his installation's
systems personnel for information on these utilities.
An update package can be tailored to a user's individual needs if he
provides NADB with information about his installation's exact specifications.
The update packing list notes the specifications that have been reported to
NADB; the user should inform NADB of any errors or omissions in this
information.
8.2.4 COMPILING UPDATED PROGRAMS
Once the IEBUPDTE procedure has been successfully performed for each
program, all modified programs should be compiled and link edited. There are
cataloged procedures in AQDHS-II to execute both COBOL and FORTRAN compilers
and the linkage editor: the COBOL procedure is 'AQCLC10'; the FORTRAN
procedure is 'AQCLF10'. The update letter will indicate which programs have
to be compiled using the FORTRAN compiler. See Section 8.2.4.1 and Section
8.2.4.2 for instructions on using these procedures.
670
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 7
Release Date: 4/30/79
Update #: 24
After the compile and link edit steps have been executed, the condition
codes for each should be checked to insure that they are either a 4 or an 0
(see Figure 8.2-k). Also, any error messages from the compile step (see
Figure 8.2-1) should be inspected. If the return code is not 4 or 0 for any
job step, contact personnel at NADB and forward the listing of that job to
NADB. Warning messages (W) do not cause the compile to fail, but all other
messages (C, E, or D) do. The printout from the linkage editor should
indicate that the load module was added to or replaced in the data set (see
Figure 8.2-m).
8.2.4.1 Cataloged JCL (AQCLC10)
The cataloged procedure AQCLC10 allows IBM users to compile and link edit
the COBOL programs in their source libraries. The standard IBM ANSI COBOL
compiler program IKFCBLOO and linkage editor program IEWL are executed by this
procedure. The actual version/level of the compiler that these programs call
is installation-dependent. Information on the compiler -p*4§£affl/level will be
printed when the procedure is executed (see Figure 8.2-n).
8.2.4.1.1 JCL listing - Figure 8.2-0 shows a listing of the cataloged
procedure AQCLC10.
8.2.4.1.2 User-supplied JCL - To execute AQCLC10, the user must supply the
names for the source and load modules of the program being compiled and link
edited. See Figure 8.2-p for a description of the procedure's substitutable
parameters.
8.2.4.1.3 Sample run stream - The following run stream compiles and
link edits the COBOL program ARPSARD (AQ0220). The source library is
CN.EPALMH.A087.CDHS.HQ.AQS.SOURCE and the load library is
CN.EPALMH.A087.CDHS.HQ.AQS.LOAD.
671
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 8
Release Date: 4/30/79
Update #: 24
// EXEC AQCLC10,
// SOURCE=ARPSARD,
// LOADMOD=ARPSARD
8.2.4.2 Cataloged JCL (AQCLF10)
The cataloged procedure AQCLF10 allows IBM users to compile and link edit
the FORTRAN programs in their source libraries. The standard IBM ANSI FORTRAN
compiler program IEYFORT and linkage editor program IEWL are executed by this
procedure. The actual version/level of the compiler that these programs call
is installation-dependent.
8.2.4.2.1 JCL listing - A listing of the cataloged procedure AQCLF10 is shown
in Figure 8.2-q.
8.2.4.2.2 User-supplied JCL - To execute AQCLF10, the user must supply the
names for the source and load modules of the program being compiled. See
Figure 8.2-r for a description of the procedure's substitutable parameters.
8.2.4.2.3 Sample run stream - The following run stream compiles and link
edits the FORTRAN program ASTMSST (AQ0200). The source library is CN.EPALMH.
A087.CDHS.HQ.AQS.SOURCE and the load library is CN.EPALMH.A087.CDHS.HQ.AQS.
LOAD.
// EXEC AQCLF10,
// SOURCE=ASTMSST,
// LOADMOD=ASTMSST
8.2.5 TESTING MODIFICATIONS
Once all modifications have been made to programs and procedures, it is
recommended that tests be run to insure that the update has been successfully
672
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 9
Release Date: 4/30/79
Update #: 24
installed. The AQDHS-II baseline test run series contains tests of all
programs and procedures. The volume of the data in the test series is much
smaller than in the live data files most states maintain. Running tests with
these smaller files means lower costs; also, there is no risk of destroying
live files should the tests fail. The AQDHS-II master file, and the
parameter, site, and parameter standards files created in the test run series
could be stored on tape and used for testing updates. This procedure would
allow for the testing of any desired program without requiring that the entire
test run series be run to create these files. Information on the test run
series can be found in the Documentation of the AQDHS-II Test Run Series.
8.2.6 COST CONSIDERATIONS
The estimate given here is for a program with 3800 statements and an
update deck containing 107 cards. This update was installed using an IBM
370/168.
IEBUPDTE
CPU time: 2.1 seconds
I/O time: 20.3 seconds
Total time: 24.0 seconds
Estimated cost: $9.65
Compile and Link edit
CPU time: 22.7 seconds
I/O time: 1 minute 36.5 seconds
Total time: 1 minute 59.2 seconds
Estimated cost: $25.43
673
N.
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 10
Release Date: 4/30/79
Update #: 24
8.2.7 WARNINGS AND SPECIAL INSTRUCTIONS
Each user is reminded not to make any modifications to AQDHS-II other
than those released or approved by NADB. Only the NADB baseline version of
AQDHS-II will be supported by NADB. All modified versions (unless authorized
to meet a specific computer system problem) must be supported by the
organization which performs the modification. NADB has begun a practice of
inserting comments in the programs affected by updates. These comments will
allow the user to inform NADB of the update status of a particular program in
case of problems. The user is urged not to remove these comments since doing
so constitutes a modification to the NADB version.
If the user wants to make modifications for his own purposes, he should
make them to a copy of the baseline system. He should, however, always
maintain the baseline system with no changes. This will give him an
opportunity to test problems against the baseline system. If there is a
problem and the problem is reproduced in the baseline, the user should report
the problem to NADB. If the problem occurs in the modified version only, it
is the user's responsibility to correct that problem.
Once the updated programs have been tested, they may be incorporated into
the production system. If the update includes modifications to file
structures, programs and instructions for making the file conversions will be
sent with the update package.
The update verification form (see Figure 8.2-e) should be completed and
sent to NADB as soon as the update has been installed and tested. Any changes
in personnel should be included on this form. Also, all NADB tapes should be
returned as soon as possible.
Once the update has been completed, all people who use the system should
be informed of any effect the modifications will have on their work.
674
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 11
Release Date: 4/30/79
Update #: 24
If there are any problems in installing the update, contact NADB for
further help.
675
-------
AQDHS-II PRELIMINARY STATISTICS PROGRAM - DIAGNOSTIC REPORT
PAGE
PROGRAM NAME: ASTPRLM (A00190)
REVISION LEVEL: 1-00
LAST UPDATE »l Z«
INCORPORATED: OCTOBER 31, 1978
OPTION IN EFFECT: QUARTER
NUMBER OF MASTER FILE RECORDS READ:
NUMBER OF MASTER FILE RECORDS HITH COMPOSITE DATA:
NUMBER OF STATISTICS RAH DATA FILE RECORDS WRITTEN:
NUMBER OF PRELIMINARY STATISTICS FILE RECORDS WRITTEN:
NUMBER OF DIAGNOSTIC MESSAGES!
22
0
36
6
0
at
Figure 8.2-a. Sample Update Message
o
GO
c_, >
O XD
I— O
:r
;> GO
O •—i
C= GO
~u m
O O
CO
•
ro
73
CL
o>
n>
Oi
in
n>
o
CU
ro n>
-^ ..
CO
o
Qi
IQ
(D
ro
-------
SYSIN
NEK MASTER
./ CHANGE NAME=ADCONVRT.LIST=ALL
./ NUMBER NEH1=100,INCR=100
IDENTIFICATION DIVISION.
PROGRAM-ID. AXCONVRT.
AUTHOR. IBM CORPORATION
FEDERAL SYSTEMS DIVISION.
DATE-NRITTEN. JANUARY 13, 1976
REVISION-LEVEL 1-00.
REMARKS. AODHS MASTER FILE TO SAROAD INPUT
* THIS IS VERSION FOUR OF THIS PROGRAM
* VERSION THREE MAS COMPLETELY REPLACED BY
• THIS VERSION (UPDATE 22) ON 01/13/76
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SOURCE-COMPUTER. IBM-360.
OBJECT-COMPUTER. IBM-J60.
SPECIAL-NAMES. C01 IS TO-NEH-PAGE.
INPUT-OUTPUT SECTION.
FILE-CONTROL.
SELECT AQDHS-FILE
ASSIGN TO UR-S-AQSMASTR.
SELECT NErt-AQOHS-FILE
ASSIGN TO UR-S-AQSNEHMS.
SELECT SAROAD-ADD-FILE
ASSIGN TO UR-S-AQSADDFL.
SELECT SARUAU-CHANGE-FILE
ASSIGN TO UR-S-AQSCHGFL.
SELECT PRINT-FILE
ASSIGN TO UR-S-AOSPRINT.
DATA DIVISION.
FILE SECTION.
FD AQDHS-FILE
BLOCK CONTAINS 6 RECORDS
LABEL RECORD IS OMITTED.
01 MASTER-RECORD.
02 ACTION-CODE PIC x.
02 FORM-CUDt PIC X.
02 IDENT-KEY.
03 KEY-1.
01 STATE PIC XX.
IEBUPDTE LOG PAGE 9001
00000100
00000200
00000300
00000400
ooooosoo
00000600
00000700
00000600
00000900
00001000
OOOOIIOO
00001200
00001300
00001100
OOOOISOO
00001600
00001700
00001600
00001900
00002000
00002100
00002200
00002300
00002000
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003SOO
00003600
00003700
00003800
00003900
00001000
00004100
00000200
00000300
00001400
ooooosoo
00000600
00004700
00004AOO
00004900
0000*000
Figure 8.2-b. IEBUPDTE Output - Program Listing
(?age 1 of 2)
o
-o
o -o
i— o
1C
5> to
z i
0 •-•
t—4
o
cr to
-o m
o o
m
to
CO
•
ro
c: TO ~o
-o n> oi
o. — • CQ
O> fl>
<-*• o>
n> in t->
m co
Q)
ct
ro n>
to
o
VO
-------
STSIN
NEH MASTER
MOVE 12 TO 3AROAD-1-START-HOUR
ADO BINARY-1 TO TRANS-SUB.
EXTRACT-DATA-1-END,
EXIT.
ELSE
00
EXTRACT-OATA-2.
IF STATUS-IS-SENT (MSTR-SUB)
NEXT SENTENCE
ELSE
IF STATUS-IS-ADD (MSTR-SUfl) AND
DATA-FIELD (MSTR-SUB) NOT * NULL-RDNG AND
DATA-FIELD (MSTR-SUB) NOT * SPACES OR
STATUS-1S-CHANGE (MSTR-SUB)
PERFORM MUVE-FURM-2 THRU MOVE-FORM-2-END
TO SAHUAD-2-READING (TRANS-SUB)
PERFORM INCREMtMT-BY-TIME-CODE
THRU INCREMENT-BY-TIME-CODE-END
MOVE SAROAO-TRANS-2 TO SAROAD-TRANSACTION
MOVE FORH-2 TO SAROAD-TRANS-CODE
IF STATU3-IS-ADD (MSTR-SUB)
MOVt TRUE TO TYPE-IS-ADD-SW
PERFORM HRITE-ROUTINE THRU MRITE-ROUTINE-END
MOVE SENT-CODE TO STATUS-FLAG (MSTR-SUB)
ELSE
MOVE FALSE TO TYPE-IS-ADD-SH
MOVE sttn-coDt TO STATUS-FLAG (MSTR-SUB)
PERFORM NRITE.-ROUTINE THRU WRITE-ROUTINE-END
ELSE
ADD BINARY-1 TO NULL-ADD-COUNT
MOVE SENT-CODE TO STATUS-FLAG (MSTR-SUB).
EXTRACT-DATA-2-END.
EXIT.
INCREMENT-HY-TIME-CODE.
IF DAILY
MOVE MSTR-SUB TO SAROAO-2-OAY-R
ELSE
IF WEEKLY
COMPUTE
UK-DAY * ((MSTR-SUB - UINARY-1) * BINARY-7)
t BINARY-1
MUVt VtK-DAY TO SAROAO-2-DAY-R
ELSt
If MONTHLY
MOVt MSTR-3UH TO SARUAD-2-MUNTH-R
ELSE
IF QUARTERLY
ICBUPDTE LOG PAGE 0013
00062300
00062000
00062500
00062600
00062700
00062AOO
00062900
00063000
00063100
00063200
00063300
00063000
00063500
00063600
00063700
00063BOO
00063900
00060000
00060100
00060200
00060300
00060000
00060500
00060600
00060700
00060600
00060900
00065000
00065100 * INSERTED*
00065200
00065300
00065000
00065500
00065600
00065700
00065800
00065900
00066000
00066100
00066200
00066300
00066000
00066500
00066600
00066700
00066600
00066900
00067000
00067100
00067200
00067300
00067000
-H C- >
O O JO
-O I— O
O
CO
> CO
O 1-1
cr co
-o m
o o
3= —1
—I •—
m o
co -z.
CO
.
rv>
•o fl> oi
r°i __j 10
DJ (D fD
c-l- OJ
fD l/l I—'
fD -P>
O
O)
ri-
r\3 fD
co
o
Figure 8.2-b - continued.
(page 2 of 2)
IEBUPDTE Output - Program Listing
10
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 15
Release Date: 4/30/79
Update #: .24
UNITED STATES ENVIRONMENTAL PROTECTION AGENCY
DATE: SEP 3 0 1977
SUBJECT: AQDHS-II UPDATE 20
FROM: Lloyd Hedgepeth, Environmental Engineer
Systems Development Section, NADB (MD-14)
TO: AQDHS-II USERS
Enclosed is the package for Update 20 to the AQDHS-II system. The
Update Tracking Form shows what your package contains. If the hardware
or software information on the form is not correct for your installation,
please notify me. This information will be used to provide you with an
update package most suited to the needs of your installation.
This update was basically required in order to incorporate the
negative meteorological data handling capability. However, there were
a number of additional improvements made and several reported problem
solutions are incorporated in this update. These are discussed in
Attachment 1.
As many non-OS users have requested update tapes with each program
in a separate file, and with no control cards, we have provided such a
tape for those installations. Please note that on that tape, files 1 and
2, containing multiple programs, do contain control cards separating the
COBOL copy members.
The actual contents of your tape will be shown on the tape contents
sheet and in the listing printed from your tape.
An update deck is provided for those who use the standard IBM-OS
utilities. In almost every installation, your data set name (DSNAME) will
not be the same as that on the //SYSUT1 and //SYSUT2 cards required for the
IEBUPDTE utility. Be sure to change the DSNAME to your data set name on
those cards in each step of the update. If the member name on the control
card image which is contained on the enclosed tape (./ REPL NAME=XXXXXXXX,
LIST=ALL) is not correct for your installation, this will have to be changed.
For those users not having IBM equipment, you can use your own
update utility.
We have enclosed a revised trouble shooting form. We hope this one
page form will be easier to use. Please use it when reporting any pro-
blems.
The baseline test series has been expanded to 53 test jobs. We feel
that they better exercise the system. A copy of the test series may be
obtained by returning the enclosed test series request form and a tape
to which thev can be copied.
Figure 8.2-c. Update Letter
679
(page 1 of 5)
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 16
Release Date: 4/30/79
Update #: 24
Each user -is reminded not to make program modifications to AQDHS-II
other than those released or approved by NADB. Only the NADB version of
AQDHS-II will be supported by NADB. All modified versions (unless authoriz-
ed to meet a specific computer system problem) must be supported by the
organization which performs the modification. NADB has begun a practice
of inserting comments in the programs affected by updates. These comments
will allow the user to inform NADB of the update status of a particular
program in case of problems. The user is urged not to remove these
comments as they will be modifications to the NADB version.
If you wish to make modifications for your own purposes, you should
make them to a copy of the baseline system. You should, however, main-
tain the baseline system with no changes. This will give you an
opportunity to test problems against the baseline. If you have a pro-
blem and the problem is reproduced in the baseline, please report the
problem to NADB. If the problem occurs in the modified version only,
it is the user's responsibility to correct that problem.
Please fill out the enclosed Update Verification Form and return
it to me. Return the tape to NADB as soon as possible.
If you need further assistance or additional information, please
contact Mr. Lloyd Hedgepeth at (919) 541-5491, or Mr. Larry McMaster
at (919) 541-6821.
Enclosures
Figure 8.2-c - continued, Update Letter
(page 2 of 5)
680
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 17
Release Date: 4/30/79
Update #: 24
ATTACHMENT 1
Problems Resolved and Improvements Incorporated In
Update 20 to AQDHS-II
A. General Problems
1. The update messages have been incorporated into all programs
affected by this update.
2. All the programs were compiled and run on the UNIVAC 1110
and all general errors resulting from Update 18 have been resolved.
These errors were tolerated by an IBM compiler but caused severe
problems for a UNIVAC compiler. The UNIVAC related problems
were:
a) "01" appearing in the B margin
b) Logical "IF" statements were too complex for the UNIVAC
compiler to handle
c) Empty paragraphs
d) Invalid sentence continuation
e) Failure to close all files
f) Mixed mode moves (i.e., alphameric to numeric, etc.)
g) Use of "FILLER" at the group level
h) Use of recursive subroutine calls.
B. Specific Program Problems
1. AXCONVRT - Modified the summary statistics to delete the count
for the number of SAROAD ADD transactions with all null readings.
2. CXCONVRT
a) Incorporated a "LIST" option of valid transactions (default
is "NOLIST").
b) Standardized the error messages.
c) Included the number of action cards ("$" cards) in the
summary statistics.
(page 3 of 5)
Figure 8.2-c - continued. Update Letter
681
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 18
Release Date: 4/30/79
Update #: 24
3. DXSTATIS
a) Standardized the error messages.
b) Provided summary statistics.
c) Since the negative data mods altered the internal file
format in a manner which is not compatible with FORTRAN,
the sentinel programs (MXSENTNL and NXSENTNL) must now be
run prior to execution of DXSTATIS to reformat the file to
be FORTRAN compatible. Otherwise DXSTATIS will abort the run.
4. EXRPTLST
a) Expanded the print line to 132 characters since there was no
negative response to this modification as discussed in
Volume I, No. 6 of the Users Bulletin.
b) Incorporated the minimum detectable value in the report header.
c) Corrected the method used to obtain the maximum raw
data value.
d) Modified the mean value calculations routine to provide
round off instead of truncation. Printed values from the COBOL
and FORTRAN programs should now match exactly.
5. FXFILMNT
a) Expanded the summary statistics to indicate the number of
readings flagged for deletion.
b) Provided a negative value table for the "LIST" option since the
list option shows the data field with the negative sign as an
overpunched character. This table allows the user to readily
Interpret the data value.
c) Corrected the technique used in processing composite data.
6. IXSLDAV6 - Corrected a subscripting problem which resulted from
Update 18.
7. PXSITE
a) Added title line.
b) Decreased number of lines per page.
8. SXPRINTS
a) Prints two sites per page to save paper.
(page 4 of 5)
Figure 8.2-c - continued. Update Letter
682
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 19
Release Date: 4/30/79
Update #: . 24
10.
b) Prints the minimum detectable value and the number of times
it was substituted.
9. TXTREDIT
a) Performs an edit check on the data for all parameters for
which SAROAD has a maximum value check. The values which
exceed the maximum value check are now accepted by AQDHS-II
and a non-suppressible warning message is printed.
b) Corrected several error messages.
c) Added additional edit checks for negative data.
d) Any Form 2 or 3 repeating data which is in error will not
appear on the list of valid transactions (using the LIST
option). However, the data in error is listed in the
diagnostic listing with its appropriate error messages.
e) Edit checks for the entire matrix of SAROAD start hour versus
sampling interval have been included.
RTRETRVR - Corrected the wrap-around feature for the sliding
average mode from Update 18.
C. Additional Procedures
A procedure AQSRETCL was added to allow the user to compile, link
edit, and save standard retrievals in the LOAD library. This saves
the user the expense of recompiling and linking his standard
retrievals each time they are needed.
Procedure AQSRETGO was added to allow for execution of retrievals
stored in the LOAD library.
Figure 8.2-c - continued. Update Letter
683
(page 5 of 5)
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 20
Release Date: 4/30/79
Update #: 24
Update #:_
Name:
UPDATE PACKING LIST
Date:
Tape #:
Date Copied:
Date Mailed to User:
Update #: Returned: YES N0_
Type of Hardware:
Software Configuration:
Date Listed:
Date Returned:
Special Instructions:
Tape Enclosed:_
Tape Contents:_
Update Deck:
Update Verification Form:
Documentation:
Tape or Update Listing:
Problem Reporting Form:
Update Deck Listing:
Update Packing List:
Update Cover Letter:
Verified by:
Figure 8.2-d. Update Packing List
684
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 21
Release Date: 4/30/79
Update #: . 24
Update No.
UPDATE VERIFICATION FORM
Return to EPA
Subsystem (check onel: AQDHS-II.
, EIS/P&R
Date update performed:
Date affected programs recompiled:
Date affected programs link-edited:
PERSONNEL CHANGES
(Forpersonnel on EPA milling lists for update decks and letter, update letter only, Nevaletter)
New employee (name):
Assigned to (check as appropriate):
Replaces (name):
AQDHS-II
EIS/P&R
To receive (cheek at appropriate): LJpdate decks and letter
Update letters w/o decks _____ Newsletter
New employee (name):
Assigned to (check as appropriate):
Replaces (name):
AQDHS-II
EIS/P&R
To receive/c/wc* M appropriated ______ Updates decks and letter
_______ Update letters w/o decks ______ Newsletter
(For additional linings, pleast we oltnk thttt,)
(Slgniturt)
lOtte)
Figure 8.2-i, Updati Verification Form
-------
AQDHS-I
JCL AND
TOPICS
FILE
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
I SECTION 8.2
GENERAL UPDATES
CONTENTS OF UPDATE 20 TAPE - NO CONTROL
Page 22
Release Date: 4/30/79
Update #: 24
CARDS
# PROGRAMS # OF RECORDS UPDATE FILE
Copy Members - RTRETRVR, RPREPEAT, 1433
RPSKCOMP, RPSLRCTL, RPSTDCTL, RPWRITCL,
RPWRITES, GDMAXRDG, RDANSRCB, RDCNTLSW,
RPUSERRT, RPWRAPIT, RPWRAPUP, RPWRITWK,
RDERRMSG, RDSLCTLS, RDSLERMS, RDUSER01,
RDWKMSTR, RPBLDNUL, RPDELTPD, RPGENREC,
RPGMINIT, RPGMINTL, RPMAINRT, RPMAINSD,
RPMVMSTR, RPQLINIT
AQSRTRCL, AQSRTRGO, AQSCNVRT 253
ADCONVRT 877
ADMERGE 391
CDCONVRT 1025
DDSTATIS 986
EDRPTLST 4082
FDFILMNT 2868
HDTABLE1 787
IDSLDAVG 1442
LDLNGPRC 2463
MDSENTNL 453
NDSENTNL 436
PDSITE 239
SDPRINTS 2006
TDTREDIT 3162
SOURCE
JCL
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
SOURCE
Figure 8.2-f. Tape Contents
686
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 23
Release Date: 4/30/79
Update #: 24
Verify that package contents are correct
Copy tape update onto private tape (tape update only)
Return NADB tape (tape update only)
Install documentation updates, if any
Interpret update deck
Run update utility to modify source programs
Verify program updates
Compile and link edit all modified programs
Verify that all compiles and link edits are correct
Run update utility to modify cataloged procedures (if applicable)
Verify procedure updates (if applicable)
Test modified programs and procedures
(move procedures to system library)
Return completed update verification form
Backup complete system
Figure 8.2-g. Checklist for Installing Update
687
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 24
Release Date: 4/30/79
Update #: 24
// EXtC PGMsIEBUPOTE
//SYSUT1 DO DSN«CN.tPALMH.A067.CDMS.MU.AQS.SUUKCE»DlSPeULO
//SYSUT2 00 DSN«CN,EPALMH.A067.Cl>MS.MU.AgS,SOUKC£.DISP«ULD
//SYSPHINT 00 8Y30UT«A
//SYSIN 00 *
./ CHANGE NAME«ODSTAT1S,LIST«ALL
./ NUMbER NEW1»100,INCR»100
C * DATL»HRITTENI MARCH 6, 1978
C • REVISION LEVEL 2-01.
C • UPDATE 23 INSTALLED 3/8/78.
DATA MOOATA / 11000 /
9001 FORMAT (' ',' REVISION LEVtLl 2-01')
9002 FORMAT (' ',' LAST UPOATEl 2*01')
9003 FORMAT (' ',' INCORPORATEDl MARCH 8, 1976')
IF (MROECP ,NE. MbDECP) LNEHSM * .THUE.
./ DELETE SE01«72100,3EU2«72100
546 IF (.NOT.((I .LE. NNNMAX) .AND. (J ,LE. MDPERCM) CU TO 549
550 IF (.NOT. ((XRATIO .ttT. XPCENT) ,AUD. (J .LI. MDPEHC)))
IF ((XRATIO .NE. XPCMAX).ANO. (J .LE. MOPERO)
IF (J .GT. 10) 60 TO 9957
9957 CONTINUE
,/ CHANGE NAME»TDTREDIT,LIST«ALL
,/ NUMBER NEWJ»100,1NCR»100
REVISION LEVEL 3-02.
• UPDATE 23 INCORPORATED ON 02/01/78
03 FILLER PIC X(104) VALUE '3-02*.
os FILLER PIC xuosj VALUE '23*.
01 FILLER PIC x(i06) VALUE 'FEBRUARY i, 1978*
VALUE '43101010098100'.
VALUE '43101020107096'.
VALUE
VALUE
VALUE
VALUE
VALUt
VALUE
VALUE
•43101050000098'.
'43101060000107'.
'43101070000150',
•43101060150000'.
'43102010065400',
'43102020071396',
'431020*0000066'.
VALUE '43102070000100',
VALUE '43102060100000',
• OOOOHOO
•00001600
•00002210
00030300
00038000
00038100
00036200
00071410
00079300
00079600
00061000
00062110
00062510
00000600
00001510
00060300
00060600
00060900
00121700
00121900
00122100
00122300
00122500
00122700
00122900
00123100
00123300
00121500
00123700
Figure 8.2-h. Listing of Update Deck
688
-------
AQDHS-II
JCL AN) GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 25
Release Date: 4/30/79
Update #: 24
//EPALMHUC JOB (A087,MLMH,,LMH,,l,35),TIME=l,PRTYe5,MSGLEVEL=(l,l)
//UPDATE EXEC PGM=IEBUPOTE
//SYSPRINT 00 SYSOUT=A
//SYSUT1 DD DSNsCN.EPALMH.A087.CDHS.BKUP.AQS. SOURCE »DI3P« (OLD, KEEP)
//SYSUT2 1)0 DSN=CN.EPALMH.A067.CDH3.BKUP.A03. SOURCE, OlSPe (OLD, KEEP)
//SYSIN 00 *
//
IEF2361 ALLOC. FUR EPALMHUC UPDATE
IEF237I 06C ALLOCATED TO SYSPRINT
IEF237I 154 ALLOCATED TO SYSUTl
IEF2371 154 ALLOCATED TO SYSUT2
IEF237I 022 ALLOCATED TO SYSJJtJ _
IEF1421 - STEP WAS EXECUTED • IcoND CODF 0000 I
IEF28SI CN.EPALMH.A087.CDH3.8KUP.AQS. SOURCE
IEF285I VOL SER NOS = LMHTST.
IEF285I CN.EPALMH.A087.CDHS.BKUP.AUS. SOURCE
IEF285I VOL StR NOSs LMHTST.
JOB «57
IEF373I STEP /UPDATE / START 79108. 1146
IEF374I STEP /UPDATE / STOP 79108.1109 CPU
CNW9Q9I
CNW949I
CNH9501
CNH91I91
STEP UPDATE REGION 60K REO 3bK USED
KEPT
KEPT
OMIN 00.56SEC MAIN J6K LCS
**********»••****« COMNET • SYSTEM EE • STEP SUMMARY
JOB EPALMHUC 3.20 STEP CUU 0.56 STEP CPU SEC3.
CONDITION CODE 0000
I/O COUNTS: D6C = 915 151 s 2J 15
-------
STSIN MEN HASTER
IEBUPOTE L06 PAGE 0016
VO
O
AFTER ADVANCIN6 LINE-SKIP LINES
ADO LINE-SKIP TO LINE-CTR.
PRINT-HEADER-ENO.
EXIT.
IEB016I HEHBER NAHE (ADCONVRT) FOUND IN NM DIRECTORY. TTR IS MM ALTERED.
IEB8I8I HIGHEST CONDITION CODE MAS 00000000
IEB819I END OF JOB IEBUPDTE.
00088300
00088400
00088SOO
0008A600
00088700
00068800
00088900
00089000
00089100
00089200
Figure 8.2-j. Message Indicating Completion of IEBUPDTE Modification
— I c_ >
O O JO
T3 I— O
o
to
co
m
c: oo
-o m
CO
00
•
ro
<=. TO -o
-O (D O)
f^ —4 irt
QJ n> n>
c+ o>
fD (/) IN)
n> cr>
o
Oi
ro ro
co
o
•-•j
vo
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 27
Release Date: 4/30/79
Update #: 24
//EPALMH6H JOB JOB 535
•••ROUTE PRINT RMT63
// EXEC COBVCL,CPARM«'8XREF,VERB,DMAP,STATE,FLOW"10',SIZE1«8J92,
// SIZE2i8t92
XXCOBVCL PRUC PRINT«A,PUNCH«B«DECK«bUMM,CPARMi,CREGION*140KfVIR«0, 00003100
XX LREGtON«lOOK,LPARMi'LET,LlST,XREF',8IZEl»»8IZE2« 00003200
••• PROC COBVCL - COBOL VERSIONS 3 A 4 COMPILE AND LINK-EDIT 8-1-70 00003300
XXCOH EXEC P6M«lKFCBLOO,R£GtONejCKEGIUN,PAKM3'SOURCE,NUZWD,DECK,«PARM' 00003400
IEF6531 SUBSTITUTION JCL - PGM«IKFCBLOO,REGION»140K,PARM«'SUURCE,NOZWB,DECK,SXREF,VERB,OMAP,STATE,FLOH«IO'
00003SOO
00003600
00003700
00003600
XXSTEPLIB DO DSN«SYS2.COBtVER.LlNK,oisP«SHR
IEF6S3I SUBSTITUTION JCL - DSNeSYS2.COB4LlNK,D13PaSHR
XXSYSLIN DD UNIT»3YSDA,D3NsllOBJMOl>,DlSPaBLKSIZE«3J20) 00003900
IEF6S3I SUBSTITUTION JCL - DUMM«B,DCBi(RtCFMifB,LRECL«80,BLKSIZE«3120) •
XXSYSUT1 DD D3Ni&3YSUU,UNITiSYSOA,SPACE«(Sl20,<80iAO)) 00004000
XXSYSUT2 DD DSN«»3YSUT2,UNITi3Y80A,SPACE«(3l20,(80,BO)) 00004100
XXSYSUT3 DO DSNilSYSUT3,UNIT«SYSDA,3PACE«<3120,(80,eO)) 00004200
XX3Y3UT4 DD D8N»lSYSUT4,UNITi8YSDA,SPACE«<3120,(80,60)) 00004300
//COB.3Y3L1B OD D3N«CN,EPALMH,A087,CDH3.BKUP,AQ3.30UfH8,BKUP.AQS,30URCE(ADCONVRT)»
// DISPiOLD
ICF236I ALLOC. FOR EPALMH6W COR
IEF237I 1CS ALLOCATED TO 3TEPLIB
IEF237I 2FO ALLOCATED TO SYSL1N
1EF237I DS6 ALLOCATED TO 8Y8PRINT
IEF237I 321 ALLOCATED TO 3Y3UT1
IEF237I 330 ALLOCATED TO 3Y3UT2
IEF237I ICO ALLOCATED TO SYSUT3
IEF237I 2Ft ALLOCATED TO 3Y3UT4
IEF237I 154 ALLOCATED TO SY3LIB
1EF237I ISO ALLOCATED TO 3YB1N
IEFI42I - STEP WAS EXECUTED -ICONI) Su5E 6000 1
IRF2ASI VOL SER NOS* APPLOJ,
IEF2A5I 3Y379toa,TOSSI37,RVOOO.bPALMM6VI.OHJMUD
IEF2851 VOL 3ER NOB* MORKS1.
IEF2851 DtD7910H,TObSllO,RVOt3.INlT,HOl3298«
IEF2ASI VOL 8ER N08» WORKSO,
IEF2«SI OED79108,T035110.RVOl3.1Nn,Hl)23298«
IEF285I VOL 3ER NOS« WORK56.
IEF2ASI DED79loa,TOSSHO,PVOI3.INIT.R0332964
IEF285I VOL SER N03i WORKS2.
IEF28SI DED79|08,TOSSUO,HVOt3.INlT,H0432984
IEF285I VOL SCR NOS* WtlRKSS,
tEFZBSl CN.CPALMH.AOA7.CDH3.BKUP,AQ3,30UHCE
UF28SI VUL SER N0a« LMHT3T.
IEF2A5I CN.EPALMH.A087. CPUS. BKUP.AQS, SOURCE
IEF28SI VOL SER N08« LMHT3T,
1EF373I STEP /COB / START 79108. 1202
ICF37«! 8TIP /CUB / 3TOP 79108. UtU CPU OMIN 03.
u«BT
RtrT
PASSED
KEPT
KEPT
KEPT
KEPT
KEPT
KEPT
9hSEC MAIN 136K LC8 OK
CNW9U9I «t*»MM»»*««*«»»«« COMNET • SYSTEM IE • STEP OUMMAHY ••••**«••••••••««•
CN«9«9I
CNN9SOI JOB EPALMH6W U.60 STEP CUU
CNW9491
CNW950I STEP COD REGION 140K REQ 1J0K USED
CNH9<|91
CNimOI I/O CUUNTSl IC5 • 0 2FO » A Ub8
CNH9SOI 330 • 37 ICO » 44 2F 1 • 95 |V4
3.96 STEP CPU aF.CS,
CUNDMION CODE 0000
• 16)8 321 • 47
• 0 IS4 • 23
Figure 8.2-k.
(page 1 of 2)
Condition Codes for Compiler and Linkage Editor
691
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 28
Release Date: 4/30/79
Update #: 24
CNM949I • *
CNN950I * STEP COST » »1«.78 •
CNW949I « *
CNW9U9I •»«»»**•*«««•***••»•»«•*»*••««•«**»*«*•«**••»****•*••»*••••***••*•»****»
XXLKED EXtC PGM=IEWL,PARM='&LPARM,S12Es(&SIZElr*SIZE2)', 00001400
IEF6S31 SUBSTITUTION JCL - PGM=IML,PARMs'LET, LIST, XREF»SIZE»(8192, 8192) ',
XX HEGIUU=&LREGION,COND=(«,LT»CUB) 00001500
IEF653I SUDSTITUTIUN JCL - REGIONslOOK,CONDs(4,LT,COB)
XXSYSLIB DO DSN=SYS2.COB&VER.LIB/U13P=SHR
IEF653I SUBSTlTUrtON JCL - DSN=SYS2.CUB4LIB,D15PsSHR
XX DO DSN=SYS3.COMNET. SYSLIB, DISPsSMR
XX DO DSN=SYSl.FORTLIB,DlSPsSHR
XXSYSLIN DD DSNe&OOJMOD,DISPs(OLD»OELETE)
XX DD DDNAME=SYS1N
//LKED.SYSLMUD DD DSN=CN.EPALMH.A087.CDHS.BKUP.AQS.LOAD(AXCONVRT),
// DISP=ULD
X/SYSLMOO DD DSN*&LODMOD(MAIN),UNITBSYSOA,DISPS<,PASS),
XX SPAC£=(CYL,(2,2,1»
XXSYSPRINT 00 SYSOUT=RPRINT,OCBsCRECFM=FBA,LRECL=121,BLKSIZE33146)
IEF653I SUBSTITUTION JCL • SYSOUT=A,OCBs(RECFMzFBA,LRECL»121, BLKSIZEa3146)
XXSYSUT1 00 DSN=&SYSUTl,UNITsSYS0A,SPACEa
-------
CO
25
CARD
295
296
332
349
353
364
365
367
369
373
398
401
419
426
427
ERROR MESSAGE
1KF5011I-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
IKFSOUI-M
F
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
AN INTERMEDIATE
TRUNCATED.
iaure 8.2-1 .
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
RESULT OR
Error M
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
A SENDING
essaaes
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
FIELD MIGHT
from Comp
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
HAVE ITS
iler
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
HIGH ORDER
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
DIGIT
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
POSITION
—1 C-
O O
M *~
0 3>
CO -Z.
0
O
m
m
^P
i —
c:
o
—i
m
CO
•a a>
a. — •
ai (D
a> en
0>
=»*=
• • o
Ol
ro m
CO
o
VO
JO
0
co
i
•— •
co
o
>—t
o
00
•
ro
o>
to
n
ro
to
-------
LOCATION RtTERS TO SYMBOL IN CONTROL SECTION
LOCATION REFERS TO SYMBOL IN CONTROL SECTION
ENTRY ADDRESS
TOTAL LENGTH
00
5CFO
*««*AXCONVRT NOW REPLACED IN DATA SET
en
vo
Figure 8.2-m. Linkage Editor Message
—1
o
0
oo
c:
Q.
fu
(t
••
ro
o
m
•z.
m
i—
cr
c;
-H
m
oo
Release
o
ro
-P>
oo
o
10
JC
o
oo
i—*
i—*
OO
m
O
—1
i — »
O
•z.
CO
rv>
o>
OJ
o
-------
PP 573«-CB2 V4 RELEASE 1.4 OIAUG7*
IBM us AMERICAN NATIONAL STANDARD COBOL
DATE APR 18,1974
10
tn
00001
00002
00003
00004
00005
00006
00007
ooooa
00009
oooto
00011
00012
00013
00014
ooois
00016
00017
oooie
00019
00020
00021
00022
00023
00021
00025
00026
00027
00028
00029
00030
00031
00032
00033
00030
0003S
00036
00037
00036
00039
00040
00011
00002
00013
00044
00005
00016
00047
0004S
00049
00050
OOOSI
OOOS2
OOOS3
OOOSO
IDENTIFICATION DIVISION.
PROGRAM-ID. AXCONVRT.
AUTHOR. IOH CORPORATION
FEDERAL SYSTEMS DIVISION.
DATE-HRITTEN. JANUARY 13, 1976
REVISION-LEVEL a-00.
REMARKS. AQDHS MASTER FILE TU SAROAD INPUT
* THIS IS VERSION FOUR OF THIS PROGRAM
* VERSION THREE WAS COMPLETELY REPLACED BY
* THIS VERSION (UPDATE 22) ON 01/13/78
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SOURCE-COMPUTER. IBM-360.
OBJECT-COMPUTER. IBM-360.
SPECIAL-NAMES. COi IS TO-NEW-PAGE.
INPUT-OUTPUT SECTION.
FILE-CONTROL.
SELECT AUDHS-F1LE
ASSIGN TO UH-S-AUSHASTR.
SELECT NEH-AQDHS-FILE
ASSIGN TO UR-S-AQSiNEWMS.
SELECT SAROAD-ADD-FILE
ASSIGN TO UR-S-AQSADDFL.
SELECT SARUAD-CHANGE-FILE
ASSIGN TO UR-S-AQSCHGFL.
SELECT PRINT-FILE
ASSIGN TO UR-S-AQSPRINT.
DATA DIVISION.
FILE SECTION.
FD AODHS-FILE
BLOCK CONTAINS 8 RECORDS
LABEL RECURD IS OMITTED.
01 HASTER-RLCORD.
02 ACTION-CODE PIC X.
02 FORM-CODE PIC x.
02 IDENT-KEY.
03 KEY-1.
00 STATE PIC XX.
04 AREA-CODE PIC 9(4).
04 SITE PIC 999.
04 AGENCY PIC A.
0« PROJECT PIC 99.
00000100
00000200
00000300
00000100
00000500
00000600
00000700
00000900
00000900
00001000
00001100
00001200
00001300
00001400
OOOOlbOO
00001600
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002SOO
00002600
00002700
00002600
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004600
00004900
00005000
OOOOS100
00005200
00005300
00005400
—I C. >
o o -o
O
oo
3=» CO
-z. i
O »-<
I— I
CD
-o m
o o
3> —I
co
00
•
ro
CL
Ol
n>
cu
10
tt>
Ol
n>
co
=tfc
CXi
rt
ro n>
co
o
-•j
10
Figure 8.2-n. Compiler Version Message
-------
AQDHS-II SECTION 8.2
JCL AND GENERAL UPDATES
TOPICS
//*
//* PROCEDURE NAME! AOCLC10
//* REVISION LEVEL! 1-00
//* LAST UPDATE *t 24
//* DATE INCORPORATED! OCTOBER 31, 1978
//*
//*
Page 32
Release Date: 4/30/79
Update #: 24
00000100
00000200
00000300
00000400
00000500
00000600
00000700
//* TH13 PROCEDURE ALLOWS THl USER TO COMPILE AND LINK-EDIT COBOL 00000800
//* PROGRAMS
//*
//*
//AOCLC10 PROC PROJECT='CN.tPALMH.A087.CDHS,HQ,AQS',
00000900
00001000
00001100
00001200
// PARAMs'DMAP,SXREF,LIB,SIZEsll4K,BUF=30K,STATE,FLOW=10', 00001300
// PRIMARY=50,
// SPCUNITsTRK,
// 3ECNDRY»100,
// M2sNULL,
// MSsNULL,
// M4=NULL,
// M5=NULL,
// M6=NULL,
// M7sNULL,
// M8=NULL,
// SOURCE=NULL,
// LOADMODsNULL,
// PR1MJC60,
// PRIM2=60,
// TEMPsSYSDA
//*
//COBOL EXEC PGMsjKFCBLOO,
// REGION=130K,
// PARMa'&PARAM'
//*
//* EXECUTE COBOL COMPILER
//*
//3YSLIB DD DSNAMEs&PROJECT.. SOURCE,
// VOLUME=(PRIVATE, RETAIN),
// DISP*(SHR,PASS)
//*
//* INPUT DATA SET - SOURCE MODULE
//*
//SYSIN DD D5NAMES&PROJECT..SOURCEUSOURCE),
// VOLUMEs(PRIVATE, RETAIN),
// DISP*(SHR,PASS)
//*
// DD DSNAMEsfcPROJECT..SOURCE(&M2),
// VOLUME=(PRIVATE, RETAIN),
// DlSPs(SHR,PASS)
//*
// DD DSNAME=&PROJECT..SUURCEUM3),
// VOLUME=(PRIVATE, RETAIN),
// DISPs(SMR,PAS3)
//*
// OD DSNAME = &PROJECT.,SOURCE(&M
-------
AQDHS-II SECTION 8.2
JCL AND GENERAL UPDATES
TOPICS
// VOLUME»(PRIVATfc, RETAIN),
// DISP«(SHR,PASS)
//*
// DD DSNAME = RPROJECT..SOURCE(8,M6),
// VULUMEc(PRlVATE, RETAIN),
// DISPs(SMR,PASS)
//*
// DD DSNAMEs&PROJECT..SOURCE(&M7),
// VOLUME«(PRIVATE, RETAIN),
// DlSPs(SHR,PASS)
//*
// DD DSNAMfca&PROJECT.. SOURCE (&M8),
// VOLUMEs(pR!VATt, RETAIN),
// DlSPs(SHR,PASS)
//*
//* OUTPUT DATA SET - OBJECT MODULE
//*
//SY3LIN DD DSN=&&OBJMOD,UNITs&TEMP,
// SPACE«»(CYL,(5,2),RLSE),DISP=(NEW,PASS)
//*
//* INPUT/OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSOUT=A
//*
//SYSUT1 DD UNITs&TEMP,
// SPACEs (TRK,(&PRIMARY,&SECNDRY))
//*
//SYSUT2 DD UNIT=(&TEMP,SEP=SYSUT1),
// SPACEs (TRK,(»PRIMARY,&SECNDRY))
//*
//SY3UT3 DD UNlT=UTEMP,SEPs(3YSUTl , SYSUT2) ) ,
// SPACEs (TRK,(iPRIMARY,fcSECNDRY))
//*
//3YSUT4 DD UNIT*(RTtMP,SEPe(3YSUTl ,SY3UT2,SYSUT3) ) ,
// SPACEc(TRK,(&PRIMARY,iSECNDRY))
//*
//*
//*
//CBLLE EXEC PGMsIEWL,
// COND»(5,LT, COBOL),
// PARMs'LI3T,LET,XREF',
// REGIONslOOK,
// TIME»(I,0)
//*
//* LINK-EDIT THE OBJECT MODULE
//*
//*
//SYSLIB DD DSNAMt = (4PROJECT..LUAO,
// VOLUME=(PRIVATE, RETAIN),
// DISPs(SHR,PASS)
// DD DSNAME=SYS1.CODLIB,
// VOLUME=(PRIVATE, RETAIN),
// OISP*(3HP,PASS)
//*
//* INPUT DATA SET - OBJECT MODULE
//*
//3Y3LIN DD DSNAMts&ROBJMOD,
// DI3P«(SHR,PA3S)
Page 33
Release Date: 4/30/79
Update #: . 24
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007600
00007900
00006000
00006100
00006200
00006300
00006400
00008500
00006600
00006700
00008600
00008900
00009QOO
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009600
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
00010600
00010900
00011000
00011 100
00011200
0001 1300
00011400
00011500
00011600
(page 2 of 3)
Figure 8.2-0 - continued. Cataloged Procedure AQCLC10
697
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 34
Release Date: 4/30/79
Update #: . 24
//*
//* OUTPUT DATA SET - LOAD MODULE
//*
//LOAD
//*
//5YSLMOD
DD D3NAMES&PROJECT..LOAD,
VOLUMES(PRIVATE.RETAIN),
OISP=(SHR,PAS3)
DD DSNAMt=&PRUJECT..Lr.)ADULOADMOD),
VOLUMES(PRIVATE,RETAIN),
DlSPs(ULD,PASS)
//*
//* INPUT/OUTPUT DATA SETS • SYSTEM OPERATION
//*
//SYSUT1 DD UNIT»&TEMP,
// SPACES(&SPCUNIT,(&PRIM1,&PRIM2),,CONTIG)
//*
//SYSPRINT DD SYSOUTsA
//*
00011700
00011800-
00011900
00012000
00012100
00012200
00012300
00012400
00012500
00012600
00012700
00012800
00012900
00013000
00013100
00013200
00013300
00013400
(page 3 of 3)
Figure 8.2-0 - continued. Cataloged Procedure AQCLC10
698
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 35
Release Date: 4/30/79
Update #: 24
Parameter Name
PROJECT
Default Value
'CN.EPALMH.A087.CDHS.HQ.AQS'
PARAM
'DMAP,SXREF,LIB,SIZE=114K,
BUF=30K,STATE,FLOW=10'
Description
Highest-level index of
data set names (e.g.
the AQDHS-II source
library is CN.EPALMH.
A087.CDHS.HQ.AQS.
SOURCE)
Parameters used by the
compiler. Information
on these parameters can
be found in the IBM
COBOL Programmer's
Guide
PRIMARY
50
SPCUNIT
TRK
Primary space alloca-
tion for temporary
files used by compiler
Units in which space is
to be allocated for
temporary file used by
linkage editor.
(page 1 of 2)
Figure 8.2-p. Substitutable Parameters for AQCLC10
699
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 36
Release Date: 4/30/79
Update #: 24
Parameter Name
SECNDRY
Default Value
100
Description
Secondary space allocation
for temporary files used by
compiler
M2 thru M8
NULL
Source library members
concatenated onto the pri-
mary program (no source
library members are conca-
tenated onto any AQDHS-II
program)
SOURCE
NULL
Name of source library
module for program
LOADMOD
NULL
Name of load library module
for program
PRIM1
60
Primary spaces allocation
for temporary file used by
linkage editor
PRIM2
60
Secondary space allocation
for temporary file used by
linkage editor
TEMP
SYSDA
Unit type specified for
temporary file
(page 2 of 2)
Figure 8.2-p - continued. Substitutable Parameters for AQCLC10
700
-------
AQDHS-II SECTION 8.2
JCL AND GENERAL UPDATES
TOPICS
//*
//* PROCEDURE NAMCl AQCLF10
//• REVISION LEVEL! 1-00
//* LAST UPDATE *t 24
//* DATE INCORPORATED: OCTOPCR 31, 1978
//*
//*
Page 37
Release Date: 4/30/79
Update #: 24
00000100
00000200
00000300
00000400
00000500
OOOOOhOO
00000700
//» THIS PROCEDURE ALLOWS THE USER TO COMPILE AND LINK-EDIT FORTRAN OOOOOflOO
//» PROGRAMS
//*
//*
//»
//AOCLF10 PROC PROJECT='CN.EPALMH.A087.CDHS.HO.AQS',
// PARAMC='MAP,ID',
// PRIMAKY=50,
// SPCUNITsTRK,
// SECNDRYslOO,
// M2sNULL,
// M3=NULL,
// M4=NULL,
// M5=NULL,
// M6=NULL,
// M7=NULL,
// Mfi=NULL,
// SOURCt=NULL,
// LOADMOU=NULL,
// PRIMlcbOr
// PRIM2=60>
// TEMPsSYSDA
//*
//FORTRAN EXEC PGMsIKYFORT,
// REGIOfJ=100K,
// f'ARMc'RPARAMC'
//*
//* EXECUTE THE FORTRAN COMPILER
//*
//*
//SYSLIB DD OSNAMEsRPROJECT.. SOURCE,
// VOLUME=(PRIVATE, RETAIN),
// DISP=(SHR,PA8S)
//*
//* INPUT DATA SIT - SOURCE MODULE
//*
//*
//SY3IN DD USNAME=RPROJtCT..SOURCE(RSOURCE),
// VOLUME=(PR.IVATfc, RETAIN),
// DISP=(SHR,PASS)
//•
// DD DSNAME = &PROJECT..St.)URCE(RM2),
// VOLUMfc=(PRlVATt, RETAIN),
// DISP=(SHR,PASS)
//*
// DD DSNAML=&('ROJECT.. SOURCE (RM3),
// VULUME=(PRIVAU, RETAIN),
// I)1SP=(5HH,PASS)
//*
// DD DSNAHKs&PROJtCT.. SOURCE (&M«),
// VOLUME=(PRIVATE, RETAIN),
00000900
00001000
00001100
00001200
00001300
00001400
00001SOO
OOOOlbOO
00001700
00001800
00001900
00002000
00002100
00002200
00002300
00002400
00002SOO
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
OOOOSOOO
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
Figure 8.2-q.
(page 1 of 3)
Cataloged Procedure AQCLF10
701
-------
AQDHS-II SECTION 8.2
JCL AND GENERAL UPDATES
TOPICS
It DI3Ps(SHR,PASS)
//*
f DO DSNAMEs&PROJECT.. SOURCE UM5),
// VOLUMF.s(PRIVATE, RETAIN),
// OISPs(SHR,PASS)
//*
» 00 DSNAMEs&PROJECT.. SOURCEUM6),
// VOLUMEs(pRlVATE, RETAIN),
// OISPs(SHR,PASS)
//*
// 00 DSNAMEs&PROJECT. .SOURCE (RM7) ,
ft VOLUM£s(pRlVATE, RETAIN),
// DISP=(SHR,PASS)
//*
" DO DSNAMEs&PROJECT. .SUURCEUM8),
// VOLUMEs(PRIVATE, RETAIN),
// OISPs(SHR,PASS)
//*
//* OUTPUT DATA SET - OBJECT MODULE
//*
//SYSLIN DD DSNs&ROBJMOD,UNIT=&TEMP,
ft SPACEs(TRK, (5,2),RLSE),DISP=(NEW,PASS)
//*
//* INPUT/OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DD SYSUUT=A
//*
//SYSPUNCH DD DUMMY
//*
//SYSUT1 DD UNIT=ATEMP,
// SPACEs (TRK, (RPRIMARY,RSECNDRY))
//*
//SYSUT2 OD UNITs(g,TEMP,SEPsSYSUTl ) ,
// SPACEs (TRK,(8.PRIMARY,RSECNDRY))
//*
//SYSUT3 00 UNITs(g,TEMP,SEPs(SYSUTl,SYSUT2))r
// SPACEs ( TRK, (5PRIMARY,&SECNDRY))
//*
//SYSUT4 DO UNITs(KTEMP,SEPs(SYSUTl,SYSUT2,SYSUT3)),
// SPACEs ( TRK, (&PRIMARY,RSECNORY))
//*
//*
//*
//LKED EXEC PGMslEWL,
// COND=(5,LT, FORTRAN),
// PARMs'LIST,LET,XREF',
// REGIUNslOOK,
// TIMEs (1,0)
//*
//* LINK-EDIT THE UHJECT MODULE
//*
//SYSLIB DD DSMAMK3&PROJECT..LOAD,
// VOLUMEs(PR!VATE, RETAIN),
// D1SP=(SHR,PASS)
// 00 OSNAME=SYS1.FORTLIH,
It VOLUMEs(PRlVATE, RETAIN),
// DISH=(SHR,PASS)
//*
Page 38
Release Date: 4/30/79
Update #: 24
00005900
00006000
00006100
00006200
00006300
00006400
00006SOO
00006600
00006700
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007500
00007600
00007700
00007800
00007900
00008000
00008100
00008200
00008300
00008400
00008500
00008600
00008700
00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
00010600
00010700
00010800
00010900
00011000
00011100
00011200
0001 1300
00011400
00011500
00011600
(page 2 of 3)
Figure 8.2-q - continued. Cataloged Procedure AQCLF10
702
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 39
Release Date: 4/30/79
Update #: 24
//* INPUT DATA SET - OBJECT MODULE
//*
//SYSLIN DO DSNAMEsl&OBJMOD,
// DISH=(SHR,PASS)
//*
//* OUTPUT DATA SET - LOAD MODULE
//*
//LOAD DD DSNAME=&PRUJECT,.LOADr
// VOLUME=(PRIVATE,RETAIN),
// DISP=(SHR,PASS)
//*
//SYSLMOD
DO DSNAMEc&PROJECT..LOADULUADMOD),
VOLUMES(PRIVATE,RETAIN),
DISPa(OLD,PASS)
//*
//* INPUT/OUTPUT DATA SETS - SYSTEM OPERATION
//*
//SYSPRINT DO SYSOUTaA
//*
//SYSUT1 DO UNITe&TEMP,
// SPACE3(&SPCUNIT,UPRIMl,tPRIM2),,CUNTIG)
//*
00011700
00011BOO
00011900
00012000
oooiaioo
oooiaaoo
0001PJOO
00012400
00012500
00012600
00012700
00012AOO
00012900
00013000
00013100
00013200
00013300
00013400
00013SOO
00013600
00013700
00013800
(page 3 of 3)
Figure 8.2-q - continued. Cataloged Procedure AQCLF10
703
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 40
Release Date: 4/30/79
Update #: 24
Parameter Name
PROJECT
PARAMC
PRIMARY
SPCUNIT
SECNDRY
Default Value
'CN.EPALMH.A087.CDHS.HQ.AQS1
'MAP.ID1
50
TRK
100
Description
Highest-level index of
data set names (e.g.
the AQDHS-II source
library is CN.EPALMH.
A087.CDHS.HQ.AQS.
SOURCE)
Parameters used by the
compiler. Information
can be found in the IBM
FORTRAN programmer's
guide
Primary space alloca-
tion for temporary
files used by compiler
Units in which space is
to be allocated for
temporary file used by
linkage editor
Secondary space alloca-
tion for temporary
files used by compiler
(Page 1 of 2)
Figure 8.2-r. Substitutable Parameters for AQCLF10
704
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.2
UPDATES
Page 41
Release Date: 4/30/79
Update #: 24
Parameter Name
Default Value
Description
M2 thru M8
NULL
Source library members
concatenated onto the
primary program
(No source library mem-
bers are concatenated
onto any AQDHS-II
program)
SOURCE
NULL
Name of source library
module
LOADMOD
NULL
Name of load library
module
PRIM1
60
Primary space alloca-
tion for temporary
file used by linkage
editor
PRIM2
60
Secondary space alloca-
tions for temporary
file used by linkage
editor
TEMP SYSDA Unit type specified
for temporary files
(Page 2 of 2)
Figure 8.2-r - continued. Substitutable Parameters for AQCLF10
705
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 1
Release Date: 4/30/79
Update #: 24
8.3 INSTALLATION OF AQDHS-II
8.3.1 INTRODUCTION
The information contained in this section is intended to supplement the
instructions in the letter sent with an installation package. Only those
installations using standard IBM utilities are addressed herein.
To obtain a copy of AQDHS-II, a blank tape certified at 1600 BPI must be
sent to NADB. The type of computer that will be used and the recording
specifications for the tape should be specified in the letter.
A checklist of tasks for the installation is shown in Figure 8.3-a.
8.3.2 INITIAL PREPARATION
The installation package should contain a letter (see Figure 8.3-b); an
installation deck and listing (see Figure 8.3-c); the tape containing AQDHS-II
source, procedure, and test data sets; an AQDHS-II User's Guide; back copies
of the CDHS User's Bulletin; a System Status/Hardware/Software Questionnaire
(see Figure 8.3-d); and a copy of the Documentation of the AQDHS-II Test Run
Series. If any of these items are missing, the user should report this problem
to personnel at EPA-NADB.
The cards in the installation deck are not interpreted; however, the
contents of each card can be printed on the cards by processing the deck
through an interpreter (many keypunch machines have this feature). This
interpreting should be done because changes must be made to the cards to
reflect the user's particular data set names.
The data sets used for the source, load, procedure, and test libraries
are created in the step named ALLOC using the IBM program IEFBR14. The names
706
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 2
Release Date: 4/30/79
Update #: 24
of these data sets should be changed to reflect the installation-dependent
data set naming conventions. The space allocated assumes the use of 3330 disk
packs; if other units are used, both the unit and the space allocations should
be modified to reflect the units used. The value CDHSPK should be changed to
indicate the volume serial number of the disk device used.
Data set names, units, and volume serial numbers in the remainder of the
installation deck should also be changed to correspond with the values used in
the ALLOC step.
The step named PUNCH punches the test run series on computer cards. The
numbered PRINT steps (e.g., PRINT1, PRINT2,...) print the cataloged
procedures, the test run series, and the source code of all programs. It may
be desirable to run these steps separately since the program listings will
generate a large volume of paper. To run these steps separately, the
installation deck must be divided into several decks, each containing one or
more steps.
8.3.3 INSTALLATION JOB EXECUTION
Once the installation deck has been modified, the installation job may be
run. A job card must be added and sufficient time and page parameters should
be specified (suggested time and page estimates are included in the
installation deck as comments). Information on job cards can be4&^found in
Section 8.1.
When the job has been run, the condition codes for each step should be
verified. Condition codes should be 0 (zero) for successful completion (see
Figure 8.3-e).
707
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 3
Release Date: 4/30/79
Update #: 24
8.3.4 PROGRAM MODIFICATION
The AQDHS-II baseline programs should run with no modifications on most
IBM computers. However, some changes may be necessitated by the file
requirements of a particular installation. Information on AQDHS-II file
specifications can be found in Appendix E. Note that the blocking factors for
all files can be modified without affecting the program line numbers.
If the user's parameter, site, and parameter standards files will be
larger than the size specified in the baseline versions (200 parameter
records, 200 site records, and 100 standards records), all programs which
store these files in tables should be modified as explained in Appendix C.
Non-IBM users will need to make more extensive modifications.
Information on the changes required for each type of hardware can be obtained
from EPA-NADB.
If other user-specified modifications are desired, a copy of the baseline
version should also be maintained since all updates issued by NADB are for the
baseline programs only. If line numbers in the user's program have been
modified, an update to that program will not be applied correctly.
See Section 8.2.3.1 for additional information on program modification.
8.3.5 PROCEDURE MODIFICATION
The programs in AQDHS-II are executed using cataloged procedures.
Information on cataloged procedures can be found in Section 8.1.6 and
information on individual procedures can be found in the discussions of
cataloged JCL which are included in the discussions of the AQDHS-II programs.
708
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 4
Release Date: 4/30/79
Update #: 24
Each procedure contains substitutable parameters for such items as
project, unit, and volume serial number. Each of these items may be changed
at execution time following instructions given in the sample run streams.
Since some of these variables remain fairly constant for a given installation,
they may be changed in the procedures themselves so that the changes need not
be made each time the procedure is executed. The substitutable parameters are
listed on and immediately following the PROC statement for each procedure.
As an example of these changes, suppose the procedure contains the
following statements:
// PROJECT*'CN.EPALMH.A087.CDHS.HQ.AQS1, 00000800
// UNIT=3330, 00000900
// SERIAL=CDHSPK 00001000
Assume these variables have the values 'F734.CDHS.AQS1, 2314, and PACK27 at a
user's installation. He could then modify the procedure, replacing the three
statements with the following statements:
// PROJECT='F734.CDHS.AQS', 00000800
// UNIT=2314, 00000900
//. SERIAL=PACK27 00001000
The line numbers (columns 73-80) should be left as in the baseline
version to facilitate updates to the procedures. Any substitutable parameter
may be modified in a procedure without affecting the line numbers.
Procedures should be moved to a system procedure library once they have
been tested. The user is advised to consult with his systems personnel
before attempting to accomplish this step.
709
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 5
Release Date: 4/30/79
Update #: 24
8.3.6 COMPILING PROGRAMS
Once IEHMOVE has been performed (step TAPIN of the installation deck) and
the source programs are in the source library, the programs must be compiled
and link edited. There are cataloged procedures in AQDHS-II to execute either
the COBOL or FORTRAN compiler in conjunction with the linkage editor; the
COBOL procedure is AQCLC10 and the FORTRAN procedure is AQCLF10. See Sections
8.2.4.1 and 8.2.4.2 for instructions on using these procedures.
After each program has been compiled and link edited, the condition codes
for each step of the job should be checked to insure that they are either 4 or
0 (see Figure 8.2-k). Also, any error messages from the compile step (see
Figure 8.2-1) should be inspected. If the return code is not 4 or 0 for any
job step, contact personnel at NADB and forward the listing of that job to
NADB. The printout from the linkage editor should indicate that the load
module was added to the data set (see Figure 8.2-rn).
8.3.7 TESTING THE SYSTEM
A test run series, stored in a test library, is provided on the
installation tape to test all programs and procedures in AQDHS-II. The volume
of the data in the test run series is much smaller than in the live data files
most states maintain. Running tests with these smaller files means lower
costs; also, there is no risk of destroying live files if any test should
fail. The final AQDHS-II master, parameter, site, and parameter standards
files created in the test run series should be stored on tape and used for
testing future updates. This allows any program to be tested without
requiring that the entire test run series be run to create these files.
Information on the test run series can be found in the manual for APTI course
475.
710
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 6
Release Date: 4/30/79
Update #: . 24
8.3.8 COST CONSIDERATIONS
The following examples provide an estimate of the cost of creating the
libraries, printing the listings, and compiling a program on an IBM 370/168.
Copy AQDHS-II from tape to disk using the IEHMOVE utility:
CPU time: 22 seconds
I/O time: 2 minutes 10 seconds
Total time: 2 minutes 32 seconds
Estimated cost: $40.05
Print listings of the AQDHS-II programs:
Number of programs: 35 programs
Number of lines: 44,418 lines
CPU time: 18.27 seconds
I/O time: 2 minutes 20.13 seconds
Total time: 2 minutes 38.4 seconds
Estimated cost: $28.13
Compile and link edit for program with 3800 statements:
CPU time: 22.7 seconds
I/O time: 1 minute 36.5 seconds
Total time: 1 minute 59.2 seconds
Estimated cost: $25.43
711
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 7
Release Date: 4/30/79
Update #: 24
8.3.9 WARNINGS AND SPECIAL INSTRUCTIONS
Each user is reminded not to make any modifications to AQDHS-II programs
or procedures other than those modifications released or approved by NADB.
Only the NADB baseline version of AQDHS-II will be supported by NADB. All
modified versions (unless authorized to meet a specific computer system
problem) must be supported by the organization which performs the
modification.
If the user wishes to make modifications for his own purposes, he should
make them to a copy of the baseline system. He should, however, maintain the
baseline system with no changes. Thus, if a problem occurs in the user's
system and it is reproduced in the baseline, the user should report the
problem to NADB. If the problem occurs in the modified version only, it is
the user's responsibility to correct the problem.
If there are any problems in installing AQDHS-II, contact NADB for
further help.
The user should maintain a backup of the source, load, and procedure
libraries as well as all files used in AQDHS-II. Systems personnel should be
consulted on the proper techniques in creating backups of the AQDHS-II system,
712
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 8
Release Date: 4/30/79
Update #: 24
_Verify that the installation package contents are correct
_Interpret installation deck
_Modify installation deck as needed
_Run installation job
_Verify installation programs
_Modify programs as needed
_Compile and link edit all programs
_Verify that all compiles and link edits are correct
_Modify cataloged procedures as needed
_Test programs and procedures
_Move procedures to system libraries
_Back up complete system
_Create initial files with live data
_Inform NADB that installation is complete using System Status/
Software/Hardware Questionnaire.
Figure 8.3-a. Checklist for Installing AQDHS-II
713
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 9
Release Date: 4/30/79
Update #: 24
Ms. Virginia Sweetland
Boeing Computer Services
The Consulting Division
Mail Stop: 1E-04
P.O. Box 24346
Seattle, Washington 98124
Dear Ms. Sweetland:
Enclosed is a tape to which I have copied the AQDHS-II subsystem of CDHS.
I am enclosing a copy of the JCL printout which resulted from the copy.
Please note that the IBM utility IEHMOVE was used in creating your tape.
Since IEHMOVE copies the data sets to your tape in an unloaded format, it will
be necessary to use IEHMOVE to copy the system from this tape to your disk
before you can obtain a readable printout. The tape was copied using no
system labels and was recorded at 1600'BPI.
To aid you in the installation, I am also enclosing an "installation
deck", which is set up for an IBM (OS) computer, and a listing of it. There
are three data sets on your tape, each containing several members. These
members are
DSNAME=CDHS.AQS.JCL
DSNAME=CDHS.AQS.JOBS
DSNAME=CDHS.AQS.SOURCE
Necessary disk space for each data set is allocated in the first step of the
installation using IEFBR14. The actual copy from tape to disk is accomplished
using IEHMOVE. The load modules will be created when you compile and link
edit the programs. Also, if you wish to re-name the data sets when you copy
then from tape to disk, you can do so by adding the appropriate control card
in each COPY statement.
The installation deck is also set up to punch out all jobs required to
accomplish the following:
Copy cataloged procedures to PROCLIB
Compile and link edit all programs
Run test programs using test data supplied with the installation (run
in order)
It is also set up to print all the JOBS which were punched, as well as
all source code and the JCL for all the cataloged procedures.
(page 1 of 4)
Figure 8.3-b. Installation Letter
714
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 10
Release Date: 4/30/79
Update #: 24
Please note that it will be necessary for you to make changes to the
installation deck to suit your local situation. For example, you may not use
3330 disk packs at your installation, and I am sure that your disk volume
serial number will not be CDHSPK. Your tape unit designation may not be 2400,
and you may wish to re-name the data sets when copying them from the tape to
your disk.
After you have installed the system, it will be necessary for you to
change several lines of coding in the cataloged procedures prior to copying
them into your PROCLIB. A complete list of these procedures is attached.
Should you choose to retain the prefix of CDHS.AQS. for your data set
names, you should change the appropriate line of each procedure to read:
//ddname PROC PROJECT-'CDHS.AQS1,
An equivalent change must also be made if you choose a different prefix for
your data set names. Similar changes will be required in the data set names
specified on the DD cards (DSNAME=CDHS.AQS.JOBS).
I urge you not to make any modifications other than those which must be
made to the Job Control Language (JCL), NADB will make all modifications to
the standard NADB system, and will support ONLY NADB-modifled versions of the
system.
If you wish to make modifications for your own purposes, you should make
them to a copy of the baseline system. You should/ however/ maintain the
baseline system incorporating only those changes distributed by NADB. This
will give you an opportunity to test problems against the baseline. If you
have a problem/ and the problem is reproduced in the baseline/ please report
the problem to NADB. If the problem occurs in the modified version only/ it
is your responsibility to correct that problem.
Updates 1 through 24 have been incorporated into your system; thus, the
next AQDHS-II update to your system will be number 25.
(page 2 of 4)
Figure 8.3-b - continued. Installation Letter
715
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 11
Release Date: 4/30/79
Update #: 24
Also included are a copy of the AQDHS-II User's Guide, a copy of the
Documentation of the AQDHS-II Test Run Series, all back issues of the CDHS
User's Bulletin, and a copy of the System Status/Hardware/Software
Questionnaire. This questionnaire should be completed and returned to me when
your installation is complete.
If you have any questions, do not hesitate to call me at (919) 541-5491.
Sincerely yours,
Lloyd M. Hedgepeth
Project Officer
National Air Data Branch (MD-14)
Enclosures
(page 3 of 4)
Figure 8.3-b - continued. Installation Letter
716
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 12
Release Date: 4/30/79
Update #: 24
Attachment 1 - AQDHS-II Cataloged Procedures
AQCVM10
AQCVM20
AQCVP10
AQCVT10
AQEDT10
AQEMD10
AQEMM10
AQEMP10
AQEMS10
AQFMM10
AQMSM10
AQMSM20
AQRPD10
AQRPM05
AQRPM10
AQRPM15
AQRPM20
AQRPM25
AQRPM30
AQRPM35
AQRPM40
AQRPM45
AQRPP10
AQRPP20
AQRPS10
AQRPS20
AQRTM10
AQRTM20
AQRTM30
AQSRM10
AQSTM10
AQSTM20
AQCLC10
AQCLF10
(page 4 of 4)
Figure 8.3-b - continued. Installation Letter
717
-------
AQDHS-II SECTION 8.3
JCL AND GENERAL INSTALLATION
TOPICS
//* AOOHS INSTALLATION
//*
Page 13
Release Date: 4/30/79
Update #: 24
00000200
00000300
//* THIS JUB WILL SCKATCH AND RE-ALLOCATE ALL DATA SETS NtCESSARY FOR 00000400
//»
00000500
//* THE INSTALLATION OF THE AQOHS. IT WILL THEN COPY THE INSTALLATION 00000600
//*
00000700
//* TAPE INTO THESE DATA SETS AND PUNCH THE JOBS REQUIRED TO COMPILE 00000800
//*
00000900
//* AND LINK-EDIT THE VARIOUS PROGRAMS IN THE SYSTEM. IT WILL THEN 00001000
//*
//* PRINT THOSE JOBS, THE CATALOGED PROCEDURES, THE LINKAGE
//•
//* CONTROL CARDS, THE SORT CONTROL CARDS AND THE TEST DATA
//*
00001100
EDITOR 00001200
00001300
. THE 00001400
00001500
//* LISTING SHOULD BE EXAMINED TO BE CERTAIN THAT THE PROCEDURES ARE 00001600
//*
//* CORRECT FOR THIS PARTICULAR COMPUTER CENTER. AFTER ANY
//*
//* CHANGES HAVE BEEN HADE, THE JOBS PUNCHED OUT MAY BE RUN
//*
//* SEQUENTIALLY TO INSTALL AND TEST THE AQDHS.
//*
//SCRATCH EXEC PGMsIEFBRl4,
// TIMEs(0,5),
// REGION»4K
//JCL DD DISPs(OLD, DELETE),
// DSNAME'CDHS.AQS.JCL
//JOBS DD DISPs(OLD, DELETE),
// DSNAME'CDHS.AQS.JOBS
//LOAD DD DISPs(OLD, DELETE),
// DSNAMEsCDHS.AQS.LOAD
//SOURCE DD OISPsCOLD, DELETE),
// DSNAMEsCOHS.AQS. SOURCE
//SYSIN OD DISPs(OLD, DELETE),
// DSNAMEsCDHS.AQS. SYSIN
//ALLOC. EXEC PGM«IEFBR14,
// REGION=4K,
// TIMEe(0,5)
//JCL DD UNITB3330,
// VOLUME»(PRIVATE, RETAIN, SER»CDHSPK),
// DISPs(NEW,CATLG, DELETE),
// SPACEs(TRK,(20ilO,5)),
// DSNAMEsCDHS.AQS. JCL
//JOBS DD UNITS3330,
// VOLUMES (PRIVATE, RETAIN, SER*CDHSPK),
// DISPs(NEW,CATLG, DELETE),
// SPACEs(TRK,(10,JO,5)),
// DSNAMEsCDHS.AOS.JOBS
//LOAD DD UNITs3330,
// VOLUMES (PRIVATE, RETAIN, SERsCDHSPK),
// DISPa(NEW,CATLG, DELETE),
// SPAC£s(TRK,(44,10,5)),
// DSNAME=COH3.AQ3. LOAD
//SOURCE DD UNIT=3330,
// VOLUMES (PRIVATE, RETAIN, SERsCDHSPK),
// DISP=(NEW,CATLG, DELETE),
// SPACEs(TRK,(200,50,5)),
// DSNAME=CDHS.AQS. SOURCE
//SYSIN DD UNIT*3330,
// VOLUMES (PRIVATE, RETAIN, SERsCDHSPK),
// DISPs(NEh,CATLG, DELETE),
// SPACEs(TRK,(5,5,5)),
// DSNAMEsCDHS.AOS. SYSIN
//TAPEIN EXEC PGM=IEHMOVE,
00001700
NECESSARY 00001600
00001900
00002000
00002100
00002200
00002300
00002500
00002600
00002700
00002800
00002900
00003000
00003100
00003200
00003300
00003400
00003500
00003600
00003700
00003800
00003900
00004000
00004100
00004200
00004300
00004400
00004500
00004600
00004700
00004800
00004900
00005000
00005100
00005200
00005300
00005400
00005500
00005600
00005700
00005800
00005900
00006000
00006100
00006200
00006300
00006400
00006500
00006604
(page 1 of 3)
Figure 8.3-c. AQDHS-II Installation Deck
718
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 14
Release Date: 4/30/79
Update #: 24
// KEGION=90K,
// TIMEs(5,0)
//SYSPRINT OD SYSOUTsA
//SYSUT1 OD UN1TS3330,
// VOLUMEs(PRIVATE, RETAIN, SER'CDHSPK) ,
// DISPaOLD
//CDHSPK DD UNIT=J3JO,
// VOLUMEsCPRJVATE, RETAIN, SERsCDHSPK) ,
// DISPeOLD
//TAPE DO UNITc2400,
// VOLUMEBSERsAQSTAPi
// DISP«CNEN,PASS),
// LABEL=(,BLP),
// DCBa(RECFM»FB,LRECL«80,BLKSIZEs800,DENs3)
//SY3IN DD *
COPY TOs3330«CDHSPK,FROMDDsTAPE,FROMsTAPEs(AOSTAP,l),
PDSsCDHS.AQS.JCL
TOs3J30=CDHSPK,FROMDDsTAPE,FROMsTAPEs(AOSTAP,2),
PDSsCDH3.AQ3.JOBS
TOs3330sCDHSPK,FROMDDaTAPE,FROM*TAPEs(AOSTAP,3),
PDSaCDHS.AQS. SOURCE
TOa33308CDHSPK,FROMDD»TAPE,FROMsTAPEs(AOSTAP,4),
PDS«COHS.AOS.SYSIN
//PUNCH EXEC PGM«IEBPTPCH,
// REGIONS60K,
// TI«EB<1,0)
//SYSPRINT DD SYSOUTsA
//8YSUT1 DD DSNAMEaCDHS.AQS.JOBS,
// VOLUMEa(pRIVATE, RETAIN),
// DISPs(SHR,PA3S)
//8YSUT2 DD SYSOUTaB
//8YSIN OD
COPY
COPY
COPY
PUNCH TYPORG«PO,MAXNAME»2
//PRINT! EXEC PGHalEBPTPCH,
// REGIONsbOK,
// TIHE»(1,0)
//SYSPRINT DD SYSOUTsA
//8YSUT1 DD DSNAHEaCDH3.AQ3.JCL,
// VOLUMEsCPRIVATE,RETAIN),
// DISPa(SHR,PAS3)
//3YSUT2 DO SYSOUTsA
//SY3IN 00 *
PRINT TYPORGaPO,MAXFLDS*l
TITLE ITEMsC AODHS-II CATALOGED PROCEDURES',!)
TITLE ITEM»C ',!)
RECORD FIELD»C80,1,,25)
//PRINT2 EXEC PGM=IEBPTPCH,
// REGIONsbOK,
// TIM£a(l,0)
//SYSPRINT DD SYSOUTsA
//SYSUT1 OD DSNAMEaCDHS.AOS.JOBS,
// VOLUMEsCPRIVATE,RETAIN),
// DISPs(SHR,PASS)
DD SYSOUTsA
//3YSUT2
//SYSIN
PRINT
TITLE
TITLE
RECORD
//PRINT3
00
TYPORGsPO,MAXFLDSsl
ITEMsC'AQDHS-II INSTALLATION JObS',1)
ITEMsC »,l)
FIELDs(80,l,,25)
tXEC PGM=1E8PTPCH,
// REGIONsbOK,
// TIMEs(l,0)
//SYSPRINT DD SYSOUTsA
//SYSUT1 00 OSNAMEsCDHS.AQS.SOURCE,
OOOObTOO
00006800
00006900
00007000
00007100
00007200
00007300
00007400
00007SOO
00007600
00007700
00007800
00007900
00008000
00008100
XOOOOB200
00008300
X00008400
00008SOO
X00008600
00008700
X00008800
00008900
00009000
00009100
00009200
00009300
00009400
00009500
00009600
00009700
00009800
00009900
00010000
00010100
00010200
00010300
00010400
00010500
OOOlObOO
00010700
00010800
00010900
00011000
00011100
00011200
00011300
00011400
00011500
00011600
00011700
00011800
00011900
00012000
00012100
00012200
00012300
00012400
00012500
00012600
00012700
00012800
00012900
00013000
(page 2 of 3)
Figure 8.3-c - continued. AQDHS-II Installation Deck
719
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 15
Release Date: 4/30/79
Update #: 24
ii
//SYSUT2 DO
//SYSIN 00
PRINT
TITLE
TITLE
RECORD
//PRINT4 EXEC
II
II
//SYSPRINT
//SYSUT1
II
II
//SY8UT2 0
//8Y8IN 0
PRINT
TITLE
TITLE
RECORD
DD
DO
VOLUMES(PRIVATE.HE TAIN),
DISPs(SHR,PASS)
SYSOUT'A
*
TTPORG«PO,MAXFLDS«1
1TEM«('AQOH3-11 SOURCE CODEM)
ITEM»(» M)
FIELD«<80,1,,25)
PGMHEBPTPCH,
REGIONBbOK,
TIME»(J,0)
SYSUUTiA
DSNAME»COH3.A08.SYSIN,
VOLUMEKPRIVATE,RETAIN),
DISP»(SHR,PA8S)
SYSOUTBA
*
TVPORG>PO,MAXFLDS*i
ITEM«C AQDHS-II SYSIN STATEMENTSM)
ITEM«C M)
FIELO*(SO,1,,25)
00013100
00013200
00013300
00013400
00013500
00013600
00013700
00013800
00013900
00010000
00014100
00014200
00014300
00014400
00014500
00014600
00014700
00014600
00014900
00015000
00015100
Figure 8.3-c - continued.
(page 3 of 3)
AQDHS-II Installation Deck
720
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 16
Release Date: 4/30/79
Update #: 24
SYSTEM STATUS/HARDWARE/SOFTWARE QUESTIONNAIRE
(Please complete and return to NADB)
Agency:
Address:
HARDWARE
Location:
IBM
UNIVAC
Model Number
Series Number
Core size (specify words or
EXEC-8, etc.
Tape Drive (specify 7-track
556 bpi, 9-trach 1600 bpi ,
etc.)
2314>
, Other t
(Specify)
SOFTWARE
Please list software i
which are/will '
tape management
tware items (installed, being installed, or planned)
be peculiar to your installation and programs (e.g.,
, spooling requirements, update utilities other than
standard. i$M utilities). We re specificallyinterested in anyj
which affect how an update
.
peculiarities of your Computing systems
is or can be incorporated.
(page 1 of 4)
Figure 8.3-d. System Status/Hardware/Software Questionnaire
721
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 17
Release Date: 4/30/79
Update #: 24
SYSTEM STATUS/HARDWARE/SOFTWARE QUESTIONNAIRE
SUBSYSTEM STATUS
Air Quality Data Handling Subsystem II (AQDHS-II);
Installed? Yes No
By whom?
Task order expiration (date)
Operational since (date)
Installation in progress? Yes No
By whom?
Scheduled to be operational (date)
Installation planned? Yes No
Installation schedule (dates)
Last update performed # Date
Emissions Inventory Subsystem/Permits and Registration (EIS/P&R);
Installed? Yes No
By whom?
Task order expiration (date)
Operational since (date)
Installation in progress? Yes - No
By whom?
Scheduled to be operational (date)
Installation planned? Yes No
Installation schedule (dates)
Last update performed # Date
(page 2 of 4)
Figure 8.3-d - continued. System Status/Hardware/Software Questionnaire
722
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 18
Release Date: 4/30/79
Update #: 24
SYSTEM STATUS/HARDWARE/SOFTWARE QUESTIONNAIRE
AIR POLLUTION CONTROL MANAGER;
Please furnish full title and address of the State and/or Local (county
or municipal} agency responsible for all air pollution control activities
of the agency and tne name, title, address, and phone number of the
agency's director.
Name and Title:
Agency:
Address:
City: State: Zip:
Phone Number(s):
AQDHS-II DATA BASE COORDINATOR:
Name and Title:
Address:
City: State: Zip:
Phone Number(s):
EIS/P&R DATA BASE COORDINATOR:
Name and Title:
Address:
City: State: Zip:
Phone Number(s):
(page 3 of 4)
Figure 8.3-d - continued. System Status/Hardware/Software Questionnaire
723
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 19
Release Date: 4/30/79
Update #: 24
SYSTEM STATUS/HARDWARE/SOFTWARE QUESTIONNAIRE
DATA PROCESSING PERSONNEL:
Director:
Name and Title:
Address:
City: State: Zip:
Phone Number(s):
AQDHS-II Contact (person responsible for performing updates):
Name and Title:
Address:
City:( State: Zip:
Phone Number(s):
EIS/P&R Contact (person responsible for performing updates):
'Name and Title:
Address:
City: State: Zip:
Phone Number(s):
Contract Support:
Please.identify contractor and furnish name, address and phone
number(s) of any contract personnel supporting your CDHS subsystems.
(page 4 of 4)
Figure 8.3-d - continued. System Status/Hardware/Software Questionnaire
724
-------
AQDHS-II
JCL AND GENERAL
TOPICS
SECTION 8.3
INSTALLATION
Page 20
Release Date: 4/30/79
Update #: 24
//EPALMH71 JOB
//DISK DO UNIT«3330,VOL»8ER«CDHSPK,DISPsOLD
//TAPE DO UNIT«2400,DISP»(NtW,PA3S),VOL«StR«»
// LABELS 3D, DCB«CRECPM«Ffl,LRECL»80,BLKSIZ£t800)
//8Y3IN DD *
JOB 632
00000100
00000200
00000300
00000400
00000500
00000600
00000700
00000900
IEF236I
IEF237I
IEF237I
IEF237I
IEF237I
IEF237I
IEF142I
IEF285I
IEF28SI
IEF285I
IEF2B51
IEF285I
IEF285I
IEF373I
IEF374I
CNW949I
CNW949I
CNW9SOI
CNH949I
CNN9SOI
CNW949I
CNW950I
CNW950I
CNW949I
CNM9SOI
CNW949I
CNW9491
IEF2851
IEF2B5I
IEF375I
IEF376I
CNN949I
CNW949I
CNW9SII
CNW949I
CNH95II
CNH949I
CNH951I
CNH9491
ALLOC. FUR EPALMM71
053 ALLOCATED TO 3Y3PRINT
ICO ALLOCATED TO SYSUT1
154 ALLOCATED TO DISK
486 ALLOCATED TO TAPE
Oil ALLOCATED TO SYS IN
- STEP WAS EXECUTED
SYS79l08.TOS5137.RVO"OO.llJALMH71.HOOl4315
COND CUUE 0004 I
T«
VOL SER N03* HORK52.
CN,EPALMM,A087,CDH3.HQ.t»NR. SOURCE
VOL SER NUSs CDHSPK.
CH.EPALMH.A087.CDHS.HO.PHR.SOURCE
VOL SER N08» 034924.
STEP / / START 79108.1234
STEP / / STOP 79108.1237 CPU OMIN 02.433EC MAIN S8K LCS OK
****************** COMNET • SYSTEM EE • STEP SUMMARY •*»***•*••*****«•»
DELETED
KEPT
PASSED
JOB EPALMH71
STEP
I/O COUNTSI
Dll • 5
83.96 STEP CUU 2.43 STEP CPU SEC3.
REGION bOK REQ 58K USED CONDITION CODE 0004
053 • 98 ICO « 178 154 • 697 486 * 2295
STEP COST
$23.SO
ft**********************************•*•••**•*««***«*•**«•*«««•««••«***»«»
CN.EPALMH.A087.CDH3.HO.PNH.SOURCE DELETED
VOL SLR NUS« 034924.
JOO /EPALMH71/ START 79108.1234
JOD /EPALMH71/ STOP 79108.1237 CPU OMIN 02.43SEC '
***»•**•**»**•«***• COMNET • SYSTEM EE • JOB SUMMARY •*••••*••*•*•••••«•
*
JOB EPALMH71 83.96 TOTAL CUU 2.43 TOTAL CPU SEC3. *
PRTY REO/RCD/CHO 4/5/4 I DISK MOUNTS CONDITION CODE 0004
JOQ COST a CUUS » MOUNTS • S23.SO t 15.00 • $28.SO
8.3-e. Condition Code for IEHMOVE
725
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 1
Release Date: 4/30/79
Update #: 24
APPENDIX A - CODE TABLES
Page
Introduction 727
Agency Codes 728
Project Codes 729
Time Codes 730
Units Codes 731
Valid Negative Value Parameters 732
Maximum Values for Parameters 733
726
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 2
Release Date: 4/30/79
Update #:. 24
INTRODUCTION
This appendix lists the commonly used codes associated with AQDHS-II.
Included are codes for: agency, project, sampling interval (time codes), units,
and negative value parameters. If these codes are not comprehensive enough,
refer to Aeros Manual Series, Volume V: AEROS Manual of Codes.
727
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 3
Release Date: 4/30/79
Update #: 24
Table A-l. Agency Codes
Agency Codes
Code Agency
A EPA group responsible for atmospheric surveillance
B EPA group responsible for meteorological activity
C EPA group responsibl'e for effects research
D.. EPA group responsible for atmospheric research
E EPA group responsible for abatement activity
F State agency
G County agency
H City agency
I District agency
0 Private
K Institution (university, college, etc.)
L Military
M Internati onal agency
N Other Federal nonmilitary agencies
0-Y Open for future expansion
Z Other
728
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 4
Release Date: 4/30/79
Update #: 24
Table A-2. Project Codes
Project Codes
Long-term Surveillance
Code
Project
01 Popul at ion-oriented survei 1 lance
02 Source-oriented ambient surveillance
03 Background survei 11 ance
Short-term Surveillance
Code
Project
04 Compl aint investi gation
05 Special studies
06 Epi sode monitoring
729
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 5
Release Date: 4/30/79
Update #: .24
Table A-3. Time Codes
Interval
One-hour 1
Two-hour 2
Three-hour B
Four-hour 3
Six-hour 4
Eight-hour 5
Twelve-hour 6
Daily 7
Weekly A
Monthly 8
Quarterly 9
Composite C
SAROAD AQDHS-II
Time Code Time Code
1
2
3
4
5
6
7
8
9
A
B
C
Valid Start Hours
00, 08, 16 (AQDHS-II); 00, 12 (SAROAD)
00, 01, 16, 17 (AQDHS-II); 00, 01 (SAROAD)
00, 01, 02
00, 01, 02, 03
00, 01, 02, 03, 04, 05
00, 01, 02, 03, 04, 05, 06, 07
00, 01, 02, 03, 04, 05, 06, 07, 08, 09, 10, 11
00-23
00-23
00-23
00-23
730
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 6
Release Date: 4/30/79
Update #: 24
Table A-4. Units Codes
Units Codes
Code Units
01 micrograms/cubic meter (25° c, 1013 millibars)
02 micrograms/cubic meter (0° C, 1013 millibars)
03 nanograms/cubic meter (25° C, 1013 millibars)
04..... nanograms/cubic meter (0° C, 1013 millibars)
05 milligrams/cubic meter (25° C, 1013 millibars)
06 milligrams/cubic meter (0° C, 1013 millibars)
07 parts per million (volume/volume)
08 parts per billion (volume/volume)
09 COHS/1000 linear feet
10 RUDS/10,000 linear feet
11 meters/second
12 miles/hour
13 knots
14 degrees
20 microns
30 picocuries/cubic meter
31 microcuries/cubic meter
32 picocuries/square meter
33 microcuries/square meter
34 picocuries/cubic centimeter
35 picocuries/gram
50 number of threshold levels
70 milligrams F/100 square centimeters-day
80 milligrams SOs/100 square centimeters-day
81 micrograms SOg/square meter-day
731
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 7
Release Date: 4/30/79
Update #: 24
Table A-4 - Continued. Units Codes
Units Codes
Code
90.
Units
.tons/square mile-month3
91 mi 11 igrams/square centimeter-month3
92 micrograms/cubic meter-month3
98 milligrams S04/square centimeters-30 days
99 milligrams/square centimeters-30 days
30n a calendar-month basis.
Table A-5. Valid Negative Value Parameters
Parameter Number
Name
61202
62101
62103
62104
62105
62106
Lapse Rate
Temperature
Dew Point
Temperature, 24-hour Maximum
Temperature, 24-hour Minimum
Temperature Difference
732
-------
AQDHS-II
APPENHX A
CODE TABLES
Page 8
Release
Update
Date: 4/30/79
#: 24
Table A-6. Maximum Values for Parameters
Parameter
Number
11101
11101
42101
42101
42101
42401
42401
42401
42401
42601
42601
42601
42601
42602
42602
42602
42602
42603
42603
42603
43101
Units
Code
01
02
05
06
07
01
02
07
08
01
02
07
08
01
02
07
08
01
07
08
01
Maximum
Value
2000.0
2183.3
115.0
125.5
100.0
5240.0
5720.5
2.0
2000.0
3690.0
4028.4
3.0
3000.0
3760.0
4104.8
2.0
2000.0
9400.0
5.0
5000.0
9810.0
Parameter
Number
43101
43101
43101
43102
43102
43102
43102
44101
44101
44101
44101
44103
44103
44103
44103
44201
44201
44201
44201
61102
Units
Code
05
06
07
01
02
05
07
01
02
07
08
01
02
07
08
01
02
07
08
14
Maximum
Value
9.8
10.7
15.0
6540.0
7139.8
6.6
10.0
1372.0
1497.8
0.7
700.0
1372.0
1497.8
0.7
700.0
1372.0
1497.8
0.7
700.0
360.0
733
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 1
Release Date: 4/30/79
Update #: 24
APPENDIX B - ERROR MESSAGES
Error messages indicate any problems encountered in a particular execu-
tion of a program. Errors are grouped into categories according to the
severity of the error and its effect on the execution of the program. These
categories are as follows:
Warning: A warning-category error does not cause termination of program
execution or rejection of input data, but informs the user of an
aspect of the input data that may warrant his attention.
Warning messages are normally suppressed, and the user must
specify an option to have them printed.
Conditional:
A conditional-category error does not cause termination of
program execution or rejection of input data. It informs
the user that an entry in the input data may be in error and
should be examined and verified. Conditional messages
cannot be suppressed.
Error: An error-category error does not cause termination of
program execution; however, the input data in which the
error was detected is rejected. Error messages cannot oe
suppressed.
Abort: An abort-category error causes termination of program
execution. The user can recover from an abort by correcting
the condition(s) that caused the abort. Abort messages
cannot be suppressed.
734
-------
AQDHS-II
APPENDIX
State
Number
01
02
03
04
05
06
07 .
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
A
Table
CODE TABLES
A-7. Valid UTM
State Zones
Name Min
Alabama 16
Alaska 01
Arizona 11
Arkansas 15
California 10
Colorado 12
Connecticut 18
Delaware 18
District of 18
Columbia
Florida 16
Georgia 16
Hawaii 04
Idaho 11
Illinois 15
Indiana 16
Iowa 14
Kansas 14
Kentucky 16
Louisiana 15
Maine 19
Maryland 17
Massachusetts 18
Michigan 15
Minnesota 14
Mississippi 15
Missouri 15
Montana 11
Nebraska 13
Max Min
16 350
59 0
12 210
16 200
.11 160
13 150
19 250
18 420
18 315
17 200
17 200
05 200
12 160
16 210
16 380
15 200
15 220
17 220
16 180
19 320
18 220
19 230
17 230
16 180
16 200
16 210
13 190
15 220
733
Page: 9
Release
Update #
Date:
: 29
10/31/81
Zones and Components
Easting
Northing
Max
720.0
999.9
800.0
830.0
820.0
860.0
780.0
498.0
335.0
830.0
800.0
820.0
830.0
780.0
730.0
780.0
880.0
780.0
830.0
670.0
800.0
750.0
810.0
800.0
810.0
840.0
880.0
800.0
.1
Min
3342
5408
3450
3640
3595
4090
4529
4254
4290
2720
3353
2100
4630
4089
4178
4470
4090
4035
3189
4760
4200
4562
4617
4815
3331
3980
4920
4420
Max
3891
7629
4100
4045
4660
4550
4661
4419
• 4330
3450
3880
2452
5430
4711
4628
4825
4440
4342
3645
5265
4413
4738
5265
5470
3880
4502
5430
4770
-------
AQDHS-II
APPENDIX A
State
Number
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
Table A-
State
Name
Nevada
New Hampshire
New Jersey
New Mexico
New York-
North Carolina
North Dakota-
Ohio
Okl ahoma
Oregon
Pennsylvania
Puerto Rico
Rhode Island
South Carolina
South Dakota
Tennessee
Texas
Utah
Vermont
Virginia
Washington
West Virginia
Wisconsin
Wyoming
American Samoa
Guam
Virgin Islands
7 -
CODE TABLES
continued.
Valid
Zones
Min
11
18
18
12
17
16
13
16
13
10
17
1.9
19-
17
13
15
13
12
18
17
10
17
15
12
Max
11
19
18
13;
18
18
14
17
15-
11
18
20
19
17
14,
17
15
12
19
18
11
18
16
13
no validation
no validation
20
20
Min
240
210
440
140
220
200
240
210
150
220
220
80
260
260
250
200
160
240
260
210
210
220
230
200
done
done
290
UTM Zones
E a sting
Page:
Release
Update
10
Date:
#: 29
"I
10/31/81
and Components
Northing
Max
750.0
800.0
625.0
810.0
760.0
800.0
790..0
780.0
800.0
800.JO
810.0
870.0
320.0
750.0
750.0
800.0
830.0
680.0
780.0
790.0
810.0
780.0
800.0
800.0
350.0
Min
3860
4717
4309
3473
4491
3738
5079
4244
361.7
4640
4397
1969
4551
3540
4694
3867
2848
4090
4727
4041
5035
4117
4705
4530
1946
. Max
4660
5023
4584
4100
4990
4066
5430
4650
4110
5128
4683
2055
4656
3902
5085
4067
4045
4660
4991
4370
5430
4502
5211
4990
2056
733.2
-------
AQDHS-II
APPENDIX A
CODE TABLES
Page 11
Release Date: 5/01/81
Update #: 28
Table A-8. Null Data Codes
Null Data Code
9980
9981
9982
9983
9984
9985
9986
9997
Abbreviation
MALF
WTHR
VAND
COLL
LAB
QUAL
CALB
WAIV
Explanation
Machine Malfunction
Bad Weather
Vandalism
Collection Error
Lab Error
Poor Quality Assurance Results
Calibration
Monitoring Waived
733.3
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 2
Release Date: 5/01/80
Update #: 27
Disaster: A disaster-category error causes termination of program
execution and is caused by a situation from which the user
cannot recover directly. Disaster messages are not expected
to occur in normal operation, thus when a disaster does occur,
it is important that the user contact personnel at NADB to
obtain troubleshooting assistance. Disaster messages cannot
be suppressed.
The error messages which are generated during the execution of a program
are printed in the diagnostic report for that program along with summary
statistics which give a count, by category, of the errors encountered. Each
error message is printed with a beginning indicator of three asterisks (***)
followed by the program name. The program name is printed to clearly indicate
in which program the error was encountered. This eliminates any ambiguity
when more than one program is run in a job stream. The error messages within
each program are numbered sequentially by a three-digit number, starting with
001; this number is printed following the program name. Following this
number, the error category and the message are printed. Error messages which
pertain to a transaction are printed immediately after an image of that
transaction. The entire transaction is edited for errors; and, since it is
possible that more than one error may be detected, multiple error messages may
be printed.
All of the error messages produced by the AQDHS-II programs are listed in the
discussions of the individual programs (Sections 4 thru 6) in this user's guide.
See Figure B-l for a list of references for error messages for each AQDHS-II
program. Each message is listed exactly as it would be printed in the diagnostic
report. A brief description of the conditions which would have caused the error;
what effect, if any, the error had on the execution of the program; and what, if
anything, the user can do to correct the error are also given for each message.
735
-------
AQDHS-II ERROR MESSA
APPENDIX B
Program Program
Name Number
ACVANOM AQ0040
ACVMFOR AQ0020
ACVPFOR AQ0030
ACVSARD AQ0010
ACVUNIT AQ0050
AEDMSTR AQ0060
AEMPARM AQ0070
AEMSITE AQ0080
AEMSTND AQ0090
AFMMSTR AQ0100
AMSARCH AQ0215
AMSMERG AQ0210
ARPANOM AQ0320
ARPDUMP AQ0310
ARPINVP AQ0290
ARPINVS AQ0280
ARPMSBR AQ0300
ARPMSST AQ0270
ARPMSTR AQ0230
ARPPARM AQ0240
ARPPMEX AQ0330
ARPSARD AQ0220
ARPSITE AQ0260
ARPSLAM AQ0390
ARPSMEX AQ0340
ARPSTDS AQ0420
ARPSTND AQ0250
GES Page 3
Release Date: 10/31/81
Update #: 29
Error Messages Page
Reference Number
5.5.5.4 381
5.5.3.4 361
5.5.4.4 370
5.5.2.4 341
5.5.6.4 394
4.5.1.4 125
4.2.2.4 53
4.3.2.4 88
4.4.2.4 105
4.5.3.4 165
5.4.3.4 324
5.4.2.4 315
6.4.3.4 554
6.2.2.4 438
6.4.5.4 588
6.4.4.4 576
6.4.6.4 598
6.4.2.4 526
6.2.3.4 448
6.2.4.4 478
6.4.7.4 607
6.3.2.4 503
6.2.6.4 493
6.5.4.4 629.52
6.4.8.4 618
6.6.4.4 629.12
6.2.5.4 485
(Page 1 of 2)
Figure B-l. References for Error Messages
736
-------
AQDHS-II ERROR MESSfl
APPENDIX B
Program Program
Name Number
ARPVSTD AQ0350
ARTGENR AQ0120
ARTLNGP AQ0110
ARTSLAM AQ0375
ARTSTDS AQ0400
ASRINTR AQ0130
ASRMSTR AQ0140
ASRPARM AQ0150
ASRSITE . AQ0160
ASRSTFL AQ0360
ASRSTND AQ0170
ASRTRAN AQ0370
ASTMSST AQ0200
ASTPRLM AQ0190
ASTSLAM AQ0380
ASTSLAV AQ0180
ASTSTDS AQ0410
GES Page 4
Release Date: 10/31/8:
Update #: 29
Error Messages Page
Reference Number
6.4.9.4 629.7
5.2.3.4 254
5.2.2.4 219
6.5.2.4 629.35
6.6.2.4 629.10
4.5.2.4 156
5.6.2.4 409
4.2.1.4 46
4.3.1.4 . 79
5.6.3.4 420.1
4.4.1.4 98
4.5.4.4 189.1
5.3.3.4 285
5.3.2.4 275
6.5.3.4 629.47
5.3.4.4 295
6.6.3.4 629.11
(Page 2 of 2)
Figure B-l - continued. References for Error Messages
737
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 1
Release Date: 10/31/81
Update #: 29
APPENDIX C - PROGRAM TABLE MODIFICATION
C.I Introduction 739
C.2 Special Instructions 740
C.3 Changing the Site Table Size 741
AEDMSTR (AQ0060) - Master File Transaction Edit Program. . .742
AEMSITE (AQ0080) - Site File Maintenance Program 743
ARPINVP (AQ0290) - Inventory by Pollutant Report Program . .744
ARPINVS (AQ0280) - Inventory by Site Report Program 745
ARPSMEX (AQ0340) - Site Exception Report Program 746
C.4 Changing the Parameter Table Size . 748
ACVANOM (AQ0040) - Anomaly Screening Master File
Conversion Program 749
ACVUNIT (AQ0050) - Units Code Conversion Program 750
AEDMSTR (AQ0060) - Master File Transaction Edit Program. . .752
AEMPARM (AQ0070) - Parameter File Maintenance Program. . . .753
ARPINVP (AQ0290) - Inventory by Pollutant Report Program . .754
ARPINVS (AQ0280) - Inventory by Site Report Program 755
ARPMSST (AQ0270) - Statistical Report Program 756
ARPMSTR (AQ0230) - Master File Detailed Report Program . . .757
ARPPMEX (AQ0330) - Parameter Exception Report Program. . . .758
ARTSLAM (AQ0375) - SLAMS Retrieval Report Program 760
ARTSTDS (AQ0400) - Standards Retrieval Report Program. . . .761
ASTPRLM (AQ0190) - Preliminary Statistics Program 762
C.5 Changing the Parameter Standards Table Size 763
ARPMSTR (AQ0230) - Master File Detailed Report Program . . .764
738
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 8 *
Release Date: 5/01/80
Update #: 27
ARPINVS (AQ0280) - INVENTORY BY SITE REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00015500) from:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00040900) from:
02 SITE-BLOCK PIC X(9800) VALUE SPACES.
to:
02 SITE-BLOCK PIC X(14700) VALUE SPACES.
This will 'allow the table to accommodate 300 records (each record contains
49 characters). The numeric value specified for this PIC clause must be
49 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00041000) from:
02 SITE-CODE-TABLE REDEFINES SITE-BLOCK OCCURS 200 TIMES.
to:
02 SITE-CODE-TABLE REDEFINES SITE-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be 'the same as
that specified for the VALUE clause in Step 1.
745
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 9
Release Date: 5/01/80
Update #: 27
ARPSMEX (AQ0340) - SITE EXCEPTION REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00011300) from:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00016700) from:
02 SITE-BLOCK PIC X(2400) VALUE SPACES.
to:
02 SITE-BLOCK PIC X(3600) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
12 characters). The numeric value specified for this PIC clause must
be 12 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00016800) from:
02 SITE-CODE-KEY REDEFINES SITE-BLOCK OCCURS 200 TIMES.
to:
02 SITE-CODE-KEY REDEFINES SITE-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
746
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 10
Release Date: 5/01/80
Update #: 27
ARPSMEX (AQ0340) also contains a table for site codes that appear on the
AQDHS-II master file but not on the AQDHS-II site file. It is not mandatory
to change the size of this table when changing the size of the AQDHS-II site
file table. However, the procedure is as follows:
1. Change the VALUE clause of the following program statement (on or
about sequence number 00011400) from:
77 MISSING-SITE-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 MISSING-SITE-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00017300) from:
02 MISSING-BLOCK PIC X(3800) VALUE SPACES.
to:
02 MISSING-BLOCK PIC X(5700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
19 characters). The numeric value specified for this PIC clause must be
19 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statements (on or about
sequence numbers 00017400-00017500) from:
02 MISSING-ENTRIES REDEFINES MISSING-BLOCK
OCCURS 200 TIMES.
to:
02 MISSING-ENTRIES REDEFINES MISSING-BLOCK
OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
747
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 11
Release Date: 5/01/80
Update #: 27
C.4 CHANGING THE PARAMETER TABLE SIZE
Whenever it is necessary to change the size (number of entries) of the
parameter table, all programs listed in this section must be modified
accordingly. The user must complete all changes listed for a given program
unless otherwise specified. The user should also refer to the special
instructions at the beginning of this Appendix when modifying programs.
748
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 12
Release Date: 5/01/80
Update #: 27
ACVANOM (AQ0040) - ANOMALY SCREENING MASTER FILE CONVERSION PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00019200) from:
77 NBR-OF-PARMS PIC 999 VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00062100) from:
02 PARM-TABLE-ZEROED PIC X(3600) VALUE SPACES.
to:
02 PARM-TABLE-ZEROED PIC X(5400) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
18 characters). The numeric value specified for this PIC clause must be
18 times the numeric value specified for the VALUE clause in Step 1.
j 3. Change the OCCURS clause of the following program statement (on or about
sequence number 00062300) from:
02 PARM-TABLE-ENTRY OCCURS 200 TIMES.
to:
02 PARM-TABLE-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
Note: Only those parameter records in the parameter file which have any of the
parameter codes listed in Figure 5.5.5-a will be included in this
program table. Therefore, ACVANOM (AQ0040) will not necessarily require
parameter table modifications.
749
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 13
Release Date: 5/01/80
Update #: 27
ACVUNIT (AQ0050) - UNITS CODE CONVERSION PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00012600) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS . PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00021300) from:
02 PARM-BLOCK PIC X(6400) VALUE SPACES.
to:
02 PARM-BLOCK PCI X(9600) VALUE SPACES.
This will allow the "table to accomodate 300 records (each record contains
32 characters). The numeric value specified for this PIC clause must be
32 tgimes the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00021400) from:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 200 TIMES.
to:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
750
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page. 14
Release Date: 5/01/80
Update #: 27
ACVUNIT (AQ0050) also contains a table for parameter codes that appear on the
AQDHS-II master file but not on the AQDHS-II parameter file. It .is not
mandatory to change the size of this table when changing the size of the
AQDHS-II parameter file table. However, the procedure for changing it is as
follows:
1. Change the VALUE clause of the following program statement (on or about
sequence number 00014800) from:
77 TABLE-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 TABLE-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00023000) from:
02 BAD-PARM-BLOCK PIC X(2000) VALUE SPACES.
to:
02 BAD-PARM-BLOCK PIC X(3000) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
10 characters). The numeric value specified for this PIC clause must be
10 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statements (on or about
sequence numbers 00023100-00023200) from:
02 BAD-PARM-TABLE REDEFINES BAD-PARM-BLOCK
OCCURS.200 TIMES.
02 BAD-PARM-TABLE REDEFINES BAD-PARM-BLOCK
OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
751
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 15
Release Date: 5/01/80
Update #: 27
AEDMSTR (AQ0060) - MASTER FILE TRANSACTION EDIT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00040600) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
This will increase the limit of table entries to 300.
2. Change the OCCURS clause of the following program statement (on or about
sequence number 00146400) from:
03 PARM-CODE-KEY-TABLE OCCURS 200 TIMES.
to:
03 PARM-CODE-KEY-TABLE OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
752
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 16
Release Date: 5/01/80
Update #: 27
AEMPARM (AQ0070) - PARAMETER FILE MAINTENANCE PROGRAM
1. Change the number of records in the following diagnostic message (on or
I about sequence number 00053200) from:
CONDITIONAL - NUMBER OF RECORDS IN OUTPUT PARAMETER FILE. EXCEEDS 200.
to:
CONDITIONAL - NUMBER OR RECORDS IN OUTPUT PARAMETER FILE EXCEEDS 300.
?. Change the VALUE clause of the following program statement (on or about
sequence number 00016400) from:
77 BINARY-200 PIC 999 COMP SYNC VALUE 200.
to:
77 BINARY-300 PIC 999 COMP SYNC VALUE 300.
If the number of output parameter file records exceeds the value of this
data item, a conditional message will be generated. After receiving this
message, the user should make the necessary changes to other programs that
access the AQDHS-II parameter file.
753
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 17
Release Date: 5/01/80
Update #: 27
ARPINVP (AQ0290) - INVENTORY BY POLLUTANT REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00014800) from:
77 POLL-MAX PIC 999 VALUE 200.
to:
77 POLL-MAX PIC 999 VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00019900) from:
02 POLL-BLOCK PIC X(7400) VALUE SPACES.
to:
02 POLL-BLOCK PIC X(lllOO) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
37 characters). The numeric specified for this PIC clause must be 37
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00020000) from:
02 POLL-RECORD REDEFINES POLL-BLOCK OCCURS 200 TIMES.
to:
02 POLL-RECORD REDEFINES POLL-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
754
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 18
Release Date: 5/01/80
Update #: 27
ARPINVS (AQ0280) - INVENTORY BY SITE REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00015600) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00040100) from:
02 PARM-BLOCK PIC X(7800) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(11700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
39 characters). The numeric value specified for this PIC clause must
be 39 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00040200) from:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 200 TIMES.
to:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same
as that specified for the VALUE clause in Step 1.
755
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 19
Release Date: 5/01/80
Update #: 27
ARPMSST (AQ0270) - STATISTICAL REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00028100) from:
77 PARM-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 PARM-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00058400) from:
02 PARM-BLOCK PIC X(23800) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(35700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
119 characters). The numeric value specified for this PIC clause must be
119 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00058500) from:
02 PARM-RECORD REDEFINES PARM-BLOCK OCCURS 200 TIMES.
to:
02 PARM-RECORD REDEFINES PARM-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
756
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 20 • ' •
Release Date: 5/01/80
Update #: 27
ARPMSTR (AQ0230) - MASTER FILE DETAILED REPORT PROGRAM
•1. Change the VALUE clause of the following program statement (on or about
sequence number 00037700) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the OCCURS clause of the following program statement (on or about
sequence number 00130000) from:
02 PARM-CODE-TABLE OCCURS 200 TIMES.
to:
02 PARM-CODE-TABLE OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
757
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 21
Release Date: 5/01/80
Update #: 27
ARPPMEX (AQ0330) - PARAMETER EXCEPTION REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00013500) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the.PICTURE clause of the following program statement (on or about
sequence number 00025700) from:
02 PARM-BLOCK PIC X(1800) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(2700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
9 characters). The numeric value specified for this PIC clause must be 9
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00025900) from:
03 PARM-CODE-ENTRY OCCURS 200 TIMES.
to:
03 PARM-CODE-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
758
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 22
Release Date: 5/01/80
Update #: 27
ARPPMEX (AQ0330) .also contains a table for parameter codes that appear on the
AQDHS-II master file but not on the AQDHS-II parameter file. It is not
mandatory to change the size of this table when changing the size of the
AQDHS-II parameter file table. However, the procedure for changing it
is as follows:
1. Change the VALUE clause of the following program statement (on or about
sequence number 00013400) from:
77 NBR-OF-EXCP • PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-EXCP PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00026900) from:
02 NEW-BLOCK PIC X(1800) VALUE SPACES.
to:
02 NEW-BLOCK PIC X(2700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
9 characters). The numeric value specified for this PIC clause must be 9
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00027100) from:
03 NEW-ENTRY OCCURS 200 TIMES.
to:
03 NEW-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
759
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 23
Release Date: 10/31/80
Update #: 29
ARTSLAM (AQ0375) - SLAMS RETRIEVAL PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00028100) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statements (on or about
sequence numbers 00086800-00086900) from:
02 PARM-TABLE-ZEROED PIC X(5600)
VALUE LOW-VALUES.
to:
02 PARM-TABLE-ZEROED PIC X(8400)
VALUE LOW-VALUES.
This will allow the table to accommodate 300 records (each record contains
28 characters). The numeric value specified for this PIC clause must be 28
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00087100) from:
03 PARM-TABLE-ENTRY OCCURS 200 TIMES.
to:
03 PARM-TABLE-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
760
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 24
Release Date: 10/31/80
Update #: 29
ARTSTDS (AQ0400) - STANDARDS RETRIEVAL PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00028300) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200-
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statements (on or about
sequence numbers 00085400-00085500) from:
02 PARM-TABLE-ZEROED PIC X(5600)
VALUE LOW-VALUES.
to:
02 PARM-TABLE-ZEROED PIC X(8400)
VALUE LOW-VALUES.
This will allow the table to accommodate 300 records (each record contains
28 characters). The numeric value specified for this PIC clause must be 28
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00085700) from:
03 PARM-TABLE-ENTRY OCCURS 200 TIMES.
to:
03 PARM-TABLE-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
761
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 25
Release Date: 5/01/80
Update #: 27
ASTPRLM (AQ0190) - PRELIMINARY STATISTICS PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00017500) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statements (on or about
sequence numbers 00044900-00045000) from:
02 PARM-TABLE-ZEROED PIC X(3800)
VALUE LOW-VALUES.
to:
02 PARM-TABLE-ZEROED PIC X(5700)
VALUE LOU-VALUES.
This will allow the table to accommodate 300 records (each record contains
19 characters). The numeric value specified for this PIC clause must be 19
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00045300) from:
03 PARM-TABLE-ENTRY OCCURS 200 TIMES.
to:
03 PARM-TABLE-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
762
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 3
Release Date: 10/31/81
Update #: 29
Table E-l. Cross-Reference of Files and Programs
Programs Which
Process
File the File
Permanent Files
Archived Master File* AMSARCH (AQ0215)
Master File ACVANOM (AQ0040)
ACVMFOR (AQ0020)
ACVUNIT (AQ0050)
AFMMSTR (AQ0100)
AMSARCH (AQ0215)
AMSMERG (AQ0210)
ARPDUMP (AQ0310)
ARPINVP (AQ0290)
ARPINVS (AQ0280)
ARPMSBR (AQ0300)
ARPMSTR (AQ0230)
ARPPMEX (AQ0330)
ARPSARD (AQ0220)
ARPSMEX (AQ0340)
ARfVSTD (AQ0350)
ARTGENR (AQ0120)
ARTSLAM (AQ0375)
ARTSTDS (AQ0400-)
ASRMSTR (AQ0140)
ASTPRLM (AQ0190)
Parameter File ACVANOM (AQ0040)
ACVPFOR (AQ0030)
ACVUNIT (AQ0050)
AEDMSTR (AQ0060)
Usage
Input/Output
Output
Input/Output
Input
Input
Input/Output
Input/Output
Input/Output
Input
Input
Input
Input
Input
Input
Input/Output
Input
Input
Input
Input
Input
Input/Output
Input
Input
Input
Input
Input
*The archived master file may be used instead of the master
program that uses the master file as input.
777
file in any
(Page 1 of 6)
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 30
Release Date: 4/30/79
Update #: 24
(i.e., a master file that has not been sorted by ASRMSTR
(AQ0140)). If the correct master file was used, there is a
serious problem with that master file, and the user should
contact NADB.
AFMMSTR 009 DISASTER - NEW MASTER FILE WILL BE OUT OF SEQUENCE
MASTER FILE RECORD KEY 1 = XXX
MASTER FILE RECORD KEY 2 = XXX
TRANSACTION RECORD KEY = XXX
Meaning: AFMMSTR (AQ0100) attempted to create a new master file record
with a key less than or equal to that of the last master file
record written and, therefore, the run was terminated. Do not
use the output from this run.
Action: Call NADB.
-AMSARCH-
*** AMSARCH 001 ABORT - INVALID YEAR SPECIFIED
Meaning: Either no option card is present, or the specified option date
is not numeric or not greater than 59. Therefore, the run was
terminated.
Action: Correct the error and resubmit the job.
-AMSMERG-
AMSMERG 001 ABORT - IDENT KEY='identification key' IS FOUND ON BOTH FILES
Meaning: Records with identical keys were found in both files and
program execution was terminated.
Action: Delete the undesired duplicate record from one of the input
files and resubmit the job.
763
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 31
Release Date: 4/30/79
Update #: .24
AMSMERG 002 ABORT - FILE #1 OUT OF SEQUENCE
Meaning: Input file #1 is out of sequence or contains records with
duplicate keys. Therefore, program execution was terminated.
Action: Sort input file #1 into the proper sequence using program
ASRMSTR (AQ0140). Verify that there are no records with
duplicate keys in the file. If there are, correct the error
and resubmit the job.
AMSMERG 003 ABORT - FILE #2 OUT OF SEQUENCE
Meaning: Input file #2 is out of sequence or contains records with
duplicate keys. Therefore, program execution was terminated.
Action: Sort input file #2 into the proper sequence using program
ASRMSTR (AQ0140). Verify that there are no records with
duplicate keys in the file. If there are, correct the error
and resubmit the job.
-ARPANOM-
ARPANOM 001 DISASTER - INVALID OR MISSING HEADER RECORDS ON INPUT FILE
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
invalid or missing header records.
Action: Call NADB.
ARPANOM 002 ABORT - INVALID OPTION
Meaning: The option card read by ACVANOM (AQ0040) was invalid.
Action: Correct or delete the option card and re-execute ACVANOM
(AQ0040) and ARPANOM (AQ0320).
764
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 32
Release Date: 4/30/79
Update #: .24
ARPANOM 003 DISASTER - INPUT FILE CONTAINS DATA NOT TO BE SCREENED
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320)
contains data which does not fall into one of the categories in
Figure 6.4.3-a.
Action: Call NADB.
ARPANOM 004 ABORT - INVALID STATE CODE (XXXXXXXXXXXXX-YYYYYY-ZZZZZZZZZ).
Meaning: A master file record has an invalid state code. (Note: this
error can only occur when screening readings for sulfur
dioxide.) XXXXXXXXXXXXX is the state-area-site-agency-project-
time codes, YYYYYY is the year-month-day, and ZZZZZZZZZ is the
parameter-method-unit codes of the record causing the error.
Action: Correct the master file using AEDMSTR (AQ0060), ASRINTR
(AQ0130), and AFMMSTR (AQ0100). Re-execute ACVANOM (AQ0040)
and ARPANOM (AQ0320).
ARPANOM 005 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
ARPANOM 006 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
ARPANOM 007 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
765
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 33
Release Date: 4/30/79
Update #: 24
ARPANOM 008 DISASTER - INPUT FILE IS INVALID
Meaning: The file passed from ACVANOM (AQ0040) to ARPANOM (AQ0320) has
out-of-sequence or missing records.
Action: Call NADB.
- A R P I N V -
ARPINVP 001 ABORT - POLLUTANT TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II parameter file exceeds
the limit of 200 imposed by the parameter code table in the
program; therefore, the run was terminated.
Action: Either decrease the size of the input parameter file or
increase the size of the parameter code table in the program
(see Appendix C: Program Modification).
ARPINVP 002 ABORT - SITE TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II site file exceeds the
limit of 200 imposed by the site code table in the program;
therefore, the run was terminated.
Action: Either decrease the size of the input site file or increase the
size of the site code table in the program (see Appendix C:
Program Modification).
ARPINVP 003 ABORT - LEVEL 77 DATA FIELD "PARM-MAX" INCREASED BEYOND PARM-
TABLE SIZE
Meaning: In an attempt to increase the size of the parameter table in
the program, the user has changed only one of the two pertinent
lines of code; therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the size of the
parameter table.
766
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 34
Release Date: 4/30/79
Update #: 24
ARPINVP 004 ABORT - LEVEL 77 DATA FIELD "SITE-MAX" INCREASED BEYOND SITE-
TABLE SIZE
Meaning: In an attempt to increase the size of the site table in the
program, the user has changed only one of the two pertinent
lines of code; therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the size of
the site table.
-ARPINVS-
ARPINVS 001 ABORT - SITE FILE OVERFLOW: NUMBER OF SITE FILE RECORDS EXCEEDS
PROGRAM STORAGE SPACE
Meaning: There are more records in the site file than the table (defined
in the program) can accommodate; therefore, the run was
terminated.
Action: Increase the size of the table in the program accordingly.
Refer to Appendix C for instructions on changing the size of
the table.
ARPINVS 002 ABORT - PARAMETER FILE OVERFLOW: NUMBER OF PARAMETER FILE RECORDS
EXCEEDS PROGRAM STORAGE SPACE
Meaning: There are more records in the parameter file than the table
(defined in the program) can accommodate; therefore, the run
was terminated.
Action: Increase the size of the table in the program accordingly.
Refer to Appendix C for instructions on changing the size of
the table.
767
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 35
Release Date: 4/30/79
Update #: .24
ARPINVS 003 ABORT - LEVEL 77 DATA FIELD "NBR-OF-PARMS" INCREASED BEYOND
PARM-TABLE SIZE
Meaning: The 77-level data item "NBR-OF-PARMS" does not coincide with
the size of the parameter table defined in the program;
therefore, the run was terminated.
Action: Refer to Appendix C for instructions on changing the 77-level
data item.
ARPINVS 004 ABORT - LEVEL 77 DATA FIELD "NBR-OF-SITES" INCREASED BEYOND
SITE-TABLE SIZE
Meaning: The 77-level data item "NBR-OF-SITES" does not coincide with
the size of the site code table defined in the program;
therefore, the run was terminated.
Action: Refer to Appendix C for instructions on changing the 77-level
data item.
-ARPMSST-
ARPMSST 001 ABORT - SITE TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II site file exceeds the
limit imposed by the site table in the program; therefore, the
run was terminated.
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
ARPMSST 002 ABORT - PARM TABLE OVERFLOW
Meaning: The number of records in the AQDHS-II parameter file exceeds
the limit imposed by the parameter table in the program;
therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
768
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 36
Release Date: 4/30/79
Update #: 24
ARPMSST 003 ABORT - STATISTICS FILE EMPTY
Meaning: There are no records in the input statistics file; therefore,
no report can be generated.
Action: The problem probably lies with the master or answer file that
was input to ASTPRLM (AQ0190). If this file contains no data,
a valid master or answer file must be chosen and the four
programs - ASRMSTR (AQ0140), ASTPRLM (AQ0190), ASTMSST
(AQ0200), and ARPMSST (AQ0270) - rerun.
ARPMSST 004 WARNING - OPTION CARD MISSING: DEFAULT VALUES ARE 64 LINES PER
PAGE AND FULL SITE BREAK
Meaning: Because no option card was present in the job stream, the
default options were used to generate the statistics report.
Action: None, if the user is satisfied with the format of the report.
ARPMSST 005 WARNING - COLUMN 1 - INVALID OR MISSING SITE BREAK OPTION - FULL
BREAK OPTION USED
Meaning: The page-break field on the option card either was left blank
or contained a character string other than BRIEF or FULL. The
report was generated using the FULL option.
Action: If the BRIEF option is desired, correct the option card and
rerun the statistical analysis job stream.
ARPMSST 006 WARNING - COLUMN 7 - INVALID OR MISSING LINE MAXIMUM OPTION - 64
LINES PER PAGE USED
Meaning: The line-maximum field on the option card was either left blank
or contained non-numeric characters. The report was generated
with a maximum of 64 lines per page.
Action: If a line maximum other than 64 is desired, correct the option
card by inserting the desired maximum value in columns seven
and eight and rerun the statistical analysis job stream.
769
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 37
Release Date: 4/30/79
Update #: 24
ARPMSST 007 ABORT - LEVEL 77 DATA FIELD "SITE-MAX" INCREASED BEYOND SITE-TABLE
SIZE
Meaning: A user modification was made to ARPMSST (AQ0270) to change the
capacity of the site table. However, only one of the two
required line changes was made. Therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
ARPMSST 008 ABORT - LEVEL 77 DATA FIELD "PARM-MAX" INCREASED BEYOND PARM-TABLE
SIZE
Meaning: A user modification was made to ARPMSST (AQ0270) to change
the capacity of the parameter table. However, only one of the
two required line changes was made. Therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the table size;
then rerun the statistical analysis job stream.
-ARPMSTR-
ARPMSTR 001 ABORT - ANSWER FILE CONTAINS NO DATA
Meaning: There were no records in the input AQDHS-II master (or answer)
file. It is possible that the retrieval request was overly
restrictive and no records qualified. Another possibility is
that the wrong file name was used in the JCL. In either case,
the run was terminated and no report was produced.
Action: Examine the file names in the JCL and any retrieval specifica-
tions used; correct as necessary and resubmit the job.
770
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 38
Release Date: 4/30/79
Update #: 24
ARPMSTR 002 ABORT - IDENTIFIER NOT RECOGNIZED
Meaning: The correct options were not used on the option card; the
valid identifiers are DISPLAY, MEAN, and SUM. The run was
terminated and no report was produced.
Action: Correct the option card and resubmit the job.
ARPMSTR 003 CONDITIONAL - OPTION CARD MISSING FOR STD ANSWER FILE - ASSUME
MEAN REPORT
Meaning: No option card defining the summary type was specified. The
default of MEAN was used for the report.
Action: No action is necessary, unless the SUM option is desired. If
so, enter SUM on the option card and resubmit the job.
ARPMSTR 004 ABORT - SYNTAX REQUIRES RELATIONAL OP (<,=,>)
Meaning: The relational operator for the display statement is missing,
improperly coded, or out of sequence on the option card. The
run was terminated and no report was produced.
Action: Check the display statement for correct format and syntax.
Correct the error and resubmit the job.
ARPMSTR 005 ABORT - INVALID USE OF DISPLAY STMT WITH NULL READING
Meaning: The display statement logic would have caused all valid
readings to be suppressed. (An example of an invalid statement
is DISPLAY N < 9999.) The run was terminated and no report was
produced.
Action: Correct the display statement and resubmit the job.
ARPMSTR 006 ABORT - PARM TABLE OVERFLOW CONSULT USER GUIDE FOR CORRECTIVE
ACTION
Meaning: The number of records in the input parameter file exceeds the
limit of 200 imposed by the parameter table size in the
771
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 39
Release Date: 4/30/79
Update #: 24
program. Therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the allowed table
size.
ARPMSTR 007 ABORT - SYNTAX REQUIRES NEGATIVE SYMBOL (N) OR RELATIONAL OP
«,=,>)
Meaning: Something other than the negation operator (N) or the rela-
tional operator (<,=,>) precedes the specified numeric value in
the display statement. Therefore, the run was terminated.
Action: Check the display statement for correct format and syntax.
Correct the error and resubmit the job.
ARPMSTR 008 ABORT - SYNTAX ERROR ON OPTION CARD
Meaning: The option card contains one or more invalid words; the only
valid words are DISPLAY, SUM, and MEAN. Therefore, the run was
terminated.
Action: Correct the option card and resubmit the job.
ARPMSTR 009 ABORT - DISPLAY STMT PARAMETER NOT NUMERIC
Meaning: The threshold value used in the display statement on the option
card is not a number in the range of -999 to 9997; therefore,
the run was terminated.
Action: Correct the display threshold value and resubmit the job.
ARPMSTR 010 ABORT - MEAN STMT MAY NOT BE USED WITH SLIDING AVG INPUT
Meaning: The summary option is not allowed for a sliding average report;
therefore, the run was terminated and no report was produced.
Action: Delete MEAN from the option card or if a sliding average file
was not the expected input, check the JCL to insure that the
specified master file name is correct. Resubmit the job.
772
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 40
Release Date: 4/30/79
Update #: .24
ARPMSTR Oil ABORT - SUM STMT MAY NOT BE USED WITH SLIDING AVG INPUT
Meaning: The summary option is not allowed for a sliding average report;
substituted; however, the output report is useable.
Action: Save the input files, the run stream, the compile of ARPMSTR,
and the output and contact the National Air Data Branch for
assistance.
ARPMSTR 013 ABORT - OUTPUT FILE CONTAINS NO DATA
Meaning: The input file contained no records and no report was printed.
One possible cause could be that the name of the master file in
the JCL is incorrect. Another possible cause is that, if the
report follows a retrieval, the retrieval specifications were
too restrictive and no records were selected.
Action: Verify that the JCL names and/or the retrieval specifications
are correct; if errors are found, correct them and resubmit the
job.
ARPMSTR 014 ABORT - SITE TABLE OVERFLOW CONSULT USER GUIDE FOR CORRECTIVE
ACTION
Meaning: The number of records in the input site file exceeds the limit
of 200 imposed by the site table in the program. Therefore,
the run was terminated.
Action: See Appendix C for instructions on increasing the allowed table
size.
ARPMSTR 015 ABORT - STANDARDS TABLE OVERFLOW CONSULT USER GUIDE FOR CORRECTIVE
ACTION
Meaning: The number of records in the input standards file exceeds the
limit of 200 imposed by the parameter standards table in the
program. Therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the allowed table
size.
773
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 41
Release Date: 4/30/79
Update #: 24
ARPMSTR 016 ABORT - MEAN AND SUM ARE MUTUALLY EXCLUSIVE OPTIONS
Meaning: Both MEAN and SUM are values for the summary option and both
cannot be selected for a given run; therefore, the run was
terminated.
Action: Select the option desired, delete the other word from the
option card, and resubmit the job.
ARPMSTR 017 ABORT - LEVEL 77 DATA FIELD "NBR OF PARMS" INCREASED BEYOND PARM-
TABLE SIZE
Meaning: ARPMSTR (AQ0230) has been incorrectly modified to increase the
parameter table; therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
ARPMSTR 018 ABORT - LEVEL 77 DATA FIELD "NBR-OF-SITES" INCREASED BEYOND SITE-
TABLE SIZE
Meaning: ARPMSTR (AQ0230) has been incorrectly modified to increase the
parameter table; therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
ARPMSTR 019 ABORT - LEVEL 77 DATA FIELD "NBR-OF-STANDARDS" INCREASED BEYOND
STANDARD-TABLE SIZE
Meaning: ARPMSTR (AQ0230) has been incorrectly modified to increase the
parameter standards table; therefore, the run was terminated.
Action: See Appendix C for instructions on correctly increasing the
allowed table size.
774
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 42
Release Date: 4/30/79
Update #: .24
-ARPPMEX-
ARPPMEX 001 ABORT - LEVEL 77 DATA FIELD "NBR-OF-PARMS" INCREASED BEYOND
PARAMETER-TABLE SIZE
Meaning: The level 77 data field 'NBR-OF-PARMS' has been increased
without increasing the size of the parameter table.
Action: See Appendix C for instructions on correctly increasing the
size of the parameter table.
ARPPMEX 002 ABORT - PARMAMETER-TABLE AREA OVERFLOW
Meaning: Either the number of parameter file records exceeds the
program's storage space as defined in the parameter table, or
the size of the parameter table has been increased without
increasing the value of the level 77 data field 'NBR-OF-PARMS'.
Action: See Appendix C for instructions on correctly making the
necessary changes.
ARPPMEX 003 ABORT - EXCEPTION-PARAMETER-TABLE AREA OVERFLOW
Meaning: Either the number of new parameter, method, and unit code
combinations exceeds the program's storage space as defined in
the exception parameter table, or the size of the exception
parameter table has been increased without increasing the
value of the level 77 data field 'NBR-OF-EXCP'.
Action: See Appendix C for instructions on correctly making the
necessary changes.
ARPPMEX 004 ABORT - LEVEL 77 DATA FIELD "NBR-OF-EXCP" INCREASED BEYOND
EXCEPTION-PARAMETER-TABLE SIZE
Meaning: The level 77 data field 'NBR-OF-EXCP' has been increased
without increasing the size of the exception parameter table.
Action: See Appendix C for instructions on correctly increasing the
size of the exception parameter table.
775
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 43
Release Date: 4/30/79
Update #: 24
-ARPSMEX-
ARPSMEX 001 CONDITIONAL - INVALID OPTION CARD - DEFAULT OPTION (62 LINES PER
PAGE) ASSUMED^
Meaning: Either a non-numeric character or an integer less than 20 was
specified in columns one through two of the option card.
The default of 62 lines per page was assumed.
Action: None.
ARPSMEX 002 ABORT - EMPTY SITE FILE
Meaning: The input site file contains no records; therefore, the run was
terminated.
Action: Specify a valid site file and resubmit the run.
ARPSMEX 003 ABORT - SITE FILE OVERFLOW
Meaning: The site file contains more records than the maximum allowed
by the program; therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the size allowed
for the site file.
ARPSMEX 004 ABORT - EMPTY MASTER FILE
Meaning: The input master file contains no records; therefore, the run
was terminated.
Action: Specify a valid master file and resubmit the run.
ARPSMEX 005 ABORT - 'MISSING-SITE1 TABLE OVERFLOW
Meaning: The number of missing sites exceeds the maximum allowed by the
program; therefore, the run was terminated.
Action: See Appendix C for instructions on increasing the size allowed
for the site file.
776
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 44
Release Date: 4/30/79
Update #: 24
ARPSMEX 006 ABORT - LEVEL 77 DATA FIELD 'NBR-OF-SITES1 INCREASED BEYOND
SITE-TABLE SIZE
Meaning: The limit for the number of records in the site file has been
increased, but the working-storage allocation for the site
table has not been increased correspondingly. Therefore, the
run was terminated.
Action: See Appendix C for instructions on increasing the size of the
site table.
ARPSMEX 007 ABORT - LEVEL 77 DATA FIELD 'MISSING-SITE-MAX' INCREASED BEYOND
MISSING-SITE-TABLE SIZE
Meaning: The limit for the number of missing sites has been increased,
but the working-storage allocation for the missing-site table
has not been increased correspondingly. Therefore, the run was
terminated.
Action: See Appendix C for instructions on increasing the size of the
missing-site table.
-ARTGENR-
ARTGENR 001 ABORT - MASTER FILE CONTAINS NO RECORDS
Meaning: The input master file as specified in the user-supplied JCL
contains no records; therefore, the run was terminated.
Action: Correct the file name and resubmit the job.
ARTGENR 002 CONDITIONAL - ANSWER FILE CONTAINS NO RECORDS
Meaning: No records were found fitting the criteria specified in the
retrieval statements.
Action: Check the retrieval statements for accuracy if some records
should have been retrieved. Correct any errors and resubmit the
job.
777
-------
AQDHS-II
APPENDIX B
ERROR MESSAGES
Page 45
Release Date: 4/30/79
Update #: 24
-ARTLNGP --
ARTLNGP 001 CONDITIONAL - $$END CARD MISSING
Meaning: The last card for the retrieval specifications must be a $$END.
If this card is missing, the error message will be printed,
but program execution will continue.
Action: No action required unless other errors have been detected.
ARTLNGP 002 ABORT - FIRST CONTROL CARD NOT $$SELECT
Meaning: The first control card for specifying a retrieval must be a
$$SELECT card. If this card is not present, the run is
aborted.
Action: Include the $$SELECT card and resubmit the job.
ARTLNGP 003 ABORT - DATA NAME INVALID 'identifier1
Meaning: Subject and object names (identifiers) must be spelled exactly,
including the hyphen, as spelled in the valid retrieval data
names, Figure 5.2.2-c. The program execution was prematurely
terminated.
Action: Correct the subject or object name (indicated by the identifier
in the error message) and resubmit the job.
ARTLNGP 004 ABORT - NO CONTROL CARDS IN INPUT STREAM
Meaning: There must be at least a $$SELECT and a $$END card in the
input run stream. The run was aborted.
Action: Include control cards as shown in 5.2.2.5.4 and resubmit the
job.
ARTLNGP 005 ABORT - INVALID NEGATION CHARACTER
Meaning: The character N should be used as the negation flag; otherwise,
the negation flag field should be blank. The run was aborted.
Action: Correct the error and resubmit the job.
778
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 4
Release Date: 10/31/81
Update #: 29
Table E-l - continued. Cross-Reference of Files and Programs
File
Permanent Files
Parameter File (continued)
Parameter Standards File
Site File
Sorted Site File
Programs Which
Process
the File
AEMPARM (AQ0070)
ARPINVP (AQ0290)
ARPINVS (AQ0280)
ARPMSST (AQ0270)
ARPMSTR (AQ0230)
ARPPARM (AQ0240)
ARPPMEX (AQ0330)
ARPSLAM (AQ0390)
ARPSTDS (AQ0420)
ARPVSTD (AQ0350)
ARTSLAM (AQ0375)
ARTSTDS (AQ0400)
ASTPRLM (AQ0190)
AEMSTND (AQ0090)
ARPMSTR (AQ0230)
ARPSTND (AQ0250)
ARPVSTD (AQ0350)
AEDMSTR (AQ0060)
AEMSITE (AQ0080)
ARPINVP (AQ0290)
ARPINVS (AQ0280)
ARPSITE (AQ0260)
ARPSMEX (AQ0340)
ASRSTFL (AQ0360)
ARPMSST (AQ0270)
ARPMSTR (AQ0230)
ARPVSTD (AQ0350)
Usage
Input/Output
Input/Output
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input/Output
Input
Input
Input
Input
Input/Output
Input
Input
Input
Input
Input
Input
Input
Input
(Page 2 of 6)
778
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 5 r ' • '•• .
Release Date: 10/31/81
Update #: 29
Table E-l - Continued. Cross-Reference of Files and Programs
File
Sorted Site File (continued)
FORTRAN-Compatible Files
FORTRAN-Compatible Master File .
FORTRAN-Compatible Parameter File
Tape Report Files
SAROAD Transaction Format
Add File
SAROAD Transaction Format
Change File
SLAMS Transaction File
Temporary Files
Answer File
File of Data to be Screened for Anomalies
Generated Retrieval Program Source Module
Master File Internal Transactions
Preliminary Statistics File
Programs Which
Process
the File
ARTSLAM (AQ0375)
ARTSTDS (AQ0400)
ASRSTFL (AQ0360)
-
ACVMFOR (AQ0020)
ACVPFOR (AQ0030)
ARPSARD (AQ0220)
ARPSARD (AQ0220)
ARPSLAM (AQ0390)
ACVUNIT (AQ0050)
ARTGENR (AQ0120)
ACVANOM (AQ0040)
ARPANOM (AQ0320)
ARTLNGP (AQ0110)
AEDMSTR (AQ0060)
ASRINTR (AQ0130)
ASTMSST (AQ0200)
ASTPRLM (AQ0190)
Usage
Input/Output
Input
Input
Output
Output
Output .
Output
Output
Output
Output
Output
Output
Input
Output
Output
Input
. Input
Output
*An answer file may be used instead of the master file in any program that
uses the master file as input.
(Page 3 of 6)
779
-------
AQDHS-II
APPENDIX E
Table E-l - Continued
File
Raw Data File
SLAMS Data File
SLAMS Site Data File
SLAMS Statistics File
Sliding Average Answer File
Sliding Average Values File
Sort Work Files
FILE SPECIFICATIONS Page 6
Release
Update #
Date: 10/31/81
: 29
. Cross-Reference of Files and Programs
Programs Which
Process
the File
ASTMSST (AQ0200)
ASTPRLM (AQ0190)
ARTSLAM (AQ0375)
ASTSLAM (AQ0380)
ARPSLAM (AQ0390)
ARTSLAM (AQ0375)
ARPSLAM (AQ0390)
ASTSLAM (AQ0380)
ARTGENR (AQ0120)
ASTSLAV (AQ0180)
ARPMSTR (AQ0230)
ASTSLAV (AQ0180)
ARPVSTD (AQ0350)
ARTSLAM (AQ0375)
ARTSTDS (AQ0400)
ASRINTR (AQ0130)
ASRMSTR (AQ0140)
ASRPARM (AQ0150)
ASRSITE (AQ0160)
ASRSTFL (AQ0360)
ASRSTND (AQ0170)
ASRTRAN (AQ0370)
Sorted Master File Transactions AEDMSTR (AQ0060)
Sorted Master File Internal
Transactions
ASRTRAN (AQ0370)
AFMMSTR (AQ0100)
ASRINTR (AQ0130)
Usage
Input/Output
Input
Output
Output
Input
Input
Output
Input
Output
Output
Input
Input
Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input
Output
Input
Output
780
(Page 4 of 6)
-------
AQDHS-II
APPENDIX E
Table E-l - Continued.
File
FILE SPECIFICATIONS Page 7
Release
Update #
j
Date: 10/31/81
: 29
Cross-Reference of Files and Programs
Programs Which
Process
the File
Sorted Parameter File Transactions AEMPARM (AQ0070)
Sorted Parameter Standards Fi
Transactions
ASRPARM (AQ0150)
le AEMSTND (AQ0090)
ASRSTND (AQ0170)
Sorted Site File Transactions AEMSITE (AQ0080)
Standards Data File
Standards Site Data File
Standards Statistics File
Statistics File
Unit Record Files
Master File Transactions
Parameter File Transactions
ASRSITE (AQ0160)
ARTSTDS (AQ0400)
ASTSTDS (AQ0410)
ARTSTDS (AQ0400)
ARPSTDS (AQ0420)
ASTSTDS (AQ0410)
ARPSTDS (AQ0420)
ARPMSST (AQ0270)
ASTMSST (AQ0200)
ACVSARD (AQ0010)
ASRTRAN (AQ0370)
ASRPARM (AQ0150)
Parameter Standards File Transactions ASRSTND (AQ0170)
SARQAD Transactions
Site File Transactions
ACVSARD (AQ0010)
ASRSITE (AQ0160)
Skeleton Master File Transactions ARPANOM (AQ0320)
Skeleton Parameter File Transactions ARPPMEX (AQ0330)
Skeleton Site File Transactions ARPSMEX (AQ0340)
Retrieval Specifications
ARTLNGP (.AQ0110)
Usage
Input/Output
Input
Output
Input
Output
Input
Output
Output
Input
Output
Input
Output
Input
Input
Output
Output
Input
Input
Input
Input
Input
Output
Output
Output
Input
(Page 5 of 6)
781
-------
AQDHS-II
APPENDIX E
Table E-l - Continued
File
Option Card Files
Print Files
Library Files
Program Source Library
FILE SPECIFICATIONS
Page 8
Release Date: 10/31/81
Update #: 29
. Cross-Reference of Files and Programs
Programs Which
Process
the File
ACVANOM (AQ0040)
ACVSARD (AQ0010)
ACVUNIT (AQ0050)
AEDMSTR (AQ0060)
AEMPARM (AQ0070)
AEMSITE (AQ0080)
AEMSTND (AQ0090)
AFMMSTR (AQ0100)
AMSARCH (AQ0215)
ARPDUMP (AQ0310)
ARPMSST (AQ0270)
ARPMSTR (AQ0230)
ARPSARD (AQ0220)
ARPSITE (AQ0260)
ARPSLAM (AQ0390)
ARPSMEX (AQ0340)
ARPSTDS (AQ0420)
ARPVSTD (AQ0350)
ARTSLAM (AQ0375)
ARTSTDS (AQ0400)
ASRMSTR (AQ0140)
ASTPRLM (AQ0190)
ASTSLAV (AQ0180)
All Programs
ARTLNGP (AQ0110)
Usage
Input/Output
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
Output
Input
(Page 6 of 6)
782
-------
00
I VI U 1 \_ L_ i_ VVSIIUI(IU^_U» LS 1 \SVtf l> 111^ IUV*\*\S'*»J V/l 1 IV^tO 1 1 »_/ A A 1 II^.*J
Recommended Records per
File
File
Sorted Parameter File
Transactions
Sorted Parameter Standards
File Transactions
Statistics File
Sorted Site File
Transactions
Standards Data File
Standards Site Data File
Standards Statistics File
Library Files
Program Source Library
Program Load Library
Procedure Library
* Blocking factors used by
Characters
per Record
80
80
100
80
120
227
120
80
N/A
80
AQDHS-II as
Block for
IBM 3330
Disk
(13,030
characters
per track)
18
18
13
18
54
28
54
42
N/A
100
released by
Files on Disk
IBM 2314
Disk
(7,294
characters
per track)
13
13
18
13
30
16
30
42
N/A
100
NADB
Recommended
Records per
Records per
Block used
Block for
Locally
Files on
Magnetic
Tape
25
25
25
25
54
28
54
50
N/A
100
(Page 4 of 4)
~O -O
~O r***3
m— f
j_
o i
X I-H
m
i —
1 i 1
CO
-o
m
o
•n
o
—i
o
cr TO -o
T3 0> O>
O. ~~* CO
c+ a>
1— •
n> co
=*te
O
OJ
r+
TO n> „' .
i— »
o
CO
I—"
oo
I—"
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 14
Release Date: 5/01/80
Update #: 27
RECORD CONTAINS clause. When changing the blocking factor for unit
record files, this comment line should be replaced by the RECORD
CONTAINS clause (to maintain the line number integrity of the source
module).
2) Compile and link edit each COBOL program that is modified.
3) Modify the cataloged procedure that executes any FORTRAN program that
uses the file. (See Table E-l.) The DCB parameters for
the affected file should be changed to reflect the new blocking
factor. Note: The AQDHS-II programs coded in FORTRAN are ARPANOM
(AQ0320) and ASTMSST (AQ0200); they are executed by procedures
AQRPM45 and AQRPM10, respectively.
4) If the above actions are taken to change the blocking factor of a
file prior to the creation of any copies of the file, no further
action is necessary; the file will be created with the blocking
factors that have been specified. However, if there are existing
copies of the file, they must be reblocked before they can be used.
This reblocking can be accomplished by IBM users with the utility
IEBGENER. An example of a run stream to reblock a disk file is shown
in Figure E-l.
To change the blocking factor of the program source module library, the
user must modify program ARTLNGP (AQ0110) as discussed in step 1 above,
compile and link edit ARTLNGP (AQ0110), and reblock the program source module
library (see Figure E-2). IBM users should not reblock the program load
module library or procedure library.
788
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 2
Release Date: 4/30/79
Update #: 24
C.I INTRODUCTION
Many of the AQDHS-II programs utilize auxiliary files (e.g., parameter,
site, and parameter standards files) by reading the records from the files and
storing them in tables. The size of a table is determined by the numeric
value assigned to appropriate data items in the program: a 77-level entry and
one or two record-level entries. As released by EPA-NADB, these data items
are set at 200; i.e., the program can process an auxiliary file containing 200
or less records.
If a user has an auxiliary file which has more than 200 records, he must
modify all programs which store that file in a table; i.e., he must increase
the numeric value of the appropriate data items in the programs. This
appendix provides precise instructions for making the correct changes. These
instructions should be followed exactly. If a program is incorrectly
modified, it will abort and an AQDHS-II error message will be printed to
indicate the faulty modification.
789
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 3
Release Date: 4/30/79
Update #: 24
C.2 SPECIAL INSTRUCTIONS
When any modification has been made to any program, the modified program must
be compiled and link edited successfully before use. This step is mandatory.
The region size allocated for executing a program may be affected when the
size of a table in that program has been increased. The region size is a
substitutable parameter in most of the cataloged procedures, and is,
therefore, easily changed.
The size of a table in a program for a particular auxiliary file should
coincide with the size of all other tables for that file in all other
programs. Therefore, when changing the size of a table in one program, the
user should change the size of the analogous tables in other programs
accordingly.
In the following examples, all tables are modified to accommodate 300 records.
The user may, of course, choose a value other than 300 to satisfy his own
requirements.
790
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 4
Release Date: 4/30/79
Update #: 24
C.3 CHANGING THE SITE TABLE SIZE
Whenever it is necessary to change the size (number of entries) of the site
table, all programs listed in this section must be modified accordingly. The
user must complete all changes listed for a given program unless otherwise
specified. The user should also refer to the special instructions
at the beginning of this Appendix when modifying programs.
791
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 5
Release Date: 4/30/79
Update #: .24
AEDMSTR (AQ0060) - MASTER FILE TRANSACTION EDIT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00038600) from:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OR-SITES PIC 999 COMP SYNC VALUE 300.
2. Change the OCCURS clause of the following program statement (on or about
sequence number 00145900) from:
03 SITE-CODE-TABLE OCCURS 200 TIMES.
to:
03 SITE-CODE-TABLE OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
792
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 6
Release Date: 4/30/79
Update #: 24
AEMSITE (AQ0080) - SITE FILE MAINTENANCE PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00012900) from:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 300.
If the number of output site file records exceeds the value of this data
item, a warning message will be generated. After receiving this warning
message, the user should make the necessary changes to other programs that
access the AQDHS-II site file.
793
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 7
Release Date: 4/30/79
Update #: 24
ARPINVP (AQ0290) - INVENTORY BY POLLUTANT REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00012300) from:
77 SITE-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 SITE-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00017900) from:
02 SITE-BLOCK PIC X(9200) VALUE SPACES.
to:
02 SITE-BLOCK PIC X(13800) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
46 characters).
The numeric value specified in this PIC clause must be 46 times the
numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00018000) from:
02 SITE-RECORD REDEFINES SITE-BLOCK OCCURS 200 TIMES.
to:
02 SITE-RECORD REDEFINES SITE-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
794
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 8
Release Date: 4/30/79
Update #: 24
ARPINVS (AQ0280) - INVENTORY BY SITE REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00013400) from:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00037800) from:
02 SITE-BLOCK PIC X(9800) VALUE SPACES.
to:
02 SITE-BLOCK PIC X(14700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
49 characters). The numeric value specified for this PIC clause must be
49 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00037900) from:
02 SITE-CODE-TABLE REDEFINES SITE-BLOCK OCCURS 200 TIMES.
to:
02 SITE-CODE-TABLE REDEFINES SITE-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
795
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 9
Release Date: 4/30/79
Update #: 24
ARPMSST (AQ0270) - STATISTICAL REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00019300) from:
77 SITE-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 SITE-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00047200) from:
02 SITE-BLOCK PIC X(14400) VALUE SPACES.
to:
02 SITE-BLOCK PIC X(21600) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
72 characters). The numeric value specified for this PIC clause must be
72 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00047300) from:
02 SITE-RECORD REDEFINES SITE-BLOCK OCCURS 200 TIMES.
to:
02 SITE-RECORD REDEFINES SITE-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
796
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 10
Release Date: 4/30/79
Update »; • 24
ARPMSTR (AQ0230) - MASTER FILE DETAILED REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00035800) from:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00154600) from:
02 SITE-BLOCK PIC X(16000) VALUE SPACES.
to:
02 SITE-BLOCK PIC X(24000) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
80 characters). The numeric value specified for the PIC clause must be
80 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00154700) from:
02 SITE-CODE-TABLE REDEFINES SITE-BLOCK OCCURS 200 TIMES.
to:
02 SITE-CODE-TABLE REDEFINES SITE-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
797
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 11
Release Date: 4/30/79
Update #: 24
ARPSMEX (AQ0340) - SITE EXCEPTION REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00011900) from:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-SITES PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00017100) from:
02 SITE-BLOCK PIC X(2400) VALUE SPACES.
to:
02 SITE-BLOCK PIC X(3600) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
12 characters). The numeric value specified for this PIC clause must
be 12 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00017200) from:
02 SITE-CODE-KEY REDEFINES SITE-BLOCK OCCURS 200 TIMES.
to:
02 SITE-CODE-KEY REDEFINES SITE-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
798
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 12
Release Date: 4/30/79
Update #: 24
ARPSMEX (AQ0340) also contains a table for site codes that appear on the
AQDHS-II master file but not on the AQDHS-II site file. It is not mandatory
to change the size of this table when changing the size of the AQDHS-II site
file table. However, the procedure is as follows:
1. Change the VALUE clause of the following program statement (on or
about sequence number 00012000) from:
77 MISSING-SITE-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 MISSING-SITE-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00017600) from:
02 MISSING-BLOCK PIC X(16000) VALUE SPACES.
to:
02 MISSING-BLOCK PIC X(24000) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
80 characters). The numeric value specified for this PIC clause must be
80 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statements (on or about
sequence numbers 00017700-00017800) from:
02 MISSING-ENTRIES REDEFINES MISSING-BLOCK
OCCURS 200 TIMES.
to:
02 MISSING-ENTRIES REDEFINES MISSING-BLOCK
OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
799
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 13
Release Date: 4/30/79
Update #: 24
C.4 CHANGING THE PARAMETER TABLE SIZE
Whenever 1t 1s necessary to change the size (number of entries) of the
parameter table, all programs listed 1n this section must be modified
accordingly. The user must complete all changes listed for a given program
unless otherwise specified. The user should also refer to the special
Instructions at the beginning of this Appendix when modifying programs.
800
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 14
Release Date: 4/30/79
Update #: 24
ACVUNIT (AQ0050) - UNITS CODE CONVERSION PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00012600) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00021300) from:
02 PARM-BLOCK PIC X(6400) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(9600) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
32 characters). The numeric value specified for this PIC clause must be
32 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00021400) from:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 200 TIMES.
to:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
801
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 15
Release Date: 4/30/79
Update #: .24
ACVUNIT (AQ0050) also contains a table for parameter codes that appear on the
AQDHS-II master file but not on the AQDHS-II parameter file. It is not
mandatory to change the size of this table when changing the size of the
AQDHS-II parameter file table. However, the procedure for changing it is as
follows:
1. Change the VALUE clause of the following program statement (on or about
sequence number 00014800) from:
77 TABLE-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 TABLE-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00023000) from:
02 BAD-PARM-BLOCK PIC X(2000) VALUE SPACES.
to:
02 BAD-PARM-BLOCK PIC X(3000) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
10 characters). The numeric value specified for this PIC clause must be
10 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statements (on or about
sequence numbers 00023100-00023200) from:
02 BAD-PARM-TABLE REDEFINES BAD-PARM-BLOCK
OCCURS 200 TIMES.
02 BAD-PARM-TABLE REDEFINES BAD-PARM-BLOCK
OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
802
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 16
Release Date: 4/30/79
Update #: 24
AEDMSTR (AQ0060) - MASTER FILE TRANSACTION EDIT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00038500) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
This will Increase the limit of table entries to 300.
2. Change the OCCURS clause of the following program statement (on or about
sequence number 00144300) from:
03 PARM-CODE-KEY-TABLE OCCURS 200 TIMES.
to:
03 PARM-CODE-KEY-TABLE OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause 1n Step 1.
803
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 17
Release Date: 4/30/79
Update #: 24
AEMPARM (AQ0070) - PARAMETER FILE MAINTENANCE PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00016400) from:
77 BINARY-200 PIC 999 COMP SYNC VALUE 200.
to:
77 BINARY-300 PIC 999 COMP SYNC VALUE 300.
If the number of output parameter file records exceeds the value of this
data item, a warning message will be generated. After receiving this
warning message, the user should make the necessary changes to other
programs that access the AQDHS-II parameter file.
804
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 18
Release Date: 4/30/79
Update #: .24
ARPINVP (AQ0290) - INVENTORY BY POLLUTANT REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00012200) from:
77 POLL-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 POLL-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00017200) from:
02 POLL-BLOCK PIC X(7400) VALUE SPACES.
to:
02 POLL-BLOCK PIC X(lllOO) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
37 characters). The numeric specified for this PIC clause must be 37
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00017300) from:
02 POLL-RECORD REDEFINES POLL-BLOCK OCCURS 200 TIMES.
to:
02 POLL-RECORD REDEFINES POLL-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
805
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 19
Release Date: 4/30/79
Update #: 24
ARPINVS (AQ0280) - INVENTORY BY SITE REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00013500) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00037000) from:
02 PARM-BLOCK PIC X(7800) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(11700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
39 characters). The numeric value specified for this PIC clause must
be 39 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00037100) from:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 200 TIMES.
to:
02 PARM-TABLE REDEFINES PARM-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same
as that specified for the VALUE clause in Step 1.
806
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 20
Release Date: 4/30/79
Update #: 24
ARPMSST (AQ0270) - STATISTICAL REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00019400) from:
77 PARM-MAX PIC 999 COMP SYNC VALUE 200.
to:
77 PARM-MAX PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00048100) from:
02 PARM-BLOCK PIC X(23800) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(35700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
119 characters). The numeric value specified for this PIC clause must be
119 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00048200) from:
02 PARM-RECORD REDEFINES PARM-BLOCK OCCURS 200 TIMES.
to:
02 PARM-RECORD REDEFINES PARM-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
807
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 21
Release Date: 4/30/79
Update #: 24
ARPMSTR (AQ0230) - MASTER FILE DETAILED REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00035700) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00126900) from:
02 PARM-BLOCK PIC X(24800) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(37200) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
124 characters). The numeric value specified for this PIC clause must be
124 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00127000) from:
02 PARM-CODE-TABLE REDEFINES PARM-BLOCK OCCURS 200 TIMES.
to:
02 PARM-CODE-TABLE REDEFINES PARM-BLOCK OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
808
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 22
Release Date: 4/30/79
Update #: 24
ARPPMEX (AQ0330) - PARAMETER EXCEPTION REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00013500) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00025700) from:
02 PARM-BLOCK PIC X(1800) VALUE SPACES.
to:
02 PARM-BLOCK PIC X(2700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
9 characters). The numeric value specified for this PIC clause must be 9
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00025900) from:
03 PARM-CODE-ENTRY OCCURS 200 TIMES.
to:
03 PARM-CODE-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
809
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 23
Release Date: 4/30/79
Update #: .24
ARPPMEX (AQ0330) also contains a table for parameter codes that appear on the
AQDHS-II master file but not on the AQDHS-II parameter file. It is not
mandatory to change the size of this table when changing the size of the
AQDHS-II parameter file table. However, the procedure for changing it
is as follows:
1. Change the VALUE clause of the following program statement (on or about
sequence number 00013400) from:
77 NBR-OF-EXCP PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-EXCP PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00026900) from:
02 NEW-BLOCK PIC X(1800) VALUE SPACES.
to:
02 NEW-BLOCK PIC X(2700) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
9 characters). The numeric value specified for this PIC clause must be 9
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00027100) from:
03 NEW-ENTRY OCCURS 200 TIMES.
to:
03 NEW-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
810
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 24
Release Date: 4/30/79
Update #: .24
ASTPRLM (AQ0190) - PRELIMINARY STATISTICS PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00017500) from:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 200.
to:
77 NBR-OF-PARMS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statements (on or about
sequence numbers 00044900-00045000) from:
02 PARM-TABLE-ZEROED PIC X(3800)
VALUE LOW-VALUES.
to:
02 PARM-TABLE-ZEROED PIC X(5700)
VALUE LOW-VALUES.
This will allow the table to accommodate 300 records (each record contains
19 characters). The numeric value specified for this PIC clause must be 19
times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statement (on or about
sequence number 00045300) from:
03 PARM-TABLE-ENTRY OCCURS 200 TIMES.
to:
03 PARM-TABLE-ENTRY OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
811
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 25
Release Date: 4/30/79
Update #: 24
C.5 CHANGING THE PARAMETER STANDARDS TABLE SIZE
Whenever it is a necessary to change the size (number of entries) of the
parameter standards table, all programs listed in this section must be
modified accordingly. The user must complete all changes listed for a given
program unless otherwise specified. The user should also refer to the special
instructions at the beginning of this Appendix when modifying programs.
Note that 100, not 200, is the current limit for the number of entries in the
parameter standards tables.
812
-------
AQDHS-II
APPENDIX C
PROGRAM TABLE
MODIFICATION
Page 26
Release Date: 4/30/79
Update #: 24
ARPMSTR (AQ0230) - MASTER FILE DETAILED REPORT PROGRAM
1. Change the VALUE clause of the following program statement (on or about
sequence number 00035900) from:
77 NBR-OF-STANDARDS PIC 999 COMP SYNC VALUE 100.
to:
77 NBR-OF-STANDARDS PIC 999 COMP SYNC VALUE 300.
2. Change the PICTURE clause of the following program statement (on or about
sequence number 00156400) from:
02 STANDARDS-BLOCK PIC X(11200) VALUE SPACES.
to:
02 STANDARDS-BLOCK PIC X(33600) VALUE SPACES.
This will allow the table to accommodate 300 records (each record contains
112 characters). The numeric value specified for this PIC clause must be
112 times the numeric value specified for the VALUE clause in Step 1.
3. Change the OCCURS clause of the following program statements (on or about
sequence numbers 00156500-00156600) from:
02 STANDARDS-TABLE REDEFINES STANDARDS-BLOCK
OCCURS 100 TIMES.
to:
02 STANDARDS-TABLE REDEFINES STANDARDS-BLOCK
OCCURS 300 TIMES.
The numeric value specified for this OCCURS clause must be the same as
that specified for the VALUE clause in Step 1.
813
-------
AQDHS-II
APPENDIX D
SAMPLE LOAD SHEETS
Page 1
Release Date: 4/30/79
Update #: . 24
APPENDIX D - SAMPLE LOAD SHEETS
This appendix provides sample load sheets which can be reproduced by the
user to aid in the generation of transactions for the parameter file, site
file, parameter standards file, and master file. A sample load sheet is also
provided for retrieval language specifications.
814
-------
AGENCY
PARM METH UNIT, 0 DifrEClL
1
1
1
2
1 1 1 I
7
1
J
1
1 1
2
1 1 1
AIR QUALITY DATA HANDLING SUBS^
COMPREHENSIVE DATA HANDLING
PARAMETER TRANSACT
PARAMETER DESCRIPTION
16
1 1 I I I 1
. .
I I i I I i i I i i
PARM METH UNIT ANALYSIS DESCRIPTION
1
2
2
1 1 1 1
7
9
11
1 1 1
1 1 1 1 1
I I i I 1 1 1 1 I 1
45
1 1 1 1 1 1 1 1 1 1 1
UNITS DESCRIPTION
35 36
1 1 1 1 1 1 1 1 1 1
STD STANDARD UNITS USER USER UNITS
PARM METH UNIT UC CONVERSION FACTOR UC CONVERSION FACTOR
1
3
2
1 1 1 1
7
.
9 111
, ,
13
PARM METH UNIT o DETECT.
1
1 1 1 1
1
I
11
1 1
21
1 1 1 1 1
22
1
24 32
1 1 1 1 1 1 1 1 1
fSTFM (AQDHS II) RY .
SYSTEM (CDHS) nATP
IONS PAGE_ OF
COLLECTION METHOD ACTION
46 70 80
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
ACTION
65 66
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | | | 1 1 1
ACTION
BO
1 1 1 1 1 1 1 1 1 1 1
PARAMETER DESCRIPTION
16
1 1 1 1 1
PARM METH UNIT ANALYSIS DESCRIPTION
00
1— »
tn
1
2
2
1 1 1 1
7
.
9
.
I
1 1 1 1 1 1 1 1 1
11
.
PARM METH UNIT UC
3
1 1 1 1
PARM METH UNIT o
1
1
2
1 1 1 1
7
.
9
I
11
1 1 1
1 1 1 1 1 1
3 STANDARD UNITS I
CONVERSION FACTOR
MIN
DETECT
2
1 1 1
I I I I I I
L 1
SER
1ICC
1 1 1 1 1 1 1 1 1 1 1
USER UNITS
ONVERSION FACTOR
1 1 1 1 1 1 1 1 1
45
1 1 1 1 1
UNITS DESCRIPTION
35 36
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | 1 1 |
COLLECTION METHOD ACTION
46 70 90J
1 1 1 1 1 1 1 1 | 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
ACTION
65 m
iiiiiiiiiiiiiiiiiiii jiiiiij^iii^i iii i
ACT.ON
1
PARAMETER DESCRIPTION
16
I I I 1 I
1 1
1 1 1 1 1 1 1 1 1 1 1
PARM METH UNIT ANALYSIS DESCRIPTION
1
2
2
1 1 1 1
7
I
9
.
11
.
1 1 1
1 1 1 1 1 1
1 1
1 1 1 1 1 1 1 1 1 1
45
1 1 1 1 1 1 1 1 1 1 1
UNITS DESCRIPTION
35 36
1 1 1 1 1 1 1 1 1 1
COLLECTION METHOD ACTION
46 70 IBOJ
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | 1 1 1 1
ACTION
65 po|
STD STANDARD UNITS USER USER UNITS
PARM METH UNIT UC CONVERSION FACTOR UC CONVERSION FACTOR ACTION
1
3
2
1 1 1 1
7 19
, ,
11
I
13
I I
PARM METH UNIT 0 DETECT
1
2
9
2
1 1
' 2'
1 1 1 1 1 1
22
.
24 321
1,
1 1 1 1 1 1 1 1 1 1 1
PARAMETER DESCRIPTION
1 1 1 1 1
1
PARM METH UNIT ANALYSIS DESCRIPTION
2
1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1
3
' 1 ' 1
J_
2
. U
1 1 1
I ' ' ' ' '
(
' ' 1 1 ' 1 1 1 1 '
45
1 1 1 1 1 1 1 1 1 1
UNITS DFSCHlPTION
1 1 1 1 1 1 1 1 1 1
1 1 1 1 ' ' 1 1 1 1 1 '
|Boj
i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i 1 i i 1 1
COLLECTION METHOD ACTION
46 - 70 p
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 LL
ACTION
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 J 1 1 1 1 1 1 1 1 1 1 1 1 1 i
*£H°£
H
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1J 1 1 1 1 1 1 1 1
EPA (DUF0429
-------
AGEN
STATE
.
(
1
1
!
(
1
I
'
rY
AREA
CODE
1 1 1
1 1 1
111
1 l 1
III
'III
1 1 1
1 1 1
1 1 1
1 1 1
i
iJ
i i i
iT i
i i i
ii i
i i i
i i i
i i i
SITE
CODE
1 1
1 l
l i
1 1
1 1
1 1
1 1
1 1
II
1 1
1 1
i.
"
1 1
1 1
1 1
1 1
1 1
1 1
1 1
1 1
1 1
1 1
1
PROJECT
11
,
,"
1
(
I
"
1
,
,
1
,
1
I
.
:,
(
',
A OCR
CODE
3
f ,
1 1
1 1
'
1 1
1 1
1 1
1 1
t i "i .
i i
i i
, ,
i i
i i
! ,
1 1
1
1 1
COUNTY
CODE
6
1 1 1
1 1 1
1 1 1
III
1 1 1
1 II
1 1 1
1 1 1
1 1 1
1 1 1
'III
~i
1 11
III
III"
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
AIR QUALITY DATA HANOI ING SURSYSTFM(AonHS-ll) BY
COMPREHENSIVE DATA HANDLING SYSTEM (CDHS) HATE.
SITE TRANSACTIONS " PAGF • OF
5
I SITE DESCRIPTION
i •
>
21 a
,,-,,, i ,,,,,,, i ,,',,,,,,,,,,,;,,, , i i i i i i i i i i i i
, 1 1 , , 1 1 1 , 1 1 1 1 1 1 , 1 1 , 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
, ., i , i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i ii
i , i , , i i i i , ; i i i i , i i i i i t i i i i i i i i i i i i i i i i i i i
1 1 , , 1 , 1 , , 1 1 , , , 1 1 1 1 1 1 , , , 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 IT 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 I i 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 1 1 1
| 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ' 1 1 1 1 1 1 1 " 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 |- 1 1 1 '1 1
1 1 1 1 1 1 1 1 1 1 1 1- 1 1 1 1 1 1 1 t 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I T 1 1 1 1 1 i 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
i i "i i i i i i i i i i • i i i i i i i i i i i i l i i i i i i i i i i i i i i i i. i i i i i i i i i i i i i i i i i i
i i i i i i l i i i i i i i i i i i i i i i i i i i i i i i i i i i l i l i i l l i i i i i i i i i i i i i i i i i i
i i i i i i i i i l i i i i t i i i i i i i i i i i i i i i i i i i l i i i i i i i i i i i i i 1 i i i i i i i i i i
i i i i i i i i i l i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i
i i i i i i i i i i i t i i i i i i i i i i i i i i i i i i i i i i i i i i l i i i i l i i i i i i i i i i i i i i i
i i j i i i ii i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i
i i i i i i i i i i i i i i i i i i i i i i i i i V i i i i i i i i i i i i i i i i i i i i i i
i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i-V-i-i i i i i i ii i i ii ii i i i i i i i i i
i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i r i i i i i i i i i i i i i i i i i i i i i i
i i i i i i i i i i i i i i i i i i i i • i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i
i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i i
Ef "W)431
-------
iFwrv
PARAMETER
CODE
1 1 1 1
1 1 I 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
1 1 1 1
s
STD
NBR
1
.
.
.
1
,
.
1
.
.
1
.
I
.
1
.1
!
UNIT
CODE,
|
|
.
.
.
.
1
.
.
I
.
I
\
AIR QUALITY DATA HANDLING SUBSYSTEM (AQDHS-II) BY ... -
COMPREHENSIVE DATA HANDLING SYSTEM (CDHS) DATE
PARAMETER STANDARDS TRANSACTIONS PAGE — OF —
STANDARD DESCRIPTION
12 ' 61
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
, , 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
I I I I I I i I i r i I I I I I I I I I I I I I I I I I I I I I I I I I I I I i I I I I I I i I i
I I I I I I 1 I I I I I l I l I I I I I I I I l I I I I I I I I I I I I I i i i i i i i I i i i i
1 1 1 I 1 I 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I I I I I 1 I I i I I
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 l l 1 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 i
l l l i i i i i i i i i i i i i i t i i i i l 1 1 l 1 1 l l 1 1 1 1 1 1 1 l i l l l l l i l i i i
i l l l i i i l l l l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I l l l 1 l l i
1 l 1 1 l l l l l l l 1 l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i
1 1 1 1 l l l 1 1 1 1 l 1 1 l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I i
i i i i i i l i i i i l l l i l l l 1 l l l l 1 1 1 l 1 1 l 1 1 l 1 1 1 1 l 1 l l 1 1 l i i i i i
i i i i i i i i i i i i i i i i i l l i 1 l l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 t 1 1 1 1 1 l 1 1 1 1
I I I I 1 1 1 ! 1 1 , | I I I 1 I I I I 1 1 , 1 1 | 1 1 1 1 1 I
l l l l l l 1 1 1 1 l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 l 1 l 1 1 l l i i i i i
1 1 1 1 1 1 1 1 1 1 1 1 ! 1 1 1 1 1 1 1 1 1 1 l 1 1 1 l l
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
I I I I I I 1 1 | | I I I I I I I | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 t 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
.........
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1
iPA (DURI430
817
-------
AGENCY
SITE NAME_
PARAMETER.
AIR QUALITY DATA HANDLING SUBSYSTEM (AQDHS-II)
COMPREHENSIVE DATA HANDLING SYSTEM (CDHS)
FORMAT 1 - LESS THAN DAILY SAMPLING INTERVAL
BY
DATE.
PAGE.
-OF__
1
1
STATE
2
,
AREA
4
I 1 1
SITE
8
, ,
Ul
O
<
11
PROJ
12
,
Ul
5
1-
14
YEAR
15 16
1
PARAMETER
23
l 1 f 1
METH
28
,
UNITS
30
,
DP
32
MO
17
,
,
,
1
i
1
,
l
,
, '
,
,
i
,
i
,
,
,
,
.
l
1
,
,
,
,
i
,
t
,
,
,
1
,
,
i
1
i
,
,
,
,
,
,
f
,
I
DAY
19
l
,
1
,
,
,
i
,
,
,
1
i
1
,
,
,
,
fl
i
,
,
,
,
1
,
l
,
1
,
,
,
,
§
i
l
,
,
,
1
,
.
,
1
,
,
,
l
i
START
HOUR
21 22
,
,
i
,
,
,
,
,
,
I
,
,
,
,
,
,
,
,
,
1
,
1
1
,
,
,
,
,
i
I
,
£
|
f
1
,
,
,
,
,
,
,
,
|
I
|
,
,
READING 1
13
li*
i i i
ill
1 i i
i i i
i l 1
i . 1
l i i
ill
i i i
i i i
H * '
i i i
i 1 i
l l i
i i i
1 l i
f i i
iii
i i i
1 * '
iii
i i t
i l i
' ' 1
T 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
I 1 1
1 ' '
If*
1 1 1
111
1 ' *
1 1 |
III
1 1 1
1 1 1
1 1 1
1 1 •
1 1 .
I I I
READING 2
7
1 l 1
ill
• i i
i i i
i i i
i i i
i • i
iii
i i i
iii
i i i
i i i
i i i
i i i
iii
i i i
i i i
• i i
i i i
i i i
i i •
i i i
. i i
ill
ill
III
l 1 l
• . 1
i 1 i
1 l 1
ill
i l 1
1 1 l
1 l i
l i 1
1 1 i
| l 1
• i 1
1 i l
1 1 1
1 i 1
III
l i 1
1 i 1
l 1 1
READINGS
41
i i 1
ill
lit
ill
i i l
i i 1
i i 1
ill
i l i
i i 1
i
i i •
ill
1
ill
1 * '
1 ' f
| i i
i • i
i i i
i i i
iii
1 i i
i i i
1 i i
i i i
i i i
i i i
ill
1 H 1
iii
i t i
1 i i
i
iii
iii
iii
i | |
1 J__L
ill
lit
iii
iii
i . .
READING 4
3
1 1 1
1 i 1
1 1 1
l 1 1
III
1 1 1
1 1 1
III
1 1 1
1 1 1
III
1 1 1
1 1
III
1 1 .1
III
1 1 1
'* 1
1 1 1
111
III
1 1 1
1 1 1
1 1 1
III
111
1 1 1
111
III
III
1 i l
III
III
1 1 1
1 1 1
III
1 1 1
III
III
1 1 l
H i i
III
1 1 1
READINGS
19
1 ^ i
iii
i i i
i i l
i . i
i i i
i i i
i i i
i l i
l l i
1 1 1
iii
iii
i i i
1 1 l
iii
i i i
iii
i i i
iii
iii
1 1 '
l f i
iii
i i |
i i i
1 i i
• • l
i i 1
i i l
iii
ill
1 i 1
i i 1
iii
iii
iii
i i - i
ill
i i •
ill
READINGS
S3
ill
i i i
i l l
l 1 l
111
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
I 1 1
1 1 1
III
' 1 1
1 1 1
1 1 1
1 1 1
1 1 1
III
1 1 1
III
III
1 1 1
| ||
1 1 1
1 1 1
1 1 1
III
1 1 1
| 1 f
III
III
• . 1
1 1 1
III
1 1 1
1 1 1
1 1 1
1 1 1
111
III
1 1 1
1 1 1
READING?
57
i i I
i i i
i i i
i i i
i i i
i 1 i
iii
i . i
I 1 I
1 I i
ill
• i .
iii
1 I i
i i I
iii
i i i
l t i
i i i
. i i
iii
i i i
i i i
iii
iii
i i i
iii
iii
iii
ill
iii
ill
ill
§
READINGS
61 64
• i i
iii
i' i i
i i
iii
i i- i
i i •
i i
iii
i i i
iii
i i i
i i i
i i i
• i i
i i i
i i i
i i i
i>i
i i i
i i i
i i i
i i .
iii
i i i
iii
fl • *
i
iii
• i i
• i i
i i 1
i • 1
iii
EPA (DUR) 427
818
-------
AGENCY
SITE
2
STATE
2
,
DAY
ja 20
0 1 1
0,2
0,3
0,4
0,5
0,6
V
0,8
0,9
1,0
1,1
V
1,3
1,4
1,5
1,6
V
1,8
1 ,9
2,0
2,1
2,2
2,3
2,4
2,5
2,6
2,7
2,8
2,9
3,0
3,1
START
HOUR
21 22
,
l
,
,
,
,
1
,
l
,
l
1
,
,
1
,
,
1
1
,
1
,
1
1
1
1
,
AIR QUALITY DATA HANDLING SUBSYSTEM (AQDHS-II)
COMPREHENSIVE DATA HANDLING SYSTEM (CDHS)
FORMAT 2 -MULTIPLE PARAMETERS
DAILY OR GREATER SAMPLING INTERVAL
AREA
i i i
SITE
B
, ,
PARAMETER CODE
23
1
METHOD
28
(
UNITS
30
,
27
DP
32
READING
33
31
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1
1
, 1 1
1- 1 1
1 1 1
1 1 1
1
1
1
,
|
I
1 , 1
1 1 1
1
1
1 1 1
, 1 1
1 1 1
1
,
1
1 1 1
1 1 1
1 • 1
1 1 1
1 1 1
1 1 1
1
1
1 1 1
1 1 1
1
,
,
1 1
|
|
AGEN PROJECT TIME
i
YEAR MONTH
PARAMETER CODE
37
4
1 1 1 1
METHOD
42
1
UNITS Dl
44 41
,
READING
4L
i
SO
, ,
i i i
i , i
i j i
iii
i i i
i i i
i i i
, , ,
iii
i
i
1 1
1 1
i i
i i i
i i i
i i i
i i i
i i i
i i i
i i i
i i i
i i i
i i
i i i
i
i
i
1 1
1 1
1 1
1 l i
1 l i
1
1 1
1 1 1
BY
DATP
PAGE OF
I'l
f5™ 80
^^M
PARAMETER CODE PARAMETER CODE
1 SI
,
' METHOD
56
,
SB 69 Be
II 1 1 I 1
UNITS DP METHOD UNITS DP
Tl W » -»£• Y ' tlL!
i ii
READING
At
1
-r M
1 1 1
I
1 1 l
1 1 1
1
i i
1 i l
1 l 1
l
, l 1
l
i i
1 1 |
1 l i
1 i l
1
i i
1
II l
, 1 1
,
i i
1 1 1
1
i i
1 1 1
II 1
, . ,
|
i i
1 l 1
1
l
1
i i
i i
i i
1 l i
READING
is n
i i i
i i i
i i i
, i
i i i
i i
j i i
i i i
i' i i
i i
i i i
iii
ii i
i i
i'i i
i
i i i
i i i
i i i
i ii
i i i
i i i
i
| 1 1
'
i
iii
i i i
i f i
EPA (DUR) 426
819
-------
\GENCY AIRQUAL
ITF
'2
STATE
2
1
TY DATA HANDLING SUBSYSTEM (AQDHS-II)
COMPREHENSIVE DATA HANDLING SYSTEM (CDHS)
FORMAT 2 - COMPOSITE DATA
AREA
4
i i i
PARAMETER CODE
23
METHOD
28
UNITS
30
27
DP
32
READING
33
36
1 1
i i |
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
i
i
1 1 1
i I |
III.
1 1 1
i I i
1
1
I
i
i
i
1
!
i i i
1
i
1
I I i
1 1 1
1
1
i
|
1
1 1 1
1 1 1
1 1 |
1 1 1
1 1 1
1 1 1
,
SITE
8
I
-------
COMPREHENSIVE DATA HANDLING SYSTEM (CDHS)
FORMAT 3 - MULTIPLE SITE (STATION)
DAILY OR GREATER SAMPLING INTERVAL
i
3
STATE
2
DAY
22
o
0
23
1-
2
0,3
0
o
_0j
4
5
6
0 ,7
o
0
8
9
1 |0
1 ,1
1
1
1
1
1
1
1
1
2
3
4
5
6
7
8
9
2 ,0
2
2
2
2
2
2
2
2
2
3
Jj
1
2
3
4
5
6
7
8
9
0
1
»QE(
4
^ PROJECT
START
HOUR
ii
s a
TIME
7
AREA
28
1 1
tt
1
PARAMETER CODE
B
SITE
30 32
| 1
READING
33
l 1
36
l 1 1
1 1 1
1 1 1
1 1
1 I
,
1
1 1 1
1 1
1
i l i
, l ,
l 1
III
1 1 1
l 1 I
l l
i 1
1
,
, l i
1 1
,
, 1 1
1 1
,
, l 1
I 1 1
i 1 1
1 1 1
1 1 1
1 1 1
1' 1 1
, , 1
1 1
1 ' *
l 1 I
,
STAR!
HOUR
37
|
1Z
METHOD
AREA
39 42
1 1 1
13
1
SITE
43 45
READING
46
1 ,
i l
49
1
i
1 1 1
1 , 1
1
1 1 1
I 1
1 1
I
1
1 1 1
1 1 1
1 1 1
1 l
,
1
III
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1
1 1 1
1 1 1
1 1 1
1 i
,
1 ' '
1 1
1 1
1 I
1
I
1 1 1
1 1 1
1 1 1
I
UNITS DP YEAR
•
5 17 IB
1 1
HATP
PAGE OF
§ I
a 6
MONTH 5 <
Z4 i 79 Bty
1
HTOURT AREA SITE B&R AREA SITf
SO 52 55 M SB 83 85 88 IB
1 III II 1 III 1
READING
59 62
1 1 1
I 1 1
1 1 1
1 1 1
1 1 i
1 1 l
1 1 1
, . ,
1 1 1
1 1 1
1 1 1
1 1 1
1 1 ,
1 1 1
,
1
1 1 1
1 1 1
1 I 1
i l 1
1 i i
, , 1
i 1 1
, 1 l
1 1 l
1 I 1
READING
72 7S
1 1 ' 1
1 1 1
1 1 1
1 1 1
1 1 1
1 1 l
1 1 i
1 1 1
1 1 1
1 I l
1 1 1
1 1 1
1 1 I
1 1 1
1 I l
1 1 1
1 1 1
1 1 1
1 1 1
1 1 1
1 , 1
1 l l
1 1 1
1 1 1
1 1 1
1 1
PA(DUR)425
821
-------
AGENCY_
PURPOSE.
AIR QUALITY DATA HANDLING SUBSYSTEM (AQDHS-II)
COMPREHENSIVE DATA HANDLING SYSTEM (CDHS)
1 RETRIEVAL SPECIFICATIONS
. BY.
DATE.
PAGE OF_
1 8
S.S.S.E.L.E.C.T
LANG
KEYWD
10 13
I
COBOL MEMBER
NAME
16 23
I.I li i i i
MODE
25
i I
KEYWORD
32
1 1 I i i
LIST OPTION
34 39
i i i I i
USER-DEFINED
DATA MEMBER
NAME
43
1 1
50
1 1 1 1
USER-DEFINED
SUBROUTINE
MEMBER NAME
52 59
i i i i i ii
GENERATED
LOAD
MODULE NAME
61 67
i i 1 i i I
VALID DATA NAMES
NAME
ACTION-CODE
AGENCY
AQCR
AREA-CODE
COMPOSITE-KEY-3
COMPOSITE-PERIOD
COMPOSITE-SAMPLES
COMPOSITE-TIME-CODE
COMPOSITE-TYPE
COUNTY-CODE
DATA-FIELD*
DAY-CODE
i
LENGTH
1
1
3
4
6
2
2
1
1
4
2
TYPE
N
A
N
N
N
N
N
A
N
N
N
N
NAME
FORM-CODE '
IDENT-KEY
KEY-1
KEY-2
KEY-3
METHOD-CODE
MONTH
NBR-OF-READINGi
PARAMETER-CODE
LENGTH
1
37
22
9
6
2
2
2
5
TYPE
N
A
A
N
N
N
N
N
N
NAME
PROJECT
RECORD-STATUS-FLAG
SITE
SLAMS-ID
START-HOUR
STATE
STATUS-FLAG*
TIME-CODE
UNIT-CODE
YEAR
* REPEATING DATA NAME
:
LENGTH
2
1
3
1
2
2
1
1
2
2
TYPE
N
A
N
A
N
A
A
A
N
N
VALID VALUES FOR
NEGATION FLAG (NF): BLANK, N
RELATIONAL OPERATOR (RO):
- EQUAL
>GREATER THAN
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 1
Release Date: 4/30/79
Update #: 24
APPENDIX E - AQDHS-II File Specifications
INTRODUCTION
This appendix presents a cross-reference of the AQDHS-II files and the
programs that read or write them; it also discusses the blocking factors of
these files.
The files used by AQDHS-II may be categorized as follows:
1) Permanent files (master file, parameter file, parameter
standards file, site file). These are the essential files of
AQDHS-II.
2) FORTRAN-compatible files (FORTRAN-compatible master file,
FORTRAN-compatible parameter file). These files enable the user
to access data from the master and parameter files with user-
written programs compiled by any ANS FORTRAN compiler.
3) SAROAD-report files. These are files placed on magnetic tape
and submitted to EPA for inclusion in the SAROAD data base.
4) Temporary Files. These files are passed between various
AQDHS-II programs and are not permanently retained.
5) Unit Record Files (print files, input card files, and output
skeleton transaction card files).
6) Library Files (program source module library, program load
module library, and procedure library). These files are
maintained as partitioned data sets on IBM/OS systems.
823
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 2
Release Date: 4/30/79
Update #: 24
CROSS REFERENCE OF FILES AND PROGRAMS
Table E-l 1s a cross-reference of AQDHS-II files and programs that read
or write them. This cross-reference 1s provided to assist the user 1n
modifying a file's blocking factor or otherwise modifying the characteristics
of a file.
824
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 3
Release Date: 4/30/79
Update #: 24
Table E-l. Cross-Reference of Files and Programs
File
Programs which
Process
the File
Usage
Input/Output
Permanent Files
Archived Master File*
Master File
Parameter File
AMSARCH (AQ0215)
ACVANOM (AQ0040)
ACVMFOR (AQ0020)
ACVUNIT (AQ0050)
AFMMSTR (AQ0100)
AMSARCH (AQ0215)
AMSMERG (AQ0210)
ARPDUMP (AQ0310)
ARPINVP (AQ0290)
ARPINVS (AQ0280)
ARPMSBR (AQ0300)
ARPMSTR (AQ0230)
ARPPMEX (AQ0330)
ARPSARD (AQ0220)
ARPSMEX (AQ0340)
ARTGENR (AQ0120)
ASRMSTR (AQ0140)
ASTPRLM (AQ0190)
ACVANOM (AQ0040)
ACVPFOR (AQ0030)
ACVUNIT (AQ0050)
AEDMSTR (AQ0060)
Output
Input/Output
Input
Input
Input/Output
Input/Output
Input/Output
Input
Input
Input
Input
Input
Input
Input/Output
Input
Input
Input/Output
Input
Input
Input
Input
Input
The archived master file may be used instead of the
program that uses the master file as input.
master file in any
(page 1 of 6)
825
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 4
Release Date: 4/30/79
Update #: . 24
Table E-l - Continued. Cross-Reference of Files and Programs
File
Programs Which
Process
the File
Usage
Input/Output
Parameter File (continued)
Parameter Standards File
Site File
FORTRAN-Compatible Files
FORTRAN-Compatible Master File
FORTRAN-Compatible Parameter File
AEMPARM (AQ0070)
ARPINVP (AQ0290)
ARPINVS (AQ0280)
ARPMSST (AQ0270)
ARPMSTR (AQ0230)
ARPPARM (AQ0240)
ARPPMEX (AQ0330)
ASTPRLM (AQ0190)
AEMSTND (AQ0090)
ARPMSTR (AQ0230)
ARPSTND (AQ0250)
AEDMSTR (AQ0060)
AEMSITE (AQ0080)
ARPINVP (AQ0290)
ARPINVS (AQ0280)
ARPMSST (AQ0270)
ARPMSTR (AQ0230)
ARPSITE (AQ0260)
ARPSMEX (AQ0340)
ACVMFOR (AQ0020)
ACVPFOR (AQ0030)
Input/Output
Input
Input
Input
Input
Input
Input
Input
Input/Output
Input
Input
Input
Input/Output
Input
Input
Input
Input
Input
Input
Output
Output
(page 2 of 6)
826
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS Page 5
Release
Update
Date: 4/30/79
#: 24
Table E-l - Continued. Cross-Reference of Files and Programs
File
SAROAD Report Files
SAROAD Transaction Format
Add File
SAROAD Transaction Format
Change File
Temporary Files
Answer File*
File of Data to be Screened
Generated Retrieval Program
Programs Which
Process
the File
ARPSARD (AQ0220)
ARPSARD (AQ0220)
ACVUNIT (AQ0050)
ARTGENR (AQ0120)
for Anomalies ACVANOM (AQ0040)
ARPANOM (AQ0320)
Source Module ARTLNGP (AQ0110)
Master File Internal Transactions AEDMSTR (AQ0060)
Preliminary Statistics File
Raw Data File
Sliding Average Answer File
Sliding Average Values File
ASRINTR (AQ0130)
ASTMSST (AQ0200)
ASTPRLM (AQ0190)
ASTMSST (AQ0200)
ASTPRLM (AQ0190)
ARTGENR (AQ0120)
ASTSLAV (AQ0180)
ARPMSTR (AQ0230)
ASTSLAV (AQ0180)
Usage
Input/Output
Output
Output
Output
Output
Output
Input
Output
Output
Input
Input
Output
Input
Output
Output
Input
Input
Output
(page 3 of 6)
827
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 6
Release Date: 4/30/79
Update #: 24
Table E-l - Continued. Cross-Reference of Files and Programs
File
Sort Work Files
Sorted Master File Internal
Transactions
Sorted Parameter File Transactions
Sorted Parameter Standards File
Transactions
Programs Which
Process
the File
ARPSITE (AQ0260)
ASRINTR (AQ0130)
ASRMSTR (AQ0140)
ASRPARM (AQ0150)
ASRSITE (AQ0160)
ASRSTND (AQ0170)
AFMMSTR (AQ0100)
ASRINTR (AQ0130)
AEMPARM (AQ0070)
ASRPARM (AQ0150)
AEMSTND (AQ0090)
ASRSTND (AQ0170)
Usage
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input/Output
Input
Output
Input
Output
Input
Output
*An answer file may be used instead of the master file in any program that
uses the master file as input.
(page 4 of 6)
828
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 7
Release Date: 4/30/79
Update #: 24
Table E-l - Continued. Cross-Reference of Files and Programs
File
Programs Which
Process
the File
Sorted Site File Transactions AEMSITE (AQ0080)
Statistics File
Unit Record Files
Master File Transactions
Parameter File Transactions
ASRSITE (AQ0160)
ARPMSST (AQ0270)
ASTMSST (AQ0200)
ACVSARD (AQ0010)
AEDMSTR (AQ0060)
ASRPARM (AQ0150)
Parameter Standards File Transactions ASRSTND (AQ0170)
SAROAD Transactions
Site File Transactions
ACVSARD (AQ0010)
ASRSITE (AQ0160)
Skeleton Master File Transactions ARPANOM (AQ0320)
Skeleton Parameter File Transactions ARPPMEX (AQ0330)
Skeleton Site File Transactions ARPSMEX (AQ0340)
Retrieval Specifications
Option Card Fi les
ARTLNGP (AQ0110)
ACVANOM (AQ0040)
ACVSARD (AQ0010)
ACVUNIT (AQ0050)
AEDMSTR (AQ0060)
AEMPARM (AQ0070)
AFMMSTR (AQ0100)
AMSARCH (AQ0215)
ARPDUMP (AQ0310)
ARPMSST (AQ0270)
Usage
Input/Output
Input
Output
Input
Output
Output
Input
Input
Input
Input
Input
Output
Output
Output
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
(page 5 of 6)
829
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 8
Release Date: 4/30/79
Update #: . 24
Table E-l - Continued. Cross-Reference of Files and Programs
File
Programs Which
Process
the File
Usage
Input/Output
Print Files
ARPMSTR (AQ0230)
ARPSARD (AQ0220)
ARPSMEX (AQ0340)
ASRMSTR (AQ0140)
ASTPRLM (AQ0190)
ASTSLAV (AQ0180)
All Programs
Input
Input
Input
Input
Input
Input
Output
Library Files
Program Source Library
ARTLNGP (AQ0110)
Input
(page 6 of 6)
830
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 9
Release Date: 4/30/79
Update #: .24
BLOCKING FACTORS
The blocking factor of a file is defined as the number of logical records
that are contained in one physical record or block. A file's blocking factor
determines how efficiently it can be stored on disk or magnetic tape. It also
affects the efficiency of any program that uses the file.
Table E-2 lists for each AQDHS-II file the recommended blocking factor
for storage on IBM 3330 disk units, IBM 2314 disk units, and magnetic tape.
The recommended blocking factors were primarily established to optimize
storage efficiency for these two models of disk and to optimize processing
efficiency for tape files. Each user may determine and implement his own
blocking factors; indeed, a user who utilizes a medium of storage other than
the IBM 3330 disk unit, 2314 disk unit, or magnetic tape should establish
blocking factors suitable for his storage medium. A blank column has been
provided in Table E-2 for the user to enter the locally-defined blocking
factors.
As released by NADB, AQDHS-II utilizes the recommended blocking factors
for IBM 3330 disk units. Additionally, all unit record files have a blocking
factor of one.
To change the blocking factor for a file other than a library file the
user must accomplish the following: (Assistance in accomplishing these tasks
may be obtained from the user's systems personnel or NADB.)
1) Modify the source module of each COBOL program that reads or writes
the file to reflect the new blocking factor (see Table E-l). For all
files other than unit record files, the RECORD CONTAINS clause in the
file's FD statement must be modified. For unit record files, no
RECORD CONTAINS clause appears in the source module of the COBOL
programs; however, a comment line is provided for insertion of a
831
-------
CO
co
ro
Table E-2. Blocking Factors
of AQDHS-II
Recommended Records per
Block for Files on Disk
File
Permanent Files
Characters IBM 3330
per record Disk
(13,030
characters
per track)
Archived Master File 63-243 8
Master File 63-243 8
Parameter File 146 11
Parameter Standards File 112 23
Site File 80 18
FORTRAN-Compatible Files
FORTRAN-Compatible
Master File
FORTRAN-Compatible
Parameter File
*Blocking factors used
118 22
20 36
IBM 2314
Disk
(7,294
characters
per track)
8
8
12
13
13
15
45
by AQDHS-II as released by NADB
Files
Recommended
Records per
Records per
Block used
Block for
Locally
Files on
Magnetic
Tape
10
10
15
20
25
20
50
(Page 1 of 4)
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
cz -yo T3
T3 rt> D»
Q. — ' «Q
01 to n>
c* O»
tt> in i-«
(D O
=*=
o
Ol
r+
ro n>
4* ••
-p»
CO
o
•-J
vo
-------
00
oo
CO
Table E-2 - Continued.
Blocking Factors of AQDHS-I
Recommended Records per
Block for Files on Disk
Characters
File
per Record
SAROAD Report Files
SAROAD Add File 80
SAROAD Change File 80
Temporary Files
Answer File 63-243
File of Data to be 114
Screened for Anomalies
Generated Retrieval 80
Program Source Module
*Blocking factors used by AQDHS-II as
IBM 3330
Disk
(13,030
characters
per track)*
N/A
N/A
8
19
42
IBM 2314
Disk
(7,294
characters
per track)
N/A
N/A
8
15
42
released by NADB
I Files
Recommended
Records per
Records per
Block used
Block for
Locally
Files on
Magnetic
Tape
50*
50*
10
25
50
(Page 2 of 4)
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
ci •yo -o
•a m o>
a. — • «3
o> n> a>
e+ O>
n> i-1
m i-*
.. O
CU
ro n>
•^
CO
o
— 1
10
-------
00
co
Table E-2 - Continued. Blocking Factors of
File
Master File Internal
Transactions
Preliminary Statistics
Raw Data File
Sliding Average Answer
Sliding Average Values
Sort Work Files
Sorted Master File
Internal Transactions
*Blocking factors used
Characters
per Record
91
File 97
112
File 63-243
File 63-243
varies
91
Recommended Records per
Block for Files on Disk
IBM 3330 IBM 2314
Disk Disk
(13,030 (7,294
characters characters
per track)* per track)
20 20
19 25
23 13
8 8
8 8
** **
20 20
AQDHS-II Files
Recommended
Records per
Records per
Block used
Block for
Locally
Files on
Magnetic
Tape
25
25
25
10
10
**
25
by AQDHS-II as released by NADB
**Blocking factors determined by COBOL sort package
(page 3 of 4)
AQDHS-II
APPENDIX E
-n
•— i
m
co
m
0
i— i
-n
i— i
o
i— i
0
co
c: •yo -o
•o n> 01
ex — • «Q
O> (D (T>
«-«• ot
(D l/l I-'
o> ro
o>
ro n>
CO
o
VO
-------
00,
to.,
en-
Table E-2 - Continued.
Blocking Factors of AQDHS-II
Files
Recommended Records per
File
File
Sorted Parameter File
Transactions
Sorted Parameter Standards
File Transactions
Statistics File
Sorted Site File
Transactions
Library Files
Program Source Library
Program Load Library
Procedure Library
*Blocking factors used by
Characters
per Record
80
80
100
80
80
N/A
80
AQDHS-II as
Block for
IBM 3330
Disk
(13,030
characters
per track)
18
18
13
18
42
N/A
100
released by
Files on Disk
IBM 2314
Disk
(7,294
characters
per track)
13
13
18
13
42
N/A
100
NADB
Recommended
PI •
Records per
Records per
Block used
Block for
Locally
Files on
Magnetic
Tape
25
25
25
25
50
N/A
100
(Page 4 of 4)
3> 3>
-o -o
-o o
n ~*T
•z. co
O 1
1— « t— 1
m
^fm
* I
H-l
I—
m
co
m
o
-n
»— i
o
—I
0
co
a. — • tn
tu t\> n>
rt- D)
n> i™*
(D CO
=»=
fa
ro n>
co
0
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 14
Release Date: .4/30/79
Update #: 24
RECORD CONTAINS clause. When changing the blocking factor for unit
record files, this comment line should be replaced by the RECORD
CONTAINS clause (to maintain the line number integrity of the source
module).
2) Compile and link edit each COBOL program that is modified.
3) Modify the cataloged procedure that executes any FORTRAN program that
uses the file. (See Table E-l.) The DCB parameters for
the affected file should be changed to reflect the new blocking
factor. Note: The AQDHS-II programs coded in FORTRAN are ARPANOM
(AQ0320) and ASTMSST (AQ0200); they are executed by procedures
AQRPM45 and AQRPM10, respectively.
4) If the above actions are taken to change the blocking factor of a
file prior to the creation of any copies of the file, no further
action is necessary; the file will be created with the blocking
factors that have been specified. However, if there are existing
copies of the file, they must be reblocked before they can be used.
This reblocking can be accomplished by IBM users with the utility
IEBGENER. An example of a run stream to reblock a disk file is shown
in Figure E-l.
To change the blocking factor of the program source module library, the
user must modify program ARTLNGP (AQ0110) as discussed in step 1 above,
compile and link edit ARTLNGP (AQ0110), and reblock the program source module
library (see Figure E-2). IBM users should not reblock the program load
module library or procedure library.
836
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 15
Release Date: 4/30/79
Update #: 24
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
// EXEC
//SYSPRI
//SYSUT1
II
//SYSUT2
II
II
II
II
II
//SYSIN
PGM=IEBGENER
DD SYSOUT=A
DD DISP=OLD,
DSNAME='file name1
DD DISP=(NEW,CATLG,DELETE),
DSNAME='file name1,
SPACE=(TRK,(10,1),RISE),
UNIT=DISK,
VOL=('volume/serial information1),
DCB=('DCB information')
DD DUMMY
User-supplied JCL:
Line 4. Replace 'file name' with the name of the file to be reblocked.
Line 6. Replace 'file name' with the name of the reblocked file.
Line 7. Space allocation is dependent upon the file size, and it may be
necessary to increase the space allocation.
Line 9. Replace 'volume/serial information' with the volume and serial
specifications of the reblocked file.
Line 10. Replace 'DCB information' with the DCB information specifying the
the new blocking factor.
Figure E-l. Sample Job Stream to Reblock a Permanent or
FORTRAN-Compatible AQDHS-II File Stored on Disk.
837
-------
AQDHS-II
APPENDIX E
FILE SPECIFICATIONS
Page 16
Release Date: 4/30/79
Update #: . 24
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13
// EXEC
//SYSPRI
//SYSUT1
II
//SYSUT2
II
II
II
II
II
//SYSIN
COPY
/*
PGM=IEBCOPY
DD SYSOUT=A
DD DISP=OLD,
DSNAME='library name1
DD DISP=(NEW,CATLG,DELETE),
DSNAME='1i brary name',
SPACE=(TRK,(10, 1),RLSE),
UNIT=DISK,
VOL=('volume/serial information1),
DCB=('DCB information1)
DD *
OUTDD=SYSUT2,INDD=SYSUT1
User-supplied JCL
Line 4. Replace 'library name1 with the name of the program source module
library to be reblocked.
Line 6. Replace 'library name' with the name of the reblocked library.
Line 7. Space allocation is dependent upon the file size, and it may be
necessary to increase the space allocation.
Line 9. Replace 'volume/serial information1 with the volume and serial
specifications of the reblocked library.
Line 10. Replace 'DCB information' with the DCB information specifying the
new blocking factor.
Figure E-2. Sample Job Stream to Reblock an AQDHS-II
Program Source Module Library.
838
-------
AQDHS-II
INDEX
INDEX
Page 1
Release Date: 4/30/79
Update: # 24
INDEX
Abort error message 1.2, Appendix B
Absolute differences 6.4.3.1
Action card 5.5.2.1, 5.5.2.2,
5.5.2.6, 6.3.2.2
Action code 1.2, 4.7.1.1, 4.2.2.2,
4.5.1.1, 4.5.1.2, 4.5.2.1, 4.5.3.2
ACTION-CODE 5.2.2.2
ACVANOM (AQ0040) 5.5.5, 4.2.2.6,
6.4.3
ACVMFOR (AQ0020) 5.5.3
ACVPFOR (AQ0030) 5.5.4, 4.2.2.8
ACVSARD (AQ0010) 5.5.2, 4.1
ACVUNIT (AQ0050) 5.5.6, 4.2.2.6
Adjacent hourly difference test
6.4.3.1, 6.4.3.2
AEDMSTR (AQ0060) 4.5.1, 4.1,
4.5.2.2, 4.5.3, 4.6.1, 5.5.2.8,
5.5.5.6, 6.4.3.2, 6.4.3.6
AEMPARM (AQ0070) 4.2.2, 4.1,
4.2.1, 6.2.4.1, 6.2.4.6, 6.2.4.8,
6.4.7.1, 6.4.7.2, 6.4.7.8
AEMSITE (AQ0080) 4.3.2, 4.1,
4.3.1, 6.2.6.6, 6.4.8.6, 6.4.8.8
AEMSTND (AQ0090) 4.4.2, 4.1, 4.4.1
AFMMSTR (AQ0100) 4.5.3, 4.1,
4.5.1, 4.5.2, 4.6.1, 5.5.2.8,
5.5.5.2, 5.5.5.6, 6.4.3.2,
6.4.3.6
AGENCY 5.2.2.2
Agency code 1.2, 4.3.1.1, 4.3.2.2,
4.5.1.1, 4.5.1.2, 4.5.2.1, 4.5.3.2,
5.5.2.2, 6.4.8.1
AMSARCH (AQ0215) 5.4.3, 5.4.2.8
AMSMERG (AQ0210) 5.4.2, 5.4.3.8
Analysis method 4.2.2.2, 6.4.2.2
Analysis period 6.4.2.6
AND 5.2.2.2.1
Anomaly screening 5.5.5, 6.4.3,
4.5.3.1, 5.2.2.2.2, 6.3.2.1,
7.2.2
categories 5.5.5.1, 5.5.5.6,
6.4.3.1, 6.4.3.6
criteria 5.5.5.2, 5.5.5.3
reports 6.4.3.2
tests 5.5.5.1, 5.5.5.2, 6.4.3.1,
6.4.3.2
ANS 1.2, 2.2
Answer file 1.2, 5.2.2, 5.2.3,
5.3.1.1, 5.3.1.2, 5.3.2.2, 5.3.4,
5.4.2, 5.5.3, 5.5.6, 5.6.2, 6.2.3,
6.4.6
Apostrophes 5.2.2.2.1
839
-------
AQDHS-II
INDEX
INDEX
Page 2
Release Date: 4/30/79
Uodate: ^ 24
AQCR 5.2.2.2
code 1.2, 4.3.1.1, 4.3.2.2,
4.5.1.2, 4.5.2.1, 4.5.3.2, 6.4.8.1
AQCLC10 8.2.4.1, 4.5.1.6, 8.3.6
AQCLF10 8.2.4.2, 8.3.6
AQCVM10 5.5.3.5
AQCVM20 5.5.6.5
AQCVP10 5.5.4.5, 4.2.2.8
AQCVT10 5.5.2.5
AQDHS-II 1.2, 2.1
Baseline test run series. See
baseline test run series
retrieval language 5.2.2.1,
5.2.2.2.1, 5.2.2.2.2.,
5.2.2.2.3
transactions. See Master file
transactions
AQEDT10 4.5.1.5, 5.5.2.1, 5.5.2.8
AQEMD10 4.4.2.5, 4.4.1.5, 4.4.1.8
AQEMM10 4.6.1, 4.5.1.8, 4.5.2.8,
4.5.3.8, 5.5.2.1, 5.5.2.8
AQEMP10 4.2.2.5, 4.2.1.5, 4.2.1.8,
6.2.4.8
AQEMS10 4.3.2.5, 4.3.1.5, 4.3.1.8
AQFMM10 4.5.3.5, 4.5.2.5, 5.5.2.1,
5.5.2.8
AQMSM10 5.4.2.5
AQMSM20 5.4.3.5
AQRPD10 6.2.5.5
AQRPM10 6.4.2.5, 5.3.1.1, 5.3.2.5,
D • *j * 0 • 0
AQRPM20 6.3.2.5, 5.3.4.8
AQRPM25 6.2.2.5.1
AQRPM30 6.4.6.5
AQRPM35 6.4.4.5, 5.6.2.8
AQRPM40 6.4.5.5, 5.6.2.8
AQRPM45 6.4.3.5, 5.5.5.5, 5.5.5.8
AQRPP10 6.2.4.5, 4.2.2.8
AQRPP20 6.4.7.5, 4.2.2.8
AQRPS10 6.2.6.5
AQRPS20 6.4.8.5
AQRTM10 5.2.1, 5.2.2.1, 5.2.2.5,
5.2.2.8, 5.2.3.8, 5.3.4.8, 5.7.1
AQRTM20 5.2.2.5, 5.2.1, 5.2.2.1,
5.2.3.5.4, 5.2.3.8, 5.3.4.8, 5.7.1
AQRTM30 5.2.3.5, 5.2.1, 5.2.2.1,
5.2.2.5, 5.2.2.8, 5.3.4.8, 5.7.1
AQSRM10 5.6.2.5, 5.3.1.1, 6.4.2.8
AQSTM20 5.3.4.5
Archival 3.1, 5.4, 7.2.3
Archived 6.4.7.6
file 5.4.2.1, 5.4.3
Area code 1.2, 4.3.1.1, 4.3.2.2,
840
-------
AgUHb-11
INDEX
INULX
Kage 3
Release Date: 4/30/79
Update: #. 24
4.5.1.1, 4.5.1.2, 4.5.2.1,
4.5.3.2, 5.5.2.2, 6.4.8.1
AREA-CODE 5.2.2.2
Arithmetic mean 5.3.1.1, 5.3.3.1.
See also Mean
Arithmetic standard deviation
5.3.1.1, 5.3.3.1. See also
Standard deviation
ARPANOM (AQ0320) 6.4.3, 5.5.5
ARPDUMP (AQ0310) 6.2.2
ARPINVP (AQ0290) 6.4.5, 5.6.2.1,
5.6.2.8
ARPINVS (AQ0280) 6.4.4, 5.6.2.1,
5.6.2.8
ARPMSBR (AQ0300) 6.4.6
ARPMSST (AQ0270) 6.4.2, 5.3.1.1,
5.3.2, 5.3.3
ARPMSTR (AQ0270) 6.2.3, 5.3.1.2,
5.3.4.1, 5.3.4.2, 5.3.4.6,
5.3.4.8, 6.4.3.2
ARPPARM (AQ0240) 6.2.4, 4.2.2.8,
5.5.5.6, 5.5.6.6, 6.4.3.6
ARPPMEX (AQ0330) 6.4.7, 4.2.2.8
ARPSARD (AQ0220) 6.3.2, 4.5.3.6,
5.2.2.2.2, 5.5.5.2
ARPSITE (AQ0260) 6.2.6
ARPSMEX (AQ0340) 6.4.8
ARPSTND (AQ0250) 6.2.5
ARTGENR (AQ0120) 5.2.3, 5.2.1, 5.2.2,
5.3.1.2, 5.3.4.8, 5.7.1, 6.4.3.2
ARTLNGP (AQ0110) 5.2.2. See also
Retrieval
ARTSKEL 5.2.2
ASRINTR (AQ0130) 4.5.2, 4.1,
4.5.1.2, 4.5.1.8, 4.5.3.1,
4.5.3.5, 4.6.1, 5.5.2.8, 5.5.5.6,
6.4.3.2, 6.4.3.6
ASRMSTR (AQ0140) 5.6.2, 5.2.2.2.3,
5.2.2.5, 5.3.1.1, 5.3.2.2,
5.3.2.6, 5.5.6.1, 5.5.6.6,
6.4.2.5.4, 6.4.2.8, 6.4.4.2,
6.4.4.5.1, 6.4.4.8, 6.4.5.2,
6.4.5.5.1, 6.4.6.6
ASRPARM (AQ0150) 4.2.1, 4.1,
4.2.2, 6.2.4.8, 6.4.7.1, 6.4.7.8
ASRSITE (AQ0160) 4.3.1, 4.1, 4.3.2
ASRSTND (AQ0170) 4.4.1, 4.1, 4.4.2
ASTMSST (AQ0200) 5.3.3, 4.2.2.6,
5.3.1.1, 5.3.2, 5.5.4.1, 5.5.4.8,
6.4.2.5.1, 6.4.2.5.8
ASTPRLM (AQ0190) 5.3.2, 5.3.1.1,
5.3.3, 5.6.2.1, 6.4.2.1,
6.4.2.5.1, 6.4.2.5.8
ASTSLAV (AQ0180) 5.3.4, 5.2.2.1,
5.2.2.6, 5.3.1.2, 6.2.3.1, 6.2.3.3
Auxiliary files 4.1, 6.2.3.6
AVERAGE 5.3.4.3
Average value 6.4.4.2, 6.4.5.2,
6.4.6.1. See also Arithmetic mean;
841
-------
AQDHS-II
INDEX
INDEX
Page 4
Release Date: 4/30/79
Uodate: # 24
Mean
Baseline 1.2, 8.2.3.1, 8.2.3.2,
8.2.7, 8.3.4, 8.3.5, 8.3.9
Baseline test run series
5.2.2.5.4, 5.5.6.5.4, 5.7.1.4,
6.2.3.5.4, 7.1, 8.2.5
BATCH 5.6.2.3
Batch retrieval code 5.6.2.3
Batched retrievals 1.2, 5.2.2.2.3,
5.6.2.1, 5.6.2.3. See also
Retrievals
BLKSIZE 8.1.4
BLOCK 1.2
size 8.1.4
Blocking factor 1.2, 8.3.4
Boolean
connectives 5.2.2.2.1
expressions 5.2.2.2.1
operator 5.2.2.2.1
BRIEF 6.4.2.3
Carbon monoxide 5.5.5.1, 6.4.3.1
Card 1.2
Card type 4.2.1.1, 4.2.2.2,
4.4.2.2, 5.2.2.2, 6.4.7.2
Catalog 1.2, 8.1.4
Cataloged data set 8.1.4
Cataloged procedures 4.6.1.1,
5.7.1.1, 8.1, 8.1.6, 8.3.5.
See also the index listings for
individual procedures and the
Cataloged JCL section for each program
CATLG 8.1.4
CDHS 1.2, 2.1
CLASS 8.1.2
COBOL 1.2, 2.2
compiler 5.3.1.2, 8.2.4
files 5.5.3, 5.5.4
retrievals 5.2.2.1, 5.2.2.2.2
data member 5.2.2.2
member name 5.2.2.2
subroutine member 5.2.2.2
sorts 2.2
Coding transactions 4.5.3.6
Coefficient of variation 6.4.3.1
Collating sequence 2.2, 4.2.1.6,
4.3.1.6, 4.4.1.6, 4.5.2.6, 5.6.2.6
Collection method 4.2.2.2, 6.4.2.2
Comment card 8.1.5
Compile 1.2, 5.7.1, 8.2.3.1, 8.2.4,
8.3.6
COBOL 5.3.1.2
Composite data 1.2, 4.5.1.1, 4.5.3.2,
6.2.3.1
Composite number of samples 1.2,
4.5.1.1, 4.5.1.2, 4.5.3.2, 5.5.2.2
Composite period 1.2, 4.5.1.1,
4.5.1.2, 4.5.3.2, 5.5.2.2
842
-------
AQDHS-II
INDEX
INDEX
Page 5
Release Date: 4/30/79
Update: # 24
Composite time code 1.2, 4.5.1.1,
4.5.1.2, 4.5.3.2, 5.5.2.2
Composite type 1.2, 4.5.1.1,
4.5.1.2, 4.5.3.2, 5.5.2.2
COMPOSITE-KEY-3 5.2.2.2
COMPOSITE-PERIOD 5.2.2.2
COMPOSITE-SAMPLES 5.2.2.2
COMPOSITE-TIME-CODE 5.2.2.2
COMPOSITE-TYPE 5.2.'2.2
Condition code 8.2.3.1, 8.2.4,
8.3.3, 8.3.6
Conditional error message 1.2,
Appendix B
Confirmation listings 4.5.3.2,
4.5.3.3
Consistency 5.5.5.1
Continuation card 8.1.1
Control card 1.2. See also
Option card
Conversion
AQDHS-II to SAROAD 6.3.2
SAROAD to AQDHS-II 5.5.2,
7.2.10
file 5.5, 5.5.3, 5.5.4, 5.5.5,
5.5.6, 6.3.2
units. See Units, conversion
Converted file 5.5.6.1, 5.5.6.6
Copy member 5.2.2.1
Correcting master file readings
6.4.3.2, 6.4.3.6
Cost considerations 3.1, 5.3.1.2,
5.3.4.6, 5.4.3.1, 8.2.6, 8.3.8.
See also the Cost Considerations
section for each program
County
code 1.2, 4.3.1.1, 4.3.2.2,
4.5.1.2, 4.5.2.1, 4.5.3.2,
6.4.8.1
COUNTY-CODE 5.2.2.2
CYL 8.1.4
Cylinder 1.2, 8.1.4
Daily data 5.5.5.2, 5.5.5.3,
6.2.3.1, 6.4.3
Data accessing and manipulation 5.0
Data field. See Reading
Data set 1.2, 8.1.3, 8.1.4, 8.3.1.
See also Partitioned data set
DATA-FIELD 5.2.2.2
Day 1.2, 4.5.1.1, 4.5.1.2, 4.5.2.1,
4.5.3.2, 5.5.2.2, 6.4.3.2
DAY-CODE 5.2.2.2
DCB 8.1.4
DD 8.1.1
card 8.1.4
DD names
843
-------
AQDHS-II
INDEX
INDEX
Page 6
Release Date: 4/30/79
Update: # 24
cross-reference of. See the
Cataloged JCL section for each
program
deferred 8.1.4
Decimal
code 1.2, 4.5.1.1, 4.5.1.2,
4.5.3.2, 5.2.2.2.1, 5.2.2.2.2,
5.5.2.2, 6.4.3.2, 6.4.7.2,
6.4.7.6
point 6.2.3.3
position 4.2.2.6, 5.5.4.1,
5.5.5.1
DECIMAL-CODE 5.2.2.2
Deck 1.2, 8.2.3.1, 8.2.3.2
DELETE 8.1.4
DELETES 6.3.2.1, 6.3.2.6
Detailed report 6.2.3, 6.2.4, 6.2.5,
6.2.6, 7.2.5, 7.2.8
Diagnostic messages 4.5.3.2, 4.5.3.3,
5.3.2.2. See also Error messages
Diagnostic report 1.2, 8.2.2.1. See
also the File Formats section for
each program
Disaster error message 1.2,
Appendix B
Disk 1.2, 8.1.4, 8.3.2
DISP 8.1.4
DISPLAY 5.3.1.2, 6.2.3.1
Display criterion 6.2.3.3
Display option 6.2.3.1, 6.2.3.3
Disposition 8.1.4
Dixon ratio test 6.4.3.1, 6.4.3.2
DUMMY 8.1.4
Dump 6.2.2
Economy measures 3.1. See also Cost
Considerations for each program
Edit checks 4.1, 4.2.2.2, 4.3.2.2,
4.5.1
EIS/P&R 2.1
End-of-job card 8.1.5
EPA 2.1, 8.2.2.1, 8.2.2.2
regions 6.4.3.1
reports 6.3
Error message 1.2, 4.3.2.1, 4.3.2.2,
4.5.1.2, 5.5.6.1, 5.5.6.3, 6.4.3.2,
8.2.4, 8.3.6, Appendix B. See also
the Error Messages section for each
program
Evaluation
of non-parenthetical expressions
5.2.2.2.1
of parenthetical expressions
5.2.2.2.1
Exception reports 6.4.7, 6.4.8
EXEC 8.1.1
card 8.1.3
844
-------
AQDHS-II
INDEX
INDEX
Page 7
Release Date: 4/30/79
Update: # 24
Execute 1.2, 8.1.6
Execution deck 6.2.3.3
Expected value 5.5.5.1
Exponential frequency distribution
5.5.5.1
Failures 6.4.3.2
Field 1.2, 8.1.1
Field descriptions
files 4.2.2.2, 4.3.2.2, 4.4.2.2,
4.5.1.2
transactions 5.5.2.6, 4.2.2.2,
4.3.2.2, 4.4.2.2, 4.5.1.2,
5.5.2.2
Field length 4.2.2.2, 4.3.2.2,
4.4.2.2, 4.5.1.2, 5.2.2.2
File 1.2. See also entries for
particular files
archival and merging 3.1, 5.4,
7.2.3
conversion 5.5, 6.3.2
creation and maintenance 4.0,
8.1.4
listings 6.2
sorting 5.6.2
specifications Appendix E
Fixed-length records 5.5.3.1,
5.5.5.2, 6.4.2.2, 8.1.4
FLAG LOW 5.5.5.2, 5.5.5.3, 5.5.5.6,
6.4.3.1, 6.4.3.3, 6.4.3.6
FLAGW 3.1, 4.2.2.3, 4.2.2.6,
4.5.1.3, 4.5.3.3
Flowcharts
archival and merging 5.4.1
file conversion 5.5.1
file creation and maintenance
4.1.1, 4.1.2, 4.1.3
master file sorting 5.6.1
reports 6.2.1, 6.3.1, 6.4.1
retrieval 5.2.1
statistical analysis 5.3.1
system 2.3
Footnote lines 6.2.4.2, 6.2.5.1,
6.2.6.1
Form code 1.2, 4.5.1.1, 4.5.1.2,
4.5.2.1, 4.5.3.2, 5.5.2.2
Form-1 data 4.5.1.1, 4.5.3.6,
5.5.2.6, 6.4.3.2
Forrn-2 data 4.5.1.1, 6.4.3.2
Form-3 data 4.5.1.1
Format 1.2
file. See entries for individual
files and the File Formats
section for each program
option card. See the Options
section for each program
transaction. See the File Formats
section for each program
Formatted dump 6.2.2
FORM-CODE 5.2.2.2
Formulas 5.3.3.1, 5.3.4.1, 6.4.3.1
FORTRAN 1.2, 2.2, 6.4.3.5.2
compatible files 5.3.2.2, 5.5.3,
5.5.4, 5.5.5.2
compiler 8.2.4
845
-------
AQDHS-II
INDEX
INDEX
Page 8
Release Date: 4/30/79
Update: #24
device numbers 6.4.3.5.2
programs 5.3.3, 5.5.3, 5.5.4,
5.5.5.2, 6.4.3
Frequency distribution 5.3.1.1,
5.5.5.1
FULL 6.4.2.3
Function 1.1, 2.2, 7.1
Gap 5.5.5.1
Gap test 5.5.5, 6.4.3.1, 6.4.3.2
Generated load module 5.2.1,
5.2.2.1
name 5.2.2.2
Generated retrieval program 5.2.1,
5.2.2.1, 5.7.1
Geographic location 6.4.3.1
Geometric mean 4.2.2.6, 5.3.1.1,
5.3.3.1
Geometric standard deviation
4.2.2.6, 5.3.1.1, 5.3.3.1
Hardware 1.2
Header record 5.5.3.1, 5.5.4.1
Hourly data 5.5.5.1, 5.5.5.2,
6.2.3.1, 6.4.3
IDENT-KEY 5.2.2.2
IEBUPDTE 8.2.3.1
IEHMOVE 8.3.6
In-line delimiter 8.1.5
Integer 5.5.5.1
Internal consistency 5.5.5.1
Internal transactions 1.2, 4.5.1,
4.5.2, 4.5.3. See also Master
file transactions
Interval size. See SIiding average
Installation 1.2, 8.1.2, 8.1.6,
8.2.2.2
of a system 1.2, 8.3
of an update 8.2.3
Installation deck 8.3.2
Inventory by pollutant 6.4.5, 7.2.4
Inventory by site 6.4.4
JCL 1.2, 8.1. See also Cataloged
procedures
Job 1.2, 8.1.2
JOB 8.1.1
card 8.1.2, 8.2.3.2, 8.3.3
KEEP 8.1.4
846
-------
AQDHS-II
INDEX
INDEX
Page 9
Release Date: 4/30/79
Update: # 24
Key 1.2
converted files 5.5.3.1,
5.5.6.1, 5.5.6.2, 5.5.6.6
master file record 4.5.3.2,
5.4.2.6, 5.5.3.1, 5.6.2.1,
5.6.2.2, 6.4.3.2
master file transaction 4.5.1.2
parameter file record 4.2.2.1,
4.2.2.2, 5.3.1.1, 5.3.2.3,
5.3.3.3, 5.5.5.2, 6.2.4.2,
6.4.2.1
parameter file transaction
4.2.2.1, 4.2.2.6
parameter standards file record
4.4.2.1, 4.4.2.6
parameter standards file
transaction 4.4.2.1, 4.4.2.6
site file record 4.3.2.1,
4.3.2.2, 5.3.1.1, 5.3.2.3,
5.3.3.3, 5.5.5.2, 6.4.2.1
site file transaction 4.3.2.1
KEY-1 5.2.2.2
KEY-l-A 5.2.2.2
KEY-2 5.2.2.2
KEY-3 5.2.2.2
Keyword 6.2.3.3, 6.4.8.1,
5.2.2.2, 8.1.1
LABEL 8.1.4
Language keyword 5.2.2.2
Leading zeroes 4.2.2.2
Less-than-daily data 4.5.1.1,
4.5.3.6, 5.5.5.1, 6.2.3.1
Library 1.2, 8.1.6
external 5.2.2.1
load 8.2.3.1, 8.3.2, 8.3.9
procedure 8.1.6, 8.2.3.1, 8.3.2,
8.3.5, 8.3.9
source 5.2.2.2, 8.2.3.1, 8.2.3.2,
8.3.2, 8.3.6, 8.3.9
system 8.1.6
test 8.3.1, 8.3.7
Line-maximum option 6.4.2.3
Link edit 1.2, 5.3.1.2, 5.7.1,
8.2.2.1, 8.2.3.1, 8.2.4
Linkage editor 5.3.1.2, 8.3.6
LIST 3.1, 4.2.2.3, 4.5.1.3,
4.5.3.3, 5.2.2.2, 5.3.1.2,
5.5.2.3
List option 5.2.2.2
LISTNEW 4.5.3.3
LISTOLD 4.5.3.3
LISTTRAN 4.5.3.3
Literal 5.2.2.2
Load module 1.2, 5.2.1, 5.2.2.5.4,
5.2.3, 5.3.1.2, 5.7.1
Load sheets 4.5.1.1, 5.5.2.1,
5.5.2.2, Appendix D
Logical record 4.5.1.1
Low Shewhart 6.4.3.3
Lower control limits (LCL)
6.4.3.1, 6.4.3.3
847
-------
AQDHS-II
INDEX
INDEX
Page 10
Release Date: 4/30/79
Update: # 24
LRECL 8.1.4
Machine-dependent 6.4.3.5.2
Master file 1.2
archival and merging 5.4
conversion 5.5.3, 5.5.5, 5.5.6,
6.3.2
creation and maintenance 4.1,
4.5.1.1, 4.5.2.1, 4.5.3, 4.6.1,
5.5.2.1, 5.5.5.6, 6.4.3.2,
7.2.10
field descriptions 4.5.3.2,
4.5.1.1
format 4.5.3.2
record-key 4.5.3.2, 5.4.2.6,
5.5.3.1, 5.6.2.1, 5.6.2.2,
6.4.3.2
reports 6.0
retrieval 5.2
sort sequence 4.5.2.1,
5.6.2. See also Sorting
statistical analysis 5.3
Master file transactions 4.5.1,
4.5.2, 4.5.3, 5.5.2, 5.5.5.6,
6.4.3.2
field descriptions 4.5.1.2
format 4.5.1.1, 4.5.1.2
key 4.5.1.2
sort sequences 4.1, 4.5.2
Maximum absolute difference 6.4.3.1
Maximum difference 6.4.3.1
Maximum number of lines per page
5.3.1.1, 6.2.2.3, 6.4.2.3, 6.4.8.3
Maximum observation 5.3.1.1, 6.4.5.1,
6.4.5.2
Maximum percentage difference
6.4.3.1
Maximum reading 6.2.3.3, 6.4.4.2
Maximum value test 6.4.3.1, 6.4.3.2
Maximum values 4.5.1.1, 6.4.3.1
Mean 5.2.2.2.2, 5.3.1.1, 5.3.3.1,
6.2.3.3, 6.4.3.1, 6.4.4.2
MEAN 6.2.3.1, 6.2.3.3
Merging files 5.4.2, 6.4.7, 7.2.4
Method code 1.2, 4.2.1.1, 4.2.2.2,
4.4.1.1, 4.5.1.1, 4.5.1.2, 4.5.2.1,
4.5.3.2, 5.5.2.2
METHOD-CODE 5.2.2.2
Minimum detectable 4.2.2.2, 4.2.2.4,
4.2.2.6, 5.3.1.1, 5.3.3.1,
5.5.4.1, 6.4.7.2, 6.4.7.6
decimal code 4.2.2.2
Minimum reading 6.4.4.2
Mode keyword 5.2.2.2, 5.3.4.1,
5.3.4.2
Modifications
program 4.5.1.6, 5.3.2.6, 6.4.7.6,
6.4.8.6, 8.2.3.1, 8.2.7, 8.3.4,
8.3.9, Appendix C
Modified Dixon ratio test. See
Dixon ratio test
Module 1.2, 2.1, 8.2.3.1, 8.7.3.2.
See also Library
Monitoring 6.4.7.6
848
-------
AQDHS-II
INDEX
INDEX
Page 11
Release Date: 4/30/79
Update: # 24
Month 1.2, 4.5.1.1, 4.5.1.2,
4.5.2.1, 4.5.3.2, 5.5.2.2
MONTH 5.3.2, 5.2.2.2
Monthly data 6.2.3.1
MSGLEVEL 8.1.2
N 5.2.2.2.1
NADB 2.1, 6.4.8.6, 8.2.2.2, 8.2.3,
8.2.4, 8.2.7, 8.3.2, 8.3.4, 8.3.9
NA067 6.3.2.1, 6.3.2.6
Natural logarithm 5.3.3.1
NBR-OF-READINGS 5.2.2.2, 5.2.2.2.2
Negation flag 5.2.2.2.1, 6.2.3.3
Negative values 4.2.2.4, 4.5.1.1,
5.3.3.1
NEW 8.1.4
Nitrogen dioxide 5.5.5.1
NO FLAG LOW 6.4.3.3
No low Shewhart 6.4.3.3
NOFLAGW 3.1, 4.5.1.3, 4.5.1.7
NOLIST 3.1, 4.5.1.3, 4.5.1.7,
4.5.3.3, 5.2.2.2, 5.5.2.3,
5.5.2.7
Nominal values 5.5.5.2, 5.5.5.3
Normalized frequency distribution
5.3.1.1
Non-IEBUPDTE updates 8.2.3.3
NOT 5.2.2.2.1
Null values 4.5.3.2, 4.5.3.6,
6.2.3.3, 6.3.2.1
Null-value reading 1.2, 4.5.3.1,
5.2.2.6, 5.5.5.2
Number of readings 4.5.1.2,
4.5.3.2, 6.2.3.3
Object module 1.2
Object name 5.2.2.2.1
OLD 8.1.4
Option card 1.2, 8.1.4
Option date 5.4.3.3, 5.4.3.6,
6.3.2.3
Options. See also the Options
section for each program
default 4.2.2.4, 4.5.1.7,
6.2.3.1, 6.2.3.6
OR 5.2.2.2.1
Overrides 8.1.4
Ozone 5.5.5.1, 6.4.3.1
Parameter 1.2, 4.1, 4.2.2.2,
4.5.3.2, 6.4.1.4, 6.4.6,
anomaly screening 5.5.5.1, 6.4.1.2,
849
-------
INDEX
INDEX
Page 12
Release Date: 4/30/79
Update: #. 24
6.4.3.1
description 4.2.2.2
maximum values 4.5.1.1
negative values 4.5.1.1
Parameter code 1.2, 4.2.1.1,
4.2.2.1, 4.2.2.2, 4.4.1.1,
4.4.2.1, 4.4.2.2, 4.4.2.6,
4.5.1.1, 4.5.1.2, 4.5.2.1,
4.5.3.2, 5.5.2.2
Parameter file 1.2, 4.1,
4.5.1.6, 5.5.5.6
conversion 5.5.4
creation and maintenance
4.1.1, 4.2.1.1, 4.2.2
format 4.2.2.2
record key 4.2.2.1, 4.2.2.2,
5.3.1.1, 5.3.2.3, 6.4.2.1
reports 6.2.1, 6.2.4, 6.4.1.5,
6.4.7
transactions 4.1.1, 4.2.1,
4.2.2.1, 4.2.2.5
uses of 4.1.4, 4.5.1.2,
5.3.2.2, 5.5.6, 6.2.3,
6.4.1.3, 6.4.4
Parameter standards. See Standards
Parameter standards file 1.2, 4.1
creation and maintenance 4.1.3,
4.4.1.1, 4.4.2
format 4.4.2.1, 4.4.2.2
record key 4.4.2.1, 4.4.2.2
reports 6.2.1, 6.2.5
transactions 4.1.3, 4.4.1,
4.4.2.1, 4.4.2.2, 4.4.2.5,
4.4.2.6
uses of 6.2.3
PARAMETER-CODE 5.2.2.2
Parenthetical expressions
5.2.2.2.1
PARM 5.6.2.3, 6.4.5.2
Partitioned data set 1.2, 8.2.3.1
PASS 8.1.4
Pattern tests 6.4.3.1. See also
entries for individual test names
Percentage 6.4.3.1
Percentage difference 6.4.3.1
Percentiles 5.3.1.1, 5.3.3.1, 5.5.5.]
Permanent file 1.2
Physical record 4.5.1.1
Pollutant. See Parameter
Preliminary statistics file 5.3.2.2,
5.3.3.2
Primary standard 4.4.2.2
units code 4.4.2.2
Print characters 4.5.3.2
Print file 6.4.3.6
Probability 5.5.5.1
Procedure 1.2. See also Cataloged
procedure
Program 1.2
structure 2.1, 2.2
Project
code 1.2, 4.3.1.1, 4.3.2.2, 4.5.1.1,
850
-------
AQDHS-II
INDEX
INDEX
Page 13
Release Date: 4/30/79
Update: # 24
4.5.1.2, 4.5.2.1, 4.5.3.2,
5.5.2.2, 6.4.8.1
PROJECT 5.2.2.2
PRTY 8.1.2
QUARTER 5.3.2
Quarterly data 6.2.3.1
Range 6.4.3.1, 6.4.6.1
Ratio 6.4.3.1
Raw data 6.4.3.2
file 5.3.2.2, 5.3.3.2
Reading 1.2, 4.5.1.1, 4.5.1.2,
4.5.3.2, 5.5.2.2, 6.4.3.2
adding 4.5.3.1, 4.5.3.6
changing 4.5.3.1, 4.5.3.6,
6.4.3.2, 6.4.3.6
deleting 4.5.3.1, 4.5.3.6, 6.4.3.6
screening. See Anomaly screening
Reading status flag 1.2, 4.5.3.2
changing 5.2.2.2.2, 5.5.5.6,
6.3.2.1, 6.4.3.6
setting 4.5.3.1, 4.5.3.2, 5.5.5.2,
6.4.3.3
RECFM 8.1.4
Record
adding 4.2.2.1, 4.3.2.1, 4.4.2.1,
4.5.3.1, 4.5.3.6, 6.3.2.1,
6.4.7.1, 6.4.7.2
changing 4.2.2.1, 4.3.2.1, 4.4.2.1,
4.5.3.1, 4.5.3.6, 5.2.2.2.2,
5.2.2.6, 5.5.5.6, 6.3.2.1
deleting 4.2.2.1, 4.3.2.1,
4.4.2.1., 4.5.3.6, 6.3.2.1
Record
length 8.1.4
sequence 5.5.3.1
Record submission status flag 1.2,
4.5.2.1, 4.5.3.2
changing 5.2.2.2.2, 5.5.5.6,
6.3.2.1, 6.4.3.6
setting 4.5.3.1, 4.5.3.2,
5.5.5.2, 6.4.3.3
RECORD-QUALIFIES-SW 5.2.2.2.2
RECORD-STATUS-FLAG 5.2.2.2
Relational operator 5.2.2.2.1,
6.2.3.3
Relative position 4.5.3.6
Repeating section 1.2, 4.5.3.6
data names 5.2.2.2
Reports 5.2.2.2.3, 5.3, 5.5.5.1,
5.5.6, 5.6.2.1, 6.0. See also
File listings; EPA reports;
Summary reports
Reserved area 4.5.1.2, 4.5.3.2
Retrieval 5.2
AQDHS-II 5.2.2.2.1, 5.2.2.2.3
batched 5.2.2.2.3, 5.6.2.1,
7.2.7
COBOL 5.2.2.2.2
control cards for 5.2.2
examples of 5.2.2.2.1, 5.2.2.2.2,
5.2.2.2.3, 5.3.4.1, 7.2
851
-------
AQDHS-II
INDEX
INDEX
Page 14
Release Date: 4/30/79
Update: i 24
options for 5.2.2.3
procedures 5.2.2.5, 5.2.3.5,
5.7.1
skeleton program 5.2.2
sliding. See Sliding average,
retrievals
specifications 5.2.1, 5.2.2,
5.3.1.2
uses of 3.1, 5.3.1.1, 5.3.4,
6.2.3.6, 6.4.3.2, 7.2
valid data names for 5.2.2.2
Revision level 8.2.2.1
RISE 8.1.4
RPTING-SECTION 5.2.2.2
Run stream 1.2, 7.0, 8.1, 8.2.3.2.
See also the Sample Run Stream
section for each program
Sampling interval 4.5.3.2,
5.3.1.2, 5.5.5.2, 6.4.2.2
SAROAD 1.2
add file 6.3.2.2, 6.3.2.6
change file 6.3.2.1, 6.3.2.2,
6.3.2.6
conversion 5.5.2, 6.3.2
editor 6.3.2.1, 6.3.2.2, 6.3.2.6
sliding average reports 5.3.1.2,
5.3.4.1
statistical analysis report 5.3.1.1
submissions 4.5.3.1, 4.5.3.2,
4.5.3.6, 5.5.5.2
time code 4.5.1.1, Appendix A
transactions 4.1, 5.2.2.2.2, 5.5.2,
6.3.2
Screening. See Anomaly screening
Secondary standard 4.4.2.2
units code 4.4.2.2
Sequence. See also Collating
sequence; Sort
of AQDHS-II transactions 4.5.1.1
of internal transactions 4.5.2.1,
4.5.2.2
of master file 4.5.2.2, 5.4.2.1,
5.5.6.2, 5.5.6.5, 5.6.2, 6.4.4.2,
6.4.5.2, 6.4.6.6
of parameter file 4.2.1.2
of parameter file transactions
4.2.1.1, 4.2.1.2
of parameter standards file
4.4.1.2, 4.4.2.2, 6.2.5.2
of parameter standards file
transactions 4.4.1.1, 4.4.1.2,
4.4.2.2, 4.4.2.6
of site file 4.3.1.2, 4.3.2.6,
6.2.6.1, 6.4.8.6
of site file transactions 4.3.1.1,
4.3.1.2, 4.3.2.1
Sequence number 5.2.2.2
Shewhart test 5.5.5.2, 5.5.5.3,
6.4.3.1, 6.4.3.2, 6.4.3.3
coefficients 6.4.3.1
SHR 8.1.4
Signed data 5.5.4.1
Site 4.1, 4.3.2.1, 4.5.3.2,
6.4.1.4, 6.4.6
code 1.2, 4.3.1.1, 4.3.2.1,
4.3.2.2, 4.5.1.1, 4.5.1.2,
4.5.2.1, 4.5.3.2, 5.5.2.2
description 4.3.2.2
Site file 1.2
creation and maintenance 4.1.2,
852
-------
AQDHS-II
INDEX
INDEX
Page 15
Release*Date: 4/30/79
Update; # 24
4.3.1.1, 4.3.2
format 4.3.2.2
record key 4.3.2.1, 4.3.2.2,
5.3.1.1, 5.3.2.3, 6.4.2.1
reports 6.2.1, 6.2.5, 6.4.1.5,
6.4.8
transactions 4.1.2, 4.3.1,
4.3.2.1, 4.3.2.2, 4.3.2.5
uses of 4.1.4, 4.5.1.2, 6.2.3,
6.4.1.3, 6.4.5
SITE 5.2.2.2, 5.6.2.3, 6.4.4.2
Skeleton program 5.2.2
Skeleton transactions 5.5.5.6,
6.4.3.2, 6.4.7.1, 6.4.7.6, 6.4.8.1
6.4.8.2
SLAMS/NAMS ID 5.2.2.2
master file 4.5.1.2, 4.5.3.2,
5.5.3.2
site file 4.3.2.2, 6.4.8.1,
6.4.8.2
SLIDING 5.2.2.2, 5.3.1.2, 5.3.4.1
Sliding average
answer file 1.2, 5.3.4, 6.2.3.1
interval size 5.3.1.2, 5.3.4.1,
5.3.4.2, 5.3.4.3, 5.3.4.6
minimum number of readings
requirements 5.3.4.1, 5.3.4.3
report 5.3.1.2, 5.3.4.1, 6.2.3,
7.2.6
retrievals 5.2.2.1, 5.3.4.1,
5.3.4.6, 7.2.6
values 5.3.4.1, 6.2.3.3
values file 1.2, 5.3.1.2,
5.3.4.2, 6.2.3.3
Software 1.2
Sort. See also Collating sequence;
Sequence
answer files 5.2.2.2.3, 5.3.1.1,
5.3.2.2, 5.3.2.6, 5.6.2, 6.4.2.6,
6.4.6.6, 7.2.9
converted files 5.5.6.1, 5.5.6.2
master file 5.3.1.1, 5.3.2.2,
5.3.2.6, 5.6.2, 6.4.2.6, 6.4.4.2,
6.4.5.2, 6.4.5.6, 6.4.6.6
master file transactions 4.1.4,
4.5.1.2, 4.5.2
parameter file transactions 4.1.1,
4.2.1, 4.2.2.1
parameter standards file transactions
4.1.3, 4.4.1, 4.4.2
site file transactions 4.1.1, 4.3.1,
4.3.2.1, 4.3.2.6
sort messages 4.2.1.6, 4.3.1.6,
4.4.1.6, 4.5.2.6, 5.6.2.6'
Source module 1.2, 5.3.1.2, 6.4.8.6,
8.2.3.2
Space 1.2, 8.1.4, 8.3.2
SPACE 8.1.4
Spike 6.4.3.1
test 6.4.3.1, 6.4.3.2
Standard. See also Primary standard;
Secondary standard
description 4.4.2.2
flag 4.4.2.2
number 4.4.2.2, 6.2.5.1
type 4.4.2.2
Standard answer file 1.2, 6.2.3.1
Standard deviation 5.3.1.1, 5.3.3.1,
6.4.3.1
Standard report 6.2.3.1, 6.2.3.3
853
-------
AqDHS-II
INDEX
INDEX
Page 16
Release Date: 4/30/79
Update: #. 24
Standard units 5.5.5.2, 5.5.5.6,
5.5.6, 6.4.3.6
code 4.2.2.2, 4.2.2.6, 5.5.5.4,
6.4.7.2, 6.4.7.6
conversion factor 4.2.2.2, 4.2.2.6,
5.5.5.4, 5.5.5.6, 5.5.6, 6.4.3.6,
6.4.7.2, 6.4.7.6
Standards 5.3.1.2, 5.5.5.6, 5.5.6.1,
6.2.5
federal 4.1, 4.4.2
state 4.1, 4.4.2
Start hour 4.5.1, 4.5.3.2, 5.5.2.2,
5.5.3.2, 5.6.2.2, 6.4.3.2
START-HOUR 5.2.2.2
STAT 5.3.1.1, 5.3.2.2, 5.3.2.6,
5.6.2.3, 6.4.2.5.4
State code 1.2, 4.3.1.1, 4.3.2.2,
4.5.1.1, 4.5.1.2, 4.5.2.1, 4.5.3.2,
5.5.2.2
master file 4.5.1, 4.5.3.2, 5.5.2.2,
5.5.3.2, 5.6.2.2, 6.4.3.2, 6.4.8.1,
6.4.8.2
parameter standards file 6.2.5.1
site file 4.3.2, 6.4.8.1, 6.4.8.2
STATE 5.2.2.2
Statistical analysis 5.3, 5.5.4.1,
5.5.4.8, 6.4.2, 7.2.7, 7.2.9. See
also Sliding average; Statistics
Statistical screening tests. See
Anomaly screening tests
Statistics 5.3.2, 5.3.3, 5.5.5.2, 6.4.2,
6.4.3.1, 6.4.4.2
file 5.3.3.2, 6.4.2.2
Status flag. See Reading status
flag; Record submission status
flag; Transaction status flag
STATUS-FLAG 5.2.2.2
STD 5.5.6.2, 5.5.6.3
STND 5.6.2.3
Stratification 6.4.3.1
Structured programming 2.2
SUB 5.2.2.2.2
Subject name 5.2.2.2.1
Substitutable parameters 1.2,
6.2.3.6, 8.1.3. See also the
Cataloged JCL section for each
program
Sulfur dioxide 5.5.5.1, 6.4.3.1
Sum 6.2.3.3
SUM 6.2.3.1, 6.2.3.3
Summary option 6.2.3.1, 6.2.3.3
Summary reports 6.4
Summary statistics. See the File
Formats section for each program.
SYSOUT 8.1.4
Systems personnel 1.2, 8.1
TALLY 5.2.2.2.2
854
-------
AlJUHb-II
INDEX
INDEX
Page 17
Release Date: 4/30/79
Update: #. 24
Tape 1.2, 8.1.4
Temporary files 1.2, 5.3.1.1,
5.3.2.2, 5.3.3.2, 5.5.5.2,
5.5.5.3, 6.4.2.2, 6.4.2.6,
6*4.3.2
Test values 6.4.3.1
Testing 8.2.5, 8.3.7
TIME 8.1.2
Time code 1.2, 4.5.1.1, 4.5.1.2,
4.5.2.1, 4.5.3.2, 4.5.3.6,
5.3.4.1, 5.3.4.3, 5.3.4.6,
5.5.2.2, 5.5.2.6, 6.2.3.1,
6.4.4.1, 6.4.5.1, Appendix A
Time estimates 4.2.1.7, 4.2.2.7,
4.3.1.7
Time period 6.4.2.1, 6.4.2.2
TIME-CODE 5.2.2.2
Threshold value 6.2.3.3
TOTAL 5.3.2
Total oxidants 5.5.5.1, 6.4.3.1
Total suspended particulate
5.5.5.1, 6.4.3.1
Total-time-period 6.4.2.2
Track 1.2, 8.1.4
Trailer record 5.5.3.1, 5.5.4.1
Trailing zeroes 4.2.2.2
Transactions 1.2. See also Skeleton
transactions; Master file
transactions; Parameter file
transactions; Site file
transactions; Parameter
standards file transactions
format. See the File Formats
sections for each program
Transaction status flag 4.5.1.1,
4.5.1.2, 5.5.2.2
TRK 8.1.4
Troubleshooting 2.1, 8.2.2.1, 8.2.3
Truncated 5.3.1.1
Truth value 5.2.2.2.1
UNCATLG 8.1.4
Unit 1.2, 8.1.4
UNIT 8.1.4
UNIT-CODE 5.2.2.2
Units 5.5.6, 6.4.2.2. See also
Standard units; User units
code 4.2.1.1, 4.2.2.2, 4.4.1.1,
4.4.2.2, 4.5.1.1, 4.5.1.2,
4.5.2.1, 4.5.3.2, 5.5.2.2,
6.4.7
conversion 5.5.6, 5.5.5.6,
7.2.5
description 4.2.2.2
Update
deck 8.2.3.1, 8.2.3.2
message 1.2, 8.2.2.1, 8.2.7. See
also the File Formats section for
each program
855
-------
AQDHS-II
INDEX
INDEX
Page 18
Release Date: 4/30/79
Update: # 24
number 8.2.2.1
package 8.2.2.2
status 8.2.2.1
Updates 8.1.6, 8.2, 8.3.4
Upper control limits (UCL)
6.4.3.1, 6.4.3.3
Upper limit 6.4.3.1
USER 5.2.2.2, 5.5.6.2, 5.5.6.3
User units 5.5.6
code 4.2.2.2, 4.2.2.6
conversion factor 4.2.2.2,
4.2.2.6, 5.5.5.6
USER-DATA-STRUCTURE 5.2.2.2
User-defined data member name
5.2.2.2
User-defined subroutine member
5.2.2.2
Working master file 5.4.3.1,
5.4.3.8
Wraparound 5.3.4.1
Year 1.2, 4.5.1.1, 4.5.1.2,
4.5.2.1, 4.5.3.2, 5.5.2.2,
6.4.4.1, 6.4.5.1
YEAR 5.3.2, 5.2.2.2
Variable-length records 4.5.3.2,
4.5.3.6, 5.5.3.1, 8.1.4
Verifying data 6.4.3.2, 6.4.3.6
VOL 8.1.4
Volume 1.2, 8.1.4, 8.3.2
Warning message 1.2, 4.2.2.4, 4.2.2.6,
4.5.3.2, 4.5.3.3, 8.3.6, Appendix B
Weekly data 6.2.3.1
856
-------
AQDHS-II
REFERENCES
Page 1
Release Date: 4/30/79
Update: # 24
REFERENCES
AEROS Manual Series. Volume V: AEROS Manual of Codes. Publication No.
EPA-450/2-76-005 (OAQPS No. 1.2-042).Research Triangle Park, North Carolina:
U.S. Environmental Protection Agency, April 1976.
Air Quality Data Handling System (AQDHS-II): Test Run Series Documentation.
Prepared for U.S. Environmental Protection Agency Contract No. 68-02-3011.
Research Triangle Park, North Carolina: Research Triangle Institute, April
30, 1979.
Grant, Eugene L. Statistical Quality Control. 3rd edition. New York:
McGraw-Hill Book Company, n.d., p.562.
Quality Assurance Handbook for Air Pollution Measurement Systems. Volumes I
and II.Publication No. EPA-600/9-76-005.Research Triangle Park, North
Carolina: U.S. Environmental Protection Agency, March 1976.
857
-------
TECHNICAL REPORT DATA
(Please read Instructions on the reverse before completing)
i. REPORT NO.
EPA 45Q/4-79-QQ9
2.
3. RECIPIENT'S ACCESSIOf*NO.
4. TITLE AND SUBTITLE
6. REPORT DATE
May 1979
6. PERFORMING ORGANIZATION CODE
Air Quality Data Handling System User's Guide
7. AUTHOR(S)
The Research Triangle Institute
Operations Analysis Division, Research Triangle Park,
8. PERFORMING ORGANIZATION REPORT NO.
NC. 27709
9. PERFORMING ORGANIZATION NAME AND ADDRESS
Office of Air Quality Planning and Standards
Monitoring and Data Analysis Division
Research Triangle Park, North Carolina 27711
10. PROGRAM ELEMENT NO.
Ft
11. CO
ACT/GRANT NO.
68-0.2-30.11
12. SPONSORING AGENCY'NAME AND ADDRESS
U.S. Environmental Protection^Agency
Office of Air, Noise, and Radiation
Office of Air Quality Planning and Standards
Rpsparrh Triannlp Park, North Tarn'Mna P7711
16. SUPPLEMENTARY NOTES
13. TYPE OF REPORT AND PERIOD COVERED
Final
14. SPONSORING AGENCY CODE
16. ABSTRACT
When dealing with atmospheric pollution, it is necessary to amass, catalog,
sort, evaluate and perform calculations upon large volumes of data. The Air
Quality Data Handling System (AQDHS-II) provides air pollution control agencies
with the capability to create and maintain their own air quality data bases and
to retrieve data and generate reports from those data bases. This report contains
step by step procedures for the operation of each program in the system. Each
program has sections containing a description, file formats, options, error
messages, catalogued JCL (IBM), warnings and special instructions, cost considera-
tions, and related programs and procedures. The report is structured along
system functional lines; I.e., file creation and maintenance, data accessing and
manipulation, and reports. There is also a section dealing with inter-functional
procedures and one which deals with JCL and general topics. The AQDHS-II is
compatible with SAROAD and will automatically handle EPA reporting requirements.
17.
KEY WORDS AND DOCUMENT ANALYSIS
DESCRIPTORS
b.lDENTIFIERS/OPEN ENDED TERMS
c. COSATI Field/Group
Computer Programs
Computer Software
Data Processing
Air Pollution
Data Handling
Computer System Programs
Data Base Management System
/* oc c T nfi
CDHS
AQDHS-II
SAROAD
Atmospheric Pollution
18. DTSTRI
19. SECURITY CLASS (ThisReport)
Unclassified
21. NO. OF PAGES
857
llnlimitpd
20. SECURITY CLASS (Thispage)
Unclassified
22. PRICE
EPA Form 2220-J_($.7_ai
. GOVERNMENT PRINTING OFFICE: 19 79 -6UO-013' 3901 REGION NO. 4
-------
United States
Environmental Protection
Agency
Office of Air, Noise, and Radiation
Office of Air Quality Planning and Standards
Research Triangle Park NC 27711
Official Business
Penalty for Private Use
$300
Publication No. EPA-46O/4-79-O09
Postage and
Fees Paid
Environmental
Protection
It your address is incorrect, please change on the above label;
tear off; and return to the above address.
if you do not desire to continue receiving this technical report
series, CHECK HERE D ; tear off label; and return it to the
above address.
------- |