VSE/POWER Diagnosis Reference - IBM · IBM Corporation or to: IBM Deutschland Entwicklung GmbH Attn: Dept ECJ - BP/003D Department 3252 6300 Diagonal Highway Schoenaicher Strasse

IBM z/VSE/VSE Central Functions IBM

VSE/POWERDiagnosis ReferenceVersion 7 Release 1

SC33-6322-07

Note!

Before using this information and the product it supports, be sure to read the general information under “Notices”on page xvii.

Seventh Edition (July 2006)

This edition applies to Version 7 Release 1 of IBM Virtual Storage Extended/POWER, which is part of VSE Central Function,Program Number 5609-ZVS, and to all subsequent releases until otherwise indicated in new editions or Technical Newsletters.

Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at theaddresses given below.

A form for readers' comments is provided at the back of this publication. If the form has been removed, address your comments to:

IBM Corporation or to: IBM Deutschland Entwicklung GmbHAttn: Dept ECJ - BP/003D Department 32526300 Diagonal Highway Schoenaicher Strasse 220Boulder, CO 80301, D-71032 BoeblingenU.S.A. Federal Republic of Germany

When you send information to IBM, you grant IBM a non-exclusive right to use or distribute the information in any way it believesappropriate without incurring any obligation to you.

© Copyright International Business Machines Corporation 1979, 2006. All rights reserved.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiProgramming Interface Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiTrademarks and Service Marks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Purposes of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

