DOCSLIB.ORG

Ieaa800 V2r4.Pdf

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
Ieaa800 V2r4.Pdf z/OS 2.4 MVS Programming: Authorized Assembler Services Guide IBM SA23-1371-40 Note Before using this information and the product it supports, read the information in “Notices” on page 815. This edition applies to Version 2 Release 4 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2021-06-21 © Copyright International Business Machines Corporation 1988, 2021. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................ xv Tables.................................................................................................................xxi About this information......................................................................................xxvii Who should use this information............................................................................................................xxvii How to use this information................................................................................................................... xxvii z/OS information.................................................................................................................................... xxviii How to send your comments to IBM................................................................... xxix If you have a technical problem.............................................................................................................. xxix Summary of changes......................................................................................... xxxi Summary of changes for z/OS Version 2 Release 4................................................................................xxxi Summary of changes for z/OS Version 2 Release 3...............................................................................xxxii Summary of changes for z/OS Version 2 Release 2 (V2R2), as updated March, 2016........................xxxiii Summary of changes for z/OS Version 2 Release 2 (V2R2), as updated December, 2015.................xxxiii Summary of changes for z/OS Version 2 Release 2..............................................................................xxxiii Chapter 1. Introduction......................................................................................... 1 Chapter 2. Subtask creation and control.................................................................5 Creating a new task (ATTACH or ATTACHX macro)..................................................................................... 5 Ensuring that a process completes (STATUS macro)..................................................................................5 Communicating with a program (EXTRACT, QEDIT)................................................................................... 6 Providing an EXTRACT answer area.......................................................................................................8 Chapter 3. Program management.........................................................................11 Residency and addressing mode of programs..........................................................................................11 Placement of modules in storage........................................................................................................ 12 Addressing mode..................................................................................................................................12 Specifying where the module is to be loaded (LOAD macro)................................................................... 12 Synchronous exits (SYNCH or SYNCHX macro)........................................................................................ 13 Using checkpoint/restart........................................................................................................................... 13 Using re-entrant modules..........................................................................................................................14 Using LLACOPY to refresh LLA directories................................................................................................ 14 Changing the LNKLST concatenation........................................................................................................ 15 Changing the current LNKLST set........................................................................................................ 15 Monitoring dynamic LPA processing......................................................................................................... 15 Listing contents of dynamic LPA with CSVDLPAU............................................................................... 19 Monitoring dynamic exits processing........................................................................................................21 Monitoring fetch and unfetch processing..................................................................................................24 Chapter 4. Serialization....................................................................................... 29 Choosing a serialization service................................................................................................................ 29 Providing ENQ resource information on DISPLAY GRS command........................................................... 34 Locking....................................................................................................................................................... 34 Categories of locks............................................................................................................................... 35 iii Types of locks....................................................................................................................................... 35 Locking hierarchy................................................................................................................................. 36 CML lock considerations...................................................................................................................... 36 Obtaining, releasing, and testing locks (SETLOCK)............................................................................. 37 Suspend lock instrumentation data ....................................................................................................37 Using the must-complete function (ENQ/DEQ)........................................................................................ 38 Characteristics of the must-complete function...................................................................................38 Programming notes.............................................................................................................................. 39 Shared direct access storage devices (shared DASD).............................................................................. 39 Volume/device status...........................................................................................................................40 Volume handling...................................................................................................................................40 Macros used with shared DASD (RESERVE, EXTRACT, GETDSAB)..................................................... 40 Serializing parallel tasks (WAIT and POST).............................................................................................. 46 Asynchronous cross memory POST.....................................................................................................47 Synchronous cross memory post.........................................................................................................48 Bypassing the POST routine.................................................................................................................48 Waiting for event completion (EVENTS).............................................................................................. 48 Writing POST exit routines.........................................................................................................................49 Identifying and deleting exit routines..................................................................................................49 Initializing extended ECBs and ECB extensions..................................................................................49 POST interface with exit routines........................................................................................................ 50 Re-entry to POST from a POST exit..................................................................................................... 51 Branch entry to the POST service routine.................................................................................................51 Branch entry to the WAIT service routine.................................................................................................53 Serializing RB processing...........................................................................................................................54 Suspending an RB until an event completes (SUSPEND)....................................................................54 Using the CALLDISP macro.................................................................................................................
Load more

