IBM Support

PH69067: IZPDB0012E error occurs during registration of a subsystem with less than three characters in the default attach name

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When attempting to register a subsystem with less than three
    characters in a default attach name, the registration will fail
    with the following error:
    
    "IZPDB0012E - 'EX' is not valid for key 'SSID' in JSON body.
    Usage: '3-4 alphanumeric characters, starting with a letter"
    
    The string 'EX' in the error message will be replaced by the
    default attach name of that subsystem.
    
    The solution to this problem was to change the regular
    expression of allowed strings for the default attach name from
    allowing 3-4 characters, to instead allow 1-4 characters. This
    new regular expression matches real character restrictions of
    this value on Db2.
    
    Affected users: Users of the Unified Management Server for z/OS
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of the IBM Unified Management Server   *
    *                 for z/OS and the following experiences:      *
    *                 - Db2 DevOps Experience for z/OS             *
    *                 - Db2 Administration Foundation for z/OS     *
    *                 - Db2 CI/CD Expert for z/OS                  *
    ****************************************************************
    * PROBLEM DESCRIPTION: IZPDB0012E error occurs during          *
    *                      registration of a Db2 subsystem with    *
    *                      less than three characters in the       *
    *                      default attach name                     *
    ****************************************************************
    When attempting to register a subsystem with less than three
    characters in a default attach name, the registration will fail
    with the following error:
    
    "IZPDB0012E - 'EX' is not valid for key 'SSID' in JSON body.
    Usage: '3-4 alphanumeric characters, starting with a letter"
    
    The string 'EX' in the error message will be replaced by the
    default attach name of that subsystem.
    
    The solution to this problem was to change the regular
    expression of allowed strings for the default attach name from
    allowing 3-4 characters, to instead allow 1-4 characters. This
    new regular expression matches real character restrictions of
    this value on Db2.
    

Problem conclusion

  • Apply the PTF
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH69067

  • Reported component name

    UNIFIED MGMT SV

  • Reported component ID

    5698UM100

  • Reported release

    120

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-11-20

  • Closed date

    2025-12-12

  • Last modified date

    2026-01-02

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

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

Modules/Macros

  • IZPB0001 IZPDAJ   IZPDB2SD IZPDPROV IZPHLOSD IZPHLVSD IZPIFI
    IZPIMSSD IZPIVP   IZPJOBMT IZPMNFST IZPPAUX  IZPSEC   IZPSERVE
    IZPSYSSD IZPUI    LRVTUPD  UMSSEC
    

Fix information

  • Fixed component name

    UNIFIED MGMT SV

  • Fixed component ID

    5698UM100

Applicable component levels

  • R120 PSY UO06219

       UP25/12/19 P F512

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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"120"}]

Document Information

Modified date:
02 January 2026