DTD Element / Attribute

Description

job-definitions

The root element of this deployment descriptor. It contains additional information about one or more job definitions.

job-definition

This element contains additional information about one job definition.

Used in: job-definitions.

Contains: name, description, and retention-period.

name

The name of the job definition. The value of this attribute has to be the same as the value of the message selector specified in the JobBean class. The job definition is displayed with this name in Job Management in the SAP NetWeaver Administrator.

Used in: job-definition.

description

A free text description of the job definition. The description is displayed in Job Management in the SAP NetWeaver Administrator.

Used in: job-definition.

retention-period

Determines the default number of days, for which the job logs are persisted in the database.

The possible values are:

●      Positive number (n)

Keep the job for the specified n days.

●      0

Do not keep the job logs

●      -1

Keep the job logs forever.

When you create a scheduler task, you can change the default retention period specified in the job-definition.xml.

Used in: job-definition.

job-definition-parameter

This element contains additional information about job parameters.

Used in: job-definition.

Contains: name, data-type, nullable, description, data-default, display, direction, and group.

Used in: job-definition-parameter

name

The name of the parameter. The parameter name you specify here has to be the same as the name you specify for the parameter in the JobBean class.

Used in: job-definition-parameter

data-type

The type of data passed by the parameter. The supported data types are: string, float, double, integer, long, Boolean, date, and properties.

Used in: job-definition-parameter

nullable

Defines whether the parameter must be specified when a scheduler task is created for the job definition. The possible values are:

●      Y  

The parameter has to be specified.

●      N

The parameter does have to be specified.

If you do not specify a value, the element takes N as its default value.

Used in: job-definition-parameter

description

A free text description of the parameter. The description is displayed in the Scheduler Administrator.

Used in: job-definition-parameter.

data-default

The default value that the parameter takes if no value is explicitly specified when a scheduler task is created for the job definition.

Used in: job-definition-parameter.

display

Specifies whether the parameter appears in the user interface when the job is scheduled. The possible values are:

●      Y

The parameter is displayed.

●      N

The parameter is not displayed.

Used in: job-definition-parameter.

direction

Specifies whether the parameter is incoming or outgoing for the job. The following directions are possible:

●      IN

The parameter is passed to the job. The parameter value provides input for the job to process.

●      OUT

The parameter is passed from the job. The parameter value is the job’s output.

●      INOUT

The parameter is passed to the job, the job processes it, and then passes it out.

The values of all parameters from the execution of each job instance are stored in the database. The parameter values from a job execution are not overwritten with the parameter values from successive job executions.

For example, if a job that has OUT parameters runs twice, the values of the OUT parameters for each of the two job executions is persisted. The value of the OUT parameter from the second job execution does not overwrite the value of the OUT parameter from the first job execution.

Used in: job-definition-parameter.

group

To improve readability, job parameters can be grouped in Job Management in the SAP NetWeaver Administrator. This property defines the group in which a parameter shows in Job Management.

Used in: job-definition-parameter.