Schedule triggers that are sent from an external script

The HCL® Marketing Software Scheduler can respond to triggers sent by an external application. The scheduler_console_client utility enables this feature. This utility issues triggers that can launch one or more schedules set up to listen for that trigger.

Because scheduler_console_client is a batch script application, it can be called by external applications, possibly using another batch script.

For example, if you set up a schedule that is listening for a trigger "T1," you could run the scheduler_console_client utility with the following command to send the T1 trigger: scheduler_console_client.bat -v -t T1

The utility can provide the following information.

  • A list of the schedules that are configured to listen for any given trigger.
  • Whether it has successfully sent the trigger. Note that the utility cannot report whether the schedule that is listening for the trigger executed successfully. That information is available on the scheduler management pages.

You can not use this utility to set up a schedule to listen for a trigger or to modify a trigger for which a schedule is listening. You must perform these actions in the scheduler user interface.

Example script

Here is an example of a script to that causes the scheduler_console_client utility to issue the string "example_trigger". This trigger would set off a run of a schedule set up to listen for "example_trigger".

You could call a script like this from an external application when that application generates an event.

The example script assumes that the script is in the same directory as the utility.

@rem*****************************************************
@rem This script is used to call the Marketing Platform
@rem scheduler_console_client.
@rem*****************************************************

echo Now starting scheduler trigger.
set JAVA_HOME=c:\jdk15_12
call scheduler_console_client.bat -v -t example_trigger

@rem*****************************************************

Security considerations

Scheduling within the enterprise applications is considered to be an administrator's activity. It is assumed that any user who has execute permission in the host operating system for the scheduler_console_client utility is also authorized to issue triggers.

To prevent any user from using this utility to issue a trigger, you should revoke execute permission for the scheduler_console_client utility for that user.