Execute the file with "--help" as an added switch for options.
But if you want more ... use a text editor on the file in question. don't take anybody else's word for it.
![Cool 8-)](./images/smilies/icon_cool.gif)
There are notes at the top which generally answer most question, and the sql queries and conditions upon which they run are IN the file. Have at it.
Also have a look in /usr/src/astguiclient/trunk/docs ... there are a lot of questions answered in this folder related to their associated scripts.