IBML ABCs of OS/390 System Programming Volume 1 P. Rogers, G. Capobianco, D. Carey, N. Davies, L. Fadel, K. Hewitt, J. Oliveira, F. Pita, A. Salla, V. Sokal, Y. F. Tay, H. Timm International Technical Support Organization www.redbooks.ibm.com SG24-5597-00 IBML International Technical Support Organization SG24-5597-00 ABCs of OS/390 System Programming Volume 1 April 2000 Take Note! Before using this information and the product it supports, be sure to read the general information in Appendix D, “Special Notices” on page 303. First Edition (April 2000) This edition applies to OS/390 Version 2 Release 8, Program Number 5647-A01, and to all subsequent releases and modifications. Comments may be addressed to: IBM Corporation, International Technical Support Organization Dept. HYJ Mail Station P099 2455 South Road Poughkeepsie, New York 12601-5400 When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 2000. All rights reserved. Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Figures . vii Tables . xiii Preface . xv The team that wrote this redbook ........................... xv Comments welcome . xvi Chapter 1. Introduction to OS/390 .......................... 1 1.1 Introduction to OS/390 fundamentals ...................... 2 1.1.1 OS/390 evolution . 3 1.1.2 OS/390 software and hardware ....................... 4 1.1.3 OS/390 elements and features ....................... 6 1.2 OS/390 products requiring customization ................... 8 1.2.1 Resource Access Control Facility (RACF) ................ 9 1.2.2 Data Facility Storage Management Subsystem (DFSMS) ........ 10 1.2.3 ADSTAR Distributed Storage Management (ADSM) ........... 11 1.2.4 Transmission Control Protocol/Internet Protocol (TCP/IP) ....... 12 1.2.5 System Modification Program Extended (SMP/E) ............ 13 1.2.6 Resource Management Facility (RMF) ................... 14 1.3 OS/390 components requiring customization ................. 15 1.3.1 System Management Facility (SMF) .................... 16 1.3.2 Virtual Lookaside Facility (VLF) ....................... 18 1.3.3 Time Sharing Option/Extended (TSO/E) .................. 20 1.3.4 Workload Manager (WLM) .......................... 21 1.3.5 UNIX System Services ............................ 22 1.3.6 OS/390 contents . 24 1.4 Role of a system programmer .......................... 26 1.5 OS/390 system programmer functions ..................... 28 1.5.1 System programmer and OS/390 operations ............... 31 1.5.2 Requirements for install ........................... 34 1.6 Installing OS/390 . 36 1.6.1 Maintenance or service using SMP/E ................... 36 1.6.2 Choosing an install package ........................ 37 1.6.3 Installing OS/390 using ServerPac ..................... 38 1.6.4 Installing OS/390 using CBPDO ....................... 40 1.6.5 Installing OS/390 using fee-based packages ............... 42 Chapter 2. OS/390 Storage Concepts ........................ 43 2.1 OS/390 Address Spaces .............................. 44 2.1.1 Subsystem definitions . 45 2.2 Processor Storage Overview ........................... 47 2.3 Storage managers . 49 2.3.1 Virtual Storage Manager ........................... 50 2.3.2 Virtual Storage . 51 2.4 Address space storage .............................. 54 2.4.2 Real Storage Manager ............................ 64 2.4.3 Auxiliary Storage Managers ......................... 66 2.4.4 Paging and Swapping ............................ 68 2.5 Program execution . 71 Copyright IBM Corp. 2000 iii Chapter 3. S/390 hardware and I/O management ................. 73 3.1 Data center . 74 3.2 Logical processor structure ............................ 76 3.3 Channel subsystem . 77 3.3.1 Start Subchannel (SSCH) logic ....................... 78 3.3.2 SAP logic . 78 3.3.3 Interrupt processing . 78 3.4 Multiple paths to a device ............................. 79 3.5 Device number . 80 3.6 Subchannel number . 81 3.6.1 Subchannel number II ............................ 82 3.7 Unit address . 83 3.8 Control unit function ................................ 85 3.9 Parallel channel . 86 3.10 ESCON channel . 87 3.11 S/390 ESCON concepts .............................. 89 3.11.1 ESCON link . 89 3.11.2 Link address . 90 3.12 Mapping device number in unit address ................... 91 3.13 ESCON CUADD function ............................. 92 3.14 ESCON director (switch) ............................. 94 3.15 ESCON director matrix .............................. 96 3.16 ESCON channel-to-channel (CTC) ....................... 97 3.17 Fiber Connection (FICON) ............................ 99 3.18 How to display channel types ......................... 101 3.19 S/390 connectivity . 102 3.20 System-related I/O work flow ......................... 103 3.21 What is HCD ................................... 105 3.21.1 HCD functions . 107 3.21.2 Dynamic I/O reconfiguration ....................... 109 3.21.3 Dynamic reconfiguration concepts ................... 111 3.22 IODF data set .................................. 113 3.22.1 Catalog considerations . 114 3.22.2 Production IODF backup ......................... 114 3.22.3 IODF placement . 114 3.22.4 Multiple configurations in a single IODF ................ 115 3.22.5 Definition order . 116 3.23 HCD primary option menu ........................... 117 3.23.1 How to create a new work IODF ..................... 119 3.23.2 Defining configuration data ........................ 120 3.24 Operating system definition .......................... 121 3.24.1 How to define an operating system ................... 122 3.24.2 EDT and esoterics ............................. 123 3.24.3 Select new configuration for EDTs ................... 125 3.24.4 How to define an EDT ........................... 126 3.24.5 How to define an EDT ........................... 127 3.24.6 Define EDT identifier ............................ 128 3.24.7 How to add an esoteric .......................... 129 3.24.8 Add an esoteric .............................. 130 3.25 Defining switches . 131 3.25.1 How to define a switch .......................... 132 3.26 Defining processors ............................... 133 3.26.1 Basic mode . 133 3.26.2 LPAR mode . 133 3.26.3 Defining processors with HCD ...................... 134 iv ABCs of OS/390 System Programming 3.26.4 Information required to define a processor .............. 135 3.26.5 How to define a processor ........................ 136 3.26.6 Work with partitions ............................ 137 3.26.7 How to add a partition to a CEC ..................... 138 3.26.8 Channel types . 139 3.26.9 Reconfigurable channels . 141 3.26.10 Shared or EMIF channels ........................ 142 3.26.11 Information required to add channels ................. 143 3.26.12 Work with channel paths ........................ 144 3.27 How to add a channel path .......................... 145 3.28 Channel path access list ............................ 146 3.29 Channel path candidate list .......................... 146 3.30 How to add a control unit ........................... 147 3.31 Information required to define a control unit ................ 148 3.31.1 Adding a control unit ........................... 149 3.32 Defining a 3990-6 control unit ......................... 150 3.32.2 Select processor for control unit .................... 152 3.32.3 Defining a 3990-6 control unit ...................... 153 3.32.4 Defining processor attachment data .................. 154 3.33 Information required to define a device ................... 155 3.33.1 S/390 device numbering ......................... 157 3.33.2 How to define an I/O device ....................... 159 3.33.3 Device / Processor Definition ...................... 161 3.33.4 Defining CSS definitions for a device .................. 162 3.33.5 Define device to operating system ................... 163 3.33.6 Define operating system device parameters ............. 164 3.33.7 Assign device to an esoteric ....................... 166 3.34 Defining a NIP console ............................. 167 3.35 Build a production IODF ............................ 168 3.35.1 Production IODF created ......................... 170 3.36 Activating a configuration with HCD ..................... 171 3.37 How to display active IODF from the HCD panels ............. 172 3.38 How to display active IODF from an MVS console ............. 173 3.39 How to display a device status ........................ 174 3.40 Producing configuration reports ....................... 176 3.40.2 HCD graphical reports .......................... 177 3.41 Hardware Configuration Manager (HCM) .................. 179 Chapter 4. TSO/E, ISPF, and JCL .......................... 181 4.1 Installation and customization facilities .................... 182 4.1.1 Time Sharing Option/Extended (TSO/E) ................. 184 4.1.2 Interactive System Productivity Facility (ISPF) ............. 193 4.1.3 JCL streams and jobs ........................... 211 4.1.4 DD statement parameters ......................... 217 4.1.5 Submitting a job ............................... 223 4.1.6 Introduction to the Spool Display and Search Facility (SDSF) .... 229 Chapter 5. MVS delivery and installation ..................... 235 5.1 Introduction to OS/390 .............................. 236 5.1.1 Advantages of OS/390