IBM Support

PH24083: BINARY CONFIG ZOS AGENTS FAIL TO RESTART AFTER THE UPGRADE

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • When the zOS agents are installed as Binary / Config and
    upgraded to UCD 7.0.4, the agents get upgraded successfully, but
    they fail to start after a restart.
    
    The encoding of the file in <agent directory>/bin folder is
    UTF-8, while it should be native encoding (EBCDIC). The
    environment variables inside the agent file are also not
    replaced with right values and remain as Tokens.
    
    Following is the error that is seen in the UCD Agent Job in
    spool:
    
    BPXM047I BPXBATCH FAILED BECAUSE SPAWN (BPX1SPN) OF
    
    <AGENT_HOME>/agent FAILED WITH RETURN CODE
    00000082 REASON CODE 0B1B0C27.
    

Local fix

  • There is no local fix. The binary agent has to be upgraded again
    with the patched agent and then the config agents have to be
    restarted again for them to get upgraded.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All zOS customers who use binary / config agent and are      *
    * upgrading to UCD 7.0.3 / UCD 7.0.4 from previous version     *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * When the zOS agents are installed as Binary / Config and     *
    * upgraded to UCD 7.0.4, the agents get upgraded successfully, *
    * but they fail to start after a restart.                      *
    *                                                              *
    * The encoding of the file in <agent directory>/bin folder is  *
    * UTF-8, while it should be native encoding (EBCDIC). The      *
    * environment variables inside the agent file are also not     *
    * replaced with correct values and remain as Tokens.           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    

Problem conclusion

  • Request fixed agent installer from support or upgrade to UCD
    7.1.0.0 version
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH24083

  • Reported component name

    UC DEPLOY

  • Reported component ID

    5725M5400

  • Reported release

    704

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-04-06

  • Closed date

    2020-07-01

  • Last modified date

    2020-07-01

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

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

Fix information

  • Fixed component name

    UC DEPLOY

  • Fixed component ID

    5725M5400

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS4GSP","label":"IBM UrbanCode Deploy"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"704","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
02 July 2020