File Number S360-20 Form C24-34S0-2 BOS Systems Reference ..Library IBM System/360 Basic Operating System Control Programs and Assembler Operating Guide Progl'am Numbers BaEiic Control Program 380B-CL-302 COIllsecutive Processing Macros 380B-IO-303 Indexed Sequential Pile Management System (ISPMS) Macros 380B-IO-304 Direct Access Method (DAM) Macros 380B-IO-305 Assembler 380B-AS-309 This publication is divided into three parts: Part 1 explains briefly the functions of the programs in the Basic Operating System. Part 2 gives operating procedures for the IBM System/360 Basic Operating System Control and Service Programs and Assembler. Procedures for generating a resident system, and obtaining and using system backup are included, as well as a section on system/operator communication. Part 3 presents the formats of Job Control, Linkage Editor, and library program control cards. A series of appendices include reference charts for System/360 code conversion and a table of IBM­ supplied program and macro names. For information about the operation of the System/360, see IBM System/360 Model 30 Operator's GuidE~, Form A24-3373. Operating guides for other progl~ams available in the System/360 Basic Operating SystE~m are in separate publications. For these and other related publications, see IBM System/360 Bibliography, Form A22-6822. All Basic Operating SystE~m Operator Messages are cataloged in IBM SystE~m/360 Basic Operating System, OperatorMessages, Forni. C24-S024. PREFACE Part 1 of this publication presents the con­ also given for generating a system, obtain­ cepts of the IBM System/360 Basic Operating ing system backup, and recreating a system System. The functions provided are ex­ from backup. plained briefly. Persons with a knowledge of basic operating system concepts may want Part 3 contains the formats of job to skip this part and refer only to the control cards, Linkage Editor input cards, sections on operating procedures and error and program control cards (used by library messages. programs) • Part 2 has a section on general operating Appendices A, B, C, and D are reference procedures. These include procedures for charts for System/360 code conversion. Ap­ starting system operation (the IPL proce­ pendix E contains the names of IBM supplied dure), starting a job, terminating a job, programs and macros in the System/360 Basic and restarting a checkpointed job. There Operating System. is an explanation of the types of communi­ cation between the system and the operator. Although this BOS Operating Guide is in­ Individual sections give the operating pro­ tended primarily for operators, others may cedures for the Assembler and system con­ find it useful in planning and/or program­ trol and service programs. Procedures are ming jobs. SIMPLIFIED TERMINOLOGY The titles of some IBM programming systems have been simplified as shown below: former: IBM System/360 Basic Operating System (8K Disk) new: IBM System/360 Basic Operating System former: IBM System/360 Basic Operating System (16K Tape) new: IBM System/360 Tape Operating System former: IBM System/360 Basic Operating System (16K Disk) new: IBM System/360 Disk Operating System Major Revision, May 1966 This edition, Form C24-3450-2, is a major reVl.Sl.on of, and obsoletes, Form C24-3450-l. Changes are designated in three ways: 1. A vertical line appears at the left of affec·ted text where only a part of the page has been changed. 2. A dot (e) appears at the left of the page number where the complete page should be reviewed. 3. A dot (e) appears at the left of the title of each figure that has been changed. The affected pages are: Title Page, Preface, Contents, 5, 18, 28,34, 38, 39, 42-44, 48, 52-56, 63, 76-78, 84, 101, 102, 104 and the Index. Part 4: Error Messages has been deleted. Copies of this and other IBM publications can be obtained through IBM Branch Offices. A form has been provided at the back of this publication for readers' comments. If the form has been detached, comments may be directed to: IBM Programming Publications, Endicott, New York 13760 €V International Business Machines Corporation, 1965 CONTEN'l'S INTRODUCTION . 5 PART 1. CONCEPTS. 6 Language Translation Functions . .. 6 Installation Service Functions . 7 System Control Functions . 8 System Service Functions . 11 Organization of the System Pack. 12 Principles of System Operation . 13 PART 2. OPERATING PROCEDURES ...... 15 General Procedures . .. •. 15 System/Operator Communication. 26 Assembler. • . • . J3 Library Programs . 46 AORGZ--Reallocate Library Limits Program. • . • . • . 50 CORGZ--Copy System Program. 51 CSERV--Core Image Library Service Program. • . • . • . 52 DSERV~-Directory Service Program. 54 LORGZ--Condense Library Program ... 58 MMAINT--Macro Library Maintenance Program. • . • . 59 MSERV--Macro Library Service Program. 60 PSERV--PUB Table Service Program. • . 62 RMAINT--Relocatable Library Maintenance Program. 64 RSERV-~Relocatable Library Service Program. 65 SYSCMA--Core Image Library Maintenance Program. • 67 System Generation ....... · 68 Basic Operating System Backup. • 72 PART 3. CARD FORMATS. • 76 Job Control Cards ... • 76 Linkage Editor Input Cards · 81 Librarian Program Control Cards. · 85 APPENDIX A: EXTENDED BINARY CODED DECIMAL INTERCHANGE CODE (EBCDIC) . 88 APPENDIX B: BINARY TO DECIMAL CONVE RS I ON . • . 91 APPENDI~ C: BINARY TO HEXADECIMAL CONVE RS I ON • • • • • 92 APPENDIX D: DECIMAL/HEXADECIMAL CONVE RS I ON. • • • • • 95 APPENDIX E: NAMES OF PROGRAMS AND MACROS. .101 INDEX . .106 IBM· SYSTEM/360 BASIC OPERATING SYSTEM CONTROL PROGRAMS AND ASSEMBLER OPERATING GUIDE The Basic Operating System/360 consists of main storage at all times. Thus, there is language translation system control, and constant access to an external storage medi­ service programs that provide for efficient um, called the residence of the system or use of 8K (and larger) System/360 disk­ the system residence volume. The system resident installations. residence volume used in the Basic Operating System/360 is a disk pack called system disk An o~erating system is a set of programs pa~k mounted on an IBM 2311 Disk Storage that, w1th the aid of an operator, permits Dr1ve. The system disk pack contains the continuous operation of a system. One char­ programs and routines that make up the acte~istic of an operating system is that operating system. It is on-line for the all its programs can be immediately availa­ execution of all programs, both those sup­ ble for execution, but they are not all in plied by IBM and those written by the user. 5 PART 1: CONCEPTS The overall objective of any data process­ tape into the System/360 main storage ing installation is to convert quantities for execution. of source data into reports or other mean­ ingful form that management can use in the • Provide system service functions for the successful operation of its business. Con­ system disk pack, such as adding programs verting the source data to usable form gen­ to the system. erally requires a series of steps or opera­ tions. The performance of each operation is based on the principle of obtaining in­ LANGUAGE TRANSLATION FUNCTIONS put data, and producing desired output data. The output may be the end result of the To provide the System/360 with instructions overall objective, or it may be the input to process his data, the user writes a prob­ to a subsequent operation that is yet to be lem program that includes information about performed. the sources of input data, processing to be performed with the data, and desired output The operations required to process the data. This program is called a source pro­ data can be performed on the System/360 by gram, or source module, and it is generally use of a series of programs. A ~~~ is written in a symbolic language that is easi­ a set of instructions to tell the system ly understood by the programmer. what functions to perform, such as reading or writing data, adding or moving data, con­ Symbolic languages consist of sets of trolling the system, etc. Programs are specified mnemonic codes and rules for ex­ either written by the user or supplied by pressing various types of instructions or IBM. specifications. They permit the use of user­ selected names (or symbols) for reference The user writes problem programs to per­ back and forth between instructions in the form whatever processing of data he requires program. These symbols represent locations, to obtain the desired output. For example, or addresses, where the instructions will in a payroll application his problem program be entered in main storage when the program may process employee hours and rates to pro­ is loaded into the machine. duce pay checks, year-to-date earnings, with­ holding tax reports, work load analyses, etc. Although symbolic languages are available to simplify the programmer's work, they can­ Programming systems supplied by IBM aid not be understood by the machine. They must the user by providing him with prewritten be translated to a language that is accepta­ and pretested programs for many of the gen­ ble to the machine. The System/360 can then eralized functions that must be performed interpret and carry out (execute) the pro­ in conjunction with his data processing (for grammer's instructions. The translation example, programs to sort records). Thus, from symbolic language to machine language the use of these programs reduces the num­ can be performed by either of two language ber of programs that the user himself must processing programs in the 8K disk basic op­ write and test. erating system: the Assembler or the Report Program Generator (RPG). Each of these pro­ The programs in the Basic Operating Sys­ grams is a set of instructions in machine tem can be categorized by the functions they language that has been written specifically perform: to translate user's symbolic-language pro­ grams to machine-language programs.