z/OS DFSMS Installation Exits
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Introduction

z/OS DFSMS Installation Exits
SC23-6850-01

IEHINITT is a system utility used to place volume label sets onto any number of magnetic tapes mounted on one or more tape units. The IEHINITT Utility supports the REKEY function. You can use the REKEY function to replace the key label structure that is stored on a tape cartridge with a new key label structure. For details, see The Re-keying Exit.

These exits use the dynamic exits service, CSVDYNEX, which is currently described in z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYNz/OS MVS Programming: Authorized Assembler Services Reference ALE-DYNz/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN. By means of this facility a single exit, IEHINITT_EXIT has been defined for the INITT function, with two associated exit points, a pre-label and a post-label. For the REKEY function, a separate exit REKEY_EXIT has been defined with only one exit point, a re-keying exit point.

Using this same facility, installations can associate their own exit routines with these exits. See chapter ‘Adding an Exit Routine to an Exit’ in the z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN book for details. The Dynamic Exits Facility allows multiple exit routines to be simultaneously defined to a single exit and, as such, coordination of processing between these exit routines is critical.

As mentioned above, there are two exits points defined for the single exit IEHINITT_EXIT:
  • The pre-label exit is invoked just prior to issuance of the labelling I/O. The intent of this exit is to allow the installation to indicate whether labelling of the volume is to occur, and, to a degree, the values which are to be used in doing the labelling.
  • The post-label exit is invoked just after the issuance of the labelling I/O has or would have occurred. The intent of the post-label exit is to inform the installation exit routines of the results of the labelling request and associated pre-label exit processing.

The same exit routine is called at each exit point. This means that the exit must determine whether it is being entered for Pre or Post Label exit processing. A flag is set in the parameter list passed to the exit routine to indicate which exit point called the exit routine.

Although the Dynamic Exit Services Facility allows a degree of specification on order of call, that specification applies only to the last routine associated with an exit. So, in fact, there is no means of ensuring the order of call of routines. Therefore, all existing exit routines are always called for both Pre and Post label processing.

Exceptions to this rule:
  • The Dynamic Exits Service itself fails for any reason:
    • If a failure occurs during pre-label processing, no more pre-label exit routines will be called and the volume will not be labeled. The post-label exit routine will be called.
    • If a failure occurs during post-label processing, no more post-label exit routines will be called.
  • A failure occurs during internal processing not related to Dynamic Exits Services
  • If a failure occurs before calling pre-label exit routines:
    • The pre-label exit routines will not be called
    • Labelling I/O will not take place
    • Post-label exit routines will be called
  • If the operator replies S(kip) to message IEC701D:
    • No volume label will be read
    • Pre-label exit routines will not be called
    • post-label exit routines will be called

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014