taskman

checks out a license token and manages interactive UNIX applications

Synopsis

taskman -R “rusage[token=number[:duration=minutes | hours h] [:token=number[:duration=minutes | hours h]]...] [-Lp project] [-N n_retries] [-v] command
taskman [-h | -V]

Description

Runs the interactive UNIX application on behalf of the user. When it starts, the task manager connects to License Scheduler to request the application license tokens. When all the requested licenses are available, the task manager starts the application. While the application is running, the task manager monitors resource usage, CPU, and memory, and reports the usage to License Scheduler. When the application terminates, the task manager exits.

By default, a license is reserved for the duration of the task, so the application can check out the license at any time. Use the duration keyword if you want unused licenses to be reallocated if the application fails to check out the license before the reservation expires.

Options

command

Required. The command to start the job that requires the license.

-v

Verbose mode. Displays detailed messages about the status of configuration files.

-N n_retries

Specifies the maximum number of retry attempts taskman takes to connect to the daemon. If this option is not specified, taskman retries indefinitely.

-Lp project

Optional. Specifies the interactive license project that is requesting tokens. The client must be known to Platform License Scheduler.

License project limits do not apply to taskman jobs even with -Lp specified.

-R “rusage[token=number [:duration=minutes | hours h] [:token=number [:duration=minutes | hours h] ] ...]

Required. Specifies the type and number of license tokens to request from License Scheduler. Optionally, specifies a time limit for the license reservation, expressed as an integer (the keyword h following the number indicates hours instead of minutes). You may specify multiple license types, with different duration values. Separate each requirement with a colon (:). Enclose the entire list in one set of square brackets.

-h

Prints command usage to stderr and exits.

-V

Prints the License Scheduler release version to stderr and exits.