IBM Support

OA47824: NEW FUNCTION - INSULATED DD SUPPORT

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: All HBB7780 and above environments           *
    ****************************************************************
    * PROBLEM DESCRIPTION: New function.                           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    This APAR provides new function within dynamic allocation.
    

Problem conclusion

Temporary fix

Comments

  • This APAR provides support within dynamic allocation for two
    new functions:
    - Insulated DD support
    - Bypass security checking support
    
    Due to space limitations, a subset of the documentation is
    included here.  See the HOLD information for additional
    documentation.
    
      o   ORDER NO- SA23-1371 (z/OS 2.1 and z/OS 2.2)
      o   ORDER NO- SA22-7608 (z/OS 1.13)
      o   Book Title- z/OS MVS Programming: Authorized
                      Assembler Services Guide
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Dynamic allocation                                         |
      |  An allocation overview                                    |
      |   Dynamic allocation functions                             |
      |    Using dsname or pathname allocation                     |
      |     Dynamic allocation facilities without JCL              |
      |     equivalents                                            |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
      Dsname allocation allows you to request the following data set
      characteristics, which are not available through JCL:
      - The password for a password-protected data set. If you
        specify the password in your program through the SVC 99
        parameter list, the system does not prompt the operator.
      - The permanently allocated attribute.
      - The convertible attribute.
    | - The insulated DD attribute (for authorized programs.)
    | - Bypass security processing (for authorized programs.)
      - Return of certain information.
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Dynamic allocation                                         |
      |  An allocation overview                                    |
      |   Dynamic allocation functions                             |
      |    Using dsname or pathname allocation                     |
      |     Using an existing allocation to fulfill a dsname       |
      |     allocation request                                     |
      |      Characteristics prohibited in your request            |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
      To be satisfied by an existing allocation, your request must
      not specify any of the following:
      ...
    | - Insulated DD attribute.
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Dynamic allocation                                         |
      |  An allocation overview                                    |
      |   Dynamic allocation functions                             |
      |    Insulated DD attribute                                  |
      +------------------------------------------------------------+
      A new section is created, following the existing Convertible
      Attribute section:
    
      To protect against accidental modification of a resource by
      other SVC 99 services, you can request that the system assign
      the Insulated DD attribute.  The Insulated DD attribute is
      available on z/OS 1.13 and above systems with APAR OA47824
      installed.
    
      To request the Insulated DD attribute when dynamically
      allocating a resource, your program must be APF-authorized,
      in supervisor state, or running in PSW key 0-7.  An allocation
      with the Insulated DD attribute has the following
      characteristics:
      - The convertible attribute cannot be assigned to the
        resource.
      - The in-use attribute may not be removed from the resource.
      - The permanently allocated attribute is assigned to the
        resource.
    
      In order to dynamically unallocate a resource that was
      allocated with the Insulated DD attribute, it is necessary to
      specify the corresponding Insulated DD text unit in the
      dynamic unallocation parameter list.  Any resource allocated
      with the Insulated DD attribute will be unallocated at the end
      of the job step if it is not deallocated earlier.
    
      When dynamically concatenating resources, it is not possible
      to create a group where some resources have the Insulated DD
      attribute and some do not.  If any resource in the group has
      the Insulated DD attribute, all resources in the group must
      have the Insulated DD attribute. In order to dynamically
      concatenate a group of resources that were allocated with the
      Insulated DD attribute, it is necessary to specify the
      corresponding Insulated DD text unit in the dynamic
      concatenation parameter list.
    
      In order to dynamically deconcatenate a group of resources
      that were allocated with the Insulated DD attribute, it is
      necessary to specify the corresponding Insulated DD text unit
      in the dynamic deconcatenation parameter list.
    
      Use of the Insulated DD text units described above require
      that your program be APF-authorized, in supervisor state, or
      running in PSW key 0-7.  This effectively prevents
      unauthorized callers from unallocating, concatenating, or
      deconcatenating resources allocated with the Insulated DD
      attribute.
    
      It is an error to specify the Insulated DD text units for a
      dynamic unallocation, concatenation, or deconcatenation
      request when the resource to be processed does not have the
      Insulated DD attribute.
    
      Dynamic remove in-use processing (verb code 05) is used to
      remove the in-use attribute of a resource.  Since resources
      with the Insulated DD attribute must always have the in-use
      attribute, dynamic remove in-use processing will ignore any
      resources with the Insulated DD attribute.
    
      Dynamic ddname allocation (verb code 06) is used to assign the
      in-use attribute to an existing resource that does not have
      the in-use attribute assigned.  Since a resource with the
      Insulated DD attribute must also have the in-use attribute,
      any attempt to assign the in-use attribute to a resource with
      the Insulated DD attribute will be rejected.
    
      Additionally, the following services are not supported for
      resources with the Insulated DD attribute:
      - IEFDDSRV MODIFY, TYPE=ALLOCATION
      - OPEN TYPE=J
      - CLOSE with FREE option
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Requesting dynamic allocation functions                    |
      |  Interpreting DYNALLOC return codes                        |
      |   Interpreting error reason codes from DYNALLOC            |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
      Table: Class 3 Error Reason Codes (Invalid Parameter List -
      PROGRAM ERROR)
    
      Hex Code  (Decimal)  Meaning and Action
      ...
    | 03C4      (964)      Meaning: Insulated DD error.  An attempt
    |    was made to unallocate, concatenate, or deconcatenate a
    |    resource with the Insulated DD attribute without specifying
    |    the Insulated DD text unit, or the insulated DD text unit
    |    was specified but the resource was not allocated with the
    |    Insulated DD attribute.
    |    Application Programmer Response: Verify that the proper
    |    ddname was used on the request, and correct if necessary.
    |    If the ddname is correct, add or remove the Insulated DD
    |    text unit and resubmit the request.
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Requesting dynamic allocation functions                    |
      |  SVC 99 parameter list verb codes and text units, by       |
      |  function                                                  |
      |   Non-JCL dynamic allocation functions                     |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
      Table: Verb Code 01 (Non-JCL Dynamic Allocation Functions) -
      Text Units, Mnemonics, and Functions
    
      Hex Text   Mnemonic  DYNALLOC Function
      Unit Key
      ...
    | 0079       DALINSDD  Specifies the Insulated DD attribute
    | 007A       DALNOSEC  Specifies bypass security processing
      ...
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Requesting dynamic allocation functions                    |
      |  SVC 99 parameter list verb codes and text units, by       |
      |  function                                                  |
      |   Dynamic unallocation text units                          |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
      Table: Verb Code 02 (Dynamic Unallocation) - Text Unit Keys,
      Mnemonics, and Functions
    
      Hex Text   Mnemonic  DYNALLOC Function
      Unit Key
      ...
    | 0079       DUNINSDD  Specifies Insulated DD request
    | 007A       DUNNOSEC  Specifies bypass security processing
      ...
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Requesting dynamic allocation functions                    |
      |  SVC 99 parameter list verb codes and text units, by       |
      |  function                                                  |
      |   Dynamic concatenation text units                         |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
      Table: Verb Code 03 (Dynamic Concatenation) - Text Unit Keys,
      Mnemonics, and Functions
    
      Hex Text   Mnemonic  DYNALLOC Function
      Unit Key
      ...
    | 0079       DCCINSDD  Specifies Insulated DD request
      ...
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | Requesting dynamic allocation functions                    |
      |  SVC 99 parameter list verb codes and text units, by       |
      |  function                                                  |
      |   Dynamic deconcatenation text units                       |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
    | Table: Verb Code 03 (Dynamic Deconcatenation) - Text Unit
    | Keys, Mnemonics, and Functions
    
      Hex Text   Mnemonic  DYNALLOC Function
      Unit Key
      ...
    | 0079       DDCINSDD  Specifies Insulated DD request
      ...
    
      +--- LOCATION IN PUBLICATION --------------------------------+
      | IEFDISRC Information                                       |
      |  IEFDISRC Map                                              |
      +------------------------------------------------------------+
      Additional information is added. Changes are marked with '|':
    
      Offsets
      Dec Hex  Type/Value  Len  Name (Dim)  Description
      ...
      --------------------------------------------------------------
      RETURN CODE DDSRV_INVALID_PARAMETERS (decimal)
      --------------------------------------------------------------
      ...
    | 0   (0)  X'138'      0    DDSRV_INSULATED_DD
    |                                     "312" X'138' DD was
    |                                     allocated using the
    |                                     insulated allocation
    |                                     TU
    
    ×**** PE16/02/12 FIX IN ERROR. SEE APAR OA49892  FOR DESCRIPTION
    

