A fix is available
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
SA227607XX | SC236852XX | GA320856XX | GA320938XX | SA227608XX |
SC267408XX | GA320935XX | GA320937XX | SA231370XX | GA320854XX |
GA320936XX | SA231371XX | GA320855XX | GA320937XX |
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