DOCSLIB.ORG

DFSMS Object Access Method Applicationprogrammer's Reference

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
DFSMS Object Access Method Applicationprogrammer's Reference z/OS Version 2 Release 3 DFSMS Object Access Method Application Programmer’s Reference IBM SC23-6865-30 Note Before using this information and the product it supports, read the information in “Notices” on page 97. 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-06-24 © Copyright International Business Machines Corporation 1986, 2019. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures.................................................................................................................. v Tables................................................................................................................. vii About this book.................................................................................................... ix Major divisions of this book.........................................................................................................................ix Required product knowledge......................................................................................................................ix z/OS information...........................................................................................................................................x How to read syntax diagrams.......................................................................................................................x How to send your comments to IBM.....................................................................xiii If you have a technical problem................................................................................................................xiii Summary of changes............................................................................................xv Summary of changes for z/OS Version 2 Release 3 (V2R3)...................................................................... xv Summary of changes for z/OS Version 2 Release 2 (V2R2)..................................................................... xvi Summary of changes for z/OS Version 2 Release 1 (V2R1)..................................................................... xvi Chapter 1. Understanding the Object Access Method.............................................. 1 Understanding OAM components................................................................................................................2 Establishing a storage management policy.................................................................................................2 Understanding the OAM application programming interface..................................................................... 3 Choosing data types that work well with OAM...................................................................................... 4 Retrieving a partial object...................................................................................................................... 5 Coordinating DB2, OAM, and your application...................................................................................... 5 Coordinating your application with OAM’s object identification........................................................... 5 Overriding management policy defaults................................................................................................6 Separating objects..................................................................................................................................6 Deleting objects......................................................................................................................................6 Chapter 2. Application program interface for OAM.................................................. 7 Using the OSREQ macro...............................................................................................................................7 What you can do with OSREQ.................................................................................................................7 Choosing the form.................................................................................................................................. 8 Getting the code right.............................................................................................................................8 Implementing the functions........................................................................................................................ 9 ACCESS—Initializing the OSREQ interface...........................................................................................10 CHANGE—Changing an object's management characteristics........................................................... 11 DELETE—Deleting an existing object................................................................................................... 14 QUERY—Obtaining object characteristics............................................................................................15 RETRIEVE—Retrieving an existing object............................................................................................ 18 Adding objects to the object storage hierarchy...................................................................................21 STORE function.....................................................................................................................................22 STOREBEG—Beginning a Store Sequence operation.......................................................................... 26 STOREPRT—Storing an individual part in a Store Sequence operation.............................................. 29 STOREEND—Ending a Store Sequence operation............................................................................... 31 UNACCESS—Ending the OSREQ interface........................................................................................... 33 OSREQ keyword parameter descriptions..................................................................................................33 Usage considerations.................................................................................................................................43 iii Usage requirements...................................................................................................................................44 Restrictions and limitations.......................................................................................................................44 Programming notes....................................................................................................................................45 Register use..........................................................................................................................................46 Expiration date processing........................................................................................................................ 46 Messages and codes..................................................................................................................................47 OAM return codes and reason codes...................................................................................................48 DB2 SQL error reason codes................................................................................................................ 48 CBRIBUFL macro....................................................................................................................................... 48 CBRIQEL macro......................................................................................................................................... 51 Appendix A. Sample program for object storage................................................... 57 CBROSREQ................................................................................................................................................. 57 CBROSR2....................................................................................................................................................65 CBROSR3....................................................................................................................................................73 Appendix B. Performance considerations and object data reblocking.................... 83 Performance considerations..................................................................................................................... 83 Object data reblocking......................................................................................................................... 83 Object storage...................................................................................................................................... 83 Object retrieval..................................................................................................................................... 84 Appendix C. Using the CBRUXSAE installation exit................................................85 Register contents on entry to CBRUXSAE................................................................................................. 86 Programming the CBRUXSAE exit correctly..............................................................................................87 Sample CBRUXSAE installation exit.........................................................................................................
Load more

