IBM Support

IJ08876: SETAGENTCONNECTION DOES NOT UPDATE MULTIPLE INSTANCES

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Setagentconnection does not update multiple instances
    Environment:
    630 FP7 Windows OS Agent
    Do you think the latest patch applied is involved?  No
    Problem Description:
    Executing the command setagentconnection against a Window's
    target where there are multiple Agent Instances and the Agent
    Owner field of an Agent Instance, as returned by the command
    Kincinfo -o is of the format DOMAIN\Owner will result in that
    Instance's configuration not updated.
    
    If the Agent's Instance Owner name is of the following format
    "NT AUTHORITY" the problem will not occur.
    
    Detailed Recreation Procedure:
    1. Install TEMS 630.FP7 and Windows OS Agent
    2. Install MS SQL Agent.
    3. Change the ownership of the MS SQL Agent to be AETH\S049373
    4. Execute the command
    
     tacmd setagentconnection -a -n <OS Agent MSN>
          -p SERVER=host1 PROTOCOL=IP.PIPE PORT=1918 BSERVER=host2
          BPROTOCOL=IP.PIPE BPORT=1918 BACKUP=Y
    5.  Observe that only the Agents whose Ownership is of the
        format NT AUTHORITY\SYSTEM" are correctly configured by the
        the command.
    
    Related Files and Output:
          To determine if the problem exists on the target system,
    execute the command kincinfo -o on the target system and observe
    whether the format of the Owners of the Agents matches the
    format DOMAIN\OwnerName.
    

Local fix

Problem summary

  • Setagentconnection does not update the connection settings for
    Agents with multiple instances.
    
    
    Executing the command setagentconnection against a Window's
    target where there are multiple Agent Instances and the Agent
    Owner field of an Agent Instance, as returned by the command
    Kincinfo -o is of the format DOMAIN\Owner will result in that
    Instance's configuration not being updated.  If the Agent's
    Instance Owner name is of the format "NT AUTHORITY" which
    includes a space character between the words NT and AUTHORITY as
    displayed by the kincinfo -o output,  the problem will not
    occur.
    

Problem conclusion

  • A code change has been made to reduce the minimum number of
    space character separated fields on the output line from
    kincinfo -o from nine to eight.
    
    
    The fix for this APAR is contained in the following maintenance
    packages:
    
       | service pack | 6.3.0.7-TIV-ITM-SP0002
    

Temporary fix

Comments

APAR Information

  • APAR number

    IJ08876

  • Reported component name

    TEMS

  • Reported component ID

    5724C04MS

  • Reported release

    630

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / Installability / Xsystem

  • Submitted date

    2018-08-30

  • Closed date

    2018-09-07

  • Last modified date

    2019-10-23

  • 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

    TEMS

  • Fixed component ID

    5724C04MS

Applicable component levels



Document information

More support for: IBM Tivoli Monitoring V6
ITM Tivoli Enterprise Mgmt Server V6

Software version: 630

Reference #: IJ08876

Modified date: 23 October 2019