Restricted Distribution It Program Logic

IBM System/360

Disk Operating System

File Number S360-36 Form Y24-S084-0

Program Logic

Supervisor and Physical and Logical Transients

Program Number 360N-CL-453, Version 3

This pUblication describes the internal logic of the IBM System/360 Disk Operating System,

Supervisor and Transients Programs. It is intended for use by persons involved in program maintenance and by system programmers who are altering the program design. Program logic

information is not needed for normal operation of these programs; therefore, distribution of this publication is limited to those with maintenance and alteration requirements. It is designed to be used as a supplement to the program listing.

Effective use of this manual requires an

understanding of IBM System/360 operation and of IBM System/360 Disk Operating System control and service programs, macro instructions, and

operating procedures. Reference publications for this information are listed in the Pr.eface of this manual.

For overall system control logic description, this PLM is to be used with four other PLMs:

IBM System/360 Disk Operating System, Introduction to System Control Programs, Form Y24-S0l7.

IBM System/360 Disk Operating

Syste~,

Lifrrarian Maintenance and Service Programs, Form Y24-S079.

IBM System/360 Disk Operating System, Linkage Editor, Form Y24-S080.

IBM System/360 Disk Operating System, IPL and Job Control Programs, Form Y24-S086.

Restricted Distribution

PREFACE.

This Program Logic Manual (PLM) is a detailed guide to the IBM System/360 Disk Operating System supervisor, physical transient, and logical transient programs.

It supplements the program listings by providing descriptive text and flowcharts.

Prerequisite and related publications that aid in the use of this manual are:

IBM System/360 principles of .Operation, Form A22-6821.

IBM System/360 Disk Operating System

L

System Control and service Programs, Form C24-5036.

IBM System/360 Disk operating System, supervisor

and~ut/output

Macros, Form C24-5037.

IBM System/360 Disk Operating System, System Generation and Maintenance, Form C24-5033.

IBM System/36.O Disk operating System, Operating Guide, Form C24-5022.

IBM system/360 Disk Operating System, Data Management Concepts, Form C24-3427.

IBM System/360 Disk and Tape operating Systems: Assembler specifications, Form C24-3414 .

. . RESTRICTED DISTRIBUTION: This publication is intended for use by IBM personnel only and may not be made available to others without the approval of local IBM management.

First Edition, February 1968

IBM System/360 Disk Operatin9-System, Basic Telecommunications Access Method PLM, Form Y30-5001.

IBM System/360 Disk operating System

L

Queued Telecommunications Access Method

PL~,

Form Y30-5002.

Titles and abstracts of other related publications are listed in the IBM

System/360 Bibliography, Form A22-6822.

This manual consists of seven

m~jor

sections. The first section is an introduction to the supervisor and transient programs. The next section describes the generation and organization of the supervisor. The next four 'sections describe the detailed operation of the supervisor, physical IOCS, physical transients, and logical transients. The last section of the manual, the appendixes, contains the label list, error messages, and other references for use in analyzing program details.

The flowcharts for all components are located at the end of the manual. The detailed flowcharts are identified by letters AA through ZZ. Numerals, such as 00 fo·r the program level flowchart,

identify the more general flowcharts.

This edition, Y24-S084-0, obsoletes the Supervisor and transient portions of Y24-S017-2 and its Technical Newsletters, Y24-5059 and

Y24-S070. .

Significant changes or additions to the specifications contained in this publication are continually being made. When using this publication in connection with the operation of IBM equipment, check the latest SRL Newsletter for revisions or contact the local IBM branch office.

Requests for copies of IBM publications should be made to your IBM representative or to the IBM branch office serving your locality.

A form is provided at the back of this publication for readers' comments. If the form has been removed, comments may be addressed to: IBM Corporation, Programming Publications, Endicott, New York 13760.

~

InternationalaBusiness Machines Corporation 1968

INTRODUCTION • • • 11

Multiprogramming _{• • 11}

Background vs Foreground Programs • • • • 12 SUPERVISOR GENERATION AND ORGANIZATION • 13 Supervisor Generation • • • • • •

Supervisor Generation Macros.

Macro Relationships • •

• • 13

• • 13

• • 17 Organization • • • • • • • • • • • 17 Low Core. • • • • • • 17

Nucleus Code. 20

I/O Tables. • • • • 20

Information Blocks and Other Tables • 40 RESIDENTI SUPERVISOR (CHARTS 01-06) •

Supervisor Interrupt Processors.

Multiprogramming support (MPS) • Batch Job Support • • • •

Supervisor Call Interrupt (SVC).

I/O Interrupt. • • • • • • Program Check Interrupt • • External Interrupt • • • • Machine Check Interrupt. •

PHYSICAL INPUT/OUTPUT CONTROL SYSTEM

44 44 44 44

• • 44 50 50

• • 50

• • 50 (PIOCS) • • • • • • • • • • 51 Command Control Block • • • • • • • • 51 PHYSICAL TRANSIENT PROGRAMS (CHARTS

07-09). • • • • • • • 60

ERP • • • • • • 60

c:::ONTENTS Message Writer • •

Physical Attention Routines • • I/O Error Recovery Procedures and

Sense Data. • • • • • • • • • 2400 Tape Error Recovery. • 1052 Error Recovery • • • • • • 1403-1443 Error Recovery,. • • • 1442 Error Recovery • • • • • • 2501, 2520, 2540 Error Recovery 2671 Error Recovery • • • • • • 2311-2314 DASD Error Recovery • 2321 DASD Error Recovery. • 12a5-1287 Error Recovery. • • • 1412-1419 Error Recovery. • • • LOGICAL TRANSIENT PROGRAMS (CHARTS

• 60

• 60

• 64

• 64 65

• 65

• 66

• 66

• 67

• 68

• 69

• 71

• 71

10-19). • • • • • • • • • • • • 73 B-Transient Grouping • • • • • • • • • • 73

Transient Attention Routines

(Charts 10-12) • • • • • • 73 Program Initiator (Charts 10, 11,

13, and 14)._. • • • • • • • 74 Terminator (Charts 15-19) • • • • • • 75

CHARTS • _{• 79}

APPENDIX A: LABEL LIST • .298 APPENDIX B: ERROR MESSAGE CROSS

REFERENCE • .319

APPENDIX C: I/O REQUEST-I/O INTERRUPT

SEQUENCE. • • • • • • • • • • • • • • .322 APPENDIX D: LABEL INFORMATION FORMAT

ON SYSRES • • • • • • • • • • • • • 323 APPENDIX E: PROGRAM KEY DEFINITIONS • • 325 APPENDIX F: EXPLANATION OF FLOWCHART

SYMBOLS • INDEX • • •

.326 .327

Contents 3

4 DOS Supervisor and Physical and Logical Transients

Figure 1.· Multiprogram Main Organization. • • • • • • • Figure 2. Superyisor Macros of 3) • • • • • • • • • Figure 2. Supervisor I"1acros of 3) . • • • • • • • • Figure 2.

of 3)

supervisor Macros Figure 3. Macro Functions • Figure 4 • Global Settings • Figure 5. Supervisor Storage

Storage

