BS2000 Jobs

Use BS2000 Jobs to run scripts on BS2000 platforms and to define how runtime options, reports and protocols must be processed. BS2000 Jobs can run independently or they can be added to a Job Group (JOBG) or to a Workflow. For more information about the integration between the Automation Engine and BS2000, see Java EE/JMX Agent.

Defining BS2000 Jobs

A BS2000 Job definition is made up of the following pages:

• Standard pages that are always available, no matter what type of object you are defining:
  • General Page
  • Version Management Page
  • Documentation Page
• Additional pages that are always available for executable objects:
  • Process Pages
  • Attributes Page
  • Output Pages
  • Variables Page
  • Prompt Sets Page
  • Rollback Page
• The BS2000 page described here.

Runtime Options Section

• Priority

  The priority with which the job should be executed. It is a value between 1 and 255, where 1 is the highest and 255 the lowest priority.

  Note: The priority does not affect the processing order of tasks, it only serves to define their starting order. The task with the higher priority is started first. For tasks with the same priority, the Fist In/First Out (FIFO) principle applies.

• Maximum CPU Time

  Maximum CPU time (in seconds) that is available for the job. If the value that is specified here is exceeded, the OS cancels the job, which then gets the ENDED_VANISHED status.

• Express

  If a batch limit has been defined on the agent, this can prevent the job from being started. Activate this checkbox to ignore this setting. As a result, the job is started immediately regardless of the batch limit.

• Job Class

  Maximum length: 8 characters

• Order Name

  Maximum length: 8 characters

• Enter Parameter

  You can specify any number of enter parameters separated by commas.

  The parameters that are allowed depend on the BS2000 version. A detailed description is available in the BS2000/OSD Commands manual under the /ENTER-JOB command.

  For example:

  TIME=NTL, RERUN-AFTER-CRASH=YES

  Parameters that have already been defined cannot be used again (max. CPU time, priority, express, job class, order name).

  Maximum length: 255 characters

Job Report Section

For information on the Job Report section, see Job Reports.

Freely Defined Port Numbers

Free port number are usually supplied in the DCSOF with the Freeport parameter. By default, the first free port number is 4096.

The BS2000 agent does not work with a fixed port number that is written in to its INI file, but it requests a free port number when it establishes a connection to the Automation Engine.

If the BS2000 agent is automatically loaded after a successful agent test start, make sure that its required free port number does not conflict with other settings.

Example

The test results in the following constellation:

1. An application that uses the 4096 port number via /BCMAP command is already running.
2. The BS2000 agent is started manually and obtains the next free port number (e.g. 4097).

In this case, both, the application and the agent work correctly.

After the tests, the BS2000 agent starts automatically and is loaded before the application. The BS2000 agent obtains the first free port number 4096.

As a result, the application to which this port number has been assigned on a fixed basis via a /BCMAP command cannot start.

See also:

Jobs (JOBS)