Transcription
Front coverIBM z/OS V2R2:UNIX System ServicesKeith WinnardPaul Robert HeringRedbooks
International Technical Support OrganizationIBM z/OS V2R2: UNIX System ServicesDecember 2015SG24-8310-00
Note: Before using this information and the product it supports, read the information in “Notices” on page v.First Edition (December 2015)This edition applies to Version 2, Release 2, of IBM z/OS (5650-ZOS). Copyright International Business Machines Corporation 2015. All rights reserved.Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP ScheduleContract with IBM Corp.
ContentsNotices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viIBM Redbooks promotions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixAuthors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixNow you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xComments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiStay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiChapter 1. 64-bit z/OS UNIX stacks above the bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1.1 64-bit z/OS UNIX stacks above the bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1.1.1 New z/OS UNIX parmlib statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1.1.2 OMVS MODIFY and DISPLAY enhancements. . . . . . . . . . . . . . . . . . . . . . . . . . . .1.2 z/OS UNIX System Services scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1.2.1 Addressing PFS commands to zFS and TFS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1.2.2 Displaying OMVS storage information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1222335Chapter 2. z/OS UNIX Shell and Utilities man pages . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.1 New z/OS UNIX man pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2.1.1 Advantages of and search processing the new implementation . . . . . . . . . . . . . . .2.1.2 Examples of the use of new man command options. . . . . . . . . . . . . . . . . . . . . . . .7889Chapter 3. z/OS UNIX file system support in ISPF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.1 New functions for the ISPF option 3.17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123.2 Showing the new functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Chapter 4. Enhancements for the System z file system . . . . . . . . . . . . . . . . . . . . . . . .4.1 zFS 64-bit Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.1 zFS cache enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.2 Health check for zFS cache removals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.3 Statistics Storage Information API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.4 Running zFS within the OMVS address space . . . . . . . . . . . . . . . . . . . . . . . . . . .4.1.5 Specifying larger values with the 64-bit zFS support . . . . . . . . . . . . . . . . . . . . . .4.1.6 Migration and coexistence considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2 zFS enhanced and new functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.1 New 8-byte counter support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.2 New sysplex-related APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.3 z/OS UNIX command zfsadm fsinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.4 Displaying zfsadm fsinfo examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.5 New zFS API ZFSCALL FSINFO (0x40000013) . . . . . . . . . . . . . . . . . . . . . . . . .4.2.6 REXX example that uses the new ZFSCALL FSINFO API . . . . . . . . . . . . . . . . .4.2.7 FSINFO zFS Modify interface command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.2.8 Removing two zFS health checks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.3 Moving zFS into the OMVS address space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.3.1 Move preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4.3.2 Moving and running zFS commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1516161717181919202121222527282929292930Chapter 5. z/OS OpenSSH new functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Copyright IBM Corp. 2015. All rights reserved.iii
iv5.1 OpenSSH upgrade to 6.4p1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.2 Enhanced ICSF support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.3 Improved SMF support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.4 Support for the TSO OMVS shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.5 Relaxing the syntax of IdentityKeyRingLabels . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.6 Use of OpenSSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.7 Eliminating ssh-rand-helper function. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.8 SMF records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.9 Migration and coexistence considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.1.10 OpenSSH Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2 Examples for use of OpenSSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5.2.1 Verifying version and showing basic debug information . . . . . . . . . . . . . . . . . . . .5.2.2 Use of SFTP from TSO OMVS and a PuTTY session . . . . . . . . . . . . . . . . . . . . .5.2.3 Use of ISPFSFTP utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323232333333343636373738383939Chapter 6. z/OS UNIX Tools and Solutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1 Utility RXISHMT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1.1 Starting RXISHMT in TSO/ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1.2 Use of FILTER command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.1.3 Use of the FILTER command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.2 zFS zfsfsutl utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.2.1 The zfsfsutl tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.2.2 Use of the zfsfsutl utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3 ISPFSFTP utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.3.1 Use of the ISPFSFTP utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6.4 rxdowner utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4142424243434344454647Appendix A. Additional material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Locating the web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Using the web material. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Downloading and extracting the web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49494949Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Other publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5151515252IBM z/OS V2R2: UNIX System Services
NoticesThis information was developed for products and services offered in the U.S.A.IBM may not offer the products, services, or features discussed in this document in other countries. Consultyour local IBM representative for information on the products and services currently available in your area. Anyreference to an IBM product, program, or service is not intended to state or imply that only that IBM product,program, or service may be used. Any functionally equivalent product, program, or service that does notinfringe any IBM intellectual property right may be used instead. However, it is the user's responsibility toevaluate and verify the operation of any non-IBM product, program, or service.IBM may have patents or pending patent applications covering subject matter described in this document. Thefurnishing of this document does not grant you any license to these patents. You can send license inquiries, inwriting, to:IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785 U.S.A.The following paragraph does not apply to the United Kingdom or any other country where suchprovisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATIONPROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS ORIMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer ofexpress or implied warranties in certain transactions, therefore, this statement may not apply to you.This information could include technical inaccuracies or typographical errors. Changes are periodically madeto the information herein; these changes will be incorporated in new editions of the publication. IBM may makeimprovements and/or changes in the product(s) and/or the program(s) described in this publication at any timewithout notice.Any references in this information to non-IBM websites are provided for convenience only and do not in anymanner serve as an endorsement of those websites. The materials at those websites are not part of thematerials for this IBM product and use of those websites is at your own risk.IBM may use or distribute any of the information you supply in any way it believes appropriate without incurringany obligation to you.Any performance data contained herein was determined in a controlled environment. Therefore, the resultsobtained in other operating environments may vary significantly. Some measurements may have been madeon development-level systems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have been estimated throughextrapolation. Actual results may vary. Users of this document should verify the applicable data for theirspecific environment.Information concerning non-IBM products was obtained from the suppliers of those products, their publishedannouncements or other publicly available sources. IBM has not tested those products and cannot confirm theaccuracy of performance, compatibility or any other claims related to non-IBM products. Questions on thecapabilities of non-IBM products should be addressed to the suppliers of those products.This information contains examples of data and reports used in daily business operations. To illustrate themas completely as possible, the examples include the names of individuals, companies, brands, and products.All of these names are fictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.COPYRIGHT LICENSE:This information contains sample application programs in source language, which illustrate programmingtechniques on various operating platforms. You may copy, modify, and distribute these sample programs inany form without payment to IBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operating platform for which the sampleprograms are written. These examples have not been thoroughly tested under all conditions. IBM, therefore,cannot guarantee or imply reliability, serviceability, or function of these programs. Copyright IBM Corp. 2015. All rights reserved.v
TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business MachinesCorporation in the United States, other countries, or both. These and other IBM trademarked terms aremarked on their first occurrence in this information with the appropriate symbol ( or ), indicating USregistered or common law trademarks owned by IBM at the time this information was published. Suchtrademarks may also be registered or common law trademarks in other countries. A current list of IBMtrademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtmlThe following terms are trademarks of the International Business Machines Corporation in the United States,other countries, or both:BookManager IBM MVS OS/390 Redbooks Redbooks (logo)System z z/OS The following terms are trademarks of other companies:UNIX is a registered trademark of The Open Group in the United States and other countries.Other company, product, or service names may be trademarks or service marks of others.viIBM z/OS V2R2: UNIX System Services
IBM REDBOOKS PROMOTIONSIBM Redbooks promotionsFind and read thousands ofIBM Redbooks publicationsSearch, bookmark, save and organize favoritesGet up-to-the-minute Redbooks news and announcementsLink to the latest Redbooks blogs and videosDownloadNowAndroidiOSGet the latest version of the Redbooks Mobile AppPromote your businessin an IBM Redbookspublication Place a Sponsorship Promotion in an IBMRedbooks publication, featuring your businessor solution with a link to your web site. Qualified IBM Business Partners may place a full pagepromotion in the most popular Redbooks publications.Imagine the power of being seen by users who downloadmillions of Redbooks publications each year!ibm.com/RedbooksAbout RedbooksBusiness Partner Programs
THIS PAGE INTENTIONALLY LEFT BLANK
PrefaceThis IBM Redbooks publication familiarizes you with the technical changes that wereintroduced into the UNIX System Services areas with IBM z/OS V2R2.This book is one of a series of IBM Redbooks publications that take a modular approach toproviding information about the updates that are included within z/OS V2R2. This approachhas the following goals: Provide modular content Group the technical changes into a topic Provide a more streamlined way of finding relevant information that is based on the topicWe hope you find this approach useful. We value your feedback.AuthorsThis book was produced by a team of specialists from around the world working at theInternational Technical Support Organization, Poughkeepsie Center.Keith Winnard is the z/OS Project Leader at the International Technical SupportOrganization, Poughkeepsie Center. He writes extensively and is keen to engage withcustomers to understand what they want from IBM Redbooks publications. Before joining theITSO in 2014, Keith worked for clients and Business Partners in the UK and Europe in varioustechnical and account management roles. He is experienced with blending and integratingnew technologies into the traditional landscape of mainframes.Paul Robert Hering is an IT Specialist at the ITS Technical Support Center, Mainz, Germany.He provides support to clients with z/OS and z/OS UNIX related questions and problems. Heparticipated in several ITSO residencies since 1988, writing about UNIX related topics. Beforesupporting IBM OS/390 and z/OS, Robert worked for many years with the IBM VMoperating system and its variations (VM/370, VM/HPO, VM/XA, and VM/ESA).Thanks to the following people for their technical guidance contributions to this project:Sue Kimmel (IBM) for providing valuable advice and guidance throughout the creation of thisIBM Redbooks publication.Michael Cox (Advisory Programmer, UNIX Systems Services Development, PoughkeepsieCenter) for providing valuable advice and guidance throughout the creation of this IBMRedbooks publication.Lynne Delesky (Software Engineer, Shell and Utilities, Poughkeepsie Center) for providingvaluable advice and guidance throughout the creation of this IBM Redbooks publication.Lei Wang (IBM) for providing valuable advice and guidance throughout the creation of thisIBM Redbooks publication.Yi Ming (IBM) for providing valuable advice and guidance throughout the creation of this IBMRedbooks publication.Scott Marcotte (IBM) for providing valuable advice and guidance throughout the creation ofthis IBM Redbooks publication. Copyright IBM Corp. 2015. All rights reserved.ix
Michelle Li (IBM) for providing valuable advice and guidance throughout the creation of thisIBM Redbooks publication.Dennis Hewitt (IBM) for providing valuable advice and guidance throughout the creation ofthis IBM Redbooks publication.Charles T. Ware (Advisory Software Engineer, z/OS Level 2 service, Poughkeepsie Center)for providing valuable advice and guidance throughout the creation of this IBM Redbookspublication.Thanks to the following people for their environment and residency support contributions tothis project:Bob Haimowitz (Development Support Team [DST], Poughkeepsie Center) for setting upand maintaining the systems, and providing valuable advice, guidance, and assistancethroughout the creation of this IBM Redbooks publication.Rich Conway (DST, Poughkeepsie Center) for setting up and maintaining the systems, andproviding valuable advice, guidance, and assistance throughout the creation of this IBMRedbooks publication.Peter Bertolozzi (Systems Management specialist, IBM Redbooks residency support,Poughkeepsie Center) for setting up and maintaining the environments within syslab in whichresidents worked.John Gierloff (Operations, Poughkeepsie Center) for residency set up and support.Don Brennan (DST, Poughkeepsie Center) for setting up and maintaining the systemshardware that was used in the creation of this IBM Redbooks publication.Ella Buslovich (Graphics specialist, location) for providing guidance and specialist graphicsfor this IBM Redbooks publication.Ann Lund (ITSO Administration, Poughkeepsie Center) for administrative support to enablethe residency.Cheryl Gera (ITSO Administration, Poughkeepsie Center) for managing the businessoperations for this IBM Redbooks publication.Now you can become a published author, too!Here’s an opportunity to spotlight your skills, grow your career, and become a publishedauthor—all at the same time! Join an ITSO residency project and help write a book in yourarea of expertise, while honing your experience by using leading-edge technologies. Yourefforts help to increase product acceptance and customer satisfaction as you expand yournetwork of technical contacts and relationships. Residencies run 2 - 6 weeks in length andyou can participate in person or as a remote resident working from your home base.Find out more about the residency program, browse the residency index, and apply online atthis website:ibm.com/redbooks/residencies.htmlxIBM z/OS V2R2: UNIX System Services
Comments welcomeYour comments are important to us!We want our books to be as helpful as possible. Send us your comments about this book orother IBM Redbooks publications in one of the following ways: Use the online Contact us review Redbooks form found at:ibm.com/redbooks Send your comments in an email to:redbooks@us.ibm.com Mail your comments to:IBM Corporation, International Technical Support OrganizationDept. HYTD Mail Station P0992455 South RoadPoughkeepsie, NY 12601-5400Stay connected to IBM Redbooks Find us on Facebook:http://www.facebook.com/IBMRedbooks Follow us on Twitter:http://twitter.com/ibmredbooks Look for us on LinkedIn:http://www.linkedin.com/groups?home &gid 2130806 Explore new Redbooks publications, residencies, and workshops with the IBM Redbooksweekly sf/subscribe?OpenForm Stay current on recent Redbooks publications with RSS i
xiiIBM z/OS V2R2: UNIX System Services
1Chapter 1.64-bit z/OS UNIX stacks abovethe barz/OS UNIX System Services (z/OS UNIX) is the IBM UNIX implementation in the z/OSoperating system.This chapter describes the new 64-bit support for z/OS UNIX stacks above the bar in z/OSVersion 2 Release 2 and includes the following topics: 1.1, “64-bit z/OS UNIX stacks above the bar” on page 2 1.2, “z/OS UNIX System Services scenarios” on page 3 Copyright IBM Corp. 2015. All rights reserved.1
1.1 64-bit z/OS UNIX stacks above the barThe increasing demand for threads resulted in the capacity approaching maximum limits ofthe kernel that are below the bar storage. Changes with IBM z/OS V2R2 introduced new64-bit support; the following possibilities are available: Internal dynamic stacks can be moved above the bar. The thread capacity is increased.1.1.1 New z/OS UNIX parmlib statementThere is a new BPXPRMxx parmlib statement that specifies whether to allocate kernel stacksfrom above or below bar storage, as shown in Example 1-1.Example 1-1 New BPXPRMxx parmlib statementKERNELSTACKS(ABOVE BELOW)The two values have the following meaning: ABOVEAll kernel stacks are allocated above the bar, which increases the thread limit to amaximum of 500,000. BELOWAll kernel stacks are allocated below the bar, which is the default setting.Note: As you plan your systems, consider the following points: The value of KERNELSTACKS cannot be changed dynamically. Any changes in KERNELSTACKS in the BPXPRMxx member do not take effect until thenext initial program load (IPL).1.1.2 OMVS MODIFY and DISPLAY enhancementsThere are two new interface controls or output changes that are introduced with z/OS V2R2.MODIFY OMVS command enhancementThere is a new interface to send Physical File System (PFS) specific commands to a PFSindependent of whether the PFS is within the OMVS address space or outside in a colonyaddress space, as shown in Example 1-2.Example 1-2 Passing a MODIFY command string to a PFS through a z/OS UNIX LFS interfaceF OMVS,PFS pfsname,command stringThe parameters feature the following meanings: pfsnameThe name of the PFS that receives the command. command-stringThe command string to be passed from the Logical File System (LFS) to the PFS.2IBM z/OS V2R2: UNIX System Services
Important: This new interface is needed by a 64-bit zFS when it runs in the OMVSaddress space because the MODIFY ZFS commands no longer work.OMVS storage display output enhancementIf KERNELSTACKS(ABOVE) is specified in the BPXPRMxx parmlib member, the output ofcommand D OMVS,STORAGE shows thread information instead of stack cell information.Note: This difference in displays below and above the line are shown in Figure 1-7 onpage 5 and Figure 1-8 on page 5.1.2 z/OS UNIX System Services scenariosThe command enhancements can be used in different environment set ups.1.2.1 Addressing PFS commands to zFS and TFSAs shown in Example 1-3, zFS and TFS feature their own address space outside OMVS.Example 1-3 Displays showing zFS and TFS are in a colony address space cn "d omvs,p" grep TFSTFSBPXTFSTFSLOCALA2015/07/15 15.15.21TFSGLOBAL SETTINGS: fsfull(99,5) ea 0 em 0 cn "d omvs,p" grep ZFSZFSIOEFSCMZFSLOCALA2015/07/15 15.15.20ZFSPRM (74,00)Note: The UNIX command cn is a tool to allow IBM MVS system commands to beissued and to receive the output to STDOUT in your shell.For more information, see IBM z/OS Version 2 Release 1 Technical Updates,SG24-8140-00, which is available at this 40/zFS MODIFY commands when zFS is in a colony address spaceExample 1-4 shows how to use the two methods that are available to address MODIFYcommands to zFS when zFS is running in its own address space outside OMVS because itwas introduced.Example 1-4 Running zFS modify commands directly and via the new F OMVS,PFS interface cn "f zfs,query,level"IOEZ00639I zFS kernel: z/OSzFSVersion 02.02.00 Service Level OA47906 - HZFS420.Created on Fri May 29 11:49:19 EDT 2015.sysplex(filesys,rwshare) interface(4)IOEZ00025I zFS kernel: MODIFY command - QUERY,LEVEL completed successfully. cn "f omvs,pfs zfs,query,level"IOEZ00639I zFS kernel: z/OSzFSVersion 02.02.00 Service Level OA47906 - HZFS420.Chapter 1. 64-bit z/OS UNIX stacks above the bar3
Created on Fri May 29 11:49:19 EDT 2015.sysplex(filesys,rwshare) interface(4)IOEZ00025I zFS kernel: MODIFY command - QUERY,LEVEL completed successfully.TFS MODIFY commands when TFS is in a colony address spaceExample 1-5 shows how to use the two ways of addressing MODIFY commands to TemporaryFile System (TFS) when TFS is running in its own address space outside OMVS.Example 1-5 Running TFS modify commands directly and via the new F OMVS,PFS interface cn "f tfs,q" grep "GLOBAL SETTINGS"BPXTF012I GLOBAL SETTINGS: fsfull(99,5) cn "f omvs,pfs tfs,fsfull(80,5)"BPXTF012I GLOBAL SETTINGS: fsfull(80,5) cn "f tfs,ea 10"BPXTF012I GLOBAL SETTINGS: fsfull(80,5) cn "f omvs,pfs tfs,em 5"BPXTF012I GLOBAL SETTINGS: fsfull(80,5)ea 0 em 0ea 0 em 0ea 10 em 0ea 10 em 5TFS MODIFY commands when the TFS PFS is within OMVSExample 1-6 shows the difference when the PFS is not running in its own address space asthe MODIFY interface is not available.Attention: Changing a TFS to be within OMVS is not meant as a suggestion. It is done fordemonstration purposes only. We still suggest running a TFS in a colony address space.However, you can move a TFS into OMVS in addition to HFS and zFS.Example 1-6 For a TFS within OMVS MODIFY commands only work via F OMVS,PFS cat "//'SYS1.PARMLIB(BPXPRMTF)'"FILESYSTYPE TYPE(TFSO)ENTRYPOINT(BPXTFS)PARM('-fsfull(80,5) -ea 1 -em 1') cn "set omvs (tf)"BPXO032I THE SET OMVS COMMAND WAS SUCCESSFUL. cn "d omvs,p" grep TFSOTFSOBPXTFSTFSO-fsfull(80,5) -ea 1 -em 1TFSOGLOBAL SETTINGS: fsfull(80,5) ea 1 em 1 cn "f tfso,ea 0"IEE341I TFSONOT ACTIVE cn "f omvs,pfs tfso,ea 0"BPXTF012I GLOBAL SETTINGS: fsfull(80,5) ea 0 em 1Because the MODIFY OMVS interface always works for addressing commands to zFS andTFS, the following tip is suggested.Tip: If you switch to always use F OMVS,PFS , this change is independent of the locationof the PFS and helps reduce potential errors.4IBM z/OS V2R2: UNIX System Services
1.2.2 Displaying OMVS storage informationExample 1-7 and Example 1-8 shows how the output of the D OMVS,STORAGE command differsdepending on the BPXPRMxx setting of KERNELSTACKS.In Example 1-7, KERNELSTACKS is set to BELOW, which is the default and works as it did before.Example 1-7 Displaying OMVS storage information if KERNELSTACKS is set to BELOW cn "d omvs,o" grep KERNELSTACKSKERNELSTACKS BELOW cn "d omvs,storage"BPXO075I 20.44.51 DISPLAY OMVS 395OMVS0011 ACTIVEOMVS (2A)KERNEL STORAGE USAGEPRIVATE STORAGE:CURRENT USAGEMAXIMUM AVAILABLEHIGH WATERREGION SIZE59740158363046502597483501830789120STACK CELLS:CURRENT USAGEMAXIMUM CELLSHIGH WATER363545346PROCESS STACK CELL USAGEUSERJOBNAME ASIDPIDPPID STATETHREADS STACKSNO PROCESSES FOUND USING 50 OR MORE SPACE SWITCHED STACK CELLS.In Example 1-8, KERNELSTACKS is set to value ABOVE.Example 1-8 Displaying OMVS storage information if KERNELSTACKS is set to ABOVE cn "d omvs,o" grep KERNELSTACKSKERNELSTACKS ABOVE cn "d omvs,storage"BPXO075I 13.01.46 DISPLAY OMVS 919OMVS0011 ACTIVEOMVS (74,2A)KERNEL STORAGE USAGEPRIVATE STORAGE:CURRENT USAGEMAXIMUM AVAILABLEHIGH WATER1474519041815228416163024896THREADS:CURRENT USAGEMAXIMUM THREADSHIGH WATER87500000108PROCESS THREAD USAGEUSERJOBNAME ASIDPIDPPID STATENO PROCESSES FOUND USING 50 OR MORE THREADSREGION SIZE1830789120THREADSChapter 1. 64-bit z/OS UNIX stacks above the bar5
6IBM z/OS V2R2: UNIX System Services
2Chapter 2.z/OS UNIX Shell and Utilities manpagesThe z/OS UNIX Shell and Utilities is the complementary part in z/OS to communicate with theIBM UNIX implementation.This chapter introduces the features and benefits of the new z/OS UNIX man pages. Copyright IB
introduced into the UNIX System Services areas with IBM z/OS V2R2. This book is one of a series of IBM Redbooks publications that take a modular approach to providing information about the updates that are included within z/OS V2R2. This approach has the following goals: Provide modular content Group the technical changes into a topic