APAR Information

  • APAR number

    OA47824

  • Reported component name

    ALLOCATION

  • Reported component ID

    5752SC1B4

  • Reported release

    780

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2015-05-11

  • Closed date

    2015-08-27

  • Last modified date

    2016-03-07

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

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

    UA78789 UA78790 UA78791

Modules/Macros

  • IEFAB4A2 IEFAB4I0 IEFAB42A IEFAB421 IEFAB434
    IEFAB469 IEFADSMD IEFBB4M3 IEFDB4A0 IEFDB4A1 IEFDB4F1 IEFDB410
    IEFDB411 IEFDB412 IEFDB413 IEFDB414 IEFDB417 IEFDB450 IEFDB460
    IEFDB470 IEFDB478 IEFDDSRV IEFDISRC IEFJESCT IEFMEDD  IEFSVC99
    IEFZB4D2 IHADSAB
    

Publications Referenced
SA227607XXSC236852XXGA320856XXGA320938XXSA227608XX
SC267408XXGA320935XXGA320937XXSA231370XXGA320854XX
GA320936XXSA231371XXGA320855XXGA320937XX 

Fix information

  • Fixed component name

    ALLOCATION

  • Fixed component ID

    5752SC1B4

Applicable component levels

  • R7A0 PSY UA78789

       UP15/09/29 P F509

  • R780 PSY UA78790

       UP15/09/26 P F509

  • R790 PSY UA78791

       UP15/09/29 P F509

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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"780","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"780","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
07 March 2016