looking a few lines below my code, the KI interface uses a separate function if the last 2 params are required. i dont think we need to bloat the code just for completeness-- if someone desires to use that API function they can easily add it. but for my purposes, i will not be using it and probably never will