OA35146: NEW FUNCTION - ALLOW NON-CLIENT PREEMPTABLE SRBS TO JOIN/LEAVE AN ENCLAVE AFTER IT HAS BEGUN

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • New function
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users running z/OS HBB7750 thru HBB7770.     *
    ****************************************************************
    * PROBLEM DESCRIPTION: New function.                           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    New function to provide the capability for a non-client
    preemptable SRB to join and leave an enclave after it has
    begun.
    

Problem conclusion

Temporary fix

Comments

  • New function to provide the capability for a non-client
    preemptable SRB to join and leave an enclave after it has
    begun.  This function already exists at HBB7780.
    
    
    DOCUMENTATION HOLD FOR APAR OA35146
      +-------------------------------------------------------+
    
      o   Book Title- z/OS         MVS Data Areas, Volume 2
                                   (DCCD-IEFDOKEY)
    
    
      MVS Data Areas, Volume 2 (DCCD-IEFDOKEY)
    
      +--- LOCATION IN PUBLICATION ---------------------------+
      |                                                       |
      | ECVT Programming Interface information                |
      |   Programming Interface information                   |
      +-------------------------------------------------------+
    
      Add the following fields to the list of ECVT Programming
      Interface information:
    
    | ECVTSRBJ
    | ECVTSRBL
    
      +--- LOCATION IN PUBLICATION ---------------------------+
      |                                                       |
      | ECVT Programming Interface information                |
      |   ECVT Heading information                            |
      |     ECVT Map                                          |
      +-------------------------------------------------------+
    
      Replace:
      Decimal=144, Hex=(90), Type=bitstring, Len=8,
      Name=ECVTR090, Description=Reserved
    
      With:
    | Decimal=144, Hex=(90), Type=address,   Len=4,
    | Name=ECVTSRBJ, Description=SRB-mode enclave join
    | - A value of 0 in ECVTSRBJ means that the
    |   function is not available
    | - Caller must be AMODE 31 or 64, key 0,
    |   supervisor state, enabled for I/O and
    |   external interrupts, holding no locks
    | - SRB mode (preemptable non-Client SRB only)
    | - Primary ASC mode
    | - Any P, Any S, Any H
    | - Set GR 1 to the below-2G address of the
    |   8-byte enclave token. Bits 0-31 of 64-bit
    |   GR 1 are ignored.
    | - Load this address into GR 15. Do not use
    |   the LLGT instruction. You do not need
    |   to set bits 0-31 of 64-bit GR 15.
    | - If AMODE 64, issue BASSM 14,15
    |   If AMODE 31, issue BASSM 14,15 or BASR 14,15
    | - 31-bit GRs 2-13, high halves 2-14, and
    |   ARs 2-14 will be preserved.
    | - On return, GR 15 contains the return code:
    |   0  = Join successfully completed.
    |   8  = Enclave token is not or is no longer
    |        valid
    |   12 = Work unit is already in an enclave
    |   16 = Non-preemptable SRB
    |   20 = Client SRB
    | - Potential Abend Codes: none
    
    | Decimal=148, Hex=(94), Type=address,   Len=4,
    | Name=ECVTSRBL, Description=SRB-mode enclave leave
    | - A value of 0 in ECVTSRBL means that the
    |   function is not available
    | - Caller must be AMODE 31 or 64, key 0,
    |   supervisor state, enabled for I/O and
    |   external interrupts, holding no locks
    | - SRB mode
    | - Primary ASC mode
    | - Any P, Any S, Any H
    | - Set GR 1 to the below-2G address of the
    |   8-byte enclave token. Bits 0-31 of 64-bit
    |   GR 1 are ignored.
    | - Load this address into GR 15. Do not use
    |   the LLGT instruction. You do not need
    |   to set bits 0-31 of 64-bit GR 15.
    | - If AMODE 64, issue BASSM 14,15
    |   If AMODE 31, issue BASSM 14,15 or BASR 14,15
    | - 31-bit GRs 2-13, high halves 2-14, and
    |   ARs 2-14 will be preserved.
    | - On return, GR 15 contains the return code:
    |   0  = Leave successfully completed.
    |   8  = Enclave token is not or is no longer
    |        valid
    |   12 = Work unit is not in an enclave
    |   16 = Work unit is not in the enclave
    |        identified by the input
    | - Potential Abend Codes: none
    
      +--- LOCATION IN PUBLICATION ---------------------------+
      |                                                       |
      | ECVT Programming Interface information                |
      |   ECVT Heading information                            |
      |     ECVT Cross Reference                              |
      +-------------------------------------------------------+
    
    | Remove ECVTR090   90       0
    
    | Add    ECVTSRBJ   90
    | Add    ECVTSRBL   94
    

APAR Information

  • APAR number

    OA35146

  • Reported component name

    SUPERVISOR CONT

  • Reported component ID

    5752SC1C5

  • Reported release

    760

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function

  • Submitted date

    2010-12-09

  • Closed date

    2011-05-04

  • Last modified date

    2011-06-01

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

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

    UA60217 UA60218 UA60219

Modules/Macros

  •    IEAECVTP IEAVECVT IEAVELCR IEAVJOIN IEAVLEAV
    IHAECVT
    

Fix information

  • Fixed component name

    SUPERVISOR CONT

  • Fixed component ID

    5752SC1C5

Applicable component levels

  • R750 PSY UA60217

       UP11/05/18 P F105

  • R760 PSY UA60218

       UP11/05/18 P F105

  • R770 PSY UA60219

       UP11/05/18 P F105

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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

z/OS family

Software version:

760

Operating system(s):

MVS, z/OS

Reference #:

OA35146

Modified date:

2011-06-01

Translate my page

Machine Translation

Content navigation