Changes

PhoneHome is enabled by default, but will not happen on every run.  Each run generates a random number (seeded by time).  PhoneHome will only occur if the random number modulo 100 is less than the [[#Adjust the Frequency of Phone Home (--phoneHomeThinning)|thinning parameter]].

PhoneHome is enabled by default, but will not happen on every run.  Each run generates a random number (seeded by time).  PhoneHome will only occur if the random number modulo 100 is less than the [[#Adjust the Frequency of PhoneHome (--phoneHomeThinning)|thinning parameter]].

PhoneHome can be completely disabled by using the [[#Turn off PhoneHome (--noPhoneHome)|<code>--noPhoneHome</code>]] option.

PhoneHome can be completely disabled by using the [[#Turn off PhoneHome (--noPhoneHome)|<code>--noPhoneHome</code>]] option.

* argument names - the argument names you specified, but NOT any user specified value

* argument names - the argument names you specified, but NOT any user specified value

* version number - the version of the tool you are running (hard coded at compile time)

* version number - the version of the tool you are running (hard coded at compile time)

* random number - a random number for this run (seeded by time), helps link the version check phonehome with the completion status phonehome.

* random number - a random number for this run (seeded by time), helps link the version check PhoneHome with the completion status PhoneHome

* [[#Adjust the Frequency of Phone Home (--phoneHomeThinning)|thinning parameter]] - percentage of time the the tool is configured to report back (0-100), default is 50

* [[#Adjust the Frequency of PhoneHome (--phoneHomeThinning)|thinning parameter]] - percentage of time the the tool is configured to report back (0-100), default is 50

* return status - 0 (success), Exception, or Error (it will not include a description of the exception/error)

* return status - 0 (success), Exception, or Error (it will not include a description of the exception/error)

=== Turn off PhoneHome (<code>--noPhoneHome</code>)  ===

=== Turn off PhoneHome (<code>--noPhoneHome</code>)  ===

Use the <code>--noPhoneHome</code> option to completely disable phone home.  PhoneHome is enabled by default based on the [[#Adjust the Frequency of Phone Home (--phoneHomeThinning)|thinning parameter]].

Use the <code>--noPhoneHome</code> option to completely disable PhoneHome.  PhoneHome is enabled by default based on the [[#Adjust the Frequency of PhoneHome (--phoneHomeThinning)|thinning parameter]].

=== Adjust the Frequency of Phone Home (<code>--phoneHomeThinning</code>)  ===

=== Adjust the Frequency of PhoneHome (<code>--phoneHomeThinning</code>)  ===

By default, when PhoneHome is enabled (default), it only happens a certain percentage of the time.

By default, when PhoneHome is enabled (default), it only happens a certain percentage of the time.