MVS Programming: Assembler Services Guide

Total Page:16

File Type:pdf, Size:1020Kb

MVS Programming: Assembler Services Guide z/OS Version 2 Release 3 MVS Programming: Assembler Services Guide IBM SA23-1368-30 Note Before using this information and the product it supports, read the information in “Notices” on page 483. This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications until otherwise indicated in new editions. Last updated: 2019-02-16 © Copyright International Business Machines Corporation 1988, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures...................................................................................................... xv List of Tables.......................................................................................................xix About this information........................................................................................ xxi Who should use this information.............................................................................................................. xxi How to use this information...................................................................................................................... xxi z/OS information........................................................................................................................................xxi Abstract for MVS Programming: Assembler Services Guide................................. xxii How to send your comments to IBM................................................................... xxiii If you have a technical problem.............................................................................................................. xxiii Summary of changes......................................................................................... xxiv Summary of changes for z/OS MVS Programming: Assembler Services Guide for z/OS Version 2 Release 3............................................................................................................................................ xxiv Summary of changes for z/OS Version 2 Release 2 (V2R2), as updated December, 2015...................xxiv Summary of changes for z/OS MVS Programming: Assembler Services Guide for z/OS Version 2 Release 2............................................................................................................................................ xxiv z/OS Version 2 Release 1 summary of changes.......................................................................................xxv Chapter 1. Introduction......................................................................................... 1 Chapter 2. Linkage conventions............................................................................. 5 Saving the calling program's registers.........................................................................................................6 Caller-provided save area.......................................................................................................................6 Linkage convention for floating point registers..................................................................................... 6 Linkage convention for the floating point control register.................................................................... 6 System-provided linkage stack..............................................................................................................7 Using the linkage stack................................................................................................................................ 7 Example of using the linkage stack........................................................................................................7 Using a caller-provided save area................................................................................................................8 If not changing ARs or bits 0–31 of the 64–bit GPRs............................................................................8 If changing the contents of bits 0-31 of the 64-bit GPRs but not changing ARs............................... 10 If starting in AMODE 64 .......................................................................................................................13 If changing ARs without using the linkage stack.................................................................................15 Establishing a base register.......................................................................................................................18 Linkage procedures for primary mode programs......................................................................................18 Primary mode programs receiving control.......................................................................................... 18 Primary mode programs returning control.......................................................................................... 19 Primary mode programs calling another program.............................................................................. 20 Linkage procedures for AR mode programs..............................................................................................20 AR mode programs receiving control and using the linkage stack..................................................... 20 AR mode programs returning control and using the linkage stack.....................................................21 AR mode programs receiving control and not using the linkage stack...............................................21 AR mode programs returning control and not using the linkage stack...............................................21 AR mode programs calling another program.......................................................................................22 Conventions for passing information through a parameter list................................................................22 Program in primary ASC mode.............................................................................................................22 Programs in AR mode...........................................................................................................................23 Chapter 3. Subtask creation and control...............................................................25 Creating the task........................................................................................................................................25 iii Priorities..................................................................................................................................................... 25 Address space priority......................................................................................................................... 25 Task priority.......................................................................................................................................... 26 Subtask priority.................................................................................................................................... 26 Assigning and changing priority........................................................................................................... 26 Stopping and restarting a subtask (STATUS macro)................................................................................. 26 Task and subtask communications........................................................................................................... 27 Chapter 4. Program management.........................................................................29 Residency and addressing mode of programs..........................................................................................29 Residency mode definitions.................................................................................................................29 Addressing mode definitions............................................................................................................... 30 Linkage considerations.............................................................................................................................. 30 Floating point considerations...............................................................................................................31 Passing control between programs with the same AMODE................................................................31 Passing control between programs with different AMODEs............................................................... 31 Passing control between programs with all registers intact...............................................................32 Load module structure types.....................................................................................................................34 Simple structure...................................................................................................................................34 Dynamic structure................................................................................................................................ 34 Load module execution..............................................................................................................................34 Passing control in a simple structure........................................................................................................ 34 Passing control without return.............................................................................................................35
Recommended publications
  • The Operating System Handbook Or, Fake Your Way Through Minis and Mainframes
    The Operating System Handbook or, Fake Your Way Through Minis and Mainframes by Bob DuCharme MVS Table of Contents Chapter 22 MVS: An Introduction.................................................................................... 22.1 Batch Jobs..................................................................................................................1 22.2 Interacting with MVS................................................................................................3 22.2.1 TSO.........................................................................................................................3 22.2.2 ISPF........................................................................................................................3 22.2.3 CICS........................................................................................................................4 22.2.4 Other MVS Components.........................................................................................4 22.3 History........................................................................................................................5 Chapter 23 Getting Started with MVS............................................................................... 23.1 Starting Up.................................................................................................................6 23.1.1 VTAM.....................................................................................................................6 23.1.2 Logging On.............................................................................................................6
    [Show full text]
  • High Level Assembler Macro Facility
    A++: Using the World's Most Powerful Macro Facility With High Level Assembler Parts 1 and 2 SHARE 119, Anaheim CA, Summer 2012 Presented by Tom Wasik, IBM [email protected] Contents prepared by John R. Ehrman [email protected] International Business Machines Corporation Silicon Valley Laboratory 555 Bailey Avenue San Jose, California 95141 USA Synopsis: This tutorial introduces the powerful concepts of conditional assembly supported by the High Level Assembler for z/OS, z/VM, & z/VSE, and provides examples of its use in both “open code” and in macro instructions. The examples in this document are for purposes of illustration only, and no warranty of correctness or applicability is implied or expressed. Permission is granted to SHARE Incorporated to publish this material in the proceedings of the SHARE 119. IBM retains the right to publish this material elsewhere. © Copyright IBM Corporation 1995, 2012. All rights reserved. Copyright Notices and Trademarks © Copyright IBM Corporation 1995, 2012. All rights reserved. Note to U.S. Government Users: Doc- umentation subject to restricted rights. Use, duplication, or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. The following terms, denoted by an asterisk (*) in this publication, are trademarks or registered trademarks of the International Business Machines Corporation in the United States and/or other countries: IBM System/370 System/390 zSeries z/OS z/VM z/VSE OS/390 DFSMS z/Architecture ESA Publications and Web Site The currently available product
    [Show full text]
  • PKZIP MVS User's Guide
    PKZIP for MVS MVS/ESA, OS/390, & z/OS User’s Guide PKMU-V5R5000 PKWARE, Inc. PKWARE, Inc. 9009 Springboro Pike Miamisburg, Ohio 45342 Sales: 937-847-2374 Support: 937-847-2687 Fax: 937-847-2375 Web Site: http://www.pkzip.com Sales - E-Mail: [email protected] Support - http://www.pkzip.com/support 5.5 Edition (2003) PKZIP for MVS™, PKZIP for OS/400™, PKZIP for VSE™, PKZIP for UNIX™, and PKZIP for Windows™ are just a few of the many members in the PKZIP® family. PKWARE, Inc. would like to thank all the individuals and companies -- including our customers, resellers, distributors, and technology partners -- who have helped make PKZIP® the industry standard for Trusted ZIP solutions. PKZIP® enables our customers to efficiently and securely transmit and store information across systems of all sizes, ranging from desktops to mainframes. This edition applies to the following PKWARE of Ohio, Inc. licensed program: PKZIP for MVS™ (Version 5, Release 5, 2003) PKZIP(R) is a registered trademark of PKWARE(R) Inc. Other product names mentioned in this manual may be a trademark or registered trademarks of their respective companies and are hereby acknowledged. Any reference to licensed programs or other material, belonging to any company, is not intended to state or imply that such programs or material are available or may be used. The copyright in this work is owned by PKWARE of Ohio, Inc., and the document is issued in confidence for the purpose only for which it is supplied. It must not be reproduced in whole or in part or used for tendering purposes except under an agreement or with the consent in writing of PKWARE of Ohio, Inc., and then only on condition that this notice is included in any such reproduction.
    [Show full text]
  • MIPS® Architecture for Programmers Volume I-B: Introduction to the Micromips32™ Architecture, Revision 5.03
    MIPS® Architecture For Programmers Volume I-B: Introduction to the microMIPS32™ Architecture Document Number: MD00741 Revision 5.03 Sept. 9, 2013 Unpublished rights (if any) reserved under the copyright laws of the United States of America and other countries. This document contains information that is proprietary to MIPS Tech, LLC, a Wave Computing company (“MIPS”) and MIPS’ affiliates as applicable. Any copying, reproducing, modifying or use of this information (in whole or in part) that is not expressly permitted in writing by MIPS or MIPS’ affiliates as applicable or an authorized third party is strictly prohibited. At a minimum, this information is protected under unfair competition and copyright laws. Violations thereof may result in criminal penalties and fines. Any document provided in source format (i.e., in a modifiable form such as in FrameMaker or Microsoft Word format) is subject to use and distribution restrictions that are independent of and supplemental to any and all confidentiality restrictions. UNDER NO CIRCUMSTANCES MAY A DOCUMENT PROVIDED IN SOURCE FORMAT BE DISTRIBUTED TO A THIRD PARTY IN SOURCE FORMAT WITHOUT THE EXPRESS WRITTEN PERMISSION OF MIPS (AND MIPS’ AFFILIATES AS APPLICABLE) reserve the right to change the information contained in this document to improve function, design or otherwise. MIPS and MIPS’ affiliates do not assume any liability arising out of the application or use of this information, or of any error or omission in such information. Any warranties, whether express, statutory, implied or otherwise, including but not limited to the implied warranties of merchantability or fitness for a particular purpose, are excluded. Except as expressly provided in any written license agreement from MIPS or an authorized third party, the furnishing of this document does not give recipient any license to any intellectual property rights, including any patent rights, that cover the information in this document.
    [Show full text]
  • Ibm High Level Assembler Manual Download Ibm High Level Assembler Manual
    Ibm High Level Assembler Manual Download Ibm High Level Assembler Manual This the first version of IBM Macro Assembler, released alongside the IBM PC. IBM Macro Assembler is an IBM OEM rebranded release of Microsoft Macro Assembler, and was intended only for use with the IBM PC. Installation instructions. This archive contains a 160k disk image, and is compatible with IBM PC-DOS 1.0 and later. IBM System-360 Operating System Assembler Languag§, Order Number GC28-6514. The Assembler Language manual contains the basic assembler and macro asserrbler specifications, except those unique to Assembler H. IEM System-360 Operating System Asserrbler H Language Specifications, Order Numter GC26- 3771. High Level Assembler Toolkit: HMQ4160: JMQ416A: SYS1: 5655-P97: Encryption Facility DFSMSdss Encryption: HCF773D: HCF773D: SYS1: 5655-P97: Encryption Facility Encrypt Ser: HCF7740: HCF7740: SYS1: 5655-SDK: IBM SDK for Node.Js - z-OS: HALU600: HALU600: SYS1: 5650-ZOS: ICKDSF - Device Support Facilities, Base: EDU1H01: EDU1H01: SYS1: 5650-ZOS: Environmental Record Editing and Printing: EER3500: EER3500 The next line seems to indicate to execute HLASM, the high level assembler, with the option to compile, load, and go – assemble the program and execute it. The next line indicates that the input will be from the lines of text following the JCL. The next line invokes the TITLE macro to place the title at the top of each printed page. See IBM-supplied default assembler options for a list of the changes to the IBM-supplied default assembler options from High Level Assembler Release 4. You specify the options at assembly time on: An external file (z-OS and CMS) or library member (z-VSE) The assembler programs are written in IBM Mainframe Assembler, they will compile using Assembler-H or HLASM.
    [Show full text]
  • Download for Z/OS
    Print Services Facility for z/OS Version 4, Release 6.0 Download for z/OS IBM S550-0429-05 Note Before using this information and the product it supports, read the information in “Notices” on page 83. This edition applies to the IBM® Print Services Facility™ Version 4 Release 6 Modification 0 for z/OS®, Program Number 5655-M32, and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces S550-0429-04. © Copyright International Business Machines Corporation 1995, 2017. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents List of Figures...................................................................................................... vii List of Tables........................................................................................................ ix About this publication...........................................................................................xi Who should read this publication............................................................................................................... xi How this publication is organized............................................................................................................... xi Understanding the syntax notation used in this publication......................................................................xi Related information....................................................................................................................................xii
    [Show full text]
  • High Level Assembler for Z/OS & Z/VM & Z/VSE
    High Level Assembler for z/OS & z/VM & z/VSE 1.6 Installation and Customization Guide IBM SC26-3494-05 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page 193. This edition applies to IBM High Level Assembler for z/OS & z/VM & z/VSE, Release 6, Program Number 5696-234 and to any subsequent releases until otherwise indicated in new editions. Make sure that you are using the correct edition for the level of the product. Order publications through your IBM® representative or the IBM branch office serving your locality. IBM welcomes your comments. For information on how to send comments, see “How to send your comments to IBM” on page xx. © Copyright International Business Machines Corporation 1992, 2021. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures................................................................................................................. xi Tables................................................................................................................ xiii About this document.......................................................................................... xvii Brief overview of High Level Assembler...................................................................................................xvii Who should use this document................................................................................................................xvii
    [Show full text]
  • Mysql Enterprise Monitor 2.0 Mysql Enterprise Monitor 2.0 Manual
    MySQL Enterprise Monitor 2.0 MySQL Enterprise Monitor 2.0 Manual Copyright © 2005, 2011, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
    [Show full text]
  • Airline Control System Version 2: General Information Manual Figures
    Airline Control System Version 2 IBM General Information Manual Release 4.1 GH19-6738-13 Airline Control System Version 2 IBM General Information Manual Release 4.1 GH19-6738-13 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page ix. This edition applies to Release 4, Modification Level 1, of Airline Control System Version 2, Program Number 5695-068, and to all subsequent releases and modifications until otherwise indicated in new editions. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address given below. A form for readers’ comments appears at the back of this publication. If the form has been removed, address your comments to: ALCS Development 2455 South Road P923 Poughkeepsie NY 12601-5400 USA When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corporation 2003, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures .................................... v Tables .................................... vii Notices .................................... ix Trademarks ................................... ix About this book ................................ xi Who should read this book .............................. xi Related publications ...............................
    [Show full text]
  • Enhance Your COBOL Applications with C-Treertg COBOL Edition
    COBOL Edition Enhance Your COBOL Applications with c-treeRTG COBOL Edition c-treeRTG COBOL Edition is a plug & play option that empowers COBOL applications by replacing the native file system of COBOL compilers with a more robust, comprehensive, solution. • FairCom's c-treeRTG COBOL Edition • Implementing RTG COBOL Edition modernizes record-oriented COBOL requires no changes to existing COBOL applications by providing a bridge code, no duplication of data, and no between COBOL and SQL standards, significant architectural changes. Existing thereby opening up their COBOL data to applications benefit from a new file system the web, cloud, and mobile devices. offering transaction processing, enhanced scalability, and recoverability while greatly • RTG COBOL Edition allows users to expanding data availability. leverage and preserve their investments in COBOL by integrating their existing • RTG COBOL Edition brings instant value COBOL applications with a modern and lowers risk by enabling users to database that preserves the performance immediately start a phasing migration and benefits of COBOL, while conforming project to a new COBOL platform instead to industry standards. of a "big bang," high risk, all-or-nothing conversion Seamless Solution for COBOL Applications This plug & play solution allows your COBOL applications to immediately benefit from the following: • Robust data management: c-treeRTG • User access: Control user access and COBOL Edition Server provides several high- permissions, view current connections, and availability features, such as full transaction see files that are being accessed by specific log, automatic recovery, and limited dynamic users to prevent ghost locks. dump for integrated backup capabilities. • Security: Natively implemented data • Full administrative tools set: Allows you to encryption ranges from simple masking to monitor, manage, configure, and fine-tune advanced encryption.
    [Show full text]
  • High Level Assembler for MVS & VM & VSE Programmer's Guide
    IBM High Level Assembler for MVS & VM & VSE Programmer’s Guide Release 5 SC26-4941-04 IBM High Level Assembler for MVS & VM & VSE Programmer’s Guide Release 5 SC26-4941-04 Note! Before using this information and the product it supports, be sure to read the general information under “Notices” on page 422. Fifth Edition (June 2004) This edition applies to IBM High Level Assembler for MVS & VM & VSE, Release 5, Program Number 5696-234 and to any subsequent releases until otherwise indicated in new editions. Make sure you are using the correct edition for the level of the product. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below. A form for reader's comments is provided at the back of this publication. If the form has been removed, address your comments to: IBM Corporation J87/D325 555 Bailey Avenue SAN JOSE, CA 95141-1003 United States of America When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1982, 2004. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Contents About this Manual .................................... xi Who Should Use this Manual .............................. xi Programming Interface Information ........................... xi Organization of this Manual ............................... xi IBM High Level Assembler for MVS & VM & VSE Publications .......... xiv Publications . xiv Softcopy Publications . xv The High Level Assembler web site ........................
    [Show full text]
  • MIPS32™ Architecture for Programmers Volume I: Introduction to the MIPS32™ Architecture
    MIPS32™ Architecture For Programmers Volume I: Introduction to the MIPS32™ Architecture Document Number: MD00082 Revision 0.95 March 12, 2001 MIPS Technologies, Inc. 1225 Charleston Road Mountain View, CA 94043-1353 Copyright © 2001 MIPS Technologies, Inc. All rights reserved. Unpublished rights reserved under the Copyright Laws of the United States of America. This document contains information that is proprietary to MIPS Technologies, Inc. (“MIPS Technologies”). Any copying, modifyingor use of this information (in whole or in part) which is not expressly permitted in writing by MIPS Technologies or a contractually-authorized third party is strictly prohibited. At a minimum, this information is protected under unfair competition laws and the expression of the information contained herein is protected under federal copyright laws. Violations thereof may result in criminal penalties and fines. MIPS Technologies or any contractually-authorized third party reserves the right to change the information contained in this document to improve function, design or otherwise. MIPS Technologies does not assume any liability arising out of the application or use of this information. Any license under patent rights or any other intellectual property rights owned by MIPS Technologies or third parties shall be conveyed by MIPS Technologies or any contractually-authorized third party in a separate license agreement between the parties. The information contained in this document constitutes one or more of the following: commercial computer software, commercial
    [Show full text]