<generate-token>

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>