z Exchange CSVFETCH exit in z/os V2R2

Transcription

1 z Exchange CSVFETCH exit in z/os V2R2 Peter Reson, z/os Core Technoogy Design IBM z Systems, Poughkeepsie NY USA Friday, March 18, 2016

2 Trademarks The foowing are trademarks of the Internationa Business Machines Corporation in the United States and/or other countries. CICS* DFSMShsm FashCopy* IBM ogo* RACF* CICS Exporer DFSMSrmm GDPS* Infoprint* REXX RMF DB2* DFSORT HiperSockets Language Environment* System z9* DFSMS DS8000* HyperSwap* NetView* System z10 DFSMSdfp Easy Tier* HyperWrite Parae Syspex* Tivoi* DFSMSdss FICON* IBM* PrintWay* * Registered trademarks of IBM Corporation The foowing are trademarks or registered trademarks of other companies. WebSphere* z10 BC z10 EC z13 z/architecture* zenterprise* z Systems z/os* Adobe, the Adobe ogo, PostScript, and the PostScript ogo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries. Ce Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under icense therefrom. Inte, Inte ogo, Inte Inside, Inte Inside ogo, Inte Centrino, Inte Centrino ogo, Ceeron, Inte Xeon, Inte SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Inte Corporation or its subsidiaries in the United States and other countries. IT Infrastructure Library is a registered trademark of the Centra Computer and Teecommunications Agency which is now part of the Office of Government Commerce. ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office. Java and a Java based trademarks and ogos are trademarks or registered trademarks of Orace and/or its affiiates. Linear Tape-Open, LTO, the LTO Logo, Utrium, and the Utrium ogo are trademarks of HP, IBM Corp. and Quantum in the U.S. and Linux is a registered trademark of Linus Torvads in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows ogo are trademarks of Microsoft Corporation in the United States, other countries, or both. OpenStack is a trademark of OpenStack LLC. The OpenStack trademark poicy is avaiabe on the OpenStack website. TEALEAF is a registered trademark of Teaeaf, an IBM Company. Windows Server and the Windows ogo are trademarks of the Microsoft group of countries. Workight is a trademark or registered trademark of Workight, an IBM Company. * Other product and service names might be trademarks of IBM or other companies. UNIX is a registered trademark of The Open Group in the United States and other countries. Notes: VISA is a registered trademark of Visa, Inc. Performance is in Interna Throughput Rate (ITR) ratio based on measurements and projections using standard IBM benchmarks in a controed environment. The actua throughput that any user wi experience wi vary depending upon considerations such as the amount of mutiprogramming in the user's job stream, the I/O configuration, the storage configuration, and the workoad processed. Therefore, no assurance can be given that an individua user wi achieve throughput improvements equivaent to the performance ratios stated here. IBM hardware products are manufactured from new parts, or new and serviceabe used parts. Regardess, our warranty terms appy. A customer exampes cited or described in this presentation are presented as iustrations of the manner in which some customers have used IBM products and the resuts they may have achieved. Actua environmenta costs and performance characteristics wi vary depending on individua customer configurations and conditions. This pubication was produced in the United States. IBM may not offer the products, services or features discussed in this document in other countries, and the information may be subject to change without notice. Consut your oca IBM business contact for information on the product or services avaiabe in your area. A statements regarding IBM's future direction and intent are subject to change or withdrawa without notice, and represent goas and objectives ony. Information about non-ibm products is obtained from the manufacturers of those products or their pubished announcements. IBM has not tested those products and cannot confirm the performance, compatibiity, or any other caims reated to non-ibm products. Questions on the capabiities of non-ibm products shoud be addressed to the suppiers of those products. 2 Prices subject to change without notice. Contact your IBM representative or Business Partner for the most current pricing in your geography. This information provides ony genera descriptions of the types and portions of workoads that are eigibe for execution on Speciaty Engines (e.g, ziips, zaaps, and IFLs) ("SEs"). IBM authorizes customers to use IBM SE ony to execute the processing of Eigibe Workoads of specific Programs expressy authorized by IBM as specified in the Authorized Use Tabe for IBM Machines provided at ( AUT ). No other workoad processing is authorized for execution on an SE. IBM offers SE at a ower price than Genera Processors/Centra Processors because customers are authorized to use SEs ony to process certain types and/or amounts of workoads as specified by IBM in the AUT. 2012, IBM Corporation 2

