A fix is available
APAR status
Closed as new function.
Error description
The IMPORT DEFN SOURCE(CATALOG) command needs a NAME() option so change can be limited to specific resources.
Local fix
POSTREQ PH21311
Problem summary
**************************************************************** * USERS AFFECTED: * * All IMS V15 users of Managed ACBs * **************************************************************** * PROBLEM DESCRIPTION: * * An IMS user of Managed ACBs cannot selectively import DBDs * * and/or PSBs into their online IMS system. * **************************************************************** * RECOMMENDATION: * * INSTALL CORRECTIVE SERVICE FOR APAR/PTF * ****************************************************************
Problem conclusion
IMPORT DEFN SOURCE(CATALOG) command is enhanced to support NAME() keyword to import only specific DBDs and PSBs from the staging directory data set to the active directory data set. One or more DBD and/or PSB names may be specified, including wildcard names. DFSMOLCW is changed to change the staging directory DCB address field from fixed to a pointer. DFSCMDRR and DFSCCTX0 are changed to add new completion codes 246 and 247. DFSIP000, DFSOLC00 and DFSOLC70 are changed to add support for a new NAME keyword on the IMPORT DEFN SOURCE(CATALOG) command, to permit the user to selectively import DBDs and/or PSBs by name into their online IMS system. One or more DBD and/or PSB names may be specified, including wildcard names. The IMS V15 APAR PI83433 can be applied in a rolling fashion to all IMSs in the IMSplex. When the IMPORT DEFN SOURCE(CATALOG) command with NAME() keyword is routed to an IMS system without the APAR applied then the command is accepted, but it does not recognize the NAME keyword and imports all of the DBDs and PSBs from the staging directory. In an ACBSHR=Y environment, the command must be routed to the IMS V15 IMS with the APAR applied. The command master IMS will coordinate the IMPORT with other sharing IMSs. Any sharing IMSs that are IMS V15 do not need to have the APAR applied. Any IMS V14 IMS sharing the directory in ACBSHR=Y environment will participate in the IMPORT command and process the directive from the command master IMS. In an ACBSHR=N environment, the IMS systems that have the APAR applied will process the command. The IMS systems without the APAR applied will fail the IMPORT command. Any IMS V15 systems without the APAR and IMS V14 systems in the IMSplex should continue to use IMPORT DEFN SOURCE(CATALOG) command without the NAME() keyword. Additional keywords for searchability: CMDIMP, IMP DEFN ************************ DOCUMENT CHANGES FOLLOW: ************************ IMS Version 15 Release Planning (GC27-6794-00) -> IMS 15 enhancements -> IMS enhancement PTFs In Table-2, IMS Database Manager Continuous Delivery Enhancements, add following entry IMS function level = Not applicable APAR/PTF = PI83433 / TBD (once PTF built) Function name = Not applicable Can be enabled = N Can be disabled = N Enabled by default = Y Must be applied globally = N DBCTL = Y DCCTL = N Batch = N Activation bits = N New function description - The IMPORT DEFN SOURCE(CATALOG) command is being enhanced to support the NAME() keyword, in order to allow the user to specify one or more DBDs and/or PSBs to be imported by name, instead of importing all of the DBD and/or PSB ACBs from the staging directory. The function is enabled when the new command is used. ************************ DOCUMENT CHANGES FOLLOW: ************************ IMS Version 15 Release Planning (GC27-6794-00) -> IMS 15 enhancements -> IMS enhancement PTFs In Table-2, IMS Database Manager Continuous Delivery Enhancements, add following entry IMS function level = Not applicable APAR/PTF = PI83433 / TBD (once PTF built) Function name = Not applicable Can be enabled = N Can be disabled = N Enabled by default = Y Must be applied globally = N DBCTL = Y DCCTL = N Batch = N Activation bits = N New function description - The IMPORT DEFN SOURCE(CATALOG) command is being enhanced to support the NAME() keyword, in order to allow the user to specify one or more DBDs and/or PSBs to be imported by name, instead of importing all of the DBD and/or PSB ACBs from the staging directory. The function is enabled when the new command is used. IMS Version 15 Commands, Volume 1: IMS Commands A-M (SC27-6780-00) IMS > IMS 15.1.0 > IMS Commands > IMPORT commands > IMPORT DEFN SOURCE(CATALOG) command Syntax diagram: The IMPORT DEFN SOURCE(CATALOG) command syntax diagram adds support for an optional NAME keyword, that supports one or more DBD and/or PSB names. The names can be wildcards. If the NAME keyword is not specified, it defaults to NAME(*), which is equivalent to importing all of the DBDs and PSBs from the staging directory. When NAME(*) is specified, all of the ACBs in the staging directory are imported. This is equivalent to the IMPORT DEFN SOURCE(CATALOG) command with no NAME keyword. >>-+-IMPORT-+-DEFN-SOURCE(CATALOG)-|N|<> '-IMP------' +----------NAME(*)----------+ | | N----+-------------------------------+-|A|>< | | | .------,---. | | V | | +-NAME(---+-name-----+-)--------+ '--name*-' A-+-------------------------------------------------+-| +-FOR(IMSID(imsid))---------------------------------+ +-OPTION(DELPENDERR)-------------------------+ +-OPTION(NOCHECK)-+--------------------------++ '-FOR(IMSID(imsid))-' +-OPTION(REFRESHPSB-+---------------+-)-|F|-+ '-,NOCHECK-' '-OPTION(UPDATEPSB-----|D|----)----|F|--------+ D-+-------------+-----+----------+--<> '-,DELPENDERR-' '-,NOCHECK-' F-+-FOR(IMSID())---<> NAME() Specifies one or more 1-8 character names of database DBD and/or program PSB resources to import from the staging directory to the active directory. Wildcard names can be specified. The name is a repeatable parameter. If the NAME parameter specified is a specific name or a wildcard name, command responses are returned for all the resource names that are processed. NAME is an optional parameter, and if not specified, it defaults to NAME(*). Duplicate names are ignored. For example, IMPORT DEFN SOURCE(CATALOG) NAME(DB1,DB2*,PSB1,PSB2%%) is a valid combination of DBD and/or PSB name parameters. When NAME(*) is specified, all of the ACBs in the staging directory are imported. This is equivalent to IMPORT DEFN SOURCE(CATALOG) command with no NAME keyword. If you specify NAME(*), it is not supported with any other NAME parameters. If one or more database DBD and/or program PSB resources specified with the NAME() keyword result in an error or are not found, none of the resources are imported and the command fails. All the resources associated with the database DBD and/or program PSB resources specified on the NAME() keyword are also imported, except for GSAM. For GSAM DBDs and PSBs, only the named GSAM DBDs and PSBs are imported. If the associated PSB resources do not exist in the staging directory, the import command will fail. For example, if a DBD is in the staging directory, any of its index databases, logically related databases (including secondary index) and PSBs that are also in the staging directory will be imported. For example, if a PSB is in the staging directory, any of the database DBDs it references that are also in the staging directory will be imported. When OPTION(NOCHECK) is specified, only the resources specified on the NAME keyword are imported. Add new return / reason codes to the IMPORT DEFN SOURCE(CATALOG) command, for the new NAME() keyword support. IMPORT DEFN SOURCE(CATALOG) adds return code x'00000008' with reason code x'00002133'. Reason code x'00002133' means that the IMPORT DEFN SOURCE(CATALOG) command is not processed because one or more DBD and/or PSB ACBs names were specified with the NAME keyword, in addition to a NAME of *. If NAME(*) is specified, the asterisk must be the only NAME parameter. Table 4 Add the following : Completion Completion Meaning code code text ---------------------------------------- 10 NO RESOURCES DBD or PSB name is invalid, FOUND or the wildcard name doesn't match any DBD or PSB names in the staging directory. 246 OPEN STAGING During processing of the IMPORT DIRECTORY DEFN FAILED SOURCE(CATALOG) command, IMS was unable to open the IMS staging directory data set for update. 247 DESERV FAILED The IMPORT DEFN SOURCE(CATALOG) command failed issuing a z/OS DESERV request to retrieve system managed directory entries (SMDE) for all members of the staging directory. The error text contains the module name that detected the error (8 characters), and the DESERV return code (8 characters).
Temporary fix
Comments
REPINNED RP20/01/23 (ATXT) TO ADD POSTREQ PH21311 INFO. **** PE20/01/23 PTF IN ERROR. SEE APAR PH21311 FOR DESCRIPTION ×**** PE20/01/23 FIX IN ERROR. SEE APAR PH21311 FOR DESCRIPTION ×**** PE20/01/23 FIX IN ERROR. SEE APAR PH21311 FOR DESCRIPTION ×**** PE20/01/23 FIX IN ERROR. SEE APAR PH21311 FOR DESCRIPTION ×**** PE20/01/23 FIX IN ERROR. SEE APAR PH21311 FOR DESCRIPTION ×**** PE20/01/23 FIX IN ERROR. SEE APAR PH21311 FOR DESCRIPTION
APAR Information
APAR number
PI83433
Reported component name
IMS V15
Reported component ID
5635A0600
Reported release
500
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2017-06-21
Closed date
2019-09-16
Last modified date
2020-03-16
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI65332
Modules/Macros
DFSCMDRR DFSCCTX0 DFSIP100 DFSMOLCW DFSOLC00 DFSOLC70 DFS3WILD
| GC27679400 | SC27678000 |
Fix information
Fixed component name
IMS V15
Fixed component ID
5635A0600
Applicable component levels
R500 PSY UI65332
UP19/09/19 P F909
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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSEPH2","label":"IMS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"15","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
22 December 2023