Basic Data Management
Environment: 90/25, 30. 30B. 40 Systems
H UI\JIVAC
UP 8068 Rev 4PUBLICATIONS LiPDATE
Operating System/3 (OS/3) Consolidated Data
Management User Guide
UP$068 Rev 4-D This Library Memo announces the release and availability of Updating Package D to “SPERRY Operating System/3 (OS/3) Basic Data Management User Guide”, UP-8068 Rev. 4.
This 8. 1 release update documents a correction applicable to a feature present in basic data management prior to the 8. 1 release,
Copies of Updating Package D are now available for requisitioning. Either the updating package only or the complete manual with the updating package may be requisitioned by your local Sperry representative. To receive only the updating package, order UP-8068 Rev. 4—D. To receive the complete manual, order UP-8068 Rev. 4.
Mailing Lists Mailing Lists AOO, AOl, 18, 18U, 19, 19U, 20, 20U; Library Memo for
BZ, CZ and MZ 21, 21U, 75, 75U, 76 and 76U UP-8068 Rev. 4—D
(Package D to UP-8068 Rev. 4, 7 pages plus Memo>
June, 1983
UD1-25Rei. 3
PUBLICATIONS
• UPDATE
Operating System/3 (OS/3) Basic Data Management User Guide
UP—8068 Rev. 4—C
This Library Memo announces the release and availability of Updating Package C to ‘SPERRY UNIVAC Operating System/3 (OS/3) Basic Data Management User Guide”, UP—8068 Rev, 4.
This update documents the following new information on the basic data management file lock feature for the 8.0 release:
How to avoid unnecessary locking out of files Additional information on file shareability
All other changes are corrections or expanded descriptions applicable to features present in basic data management prior to the 8.0 release.
Copies of Updating Package C are now available for requisitioning. Either the updating package only or the complete manual with the updating package may be requisitioned by your local Sperry Univac representative, To receive only the updating package, order UP—8068 Rev. 4—C. To receive the complete manual, order UP—8068 Rev. 4.
Mailing Lists BZ, CZ and MZ
Mailing Lists A00,A01,18,18U,19, Library Memo for 19U,20,20U,21,21U,75,75U,76 and UP—8068 Rev. 4—C 76U
(Package C to UP—8068 Rev. 4, 32 pages plus Memo)
February, 1983
,Di 2 pc• ,?3
N I
PUBLICATIONS UPDATE
Operating System/3 (OS/3) Basic Data Management User Guide
UP4068
Re
4-BThis Library Memo announces the release and availability of Updating Package B to “SPERRY UNIVAC Operating System/3 (0S13)Basic Data Management User Guide”, UP-8068 Rev. 4.
This update for the 8.0 release indicates the availability of a new conversion routine for basic data management. This routine is the OS/3 Sequential DTF Mode to CDI Mode Converter (DTFCDI3O1). This converter processes a basic data management BAL source program module and produces a consolidated data management source module that, with minimal modification, can be used in the consolidated data management environment.
All other changes are corrections or expanded descriptions applicable to features present in basic data management prior ot the 8.0 release.
Copies of Updating Package B are now available for requisitioning. Either the updating package only or the complete manual with the updating package may be requisitioned by your local Sperry Univac representative. To receive only the updating package, order UP-8068 Rev. 4—B. To receive the complete manual, order UP-8068 Rev. 4.
Mailing ListsBZ, Mailing Lists A00, AOl, 18, 18U, 19, 19U, 20, 20U, Library Memo for
CZand MZ 21, 21U, 75, 75U, 76, and 76U UP.8068 Rev. 4—B
(Package B to UP-8068 Rev. 4, 29 pages plus Memo)
September, 1982
uDi 251 1e J73
PuBLICATIONS UPDATE
Operating System/3 (OS/3) Basic Data Management User Guide
UP-8068 Rev. 4-A
This Library Memo announces the release and availability of Updating Package A to “SPERRY UNIVAC Operating System/3 (OS/3) Basic Data Management User Guide”, UP-8068 Rev. 4.
This update documents the following new basic data management features for the 7.0 release:
Consolidated Data Management migration considerations New information on the file lock feature
All other changes are corrections or expanded descriptions applicable to features present in basic data management prior to the 7.0 release.
Copies of the Updating Package A are now available for requisitioning. Either the updating package only or the complete manual with the updating package may be requisitioned by your local Sperry Univac representative. To receive only the updating package, order UP-8068 Rev. 4-A. To receive the complete manual, order UP-8068 Rev. 4.
Mailing Lists Mailing Lists 18, 18U, 19, 19U, 20, 20U, 21, Library Memo for
BZ, CZ and MZ 21U, 75, 75U, 76 and 76U UP-8068 Rev. 4-A
(Package A to UP-8068 Rev. 4, 38 pages plus Memo)
December, 1981
SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
PSS 1 Update D
All the technical changes are denoted by an arrow(-0.-)in the margin. A down ward pointing arrow( ‘Inext to a line indicates that technical changes begin at this line and continue until an upward pointing arrow( 41is found. A horizontal arrow(-0-)pointing to a line indicates a technical change in only that line. A horizontal arrow located between two consecutive lines indicates technical changes in both lines or deletions.
UP-8068 Rev. 4
PAGE STATUS SUMMARY
ISSUE: Update D — UP-8068 Rev.4
RELEASE LEVEL: 8.1 Forward
PSS 1 D
Page Update
Part/Section Page Update
Part/Section Page Update
Part/Section Number Level Number Level Number Level
Cover/Disclaimer Orig. 10 (cont) 16 thru 22 Orig. 16 (cont) 6 thru 14 Orig.
11 PART 5
2 3 thru 7 8 9 l0thru 15 16 17 thru 51
Orig.
A Orig.
A C Orig.
A Orig.
Title Page Orig,
Preface 1 Orig.
2 A
3, 4 Orig.
Contents 1 thru 11 Orig.
12 C
13, 14 Orig.
15 B
16,16a A
17,18 Orig.
19 C
PART 1
Title Page Orig.
1 1 Orig.
2 A
2a A
3 A
4 thru 18 Orig.
PART 2
Title Page Orig.
2 1 thru 4 Orig.
3 1 thru 31 Orig.
4 1 thru 5 Orig.
5 1 thru 12 Orig.
6 1 thru 12 Orig.
7 1 thru 31 Orig.
PART 3
Title Page Orig.
8 1 thru 17 Orig.
9 1 thru 62 Orig.
PART 4
Title Page Orig.
17 1 thru 75 Orig.
PART 6
Title Page Orig.
Appendix A 1 thru 11 Orig.
Appendix B 1 thru 15 Orig.
Appendix C 1 thru 1 1 Orig.
Appendix D 1 thru 32 Orig.
Appendix E 1 thru 26 Orig.
Appendix F 1 A
2,3 B
Index 1, 2 Orig.
3 A
4thru6 B
7 Orig.
8thrul0 C
11 thru 23 Orig.
24 C
25 thru 27 Orig.
User Comment Sheet
12 1 thru 9 Orig.
10 B
11 thru 13 Orig.
13 1 thru 18 Orig.
iSa C
19 thru 29 Orig.
13A 1 Orig.
2 B
3 Orig.
4 B
4a B
5 thru 13 Orig.
135 1 Orig.
2 B
3 thru 5 Orig.
6 D
7 thru 12 Orig.
13 C
14 D
15 thru 17 Orig.
18 B
i9thru2l Orig.
14 1 thru 13 Orig.
15 1 thru 7 Orig.
8,9 C
10 Orig.
11,12 C
13 Orig.
14 C
15,16 Orig.
17 C
18 thru 20 Orig.
21 C
22 thru 1 1 1 Orig.
10 1 thru 7 Orig.
8 A
9,10 Orig.
11,12 A
12a A
13 Orig.
14,15 A
16
2 3 4 4a 5
B Orig.
A B C C
*
0 0 0
1
SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
PSS 1 Update C
All the technicalchangesare denoted by an arrow (*—) in the margin. A downward pointing arrow (
f
) next to a line indicates that technical changes begin at this line and continue until an upward pointing arrow (4)
is found. A horizontal arrow(-0.-)pointing to a line indicates a technical change in only that line. A horizontal arrow located between two consecutive lines indicates technical changes in both lines or deletions.UP-8068 Rev.4
PAGE STATUS SUMMARY ISSUE: Update C— UP-8068 Rev. 4 RELEASE LEVEL:i 8.0 Forward
Cover/Disclaimer Orig.
Part/Section Page Update
Part/Section Page Update Page Update
Part/Section Number Level Number Level
Number Level
PSS 1 C
Preface 1 Orig.
2 A
3,4 Orig.
10(cont) 14,15 A
16 thru 22 Orig.
16(cont) 5 C
6 thru 14 Orig.
PART 5
Contents 1 thru 11 Orig.
12 C
13, 14 Orig.
15 B
16,16a A
17, 18 Orig.
19 C
11 1 Orig.
2 A
3 thru 7 Orig.
8 A
9 C
10 thru 15 Orig.
16 A
17 thru 51 Orig.
Title Page
PART 1
Orig.
12 1 thru 9 Orig.
10 B
11 thru 13 Orig.
Title Page Orig.
13 1 thru 18 Orig.
18a C*
19 thru 29 Orig.
17 1 thru 75 Orig.
PART 6
Title Page Orig.
Appendix A 1 thru 11 Orig.
Appendix B 1 thru 15 Orig.
Appendix C 1 thru 11 Orig.
Appendix D 1 thru 32 Orig.
Appendix E 1 thru 26 Orig.
Appendix F 1 A
2,3 B
Index 1, 2 Orig.
3 A
4thru6 B
7 Orig.
8thrul0 C
11 thru 23 Orig.
24 C
25 thru 27 Orig.
User Comment Sheet
1 1 Orig.
2 A
2a A
3 A
4thru 18 Orig.
PART 2
Title Page Orig.
2 1 thru 4 Orig.
3 1 thru 31 Orig.
4 1 thru 5 Orig.
5 1 thru 12 Orig.
6 1 thru 12 Orig.
7 1 thru 31 Orig.
PART 3
Title Page Orig.
8 1 thru 17 Orig.
9 1 thru 62 Orig.
PART 4
Title Page Orig.
13A 1 Orig.
2 B
3 Orig.
4 B
4a B
Sthru 13 Orig.
13B 1 Orig.
2 B
3 thru 5 Orig.
6 B
7 thru 12 Orig.
13,14 C
15 thru 17 Orig.
18 B
19 thru 21 Orig.
14 1 thru 13 Orig.
15 1 thru 7 Orig.
8,9 C
10 Orig.
11,12 C
13 Orig.
14 C
15,16 Orig.
17 C
l8thru2O Orig.
21 C
22 thru 111 Orig.
3 B
*New pages
10 1 thru 7 Orig.
8 A
9, 10 Orig.
11,12 A
12a A
13 Orig.
16
2 3 4 4a
B Orig.
A B C
SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
PSS 1 Update B
All the technical changes are denoted by an arrow(-b-)in the margin. A downward pointing arrowI ‘)next to a line indicates that technical changes begin at this line and continue until an up ward pointing arrow(
4)
is found. A horizontal arrow(-)pointing to a line indicates a technical change in only that line. A horizontal arrow located between two consecutive lines indicates technical changes in both lines or deletions.UP-8068 Rev. 4
PAGE STATUS SUMMARY ISSUE: Update B— UP-8068 Rev. 4 RELEASE LEVEL: 8.0 Forward
Cover/Disclaimer Orig.
Page Update Page Update Page Update
Part/Section Part/Section
Part/Section Number Level N umber Level Number Level
PSS 1 B
11
Preface 1 Orig.
2 A
3, 4 Orig,
Contents
Appendix F 2
3 thru 7 8 9thru 15 16 17 thru 51
Orig.
A Orig.
A Orig.
A Orig.
2 3
1 thru 11 12 12 13,14 15 16, 16a l7thru 19
A B
Orig.
A Orig.
B A Orig.
1 thru 9 10 11 thru 13
Index 1,2 Orig.
3 A
4thru6 B
7 thru 27 Orig.
13
Orig.
B Orig.
1 thru 29
User Comment Sheet Orig.
PART 1
Title Page Orig.
1 1 Orig.
2 A
2a A
3 A
4thru 18 Orig.
PART 2
Title Page Orig,
13A 1 Orig.
2 B
3 Orig.
4 B
4a B*
5 thru 13 Orig.
13B
2 1 thru 4 Orig.
2 3 thru 5 6 7thru 17 18 l9thru 21
Orig.
B Orig.
B Orig.
B Orig.
3 1 thru 31 Orig. 14 1 thru 13 Orig.
4 1 thru 5 Orig. 15 1 thru 111 Orig.
5 1 thru 12 Orig. 16
2 3 4 5 6thru 14
6 1 thru 12 Orig.
7 1 thru 31 Orig.
PART 3
Title Page Orig.
8 1 thru 17 Orig.
9 1 thru 62 Orig.
PART 4
Title Page Orig.
B Orig.
A B A Orig.
PARTS
Title Page Orig.
17 1 thru 75 Orig.
PART 6
Title Page Orig.
Appendix A 1 thru 1 1 Orig.
Appendix B 1 thru 15 Orig.
Appendix C 1 thru 1 1 Orig.
Appendix D 1 thru 32 Orig.
10 1 thru 7 Orig.
8 A
9,10 Orig.
11,12 A
12a A
13 Orig.
14,15 A
l6thru 22 Orig.
*New pages
Appendix E 1 thru 26 Orig.
UP-8068 Rev, 4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
PSS 1 Update A
PAGE STATUS SUMMARY ISSUE: Update A — UP-8068 Rev, 4 RELEASE LEVEL: 7.0 Forward
Part/Section Page Update Page Update
Part/Section
Number Level Part/Section Page Update
Number Level Number Level
Cover/Disclaimer Orig.
PSS 1 A
11 1 Orig.
2 A
3 thru 7 Orig.
8 A
Preface 1 Orig, 9thru 15 Orig.
2 A 16 A
3, 4 Orig. 17 thru 51 Orig.
Contents 1 thru 1 1 Orig.
12 1 thru 13 Orig.
12 A
13 Orig,
13 1 thru 29 Orig.
15,16 A
16a A*
13A 1 thru 13 Orig.
17 thru 19 Orig.
PART 1 138 1 thru 21 Orig.
Title Page Orig.
14 1 thru 13 Orig.
1 1 Orig.
2 A 15 1 thru 111 Orig.
2a A*
3 A 16 1,2 Orig.
4 thru 18 Orig. 3 thru 5 A
6thru 14 Orig.
PART2
Title Page Orig. PART 5
Title Page Orig.
2 1 thru 4 Orig.
17 1 thru 75 Orig.
3 1 thru 31 Orig.
PART 6
4 1 thru 5 Orig. Title Page Orig.
5 1 thru 12 Orig. Appendix A 1 thru 11 Orig.
6 1 thru 12 Orig. Appendix B 1 thru 15 Orig.
7 1 thru 31 Orig. Appendix C 1 thru 11 Orig.
Title Page
PART 3 Appendix D 1 thru 32 Orig.
Orig.
8 1 thru 17 Orig.
9 1 thru 62 Orig.
PART 4
Title Page Orig.
Appendix E 1 thru 26 Orig.
Appendix F 1,2 A
Index 1,2 Orig.
3 A
4 thru 27 Orig.
User Comment Sheet
10 1 thru 7 Orig.
8 A
9,10 Orig.
11,12 A
12a A*
13 Orig.
14,15 A
16 thru 22 Orig.
*New pages
All the technical changes are denoted by an arrow(-*—)in the margin. A downward pointing arrow( Inext to a line indicates that technical changes begin at this line and continue until an upward pointing arrow(
4
Iis found. A horizontal arrow(-0.’-)pointing to a line indicates a technical change in only that fine. A horizontal arrow located between two consecutive lines indicates technical changes in both lines or deletions,UP-8068 Rev. 4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
PAGE STATUS SUMMARY
PSS 1
All the technical changes are denoted by an arrow(.-)in the margin. A downward pointing arrow (
f
Inext to a line indicates that technical changes begin at this line and continue until an upward pointing arrow(4)
is found. A horizontal arrow(-*)pointing to a line indicates a technical change in only that line. A horizontal arrow located between two consecutive lines indicates technical changes in both lines or deletions.ISSUE: UP-8068 Rev. 4 RELEASE LEVEL: 7.0 Forward
Cover/Disclaime
Page Update Page Update
Part/Section Page Update Part/Section
Part/Section Number Level Number Level Number Level
PART 5
Title Page
17 lthru75
PART 6
Title Page Appendix A 1 thru 1 1 Appendix B 1 thru 15 Appendix C 1 thru 11 Appendix D 1 thru 32 Appendix E 1 thru 26
Index 1 thru 27
User Comment Sheet
PSS 1
Preface 1 thru 4
Contents 1 thru 19 PART1
Title Page
1 lthrul8
PART 2
Title Page
2 lthru4
3 lthru3l
4 lthru5
5 lthrul2
6 lthrul2
7 lthru3l
PART 3
Title Page
8 lthrul7
9 lthru62
PART4
Title Page
10 1 thru 22
11 lthru5l
12 1 thru 13
13 lthru29
13A lthrul3
13B lthru2l
14 1 thru 13
15 1 thru 111
16 1 thru 14
a -1 ci
----I. .. t$
I•••.$.
.-Th
•-.. $I ‘S
C)
UP-8068 Rev. 4 SPERRY UNIVAC OS/3 Preface 1 BASIC DATA MANAGEMENT
Preface
This manual is one of a series designed to instruct and guide the programmer in the use of the SPERRY UNIVAC Operating System/3 (OS/3). This manual specifically describes OS/3 basic data management and its effective use. Its intended audience is the applications programmer with a basic knowledge of data processing, but with limited programming experience, as well as the seasoned applications programmer.
Two other manuals are available that cover OS/3 basic data management; one is an introductory manual and the other is a programmer reference manual (PRM). The introductory manual briefly describes OS/3 basic data management and its facilities. The PRM provides the characteristics of OS/3 basic data management in skeletal form and is intended as a quick-reference document for the programmer experienced in the use of OS/3 basic data management.
For systems with interactive facilities, an additional series of manuals is provided to instruct and guide the programmer in the use of OS/3 consolidated data management.
These are:
s Introduction to consolidated data management, UP-8824
• Consolidated data management concepts and facilities, UP-8825
• Consolidated data management macro language user guide/programmer reference, UP-8826
In general, any further references to the term data management in this user guide imply basic data management.
This user guide is divided into the following parts:
• PART 1. OS/3 DATA MANAGEMENT
Introduces OS/3 data management in terms of what it is and how it is used;
introduces and briefly describes consolidated data management; describes the data management/user interface and the relation of data management to other OS/3 software.
UP-8068 Rev. 4 SPERRY UNIVAC OS/3 Preface
BASIC DATA MANAGEMENT Update A
• PART 2. CARD, DISKETTE, and PRINTER FILES
Describes file and format conventions and the function and operation of OS/3 data management in relation to punched card, diskette, and printer files.
• PART 3. MAGNETIC TAPE FILES
Describes file and format conventions and the function and operation of OS/3 data management in relation to magnetic tape files.
• PART 4. DISK FILES
Describes file and format conventions and function and operation of OS/3 data management as related to disk files. Describes the indexed sequential access method (ISAM) both with and without an index structure, the sequential access method (SAM), the direct access method (DAM), the indexed random access method (IRAM), the multiple indexed random access method (MIRAM), and the nonindexed access
method. Also includes information on disk space management.
• PART 5. PAPER TAPE FILES
Describes record, character, and file conventions and the functions of OS/3 data management for perforated paper tape files.
• PART 6. APPENDIXES
Provide selected functional characteristics of peripheral devices relevant to data management use; explain the OS/3 data management procedures for error and exception handling; compare the EBCDIC/ASCII/Hollerith codes and other card codes used in OS/3; describe the systems standard labels for magnetic tape and disk files;
and describe the consolidated data management migration considerations.
Statement Conventions
The conventions used to delineate the data management macroinstructions are:
• Positional parameters must be written in the order specified in the operand field and must be separated by commas. When a positional parameter is omitted, the comma must be retained to indicate the omission, except for the case of omitted trailing para meters.
Examples:
Assume that CNTRL is a data management macroinstruction with three optional positional parameters: A, B, and C.
TAG1 CNTRL A TAG2 CNTRL A,B TAG3 CNTRL A,B,C TAG4 CNTRL A,,C
UP-8068 Rev 4 SPERRY UNIVAC OS/3 Preface 3 BASIC DATA MANAGEMENT
A keyword parameter consists of a word oracode immediately followed by an equal sign, which is1 in turn, followed by a :specification. Keyword parameters can be written in* any order in the operand field. Commas are required only to separate parameters; however, a comma must neither be coded in column 16 of a continuation line nor follow the last keyword of a string.
Example:
Assume that the data management DTF macro for a card file (called CARDIN) has three keyword parameters: IOAREA1, BLKSIZE, and WORKA.
CARDlN DTFCD IOAREA1=AREA1,BLKSIZE=80;WORKA=YES
• Capital letters, commas, equal signs, and parentheses must be coded exactly as shown. The exceptions are those acronyms that are part of geheric terms representing information to be supplied by the user and the commas preceding keyboard parameters of declarative macroinstructions. (These commas serve to remind the user that keyboard parameters coded in a string ust be separated by commas.)
Examples:
Ft ELDS=([AD DR][,A2TD][,FR EQJ) REOC=(MERGE,label,reel,to) CMceNUMBCHAR=n
X aa (NOV)
m Lowercase letters and words are generic terms representing information that must be supplied bythe user. Such lowercase terms may contain hyphens and acronyms (for readability).
Examples:
name sta rt- addr
number-of-bytes pa ram-i
CCB-name
• Information contained within braces represents mandatory entries of which one must be chosen.
Examples:
ffilename
UP8O68 Rev. 4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
Preface A
I Information contained within brackets represents optional entries that (depending upon program requirements) are Included or omitted Braces within brackets signify that one of the specified entries mustbe chosen if that parameter isto be included.
Examples:
[I NPUT=NO]
[OUTPUT=NO]
I
JworknameL’o
• An optional parameter which has a list of optional entries may have a default specification which is supplied by the operating system when the parameter is not specified by the user. Although the default may be specified by thern user with no adverse effect, it is considered inefficient to do so. For each reference, when a default specification occurs in the format delineation it is printed on a shaded background If by parameter omission, the operating system performs some complex. processing other than parameter insertion it is explained under an if-omitted heading in the parameter description.
Examples:
F,M ERG
L
iNCF
JASCIIL
iEBDUDH• An ellipsis (series of three periods) indicates the omission entries.
Example:
of a variable number of
param-1 param-n
• Commas are required when positional parameters are omitted, parameter specified.
Example:
except after the last
positional parameter 1, positional parameter 2,, positional parameter 4
UP-8068 Rev. 4 SPERRY UNIVAC OS/3 Contents 1 BASIC DATA MANAGEMENT
Contents
PAGE STATUS SUMMARY PREFACE
CONTENTS
PART 1. OS/3 DATA MANAGEMENT 1. INTRODUCTION
1.1. THE FUNCTION OF DATA MANAGEMENT 1-1
1.2. BASIC AND CONSOLIDATED DATA MANAGEMENT 1-1
1.3. DATA STRUCTURE 1-4
1.3.1. Définitión of Terms 1-6
1.3.2. Punched Card Files 1-7
1.3.3. Diskette Files 1—7
1.3.4. Printer Files 1-7
1.3.5. Magnetic Tape Files 1-7
1.3.6. Disk Files 1-8
1.3.7. Paper Tape Files 1-9
1.4. PROGRAMMING FOR DATA MANAGEMENT 1-9
1.5. OS/3 DATA MANAGEMENT ENHANCEMENTS 1-10
1.5.1. ISAM Files 1-10
1.5.2. SAM and DAM Files 1-10
1.5.3. IRAM Files 1-10
1.5.4. MIRAM Files 1-11
1.5.5. Error and Exception Returns 1-11
1.5.6. Disk Flexibility and Hardware Constraints 1-11
1.5.7. Shared Data ManagerneritModules 1-12
1.6. DATA MANAGEMENT/USER INTERFACE 1-12
1.6.1. Declarative Macroinstructions 1-12
1.6.2. Imperative Macroinstructions 1-14
1.6.3. Assembler Rules for Operand Field 1-14
UP-8068 Rev. 4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
Contents 2
1.7.
1.7.1.
1.7.2.
1.7.3.
1.7.4.
1.7.5.
2. CARD FORMATS AND FILE CONVENTIONS
2.1. GENERAL 2-1
RECORD FORMATS
Start-of-Data Job Control Statement End-of-Data Job Control Statement Card Punch Records
:21 2-2 2—3 2-3
3-i FUNCTIONAL DESCRIPTION
Punched Card Input Punched Card Output
3-1 3-1 3-2
3.3. DEFINE A SAM CARD FILE (DTFCD) 3-3
3.4.
3.4.1.
3.4.2.
3.4.3.
3.4.4.
3.4.4.1.
3.4.5.
(OPEN) (GET) (PUT) (CNTRL)
ERROR AND EXCEPTION HANDLING FilenameC
FilenameS 3-25
3.6. SAMPLE PROGRAMS 3-25
4. DISKETTE FORMATS AND FILE CONVENTIONS
4-1 RELATED OS/3 SOFTWARE
System Service Programs (SSP) Job Control
Supervisor Linkage Editor Data Utilities
PART 2. CARD, DISKETTE, AND PRINTER FILES
1—15 1-15 1-16 1-17 1-17 1-18
FILE ORGANIZATION Card Input Files Card Output Files Combined Files 2.2.
2.2.1.
2.2.2.
2.2.3.
2.3.
2.3.1.
2.3.2.
2.3.3.
(/$) (/*)
3. FUNCTION AND OPERATION OF PUNCHED CARD SAM
3.1. GENERAL
2-3 2-3 2-3 2-4
3.2.
3.2.1.
3.2.2.
IMPERATIVE MACRO INSTRUCTIONS Open a Card SAM File
Retrieve Next Logical Record Output a Record
Controlling Stacker Selection on the Card Punch Using the CNTRL Imperative Macro
Close a Card SAM File 3.5.
3.5.1.
3.5.2.
(CLOSE)
3-13 3-14 3-15 3-17 3-19 3-20 3-24 3-25 3-25
4.1. GENERAL
UP-8068 Rev.4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
Contents 3
5. FUNCTION AND OPERATION OF DISKEUE SAM
4-1 4-3 4-4 4-4
4-4
5.1. GENERAL 5—1
5—1 5—1 5-2 5—2 5—3
(DTFCD)
5-3 5-4
6. PRINTER FORMATS AND FILE CONVENTIONS
6.3.
6.4.
6.4.1 6.4.2.
6.4.2.1.
6.4.2.2.
6.4.2.3.
6.4.3.
6.4.4.
6—5 6-7 6—7 6-7 6-8 6-8 6—8 6—9 6—9 4.2.
4.2.1.
4.2.2.
4.2.3.
4.3.
4.3.1.
4.3.2.
FILE ORGANIZATION Diskette Input Files Diskette Output Files Combined Files RECORD FORMATS Fixed-Length Records Variable-Length Records
4-4 4-4
5.2.
5.2.1.
5.2.2.
5.2.3.
5.2.4.
5.2.5.
5.2.6.
FUNCTIONAL DESCRIPTION Input Record Processing Output Record Processing
Combined File Record Processing Multisector I/O
Specifying 8413 Diskette Use Diskette Limitations
5.3. DEFINE A SAM DISKETTE FILE 5.4.
5.4.1.
5.4.2.
5.4.3.
5.4.4.
IMPERATIVE MACROINSTRUCTIONS Open a Diskette SAM File
Retrieve Next Logical Record Writing a Diskette Record Closing a Diskette File
(OPEN) (GET) (PUT)
5—6 5—7 5-8 5-10
(CLOSE) 5-12
6.1. GENERAL 6-1
6.1 .1. 0773 Printer Subsystem 6-2
6.1.2. 0770 Printer Subsystem 6-2
6.1.3. 0768 Printer Subsystem 6-2
* 6.1.4. 0776 Printer Subsystem 6-2
6 1 5 0778 Printer Subsystem 6-2
6.2. FILE ORGANIZATION 6-2
6.2.1. Text 6—3
6.2.2. Tabular Data 6-4
6.2.3. Printer Forms 6-4
RECORD FORMATS
VERTICAL FORMAT AND LOAD CODE BUFFERS Load Code Buffer Interchangeability
LCB Statement Specification
LCB Specification fOr the 0773 and 077S Printers LCB Specification for the 0770 and 0776 Printers LCB Specification for the 0768 Printer
Vertical Format Buffer Interchangeability VFB Statement Specification
UP-8068 Rev. 4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
Contents 4
8.2.
8.2.1.
8.2.2.
8.2.3.
8.2.4.
8.2.4.1 8.2.5.
IMPERATIVE MACROINSTRUCTIONS Open a Printer File
Output a Record Control Printer Forms Print Overflow Action Close a Printer File
(OPEN) (PUT) (CNTRL) (PRTOV) (CLOSE)
ERRORAND EXCEPTION HANDLING 7-28
FilenameC
Truncation of Print Line 7—28
SAMPLE PROGRAM
PART 3. MAGNETIC TAPE FILES
9. FUNCTIONS AND OPERATIONS, MAGNETIC TAPE SAM
9.1.
9.2.
9.2.1.
9.2.2.
9.2.2.1.
9.2.2.2.
9.2.2.3.
9.2.2.4.
9.2.2.5.
9.2.2.6.
(IOAREA1) (BLKSIZE) (TYPEFLE) (ERROR) (EOFADDR) (SAVAREA)
8-1 8-2 8-2 8-8 8-9 8-9 8-14
9—1 9—2 9-10 9-10 9-10 9—11 9—12 9—12 9-13
6.4.4.1. Specifying Home Paper Position 6—9
6.4.4.2. Specifying Forms Overflow Position 6.4.4.3. Specifying Special Forms
6.4.4.4. Paper Tape Loop, 0768 Printer
6.4.4.5. Vertical Format Buffer Statement Example
7. FUNCTION AND OPERATION OF SAM PRINTER
GENERAL
FUNCTIONAL DESCRIPTION DEFINE A SAM PRINTER FILE
FILES
7.1.
7.2.
7.3.
7.4.
7.4.1.
7.4.2.
7.4.3.
7.4.4.
7.4.5.
7.5.
7.5.1.
7.5.2.
7.6.
6-9 6-10 6-10 6-12
7—1 7-1 7-4 7-15 7-16 7-18 7—21 7-24 7-27 (DTFPR)
7-28
7—28
8. MAGNETIC TAPE FORMATS AND FILE CONVENTIONS
8.1. GENERAL 8-1
TAPE VOLUME AND FILE ORGANIZATION EBCDIC Standard Volume Organization EBCDIC Nonstandard Volume Organization EBCDIC Unlabeled Volume Organization ASCII Standard Volume Organization
End-of-File and End-of-Volume Coincidence Magnetic Tape File Record and Block Formats
GENERAL 9—1
DEFINING A MAGNETIC TAPE FILE (DTFMT)
Format of the DTFMT Declarative Macro
Required and Most Frequently Used DTFMT Keywords Specifying the I/O Buffer
Specifying the Length of the I/O Buffer Specifying Type of File Processing Error Processing
End-of-Data Processing for an Input File Specifying a Register Save Area
UP-8068 Rev.4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
Contents5
9.2.3.1.
9.3.3.2.
9.2.3.3.
9.2.3.4.
9.2.3.5.
9.2.3.5.1.
9.2.4.
9.2.4.1.
9.2.4.2.
9.2.4.3.
9.2.5.
9.2.5.1.
9.2.5.2.
9.2.5.3.
9.2.5.4.
9.2.6.
9.2.6.1.
9.2.6.2.
9.2.6.3.
9.2.7.
9.2.7.1.
9.2.7.2.
9.2.7.3.
9.2.8.
9.2.8.1.
9.2.8.2.
9.2.9.
9.2.10.
9.3.
9.3.1.
9.3.2.
9.3.3.
9.3.3.1.
9.3.3.2.
9.3.3.3.
9.3.4.
9.3.4.1.
9.3.4.2.
9.3.4.3.
9.3.4.4.
9.3.4.5.
9.3.4.6.
9.3.5.
9.3.6.
9.3.7.
9.4.
9.4.1.
9.4.2.
9.4.3.
9.4.4.
(IOAREA2) (IOREG) (WORKA) (ERROPT) (BKNO)
(RECFORM) (RECSIZE) (VARBLD) (READ) (REWIND) (OPRW) (CLRW) (FILABL) (TPMARK) (LABADDR) (ASCII) (BUFOFF) (LENCHK) (OPTION) (CKPTREC)
9-13 9-13 9—13 9-14 9-14 9—15 9—15 9—17 9-17 9-18 9-19 9—21 9-22 9-22 9-23 9-23 9-23 9-23 9-24 9-24 9-26 9-27 9-27 9-28 9-28 9-28 9-29 9-29 9-30
9-31 9-31 9-32 9-33 9-34 9-34 9-36 9-36 9-36 9-36 9-38 9—39 9-39 9-39 9-40 9-41 9-43
9-43 9-46 9-48 9-50 9-52 9.2.3. Commonly Used DTFMT Keywords
Specifying a Secondary I/O Buffer Specifying an Index Register Processing in a Work Area Handling Parity Errors Processing Block Numbers
Block Number Specification
Parameters Related to Tape Record Formats Specifying a Record Format
Providing Record Size
Blocking Variable Records in an I/O Area Parameters Related to Tape Movement
Specifying Input File Direction Exercising General Rewind Options Rewinding at Open
Rewinding at Close
Parameters Related to Tape Label Processing Specifying Type of Tape Labels
Eliminating Tape Mark After Header Labels Special Label Handling
ASCII Processing
Specifying ASCII Processing Specifying ASCII Buffer Offset
Checking the Length of Variable ASCII Records Other DTFMT Keyword Parameters
Specifying That a File is Optional Bypassing Checkpoint Dumps
Nonstandard Forms of DTFMT Keywords Processing Multivolume Files
(LBL) JOB CONTROL STATEMENTS USED WITH MAGNETIC TAPE FILES
Assigning a Tape Device to Your Job (DVC)
Defining Your Logical File (LFD)
Specifying Tape Volume Information (VOL)
Inhibiting Volume Serial Number Checking
Specifying Dynamic Tape Prepping and Recording Density Specifying a Scratch Volume
Specifying Tape File Label Information Specifying File Identifier
Checking Volume and File Serial Numbers Specifying File Expiration Date
Specifying File Creation Date Specifying File Sequence Number
Specifying File Generation and Version Numbers Creating Multivolume Tape Files
Extending Tape Files
Error Messages Related to Tape Label Processing IMPERATIVE MACROS FOR PROCESSING MAGNETIC TAPE FILES
Initiating Tape File Processing Terminating Tape File Processing
Delivering the Next Logical Output Record to Tape SAM Reading the Next Logical Input Record From Tape
(OPEN) (CLOSE) (PUT) (GET)
UP-8068 Rev. 4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
Contents 6
9.4.5. Changing File Processing Mode for an IN/OUT
PART 4. DISK FILES 10. ISAM FORMATS AND FILE CONVENTIONS
10.2.
10.2.1.
10.2.2.
10.2.2.1 10.2.3.
10.2.4.
10.2.5.
MULTIVOLUME ISAM FILES
Specifying Location of Retrieval Search Argument Specifying Length and Location of Record Keys Suppressing a File Lock
Providing Cylinder Overflow Area Specifying Record Size and Format Specifying
Specifying
10-1 10-3 10-5 10-8 10-11 10-12 10-14 10-16
11-8 11—8 11—9 11-10
-
Tape File (SETF) 9-54
• 9.4.6. Writing Short Output Blocks to Magnetic Tape (TRUNC) 9-56
. 9.4.7. Skipping to the Next Input Block (RELSE) 9-58
9.4.8. Forcing End-of-Volume Procedures (FEOV) 9-59
9.4.9. Processing User Tape Labels (LBRET) 9-60
9.4.10. Controlling Tape Unit Functions (CNTRL) 9-62
10.1. GENERAL
ISAM FILE ORGANIZATION ISAM Record Formats ISAM Data Block Format
Calculating Space Requirements for the File ISAM Index Blocks
Calculating Space for the ISAM Index Area Loading the Top Index into Main Storage
10.3. ALTERNATE SEQUENTIAL ACCESS METHOD (ASAM)
10.3.1. ASAM Data Formats 10.4.
11. FUNCTIONS AND OPERATION OF ISAM
11.1. GENERAL
11.2. FUNCTIONAL DESCRIPTION, OS/3 ISAM 11.2.1.
11.2.2.
11.2.3.
10-18 10-22 10-22
11—1 11-2 11-2 11-3 11-4 Processing an Indexed ISAM File
Processing an ISAM File Without an Index Structure Deleting Records From an ISAM File
11.3. DEFINING AN OS/3 ISAM FILE (DTFIS) 11-6
DTFIS KEYWORD PARAMETERS Specifying File Accessing Options Specifying Size of Data Blocks Specifying Your Error Exit
Describing an Index Area in Main Storage Eliminating the Index Structure
Specifying I/O Buffers
Specifying Current Record Pointer Specifying the Type of File Processing 11.4.
11.4.1.
11.4.2.
11.4.3.
11.4.4.
11.4.5.
11.4.6.
11.4.7.
11.4.8.
11.4.9.
11.4.10.
11.4.11.
11.4.12.
11.4.13.
11.4.14.
11.4.15.
(ACCESS) (BLKSIZE) (ERROR)
(INDAREA,INDSIZE) 11-11
(INDEXED) 11-12
(IOAREA1 IOAREA2) 11-12
(IOREG) 11-13
(IOROUT) 11-13
(KEYARG) 11-14
(KEYLEN,KEYLOC) 11-15
(LOCK) 11—16
(PCYLOFL) 11—17
(RECFORM,RECSlZE) 11-17 a Save Area for Contents of General Registers (SAVAREA) 11-18
the Type of Retrieval (TYPEFLE) 11—18
UP-8068 Rev. 4 SPERRY UNIVAC OS/3 BASIC DATA MANAGEMENT
ERROR AND EXCEPTION HANDLING FilenameC
Other Addressable Fields of the DTFIS File Table
11.7 PROGRAMMING EXAMPLE
11 .7.1. Sample ISAM File Load Program
12. IRAM FORMATS AND FILE CONVENTIONS
Contents 7
12.1. GENERAL 12-1
12.1.1. IRAM Concepts 12-1
12.2. IRAM FILE CONVENTIONS AND FORMATS 12.2.1. The Data Partition
12.2.2. Entries in the Index Partition 12.2.3. Structure of IRAM Index
12.2.4. Estimating Disk Space Required for an Indexed IRAM File
12.2.5. Estimating Disk Space Required for a Nonindexed IRAM File
11.4.16. Forestalling Use of Update Functions (UPDATE) 11—19
11.4.17. Specifying Parity Check of Output Records (VERIFY) 11—19 11 .4.18. Specifying Location of Record Work Areas. (WORK1 ,WORKS) 11-19
1 1 .4.19. Nonstandard Forms of the Keyword Parameters 1 1—20
11.4.20. Recapitulation of DTFIS Keyword Parameters 11—21
11.5. IMPERATIVE MACROS FOR ISAM FILES . 11-23
1 1 .5.1. Basic Macroinstructions 1 1—23
11.5.1.1. Initializing an ISAM File (OPEN) 11—24
11.5.1.2. Terminating an ISAM File (CLOSE) 11—25
11 .5.2. Loading and Extending an ISAM File 11-26
11.5.2.1. Initiating the Load Sequence (SETFL) 11—27
11.5.2.2. Writing Initial Records to the File (WRITE,NEWKEY) 11—28
11.5.2.3. Terminating the Load Sequence (ENDFL) 11—30
11.5.3. Inserting New Records in an ISAM File 11—31
1 1 .5.3.1. Adding a New Record to Overflow in an
Existing File (WRITE,NEWKEY) 11—32
1 1 .5.3.2. Adding a New Record to Overflow in an Existing
File (ADD) 11—34
11.5.3.3. Ensuring Completion of Record Transfer (WAITF) 11—35
11.5.4. Processing an ISAM File Randomly . 11-35
1 1 .5.4.1. Retrieving a Record (READ,ID and
READ,KEY) 11-36
11.5.4.2. Updating a Record (WRITE,KEY) 11-38
11.5.4.3. Updating Last Record Retrieved (UPDT) 11—40
11.5.5. Processing an ISAM File Sequentially 11-40
11.5.5.1. Initializing a Retrieval Sequence (SETL) 11—42
11.5.5.2. Retrieving Next Logical Record (GET) 11—44
11.5.5.3. Updating a Record (PUT) 11—46
11.5.5.4. Terminating a Retrieval Sequence (ESETL) 11—48
11.6. 11-49
11.6.1. 11-49
11.6.2. 11-49
11—50 11—50
12-3 12-3 12—3 12-6 12-9 12-12