Property of IBM

- ^- - ^{L Y21 -0050-0}

- _{- - - - - - -} - - _{- - ---} File No. S34-36

- - - ^--- - - --

- - ^• - Licensed Material

Property of IBM

IBM System/34

System Support Program Logic Manual: System

Program Number 5726-SS1

- - _{- - - - -} - - _{- - - - ---} ^{- -} L Y21-0050-0 File No. S34-36

- - - ^---

- - ^{- - - •} - - Licensed Material

Property of IBM

IBM System/34

System Support Program Logic Manual: System

Program Number 5726-SS1

First Edition (December 1977)

This edition applies to version 01, modification 00 of the IBM 5ystem/34 System Support Program Product (Program Number 5726-551) and to ~II subsequent versions and modifications until otherwise indicated in new editions or technical newsletters.

Changes are periodically made to the information herein; before using this publication, refer to the latest IBM System134 Bibliography, GH30-0231, for the editions that are applicable and current.

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

A Reader's Comment Form is provided at the back of this publication. If the f~rm has been removed, address your comments to IBM Corporation, Publications, Department 245, Rochester, Minnesota 55901.

©Copyright International Business Machines Corporation 1977

Licensed· Material-Property of IBM

(

This logic manual is designed to aid I BM support personnel in maintaining the IBM System/34 by serving as a recall mechanism and guide to program listings. This manual does not contain directions for programming or operating the system.

Note:

The System Support Program Product is documented by two manuals: this manual and IBM System/34 System

Support Program Logic Manual: Data Communications,

LY21-0051.

The SSP (System Support Program Product) provides the programming support necessary to start the system, process commands, start a job, run a job, and terminate a job. Its functions include:

• Main storage IPL

• Command processing

• Initiator

• Allocate

• Open

• Data management

• Diskette end of volume

• Keysort

• Spool intercept

• Spool print writer

• Close

~

Termination

• System service programs

• System maintenance programs

• Overlay linkage editor

• System uti! ity programs

Preface

This manual describt!s the SSP modules by providing:

• A system flow overview of the entire SSP.

• An overview of each of the primary components of the SSP.

• A detailed description including, as required: a descrip-, tion of the function, a HIPO diagram, and a logic flow diagram for each function contained within the SSP.

• Significant data areas, as required. For data areas not described in this manual, see the Data Areas Handbook.

Note:

The arrowheads ( . 4 ) that occasionally appear in the HIPO extended descriptions are provided to help you line up the descriptions with their respective module references.

RELATED PUBLICATIONS

This publication references the following publications:

• IBM System/34 System Data Areas and Diagnostic

Aids, L Y21-0049

• IBM System/34 System Support Reference Manual, SC21-5155

• IBM System/34 System Support Program Logic Manual:

Data Communications,

LY21-0051

• IBM Systemt34 Overlay Linkage Editor Reference

Manual, SC21-7707

iii

Licensed Material-Property of IBM

(

iv

Licensed Material-Property of IBM

PART 1 INTRODUCTION

INTRODUCTION • • • • • • • • • • • • • • • • • • • • • • • • • • • • 0·1

PART 2. SYSTEM SUPPORT PROGRAM PRODUCT

CHAPTER 1. STARTING THE SYSTEM • • . • • • • • • • • • • • 1·1 INTRODUCTION . . . . • . . . • . • • . • • • • • • . . . • . • . . . 1·1 Main Storage Initial Program Load (IPL) • . • . . . • . . . 1·1 System Configuration ($CNFIG) . . • • • . • . . . . • . • . • . . • 1·2 Rebuild VTOC Format l's . . . • . • . . • . • . . . . • . • • • . . • 1·2 METHOD OF OPERATION . . • . . . • • . . • . • . • . . • • . 1·3 PROGRAM ORGANIZATION . • . • • • . • • • . . • . . • • . • 1·22 CHAPTER 2. PROCESSING COMMANDS • • • • • • • • . • • • • 2·1 INTRODUCTION . . . . • . • . . • . . • • . • • . . . • . . . • . . • 2-1 Command Processor . . . • • . . . • • . • . . ' • • . . . • . 2-1 Router • . • . • . . . • . . . • . • . . . . • . . . • • . • . . • • . 2-1 Sign on . • . . • . • . . • • . • . • • • • • • • • • . • . . • . . • • 2-1 Process Control Commands • . . . • . • . . • • . • . • • • . . .2-3 Job Initiation and Work Station Release • . . . . • • . . • . . • 2-3 High·Level Aids and Task·to·Task Communications Router .. 2·3 Inquiry Menu Option Processor and Resume • . • . . . • • . • 2·6 Special Command Processor • • . • . . • . • . • . • . . • • . . • 2·6 Command Processor /Work Station Data Management

Interface . • . . • . . • . . . . • . . . • . • • • . • . . . 2·6 Console Management • • . • . . . . • . • • . . • . . • . • • . • • 2-7 Command Processor Cleanup . • . • • • • . • • . . . • • . 2·7 Password Security. • • . . • . • . • • . • . • • • • • . . . • • . .2·7 I/O Error Recovery . • . • • . . • . . • • • . . • . • • . . . • 2·8 METHOD OF OPERATION . . • . • . . • • . . • . . • • . • . . . . 2·9 PROGRAM ORGANIZATION . • . . • . • . • • • • • . • • • • . 2·77 CHAPTER 3. STARTING A JOB • • • • • • • • • • • • • • • • • • 3·1 INTRODUCTION . • . • • . • • . • . • • . • • . • • . • • • • • . . . 3·1 Initiator • • • • • • • • . • . • . . . • . • • . . . . • • . • . • . . 3·1 Reader/Interpreter Function • • . • . . • . • • • • • • • . • . . 3·1 Disk File Initialization Function • . • • . • . . • . • • • • • . • 3·3 Program Initialization Function . . • . • . • • . . • . . . 3-3 Allocate • • • • . • . • • • . • • . • • • • • . • • • • • • • . • • • . • 3-4 Normal Allocate . . . 3-4 Special Allocate • • • • • • • • • • . • • • • . . • • • • . • . • • . 3·5 Deallocate . . • • • • • • • • . • • . • • • ' • • • • • • • • • . • . . 3·5 Open • • . . • • • • • • • • . • • • • • • • • . • • • • • . • • • • • • • 3·5 Common Open 1 (tiDMOP) . • • • • • • . • • • • • • . . . • . • 3·6 . Disk Open (tlDD10P, tlDD20P) • • • . • • • . • • • • . • . . • 3·6 Work Station Open (t/WDOPN) . • . • • • . • • • • • • • • • • . 3-6 Diskette File Open (tiDROP) • . • • • • • . • • • . • • • • • • • 3-7 Common Open 2 (tiDMOF) • • • • • • • • . • • • . • • • . • • . 3-7 Printer Open (within tlDMOF) • • • • • • • • • • • • • • . • • • 3-7 METHOD OF OPERATION . • • • • • • • . • . • • • • • • • • • • • 3-9 PROGRAM ORGANIZATION • • • • • • • • • • • . • . • • • • • 3·33 CHAPTER 4. RUNNING A JOB • • • • • • • • • • • • • • • • • • • 4·1 INTRODUCTION . • . • • • . • • . • . • • . • . . • . • . • . • . • .4-1 Disk Data Management • • • • • • • • • . • • • • • • • • . • • • • • • 4-1 Consecutive Access Method • • • • • • . • • • • • • • • • • • • • 4-1 Direct Access Method • • • • • • • . • • • . • • • • • • • • • • . 4-1 Indexed Random Access Method. • • • • • •. • • • • . • • . 4·4

Contents

Indexed Sequential Access Method. • . . • • . • . . . • . 4-4 Indexed Sequential/Random Input Access Method • . . . . • • 4·5 Description of Access Method Drivers . . • • • • . • • • . • • . 4·5 Sector Data Management to Disk (tiDDSM) . . . • • . . . . • • • . 4·8 Data Transfer Modes - Locate and Move . . • • . • • • • • . ,4·8 Diskette Data Management (tlDRDM) . • . • . . • • . • . • . • . ,4·9 Diskette End of Volume (tlDRNV) . . . . • . . . . • . • . • . • . .4·9 Sector Data Management to Diskette (tlDRSM). . . . • . . . . .4-10 Printer Data Management • • • • . . • • • • • . . • • • • • • . • .4-10 Work Station Management. • • . • • • • . • • • . • . • • . . . . .4 -10 Work Station Data Management . . . 4-11 Keysort . • . . . • . . . • . . . • . • • • . • • • . . • . . 4-12 Spool Intercept . . . . • . • . . • • . • • . . . • . • . . . • . • • . 4-15 Spool Print Writer . . . • . . . • . • . . • • . • . . . • . 4-16 METHOD OF OPERATION . . . • • . . • . • • . . . . • . . . 4-17 PROGRAM ORGANIZATION . . • • • • . . . • . . • • • . .4·36 CHAPTER 5. TERMINATING A JOB • • • • • • • • • • • • • • • • 5·1

INTRODUCTION . . . • . • . . . • . • . . • . . • . • • . . . • • . . 5·1 Close . . . . • • • . • • . . • . • • . . . . • . . • . • • • . • . • . . . 5-1 Common Close (tlDMCL) • . • • . . . • • . . . . • . • . • . 5-1 Printer Close (within tlDMCL) . • . • . . • • • . . . 5-1 Work Station Close (within tlDMCL) . . . • . . . • ' • • . • • . . 5·1 Binary Synchronous Communication Close (tiBSCL) . • . . . . 5·3 Diskette Close (tlDRCL) . . • • . • . . • • • . . . • . . . • . 5·3 Disk Close (tlDDCL) • • • . • • • • . . • . . . • . . • . 5·3 Termination . • • . • • • . • • • • . . . • • • . . • • . . . 5·3 Step Termination • • . . . . • . . . • . . • . . . • . • • 5-3 Job Termination . . . . • . . . . • . • . . . . • . • . • . • • • . 5·3 Abnormal Termination . . . • . . . • . • • • . . . 5·4 Termination Interface . . • • . • . . . • • . . • . . . . • 5·4 METHOD OF OPERATION . • • • • . • • . . • . . • . • . . . • • . 5-6 PROGRAM ORGANIZATION • . • . . . • • • • . • • • . • 5·12

PART 3. SPECIAL FUNCTION PROGRAMS

CHAPTER 6. SYSTEM SERVICE PROGRAMS • • • • • • • • • • 6-1 INTROOUCTION . . . • • . • . • . • . . • . • . • . . . • • . • . . • 6·1 Librarian Facilities . • • . . . . • . . • • . • • . . • • • . . • . . . . 6-1 Find a Library Routine . . . • • • • • . • • . • • . • • • • . . . • 6·1 Single Name Find Routine . • • • . . • . . . • • . . . • . • . 6·2 Librarian Find Routine . . . • . • • . • . . • • . • . . . • . • . • 6-2 Source Library Get Routine • • • • • • . • . . . • . . • . • . . • 6·2 Library Record Put • • • • • . • • • • • . . . • • • • . . . 6·3 Library Sector Get/Put . • • • . . . 6-3 Library Member Protection • . . • • . • . • • . • • . • • • . . • . . 6·3 Active Format 1 Area Access Routine • • • . • • • . . • • • . . . • 6·5 Cross·Reference Resolver . . • • • • . • • • • • . • • • • . . • . . • 6·5 Duplicate Key Display Routine • • • • . • • . • • . • . • • • . • • • 6-6 Print Image Verify Routine • • • • . • . . . • . • • • • • . • . . . • 6·6 Disk VTOC Read/Write • • • • • • • • • • • • • • • • • • • • • • . • 6-7 Diskette VTOC Read/Write . • • • • • . • • . • • . • • • • • • • . • 6-7 Message Retrieve • • • • • • • • . • • • • • • • . • • • . • • • . • . • 6·8 SYSIN • • • . • • • • • • . • • • • • • • • . ' • • . • • • . • • • • • • • 6·8 SYSLIST • • • • . . • • • • • • . • • • • . • • . • • • • • • . • . • • • 6·9 SYSLOG • • . . • • • • . • • • • • • • • • • • . • • • • • • • • . • . . 6·9 History File Put • • • • . • • • • • • • • • • • . • • • • • • • • • • • 6-10 Supervisor Task Attach Transient (tiSVAT) • . • • • . . • • . • • 6-11 Supervisor Task Detach or Change Origin Point (tiSVAU) •••• 6-11

v

Licensed Material-Property of IBM

Change Point of Origin . . • . . . • • 6-11 Detach Task • • • • • • . • • . . . • . • • . . • • . . . • . • . . 6-11 Syntax Checker (#USYX) • • . • • • • • . . . • . . . • . . . • 6-12 Information Retrieval (#SVINF) . • . . • • • . • • • . . • . • . . 6-12 Data Management Task Transfer Control (#SVTTC) . . . • . 6-12 Snap Dump (#SVDMP) • . • • • . • • . • . . . . • . . . • . . . • . 6-13 METHOD OF OPERATION . • • • • • . • • • • • • • • . . . • . . 6-14 PROGRAM ORGANIZATION . . • . • • . • . . . • . . • . . . • 6-53 DATA AREAS • . • . • . • . . • • • • . • • • . . • • • . . . • 6-69 Find a Library Parameter List . • • . . . • . • • . . . • • • • 6-69 System Find Parameter List . • . • . . • • . • . • . • . . . • . 6-69 Librarian Find Parameter List • • . • . . • . • • . . . . • • . . . . 6-72 Source Library Get Parameter List • . • • . • • • • . . • • • • • . 6-74 AFA Access Parameter List • • . • . . • • . . • . . • . . . • . 6-76 Duplicate Key Display Parameter List . • • • . . • • . • . . • • • 6-77 Supervisor Task Attach Parameter List • . . • . • • . • . . . • . . 6-78 Supervisor Task Attach Error Return Code . . • . • • • . • . • • 6-80 Syntax Specification Module . . . • . . . . • . • . . . 6-80 Verb Record - VERB • . . • • • . • . . • • • • • . • . . • • . • . 6-81 Parameter Records . . • . • • . . • • . • . . • . . . • . • . . . • . 6-81 Positional Parameter Record - POSIT • • . • • • • • • • . . • . . 6-81 Keyword Parameter Record - KEYWD . . • • • • . . . • . . . . 6-83 Substitution Table - SUBEN • . • . . • • • • • . . • . . • . • . • 6-83 Valid Combination Record . • • . • • . • • • • • • . • • . • . . • 6-85 Syntax Checker Communication Table - USCTABLE . • . • . . 6-87 Syntax Checker Parameter List • • . • • . • • • • • • • • . • . . . 6-90 CHAPTER 7. SYSTEM MAINTENANCE PROGRAMS. _ •••• 7-1 INTRODUCTION • • • . • . • . • • . . • . • • • • • . . • • • • . . • 7-1 METHOD OF OPERATION . . . • . • • . • • . . . • • • . . • • . • 7-2 PROGRAM ORGANIZATION . • • • . . • • • . . • . • • . • . . 7-12 CHAPTER 8. OVERLAY LINKAGE EDITOR ••••••••••• 8-1 INTRODUCTION . . . . • • . . • • • • • • • • • • • • . • • . . • . . 8-1 Compiler Entry . . . • . . . . • • • • • . • • • • • • • • • • 8-1 Input for Compiler Entry • • . • . • • • • • • • • . • • • • • • • • • 8-1 Output from Compiler Entry • • • • • • • • . • • • • • • . • • . . . 8-1 User Entry • . . • • . • • . . . • • • . • • • • . • . • . • • . . • • . . 8-5 Input for User Entry • • • • • • • • • • • • . • • • • • . • • • • . • . 8-5 Output frpm User Entry . • • • • • • • • • • • . . • . • • . • • • • .8-5 Overlay Linkage Editor Phases and Routines • • • • • • • . . • • • 8-5 Minimum Storage Requirements • • • • • • . • . • • • . • • . • 8-5 METHOD OF OPERATION • . • • • . • • • • • . • • • . • • • . • • 8-7 PROGRAM ORGANIZATION •••••••••• ' • • • . . • • • • 8-24 DATA AREAS • • • • • • • • • • • • . • • . • • • • • . • . • • • • 8-29 Overlay Linkage Editor Common (LOMMON) • • • • • . • • • • 8-29 Verb List (OVERBS) . • . • • • • • • • • • • • • • • • • • • • • • • 8-29 Segment List Entries • . • • • • • • • • . • • • • • • • • . • • • • • 8-29 Overlay Fetch Routine • • • • • • . • • • • • . • • • • • • • • • • • 8-43 How to Find an Overlay • • • • • . • • • • • . . • • . • • • • . . • 8-44

PART 4. SYSTEM UTI LlTY PROGRAMS

CHAPTER 9. BACKUP LIBRARY UTILITY ($BACK) •••••• 9-1 INTRODUCTION • • • • . • • • • . • • • • • • . • • • • • • • • • • . 9-1 METHOD OF OPERATION • • • • • • • . • • • • • . • . . • • • • • 9-2 PROGRAM ORGANIZATION . • • • • • • . • • • • • • • • . • • . 9-6 CHAPTER 10. BASIC EXCHANGE UTILITY ($BICR) •••• 10-1 INTRODUCTION . • • • . • • • • • • • • . • • • • • • • • • • • • . 10-1 METHOD OF OPERATION • • • • • • • . • • • • • • • • • • • • . 10-5 PROGRAM ORGANIZATION • • • • • . • • • • • • • • . • • • • 10-9 DATA AREAS • • • . • • • • • • • • • • • • • • • • • . • • • • • 10-11 BICCVLST Verb List • • • • • • • • • • • • • • • • • • • • • • • • 10-12

vi

CHAPTER 11. BUILD MENU UTILITY ($BMENU) •••••• 11-1 INTRODUCTION • • • • . • . • . • . • • . • • . • • • . • • • • • • 11-1 METHOD OF OPERATION . • . . . • . • • • . . • • . • • • • • • 11-2 PROGRAM ORGANIZATION . . . • . • • . . • • • • • • • . • • 11-6 CHAPTER 12. ALTERNATE SECTOR REBUILD

UTILITY ($BUILD) • • • • • • • • • • • • • • • • • • • • • • • • 12-1 INTRODUCTION • • . . • • • • • • • • • • • • • • • • • • . • • • . 12-1 METHOD OF OPERATION • • . . • • . • • • • • • • • • • • . • • 12-2 PROGRAM ORGANIZATION • • • • • • • • • . • • • . • • . • . 12-5 CHAPTER 13. DISK COPY/DISPLAY UTILITY

($COPY) • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 13-1 INTRODUCTION • . • . • . . . • • • . • . • • • . • • . • • • • . . 13-1 METHOD OF OPERATION . • . • • • . • . . • . • • • • . • • • . 13-3 PROGRAM ORGANIZATION . . • . • . • . • . • • • • • • . • 13-14 DATA AREAS . • . • . • . . • • • • • • • • • • . • . . • • • • • 13-20 Verb Lists - PYZV L 1, PYZV L2, PYZV L3 13-20

$COPY Common Communication Area - $CCCA . • . • • • . 13-20 Embedded Format 1 • • • • • • • • • • • • • . . • • . • . . • . • 13-26 CHAPTER 14. FILE DELETE UTILITY ($DELET) •••••• 14-1 INTRODUCTION • . • • • . • • • . • • . • • . • • • • • • • . • • • 14-1 METHOD OF OPERATION • • • • • • • • • . • . • • . • • • • • • 14-2 PROGRAM ORGANIZATION • • • • • • • . • . • • . • • • • • • 14-6 CHAPTER 15. DISKETTE COpy UTILITY ($DUPRD) •••• 15-1 INTRODUCTION . • . • • • • . . • • • • • . • • . • • • • • • • • • 15-1 METHOD OF OPERATION • . • • • . • . . . • . . • • . • . • 1'5-2 PROGRAM ORGANIZATION • • • . • . . • • . • • • • • • • • • 15-6 CHAPTER 16. FILE BUILD UTILITY ($FBLD) •••••••• 16-1

INTRODUCTION . • • • • . • • . • . • • • • • • • . • • • • . • • • 16-1 METHOD OF OPERATION . • • • • • • • • • • • . • . • • . • • • 16-2 PROGRAM ORGANIZATION • . • • • • • . • • • • • • • . • • • 16-4 CHAPTER 17. HISTORY FILE DISPLAY UTILITY

($HIST) • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 17-1 INTRODUCTION • • . . . • . . • . • • . • • • • • . • • . • • • • • 17-1 METHOD OF OPERATION . • • • • • • • • • • • . • • • • • • • • 17-3 PROGRAM ORGANIZATION . • • • • • • • • • • • • • • • • • • 17-6 CHAPTER 18. DISKETTE LABELING AND

INITIALIZATION UTILITY ($INIT) • • • • • • • • • • • • • • 18-1 INTRODUCTION • • • • • • • • . • • • • • • • • • • • . • • • • • . 18-1 METHOD OF OPERATION . . • • • • • . • • • . • • . • • • • • • 18-2 PROGRAM ORGANIZATION . • • • • • • • • • • • • • • • • • • 18-5 DATA AREAS • • • • • • . • • . • • • • • • • • • • • . • • • • • • 18-6 VERBSUVE, VERBSVE, and VERBSEVerb Lists •••••••. 18-6 CHAPTER 19. VTOC DISPLAY UTILITY ($LABEL) ••••• 19-1 INTRODUCTION • . • • • • • • • • • • • • • • • • • • • • • • . • • 19-1 METHOD OF OPERATION • • • • • • • • • • • • • • • • • • • • • 19-2 PROGRAM ORGANIZATION • • • • • • • . • • • • • • • • • • • 19-6 CHAPTER 20. RELOAD LIBRARY UTILITY ($LOADI) ••• 20-1 INTRODUCTION • • • . • • • • • • • • • • • • • • • • • • • • • • • 20-1 METHOD OF OPERATION • • • • • • • • • • • • • • • • • • • • • 20-2 PROGRAM ORGANIZATION . • • • • • • • • • • • • • • • • • • 20-6 DATA AREAS ' • • • • • • • • • • • • • • ' • • • • • • • • • • • • • • 20-7

$LOADI Communication Area ••••• ',,' •••••••••••• 20-7

Licensed Material-Property of IBM

CHAPTER 21. LIBRARY MAINTENANCE UTILITY

($MAINT) •••••••••••••••••••••••••••••• 21·1 INTRODUCTION ••••••••••••••••••••••••••• 21·1 METHOD OF OPERATION ••••••••••••••••••••• 21-4 PROGRAM ORGANIZATION ••••••• ' .••••••••• '.21·22 DATA AREAS •••••••••••••••••••••••.••• 21-32 Library Common Area - CNTLBMSG •••••••••••••• 21·32 CHAPTER 22. MESSAGE BUILD UTILITY ($MGBLD) •••• 22·1 INTRODUCTION ••••••••••••••••••••••••••• 22·1 METHOD OF OPERATION. • • • • • • • • • • • . • • • • • • • • 22·2 PROGRAM ORGANIZATION ••••••.••• ' .•••••••• 22·5 CHAPTER 23. DISK REORGANIZATION UTILITY

($PACKI$FREE) •••••••••••••••••••••••••• 23·1 INTRODUCTION . • • • • . • • • • • • • • • • . • • • • • • . • • • 23-1 METHOD OF OPERATION • . • • • • • • . • • • • • • • • . • • • 23·2 PROGRAM ORGANIZATION • • • • • • . • . • • . • • • • • • • 23·5 DATA AREAS • • • • • • • • • • • • • • • • • • • • • • . • • . • • 23-6 FRETB Tabl~ •••••••••••••••••• L • • • • • • • • • • 23·6 CHAPTER 24. SECURITY FILE·UTILITIES •••••••••• 24·1 INTRODUCTION • • • • • • . • • • • . • • . . • • • • . • . . . • . 24-1 METHOD OF OPERATION • • • • • • • • • . • • • • • . • • • • . 24·2 PROGRAM ORGANIZATION . . • • • • • . • . • . • • • . . • • . 24·9 CHAPTER 25. FILE RENAME UTILITY ($RENAM) ••••• 25·' INTRODUCTION . • • . • • • • • • • • • . • • • . • • • • • • • • • 25·1 METHOD OF OPERATION • • • • • • . • • . • • . • . • . • • . . 25·2 PROGRAM ORGANIZATION . • • • . • • • • . . • • • • • • • • 25·5

CHAPTER 26. WORK STATION CONFIGURATION

($SETCF) •••••••••••••••••••••••••••••• 26·' INTRODUCTION ••••••••••••••••••••••••••• 26·1 METHOD OF OPERATION • • • • • • • • • • . • • . • • • • • • • 26·2 PROGRAM ORGANIZATION ••••••••••••••••••• 26-6 CHAPTER 27. SCREEN·FORMAT GENERATOR

UTILITY ($SFGR) ••••••••••••••••••••••••• 27·' INTRODUCTION • • • • • • . • • • • • • • • • • . • . • • • • • • • 27-1 METHOD OF OPERATION •••••.••••••••••••••• 27·3 PROGRAM ORGANIZATION • . • • • • • • • • . • • • • • • • • 27·8 CHAPTER 28. COMMAND PROCESSOR PROCEDURE

ERROR UTILITY ($CPPE) ••••••••••••••• ' ••••• 28·' INTRODUCTION • • • • • • • • • • • • • . • • • • • • • • . • • ' .• 28·1 METHOD OF OPERATION • • • • • . • • . • . • • • • • • • • . • 28·2 PROGRAM ORGANIZATION ••••••.•••••• , •••.• 28-4

APPENDIXES

APPENDIX A. DIRECTORY •••••••••••••••••••• A·' APPENDIX B. LIST OF ACRONYMS AND

ABBREVIATIONS •••••••••••••••••••••••••• B·'

vii

Licensed Material-Property of IBM

(

viii

Licensed Material-Property of IBM

How to Use This Manual

Diagram numbers are assigned by chapter (for example, all diagrams in chapter 1 are numbered 1.nn). Any diagram with a zero preceding the first period (Diagram 0.1, for example) is a table of contents diagram for the SSP. Similiarly, any diagram with a zero following the first period is a table of contents diagram for its respective chapter. Each entry in a table of contents diagram identifies a particular input - process - output type of diagram. The input - process - output diagrams describe functions and are found in the Method of Operation section of each chapter of this manual.

Licensed Material-Property of IBM

ix

(

x

Licensed Material-Property of IBM

The main objective of the HIPO method of diagramming is to improve communication procedures and techniques through the effective use of functional operation diagrams.

H IPO, hierarchy plus input - process - output, is a method of graphically describing internal function by structuring a presentation from general to detailed levels in a set of method-of-operation diagrams.

A visual table of contents is prepared for each set of func- tional diagrams. It shows:

• The structural relationships of the diagrams

• The contents of each of the diagrams

• A legend applying both to the individual function dia- gram and the total presentation

Each set of functional diagrams contains a visual table of contents, one or more overviews, and a number of low level diagrams showing the implementation and/or design of a function. The implementation of a major function can extend through many modules or routines.

Module 1 Module 2 Module 3

[J~B

A specific module might support parts of many functions.

Sometimes these functions are not even related.

Module 2 B B+C

C A

Functional Diagram Techniques

Someone who must modify an existing function, add a new function, test for regression, or fix the system must know:

• How the function is performed

• What other, perhaps nonrelated, functions use the same code

Graphic Content: The graphic content is determined by the situations shown.

The table of content diagrams act as introductions to the functions and directors to the low level, detailed diagrams.

Legend

.. ^----

=)----

D ----

Contents

1.:=-.::= 6.=-:=:

2.==-=

7.~.:..-:::

3.::-:.-_-= 8.:..-.=

4 ---. 9.===

5.=:.= 10.=::.:

xi

Licensed Material-Property of IBM

The low level diagrams contain unit level information (that level of information reflecting the actual workings of the system). Each low level diagram is arranged to best show:

• A process that supports the function being described

• Results of the process

• Requirements for processing Stated graphically:

Input Process Output

To tie together the program organization and functional areas, the function diagrams use cross-references from one area to another and to the listings.

xii

Functional Descriptions

p

/ \

/ \

/ \

/ \ \

/ \

/ \

~---~~

Listings Routines

Informational Content: Functional diagrams should discuss inputs: process, and results. For the sake of clarity, these elements are presented in a normal reading sequence. Sim- ple boxes are used to block off these three major areas of the diagram.

The picture area of the diagrams contains as few words as possible. There are two reasons for this:

• When the picture becomes cluttered with text, it loses some value as a recall mechanism.

• The degree of difficulty of maintaining the diagrams increases with increased number of words in the picture area.

In the diagrams, functions are related by cross-references to the module(s) supporting those functions. The description box of the diagram includes the references of the module(s) associated with the implementation steps that support the function.

Licensed Material-Property of

IBM

INPUT _ _ _ _ _

DESCR IPTION

D ^{- --}

fJ - ^-

IJ ^-

II

\ \

a...s:.;:0CESS

-- ^-

o

fJ II II

- - -

- - - - - - -

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

- - - -

- - - -

- - - - -

- - -

- - - - -

- - _{- - -} ^-

~

Process steps 1 and 2 are performed. in PHAS1.

Before step 3, passing of control is implied by the horizon- tal line through the routine column. Steps 3 and 4 are per- formed in PHAS2.

Licensed Material-Property of IBM

OUTPUT _ _ _ _

MODULE/

ROUTINE PHAS1

PHAS2

Legend:

. . Control flow (leads the reader through the process)

=::::::::> ^{Data flow} D Reference block

xiii

(

xiv

licensed Material-Property of IBM

Part 1. Introduction

Licensed Material-Property of IBM

Licensed Material-Property of IBM

This program logic manual provides diagnostic information and serves as a recall mechanism for the IBM programming representative working on a System/34 problem. H I PO and control flow diagrams help guide the programming repre- sentative to the proper module on microfiche. If a main system module is not causing the problem, the directory in Appendix A can help locate additional information in this manual and on microfiche.

Figure 0-1 is an overview of the logic documentation avail- able for System/34. It lists the major components of each PLM.

Figure 0- 2 shows the system control flow and major divi- sions of the SSP. Part 2 of the manual follows the same major divisions as shown in this diagram.

Introduction

Diagram 0.1 is an overview of the SSP. Within this over- view are overviews of the system service programs, the sys- tem maintenance programs, the overlay linkage editor, and the util ity programs.

Information presented in this manual, accompanied by information in the

Data Areas Handbook,

is used to inter- pret main storage dumps. Appropriate module I istings on microfiche are then consulted as necessary to initiate a circumvention to the program problem and to write an APAR. The

Data Areas Handbook

can then be used to help apply the program temporary fix.

Introduction 0-1

Licensed Material-Property of IBM

I

IBM Systeml34 System Support Program Logic Manual: System, L Y21·0050

Component/Funct.ion Diagram Chapter

Starting the system 1.0 1

ProceSSing commands 2.0 2

Starting a job 3.0 3

Running a job 4.0 4

Terminating a job 5.0 5

System service 6.0 6

programs

System maintenance 7.0 7

programs

Overlay linkage 8.1,8.2 8

editor

IBM Systeml34 System Data Areas and Diagnostic Aids Handbook, L Y21·0049

•

System overview

•

Data areas

•

Diagnostic aids

•

I/O controllers

•

Troubleshooting aids

•

Work station utility

I

IBM Systeml34 System Support Program Logic Manual: Data Communications, LY21·0051' Component/Function Diagram Part

Binary synchronous 1 1

communications

MULTI·LEAVING remote 2 2

job entry utility

Data communications A·1 App.A

print utility

System utility 9.0 9 through 28 programs

I

IBM Systeml34 Utilities Logic Manual, LY21·0563

Component/Function Diagram Chapter Work station utility 1·1 1 Screen design aid 2·1 2 Data file utility 3·1 3 Source entry utility 4·1 4

Sort 5·1 5

IBM Systeml34 RPG /I Logic Manual, LY21·0565

Component/Function Compiler phase flow

·Object program flow

Figure Part 1·1

2·1 1 2

Figure 0·1. System/34 Logic Documentation Overview

0·2

Licensed Material-Property of IBM

I

IBM Systeml34 Basic Assembler and Macro Processor Logic Manual,

LY21-0569

Component/Function Figure Chapter Assembler

Macro processor

1·2 2·2

1 2

Starting

i

the Sy lIem

I

^Sling

Proce Com mands

St arting a Job

Ru nning a Job

Term inating a Job

~-::::

-

^Task _Work

~ ... -""

~l _-

Procedure Library

r-.._"

...

_ "

OCL from display station batch

SYSIN -"

Keyboard OCL

...

SYSIN

...

OCL Source

SYSIN

OCL Prompts,

Responses

~ ~

'1--

~-

0.V

^C/O

Active F1's

J

Jo<"

----V"" Active F1's

Active F1's

Keysort

Figure ().2. System Control Flow Overview

II I

I

IPL

1

J>. Workstation

Commend Management

Processor

Job Control

I

Inquiry

I

""'- Batch Job Procedures Logical I/O

I

Messages Prompts, Re.ponses

Initiator

Messages & Responses

Reader' Interpreter

'---'"

A. F1's ... ""'- VTOC ....-

Disk _$SOURCE

... _"'"

Initialization Source

Library MSG MBRS, _...

_"'"

User PGMS

Object Library

~

$SOURCE,

Program $WORK

Initiation Local

'---""

Area Task

~ . Work Area

$SOURCE,

-1

^Device

r--

$WORK Allocate

Pointers

-1

^Open

r--

I

Data

~

Management User

Program

SYSLIST

Termination

L-f

^Close

r--

Step F1's& F5

Termination

Job Termination

Licensed Material-Property of IBM

-" Display

:)f Stetlon

0

^{Job Queue}

D

ir==0

SYSLOG r -

j

B

ir==0

History File Put

f-.... _ _ ~

History File

:---

Control Flow Data Flow

~---,>

I ntraduction 0-3

System Support Progrem Product

I I

Sterting the Command Starting a Job Running a Job Terminating

System Processor a Job

(Diagram 1.0) (Diagram 2.0) (Diagram 3.0) (Diagram 4.0) (Diagram 5.01

I ^I

I I

Perform Router Perform Sign·on Command Job Initiator and High·Level Aids

Function Function Processing Work Station and TIC Router

Overview Release Overview

(Diagram 2.11 (Diagram 2.21 (Diagram 2.3) (Diagram 2.181 (Diagram 2.211

I I I

Inquirv Menu Special CP/WSDM Console Management Perform Command Perform Password Perform I/O

Option Processor Command Interface Overview Processor Security Error

and Resume Processor Cleanup Function Function Recoverv

Overview

(Diagram 2.22) (Diagram 2.25) (Diagram 2.261 (Qiagram 2.271 (Diagram 2.31 I (Diagram 2.321 (Diagram 2.331

I I

Main Storage Perform System Rebuild VTOC

IPL Overview Configuration Format l's

Function

(Diagram 1.11 (Diagram 1.51 (Diagram 1.61

I I

Perform Initiator Allocate Open Disk, Diskette,

6

Function Overview Printer, Work Station

and Data Commu-

6

nications DTFs (Diagram 3.11 (Diagram 3.21 (Diagram 3.6)

Diagram 0.1 (Part 1 of 6). Functional Overview

(

0-4

Licensed Material-Property of IBM

~A)

I J I I

Perform Disk Data Perform Sectorized Perform Diskette Perform Diskette Write Pri nter Data

Management Disk Data Data Management End of Volume

Function Management Function

Function

(Diagram 4.1 ) (Diagram 4.2) (Diagram 4.3) (Diagram 4.4) (Diagram 4.5)

Perform Work

I

Station Data Management Function (Diagram 4.6)

Sort Index Entries

I

for Indexed Disk File

(Diagram 4.7)

Close Disk, Diskette, Printer, Work Station and Data Communi- cations DTFs

(Diagram 5.1 ) Diagram 0.1 (Part 2 of 6). Functional Overview

Perform Spool

I

Intercept Function

(Diagram 4.8)

Termi nate Job Step and Job as Required

(Diagram 5.2)

J

Print Records From Spool File

(Diagram 4.9)

I

I ntraduction 0-5

Licensed Material-Property of IBM

System Service Programs

"

System Service Programs Overview

(Diagram 6.0)

I I I I

Find Requested Find Directory Find Requested Retrieve Requested Put Record

Library Entry Library Directory Record to Library

Entry

(Diagram 6.1 ) (Diagram 6.2) (Diagram 6.3) (Diagram 6.4) (Diagram 6.5)

I I I I

Get or Put Perform Library Access Active Perform Cross Display Duplicate

Library Sector Member Protection Format-1 Area Reference Key Information

Function Resolver

Function

(Diagram 6.6) (Diagram 6.7) (Diagram 6.8) (Diagram 6.9) (Diagram 6.10)

I I ^{I I}

Verify Print Process Disk VTOC Process Diskette Retrieve Perform SYSIN

Image Read/Write Request VTOC Read/Write Requested Message Function

Request

(Diagram 6.11) (Diagram 6.12) (Diagram 6.13) (Diagram 6.14) (Diagram 6.15)

I I I I

Perform SYS LI ST Perform SYSLOG Put Records into Perform Supervisor Perform Supervisor

Function Function History File Task Attach Task Detach

Function Function

(Diagram 6.16) (Diagram 6.17) (Diagram 6.18) (Diagram 6.19) (Diagram 6.20)

I I I I

Perform Syntax Perform Perform Data Perform Snap

Checking Function Information Management Task Dump Function

Retrieval Transfer Control

Function Function

(Diagram 6.21 ) (Diagram 6.22) (Diagram 6.23) (Diagram 6.24) Diagram 0.1 (Part 3 of 6). Functional Overview

(

0-6

Licensed Material-Property of IBM

System Maintenance Programs Overview

(Diagram 7.0)

I I

Perform APAR Perform Dump Perform PTF

Utility Function Utility Function Installation Function (Diagram 7.1) (Diagram 7.2) (Diagram 7.3)

I I

Perform Patch Perform Trace Perform

Utility Function Select Function ERAP Utility Function (Diagram 7.4) (Diagram 7.5) (Diagram 7.6) Diagram 0.1 (Part 4 of 6). Functional Overview

Introduction 0- 7

Licensed Material-Property of IBM

Overlay Linkage Editor

Compiler Entry Over- view (Diagram 8.1)

or

User Entry Overview (Diagram 8.2)

I I I I

Compiler Entry Autolink Segment Cross-Reference Sort Autoli nk Overlay Design

Phase List Build Segment List Segment List

Build

(Diagram 8.3) (Diagram 8.4) (Diagram 8.5) (Diagram 8.6) (Diagram 8.7)

I I I I

Overlay Segment Storage Map Relocate, Resolve Library Control Error Routine

List Build Phase Externs, and Build Phase

Load Module Phase

(Diagram 8.8) (Diagram 8.9) (Diagram 8.10) (Diagram 8.11) (Diagram 8.12)

I I I I

Error Message User Entry User Entry User Entry User Entry

Print Phase Phase 1 Phase 2 Phase 3 Phase 4

(Diagram 8.13) (Diagram 8.14) (Diagram 8.15) (Diagram 8.16) (Diagram 8.17)

Diagram 0.1 (Part 5 of 6). Functional Overview

0-8

Licensed Material-Property of IBM

System Utility Programs

System Util ity Programs Overview

(Diagram 9.0)

I I I I

System Backup Basic Interchange Build Menu Rebuild Perform Copy

Display Alternate Utility Function

Sector

(Diagram 9.1 ) (Diagram 10.1) (Diagram 11.1) (Diagram 12.1) (Diagram 13.0)

I I I I

Delete File Copy Diskette File Build File Display History Initialize

File Diskette

(Diagram 14.1) (Diagram 15.1) (Diagram 16.1) (Diagram 17.1) (Diagram 18.1)

I I I I

Display Disk/ Reload Library/ Library Build Message Reorganize Disk

Diskette VTOC Pseudo IPL Maintenance Load Member Files

(Diagram 19.1) (Diagram 20.1) (Diagram 21.0) (Diagram 22.1 ) (Diagram 23.1)

I I 1 I

Update Security Rename Disk Modify Build Display Process Error

File File Configuration Screen Format for SSP or Other PP

Record Procedure

(Diagram 24.1) (Diagram 25.1) (Diagram 26.1 ) (Diagram 27.1) (Diagram 28.1 ) Diagram 0.1 (Part 6 of 6). Functional Overview

Introduction 0-9

Licensed Material-Property of IBM

(

0-10

Licensed Material-Property of IBM

Part 2. System Support Program Product

Licensed Material-Property of IBM

(

Licensed Material-Property of IBM

I ntrod uction

The functions needed to start the system are:

• Perform initial program load (lPL)

• Perform system configuration

• Rebuild IPL format 1, if needed

MA(N STORAGE INITIAL PROGRAM LOAD (lPL) System/34 initial program load (lPL) consists of two parts:

control storage IPL and main st0,rage IPL.

The function of control storage IPL is to initialize main and control storage common areas to a sufficient degree to allow the control storage supervisor to operate. Control storage IPL first loads control storage and performs a basic system checkout of the processing unit and I/O functions.

It then loads the control storage nucleus. After loading the work station and printer control programs, control storage IPL loads main storage IPL phase 1 (#MSNIP) and the first two sectors of the configuration record into the main storage transient area and passes control to

#MSNIP.

Main storage IPL completes initialization of the System Support Program Product (SSP). Main Storage IPL con- sists of three phases: main storage IPL phase 1 (#MSNIP), phase 2 (#MSTWA), and phase 3 (#MSIPL). (See Figure 1-1 for main storage IPL logic flow.)

#MSNIP performs initial main storage IPL processing.

Its main functions are:

• Initialize the system communication area

• Build the resident library format 1

• Determine defective main storage locations

• Initialize the transient/transfer control table

• Resolve disk addresses as needed (load and execute

#MAXRF)

Chapter 1. Starting the System

• Set the command processor task control block (TCB) to reflect any defective 2K main storage blocks

• Increase assign/free area size to allow for main storage allocation

#MSNIP passes control to #MSTWA.

#MSTWA performs phase 2 main storage IPL processing.

Its main functions are:

• I nitialize the transfer control table for resident routines

• Initialize the task work area index

• Initialize the terminal unit blocks

• Initialize the task work area for each work station

• Build the device allocate table

• Initialize command reject file data areas

Before it passes control to #MSIPL, #MSTWA updates the instruction address register (lAR) in the request block (RB) stack to pass control to the command processor resident router (#CPML) when IPL is completed.

#MSIPL controls final main storage IPL processing. The main storage IPL phase 3 function uses additional main storage IPt modules. They are: process overrides

(#MSRID), process overrides

(#M~OER),

spool file IPL (#MSSP), input job queue IPL (#MSJO), and main storage allocate (#MSSOS). The primary functions of main storage IPL phase 3 are:

• Perform main storage IPL sign-on

• Process override information if OVER RI DE-YES is entered on the IPL sign-on display (#MSRID, HMSOER)

• Initialize the system print spool function if print spool is supported (#MSSP)

Introduction 1-1

Licensed Material-Property of IBM

o Initialize the job queue if job queue is supported (#MSJQ)

C

Build the assign/free area (#MSSQS) e Build the user main storage area (#MSSQS)

" Enable all system terminals

#MSIPL then calls the supervisor task attach transient (#SVAT) to attach a TCB to run file rebuild (#MSBLD).

Control eventually passes to #CPM L.

SYSTEM CONFIGURATION ($CNFIG)

System configuration is performed when the system is initially installed or any time a system or feature change requires reconfiguration. The configuration information is saved in the configuration records. (See the

Data Areas Handbook

for a description of the configuration records.) The system user may override certain configuration options at IPL (see #MSIPL) or alter the configuration of each work station by using $SETCF.

System configuration is initiated with the CNFIGSSP' command following the initial RELOAD of the base system support program to disk. (See

IBM System/34 Program Product Installation and Modification Reference Manual,

SC21-7689, for more information about the CNFIGSSP procedure.)

CNFIGSSP loads and runs the system configuration pro- gram ($CNFIG). The main functions performed by

$CNFIG are:

o Read, modify, and write system configuration records.

o Set values/parameters in the configuration records based on operator responses to configuration prompts.

o Validate the operator's input values and ensure system operation.

o Set UPSI switches to control CNFIGSSP procedure flow.

1-2

$CN FIG val idates the operator's responses to prompts and updates the appropriate configuration record after each configuration display is presented. After all operator responses are processed, $CNFIG returns the updated configuration records to disk and passes control to the end-of-job transient ($EOJ).

REBUILD VTOC FORMAT "S

The rebuild VTOC format 1 's routine (#MSBLD) examines each format 1 in the disk VTOC to ensure that the pointers accurately reflect the status of the data set contents. The routine also checks the format 5 to ensure that disk reor- ganization ($PACK or $FREE) was not previously interrupted.

#MSBLD is called by main storage IPL phase 3 (#MSIPL).

The system operator may request that #MSBLD not be run.

If run, th.e system operator directs #MSBLD to perform one of the following:

• Delete all files in error

• Examine old files, as well as new

• Prompt on each file in error for retention or deletion

Licensed Material-Property of IBM

(

Method of Operation

This section contains functional diagrams for routines needed to start the system. They are:

• Main storage IPL

• System configuration

• Rebuild VTOC format 1

Licensed Material-Property of IBM

Method of Operation 1-3

From: Control Storage IPL

IINPUT

1 ______ -....>. ^~OCESS

Perform main storage IPL (Diagram 1.1) Required system

areas

I r ^OUTPUT

Con figu rati on

records

-.;;;I;...----~.

Perform system configuration

--->

Initial program

I I

load completed

---...;;;;....----.;;;;..>

Configuration

I I

^records

-...;;;.---...;...>

^{Format 1}

I I

(Diagram 1.5)

-~--->.

Rebuild VTOC format 1 (Diagram 1.6) Format 1

---:Tl

To: Command Processor Diagram 1.0. Overview of Starting the System

From: Control Storage IPL

.INPUT L.::;:0CESS .. OUTPUT

.. ^..

Configuration

:> •

Perform main storage IPL phase 1

::>

Initial program

.. ..

record processing (Diagram 1.2) load completed

System library

•

Perform main storage IPL phase 2

directory processing (Diagram 1.3)

Required system

•

Perform main storage IPL phase 3

areas processing (Diagram 1.4)

User oPtions

~ ~

To: Command Processor Diagram 1.1. Overview of Main Storage IPL

1-4

Licensed Material-Property of IBM

From: Control Storage IPL

'" INPUT _~-.z_..,.

L.l:;:0CESS

OUTPUT _ _

II1II_

(XR2

Configuration record Main Storage Fixed Nucleus Transient Area:

#MSNIP Configuration record User Area System library directory

_---,""'~" ... D

Initialize system communication area

D

Build resident library format 1

II

Determine bad main storage locations

II

Initialize transient/transfer control table

II

Resolve disk addresses as needed

II

Set command processor TCB to reflect any bad 2K storage blocks

IJ

Increase assign/free size to allow for main storage allocation

---::Il

SCA

Library format 1 Transient table Command processor TCB Temporary assign/

free area

To: Main Storage IPL Phase 2

#MSTWA (Diagram 1.3)

MODULE/

OESeR IPTION ROUTINE

D

Initialize system communication area (SCA) from configuration record information: #MSNIP

•

Task work area (TWA) address. Disk 105

•

TWA size. #MSNIP

•

Disk VTOC address.

•

Disk VTOC size.

•

Diskette VTOC work area disk address.

•

Diskette VTOC work area size.

•

Configuration record start address.

•

History file start address.

•

History file size.

•

Release and modification level.

•

Control storage configuration size.

•

DUMP indicator.

•

System configuration bytes.

• ^•

Communications configuration from UDT. Disk 105

Resolve current history file pointer: #MSNIP

•

Scan history file looking for file 10 (X'FE') as start of history file sector. Disk 105

•

If history file current pointer found, put disk address in SCA (SCAHFCURl. #MSNIP

•

If history file current pointer not found, set history file error flag in SCA (SCAHFERRl.

fJ

Read system VTOC, first sector, to get library format 1. Disk 105

Move library format 1 to nucleus. #MSNIP

Save spool buffer size.

.

Diagram 1.2 (Part 1 of 2). Perform Main Storage IPL Phase 1 Processing

Method of Operation 1-5 Licensed Material-Property of IBM

~

OEseR IPTION

II

Count number of bad 2K

bloc~s

of main storage.

Assign save area for bad 2K block numbers.

Move bad 2K blocks to save area.

II

Move dump SVC address into transient/transfer control table for each table entry.

Read in block (one track) of library directory sectors.

Look for name table entry in library directory . . If name table entry found:

• Place SSN in transient table if necessary.

• Place SS in SCA (message member) if necessary.

• Build loader parameter list if necessary.

If name table entry not found:

• Determine whether it is required by SSP.

• If required, call dump main storage transient task (9 control storage function) to abend system (MIC 249).

II

Resolve disk addresses by executing cross reference resolver.

1,1

Determine whether any bad 2K storage blocks exist (SCA2KBAD).

Find task control block (TCB) address translate registers (ATRs).

Flag bad ATRs.

Set good ATR numbers in TCB.

II

Allocate temporary assign/free space for duration of main storage IPL.

Load and pass control to IPL phase 2 (#MSTWA).

Diagram 1.2 (Part 2 of 2). Perform Main Storage IPL Phase 1 Processing 1·6

Licensed Material-Property of IBM

MODULE/

ROUTINE

#MSNIP

Disk lOS

#MSNIP

#MAXRF

#MSNIP

(

\,

From: Main Storage IPL Phase 1 -#MSNIP (Diagram 1.2)

'" INPUT _ _ _ _

•

I...I:;:0CESS '" OUTPUT _ _ _

_

XR2 (Load table

Main Storage

Transient Area:

# MSTWA Configuration record

---"'...D

_ - - -... "..~ Initialize transfer control table for resident routines

D

Initialize task work area index

I)

Initialize terminal unit blocks

II

Initialize task work area

II

Build device allocate table

II

Initialize command reject file data areas User Area

Transient table SCA

UDT

---::i1

DESCRIPTION

D

Scan load table built during directory scan by #MSNIP.

Load resident routines:

•

Calculate next load address.

•

If request indicator byte (RIB) given, put its address in transfer control table.

To: Main Storage IPL Phase 3 -#MSIPL (Diagram 1.4)

•

Call main storage relocating loader (control storage function) to load the resident routine.

fJ

Find space for command processor work area.

Build command processor image matrix and order index.

Reset task work area index to all available work space.

Reset task work area (first track) to binary zeros.

Find space for temporary work station queue (to be used during IPL).

Allocate space from TWA for command reject file.

If no space available for work station queues, call dump main storagelterminate task routine (control storage function) to eliminate IPL procedure.

Diagram 1.3 (Part 1 of 2). Perform Main Storage IPL Phase 2 Processing

Transfer control table

TWA System TUBs Device allocate table

MODULE!

ROUTINE

#MSTWA

Disk 105

#MSTWA

Method of Operation 1-7

Licensed Material-Property of IBM

MODULE/

OEseR IPTION ROUTINE

IJ

Read terminal information blocks into work area. Disk lOS

Initialize terminal unit blocks (TUB) based on system configuration record information: # MSTWA

•

Set work station 10.

•

Initialize common TUB fields.

•

Set system printer TUB address in SeA.

•

Set task work area address.

II

Allocate work space in task work area.

Write work station configuration record to disk. Disk lOS

Initialize local area of task work area. # MSTWA

II

Build entries for diskette from unit definition table (UDT) information.

Build communication entries from communication configuration record information.

II

Initialize command reject file data areas.

Build arid queue error recovery blocks (ERB) for disk and diskette.

Load and pass control to main storage IPL phase 3 (#MSIPL).

"

Diagram 1.3 (Part 2 of 2). Perform Main Storage IPL Phase 2 Processing 1-8

Licensed Material-Property of IBM

From: Main Storage IPL Phase 2 -#MSTWA (Diagram 1.3) INPUT _ _ _ _ •

Main Storage

Transient Area:

#MSIPL

#MSRID

#MSOER

#MSSP

#MSJQ

#MSSQS User Area

SCA TUBs TCBs User options

L..:;:0CESS

o

Perform main storage IPL sign-on

fI

Process override information if necessary

II

Initialize system print spool function

D

Complete nucleus initialization

----:&l

.

~ OUTPUT _ _ _ _

Initial sign-on Structured user area

Spool file and buffer pool Initialized main storage nucleus

To: Command Processor Resident Router -#CPML (Diagram 2.1)

MODULE/

OESeR IPTION ROUTINE

D

Post task control block (TCB) for request-enter sign-on. #MSIPL

Search terminal unit block (TUB) chain for system and alternate consoles.

Check system console for errors.

If no system console errors, simulate REQ-ENT request.

Wait for console input.

If request-enter is from console, process R EQ-ENT request. #CPTC

If request-enter is not from console: #MSIPL

•

Build assign accept/input parameter list.

•

Accept input from console. #WDDA

•

If alternate console, enable request-enter and call request enter transient (#CPTC). #MSIPL

•

If master console, call sign-on transient (#CPON) to process sign-on information.

•

Prompt for file rebuild options. #MSRID

Check for override request-entered at sign-on.

D

Build override format index: #MSRID

•

Read override format index from disk. Disk 105

•

Build in-core format index. #MSRID

Diagram 1.4 (Part 1 of 6). Perform Main Storage IPL Phase 3 Processing

Method of Operation 1-9

Licensed Material-Property of IBM