Recommended publications
  • Ubuntu Installation Guide
    Ubuntu Installation Guide Ubuntu Installation Guide Copyright © 2004 – 2020 the Debian Installer team Copyright © 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2015, 2018 Canonical Ltd. This document contains installation instructions for the Ubuntu 20.04 system (codename “‘Focal Fossa’”), for the S/390 (“s390x”) architecture. It also contains pointers to more information and information on how to make the most of your new Ubuntu system. This manual is free software; you may redistribute it and/or modify it under the terms of the GNU General Public License. Please refer to the license in Appendix F. Table of Contents Installing Ubuntu 20.04 “Focal Fossa” For s390x...........................................................................ix 1. Welcome to Ubuntu ........................................................................................................................1 1.1. What is Ubuntu?...................................................................................................................1 1.1.1. Sponsorship by Canonical .......................................................................................1 1.2. What is Debian? ...................................................................................................................1 1.2.1. Ubuntu and Debian..................................................................................................2 1.2.1.1. Package selection........................................................................................2 1.2.1.2. Releases.......................................................................................................3
    [Show full text]
  • Ubuntu Server for IBM Z and Linuxone
    Ubuntu Server for IBM Z and LinuxONE What’s New - June 2021 Frank Heimes, Tech. Lead Z, Canonical Ltd. Ubuntu on Big Iron: ubuntu-on-big-iron.blogspot.com Ubuntu Server for IBM Z and LinuxONE (s390x) Mission and Philosophy - In a nutshell Freedom to download Ubuntu - study, use, share, (re-)distribute, contribute, improve and innovate it! Mapped to Ubuntu Server for IBM Z and LinuxONE (s390x) - the goal is: ● to expand Ubuntu’s ease of use to the s390x architecture (IBM Z and LinuxONE) ● unlock new workloads, especially in the Open Source, Cloud and container space ● to tap into new client segments ● quickly exploit new features and components - in two ways: ○ promptly supporting new hardware ○ releases built and based on the latest kernels, tool-chain and optimized libraries ● provide parity across architectures, in terms of release and feature parity and closing gaps ● provide a uniform user experience and look-and-feel ● be part of the collective world-wide Open Source power in action ● deal with upstream work and code only - no forks ● offer a radically new subscription pricing with drawer-based pricing, or alternatively provide entry-level pricing based on up to 4 IFLs Release Cadence - Ubuntu https://wiki.ubuntu.com/Releases https://wiki.ubuntu.com/LTS https://en.wikipedia.org/wiki/List_of_Ubuntu_releases 16.04 16.10 17.04 17.10 18.04 18.10 19.04 19.10 20.04 20.10 21.04 20.10 in development Ubuntu 20.04 LTS end-of-life 19.10 in service with s390x support 19.04 upgrade path 18.10 Ubuntu 18.04 LTS 5 years ESM 17.10 17.04 18 months 16.10 5 years Ubuntu 16.04 LTS 5 years ESM Ubuntu 18.04 LTS (Bionic Beaver) ● The codename for the current LTS (Long Term Support) release 18.04 is 'Bionic Beaver' or in short 'Bionic': https://launchpad.net/ubuntu/bionic ● Bionic Release Schedule: https://wiki.ubuntu.com/BionicBeaver/ReleaseSchedule Release date: April, 26th 2018 ● Updated major components: ○ Kernel 4.15 (linux-generic) + HWE kernels ○ docker.io 17.12.1 → 18.09.5 ○ Qemu-KVM 2.11.x / Libvirt (libvirt-bin) 4.0.0 ○ Open vSwitch 2.9 → 2.9.2 ○ LXD 3.0.0 (incl.
    [Show full text]
  • IBM Z Systems Introduction May 2017
    IBM z Systems Introduction May 2017 IBM z13s and IBM z13 Frequently Asked Questions Worldwide ZSQ03076-USEN-15 Table of Contents z13s Hardware .......................................................................................................................................................................... 3 z13 Hardware ........................................................................................................................................................................... 11 Performance ............................................................................................................................................................................ 19 z13 Warranty ............................................................................................................................................................................ 23 Hardware Management Console (HMC) ..................................................................................................................... 24 Power requirements (including High Voltage DC Power option) ..................................................................... 28 Overhead Cabling and Power ..........................................................................................................................................30 z13 Water cooling option .................................................................................................................................................... 31 Secure Service Container .................................................................................................................................................
    [Show full text]
  • User's Guide and Reference for IBM Z/OS® Remote Access Programs August 2, 2021
    User's Guide and Reference for IBM z/OS® Remote Access Programs August 2, 2021 International Business Machines Corporation IBM Z Dallas ISV Center Dallas, TX USA This document is intended for the sole use of participants in an IBM Z Dallas ISV Center Remote Development or Early Test Program and is not to be distributed to non-participants or used for purposes other than intended. © Copyright International Business Machines Corporation 2019. All rights reserved. 1 Table of Contents 1 Preface .................................................................................................................................................... 4 1.1 Links ................................................................................................................................................. 4 2 Overview – Remote Access Environment ........................................................................................... 5 2.1 Hardware / Software Platform .......................................................................................................... 5 2.2 Introduction to the Virtual Machine Concept ................................................................................... 5 2.3 z/OS Remote Access Environment ................................................................................................... 5 2.4 Printers .............................................................................................................................................. 7 2.5 System Availability..........................................................................................................................
    [Show full text]
  • Linux on IBM System Z with Z/VM
    • Support for Collaborative Memory Management Assist (CMMA) • z/VM VSWITCH support for OSA-Express2 and OSA-Express3 IBM Systems and Technology Group on System z by which z/VM and Linux guests exchange link aggregation for increased throughput and provides more information to optimize their use and management of memory seamless nondisruptive failover in the event that an OSA port in • Up to 32 real processors in a single z/VM image the group becomes unavailable • Coordinated near-continuous availability and disaster recovery • Enhanced memory utilization using Virtual Machine Resource ™ Manager (VMRM) between z/VM and Linux guests for Linux guests with HyperSwap support and a Linux on IBM Geographically Dispersed Parallel Sysplex™ GDPS® solution • More extensive workloads and systems resource management features with VMRM including functions that may be called by Access to a Linux Environment client applications to allocate and manage resources for guests System z with • Enhanced I/O performance and operation of SCSI disks IBM has established a Linux environment that delivers virtual Linux including support for N-Port Identifier virtualization on System z servers so developers can port, test and develop new software servers technologies for the System z platform. For registration procedures z/VM • DVD installation to SCSI disks or 3390-format disks and terms of service for the Community Development System for • IPL of SCSI disks attached to FCP channels by z/VM for Linux Linux, go to: and other guest operating systems ibm.com/systems/z/os/linux/lcds/ Additional opportunities for Independent Software Vendors (ISVs) • Usability enhancements for the z/VM virtual switch (VSWITCH) to test drive the Linux experience are the Linux for System z Test and guest LAN environments Drive offerings.
    [Show full text]
  • Introducing Linux on IBM Z Systems IT Simplicity with an Enterprise Grade Linux Platform
    Introducing Linux on IBM z Systems IT simplicity with an enterprise grade Linux platform Wilhelm Mild IBM Executive IT Architect for Mobile, z Systems and Linux © 2016 IBM Corporation IBM Germany What is Linux? . Linux is an operating system – Operating systems are tools which enable computers to function as multi-user, multitasking, and multiprocessing servers. – Linux is typically delivered in a Distribution with many useful tools and Open Source components. Linux is hardware agnostic by design – Linux runs on multiple hardware architectures which means Linux skills are platform independent. Linux is modular and built to coexist with other operating systems – Businesses are using Linux today. More and more businesses proceed with an evolutionary solution strategy based on Linux. 2 © 2016 IBM Corporation What is IBM z Systems ? . IBM z Systems is the family name used by IBM for its mainframe computers – The z Systems families were named for their availability – z stands for zero downtime. The systems are built with spare components capable of hot failovers to ensure continuous operations. IBM z Systems paradigm – The IBM z Systems family maintains full backward compatibility. In effect, current systems are the direct, lineal descendants of System/360, built in 1964, and the System/370 from the 1970s. Many applications written for these systems can still run unmodified on the newest z Systems over five decades later. IBM z Systems variety of Operating Systems – There are different traditional Operating Systems that run on z Systems like z/OS, z/VSE or TPF. With z/VM IBM delivers a mature Hypervisor to virtualize the operating systems.
    [Show full text]
  • Practical Migration from IBM X86 to Linux on IBM System Z
    Front cover Practical Migration from x86 to Linux on IBM System z A guide to migrating popular applications and services from Linux on x86 to Linux on System z Practical guidance on planning, analysis, and TCO Comprehensive hands-on migration case study Lydia Parziale Eduardo Simoes Franco Craig Gardner Berthold Gunreben Tito Ogando Serkan Sahin ibm.com/redbooks International Technical Support Organization Practical Migration from x86 to Linux on IBM System z September 2014 SG24-8217-00 Note: Before using this information and the product it supports, read the information in “Notices” on page vii. First Edition (September 2014) This edition applies to z/VM Version 6.3, DB2 Version 10.5, SUSE Linux Enterprise Server Version 11, and Red Hat Enterprise Linux Version 6. Versions of other software components are incident to the versions available from the respective distributions referenced above. © Copyright International Business Machines Corporation 2014. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Notices . vii Trademarks . viii Preface . ix Authors. ix Now you can become a published author, too! . xi Comments welcome. xii Stay connected to IBM Redbooks . xii Chapter 1. Benefits of migrating workloads to Linux on System z . 1 1.1 Benefits . 2 1.2 Reasons to select Linux on System z . 3 1.2.1 System z strengths . 3 1.3 A new type of information technology: Workload centric . 5 1.4 Workload-centric cloud . 7 1.5 Enterprise cloud computing blueprint for System z. 9 1.5.1 Empowered virtualization management: IBM Wave for z/VM.
    [Show full text]
  • Ubuntu Server for IBM Z and Linuxone
    Ubuntu Server for IBM Z and LinuxONE Introduction and Overview Frank Heimes, Tech. Lead for Ubuntu on s390x, Canonical Ltd. Ubuntu on Big Iron: ubuntu-on-big-iron.blogspot.de Canonical We are the company behind Ubuntu. Where is the name Ubuntu coming from? ubuntu |oǒ'boǒntoō| Ubuntu is an ancient African word meaning ‘humanity to others’. It also means ‘I am what I am because of who we all are’. The Ubuntu operating system brings the spirit of Ubuntu to the world of computers. Ubuntu http://www.ubuntu.com/about/about-ubuntu Ubuntu Server for IBM Z and LinuxONE (s390x) Design Philosophy ● Expand Ubuntu’s ease of use to the s390x architecture (IBM Z and LinuxONE) ● Unlock new workloads, especially in the Open Source, Cloud and Container space ● Offer a radically new pricing approach (drawer-based pricing) ● Consequentially tap into new client bases ● Exploit new features and components faster - in two ways: ○ hardware: compiled for zEC12 and up ○ software: latest kernels, compilers and optimized libraries ● Provide party with other architectures ○ Release parity ○ Feature parity ○ Uniform user experience ○ Close potential gaps ● Open source - is collective power in action ● Upstream work and code only - no forks Ubuntu Release Naming Scheme The official name of an Ubuntu release is ‘Ubuntu x.y’ with ‘x’ representing the year (minus 2000) and ‘y’ representing the month of eventual release within in that year. So Ubuntu's first release, made available in 2004 October (October is the 10th month) was Ubuntu 4.10. Since the actual release date
    [Show full text]
  • IBM Z/Architecture Reference Summary
    z/Architecture IBMr Reference Summary SA22-7871-06 . z/Architecture IBMr Reference Summary SA22-7871-06 Seventh Edition (August, 2010) This revision differs from the previous edition by containing instructions related to the facilities marked by a bar under “Facility” in “Preface” and minor corrections and clari- fications. Changes are indicated by a bar in the margin. References in this publication to IBM® products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM program product in this publication is not intended to state or imply that only IBM’s program product may be used. Any functionally equivalent pro- gram may be used instead. Additional copies of this and other IBM publications may be ordered or downloaded from the IBM publications web site at http://www.ibm.com/support/documentation. Please direct any comments on the contents of this publication to: IBM Corporation Department E57 2455 South Road Poughkeepsie, NY 12601-5400 USA IBM may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you. © Copyright International Business Machines Corporation 2001-2010. All rights reserved. US Government Users Restricted Rights — Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. ii z/Architecture Reference Summary Preface This publication is intended primarily for use by z/Architecture™ assembler-language application programmers. It contains basic machine information summarized from the IBM z/Architecture Principles of Operation, SA22-7832, about the zSeries™ proces- sors. It also contains frequently used information from IBM ESA/390 Common I/O- Device Commands and Self Description, SA22-7204, IBM System/370 Extended Architecture Interpretive Execution, SA22-7095, and IBM High Level Assembler for MVS & VM & VSE Language Reference, SC26-4940.
    [Show full text]
  • IBM Z Systems Advanced Workload Analysis Reporter (IBM Zaware)
    IBM z Systems Advanced Workload Analysis Reporter (IBM zAware) Achieving Higher Availability . Complex incidents involving several different Most modern businesses rely so heavily on IT that subsystems an unplanned outage can result in negative . The triggers and events leading up to a problem financial and reputation consequences. Today IT How does it work? systems are highly complex, and message Messages are monitored and analyzed by IBM volumes issued far exceeds what humans can zAware including all z/OS console messages, ISV read, let alone analyze. Companies are seeking a and application generated messages, and Linux smarter way to analyze IT problems so that overall related messages. The baseline training for IBM service is not disrupted and can be restored zAware can be customized based on knowledge quickly before customers are impacted. of the workloads running on z/OS or Linux on z. IBM zAware is a self-contained firmware IT Users can also prime the server by transferring analytics solution that helps systems and prior data for IBM zAware monitored clients, and operations professionals rapidly identify request the server to build a model for each client problematic messages and unusual system from the transferred data. behavior in near real time. Systems Monitoring of both z/OS and Linux on z can be administrators can then use the information to run in the same partition that is isolated from take corrective actions. IBM zAware is designed production environments. This allows one IBM to dramatically reduce the time to isolate IT zAware to monitor multiple systems at the same problems so IT staff can restore service quickly time without impacting any operating system and improve overall availability.
    [Show full text]
  • Architectural Decisions for Linuxone Hypervisors
    July 2019 Webcast Virtualization options for Linux on IBM Z & LinuxONE Richard Young Executive IT Specialist Virtualization and Linux IBM Systems Lab Services Wilhelm Mild IBM Executive IT Architect for Mobile, IBM Z and Linux IBM R&D Lab, Germany Agenda ➢ Benefits of virtualization • Available virtualization options • Considerations for virtualization decisions • Virtualization options for LinuxONE & Z • Firmware hypervisors • Software hypervisors • Software Containers • Firmware hypervisor decision guide • Virtualization decision guide • Summary 2 © Copyright IBM Corporation 2018 Why do we virtualize? What are the benefits of virtualization? ▪ Simplification – use of standardized images, virtualized hardware, and automated configuration of virtual infrastructure ▪ Migration – one of the first uses of virtualization, enable coexistence, phased upgrades and migrations. It can also simplify hardware upgrades by make changes transparent. ▪ Efficiency – reduced hardware footprints, better utilization of available hardware resources, and reduced time to delivery. Reuse of deprovisioned or relinquished resources. ▪ Resilience – run new versions and old versions in parallel, avoiding service downtime ▪ Cost savings – having fewer machines translates to lower costs in server hardware, networking, floor space, electricity, administration (perceived) ▪ To accommodate growth – virtualization allows the IT department to be more responsive to business growth, hopefully avoiding interruption 3 © Copyright IBM Corporation 2018 Agenda • Benefits of
    [Show full text]
  • IBM Z/VM – Frequently Asked Questions
    IBM Z August 2020 IBM z/VM Frequently Asked Questions for z/VM 7.2, z/VM 7.1 and z/VM 6.4 Worldwide LUQ12358-USEN-14 1 Table of Contents _Toc45360441 General Questions ........................................................................................................................................... 3 IBM z/VM Support for IBM z15 and IBM LinuxONE III ................................................................................ 10 Technical Questions - IBM z/VM 7.2, z/VM 7.1, and z/VM 6.4 .................................................................... 11 Efficiency and Scalability ............................................................................................................................... 21 System Ease of Use ....................................................................................................................................... 23 Hardware Currency ........................................................................................................................................ 25 Installation, Migration, and Serviceability .................................................................................................... 27 Statements of Direction from Announcements ............................................................................................ 28 Resources ...................................................................................................................................................... 31 2 General Questions What is IBM Z® and IBM® LinuxONE virtualization
    [Show full text]