· · (Part 1 · ^·

· _{(Part 2} ^· · ·

· · · · _{(Part 3}

Allocation. • • • • • • • • • • Figure 6. supervisor Communications

Region (Part 1 of 5) • • • • . . • • Figure 6. Supervisor Communications

Region (Part 2 of 5) • • • • • • • • Figure 6. Supervisor Communications

·

12

· ¹⁴

15 16

• 18 19 21 22 23 Region (Part 3 of 5) • • • • • • • • • • 24 Figure 6. Supervisor Communications

Region (Part 4 of 5) • • • • • • • • Figure 6. Supervisor Communications

25

• • 26 27 28 Region (Part 5 of 5) • • • • • • • •

Figure 7. System Control Center • • Figure 8. I/O Table Interrelationship.

Figure 9. Physical Unit Block (PUB)

Table • • • • • • • 29

Figure 10. Logical Unit Block (LUB) Table • • • • • • •

Figure 11.

Figure 12.

Tape Error Block (TEB) • CHANQ, LUBID, REQID Tables

30 31 32 Figure 13. First Part of Program

Information Block (PIB) Table • • Figure 14. PIB Flag Expansions • • Figure 15. Second Part of Program Information Block (PIB) Table . • Figure 16. Disk Information Block

(DIB) Table • • • • • • • • • • • Figure 17. Job Information Block

(JIB) Table • • • • • • • Figure 18. Accessing CE

Serviceability Routines •

• • 33 34

• • 35

• 36

• 37 38

Figure 19. Option Tables • • . • Figure 20. Tables for MICR DTF

FIGURES

• 39 Addresses and Pointers. • • • 41 Figure 21. Device Type Codes. • 42 Figure 22. Density Data. • • • • 43 Figure 23. Task Selection Procedure • • 48 Figure 24. DOS Supervisor Calls . • • • 49 Figure 25. Supervisor Cancel Codes.. 50 Figure 26. Example of the CHANQ Table

Operation • • • • • • • • • • • • Figure 27. Command Control Block

(CCB) • • • • • • • • • • • • Figure 28. Channel Command Word (CCW)

(Part 1 of 2) • • • • • • . • • Figure 28. Channel Command Word (CCW)

• 50 52 53 (Part 2 of 2) • • • • • • • • • 54 Figure 29. Program Status Word (PSW) • • 55 Figure 30. Channel Address Word (CAW) 56 Figure 31. Channel Status Word (CSW). 57 Figure 32. CSW Testing in I/O

Interrupt Processor • • • • • • • Figure 33. Error Recovery Block

(ERBLOC). • • • • • • • • • • • • Figure 34. A-Transient Programs • Figure 35. Sense Information for

Devices Supported by Device Error Recovery. • • • • • • • • • . • • Figure 36. Physical Transients Error

Messages • • • • • • • • • • • • • • • Figure 37. Interphase Communication

Area (For A-Transients $$ANERRZ, Y, and 0). • • . • • • • • • • • • •

58 59

• 61

• 62 63

• 64

• • 74 Figure 38. Cancel Code Messages • •

Figure 39. MAP output • • • • • • Figure 40. List I/O Examples • • • Figure 41. Terminator Phases • • • Figure 42. Format of SYSRES Tape Label

• 74

• 77 78 Information. • • • • • • • • • • 323 Figure 43. Format of SYSRES DASD

Label Information • • • • • .324

Figures 5

~HARTS

Chart 00. System Program Flow • • • • • 10 Chart 01. Supervisor General Entry,

General Exit, and Processor Exit. • • • 79 Chart 02. Resident Attention Routine

and Program Check Interrupt Routine. 80 Chart 03., SVC Interrupt Processor,

General Cancel, and Fetch • • • • • • 81 Chart 04. I/O Interrupt Processor and

Channel Scheduler • • • • • • • • • • 82 Chart 05. External Interrupt Routines 83 Chart 06. Unit Check, Resident ERP,

and Quiesce I/O Routines. • • 84 Chart 07. Physical Transients (Part 1

of 2) • • • • • • • • • • • • • 85 Chart 08. Physical Transients (Part 2

of 2) • • • • • • • • • • • • • 86

Chart 09. Physical Attention

Transients. • • • • • • • • 87 Chart 10. Logical Transient Root

Phas e • • • • • • • • • • • • • • • 88 Chart 11. Logical Transient Attention

Routines (Part 1 of 2). • • • • • • • 89 Chart 12. Logical Transient Attention

Routines (Part 2 of 2). • • • . • • • 90 Chart 13. Logical Transient Initiator

(Part 1 of 2) • • • • • • • • • • • • 91 Chart 14. Logical Transient Initiator

(Part 2 of 2) • • • • • • • • • 92 Chart 15. Logical Transient

Terminator (Part 1 of 5). • • 93 Chart 16. Logical Transient

Terminator (Part 2 of 5). • • 94 Chart 17. Logical Transient

Terminator (Part 3 of 5). • • • 95 Chart 18. Logical Transient

Terminator (Part 4 of 5). • • • 96 Chart 19. Logical Transient

Terminator (Part 5 of 5). • 97 Chart AA. $$A$SUPl - SUPVR Macro,

General Entry • • • • • • • • • • • • 98 Chart BA. $$A$SUPl - FOPT Macro,

General Cancels and Program Check

without PC Routine. • • • • • • • • • 99 Chart BB. $$A$SUPl - FOPT Macro,

General Cancel Subroutine • • • • • • • 100 Chart BC. $$A$SUPl - FOPT Macro,

General Exits • • • • • . • • • . • • . 101 Chart BD. $$A$SUPl - FOPT Macro,

General Entry. • • • • • • • • • • • .102 Chart CA. $$A$SUPl - SGTCHS Macro,

Channel Scheduler with MPS • • • • • • • 103 Chart CB. $$A$SUPl - SGTCHS Macro,

Channel Scheduler without MPS • • • • . 104 Chart CC. $$A$SUPl - SGTCHS Macro,

Channel Scheduler (Part 1 of 2) • • • • 105 Chart CD. $$A$SUPl - SGTCHS Macro,

Channel Scheduler (Part 2 of 2) • . • • 106 Chart CEo $$A$SUPl - Supervisor,

SGTCHS Macro, Start I/O -- No Options .107 Chart CF. $$A$SUPl - SGTCHS Macro,

Start I/O -- Maximum options (Part 1

of 3) • • • • • • • • • • • • • • .108

Chart CG. $$A$SUPl - SGTCHS Macro, Start I/O -- Maximum options (Part 2

of 3) • • • • • . • • • • • . • • • • . 109 Chart CH. $$A$SUPl - SGTCHS Macro,

Start I/O -- Maximum options (Part 3

of 3) • • • . • • • • • • • • • • • • • 110 Chart CJ. $$A$SUPl - SGTCHS Macro,

I/O Interrupt (Part 1 of 4) • • • • .111 Chart CK. $$A$SUPl - SGTCHS Macro,

I/O Interrupt (Part 2 of 4) • • . • • • 112 Chart CL. $$A$SUPl - SGTCHS Macro,

I/O Interrupt (Part 3 of 4) • • • • • • 113 Chart CM. $$A$SUPl - SGTCHS Macro,

I/O Interrupt (Part 4 of 4) . • • • • • 114 Chart CN. $$A$SUPl - SGTCHS Macro,

I/O Interrupt Subroutines • • • • • • .115 Chart DA. $$A$SUPl - SGUNCK Macro,

Unit Check Entri es • • • • • • • • • .116 Chart DB. $$A$SUPl - SGUNCK Macro,

Build Error Queue Entry • • • • • • • • 117 Chart DC. $$A$SUPl - SGUNCK Macro,

Error Recovery Exits (Part 1 of 2) • • • 118 Chart DD. $$A$SUPl - SGUNCK Macro,

Error Recovery Exits (Part 2 of 2) • • . 119 Chart DE. $$A$SUPl - SGUNCK Macro,

DEQUER and RSTREG Subroutines • • • • • 120 Chart DF. $$A$SUPl - SGUNCK Macro,

Error Start I/O Subroutine • • • • • • • 121 Chart DG. $$A$SUP1 - SGUNCK Macro,

Quiesce I/O Task • • • • • • • • • • • • 122 Chart EA. $$A$SUPl - SGDFCH Macro,

Fetch (Part 1 of 3) • • • • • • • • • • 123 Chart EB. $$A$SUPl - SGDFCH Macro,

Fetch (Part 2 of 3) • • • • • • • • .124 Chart EC. $$A$SUPl - SGDFCH Macro,

Fetch (Part 3 of 3) • • • • • • • • • . 125 Chart ED. $$A$SUPl - SGDFCH Macro,

READUPDT and RSTPUB Subroutines. • .126 Chart FA. $$A$SUPl - SGSVC Macro, SVC

Interrupt Handler • • • • • • • • .127 Chart FB. $$A$SUPl - SGSVC Macro,

SVCs 1, 5, 12, 13, and 29 • • • • • • • 128 Chart FC. $$A$SUP1 - SGSVC Macro,

SVCs 2 and 11 . • • • • • • • • • .129 Chart FD. $$A$SUP1 - SGSVC Macro,

SVCs 3, 4, and 7. • • • • • • • • .130 Chart FE. $$A$SUPl - SGSVC,Macro,

SVCs 8, 9, and 10 • • • • • • • • .131 Chart FF. $$A$SUP1 - SGSVC Macro,

SVCs 22, 23, 24, and 26 • • • • • .132 Chart FG. $$A$SUPl - SGSVC Macro,

Program Check Interrupt and SVCs 16

and 17. • • • • • • • • • • • • • .133 Chart FH. $$A$SUPl - SGSVC Macro,

Program Check Interrupt • • . • • .134 Chart FJ. $$A$SUP1 - SGSVC Macro,

External Interrupt. • • • • • • • .135 Chart FK. $$A$SUPl - SGSVC Macro,

External Interrupt Subroutines.. • .136 Chart FL. $$A$SUP1 - SGSVC Macro,

Program Check Interrupt (SVCs 16

through 21 with options) • • • • • • . • 137

6 DOS Supervisor and Physical and Logjcal Transients

Chart GA. $$A$SUPl - SGDSK Macro,

Disk Error Recovery (Part 1 of 2) • • .138 Chart GB. $$A$SUPl - SGDSK Macro,

Disk Error Recovery (Part 2 of 2) • • • 139 Chart HA. $$A$SUPl - SGTCON Macro,

Resident Attention, SVEREG and VLDADR Subroutines • • • • • • • • • • • • • • 140 Chart JA. $$A$SUPl - SMICR Macro,

External Interrupt (Part 1 of 3). • .141 Chart JB. $$A$SUPl - SMICR Macro,

External Interrupt (Part 2 of 3) • • • • 142 Chart JC. $$A$SUPl - SMICR Macro,

External Interrupt (Part 3 of 3). .143 Chart JD. $$A$SUPl - SMICR Macro, ERP

for 1412/1419 Start I/O. • • • • .144 Chart JE. $$A$SUPl - SMICR Macro, ERP

for 1412/1419 Test I/O. • • • • • .145 Chart JF. $$A$SUPl - SMICR Macro, ERP

for 1419D SIO and TIO • • • • • • • • .146 Chart JG. $$A$SUPl - SMICR Macro,

Program Check Interrupt • • • • • • • • 147 Chart JH. $$A$SUPl - SMICR Macro,

Exit Routine • • • • • • • • • • • • • • 148 Chart KA. $$A$SUPl - SEND Macro, LTA

Subroutine • • • • • • • • • • • • • • • 149 Chart LA. $$ANERRA - ERP Monitor

(Part 1 of 2) • • • • • • • • • • • • • 150 Chart LB. $$ANERRA - ERP Monitor

(Part 2 of 2) • • • • • • • • • • .151 Chart LC. $$ANERRB - Disk ERP • • • • • 152 Chart LD. $$ANERRD - Phase 1 of Tape

ERP (Part 1 of 2) • • • • • • • .153 Chart LE. $$ANERRD - Phase 1 of Tape

ERP (Part 2 of 2) • • • • • • • .154 Chart LF. $$ANERRE - Phase 2 of Tape

ERP (Part 1 of 2) • • • • • • • .155 Chart LG. $$ANERRE - Phase 2 of Tape

ERP (Part 2 of 2) • • • • • • • .156 Chart LH. $$ANERRF - Phase 3 of Tape

ERP (Part 1 of 3) • • • • • • • .157 Chart LJ. $$ANERRF - Phase 3 of Tape

ERP (Part 2 of 3) • • • • • • • .158 Chart LK. $$ANERRF - Phase 3 of Tape

ERP (Part 3 of 3) • • • • • • • .159 Chart LL. $$ANERRL - Phase 4 of Tape

ERP • • • • • • • • • • • • • • .160 Chart LM. $$ANERRG - Phase 1 of Data

Cell ERP (Part 1 of 3). • • • • .161 Chart LN. $$ANERRG - Phase 1 of Data

Cell ERP (Part 2 of 3). • • • • .162 Chart LP. $$ANERRG - Phase 1 of Data

Cell ERP (Part 3 of 3). • • • • .163 Chart LQ. $$ANERRH - Phase 2 of Data

Cell ERP. • • • • • • • • • • • .164 Chart LR. $$ANERRI - Phase 3 of Data

Cell ERP. • • • • • • • • • • • .165 Chart LS. $$ANERRJ - Phase 4 of Data

Cell ERP (Part 1 of 2). • • • • .166 Chart LT. $$ANERRJ - Phase 4 of Data

Cell ERP (Part 2 of 2). • • • • .167 Chart LU. $$ANERRK - Phase 5 of Data

Cell ERP. • • • • • • • • • • • • .168 Chart LV. $$ANERRM - Phase 1 of ERP

Message Writer. • • • • • • • • • .169 Chart LW. $$ANERRN"- Phase 2 of ERP

Message Writer (Part 1 of 2>' • • .170 Chart LX. $$ANERRN - Phase 2 of ERP

Message Writer (Part 2 of 2). • • .171

Chart LY. $$ANERRO - Phase 3 of ERP

Message Writer. • • • • • • • • .172 Chart LZ. $$ANERRP - Phase 4 of ERP

Message Writer. • • • • • • . • .173 Chart MA. $$ANERRQ - Phase 5 of ERP

Message writer (Part 1 of 2). • .174 Chart MB. $$ANERRQ - Phase 5 of ERP

Message writer (Part 2 of 2). • .175 Chart MC. $$ANERRR - Phase 6 of ERP

Message Writer. • • • • • • • • .176 Chart MD. $$ANERRS - Phase 7 of ERP

Message Writer. • • • • • • • • .177 Chart t1l!.. $$ANERRT - NICR (1412/1419)

ERP • • • • • • • • • • • • • • .178 Chart MF. $$ANERRU - Phase 1 of Unit

Record ERP (Part 1 of 2). • • • .179 Chart MG. $$ANERRU - Phase 1 of Unit

Record ERP (Part 2 of 2). • • • .180 Chart ~lli. $$ANERRV - Phase 2 of Unit

Record ERP (Part 1 of 2). • . • .181 Chart MJ. $$ANERRV - Phase 2 of Unit

Record ERP (Part 2 of 2). • • • • .182 Chart MK. $$ANERRW - MICR (1419D) ERP

(Part 1 of 3) • • • • • • • • • • .183 Chart ML. $$ANERRW - MICR (1419D) ERP

(Part 2 of 3) • • • • • • • • • • .184 Chart Ml>l. $$ANERRW - MICR (1419D) ERP

(Part 3 of 3) • • • • • • .185 Chart MN. $$ANERRX - Paper Tape ERP

(Part 1 of 2) • • • • • • • . • .186 Chart MP. $$ANERRX - Paper Tape ERP

(Part 2 of 2) • • • • • • • • • • .187 Chart MQ. $$ANERRY - Physical

Attention Routine: Send Message. .188 Chart MR. $$ANERRY - Physical

Attention Routine: Read Operator

Reply. • • • • • • • • • • • • • .189 Chart MS. $$ANERRZ - Physical

Attention Routine: Initial PUB Scan. .190 Chart MT. $$ANERRZ - Physical

Attention Routine: Cancel.. • • • • • 191 Chart MO. $$ANERRO - Physical

Attention Routine: Emergency Cancel (Part 1 of 2) • • • • • • • • • • • • • 192 Chart MV. $$ANERRO - Physical

Attention Routine: Emergency Cancel

(Part 2 of 2) • • • • • • • • .193 Chart MW. $$ANERRl - Move Data to

Communications Region • • • • • • • • .194 Chart MX. $$ANERR9 - Optical Reader

ERP (Part 1 of 2) • • • • • • • • • • .195 Chart MY. $$ANERR9 - Optical Reader

ERP (Part 2 of 2) • • • • • • • • • • • 196 Chart NA. $$BATTNA - Nonresident

Attention/Initiator Root Phase • • • • • 197 Chart NB. $$BATTNA - Control Routine • • 198 Chart NC. $$BATTNA - Root Phase

Subroutines • • • • • • • • • • • .199 Chart ND. $$BATTNA - General Scan

Routines. .200

Chart NE. $$BATTNB - MSG Statement

Processor • • • • • • • • • • • • • • • 201 Chart NF. $$BATTNB - Set Operator

Communications and Exit Table Linkage .202 Chart NG. $$BATTNC - CANCEL Statement

Processor • • • • • •

~

• • • • • • • • 203

Charts 7

Chart NH. $$BA'lTNC - PAUSE, LOG, NOLOG, and IGNORE Statement

Processors • • • • • • • • • • • • • • • 204 Chart NJ. $$BA'lTND - MAP Statement

Processor . . . . Chart NK. $$BA'lTND - Output MAP

Subroutines· (Part 1 of 2) • Chart NL. $$BATTND - output MAP

Subroutines (Part 2 of 2) •

• .205

• .206

• .207 Chart NM." $$BA'lTNE - ALLOC Statement

Processor (Part 1 of 4) • • • • • • • • 208 Chart NN. $$BA'lTNE - ALLOC Statement

Processor (Part 2 of 4) • • • • • • • • 209 Chart NP. $$BA'lTNF - ALLOC Statement

Processor (Part 3 of 4) • • • • • • • .210 Chart NQ. $$BA'lTNF - ALLOC Statement

Processor (Part 4 of 4) • • • • • • • • 211 Chart NR. $$BA'lTNG - START and BATCH

Statement Processors • • • • • • • • • • 212 Chart NS. $$BA'lTNG - START and BATCH

Subroutines • • • • • • • • • • • • • • 213 Chart NT. $$BA'lTNH - START Statement

Processor Channel Program • • • • • • • 214 Chart NU. $$BA'lTNH - Subroutines • • • • 215 Chart NV. $$BA'lTNI - ASSGN Statement

Processor (Part 1 of 2) • • • • • • • • 216 Chart NW. $$BATTNI - ASSGN Statement

Processor (Part 2 of 2) • • • • • • • • 217 Chart NX. $$BA'lTNI - Validate SYSXXX

Subroutine. • • • • • • • • • • .218 Chart NY. $$BA'lTNI - Validity Check

Channel and Unit. • • • • • • • • .219 Chart NZ. $$BA'lTNI - Unassign

Subroutine. • • • • • • • • .220 Chart PA. $$BATTNI - Scan LUBs and

JIBs Subroutines • • • • • • • . • • • • 221 Cha·rt PB. $$BA'lTNI - Conversion

Subroutines • • • • • • • • • • • • • • 222 Chart PC. $$BA'lTNI - UNA Statement

Processor • • • • • • • • • • • • • • • 223 Chart PD. $$BATTNI - Miscellaneous

Subroutines • • • • • • • • • • • • • • 224 Chart PEG $$BATTNJ - LISTIO Statement

Processor • • • • • • • • • • • • • • • 225 Chart PF. $$BA'lTNJ - Subroutines • • • • 226 Chart PG. $$BATTNJ - Locate

As signment Routine. • • • • • • • • • .227 Chart PH. $$BATTNJ - output List

(Part 1 of 2) • • • • • • • • • • • • • 228 Chart PJ. $$BA'lTNJ - Output List

(Part 2 of 2) • • • • • • • • • • • • • 229 Chart PK. $$BATTNK - VOL Statement

Processor Chart PL.

Processor Chart PM.

$$BATTNK - TPLAB Statement

$$BATTNK - TLBL Statement

• .230

• .231 Processor • • • • • • • • • • • • • • .232 Chart PN. $$BATTNK - Check, Convert,

and Concatenate Subroutines. • • .233 Chart PP. $$BATTNK - Process File ID

and Date Operands • • • • • • • • • • .234 Chart PQ. $$BATTNK - DLBL Statement

Processor • • • • • • • • • • • • • • • 235 Chart PRo $$BATTNK - Output Label

Data Subroutines • • • • . • • • • • • • 236 Chart PSG $$BATTNL - DLAB Statement

Processor • • • • • • • • • .237

Chart PT. $$BATTNL - Extract Operand Routine . . . . . . . . _{· · ·} · · · · ^.238

Chart PUG $$BATTNL - XTENT Statement Processor (Part 1 of 3) · · · · · ^.239

Chart PV. $$BATTNL - XTENT Statement Processor (Part 2 of 3) · · · · · · · ^.240

Chart PW. $$BATTNL - XTENT Statement

Processor (Part 3 of 3) · · · ^{· .241}

Chart PX. $$BATTNL - XTENT Processor Subroutines • • • • • • • • • • • • • • 242 Chart PY. $$BATTNM - EXEC Statement

Processor. • • • • • • • • .243 Chart PZ. $$BATTNM - Output Last

Block of Label Data • • • • • • • • • .244 Chart QA. $$BATTNM - Move Last Block

Routine . . . .245 Chart QB. $$BATTNM - Move Subroutine

and INITIALIZE FOR FG Program Load

Routine . . . .246 Chart QC. $$BATTNM - UCS Statement

Processor • . • • • • . . • . • • . . .247 Chart QD. $$BATTNM - 9CS Subroutines • • 248 Chart QE. $$BATTNN - TIMER Statement

Processor • • • • • • • • • • • • • • .249 Chart QF. $$BATTNO - EXTENT Statement

Processor (Part 1 of 3) • • • • • • • .250 Chart QG. $$BATTNO - EXTENT Statement

Processor (Part 2 of 3) • • • • • • • .251 Chart QH. $$BATTNO - EXTENT Statement

Processor (Part 3 of 3) • • • • • • • • 252 Chart QJ. $$BATTNO - EXTENT Processor

Subroutines. • • • • • • • • • • • .253 Chart QK. $$BATTNO - Process Track

Operands. • • • • • • • • • • • • • . 254 Cha"rt QL. $$BATTNO - LBLTYP Statement

Processor • • • • • • • • • • • • • • .255 'Chart QM. $$BATTNP - READ Statement

Processor • • • • • • • • . . • • • • • 256 Chart QN. $$BATTNP - HOLD or RELSE

Statement Processor • • • • • • • • • • 257 Chart RA. $$BEOJ - Terminated Program

I/o Handling. • • • • • • • • • • .258 Chart RB. $$BEOJ -EOJ Processing

Routine and $$BEOJ Subroutines • • • • • 259 Chart RC. $$BEOJ - Message Output

Subroutine. • • • • • • • • • • • • • • 260 Chart RD. $$BEOJ3 - Quiesce I/O Phase .261 Chart RE. $$BTERM - Reset Foreground

PUB Ownership and Detach Attention

Routine • • • • • • • • • • • • • • • • 262 Chart RF. $$BTERM - Reset JIBs for

I/O Device of Terminated Program. .263 Chart RG. $$BTERM - Get TEB

Statistics and Reset TEBs • • • • .264 Chart RH, $$BTERM - Print Message and

TEB Statistics Subroutine • • • • .265 Chart RJ. $$BEOJl - Prepare Cancel

Cause Message • • • • • • • • • • .266 Chart RK. $$BEOJl - Output Cancel

Message on SYSLST • • • • • • • • .267 Chart RL. $$BEOJ2 - Select Cancel

Message and Program Identification. .268 Chart RM. $$BEOJ2 - Select I/O Device

and Output the Cancel Message • .269 Chart RN. $$BILSVC - Prepare

Information about Cancel Cause. • .270

8 DOS Supervisor and Physical and Logical Transients

Chart RP. $$BILSVC - Select I/O Device and Prepare to output a

Message. • • • • • • • • • • • • .271 Chart RQ. $$BILSVC - output Message

on Selected I/O Device • • • • • • • • • 272 Chart RR. $$BPSW - Prepare Canceled

Program's PSW for Output Message and

PIOCS Subroutine. • • • • • • • • • • .273 Chart RS. $$BPSW - Select I/O Device

and Prepare to Output a Message • .274 Chart RT. $$BPCHK - Prepare

Information for Message about PC

Cancel and Select I/O Device • • • • • . 275 Chart RU. $$BPCHK - Set Up for I/O

and Output the Message. • • • .276 Chart RV. $$BDUMP - Monitor

Background Program Dump • • • • • .277 chart RW. $$BDUMP - Monitor

Foreground Program Dump • • • • • • • .278 Chart RX. $$BDUMPF - Foreground

Program Dump • • • • • • • • • • • • • • 279 Chart RY. $$BDUMPF - Prepare Page

Headings and PIOCS Subroutines • • • • • 280 Chart RZ. $$BDUMPF - Prepare and Edit

a Line Subroutine • • • • • • • • • • • 281 Chart SA. $$BDUMPF - Line Test

Subroutines • • • • • • • • • • • • • • 282 Chart SB. $$BDUMPB - Initialization

for BG Storage Dump on Printer or

Tape • • • • • • • • • • • • • • • • • • 283

Chart SC. $$BDUMPB - BG Dump on

Printer or Tape • • • • • • • • .284 Chart SD. $$BDUMPB - Prepare Page

Headings and PIOCS Subroutines • • • • • 285 Chart SE. $$BDUMPB - Prepare and Edit

a Line Subroutine • • • • • • • • .286 Chart SF. $$BDUMPB - Line Test

Subroutines • • • • • • • • • • • .287 Chart SG. $$BDUMPD - Dump on Disk

Device. . . • . • . . .288 Chart SH. $$BDUMPD - Prepare Page

Headings and PIOCS Subroutines. • .289 Chart SJ. $$BDUMPD - Prepare and Edit

a Line Subroutine • • • • .290 Chart SK. $$BDUMPD - Line Test

Subroutines • • • • • • • • • • • .291 Chart SL. $$BPDUMP - Parameter

Storage Dump Monitor. • • • • • • .292 Chart SM. $$BPDUMl - Initialize

Parameter Dump on Printer or Tape .293 Chart SN. $$BPDUMl - Parameter

Storage Dump on Printer or Tape • .294 Chart SP. $$BPDUMl - Line Test

Subroutines . • • • • • • • • • • .295 Chart SQ. $$BPDUMl - Prepare and Edit

a Line Subroutine • • • • • • • • • • • 296 Chart TA. $$BSYSWR - Set up a Write

on SYSRES Operation; Move Label

Cylinder Address to COMREG • • • • • • • 297

Charts' 9

f-' 0

t1 0

(fl (fl

~

'0

(D 1-"

~

Ul

0 11

ill ~

0.

'"d

:;J"'

'<

Ul 1-"

() _//EXE

ill

~

ill

~

0.

I.Q

b

1-" _IIEXE

() ill

~ f-j

11

ill

~

~r='=· ^~

.-_..l~~~~-__,

ANGUAGE TRANS I SLNKEDr 01 -07

I EXECUTE PHASE I

PL/l, RPG, FORTRAN I

COIlOL, ASSEMBLER JUST LINK EDITED

I LINKAGE EDITOR I

m. ~4

C PROCESSING PROGRAM SORT /MERGE

I CATALOG

~ ^~

^{I I} DOS linkage

I EdUct, I

I Y24-5Cf10 I

L _____

______ J

Ul 1-"

(D

~

rI'

UTILITIES

~ ^ii!!1

Ul

AUTOTEST

~ ^1m!

USER PROGRAM

~ ^m1

r---'

DOS lPL ond SET LOAD UNIT Job Control,

SWITCHES y24- 5086

DEPRESS LOAD KEY

---,

iii r---

_{, '} DOS Supervi $Or end Physical and sirnn, Y204-5084

IPL 01

( )

Logical Tron

IPL BOOTSTRAP 1 If':ITERRUPTS

lPL BOOTSTRAP 2 lPL-PHASE I

"-

(S$A$IPl2 ) LOAD AND

1M

INITIALIZE RESIDENT SUPERVISOR 1-6 A- TRANSIENTS 7-9 B - TRAN

THE SUPERVISOR ^{SIENTS 10-19}

$IPlRT2 02 ($$A$UP1) INTERRUPT ERROR RECOVERY

CANCEL, PROCESSORS, PROCEDURES, DUMP, PHYSICAlIOCS, PHYSICAL

IPl-PHASE 2 MPS MECHANISM ATTENTION ETC.

0mf. • ^1: ~ ^.l-

I ^{SJOBCTLA 03-11}

I FOREGROUND I

I

FOREGROUND'

I

BACKGROUND

I

I JOB CONTROL PROGRAM PROGRAM PROGRAM

I I

L _____ ~---J

L _________________________________

r---..L~~2'!..---...L12~~~---~:l---

MAINT 03 CORGZ 01-02 //EXEC CSERV CSERV 14

b$

COPY SYSTEM AND

R

MAINTENANCE CORE IMAGE

ROOT PHASE CREATE PRIVATE

SERVICE LIBRARIES

l

1

^{& IIEXE} DSERV DSERV 12-13

, CONDS OR ALLOC

~

DIRECTORY SERVICE

^!q

D~E

_MAINTCN ^~ 07

OR

I ^{RENAM MAINTDR 06 CONDENSE ~NY} //EXEC SERV RSERV 15

~

DELETE OR RENAME SYSTEM OR PRIVATE

~

ANY SYSTEM OR LIBRARY

RELOCATABLE

~

PRIVATE LIBRARY LIBRARY SERVICE

C LR MATNTR2 04 / /EXEC SSERV SSERV 16

~

RELOCATABlE ^CATALOG PRIVATE LIBRARY ^YES

-~

SOURCE STATEMENT

~

LIBRARY ~ LIBRARY SERVICF

(SYSTEM OR PRIVATE)

NO CATALS MAINTS2 05

CONDS AUTO CONDS

t

STATEMENT LIBRARY

^~ .. =""~

^REQUEST

~ 8m(

(SYSTEM OR PRIVATE)

CONDL MAINTCL 08 MATNTA 10 $MAINEOJ OS MAINTEJP 09

.~

SET CONDENSE

SYSTEM UPDATE SYSTEM CHECK CONDENSE

LIMITS FOR SYSTEM

REALLOCATION DIRECTORIES LIMITS AND DISPLAY

OR PRIVATE UBRARIES DIRECTORY

$LNKEDTC

"~ n

CATAL YES YES

CATALOG CORE PRIVATE liBRARY AUTO CONoS

I • IMAGE LIBRARY

I NO 2 3 NO

~----~---

I ENDOF JOB)

FOREGROUND INITIATOR

AND TERMINATOR

---...,

DOS librarian N'6linleoonce and Service, Y204-5079

o o

The resident version of the IBM System/360 Disk Operating System (DOS), System

Control, Version 3, provides disk operating system capabilities for 16K and larger System/360 configurations. At least one IBM 2311 Disk Storage Drive or IBM 2314 Direct Access Storage Facility is required.

Systems larger than 16K can benefit from this 16K package if they do not require the expanded fUnctions of the larger disk operating system packages offered by IBt-i.

The system is disk resident, using the IBM 2311 or IBM 2314 Disk Storage Drive for on-line storage of all programs. Depending on the requirements of the particular application, the system can be expanded to include all processing programs used to perform the various jobs of a particular installation, or it can be tailored to a minimum system to control a single program.

The operating system includes the following components: CPU, input/output channels, input/output control units, input/output devices, microprogramming, system control programs, support programs, user programs, user data files,

Teleprocessing capability, and multiple programming capability. This PLM discusses the supervisor and the physical and logical transients that are part of system control.

The supervisor and physical 10CS are specifically designed for a user's configuration by means of a one time assembly (generation time). They require reassembly only if the user's configuration changes.

The supervisor and physical IOCS provide the required interface between the program being executed and the other components of the operating system. The program

currently being executed is identified to the operating system as the current

program. The last program interrupted is identified as the problem program. The problem program or the current program can be, at any given time, either a system control

p~ogram,

a support program, or a user program.

The supervisor program operates with problem programs when job processing

(problem program execution) occurs. The supervisor program is divided into two parts:

1. The resident part, called the supervisor nucleus;

INTRODUCTION

2. The nonresident part, called a supervisor transient.

The nucleus is loaded into main storage at IPL.time and remains there throughout

job processing. A transient (one of many) is loaded, as needed, from the core image library of SYSRES. When a transient has . finished performing its service, it can be overlaid by some other transient when some other type of service is required. This technique maximizes the use of main storage allotted to the supervisor. The basic functions performed by the supervisor are:

• Storage protection (required for multiprogramming)

• Interrupt handling

• Channel scheduling

• Device error recovery

• Operator communications

• Program retrieval (fetch or load)

o End-of-job processing

• Timer services (optional).

Each installation must generate its own custom made supervisor by means of a one time assembly. Supervisor generation macros control the generation of the

supervisor control program. The user must reassemble the supervisor if its functions are to be modified (for example, when an installation configuration changes).

MULTIPROGRAMMING

For systems with main storage equal to or greater than 24K, disk operating system offers multiprogramming support. This support is referred to as fixed partitioned multiprogramming, because the number and size of the partitions is defined during system generation. The size of the

partitions may be redefined by the console operator, after system generation, to meet the needs of a specific program to be executed. Figure 1 illustrates the relationship among programs in a multiprogramming environment.

Introduction 11

GenE!'ral Organization

il'i""'~~~~~~;'S~::'::!!!l

Background At least 10K

Foreground 2 } Multiple of 2K (10K min. if BJF) Foreground I } Multiple of 2K (10K min. if BJF)

Foreground Organiza,tion General:

Save Area

Save Area:

Program Name (8 bytes)

General Registers

9 thru 8

64 bytes

Retum PSW (8 bytes)

Reserved Length of Label Area - 2 bytes 6 bytes

I e~

Floating Point Registers I of label

I 32 bytes

'- _ _ _ _ _ _ _ _ _ _ J area NOTE: Floating point register save area is required only when

floating point feature is specified for supervisor generation.

Figure 1. Multiprogram Main Storage organization

BACKGROUND VS FOREGROUND PROGRAMS

There are two types of problem programs in multiprogramming, background and

f'oreground. Foreground programs may operate in either the batched-job mode or in the single-program mode. Background

programs and batched-job foreground

programs are initiated by job control from the batched-job input streams.

Single-program foreground programs are initiated by the operator from the

printer-keyboard. When one completes, the operator must explicitly initiate the next program. Background and foreground

programs initiate and terminate independently of each other.

The system can operate one background program and one or two foreground programs simultaneously. The supervisor controls priority for CPU processing. Foreground programs have priority over background programs. All programs operate with interrupts enabled. When an interrupt occurs, the supervisor gains control, processes the interrupt, and gives control to the highest priority program that is in a ready state.

Control is taken away from a high priority program when that program encounters a condition that prevents continuation of processing until a

specified event has occurred. Control is taken away from a lower priority program at the completion of an event for which a higher priority program is waiting. When all programs in the system are

simultaneously waiting <i.e., no program can process}, the system is enabled for interruptions in the wait state.

The supervisor receives and processes interruptions. When an interruption

satisfies a program's wait condition, that program becomes active and competes with other programs for CPU processing time.

In addition to at least 24K positions of main storage, multiprogramming support requires the storage protection feature.

If the hatched-job foreground option is selected when the system is generated, all types of programs may be run as foreground programs. <Specifying the option causes the generation of individual communications regions for each partition.} However, the linkage editor and the maintenance

fUnctions of the librarian are restricted to the background partition.

12 DOS Supervisor and Physical and Logical Transients

This section of the manual describes:

1. Techniques used in supervisor generation.

2. Generation macros and their optional operands.

3. The relationship between the outer generation macros and the inner macros that generate the bulk of the

supervisor code.

4. The organization of the supervisor, including the nucleus code, tables, and information blocks.

To understand macro definition language structure and usage, refer to the DOS Supervisor and I/O Macros publication referenced in the preface. With this information, an SSERV listing of the supervisor generation macros, and the PLM material, the reader can identify those sections of code that are generated for his own supervisor program. The basic

instruction used in macro definition language is the AIF (ask if) statement.

The following examples show how i t is used:

1. AIF (&BG20).MP1

This instruction asks if

multiprogramming support is required.

If BG20 is on, the next significant line in the SSERV listing is found at the label, .MP1, and any intervening code is rejected by the language translator. If BG20 is not on, the next sequential line on the SSERV listing is significant.

2. AIF (NOT &BG20).N023

This instruction tests the opposite status of the BG20 switch. In this case, the line at location .N023 is the next significant line in the SSERV listing only when BG20 is not on, that is, only when multiprogramming support is not required.

A detailed description of the AIF

instruction and the other instructions used in the SSERV listing is given in the

Systems Reference Library publication, IBM Systeml360 Disk and Tape Operating Systems, Assembler Specifications, Form C24-3414.

SUPERVISOR GENERATION AND ORGANIZATION

SUPERVISOR GENERATION

The supervisor is assembled with a series of macros that describe the installation's fUnctional requirements and its

configuration. At system generation time, a source deck containing the supervisor generation macros is assembled into an object deck. The job control program places the results of the assembly on SYSLNK (I/O device for the linkage editor program) and calls the linkage editor program. The deck is link-edited and cataloged to the core image library on SYSRES. A corresponding core image library directory entry is posted for the new

supervisor, and the Program Information Department (PID) supervisor directory entry is deleted.

Normally, a condense maintenance program would then be executed to remove the PID supervisor from the core image library.

The procedures and sequence of events used in system generation are described in the publication, IBM Systeml360 DOS System Generation and Maintenance, Form C24-5033.

Whenever a new supervisor generation is required by the user the same general steps are taken:

1. Punch the macro instructions, together with the selected optional operands, into a card deck.

2. Execute an assembly, and put the . object modules on SYSLNK (using an

include control statement with no operand) via the job control program.

3. Link-edit the new supervisor, cataloging it to the core image library, deleting the

ol~

supervisor directory entry, and posting the new supervisor directory entry.

4. Re-IPL with the new supervisor.

5. Execute a maintenance program to condense the core image library, deleting the old supervisor program.

SUPERVISOR GENERATION MACROS

The list of supervisor macros and optional operands in Figure 2 is.presented to give the reader:

Supervisor Generation and Organization 13

• Supervisor generation macro names.

• Required macro sequence (as listed in Figure 2).

• Macro parameters. (Where there is an assumed value, that value is

underlined. )

Name Macro Description

SUPVR Describes system environment

CONFG Describes hardware features

STDJC

Sets standard values for job control variables.

Pcrameter=Option

SYSTEM=DISK MPS= {NO} YES BJF

TP= {NO } BTAM QTAM MICR=

NO I

1412 1419 14190

MODEL= {~}

Sp'= {NO}

YES DEC= {NO}

YES FP= {NO}

YES TlMER= {NO}

YES DECK= {~~}

LisT= {~~}

XREF= {~~}

ERRS = {~~}

LOG= {~~}

DUMP= {~~}

L1NES= {~}

DATE=

{~}

DMY CHARSET= {4BC}

60C LISTX= {NO}

YES SYM= {t!Q.}

YES

Figure 2. Supervisor Macros (Part 1 of 3)

• A brief description of what the generated macro does.

• A brief description of what the individual parameter options do.

Option Description

System residence (SYSRES) must be on a disk device.

Indicates multiprogramming support. If YES or SF J is specified, the system generated is capable of supporting two foreground programs.

YES or BJF must be specified if TP=QTAM. If BJF is specified, the

system generated will support batched mode for both foreground par- titions. Multiple communications regions are generated only

if MPS=BJF. MPS=YES is implied if MPS=BJF. -

Specify

if

Basic or Queued Teleprocessing Access Method (BTAM or

QTAM)

is

desired. When QTAM is specified, SVC support for BTAM

is also included.

Indicates whether the supervisor is to support magnetic ink character

reoders. If both 1412's and 1419's are present indicate 1419. 14190 indicotes Dual Address Adopter 1419's.

If 1412/1419's are attached

to the multiplexor channel the PIOCS parameter BMPX=YES is not supported.

nn defines the System/360 model number (30, 40, etc.);

Indicates the storage protection feature is desired. YES is assumed if

MPS =YES or BJF in the SUPVR macro.

Decimal feature.

Floating - point feature.

Timer feature. If TlMER=YES the supervisor macro GETIME is supported.

Output modules on SYSPCH.

Source modules listings from language translators on SYSlST.

language, translators output symbolic cross - reference lists on SYSlST.

Compilers summarize all errors in source programs on SYSlST.

listing of all control statements on SYSlST.

Dump of registers and main storage on SYSlST.

Number of lines per page on SYSlST.

Fo rmat of date.

Specifies the 48 or 60 character set for longuage translator input

on SYSIPT.

Hexadecimol ob ject module 'listings from compilers on SYSlST.

Assembler output symbol tables on SYSPCH.

14 DOS supervisor and Physical and Logical Transients

Name M~cro Description

FOPT

Describes functional supervisory options

Parameter =Option

OC= {NO}

YES PC= {~g}

IT=

NO I

BG

FI F2 TEB= {~O}

SKSEP= {NO}

YES

n

CE= {NO}

YES

n

CCHAIN = {NO}

YES

• SYSFIL=

I O;:!tn~,n2]) I

Option Description

Operator initiated communications to problem programs. If OC=YES the facility is available to all programs in MPS.

Problem program routine for program check. If PC =YES, the facility is available to all programs in MPS.

Problem program abi lity to set timer intervals and specify a timer inter- rupt routine. BG, FI, or F2 indicates which program has the facility.

When IT is specified far a partition, TIMER=YES is assumed in the CONFG macro. Timer support is available to only one program in MPS.

Tape error statistics are to be accumulated and logged where n is the number of tape drives attached to the system.

Specifies if SEEKs are to be separated from the remainder of channel programs. Seek separation allows other devices on the channel to be accessed (including other seeks) during the seek. YES indicates support for all DASD type devices specified by the DVCGEN macro at system generation time. n is the number of DASD devices to be supported and cannot be less than the number of DASD devices specified at system generation. The maximum number is 255.

Specifies the amount of core to be allocated to customer engineer serviceability routines. When YES is specified, 600 bytes are allocated;

when n bytes are specified, it must be for a minimum of 600 bytes.

Command chaining support for retry on I/O operations. When an error

occurs ond CCHAIN =YES, the user is allowed to retry ot the last CCW

executed instead of at the first CCW in the channel program as is the case in a normal retry. This option requires that the appropriate bit be

set in the CCB.

Supervisory DASD file protection, where (n,n) indicates the range of

channels to which DASD's may be attached. Specifying 2311 or 2314

indicates support for both. 2321 option indicates support for 2321

device as well as for 2311 and 2314. DASDFP prevents the user from

writing outside the extents of his file in case of program error. Extents are protected to the nearest cylinder.

System input and system output (SYSRDR, SYSIPT, SYSLST, SYSPCH)

files may be assigned to a 2311,2314, or both. Specifying either

indicotes support for both. If MPS=BJF in the SUPVR macro, support

is given for foreground logical units when running in botched mode.

n

1 =

residual capacity (in records) for beginning of operator notification

when SYSLST is assigned to a 2311 or 2314.

100S nl S 65536

If n 1 is omitted, 1000 is assumed

n2 = residua I capacity (in records) for beginning of operator notification

when SYSPCH is assigned to a 2311 or 2314.

100 S n2 S 65536

If n2 is omitted, 1000 is assumed.

*

Valid when at least 24K bytes of main storage are available.

PIOCS

Describes the system I/O configuration

SELCH= {~~}

BMPX= {NO}

YES CHANSW=

{ NO } RWTAU TSWTCH TAPE= NO

9"

7

Figure 2. Supervisor Macros (Part 2 of 3)

Selector channels attached to the system.

Burst mode devices will be supported on multiplexor channel. BMPX:::;

YES not supported with MICR.

Channel switching tape control unit. RWTAU=2404 or 2804, TSWTCH = 2816. If either 2404 or 2804

~

2816, RWTAU must be specified.

Indicates required tape PIOCS support. 9=nine track only, 7=seven or nine track, NO:::;No tope drives attached. NO is the assumed value.

Supervisor Generation and Organization 15

Name ALLOC

IOTAS

DVCGEN

ASSGN

SEND

Macro Description

Partitions storage for MPS (Optioneil macro).

Describes installation requirements for I/O tables.

Parameter = Option {Fl=nK, F2=nKI

IODEV={~}

BGPGR={];Q}

F1PGR={~}

F2PGR=m

CHANQ={*}

JIB=m

Specifies I/O devices. Each device typP requires CHUN = {X1cuull a separate DVCG EN macro. (See note Hor

DVCGEN rules. This is an optional macro.) DVCTYP= {xxxxxxl

Sets standard background I/O assignments. A separate macro is required for each standard assignment desired. (Optional macro) CAUTION: The AS$GN macro allows SYSRDR, SYSLST, SYSPCH, and SYSIPT to be assigned to a tape or DASD. However, IPL unassigns any such assignments.

Indicates end of supervisor generation.

CHANSW={NO}

YES MODE = {X'ss' I

{ SYSxxx,X1CUU

I }

{n I

Note 1: Rules for Using DVCGEN

1. A separate DVCGEN macro instruction is required for each device.

Option Description

Specifies storage partitioning MPS, where n must be a multiple of 2.

Must be at least 10K if MPS=SJF.

Number of I/O devices attached to the system

Number of symbolic units of the class SYSnnn for the background program.

Number of symbolic units of the class SYSnnn for Fl. Valid only in MPS.

Otherwise zero is assumed.

Number of symbolic units of the class SYSnnn for F2. Valid only in MPS.

Otherwise zero is assumed.

Number of I/O requests in the channel queue. 6 is the minimum value generated.

Number of Job Information Blocks (JIBs) for the system. Requirements are:

1. One JIB for each temporary logical unit assignment.

2. One JIB for each alternate logical unit assignment.

3. One JIB for each open 2311·or 2314 extent with the DASD file protect feature.

4. Two JIBs for each open 2321 extent with the DASD file protect feature.

Specify the hexadecimal number of the channel and unit for the device.

Specify the device type. See Figure 21.

Specify if the device is attached to more than one selector channel. If it is, the device can be switched.

1. 2400T9. MODE specifies the tape mode. X'CO' is the default value.

2. 2400T7. MODE specifies the tope mode. X'90' is the default value.

See Figure 22 for other values.

3. 2702. MODE designates the SADxxx command. X'OO' is the default value.

X'OO' SADO X'OI' SADI X'02' SAD2 X'03' SAD3

4. 2260 (Local). MODE is used to specify the 1053 printer when CH UN = X 'cuu' refers to a 1053 attached to a 2848. The operand must be entered as MODE=X10t ' •

5. 1412/1419. MODE designates the external interrupt bit associated with Magnetic Ink Character Readers. The modes X'OI' through X'2D ' correspond to external interrupt PSW bits 31 through 26 respec- tively. For the dual address adapter 1419, this parameter is needed for both the 1419P and 14195 device types.

X'Dl l Device attached to external line 7.

X'D2

¹

Device attached to external line 6.

X'D41 Device attached to external line 5.

X'DB' Device attached to external line 4.

X' l0 ' Device attached to external line 3.

X'2D ' Device attached to external line 2.

SYSxxx is any background symbolic logical unit (SYSIPT, SYSLOG, etc.) or programmer logical unit (SYSOOO, SYS001, etc.). X'cuu' is the hexadecimal number of the channel and unit to which the symbolic device is attached.

Spec;:ifies the beginning address of the problem program area. An area should be reserved for supervisor expansion and maintenance. The parameter is optional. If not specified, no area is reserved beyond the assembled last address of the supervisor.

2. The total number of DVCGEN macros must not exceed the total number of devices specified in the 10DEV parameter of the IOTAB macro.

3. DVCGEN macros must be specified in ascending channel address sequence.

4. Switchable units (attached to more than one selector channel) must be defined once. They are defined on the lowest channel on which they are addressable.

5. The sequence of the DVCGEN cards determines the priority of the devices on their channel. Switchable units must be the last devices for each channel, and must be on consecutive channels.

6. The specifications of these macros may be altered by IPL ADD and DEL statements. See IPL PLM, Y24-5086.

Figure 2. Supervisor Macros (Part 3 of 3)

16 DOS Supervisor and Physical and Logical Transients