Previous Topic: ExampleNext Topic: Example


listJobs—List Jobs Related to Target Computer

This action lists those jobs, which are related to the system identified in the name parameter. An additional filter can be specified to restrict the list to only those jobs that fulfill the filter criteria. If no filters are given the complete list of jobs is shown. The filter is limited to100 bytes.

This action has the following format:

targetcomputer action=listjobs
name = computer_name 
[{alt |
[{filter=filter|filterfile=file_name}]]
alt

An alternative output list is provided.

An alternate list is provided based on the item name and version only.

In case of coding this parameter the value of the item and version parameter might contain database supported wild cards, for example,

"%"

for an arbitrary, even empty sequence of characters

"_"

for an arbitrary single character

For Microsoft SQL Server also the square brackets ("[","]") have a special meaning. This has to be taken into account when coding the name.

filter

Specifies the expression to confine the amount of information listed

The following attributes are valid to build atomic filter expressions:

Attribute

Type

Job name

String

Job state

{UNDEFINED | WAITING | DELIVERY_ORDERED | DELIVERING | DELIVERY_OK | DELIVERY_ERROR | ALREADY_DELIVERED | EXECUTION_ORDERED | EXECUTING | EXECUTION_OK | EXECUTION_ERROR | UNDELIVERY_ORDERED | UNDELIVERING | UNDELIVERY_OK | UNDELIVERY_ERROR | ALREADY_INSTALLED | MANIPULATION_NOT_ALLOWED}

Item name

String

Item version

String

Item type

{SOFTWARE | DOCUMENT | PROCEDURE | UNSEALED ITEM | ENABLED ITEM | DETECTED ITEM | ARCHIVED ITEM}

Procedure name

String

Ordered by

String

Error message

String

Error cause

Long

Comment

String

Computer installation procedure

String

Creation date

Sdate

Creation time

Stime

Activation date

Sdate

Activation time

Stime

Completion date

Sdate

Completion time

Stime

filterfile

Specifies the name of the file that contains the filter commands.

The commands in the file are specified in the same way as in the filter parameter, but the size of the file is limited by the capacity of the system that runs this command.

name

Specifies the name of the computer of which the jobs will be shown.