IBM Support

VM66314: UNEXPECTED RETURN CODE FROM XAUTOLOG COMMAND

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • In some situations, when an ESM is being used, the XAUTOLOG
    command fails and returns an unexpected return code.
    
    This can cause programs like SMAPI to report
    unexpected errors when activating a z/VM userid.
    

Local fix

  • N/A
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of z/VM with an External Security  *
    *                 Manager (ESM).                               *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    ****************************************************************
    * RECOMMENDATION: APPLY PTF                                    *
    ****************************************************************
    When a user is being logged on to the z/VM system which utilizes
    an External Security Manager (ESM) and an error occurs, the
    error message might not be displayed. This may be noticed by a
    program which issues the XAUTOLOG command, such as the z/VM
    Systems Management Application Programming Interface (SMAPI).
    In this case the program may see an invalid response code four,
    which is not expected by SMAPI, resulting in an undocumented
    return code for the programming interface, such as the
    Image_Activate API.
    

Problem conclusion

  • HCPLGA is fixed to ensure that the proper error message is
    displayed when an External Security Manager (ESM) indicates a
    failure during the logon process.
    

Temporary fix

Comments

APAR Information

  • APAR number

    VM66314

  • Reported component name

    VM CP

  • Reported component ID

    568411202

  • Reported release

    640

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-08-09

  • Closed date

    2019-10-07

  • Last modified date

    2020-12-16

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

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

    UM35547 UM35548

Modules/Macros

  • HCPLGA   HCPLGNBK
    

Fix information

  • Fixed component name

    VM CP

  • Fixed component ID

    568411202

Applicable component levels

  • R640 PSY UM35547

       UP19/10/16 P 2001

  • R710 PSY UM35548

       UP19/10/16 P 2001

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG27M","label":"APARs - z\/VM environment"},"Platform":[{"code":"PF054","label":"z\/OS"}],"Version":"640","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]

Document Information

Modified date:
12 January 2021