Abstract for DFSMS Installation Exits
Summary of changes
Summary of changes
z/OS Version 2 Release 1 summary of changes
Introduction
Choosing between Installation and User Exits
Using Installation Exits
Using User Exits
Programming Considerations
Installing Exits
Replacing an Existing Exit
Adding a New Exit
Testing Exits
Protecting the System from Exit Errors
Invoking Dumps
Issuing the ABEND Macro in an Exit
Setting CVTSDUMP
Issuing the SDUMP Macro
Using the Console DUMP Command
Issuing Messages
Tracing Module Flow in OPEN, CLOSE and EOV
Data Management Installation/Dynamic Exits
DADSM Installation/Dynamic Exits General Information
User Interfaces with DADSM Installation/Dynamic Exits
Messages
System Messages
Messages from Other Programs
Exit Messages
Documenting Your Exits
DADSM Pre- and Post processing Dynamic Exits (IGGPRE00_EXIT, IGGPOST0_EXIT)
Adding DADSM pre and post processing exit routines
Characteristics of the IGGPRE00_EXIT and IGGPOST0_EXIT Exit Dynamic Exits, Exit Routines
Understanding when IGGPRE00_EXIT and IGGPOST0_EXIT dynamic exits, exit routines are available
Rejecting DADSM requests in IGGPRE00_EXIT dynamic exit, exit routines
Rejecting a Partial Release Request
Rejecting a Scratch or Rename Request
Rejecting a Create (Allocate) Request in IGGPRE00
Rejecting an Extend Request
Returning a Model Format-1 DSCB
Registers on Entry to the IGGPRE00 and IGGPOST0 Exit Routines
IGGPRE00_EXIT and IGGPOST0_EXIT dynamic exits, exit routine Parameter List
System Control Blocks Used by IGGPRE00_EXIT and IGGPOST0_EXIT dynamic exits, exit routines
Registers on Return from the IGGPRE00_EXIT and IGGPOST0_EXIT dynamic exits, exit routines
IGGPRE00_EXIT dynamic exit, exit routine return codes
Scratch and Rename Installation Exits (IGGDASU3, IGGDARU3)
Replacing the Scratch and Rename Exit Routines
Characteristics of the Scratch and Rename Exit Routines
Registers on Entry to the Scratch and Rename Exit Routines
Scratch Parameter List (IGGDASCR)
Rename Parameter List (IGGDAREN)
DADSM Volume List (IGGDAVLL)
Registers on Return from the Scratch and Rename Exits
dDASD Calculation Services Installation Exits (IGBDCSX1, IGBDCSX2)
Replacing the IGBDCSX1 and IGBDCSX2 Exit Routines
Characteristics of the IGBDCSX1 and IGBDCSX2 Exit Routines
Registers on Entry to the IGBDCSX1 and IGBDCSX2 Exit Routines
IGBDCSX1 and IGBDCSX2 Parameter List
Registers on Return from the IGBDCSX1 and IGBDCSX2 Exit Routines
IGBDCSX1 and IGBDCSX2 Return Codes
IGBDCSX1
IGBDCSX2
Example of the IGBDCSX1 Exit Routine
Example of the IGBDCSX2 Exit Routine
Data Management Abend Installation Exit (IFG0199I)
Replacing the IFG0199I Exit Routine
Characteristics of the IFG0199I Exit Routine
Registers on Entry to the IFG0199I Exit Routine
IFG0199I Parameter List
Registers on Return from the IFG0199I Exit Routine
IFG0199I Return Codes
Example of the IFG0199I Exit Routine
DCB Open Installation Exit (IFG0EX0B)
Replacing the IFG0EX0B Exit Routine
Characteristics of the IFG0EX0B Exit Routine
Understanding IFG0EX0B Execution Environment
Using the Data Control Block (DCB)
Specifying a Value for the Number of Buffers
Modifying the Job File Control Block (JFCB)
Requesting Partial Release of DASD Data Set Space
Updating DASD Secondary Space Data
Using the Unit Control Block (UCB)
Finding the Task Input/Output Table (TIOT) Entry
Finding the Data Set Control Blocks (DSCBs)
Directing the System to Determine Block Size
Registers on Entry to the IFG0EX0B Exit Routine
IFG0EX0B Parameter List
Registers on Return from the IFG0EX0B Exit Routine
IFG0EX0B Return Codes
Processing: BUFNO Subroutine
Processing: SCREEN Subroutine
Processing: RLSE Subroutine
Processing: SQTY Subroutine
Example of the IFG0EX0B Exit Routine
VSAM EOV Installation Exit (IDAEOVXT)
Replacing the IDAEOVXT Exit Routine
Characteristics of the IDAEOVXT Exit Routine
Registers on Entry to the IDAEOVXT Exit Routine
IDAEOVXT Parameter List
Registers on Return from the IDAEOVXT Exit Routine
Tape Cartridge Message Display Installation Exit (IGXMSGEX)
Installing the IGXMSGEX Exit Routine
Characteristics of the IGXMSGEX Exit Routine
Controlling the Automatic Cartridge Loader
Registers on Entry to the IGXMSGEX Exit Routine
IGXMSGEX Parameter List
Registers on Return from IGXMSGEX
Example of the IGXMSGEX Exit Routine
Tape Label Processing Installation Exits
Programming Considerations
Open, Close, End-of-Volume Tape Management Exits
Installing the Open, Close, and EOV Exits
Characteristics of the Open, Close and EOV Exits
Registers on Entry to the Open, Close and EOV Exits
Open, Close, and EOV Main Parameter List
Passing Information Between Exits
Open, Close, and EOV Return Codes
Label Anomaly Exit (IFG019LA)
Label Anomaly Exit (IFG019LA) Function-Specific Parameter List
Label Anomaly Exit (IFG019LA) Return Codes
Volume Mount Exit
Volume Mount Exit Function-Specific Parameter List
Volume Mount Exit Return Codes
File Validation Exit
File Validation Exit Function-Specific Parameter List
File Validation Exit Return Codes
File Start on Volume Exit
File Start on Volume Exit Function-Specific Parameter List
File Start on Volume Exit Return Code
File End on Volume Exit
File End on Volume Exit Function-Specific Parameter List
File End on Volume Return Code
Nonstandard Labels
Processing Nonstandard Labels
Input Header Label Routines (NSLOHDRI, NSLEHDRI)
Input Trailer Label Routines (NSLETRLI)
Output Header Label Routines (NSLOHDRO, NSLEHDRO)
Output Trailer Label Routines (NSLETRLO, NSLCTRLO)
Data Recovery
Installing Nonstandard Label Routines
Writing Nonstandard Label Processing Routines
Processing Tapes with Nonstandard Labels
Program Functions
Mapping the Common Open, Close, EOV Work Area
Flowcharts for Sample Routines
Automatic Volume Recognition (AVR) Nonstandard Label Processing Routine (IEFXVNSL)
Installing the AVR Nonstandard Label Routine
Writing the AVR Nonstandard Label Processing Routine
Registers on Entry to the AVR Exit Routine
AVR Parameter List
NSL Volume Verification with Dynamic Device Reconfiguration (NSLREPOS)
Volume Label Verification and Volume Label Editor Routines
Verification of First Record
Volume Label Editor Routines
Installing Your Own Label Editor Routines
Writing Volume Label Editor Routines
Program Functions
ISO/ANSI Version 3 and Version 4 Installation Exits (IFG0193G)
Label Validation Exit
Label Validation Suppression Exit
Volume Access Exit
File Access Exit
WTO/WTOR Message Processing Facility Installation Exit (IEAVMXIT)
IECIEPRM Parameter List
UCB Tape Class Extension-IECUCBCX
Pre-ACS Installation Exit IGDACSXT
Installing the Pre-ACS Exit Routine
Characteristics of the Pre-ACS Installation Exit
Registers on Entry to the Pre-ACS Exit Routine
Registers on Return from the Pre-ACS Exit Routine
Automatic Class Selection (ACS) Installation Exits
Installing the ACS Exit Routine
Characteristics of the ACS Installation Exits
Understanding the Automatic Class Selection Process
Recovery Environment for ACS Exit Routines
Registers on Entry to the ACS Exit Routines
Using the ACS Exits Parameter Lists
Assigning Classes
Returning Messages
Invoking ACS Interface Routine from an Exit
ACS Installation Exits Parameter List (IGDACSPM)
Read-Only Variables Parameter List (IGDACERO)
Read-Write Variables (IGDACERW)
Registers on Return from an ACS Installation Exit Routine
ACS Return and Reason Codes
Example of the ACS Installation Exit Routine
DFSMShsm Installation Exits
Using DFSMShsm Installation Exits
Installing DFSMShsm Exits
Replacing DFSMShsm Exits
Writing DFSMShsm Exits
Special Considerations
Registers on Entry to DFSMShsm Installation Exits
Registers on Return from DFSMShsm Installation Exits
Calling DFSMShsm Installation Exits
Creating User-Defined Messages
ARCADEXT: Data Set Deletion Installation Exit
Characteristics of the ARCADEXT Exit
Recovering from an Abend of ARCADEXT Processing
ARCADEXT Parameter List
ARCADEXT Return Codes
ARCBDEXT: Data Set Backup Installation Exit
Characteristics of the ARCBDEXT Exit
Recovering from an Abend of ARCBDEXT Processing
ARCBDEXT Parameter List
ARCBDEXT—Input Data Structure
ARCBDEXT Return Codes
ARCCBEXT: Control Data Set Backup Installation Exit
Characteristics of the ARCCBEXT Exit
Recovering from an Abend of ARCCBEXT Processing
ARCCBEXT Parameter List
ARCCDEXT: Data Set Reblock Installation Exit
Characteristics of the ARCCDEXT Exit
Recovering from an Abend of ARCCDEXT Processing
ARCCDEXT Parameter List
ARCINEXT: Initialization Installation Exit
Characteristics of the ARCINEXT Exit
Recovering from an Abend of ARCINEXT Processing
ARCINEXT Parameter List
MCVT User-Reserved Fields for Use with the ARCINEXT Exit
ARCMDEXT: Space Management Exit
Characteristics of the ARCMDEXT Exit
Recovering from an Abend of ARCMDEXT Processing
ARCMDEXT Parameter List
ARCMDEXT—Input Data Structure
ARCMDEXT Return Codes
ARCMMEXT: Second Level Migration Data Set Installation Exit
Characteristics of the ARCMMEXT Exit
Recovering from an Abend of ARCMMEXT Processing
ARCMMEXT Parameter List
ARCMMEXT Return Codes
ARCMVEXT: Space Management Volume Installation Exit
Characteristics of the ARCMVEXT Exit
Recovering from an Abend of ARCMVEXT Processing
ARCMVEXT Parameter List
ARCRDEXT: Recall Installation Exit
Characteristics of the ARCRDEXT Exit
ARCRDEXT Parameter List
Building Recall Exit Lists
ARCRDEXT Unlike Attribute Array
Recalling Data Sets to Target Volumes Associated with User-Defined Pools
Recalling Data Sets to Target Volumes with Unlike Attributes
Recalling Data Sets to Target Volumes with Like Attributes
Overriding the System's Volume Priority
Recovering from an Abend of ARCRDEXT Processing
ARCRPEXT: Return-Priority Installation Exit
Characteristics of the ARCRPEXT Exit
Recovering from an Abend of ARCRPEXT Processing
ARCRPEXT Parameter List
ARCRPEXT—Input Data Structure
ARCRPEXT—Output Data Structure
ARCRPEXT Message Area
ARCRPEXT Return Codes
ARCSAEXT: Space Management and Backup Installation Exit
Characteristics of the ARCSAEXT Exit
Recovering from an Abend of ARCSAEXT Processing
ARCSAEXT Parameter List for Non-System-Managed Data Sets
ARCSAEXT Parameter List for System-Managed Data Sets
ARCSAEXT—Data Set and Processing Information Area
ARCSAEXT Return Codes
ARCSDEXT: Shutdown Installation Exit
Characteristics of the ARCSDEXT Exit
Recovering from an Abend of ARCSDEXT Processing
ARCSDEXT Parameter List
MCVT User-Reserved Fields (for use with the ARCINEXT and ARCSDEXT Exits)
ARCTDEXT: Tape Data Set Installation Exit
Characteristics of the ARCTDEXT Exit
Recovering from an Abend of ARCTDEXT Processing
ARCTDEXT Parameter List
ARCTEEXT: Tape-Ejected Installation Exit
Characteristics of the ARCTEEXT Exit
Recovering from an Abend of ARCTEEXT Processing
User-Created Messages
ARCTEEXT Parameter List
ARCTEEXT Return Codes
ARCTVEXT: Tape Volume Installation Exit
Characteristics of the ARCTVEXT Exit
Recovering from an Abend of ARCTVEXT Processing
ARCTVEXT Parameter List
ARCTVEXT Data Area
ARCTVEXT Return Codes
DFSMShsm ABARS Installation Exits
Using DFSMShsm ABARS Exits
Installing DFSMShsm ABARS Exits
Writing DFSMShsm ABARS Exits
Replacing ABARS Exits
Registers on Entry to DFSMShsm ABARS Installation Exits
Registers on Return from DFSMShsm ABARS Installation Exits
Calling DFSMShsm ABARS Installation Exits
Creating User-Defined Messages
ARCBEEXT: ABARS Backup Error Installation Exit
Characteristics of the ARCBEEXT Exit
Recovering from an Abend of ARCBEEXT Processing
ARCBEEXT Parameter List
ARCBEEXT Return Codes
ARCCREXT: ABARS Conflict Resolution In Installation Exits
Characteristics of the ARCCREXT Exit
Recovering from an Abend of ARCCREXT Processing
ARCCREXT Parameter List
ARCCREXT Return Codes
ARCEDEXT: ABARS Expiration Date Installation Exit
Characteristics of the ARCEDEXT Exit
Recovering from an Abend of ARCEDEXT Processing
ARCEDEXT Parameter List
ARCEDEXT Return Codes
ARCM2EXT: ABARS Migration Level 2 Data Set Installation Exit
Characteristics of the ARCM2EXT Exit
Recovering from an Abend of ARCM2EXT Processing
ARCM2EXT Parameter List
ARCM2EXT Return Codes
ARCSKEXT: ABARS Data Set Skip Installation Exit
Characteristics of the ARCSKEXT Exit
Recovering from an Abend of ARCSKEXT Processing
ARCSKEXT Parameter List
ARCSKEXT Return Codes
ARCTVEXT: Tape Volume Installation Exit
DFSMSdss Installation Exits
Installing and Replacing DFSMSdss Installation Exit Routines
Characteristics of DFSMSdss Installation Exit Routines
DFSMSdss Dynamic Exit (ADRDYEXT_EXIT1)
Characteristics of the DFSMSdss Dynamic Exit, ADRDYEXT_EXIT1
Registers on Entry to ADRDYEXT_EXIT1
ADRDYEXT_EXIT1 Parameter List
Registers on Return from ADRDYEXT_EXIT1
ADRDYEXT_EXIT1 Return Codes
Authorization Installation Exit Routine (ADRUPSWD)
Installation-Supplied Authorization Exit Routine
Registers on Entry to the ADRUPSWD Exit
ADRUPB Parameter List
Registers on Return from the ADRUPSWD Exit
ADRUPSWD Return Codes
Return Codes for Volume Level Entry
Return Codes for Data Set Level Entry
Example of the ADRUPSWD Exit
Enqueue Installation Exit Routine (ADRUENQ)
Installation-Supplied Enqueue Exit Routine
Registers on Entry to the ADRUENQ Exit
ADRUENQ Parameter List
Registers on Return from the ADRUENQ Exit
ADRUENQ Return Codes
Example of the ADRUENQ Exit
Options Installation Exit Routine (ADRUIXIT)
Installation-Supplied Options Exit Routine
Registers on Entry to the ADRUIXIT Exit
ADRUFO Parameter List
Registers on Return from the ADRUIXIT Exit
ADRUIXIT Return Codes
Example of the ADRUIXIT Exit
Reblock Installation Exit Routine (ADRREBLK)
Installation-Supplied ADRREBLK Exit Routine
Registers on Entry to the ADRREBLK Exit
ADRRBLKB Parameter List
Registers on Return from the ADRREBLK Exit
ADRREBLK Return Codes
Example of the ADRREBLK Exit
IEHINITT Dynamic Exits
Introduction
General Programming Considerations
The Pre-Label Exit
Overview
Registers on Entry
Registers on Exit
Return and Reason Code Values
Summary of Information Passed to the Pre-Label Exit Routines
Conflict Processing
Special Considerations for NUMBTAPE Processing:
Labelling Write Protected Volumes
READLBL Related Support
The Post-Label Exit
Overview
Registers on Entry
Registers on Exit
Return and Reason Code Values
Summary of Information Passed to the Post-Label Exit Routines
Output
The Re-keying Exit
Overview
Registers on Entry
Registers on Exit
Return and Reason Code Values
Summary of Information Passed to the Re-keying Exit Routines
Output