IJ30784: INCONSISTENCIES IN "CLASSIFYING SOFTWARE (V2)" REST API CHAPTER

APAR status

• Closed as program error.

Error description

• Two adjustments need to be made to the "Classifying software
  (v2)" REST API chapter of ILMT documentation:
  
  https://www.ibm.c
  om/support/knowledgecenter/en/SS8JFY_9.2.0/com.ibm.lmt.doc/Inven
  tory/integration/r_put_software_instances_v2.html
  
  1)
  Under the
  "Parameters" section the "discoverable_guid" parameter needs to
  be specified as mandatory.
  
  2)
  Instruction should mention that
  the HTTP body payload (specified with the '--data' attribute)
  needs to be enclosed by the '{"rows":[...]}' envelope. It is
  required because the REST API v2 for classifying software
  expects an array of JSON objects, even if there is just one
  entry to be processed.
  
  TS004660505
  

Local fix

• Exemplary correct PUT statement syntax with cURL:
  
  curl -X PUT
  -k
  https://hostname:9081/api/sam/v2/software_instances?token=xxx
  --data '{"rows":[{"verbose":"1","is_charged":"0","metric_id":"xx
  x","product_release_guid":"xxx","discoverable_guid":"xxx,"comput
  er_dns_name":"xxx","instance_id":"xxx"}]}'
  

Problem summary

• ****************************************************************
  *****************
  ERROR DESCRIPTION:
  
  Two adjustments need to be made to the "Classifying software
  
  (v2)" REST API chapter of ILMT documentation:
  
  
  
  https://www.ibm.c
  
  om/support/knowledgecenter/en/SS8JFY_9.2.0/com.ibm.lmt.doc/Inven
  
  tory/integration/r_put_software_instances_v2.html
  
  
  
  1)
  
  Under the
  
  "Parameters" section the "discoverable_guid" parameter needs to
  
  be specified as mandatory.
  
  
  
  2)
  
  Instruction should mention that
  
  the HTTP body payload (specified with the '--data' attribute)
  
  needs to be enclosed by the '{"rows":Ý...¨}' envelope. It is
  
  required because the REST API v2 for classifying software
  
  expects an array of JSON objects, even if there is just one
  
  entry to be processed.
  
  
  
  TS004660505
  
  ****************************************************************
  *****************
  * EXPECTED RESULTS:
  * The issue does not occur.
  ****************************************************************
  * RECOMMENDATION: Apply appropriate update when available.
  ****************************************************************
  

Problem conclusion

• The fix for this APAR is contained in the following maintenance
  packages:
   | Update | ILMT 9.2.23.0
  ****************************************************************
  

Temporary fix

Comments

APAR Information

• 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

  LIC METRIC TOOL

• Fixed component ID

  5724LMTEM

Applicable component levels