Introduction

The "Token Reactivate Notification Service" task periodically checks if DeviceID tokens are about to need reactivation will send out notification messages to the users if required.

The notifications that are sent are based on the parameters specified in the DeviceID policy setting parameters in the "Reactivate" section of the policy (see below);

The task can be found by navigating to "Administration | Tasks", then scrolling down to the task "Token Reactivate Notification Service";

Task Parameters

The task parameters are used by the task script to determine which tokens are to be deleted and are edited by left clicking on the context menu of the task and selecting "Parameters";

A new window titled "Task Parameters" will now open that lists the parameters making them available for editing, and the default parameters for this task are as follows;







Specify the computer name of the server the task is to be run on,





Specify the correct "application" that you are using for the Exchange ActiveSync..





If you have multiple DualShield backend servers, then you need to specify the computer name of the server that will run this task

Select the parameter "Server" then click the  button, and a new window titled "Parameter - Edit" will open;

At the prompt "Name", enter the machine name of the server where the task will be running, then click  to update the parameter.

Editing and Scheduling the Task

Viewing and Editing the task

By default, the task is not enabled, but may be enabled by left clicking on the context menu of the task and selecting "Edit";

A new window will now open titled "Task - Edit";







Enter the name to be assigned to the task within the management console.





Enter a description of what the task will do.





The version number of the task.





This field is used to specify when the task is scheduled to executed.





This field will determine if the task schedule is enabled (if enabled the task will execute at the scheduled time).





Specifies how many times the task should be repeated after the task is executed.






import com.deepnet.das.token.TokenAssignment
import com.deepnet.das.token.Product
import com.deepnet.das.exception.ProductNotFoundException

// this task will only be executed on specified server
if(server && ! InetAddress.getLocalHost().getHostName().equalsIgnoreCase(server)){
setEndMessage("Task execution has been bypassed")
return;
}

// currently, only check DeviceID product
def product = Product.findByAlgorithm('DNS/ASDID')
if(!product){
throw new ProductNotFoundException()
}

// find all ACTIVE token assignments of product
def query = {
eq('status', 'ACTIVE')
token{
eq('product', product)
}
}

def count = TokenAssignment.createCriteria().count(query)
def criteria = TokenAssignment.createCriteria()
def scrollable = criteria.scroll(query)
def notified = 0

while(scrollable.next()){
def tas =  scrollable.get(0)
if(tas.reactivateNotice(application))
notified++
onProgress(count, "Tokens checked:  " + count)
}

setEndMessage("Sent notice to tokens: " + notified + "/" + count)





Scheduling the Task

Select the "Enable Schedule" checkbox to ensure the task schedule is activated, then use the pencil icon ("")  to specify the time and frequency settings for automated task execution.

Manual Task Execution

The task can be run manually from the management console by left click on the context menu of the task, then selecting "Run";

A new window will open titled "Execute Task" will then open (the window will be populated with the default task property settings);

Ensure the parameters "Execute On Server" and "Application" contains the computer name of the server the task is to be run on, and the name of the corr3ect application that you are using for Excahange ActiveSync, then click the  button.