Recommended publications
  • IBM System/360 Operating System Sequential Access Methods Program Logic Manual
    Y28-6604-1 Program Logic IBM System/360 Operating System Sequential Access Methods Program Number 3S0S-DM-50B This publication describes the internal logic of the routines of the queued sequen­ tial access method, the basic sequential access method, and the basic partitioned access method of IBM System/360 Operating System. Program Logic Manuals are intended for use by IBM customer engineers involved in program maintenance, and by system pro­ grammers involved in altering the program design. Program logic information is not necessary for program operation and use; therefore, distribution of this manual is limited to persons with program maintenance or modification responsibilities. Restricted Distribution PREFACE This publication describes the sequen­ • Buffer pool management routines that tial access method facilities in IBM Oper­ furnish buffer space in main storage. ating System/360. It describes routines in five categories: PREREQUISITE PUBLICATIONS • Queued sequential access method rou­ tines that cause storage and retrieval Knowledge of the information in the of data records arranged in sequential following publications is required for an order .• understanding of this publication: • Basic sequential access method routines IBM system/360 Operating System: Data that cause storage and retrieval of Management, Form C28-6537 data blocks arranged in sequential order. IB,M Systerol360 Operating System: Intro­ duction to Control Program Logic. Pro­ • Basic partitioned access method rou­ gram Logic Manual, Form Y28-6605 tines that cause storage and retrieval of data blocks in a member of a parti­ tioned data set, and construct entries and search for entries in the directory RECOMMENDED READING of a partitioned data set. The publication IBM System/360 Operating • Executors that operate with System: Control Program SerVices, Form input/output supp~rt routines.
    [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]
  • IBM Mainframe Utility Programs ­ Wikipedia, the Free Encyclopedia IBM Mainframe Utility Programs from Wikipedia, the Free Encyclopedia
    9/11/2015 IBM mainframe utility programs ­ Wikipedia, the free encyclopedia IBM mainframe utility programs From Wikipedia, the free encyclopedia IBM mainframe utility programs are Utility software supplied with IBM mainframe operating systems such as MVS to carry out various tasks associated with datasets, etc. The following list describes utilities distributed with OS/360 and successors. No VSE or VM utilities are included. Contents 1 History/Common JCL 2 Dataset utilities 2.1 IDCAMS 2.2 IEBCOMPR 2.3 IEBCOPY 2.4 IEBDG 2.5 IEBEDIT 2.6 IEBGENER 2.7 IEBIMAGE 2.8 IEBISAM 2.9 IEBPTPCH 2.10 IEBUPDTE 3 Scheduler utilities 3.1 IEFBR14 4 System utilities 4.1 ICKDSF 4.2 IEHDASDR 4.3 IEHINITT 4.4 IEHLIST 4.5 IEHMOVE 4.6 IEHPROGM 5 Supporting programs 5.1 SORT 5.2 Compilers/Linker 5.3 DFSMS 6 References 7 See also 8 External links History/Common JCL Many of these utilities were designed by IBM users, through the group SHARE, and then modified or extended by IBM from versions originally written by a user. https://en.wikipedia.org/wiki/IBM_mainframe_utility_programs 1/14 9/11/2015 IBM mainframe utility programs ­ Wikipedia, the free encyclopedia These utilities are usually invoked via Job Control Language (JCL). They tend to use common JCL DD identifiers for their data sets: DDNAME Usual function input file for the 'commands' for the utility. Often set to DUMMY if the default action is SYSIN desired SYSUT1 input file SYSUT2 output file SYSUT3 work (spill) file for input (SYSUT1) (often not used) SYSUT4 work (spill) file for output (SYSUT2) (often not used) SYSPRINT output file for printed output from the utility SYSOUT output file for messages from the utility SYSUDUMP output file for a system 'dump' if the program fails Dataset utilities IDCAMS IDCAMS ("Access Method Services") generates and modifies Virtual Storage Access Method (VSAM) and Non­VSAM datasets.
    [Show full text]
  • Systems Introduction to OS/VS2 Release 2 First Edition (March, 1973)
    GC28-0661-1 File No. S370-34 Systems Introduction to OS/VS2 Release 2 First Edition (March, 1973) This edition is a reprint of GC28-0661{) incorporating some editorial changes. It does not obsolete GC28-0661-O. This edition applies to Release 2 of OS/VS2 and to all subsequent releases until otherwise indicated in new editions or Technical Newsletters. Changes are continually made to the information herein; before using this publication in connection with the operation of IBM systems, consult the latest IBM System/360 and System/370 Bibliography, Order No. GA22-6822, and the current SRL Newsletter. Order No. GN20-0360, for the editions that are applicable and current. Requests for copies of IBM publications should be made to your IBM representative or to the IBM branch office serving your locality. A form for readers' comments is provided at the back of this pUblication. If the form has been removed, comments may be addressed to IBM Corporation, Publications Development, iJepartment 058, Building 706-2, PO Box 390, Poughkeepsie, N.Y. 12602. Comments and suggestions become the property of IBM. © Copyright International Business Machines Corporation 1973 Preface This publication contains introductory information Design Concepts -- shows sequence of operation and about OS/VS2 Release 2, a system control other highlights of system design. program (SCP) that features virtual storage, System Requirements -- lists the basic hardware multiprogramming, multiprocessing, time sharing, requirements. and job entry subsystems. It is assumed that readers have a basic knowledge of programming Compatibility -- points out the major differences systems such as OS/MVT or OS/VS2 Release 1.
    [Show full text]
  • Computer Labs for the Introduction to the New Mainframe: Z/OS Basics
    Computer Labs for the Introduction to the New Mainframe: z/OS Basics course Instructor Version The following labs are from the Introduction to the New Mainframe: z/OS Basics course/Redbook. These labs have been run and tested using the computer hub at Marist College in Poughkeepise, NY. You may need to adjust these labs to run on a computer system other than the one at Marist College. Chapter 2 Exercises (Section 2.16) ........................................................................................ 4 To display the CPU configuration ...................................................................................... 4 To display the page data set usage ..................................................................................... 4 To display information about the current Initial Program Load (IPL) ............................... 4 Instructor Notes .................................................................................................................. 4 Chapter 4 Exercises (Section 4.7) .......................................................................................... 5 4.7.1 Logging on to z/OS and entering TSO commands ................................................... 5 4.7.2 Navigating through the ISPF menu options .............................................................. 5 4.7.3 Using the ISPF editor ................................................................................................ 6 4.7.4 Using SDSF ..............................................................................................................
    [Show full text]
  • State of Florida Department of Children and Families Access Florida System Technical Architecture Overview Itn
    STATE OF FLORIDA DEPARTMENT OF CHILDREN AND FAMILIES ACCESS FLORIDA SYSTEM TECHNICAL ARCHITECTURE OVERVIEW ITN# - 03F12GC1 JUNE 1, 2012 STATE OF FLORIDA – DEPARTMENT OF CHILDREN AND FAMILIES June 1, 2012 Table of Contents 1.0 Background and Organization Overview .......................................................................................... 1 1.1 Background ................................................................................................................................... 1 1.2 Program of Service Specific Terms ................................................................................................ 3 1.3 ACCESS Florida IT Organization and Activity Overview................................................................. 6 1.4 Northwood Shared Resource Center ............................................................................................ 7 2.0 Technical Overview ........................................................................................................................... 8 2.1 Application Frameworks ............................................................................................................... 8 2.2 Databases Types ........................................................................................................................... 9 2.3 Data Access Technologies ........................................................................................................... 10 2.4 Data Security ..............................................................................................................................
    [Show full text]
  • VSAM Demystified
    Front cover VSAM Demystified Learn the latest VSAM functions and manage VSAM data Understand, evaluate, and use VSAM properly Learn problem determination and recommendations Mary Lovelace Jose Dovidauskas Alvaro Salla Valeria Sokal ibm.com/redbooks International Technical Support Organization VSAM Demystified March 2013 SG24-6105-02 Note: Before using this information and the product it supports, read the information in “Notices” on page xi. Third Edition (March 2013) This edition applies to z/OS Version 1 Release 13 DFSMS (product number 5694-A01). © Copyright International Business Machines Corporation 2001, 2012, 2013. 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 . xi Trademarks . xii Preface . xiii The team who wrote this book . xiii Now you can become a published author, too! . xiv Comments welcome. xiv Stay connected to IBM Redbooks . xiv Summary of changes. xvii March 2013, Third Edition . xvii Chapter 1. VSAM basics . 1 1.1 VSAM functions by release level. 2 1.2 What is VSAM? . 4 1.2.1 What is an access method? . 4 1.2.2 VSAM access types . 4 1.3 VSAM functions. 5 1.3.1 Catalog management . 5 1.3.2 Record management . 5 1.4 VSAM terminology and concepts . 5 1.4.1 Logical record . 5 1.4.2 Physical record . 8 1.4.3 Control interval . 10 1.4.4 Spanned records. 11 1.4.5 Control area . 12 1.4.6 Components . 13 1.4.7 Clusters. 15 1.4.8 Alternate indexes .
    [Show full text]
  • Software Guide the Computer with Growth Potential
    February 1980 Volume 3 Issue 2 NEW: Professional software guide The computer with growth potential The System Three is Cromemco's best selling small business computer. It's easy to see why. Not only is it ideal for the first time computer user. But perhaps more important, it can be expanded into a comprehensive business facility servicing many varied company requirements. Single -user system You can start small. A 64K computer with a megabyte of floppy disc storage costs under £4,000.* Perhaps your initial reason for choosing Cromemco was its flexible database management system-ideal for client records, order processing, sales analysis, inventory control, and many more business uses; or you might have required the full screen word processing system, capable of printing up to 20 original letters an hour; possibly you needed Cobol, Basic or Fortran to develop your own customised packages. Single -user System Three, with 64K memory, 2 discs, terminal and printer. Easy to use Ideal for small businesses. Whatever the reason, you were highly impressed with the ease with which your Will it expand? Multi-user system very first computer application got off the It was then you discovered that the Fortunately, we can readily expand your ground. So you added another. And terminal is the limiting factor, because ofCromemco. Unlike other makers' systems, another. And pretty soon quite a lot of the time taken to input data. If only you all we need to do is add some memory and a company business was running on your could connect a second terminal you ®TU-ART interface, and the multi-user Cromemco.
    [Show full text]
  • 16Th, Las Vegas, Nevada, June 12-17, 1993)
    DOCUMENT RESUME ED 431 280 EC 307 264 AUTHOR Binion, Mary, Ed. TITLE Engineering the ADA from Vision to Reality with Technology (16th, Las Vegas, Nevada, June 12-17, 1993). Volume 13. INSTITUTION RESNA: Association for the Advancement of Rehabilitation Technology, Washington, DC. ISBN ISBN-0-932101-33-X ISSN ISSN-0883-4741 , PUB DATE 1993-06-17 NOTE 583p. PUB TYPE Collected Works Proceedings (021) EDRS PRICE MF03/PC24 Plus Postage. DESCRIPTORS Adults; Appropriate Technology; *Assistive Devic.3s (for Disabled); *Augmentative and Alternative Communication; *Computer Uses in Education; Delivery Systems; *Disabilities; *Educational Technology; Elementary Secondary Education; Employment; Federal Legislation; Gerontology; Learning Disabilities; Mobility Aids; Older Adults; Public Policy; Rehabilitation Programs; Robotics; Severe Disabilities; Special Education; Teacher Education; Transitional Programs; Transportation IDENTIFIERS Americans with Disabilities Act 1990 ABSTRACT This compilation of presentations from RESNA's conference proceedings focused on the progress and potential of assistive and rehabilitation technology for individuals with disabilities and ways that RESNA members could help these ideas to be realized. Papers were presented on the following topics:(1) service delivery and public policy issues; (2) personal transportation;(3) augmentative and alternative communication; (4) droolin:7; (5) quantitative assessment;(6) special education, including computer applications for students with learningdisabilities, wearable computers
    [Show full text]
  • Systems OS/VS Virtual Storage Access Method (VSAM) Planning Guide
    GC26-3799-0 OS/VS Virtual Storage Access Method (VSAM) Systems Planning Guide First Edition (July 1972) This edition applies to release 2 of OS/VS1, to release 1 of OS/VS2, and to all subsequent releases until otherwise indicated in new editions or technical newsletters. Changes may be made to the information in this publication at any time; before using this publication in connection with the operation of IBM systems, consult the System/360 and System/370 Bibliography~ GA22-6822, and the latest System/360 and System/3 70 SRL Newsletter~ GN20-0360, for the editions that are applicable and current. Requests for copies of IBM publications should be made to your IBM representative or to the IBM branch office serving your locality. Forms for readers' comments are provided at the back of this publication. If the forms have been removed, comments may be addressed to IBM Corporation, Programming Publications, Department D78, Monterey and Cottle Roads, San Jose, California 95114. Comments become the property of IBM. © Copyright International Business Machines Corporation 1972 USING THIS PUBLICATION This publication is intended to enable prospective users of VSAM (virtual storage access method), an access method of OS/VS (operating system/virtual storage), to prepare for using VSAM. The intended audience is data-processing managers whose decisions will influence the use of VSAM, system and application programmers who will make detailed preparations, and others seeking an introduction to VSAM. This planning guide has six chapters: "Introducing VSAM" outlines how VSAM meets the requirements of an access method in today's data-processing environment.
    [Show full text]
  • DFSMS Basics: Data Set Fundamentals Get to Know Your Data Sets!
    DFSMS Basics: Data Set Fundamentals Get to Know Your Data Sets! Neal Bohling and Tom Reed DFSMS Defect Support @ IBM August 7, 2014 Session Number 16119 What'sWhat's youryour experienceexperience level?level? IBM 7094 1965 ~500KHz Background To fully understand z/OS Data Sets, let's look at how data is stored Tape Disk (Sequential) (Direct) DASD Structure ModernModern Devices Devices are are Modeled Modeled after after this this architecture: architecture: 1 1 Track Track = = 56664 56664 Bytes Bytes 1 1 Cylinder Cylinder = = 15 15 Tracks Tracks Data Sets • Volumes provide a stream of data. 1100100111000010110101001100100111100010111000111100100011000101110000101100010111100010111000111100001111010110110101001 1010111111001001110001111001001110101011100011111000011110101101101010011010111110000011101010111101000110010011100001011 0101001100100111100010111000111100100011000101110000101100010111100010111000111100001111010110110101001101011111100100111 0001111001001110101011100011111000011110101101101010011010111110000011101010111101000110010011100001011010100110010011110 0010111000111100100011000101110000101100010111100010111000111100001111010110110101001101011111100100111000111100100111010 1011100011111000011110101101101010011010111110000011101010111101000110010011100001011010100110010011110001011100011110010 0011000101110000101100010111100010111000111100001111010110110101001101011111100100111000111100100111010101110001111100001 1110101101101010011010111110000011101010111101000110010011100001011010100110010011110001011100011110010001100010111000010
    [Show full text]
  • Introduction to the New Mainframe: Z/OS Basics
    Front cover Introduction to the New Mainframe z/OS Basics Basic mainframe concepts, including usage and architecture z/OS fundamentals for students and beginners Mainframe hardware and peripheral devices Mike Ebbers John Kettner Wayne O’Brien Bill Ogden ibm.com/redbooks International Technical Support Organization Introduction to the New Mainframe: z/OS Basics March 2011 SG24-6366-02 Note: Before using this information and the product it supports, read the information in “Notices” on page xi. Third Edition (March 2011) © Copyright International Business Machines Corporation 2006, 2009, 2011. 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 . xi Trademarks . xii Preface . xiii How this text is organized . xiv How each chapter is organized . xiv The team who wrote this book . xv Acknowledgements . xvi Now you can become a published author, too! . xix Comments welcome. xix Stay connected to IBM Redbooks . xix Summary of changes . xxi March 2011, Third Edition . xxi August 2009, Second Edition . xxi Part 1. Introduction to z/OS and the mainframe environment Chapter 1. Introduction to the new mainframe . 3 1.1 The new mainframe. 4 1.2 The System/360: A turning point in mainframe history . 4 1.3 An evolving architecture . 5 1.4 Mainframes in our midst . 8 1.5 What is a mainframe . 9 1.6 Who uses mainframe computers. 12 1.7 Factors contributing to mainframe use . 15 1.8 Typical mainframe workloads . 22 1.9 Roles in the mainframe world . 29 1.10 z/OS and other mainframe operating systems .
    [Show full text]