VSE/POWER Private Subtasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2VSE/POWER Direct Access Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Communication with VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9VSE/POWER Operator Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Job Entry Control Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Format of VSE/POWER Operator Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Environmental Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Programming Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Storage Requirements and Allocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Virtual Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Real Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Hardware Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Machine Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Devices Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Chapter 2. Method of Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19VSE/POWER Linkage Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Register Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Interface Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Function Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Service Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Chapter 3. Program Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Code Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Storage Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Code Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Internal Macro Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Initialization and Termination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Initialization of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39VSE/POWER Startup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Termination of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54VSE/POWER Multitasking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Task Initiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Task Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Task Termination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Reader, Execution Processor, and Writer Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Reader Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Execution Processor Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Writer Tasks (List and Punch) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Offload Reader/Writer Tasks (IPW$$OF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Dynamic Partition Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Enabling Dynamic Partition Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

© Copyright IBM Corp. 1979, 2006 iii

Driving Dynamic Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Tracking Dynamic Partition Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Attributes and Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Load, Modify, and Display the Dynamic Partition Support . . . . . . . . . . . . . . . . . . . . . . . . . 83Abnormal Termination with Dynamic Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Interplay of Dynamic Partition Scheduling Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

The Spooling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Queue File Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89In-Storage Queue Principles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Data File Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Queue File and Data File Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Time Event Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Running in ESA-Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Usage of ESA-Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Usage of Access Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Usage of Access Register in Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Addressing Exception in Access-Register Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Multiprocessor Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111External Invocation and Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Internal Implementation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Internal Functional Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Internal Implemented Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Resource Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Real Storage Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Virtual Storage Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Message Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Queue File Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Disk Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Tape Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Timer Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Interval Timer Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Validation Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Remote Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Get Trace Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Switch NP/PA Mode Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

Miscellaneous Tasks and Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Message Handler Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143Notify Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Asynchronous Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159IDUMP in Flight Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Open/Close Tape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Command Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Initiation of the Permanent Command Processor Task . . . . . . . . . . . . . . . . . . . . . . . . . . 165Initiation of the Temporary Command Processor Task . . . . . . . . . . . . . . . . . . . . . . . . . . 165Command Processor Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Command Authorization Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Command Processing Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Command Processing Due to Operator Communication . . . . . . . . . . . . . . . . . . . . . . . . . 181

VSE/POWER Job Accounting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Account File Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

VSE/POWER Networking Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187PNET Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188PNET Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

iv VSE Central Functions V7R1 VSE/POWER DRM

PNET Node Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191PNET BSC/CTC/TCP/SSL I/O Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195PNET TCP Interface to TCP/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198TCP/IP Driver Subtask (TD Subtask) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199PNET SSL Interface to TCP/IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221TCP/SSL Driver Subtask (SD Subtask) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223PNET SNA Interface to VTAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251PNET SNA Session Establishment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252PNET SNA Session Termination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259PNET SNA VTAM Exits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263PNET SNA SEND/RECEIVE Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267PNET Transmitter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273PNET Composer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276PNET Receiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278PNET Presentation Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283PNET Buffer Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284PNET Compression/Decompression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284PNET Multi-Leaving Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286

Remote Job Entry (RJE) Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296RJE,BSC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296RJE,SNA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303

Appendages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331Page Fault Appendage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331Attention Interface Appendage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332RJE,BSC and PNET,BSC/CTC Channel End Appendage . . . . . . . . . . . . . . . . . . . . . . . . 332Hot Reader Appendage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332SVC 0/3 Appendage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332SVC 90/91 Appendage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Interval Timer Appendage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333JCL End-of-Job Appendage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Appendage Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333

VSE/POWER Shared Spooling Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335Timer Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335Queue Control Area (QCA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337Command/Message Passing Between Sharing Systems . . . . . . . . . . . . . . . . . . . . . . . . 341

VSE/POWER Spool-Access Support Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344Spool Access Support Master Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344SAS User Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346SAS Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

External Device Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Device Service Task (DST) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374Orders from VSE/POWER (Outbound) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Orders from the DDS (Inbound) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

Heartbeat Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Codes using REIPL Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Chapter 4. Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387CSECT and Control Block Name List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388PHASE Name List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Macro List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

Macro Shipables' List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Programming Example Shipables' List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400

Message Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Contents v

Chapter 5. Storage Layout and Data Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433The Layout of the SVA Part of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

How to Locate the CAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434The Storage Layout of the VSE/POWER Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434

The Permanent Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439The Fixable Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439The GETVIS Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442

Account Control Block (ACCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444Accounting Record Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448Assign/Unassign Work Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449Asynchronous Service Anchor Block (ASAB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450Asynchronous Service Control Section (ASCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451Asynchronous Service Work Element (ASWE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452Buffer Control Word (BCW) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453Buffer Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454Cancel Codes of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456Channel Command Word (CCW) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457Command Control Block (CCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458Command Processor Work Area (CPWA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459Communicator Information Block (CIB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485Class Table Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487Communicator Information Block 2 (CI2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488Communicator Information Element (CIE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489Application Communicator Information Element (ACIE) . . . . . . . . . . . . . . . . . . . . . . . . . . . 490Control Address Table (CAT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491Data Set Control Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508Compaction Table Block (CMPT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509Disk Management Block (DMB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510DSECTS for Accounting (A-FILE ON FBA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Dynamic Partition Control Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Execution Processor Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525External Device Control Block (EDCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526FCB Table (FCBCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Function Management Header 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Generation Table (GNB) for VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529Initialization Processor Work Area (IP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533Journal Communication Area (JCA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535Logical Data Record Area (LDA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Logical Reader Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540Logical Writer Work Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542Message Control Block (MMB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544Master External Device Control Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546Module Control Block (MCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547Network Composer Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Network Compression Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Network Definition Table (NDT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553Network Data Set Header Record (DSHR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555Network Job Header Record (JHR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559Network Job Trailer Record (JTR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563Network Presentation Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564Network Receiver Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565Network Transmitter Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567Network Transmitter Exit Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569Nodal Message Record (NMR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570

vi VSE Central Functions V7R1 VSE/POWER DRM

Node Control Block (NCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571Node Control Block Task Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583Open 3540 Diskette Work Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584Output Exit Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586Output Parameter Definition Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587Output Parameter Text Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588Output Parameter Processing Interface List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589Partition Control Block (PDB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591Physical Data Record Area (PDA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594Physical Work Space (PWS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5953540 Physical Work Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596PNET Control Block (PNCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597PNET TCP Driver Control Block (TDCB) and PNET SSL Driver Control Block (SDCB) . . . . . . . . 599Print Status Processor Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608Printer TCB Extension Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613Queue Record Area (QRA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614Remote Message Control Block (MSCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620RJE Line Control Block (LCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621Segment Macro Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629Shared System Slot Communication (SLOT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631Service Request Block (SRB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633SNA Session Control Block for PNET (SSCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635SNA Compaction Table Control Block (COCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636SNA Control Block (SNCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637SNA Logical Unit Control Block (LUCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638SNA Logon Request Control Block (LRCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641SNA Remote Control Block (RMCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642SNA Session Request Queue (SRQE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644SNA Unit Control Block (SUCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645SNA Work Area (WACB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647Source Library Member Element (SLME) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 650Source Library Work Area (SLWA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651Spool Parameter List (SPL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654Spool Access Support Parameter List (PWRSPL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656SPL Checking Parameter List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674Spool Access Support Task Work Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675Spool Environment Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679Spool Environment Header (SEH) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680Spool Environment Record (SER) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682Storage Control Block (SCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684System Information Area (SIA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686Tape Control Block (TBB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687Task Control Block (TCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690

TCB State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691TCB Task Register Save Area (TRSA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691TCB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693Command Processor Control Block (CPB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714Additional Linkage Register Save Area (LRSA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715

Task Dispatch Trace Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720Timer Queue Element (TQE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721Trace Information Block (TIB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722User Exit Data Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723Virtual Buffer Control Area (Prefix) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724VTAM Driver Control Block (VDCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

Contents vii

Virtual Storage Control Block (VSCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726Wait Control Block (WCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727

Chapter 6. Diagnostic Aids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729General Debugging Hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729

Stand-alone Dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729Identifying the VSE/POWER Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729Identifying the SVA Part of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729Identifying Fixed Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729Identifying the Start of the Pageable Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730Locating and Identifying Control Blocks, Tables, and Areas . . . . . . . . . . . . . . . . . . . . . . . 730Identifying the Start of a CSECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734Establishing the Level of a CSECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735Determining the Active Routine and Analyzing Register Save Areas . . . . . . . . . . . . . . . . . 735Analyzing Event Control Blocks (ECBs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735Using Buffer Control Words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735Analyzing TCBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735RJE,BSC and PNET Telecommunication Trace Facility . . . . . . . . . . . . . . . . . . . . . . . . . 737PNET BSC/CTC/TCP I/O Logging on Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740Hardware Error Recording . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740VSE/POWER Disk Dump Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740Establishing the Last Command Issued . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740An Aid to Eliminate Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740Problems Related to VTAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740

System Dump Containing the VSE/POWER Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741

Appendix A. VSE/POWER Status Bytes in the VSE/AF Supervisor . . . . . . . . . . . . . . . . . 743

Appendix B. Summary of ECB Usage (4 and 8-Byte) . . . . . . . . . . . . . . . . . . . . . . . . . . 745

Appendix C. VSE/POWER Internal Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747Coding Aids . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747Macro Notation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 747

Format of Internal Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748IPW$ALN - Align to Storage Boundary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748IPW$AJ# - Assign New VSE/POWER Job Number . . . . . . . . . . . . . . . . . . . . . . . . . . . 748IPW$AQS - Add Queue Entry to Class Chain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748IPW$ATT - Attach VSE/POWER Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749IPW$BUF - Invoke PNET Buffer Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749IPW$CAF - Close Account File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751IPW$CLI - Close Logical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752IPW$CPY - Provide Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752IPW$CNC - Cancel VSE/POWER or VSE/POWER Task . . . . . . . . . . . . . . . . . . . . . . . . 753IPW$CTT - Perform Tape Control Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753IPW$DQS - Delete Queue Entry from Class Chain . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754IPW$DET - Detach VSE/POWER Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754IPW$DSD - Define Storage Descriptor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754IPW$FQS - Free Queue Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755IPW$GAM - Get Message and Send to Designated Person . . . . . . . . . . . . . . . . . . . . . . 755IPW$GAR - Get Account Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757IPW$GDR - Get Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757IPW$GLR - Get Logical Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757IPW$GMS - Call General Message Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 757IPW$GQR - Get Queue Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 758

viii VSE Central Functions V7R1 VSE/POWER DRM

IPW$GQS - Get Next Queue Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759IPW$GSL - GET SLI Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759IPW$GTE - Get Trace Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760IPW$GTO - Issue TD-Subtask Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760IPW$GTS - Issue SD-Subtask Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760IPW$IAS - Invoke Asynchronous Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761IPW$ICP - Invoke VSE/POWER Command Processor . . . . . . . . . . . . . . . . . . . . . . . . . 762IPW$ICS - Invoke Common Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763IPW$IDM - Invoke IDUMP of the VSE/POWER Partition . . . . . . . . . . . . . . . . . . . . . . . . 763IPW$IDS - Invoke Data Management Service Routines . . . . . . . . . . . . . . . . . . . . . . . . . 764IPW$IIS - Invoke Print Status Processing Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764IPW$IOM - Invoke I/O Monitor or SNA Send/Receive Routine . . . . . . . . . . . . . . . . . . . . . 765IPW$IOC - Invoke Compaction Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765IPW$IPS - Invoke PNET Driver Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765IPW$IQS - Invoke Queue Management Service Routines . . . . . . . . . . . . . . . . . . . . . . . . 766IPW$IRY - Invoke Queue File / Account File Recovery . . . . . . . . . . . . . . . . . . . . . . . . . 768IPW$ITP - TD-Subtask EZASMI Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 768IPW$ITS - SD-Subtask EZASMI Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769IPW$ITQ - Invoke Maintain Wait for Run Subqueue . . . . . . . . . . . . . . . . . . . . . . . . . . . 770IPW$IXS - Invoke Cross-Partition Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770IPW$MQR - Modify Queue Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771IPW$NTY - Notify User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772IPW$OAF - Open Account File for Read Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772IPW$OEF - Open 3540 Diskette File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773IPW$OLI - Open Logical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773IPW$OPI - Invoke Output Parameter Processing Routine . . . . . . . . . . . . . . . . . . . . . . . . 773IPW$OTP - Open Tape Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774IPW$PAR - Write Account Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774IPW$PDR - Put Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775IPW$PLR - Put Logical Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775IPW$RDC - Get Time of Day (Read Clock) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775IPW$RDD - Read Data Block from Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776IPW$RDQ - Read Queue Record from Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776IPW$RDT - Read Tape Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777IPW$RET - Return to Caller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777IPW$RLR - Release Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777IPW$RLV - Release GETVIS Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778IPW$RLW - Release Fixed (Real) Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778IPW$RMS - Remote Message Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779IPW$RQS - Reserve Queue Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780IPW$RSR - Reserve Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780IPW$RSV - Reserve GETVIS Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780IPW$RSW - Reserve Fixed (Real) Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782IPW$SAV - Save Caller's Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782IPW$SRJ - Scan Reader JECL Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783IPW$SRM - Set Remote Mask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783IPW$SSJ - Call Parameter Checking Routine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 783IPW$STM - Set Timer Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784IPW$SXJ - Scan Execution JECL Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785IPW$TDM - Switch Turbo Dispatcher Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785IPW$TTM - TD-Subtask Timer Interval Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785IPW$TTS - SD-Subtask Timer Interval Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786IPW$ULP - Update LUB/PUB Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787IPW$UNV - Unchain Virtual Storage Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787

Contents ix

IPW$VCA - Validate Command Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788IPW$VDA - Validate Data Area Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 788IPW$WF[x] - Wait for VSE/POWER Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789IPW$WQR - Write Queue Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 790IPW$WTD - Write Data Block to Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 790IPW$WTO - Write to Operator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791IPW$WTQ - Write Queue Record Block to Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792IPW$WTR - Write to Operator with Reply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792IPW$WTT - Write Tape Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793

Appendix D. VSE/POWER Storage Requirements for Release 6.1 . . . . . . . . . . . . . . . . . . 795

List of Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799

Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 801

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805

x VSE Central Functions V7R1 VSE/POWER DRM

Figures

1. Relationship Between VSE/POWER, VSE/AF, and the Program Running under the Control ofVSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2. Basic Organization of the VSE/POWER Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143. SVA Part of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154. Devices Supported by VSE/AF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165. Hierarchic Structure of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196. Relationship of Internal and External Save Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217. Contents of Registers when a Service is Invoked . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238. Interface Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329. Function Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

10. Service Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3411. Definition Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3612. Miscellaneous Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3713. PNET TCP TD-Subtask Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3714. PNET SSL SD-Subtask Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3815. Initiation Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4016. Initial Task Selection (TCB Chain) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4517. Free DBLK Group Subchain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4618. Task Selection List (TSL) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5919. Attaching a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6120. Overview of Task Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6221. Detaching a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6422. Data Flow Throughout the Spooling Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6523. Physical and Logical Work Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6624. Physical Data Area - GETVIS Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6725. Execution Segmentation Data Flow Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7126. SETPRT Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7227. SETPRT Request Processing Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7428. Internal Tape Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7729. Flow of a Dynamic Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8130. Logic Flow of PLOAD DYNC Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8531. Control Block Relationship for Dynamic Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8832. Device Type - Queue Record Block Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8933. Free Queue Record Chain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9034. Class Chain and Queue Entry Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9135. Data Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9436. Job Header, Data Set Header and Job Trailer Format . . . . . . . . . . . . . . . . . . . . . . . . . 9537. Structure of Job Queue and 'Wait For Run' Subqueue . . . . . . . . . . . . . . . . . . . . . . . . 10438. Resource LOCKWORD of a VSE/POWER Control Block . . . . . . . . . . . . . . . . . . . . . . 12339. Storage Management Control Blocks Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . 12440. Virtual Storage Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12641. Local Job Submission and Notification Message Queuing . . . . . . . . . . . . . . . . . . . . . . 12942. Shared System Notify Message Queuing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12943. Job Completion Message Queuing at Receiving System . . . . . . . . . . . . . . . . . . . . . . . 13044. Job Completion Message Queuing at Shared Receiving System . . . . . . . . . . . . . . . . . . 13145. Message Flow with Shared Processing System and Network . . . . . . . . . . . . . . . . . . . . 13246. Job Event Message Queuing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13347. Control Block Relationship for Communicator Information Block 2 . . . . . . . . . . . . . . . . . 13448. Conversion from f.f. NMR to Message Queue Format . . . . . . . . . . . . . . . . . . . . . . . . 13549. Message Service Control Block Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

© Copyright IBM Corp. 1979, 2006 xi

50. I/O Request Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13851. Disk Management Control Blocks Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14052. Tape Service Control Blocks Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14053. Areas Checked by Validation Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14254. Trace Service Control Block Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14355. Local Message Routing Codes for WTO/WTOR Macro . . . . . . . . . . . . . . . . . . . . . . . 14556. Local Message Descriptor Codes for WTO/WTOR Macro . . . . . . . . . . . . . . . . . . . . . . 14657. Message Modification Characters and Action Table . . . . . . . . . . . . . . . . . . . . . . . . . 15058. Relationship Between VSE/POWER and VSE/AF Job Accounting . . . . . . . . . . . . . . . . . 18459. User Specified Account Records, Data Relationship . . . . . . . . . . . . . . . . . . . . . . . . . 18660. Starting a PNET Connection - Shown for a BSC Link . . . . . . . . . . . . . . . . . . . . . . . . 19361. Control Flow when Stopping a PNET Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . 19462. PNET BSC and CTC CCW Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19663. TD Subtask - Three Operation Layers for PNET TCP support. . . . . . . . . . . . . . . . . . . . 20064. TD-Subtask - Flow of I/O after PSTART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20765. TD Subtask - Startup and First PSTART Command . . . . . . . . . . . . . . . . . . . . . . . . . 20866. TD Subtask - Second PSTART Command and Signon Complete . . . . . . . . . . . . . . . . . 20967. TD Subtask - Processing the Idling State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21068. Socket Calls Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22569. Synchronous Socket Calls Read and Write Used Implicitly . . . . . . . . . . . . . . . . . . . . . 22670. SD Subtask - Three Operation Layers for PNET SSL support. . . . . . . . . . . . . . . . . . . . 22671. SD Subtask - Startup and First PSTART Command . . . . . . . . . . . . . . . . . . . . . . . . . 23572. SD Subtask - Second PSTART Command and Signon Complete . . . . . . . . . . . . . . . . . 23773. SD Subtask - Processing the Idling State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23974. PNET SNA Session Establishment - for First Node . . . . . . . . . . . . . . . . . . . . . . . . . . 25475. PNET SNA Session Establishment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25576. PNET SNA Remote Initiated Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25777. PNET SNA Primary Initiated Stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26078. PNET SNA Secondary Initiated Stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26279. PNET SNA Abnormal Termination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26680. PNET SEND Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26981. PNET RECEIVE Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27182. General Transmission Flow - Shown for BSC Link . . . . . . . . . . . . . . . . . . . . . . . . . . 27383. Format of Output Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27784. JES2 to VSE/POWER Priority Conversion Table . . . . . . . . . . . . . . . . . . . . . . . . . . . 27985. PNET Internal Record Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28386. SCB Byte Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28587. String Control Byte (SCB) for BSC/CTC/TCP/SSL communication . . . . . . . . . . . . . . . . . 28688. Record Control Byte (RCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28789. Subrecord Control Byte (SRCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28890. Function Control Sequence (FCS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28991. Block Control Byte (BCB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29092. Multi-Leaving Buffer Format for SNA Communication . . . . . . . . . . . . . . . . . . . . . . . . 29093. Multi-Leaving Buffer Format for BSC/CTC/TCP/SSL . . . . . . . . . . . . . . . . . . . . . . . . . 29194. PNET BSC/TCP/SSL Control Block Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . 29295. PNET BSC/CTC/TCP Buffer Relationship and Queuing . . . . . . . . . . . . . . . . . . . . . . . 29396. PNET SNA Control Block Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29497. PNET SNA Buffer Relationship and Queuing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29598. RJE,BSC Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29799. LCB Activity Checking and Channel End Processing . . . . . . . . . . . . . . . . . . . . . . . . . 298100. Line Action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299101. RJE,BSC Reader Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300102. RJE,BSC Writer Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302103. RJE,SNA Interrelationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

xii VSE Central Functions V7R1 VSE/POWER DRM

104. BIND Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307105. FMH1 Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311106. Default FMH1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312107. FMH2 Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313108. FMH3 Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314109. Description of RJE,SNA Routines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317110. Description of RJE,SNA Control Blocks and Work Areas . . . . . . . . . . . . . . . . . . . . . . 320111. RJE,SNA Execution Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321112. RJE,SNA Control Block and Work Area Chaining . . . . . . . . . . . . . . . . . . . . . . . . . . . 330113. Appendage Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334114. Slot-DBLK Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338115. SAS Master Task Control Block Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346116. SAS User Task Module Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347117. Possible Requests within GET Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349118. Possible Requests within GET BROWSE Function . . . . . . . . . . . . . . . . . . . . . . . . . . 350119. Possible Requests within PUT Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351120. Possible Requests within CTL Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352121. Possible Requests within GCM Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352122. CTL Function Control and Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354123. GET Data/Control Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356124. PUT Function Control/Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359125. Output Parameter Text Block Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360126. GCM Function Program Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364127. Processing GCM-OPEN-KEEP Followed by GCM-MORE and GCM-REMOVE . . . . . . . . . . 365128. Processing GCM-OPEN-KEEP Followed by GCM-OPEN-REMOVE . . . . . . . . . . . . . . . . 366129. GCM Function Control/Data Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367130. GCM Function Control/Data Flow (cont.) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368131. Device Serving Support - Device Driving System Overview . . . . . . . . . . . . . . . . . . . . . 374132. Normal Protocol to Start a Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376133. External Device Reactivation Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378134. Flush HOLD Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380135. External Device Termination Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381136. Message Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408137. Message Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430138. Message Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431139. Control Blocks in the SVA Part of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . 433140. Storage Layout of VSE/POWER Partition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435141. Control Blocks Permanently Allocated in the Fixable Area . . . . . . . . . . . . . . . . . . . . . . 439142. Control Blocks Dynamically Allocated in the Fixable Area . . . . . . . . . . . . . . . . . . . . . . 440143. Control Blocks Dynamically Allocated in the GETVIS Area . . . . . . . . . . . . . . . . . . . . . 443144. Cancel Codes of VSE/POWER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456145. Task Class List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712146. Summary of Linkage Register Save Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713147. Linkage from a Physical Routine to a Function Routine . . . . . . . . . . . . . . . . . . . . . . . 715148. Linkage from One Function Routine to Another Function Routine . . . . . . . . . . . . . . . . . 716149. Linkage Between the Two LRSAs in a Double Linkage Register Save Area (Case 1) . . . . . . 717150. Linkage Between the Two LRSAs in a Double Linkage Register Save Area (Case 2) . . . . . . 718151. Locating and Identifying Control Blocks, Tables and Areas in the SVA Part . . . . . . . . . . . . 730152. Locating and Identifying Control Blocks, Tables, and Areas in the Fixable Area . . . . . . . . . 731153. Locating and Identifying Control Blocks, Tables and Areas in the VSE/AF GETVIS Area . . . . 734154. General Meaning of the Task Management Fields . . . . . . . . . . . . . . . . . . . . . . . . . . 736155. General Meaning of Fields in the TRSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737156. Summary of ECB Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745157. Relationship Between Classes in the TCB and the Master Class Table in the DMB . . . . . . . 746

Figures xiii

158. Values for Calculating IBM VSE/POWER's Fixable and Getvis Areas . . . . . . . . . . . . . . . 796

xiv VSE Central Functions V7R1 VSE/POWER DRM

Figures xv

xvi VSE Central Functions V7R1 VSE/POWER DRM

Notices

References in this publication to IBM* products, programs, or services do not imply that IBM intends tomake these available in all countries in which IBM operates. Any reference to an IBM product, program,or service is not intended to state or imply that only that IBM product, program, or service may be used.Any functionally equivalent product, program, or service that does not infringe any of the intellectual prop-erty rights of IBM may be used instead of the IBM product, program, or service. The evaluation andverification of operation in conjunction with other products, except those expressly designated by IBM, arethe responsibility of the user.

This publication is intended primarily for use by IBM personnel responsible for program service. The infor-mation contained in this document has not been submitted to any formal IBM test and is distributed AS IS.It is not intended as a description of a programming interface. The use of this information is a customerreponsibility. Service for errors, ommissions, accuracy, or completeness will not be provided.

IBM may have patents or pending patent applications covering subject matter in this document. The fur-nishing of this document does not give you any license to these patents. You can send license inquiries,in writing, to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785,U.S.A.

Programming Interface Information

This publication is intended to help the customer to do diagnosis of VSE/ESA. This publication documentsinformation that is Diagnosis, Modification, or Tuning Information provided by VSE/ESA.

Warning: Do not use this Diagnosis, Modification, or Tuning Information as a programming interface.

Trademarks and Service Marks

The following terms, used in this publication, are trademarks or service marks of the IBM Corporation inthe United States and/or other countries.

ACF/VTAMAdvanced Function PrintingAFPAS/4��CICSCICS/VSEEnterprise Systems Architecture/37�Enterprise Systems Architecture/39�ES/9��ESA/39�IBMOS/39�Print Services FacilitySystem/37�VM/ESAz/VSEVTAM

© Copyright IBM Corp. 1979, 2006 xvii

xviii VSE Central Functions V7R1 VSE/POWER DRM

Preface

This manual, contains:

� Chapter 1: Gives an overview of VSE/POWER, states requirements for operation, and lists thedevices supported by VSE/POWER.

� Chapter 2: Describes the method of operation, including linkage and register conventions.

� Chapter 3: Outlines the logical structure of VSE/POWER; it explains the internal operations andshows the relationships between tasks and routines.

� Chapter 4: Lists program identifiers. This allows you to establish the relationship between phases,modules, and control sections. This part also lists the VSE/POWER messages and the relatingmodules.

� Chapter 5: Describes the layout of the VSE/POWER partition, account records, control blocks, andthe work areas required by VSE/POWER.

� Chapter 6: Gives debugging hints, and shows how you can get information from a dump of theVSE/POWER partition.

At the back of this manual, you find:

� VSE/POWER Internal Macros.� Appendixes: They expand on the information given in the above sections.� List of Abbreviations.� Bibliography: Lists manuals you may want to consult.� Glossary: Explains some of the terminology used in this manual.

� Index.

© Copyright IBM Corp. 1979, 2006 xix

xx VSE Central Functions V7R1 VSE/POWER DRM

Chapter 1. Introduction

This section contains an overview of the Virtual Storage Extended/Priority Output Writers, ExecutionProcessors and Input Readers (VSE/POWER) Program Product. It is organized as follows:

� Purposes of VSE/POWER. A general description of VSE/POWER and the way its major functions areperformed under VSE/AF.

� Communication with VSE/POWER. A summary of the VSE/POWER Operator Commands and the JobEntry Control Language, which allow the user to control VSE/POWER operations. The format of themessages issued by VSE/POWER is also explained.

� Environmental Requirements. The programming requirements for the various functions ofVSE/POWER, and the basic organization of the VSE/POWER partition with its storage requirements.The machines and devices which are supported by VSE/POWER are listed under "Hardware Support".

Purposes of VSE/POWER

VSE/POWER performs automatic spooling and priority scheduling under the control of the VSE/AF super-visor. VSE/POWER occupies a virtual partition in which it is initiated and can service from one to elevenbatch partitions (other than the VSE/POWER partition) of a lower or sometimes a higher dispatching pri-ority. Coexisting with the spooled static partitions, VSE/POWER services dynamic partitions. Input tosupported partitions is first spooled onto intermediate disk storage. When the supported partition com-mences execution, I/O requests to reader devices are intercepted and satisfied from intermediate storagevia I/O data areas in the VSE/POWER partition. Output requests to list and punch devices are also inter-cepted, with the output being stored in output data areas of the VSE/POWER partition and later trans-ferred to disk or tape. Printing and punching of the output from disk or tape is carried out when requestedby the operator. Under the control of VSE/POWER, programs may be executed in either real or virtualmode.The optional Shared Spooling function permits the sharing of the VSE/POWER files that contain thespooled input and output among two or more VSE/AF systems running in the same processor or differentprocessors.

The use of the optional networking function, referred to in other parts of this manual as PNET, allowsVSE/POWER to fully participate within networks consisting of other VSE/POWER nodes, JES2/JES3 NJEnodes or RSCS nodes.Jobs, Output (list, punch), operator commands and messages can be transmitted from one computersystem to another.The methods of communication used are binary synchronous communication (BSC) lines, channel-to-channel adapters (CTCA), synchronous data link control (SDLC) lines, and Internet (Transmission ControlProtocol/Internet Protocol: TCP/IP).

Three major operations are performed under VSE/POWER control:

Read User job information is read from a reader device (card, diskette, or tape) and spooled to interme-diate storage (DASD). The PUTSPOOL macro interface can be optionally used to submit a jobstream from the user's buffer area to intermediate storage.

The input may also come optionally from a remote terminal supported by the VSE/POWERRemote Job Entry, or from a network supported by the VSE/POWER Networking function.

The job is executed under the control of the VSE/POWER execution processor to meet userprogram requests.

© Copyright IBM Corp. 1979, 2006 1

List List output generated by the user program is spooled to intermediate storage (DASD or magnetictape) before being transferred to a list device, normally a line printer.

The GETSPOOL macro interface can be optionally used to request retrieval of printer output.

The list output may optionally be returned to a remote printer supported by the VSE/POWERRemote Job Entry, or to another node within a network supported by VSE/POWER Networking.

Punch Punch output generated by the user program is spooled to intermediate storage (DASD or mag-netic tape) before being transferred to a punch device, normally a card punch.

The GETSPOOL macro can be used to request retrieval of punched output.

The punch output may optionally be returned to a remote punch supported by the VSE/POWERRemote Job Entry, or to another node within a network supported by VSE/POWER Networking.

Additionally, VSE/POWER provides a programmable interface, referred to in other parts of the manual asSpool Access Support (SAS), which allows accessing the VSE/POWER spool files from any applicationrunning in another partition either controlled or not controlled by VSE/POWER. It offers services that allowtwo-way communication between VSE/POWER and a user using the cross partition communication facility(XPCC) of VSE/AF. A "User" can be defined as any application, task, transaction, or interactive user whois active in another partition. The support enables a user to:

� Submit a job to the VSE/POWER RDR queue for later execution in a VSE/POWER controlled partitionor to the XMT queue for transmission to another node in the network.

� Spool list or punch data to the output queues (LST, PUN or XMT).

� Retrieve data from the RDR, LST or PUN queue.

� Manipulate the local or remote queues.

� Route messages to the central operator, any remote operator, any other interactive user either on thelocal or remote system or any remote RJE terminal operator.

� Pass other commands, such as PDISPLAY T, to VSE/POWER for processing.

� Return job event messages

Intermediate storage therefore contains user input and output data spooled to and from it under the controlof VSE/POWER.

The user can generate several different versions, depending on the parameters specified in the POWERmacro, and optional PLINE, PRMT, PNODE and PCPTAB macros.

The partition in which VSE/POWER is initiated is referred to as the VSE/POWER partition.

VSE/POWER Private Subtasks

To perform the required operations concurrently, VSE/POWER is structured into a series of asynchro-nously executed tasks. These tasks are:

� VSE/POWER partition VSE/AF maintask

� VSE/POWER partition VSE/AF subtasks

In addition, VSE/POWER has its own

� VSE/POWER partition private subtasks

VSE/POWER private subtasking task support is provided within the VSE/POWER system and does notpresuppose Multitasking Support within the VSE/AF supervisor.

The VSE/POWER private subtasks are as follows:

2 VSE Central Functions V7R1 VSE/POWER DRM

INITIATOR TASK. Takes over from the VSE/POWER maintask at startup time and completesVSE/POWER initiation. For details refer to “Initialization of VSE/POWER” on page 39.

TERMINATOR TASK. Created at initialization time, and waits for posting of either

� offline formatting of data file extents, or

� final deletion of entries in the DELetion queue, or

� termination processing due to the PEND command.

For details refer to “Termination of VSE/POWER” on page 54.

COMMAND TASK. Handles system operator commands and initiates other VSE/POWER tasks, or allowsstopping of tasks.

WAIT TASK. Transfers the VSE/POWER partition to and from the wait state to meet system requirements.

RJE,BSC LINE MANAGER TASK. Controls line activities with remote terminals. The task is alive as longas VSE/POWER is active.

RJE,SNA MANAGER TASK. Controls the activation of transmission processing to and from a remoteSNA workstation on a demand basis. The task is attached when the central operator issues a PSTARTRJE,SNA command. The SNA manager also attaches a VSE/AF subtask in which the interface withVTAM is opened.

RJE,SNA LOGON TASK NO. 1. Initializes session work areas and does validity checking of logonrequest.

RJE,SNA LOGON TASK NO. 2. Establishes a session between VSE/POWER and a remote SNA work-station.

RJE,SNA LOGOFF TASK. Terminates a session between VSE/POWER and a remote SNA workstation.

RJE,SNA MESSAGE TASK. Sends messages to a remote SNA workstation.

SPOOL MANAGER TASK. Controls the activation and deactivation of the internal reader task and thespool/command manager list task. The task is attached during VSE/POWER initialization whenSPOOL=YES is specified in POWER macro and detached at VSE/POWER termination.

READ TASK. (See Notes, item 2 on page 6.) Performs the first part of the read operation and transferinformation from a peripheral reader to intermediate direct access storage. The operator may call forconcurrent execution of as many read tasks as he has physical readers available. Each read task istherefore associated with a specific reader.

TAPE READ TASK. (See Notes, item 3 on page 6.) Performs the first part of a read operation andtransfer information from a tape device to intermediate direct access storage.The operator can call for the concurrent execution of as many tape read tasks as he has physical tapeunits available.

RJE,BSC READ TASK. (See Notes, item 2 on page 6.) Performs the read operation for a remote station.Each RJE,BSC read task has the standard name '1RDR' assigned to it. Different RJE,BSC read tasks arefurther distinguished by suffixing the line address to this standard name.

RJE,SNA READ TASK. Performs the read operation from a remote SNA workstation.

Chapter 1. Introduction 3

INTERNAL READER TASK. Performs the read operation for the PUTSPOOL VSE/POWER cross-partition communication macro interface.

EXECUTION READ TASK (See Notes, items 1 and 2 on page 6.) Performs the second part of the readoperation and transfer information from intermediate direct access storage to meet the read requests ofthe user program. Each execution read task is associated with a specific partition. There can thereforeexist as many execution read tasks as there are partitions controlled by VSE/POWER.

EXECUTION LIST TASK. (See Notes, items 1 and 3 on page 6.) Performs the first part of the list func-tion and transfer information from the user program to either intermediate direct access storage or tape.There can exist as many execution list tasks as printers being spooled per partition, under VSE/POWERcontrol. Each execution writer is associated with the partition for which it is spooling.

EXECUTION PUNCH TASK. (See Notes, items 1 and 3 on page 6.) Performs the first part of the punchfunction and transfer information from the user program to either intermediate direct access storage ortape. There may exist as many execution punch tasks as punches being spooled per partition, underVSE/POWER control. Each execution punch task is associated with the partition for which it is spooling.

LIST TASK. (See Notes, item 3 on page 6.) Performs the second part of the list operation and transferinformation from intermediate direct access or tape storage to the printer. The operator may call for con-current execution of as many list tasks as he has physical printers available. Each list task is thereforeassociated with a specific printer.

RJE/BSC LIST TASKS. (See Notes, item 3 on page 6.) Performs the list operation for a remote BSCwork/workstation. Only one list task may be active per line. Each RJE,BSC list task has the standardname '1LST' assigned to it. Different RJE,BSC list tasks are further distinguished by suffixing the lineaddress to this standard name.

RJE,SNA LIST TASK. Performs the list operation to a remote SNA workstation.

SPOOL/COMMAND MANAGER LIST TASK. Performs the list/punch retrieval (GETSPOOL) and thecommand invocation (CTLSPOOL) for the VSE/POWER spool manager interface.

PUNCH TASK. (See Notes, item 3 on page 6.) Performs the second part of the punch function andtransfers information from intermediate direct access storage or tape to the punch. The operator may callfor concurrent execution of as many punch tasks as he has physical punches available. Each punch taskis therefore associated with a specific punch.

RJE,BSC PUNCH TASK. (See Notes, item 3 on page 6.) Performs the PUNCH operation for a remoteBSC workstation. Each RJE,BSC punch task has the standard name '1PUN' assigned to it. DifferentRJE,BSC punch tasks are further distinguished by suffixing the line address.

RJE,SNA PUNCH TASK. Performs the punch operation to a remote SNA workstation.

ACCOUNT TASK. Supports the VSE/POWER job accounting option (together with VSE/AF JAI). It givesthe user the option to either save the account file on another medium (tape, disk, cards) or delete thecontents of the account file. The contents and format of the account records are not checked or changedby this task.

STATUS TASK. Scans the queue file, POFFLOAD or spool tapes, or network definition table and printsthe status display or node information respectively on SYSLOG, a line printer, a workstation printer, buildsa LST queue entry containing the desired information, or sends the queue status display / node informa-tion back to the originating node.The Status task also performs the dumping of the storage copy of the queue file residing in VIO or parti-tion GETVIS.


OFFLOADING TASK. Performs one of the following functions:

� Saves queue entries on tape, or� Stores the contents (backup) of an entire class chain or queue onto tape, or� Restores saved queue entries, selectively if desired, from POFFLOAD or spool tape to VSE/POWER

queue.

The operator can call for the concurrent execution of as many off-loading tasks as he has physical tapeunits available.

TIMER TASK. Supports the time-sharing approach used by the Shared Spooling function. Interfaces witha VSE/AF subtask that handles the timer intervals.

NOTIFY TASK. Controls the transfer of messages destined for a particular subsystem, such asVSE/ICCF or VSE/DSNX. The task is attached by the SAS master task when the first 'notify' connectionrequest is encountered; the task is detached at VSE/POWER termination.

PNET DRIVER TASK. Controls all activities on a PNET BSC/CTC or SDLC communication line. Proc-essing is performed on a demand basis. The task is attached when the first PSTART PNET, nodeid isentered and detached when the last node is disconnected (signed off). The Network Driver also attachesa VSE/AF subtask in which the interface with VTAM is opened, when the first PSTART for a node is givenusing an SDLC communication line.

TRANSMITTER TASK. Transmits job or output to another node in the network. Up to eight transmitterscan be active at a time for any node currently connected. There can be a mixture of job and outputtransmitters active concurrently. The task is active as long as there are jobs or output eligible for trans-mission.

RECEIVER TASK. Receives either job or output from another node in the network. Up to eight receivers,which may be a mixture of job or output receivers, can be active at a time for any node which is currentlyconnected. The receiver task is attached only for the duration of the transmission of one job or output.

CONSOLE TRANSMITTER TASK. Sends messages and commands to another node in the network. Thetask exists as long there are messages or commands to send.

CONSOLE RECEIVER TASK. Receives messages and commands from another node in the network.The task is associated with a specific node and is attached when the node is started and exists as long asthe connection to that node exists.

CONNECT TASK. Establishes a SNA session between VSE/POWER and another node in the network.The task is attached either when a PSTART nodeid is entered by the central operator, in which case thetask acts as primary application, or when a BIND is received, in which case the task acts as secondaryapplication.

DISCONNECT TASK. Terminates a SNA session between VSE/POWER and another node in thenetwork acting as a primary or secondary application.

SPOOL ACCESS SUPPORT MASTER TASK. Acts as a watchdog and waits for connection requestsfrom other partitions; it controls the activation of the notify task and SAS user tasks. The task is attachedduring VSE/POWER initialization and detached at VSE/POWER termination.

SPOOL ACCESS SUPPORT USER TASK. Performs each function request from a SAS user. The func-tion can be to:

� Spool jobs to the VSE/POWER RDR or XMT queue.� Spool list or punch data to the output queues.


� Retrieve job/output data from the various VSE/POWER queues.� Manipulate queue entries in the various VSE/POWER queues.� Issue VSE/POWER commands or to send messages.� Retrieve fixed format Job Completion messages queue for a user

The task is attached by the SAS master task when a new XPCC connection is established and detachedon demand by the SAS user or the system operator by means of the PSTOP command.

DEVICE SERVICE TASK. Services a Device Driving System (DDS) and transfers output data from theVSE/POWER spool files to the DDS processing the external output device. The task is attached by thecommand processor when a PSTART DEV command is given and terminated as result of a PSTOP DEVcommand.

TIME EVENT SCHEDULING TASK. Calculates the time interval for the first queue entry in the wait forrun subqueue and waits for its expiration. After expiration it removes the queue entry from the wait for runsubqueue and chains it to the really dispatchable class chain. The task is attached during VSE/POWERinitialization and detached at VSE/POWER termination time.

HEARTBEAT TASK. Watches in an unattended node environment over VSE/OCCF. If VSE/OCCF termi-nates abnormally the heartbeat task forces VSE/POWER termination via PEND IMM and indicates REIPLto do. The task is attached by the spool access support master task if the environment is unattended andthe application id is SYSOCCF. The task is detached at VSE/POWER termination time or if the connectionis terminated normally or abnormally.

DYNAMIC PARTITION SCHEDULING TASK. Operates as a static 'hyper'- execution reader task. It allo-cates dynamic partitions for queue entries whose class is defined in the dynamic class table. Thedynamic partition scheduling task is attached during VSE/POWER initialization. It is detached duringVSE/POWER termination.

Notes:

1. Execution read tasks, execution list tasks, and execution punch tasks are collectively referred to as“execution processor” tasks.

2. Read, list and punch tasks are collectively referred to as “read/write” tasks.

3. Each read task is divided into two parts, physical reader (PR), tape reader (SY), BSC reader (BR)and/or 3540 reader (ER), which performs the device-dependent functions related to data collectionfrom a specified device or family of devices, and logical reader (LR), which performs the logical func-tions related to entering input data into the VSE/POWER data file and inserting a new queue entry intothe correct position in the VSE/POWER queue file. These two parts are linked by means of a high-level logical record interface.

Similarly, each list task is divided into Physical List (PL), BSC Writer (BW) or Physical Punch (PP),and Logical Writer (LW). The physical part of a task performs device-dependent functions for printeror punch, respectively. The Logical Writer retrieves data from the list queue or the punch queue, asrequired. In each case a high-level logical record interface is defined to connect the two parts of thetask.

Figure 1 shows the relationship of the user program to the VSE/POWER partition and tasks and to theVSE/AF supervisor.


Figure 1. Relationship Between VSE/POWER, VSE/AF, and the Program Running under the Control of VSE/POWER

Notes:

1. SVC 0 for I/O to VSE/POWER files.

2. SVC 0 from user partition unit record devices converted to I/O to a spooling device on VSE/POWERpartition.

3. SVC 7 issued by VSE/POWER.

4. SVC 0 for I/O from VSE/POWER files


VSE/POWER Direct Access Files

VSE/POWER files can be either on Count-Key-Data (CKD) or Fixed Block Architecture (FBA) devices. Amixture is also possible, however the extents of the Data File must all reside on the same disk type.

For a list of disk types available to contain the VSE/POWER 7.1 spool files refer to z/VSE 3.1 Planning.

For more information on the organization of the VSE/POWER files, refer to the VSE/POWER Adminis-tration and Operation.


Communication with VSE/POWER

VSE/POWER Operator Commands

VSE/POWER provides operator commands that allow the central-system operator and the remote-terminaloperator to communicate with the system. Following types of commands are provided:

� Task-management commands, which allow the operator to initiate and terminate VSE/POWER tasks(except spool management tasks). For RJE, task management commands are only applicable to theRJE writer task. The RJE reader task is started whenever the workstation is ready to send. Its opera-tion is controlled by the system.

� Queue-management commands, which allow the operator to display and modify the contents ofVSE/POWER queue entries. Queue-management commands are only applicable to users that havethe correct authority.

� List-control commands, which allow the operator to perform certain device-dependent operations online printers.

� Workstation-control commands, which allow the remote operator to initiate and terminate VSE/POWERRJE tasks.

� Network-control commands, which allow the operator to perform certain operations to control the func-tioning of the network system.

� External device control commands, which allow the operator to initiate, control and terminate externaldevices.

For further information on VSE/POWER operator commands refer to VSE/POWER Administration andOperation.

Job Entry Control Language

VSE/POWER provides a job entry control language (JECL) to assist the user in delimiting jobs to thesystem and to allow him to specify special requirements that may apply to particular jobs. JECL supple-ments but does not replace the job control language (JCL) provided by VSE/AF itself. The JCL statementsrequired for normal VSE/AF system operation are also required when operating under VSE/POWER.

For a detailed description of the VSE/POWER JECL statements, refer to VSE/POWER Administration andOperation.

Format of VSE/POWER Operator Messages

Messages sent by VSE/POWER to SYSLOG, SYSLST, or to a terminal may have the following formats:

1QnnI or 1RnnI or 1VnnI (information-type message)1QnnD (decision-type message)1QnnA or 1RnnA or 1VnnA (action-type message)

where:

Q VSE/POWER general-message indicator.

R VSE/POWER message indicator for messages issued by RJE,BSC, the command-processor tasks,the Shared Spooling function and networking.

V VSE/POWER message indicator for messages issued by RJE,SNA tasks.


nn message-identification number. (May also include alpha characters.)

I-type messages are for the operator's information only; no response is required. Processing continuesnormally.

D-type messages require an immediate reply from the operator.

A-type messages require some action from the operator, such as moun

Documents

VSE/POWER Diagnosis Reference - IBM · IBM Corporation or to: IBM Deutschland Entwicklung GmbH Attn: Dept ECJ - BP/003D Department 3252 6300 Diagonal Highway Schoenaicher Strasse