OA49722: NEW FUNCTION - IEF_ALLC_UNLOAD EXIT ENHANCEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All HBB7780 and above installations using    *
  *                 the IEF_ALLC_UNLOAD installation exit.       *
  ****************************************************************
  * PROBLEM DESCRIPTION: New function in the IEF_ALLC_UNLOAD     *
  *                      installation exit.                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The IEF_ALLC_UNLOAD installation exit can be used to perform
  pre- and post-processing when a device is unloaded by
  Device Allocation outside of normal end-of-job or end-of-step
  device unload processing.  This APAR provides an enhancement to
  the exit.
  

Problem conclusion

Temporary fix

Comments

• The parameter list for the IEF_ALLC_UNLOAD exit, mapped by macro
  IEFUNLXT, will contain a new field, UNLXT_SOURCE, that describes
  the source of the unload request (for example, the unload is on
  behalf of a VARY OFFLINE command.)  See the documentation for
  complete details regarding the contents of this field.
  
    DOCUMENTATION HOLD FOR APAR OA49722
  
    o   ORDER NO-   SA22-7593 (z/OS 1.13)
    o   ORDER NO-   SA23-1381 (z/OS 2.1 and z/OS 2.2)
    o   Book Title- z/OS MVS Installation Exits
  
    +--- LOCATION IN PUBLICATION --------------------------------+
    |                                                            |
    | The Exits                                                  |
    |  IEF_ALLC_UNLOAD  Allocation Event Installation Exit       |
    |   Exit Routine Processing                                  |
    |                                                            |
    +------------------------------------------------------------+
  
    MVS invokes the Unload Event exit routine or routines, if any
    are specified to the dynamic exits facility, whenever an
    unload event takes place.
  
    Using the Information in the Parameter List: MVS passes the
    address of a list of parameters to the exit routine. The
    parameters contain the following information:
  
      ...
      - Flags indicating which of the following ENQs are held by
        the caller:
         -  SYSIEFSD.CHNGDEVS
         -  SYSIEFSD.VARYDEV
         -  SYSIEFSD.Q4
  |   - One of the following source values that indicates the
  |     reason the exit is invoked:
  |      -  Unload is on behalf of the VARY OFFLINE command or
  |         comparable IEEVARYD request - 01
  |      -  Unload is on behalf of the UNLOAD command - 02
  |      -  Unload is on behalf of a non-Allocation requestor - 03
  |     The source information is only available on z/OS 1.13,
  |     z/OS 2.1, and z/OS 2.2 systems when APAR OA49722 is
  |     installed.  When OA49722 is not installed, the
  |     corresponding location in the parameter list will always
  |     contain zero.  When OA49722 is installed, the field will
  |     always contain a non-zero value.
      - Address of the UCB of the device being unloaded. The
        system does not pin the UCB before calling the exit.
  
    +--- LOCATION IN PUBLICATION --------------------------------+
    |                                                            |
    | The Exits                                                  |
    |  IEF_ALLC_UNLOAD  Allocation Event Installation Exit       |
    |   Programming Considerations                               |
    |                                                            |
    +------------------------------------------------------------+
  
    Observe the following conventions when coding the
    IEF_ALLC_UNLOAD Exit routine:
  
      ...
      - Make sure that the exit routine does not get affected
  |     when new function code support is added or new exit
  |     source values are added.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UA80797 UA80798 UA80799

Modules/Macros

• IEFAB49C IEFHBOFF IEFHBUNL IEFUNLXT
  

Fix information

• Fixed component name

  ALLOCATION

• Fixed component ID

  5752SC1B4

Applicable component levels

• R7A0 PSY UA80797

     UP16/03/09 P F603

• R780 PSY UA80798

     UP16/03/09 P F603

• R790 PSY UA80799

     UP16/03/09 P F603

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.