3 CSVFETCH exit Introduced in z/os 2.2 Fetch and unfetch events Fexibiity for exit routine to indicate for which events to get contro Supported by the dynamic exit faciity Primariy intended for use by monitor products so that they do not have to hook the operating system. Not imited to that use case. 2012, IBM Corporation 3

4 Considerations Performance Do as itte as possibe The exit routine coud adversey affect the performance of the system due to frequency and oca ock contention 2012, IBM Corporation 4

5 CSVFETCH events (fetch) For fetch events, the exit is caed after the fetch Fetch_GetStore (X' _ ') first oad, storage is obtained Fetch_JPQ (X' _ ') secondaryoad, found on job pack queue Unix_GetStore (X' _ ') first oad, storage is obtained Unix_JPQ (X' _ ') secondary oad, found on job pack queue 2012, IBM Corporation 5

6 CSVFETCH events (fetch) Fetch_LPA (X' _ ') fetched from LPA Fetch_DirLoad (X' _ ') Load with Address (AKA directed oad ) Unix_DirLoad (X' _ ') Unix directed oad via BPX1LDX/BPX4LDX Fork (X' _ ') modue created for fork 2012, IBM Corporation 6

7 CSVFETCH events (unfetch) For unfetch events, the exit is caed before the unfetch Unfetch_FreeStore (X' _ ') Unfetch_NoFree (X' _ ') Unfetch_LPA (X' _ ') 2012, IBM Corporation 7

8 Data for fetch events Indication that it is a fetch event and the service ID Modue name or Path name UCB address pus CCHH of the fetch (when avaiabe) Address of CDE (may be minor with address of major, or major with address of XTLST) so can ocate the extents DCB address or indication of LNKLST Other options that might have been requested such as oad with address, goba=yes, goba=(yes,fixed) 2012, IBM Corporation 8

9 Data for unfetch events Indication that it is an unfetch event and the service ID Modue name or Path name Address of CDE (can be minor with address of major, or major with address of XTLST, as indicated by bit CDMIN) Entry point address 2012, IBM Corporation 9

10 Identifying your exit routine Use the CSVDYNEX macro to connect an exit routine to the dynamic exits processing. For exampe: CSVDYNEX REQUEST=ADD, EXITNAME=THEEXIT, MODNAME=THEMOD... THEEXIT DC CL16'CSVFETCH' THEMOD DC CL8'FTCHXRTN' The exit routine must be reentrant X X 2012, IBM Corporation 10

11 Using ServiceMask Identify which events, by creating a service mask, or'ing together the service ID's. For non-unix non-lpa fetch and unfetch events, for exampe: CSVDYNEX REQUEST=ADD, EXITNAME=THEEXIT, MODNAME=THEMOD, SERVICEMASK=SM... THEEXIT DC CL16'CSVFETCH' THEMOD DC CL8'FTCHXRTN' SM DC XL8' ' X X X 2012, IBM Corporation 11

12 Exit routine environment Key 0, supervisor state, task mode, enabed AMODE 31 or 64 according to dynamic exits faciity Primary = Home = Secondary LOCAL ock hed (do not reease it!) A data beow 2G Area mapped by macro CSVFTCHX to identify the event 1024-byte workarea which coud be used for modue dynamic storage 2012, IBM Corporation 12

13 Exit routine registers On Entry: 1 address of parameter area - Parameter area word 0: address of area mapped by CSVFTCHX - Parameter area word 1: address of 1024-byte work area 13 address of 144-byte F4SA-format save area 14 return address 15 entry point address On Return: Preserve regs , IBM Corporation 13

14 Fine Points Load with address: Fetch event, no unfetch event LPA Load without deete: no unfetch event For system-initiated impicit unfetch at task termination there coud be one unfetch event covering a oads of a modue For memory termination, no unfetch events 2012, IBM Corporation 14

15 Questions? 2012, IBM Corporation 15