Previous Topic: ExampleNext Topic: Example


listFailedJobs—List Failed Jobs

This action lists all failed jobs of the specified job container. A filter can be specified to confine the amount of failed jobs listed.

This action has the following format:

jobcontainer action=listFailedJobs
name=job_container_name 
{[{filter=filter|filterfile=file_name}] 
[TV] | TV alt}
alt

Provides an alternate - more detailed - list in target view.

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.

name

Specifies the name of the job container to be listed, however, only failed jobs will be listed.

filter

Specifies the expression to confine the amount of information listed.

The atomic expressions for building filter expressions correspond to those of the listjobs.

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..

TV

Adjust the view of the list:

none specified

job view

TV

target view

The information listed is of the same format as for "listJobs".