Description
Generate a Shelf Life token that can be read in by an application at runtime.
Task Specific Parameters
| Attribute | Description | Required |
|---|---|---|
| key | The Shelf Life key file you received from PreEmptive. | Yes |
| file | The file that will receive the newly generated token. | Yes |
| date | The absolute date on which the token will expire in MM/DD/YYYY format. Mutually exclusive with period. | No; if period is specified. |
| period | The number of days from a start date before the token will expire. The start date is provided by the application at runtime. Mutually exclusive with date | No; if date is specified. |
| warningdate | The absolute date on which expiration warnings should start in MM/DD/YYYY format. Mutually exclusive with warningperiod. | No |
| warningperiod | The number of days from the expiration date on which expiration warnings should start. Mutually exclusive with warningdate | No |
General Parameters
| Attribute | Description | Required |
|---|---|---|
| append | If true the file specified by output and error will have output appended rather than being overwritten. | No; defaults to false |
| dashohome | The location of DashOPro.jar. See Setting DashO Home for details. | No |
| dir | The directory where the process will be invoked. | No; defaults to the basedir of the buildfile. |
| error | Name of a file to which to write the error output. (Error messages print to the error output) | No |
| errorProperty | Name of a property in which to store the standard error output. (Error messages print to the standard error output) | No |
| failonerror | If true stops the buildprocess if the process exits with a returncode other than 0. | No; defaults to true |
| if | Execute only if the named property has been set. | No |
| jvm | The command used to invoke the Java Virtual Machine. The command is resolved by java.lang.Runtime.exec(). |
No; default is java. |
| maxmemory | Max amount of memory to allocate to the process. | No |
| newenvironment | If true the old environment settings will not be propogated when new environment variables are specified. | No; defaults to false. |
| output | Name of a file to which to write the output of the process. | No |
| outputProperty | Name of a property in which to store the standard output. | No |
| printstacktraces | If true stack traces will be printed for errors. | No; defaults to false. |
| quiet | If true output will be terse. | No; defaults to false. |
| resultproperty | The property name which will contain the return code from the task. | No |
| timeout | Stop the process if it doesn't finish within the specified time in milliseconds. | No |
| unless | Execute only if the named property has not been set. | No |
| verbose | If true additional information will be printed. | No; defaults to false. |
Parameters specified as nested elements
property
Use nested <property> elements to add name/value pairs to the token. These values can be retrieved at runtime.
arg and jvmarg
Use nested <arg> and <jvmarg> elements to specify arguments to DashO and the JVM respectively.
See Command line arguments.
sysproperty
Use nested <sysproperty> elements to specify system properties required by DashO.
This tag uses the same syntax as <env>: see the <exec> task for details.
env
Use nested <env> elements to add or replace environment variables passed to the process.
See the <exec> task for details.
Example
<property name="user" value="YOYODYNE PROPULSION"/>
<property name="option1" value="true"/>
<target name="make-token">
<generate-token key="my-key.slkey" file="tokens/${user}.txt"
date="12/31/2019"
warningperiod="90">
<property name="UserName" value="${user}"/>
<property name="option-one-on" value="${option1}"/>
</generate-token>
</target>
