IBM Support

PH69922: THE VALUE FUNCTION FAILED WHEN THE LENGTH OF IMSPLEX NAME OR IMSID IS LESS THAN THE MAXIMUM NUMBER OF CHARACTERS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The value function failed when users try to invoke
    Administration Tool ISPF under any of the following conditions:
    - The length of IMSPlex name is less than five characters
    - The length of IMS ID is less than four characters
    
    Error message:
    ATY$AIMQ REXX ERROR 40 IN LINE 827: Incorrect call to routine
    x = value('PLX'plexname)
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of IMS Administration Tool for z/OS    *
    *                 (FMID=HALC110).                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: The value function failed when the      *
    *                      length of IMSPlex name or IMS ID is     *
    *                      less than the maximum number of         *
    *                      characters.                             *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    ****************************************************************
    The value function error occurs, when users try to start IMS
    Administration Tool ISPF under any of the following conditions:
     - The length of IMSPlex name is less than five characters
     - The length of IMS ID is less than four characters
    

Problem conclusion

  • IMS Administration Tool has been modified to handle short
    IMSPlex names and IMS IDs correctly.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH69922

  • 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-02-01

  • Closed date

    2026-02-17

  • Last modified date

    2026-03-02

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

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

    UO06838

Modules/Macros

  • ATY$AIMQ ATY$BCMP ATY$BRSC ATY$CCMD ATY$CMDQ ATY$I200 ATY$I2D0
    ATY$MCD0 ATY$MRP1 ATY$MRP2 ATY$MRP3 ATY$SDBK ATY@OBJU
    

Fix information

  • Fixed component name

    IMS ADMIN TOOL

  • Fixed component ID

    5655CAT00

Applicable component levels

  • R110 PSY UO06838

       UP26/02/19 P F602

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:
02 March 2026