batchtaskman - Batch Job Task Manager

Display usage:

batchtaskman -h

List task information:

batchtaskman dataarea [--exec [l|g]] [-C] -l [steps] [-o i|n] [-t task|--filter filterstring] [-a|-f fieldname[:size],...] [-s fieldname=size,[fieldname=size,...]]

Delete a task:

batchtaskman dataarea [--exec [l|g]] -d -t task

Delete a task step:

batchtaskman dataarea [--exec [l|g]] -d -t task -S step

Update a task:

batchtaskman [dataarea] [--exec [l|g]] -u [datafile] [-T action | stream | java] -t task -f fieldname=value[,...]

Create a task and optionally schedule:

batchtaskman [dataarea] [--exec [l|g]] -c [datafile [-T action | stream | java] -f fieldname=value[,...] [--schedule [--schedfields fieldname=value[,...]] [-z timeZone]

Create a task step (where -p value is a task stream type task):

batchtaskman [dataarea] [--exec [l|g]] -c -p parent -t task

Schedule a task:

batchtaskman dataarea [--exec [l|g]] --schedule -t task [-f fieldname=value[,...]]

Show fields:

batchtaskman dataarea [--exec [l|g]] --showfields

batchtaskman manages system batch tasks. Tasks contain the definition of the business class/task and action that will be performed, as well as the data required for the action.

Program Option Description
dataarea Specify the data area that the task is associated with.
-h Show syntax for the utility.
--exec l | g Specify the executor (local or grid) to use to run the batch operation. Grid is the default.
-u|-l-|c|-d

Specify the mode that the utility runs in. Use:

-u to update task information.

-l (lowercase L) to list task or step information.

-c to create a new task.

-d to delete a task or task step.

steps

Optional, for list mode only.

Specify to list task steps. Requires use of -t also.

-C

Optional, for list mode only.

Show the results in a column layout. A row layout is the default.

-a|-f fieldname[:size],...

Optional, for list mode only.

Use -a to show all fields. The default is to show all normally in-use fields. This typically excludes CLOBS and BLOBS.

Use -f to show only the specified fields.

For row layouts, the field name may be trailed by a colon and the size of the field (:size). This size will override the field's default display size.

If the size is specified here, you do not need to use the -s option.

-s fieldname=size,[fieldname=size,...]

Optional, for list mode in row layouts only.

Override field display sizes with a specified size.

-f fieldname=value[,...]

For update or create mode.

Specify the value for a field that will be used to determine which jobs are updated.

-o i|n

Optional, for list mode only.

Specify sort order. Use

i to sort by task or step ID

n to sort by task name (not valid for a step listing)

-t task Specify the ID of a task.
-S step

Optional, for delete or update mode.

Specify the ID of a task step.

-T action|stream|java

For update and create modes.

Specify a task type. Use

action to create a business action type (the default for create).

java to create a Java task type.

stream to create a task stream.

-p parent

Optional, for create mode only when creating a task step.

Specify a parent task. The parent must be a valid Task Stream type task.

--schedule Use to schedule a task. Note that within a create it is optional to specify a task.
--showfields Show the available fields.
-z timeZone Use to specify a time zone when scheduling a task.
-v displayoptions

errorlevel, tracelevel, and verbose specified in any order, where:

  • errorlevel = {n}one | {f}atal | {e}rror | {w}arning (warning is the default)

  • tracelevel = 0:6 where 0 is no message and 6 is everything

  • verbose = whether to display exception stacktrace

Example: List all tasks in name order

batchtaskman sourcing -l -o n

where

This Option Is
sourcing The data area the tasks belong to.
-l Indicates that a list of tasks is requested.
-o n Specifies a sort order by task name.