A fix is available
APAR status
Closed as program error.
Error description
IMS Administration Tool does not substitute '&RGSUF.' in IMS control region JCL with a DFSPB member suffix. Therefore, it cannot construct the DFSPB member name and terminates with message ATY3117E.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of IMS Administration Tool for z/OS * * (FMID=HALC110). * **************************************************************** * PROBLEM DESCRIPTION: IMS Administration Tool issues message * * ATY3117E and terminates because it * * cannot resolve the DFSPB member name. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** IMS Administration Tool cannot generate the DFSPB member name when the variable specified for the DFSPB member suffix in IMS CTL region JCL ends with a period. As a result, the tool terminates with message ATY3117E.
Problem conclusion
IMS Administration Tool has been modified to correctly generate the DFSPB member name when the variable specified for the DFSPB member suffix in IMS CTL region JCL ends with a period.
Temporary fix
Comments
APAR Information
APAR number
PH71807
Reported component name
IMS ADMIN TOOL
Reported component ID
5655CAT00
Reported release
110
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2026-06-17
Closed date
2026-07-06
Last modified date
2026-07-08
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UO08498
Modules/Macros
ATY#BRGN
Fix information
Fixed component name
IMS ADMIN TOOL
Fixed component ID
5655CAT00
Applicable component levels
R110 PSY UO08498
UP26/07/08 I 1000
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":"BU048","label":"IBM Software"},"Product":{"code":"SSCD9F6","label":"IMS Administration Tool"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]
Document Information
Modified date:
08 July 2026