OperationsGUI

Open JobScheduler Operations Center

The JobScheduler Operations Center (JOC) of the JobScheduler is used to monitor and control the jobs, job chains and orders.
You open JOC in a browser with the URL:

  http://[scheduler_host]:[scheduler_port] (e.g. http://localhost:4444) 

where scheduler_host and scheduler_port
are the hostname and the TCP port number of the JobScheduler.

Configuration via custom.js

The configuration file custom.js for JOC is stored in the ./config/operations_gui directory.

For releases < 1.3.9 you find the custom.js in the ./config/html directory.

In the custom.js are some variables which are defaults when the site is loaded but can be overwritten via cookies.

The custom.js of version 1.3.9 contains the following variables:

Cookie Behaviour

Possible values are true and false.

If false then almost all following variables are stored in cookies, so that these settings are only default values and will be overwritten via the cookies.

If true then only filters are read from cookies whereat the defined correspondent filters in this file have priority.

 _disable_cookie_settings = false;

Language

Set the interface language.
A language file scheduler_lang_sos_lang.js_ (i.e. scheduler_lang_ru.js for Russian) must exist.

The language files are stored in the ./operations_gui directory beside the ./bin directory.

For releases < 1.3.9 you find the language files in the ./config/html directory.

If this value is empty then no language files are included and English is used.

At this time 'de' (German), 'fr' (French) and 'ru' (Russian) are supported.

 _sos_lang                = '';

If you want a user-defined language setting then look to the example below.

Automatically Refresh

Possible values are true and false.
If true then the periodically update is on.

 _update_periodically     = false;

Interval between the periodically updates in seconds.

 _update_seconds          = 5;

Views

You can switch between the tabs 'jobs', 'job_chains', 'process_classes' and 'last_activities' as the beginning view.

 _show_card               = 'jobs';

For some tabs you can set the default view mode (list or tree).

 _view.jobs               = 'list';
 _view.job_chains         = 'list';

Checkboxes, Radios And Selectboxes

You can specify which checkboxes are on (true) or off (false).

 _checkbox_states.show_tasks_checkbox            = true;
 _checkbox_states.show_job_chain_orders_checkbox = true;
 _checkbox_states.show_job_chain_jobs_checkbox   = false;
 _checkbox_states.show_order_history_checkbox    = false;
 _checkbox_states.show_task_error_checkbox       = false;
 _checkbox_states.show_error_checkbox            = false;

You can specify the value of some radios.

The possible values for last_activities_radios are 'all', 'orders' and 'tasks'.

 _radio_states.last_activities_radios = 'all';

You can specify the value of some selectboxes.

The possible values for show_jobs_select are 'all', 'standalone' and 'order'.

The possible values for jobs_state_select are 'all', 'running', 'stopped', 'running_or_stopped' and 'other'.

 _select_states.show_jobs_select      = 'all';
 _select_states.jobs_state_select     = 'all';

Number Of Displayed Orders Or Tasks Resp.

You can set how much orders are shown in the job chains if the checkbox show orders are checked.

 _max_orders              = 10;

You can set how much orders and tasks are shown in the last activities tab.

 _max_last_activities     = 30;

Number Of History Entries

Per default the last 50 entries are shown from the orders history and last 10 from the tasks history respectively.

 _max_order_history       = 50;
 _max_task_history        = 10;

Timeout For Terminate

In the top menu you find a terminte with timeout. Here you set the timeout in seconds.

 _terminate_timeout       = 60;

Default For 'Start at'

In start task/order at dialogs are set the start time equals now per default. You can omit this.

 _start_at_default_is_now = true;

Start Task Unforced Now

Enables the additional job menu item Start task unforced now.

 _start_next_period_enabled  = false;

Debug Level

Possible values are 0-9.

A new window will be open to write the debug information. A popup blocker should allow this.

 _debug_level             = 0;

Additional URLs In 'Extras' Menu

You can add arbitrary URLs to the popup menu of the extras button on the top in the form:

 _extra_urls[ 'display name' ] = 'url';

For an example of use see below.

Aliase

You can set an URL mapping for the remote schedulers if i.e. an Apache proxy configuration is used.

For more information about proxy configuration see 'How to operate JOC with an Apache Proxy?'.

Set an alias in the form:

 _url_aliase[ 'remote_host:remote_port' ] = 'url';

Filters

For more information see 'How to store filters persistently that would not disappear after cleanup of cookies?'.

You can set filters for jobs, job chains and order in the form

 _job_filter[ 'filter name' ]       = 'regular expression';
 _job_chain_filter[ 'filter name' ] = 'regular expression';
 _order_filter[ 'filter name' ]     = 'regular expression';

or use

 _project_filter[ 'filter name' ]   = 'regular expression';

which is effective for jobs, job chains and orders simultaneously.

A selectbox will be displayed with the filter names.
To set which selectbox option is selected you can use

 _active_job_filter                 = 'name of the filter';
 _active_job_chain_filter           = 'name of the filter';
 _active_order_filter               = 'name of the filter';

or

 _active_project_filter             = 'name of the filter';

User-defined Configuration via my_custom.js

While the configuration file custom.js (see above) for JOC is always read,
you can create an additional own configuration file i.e. my_custom.js to overwrite the settings in custom.js.

The file my_custom.js is read when you type the URL

 http://[scheduler_host]:[scheduler_port]/index.html#my_custom 

The name of the user-defined configuration file is arbitrary and must be stored in the same directory like custom.js.
You can add multiple files as the following example 1.

Example 1

The language of JOC is per default English, but some users want JOC in, for example, Russian or in French.
Create the file ru.js with the content:

 _sos_lang           = 'ru';

and create the file fr.js with the content:

 _sos_lang           = 'fr';

After this you get JOC in Russian if you type:

 http://[scheduler_host]:[scheduler_port]/index.html#ru

or:

 http://[scheduler_host]:[scheduler_port]/#ru) 

and you get it in French if you type:

 http://[scheduler_host]:[scheduler_port]/index.html#fr

or:

 http://[scheduler_host]:[scheduler_port]/#fr. 

You can extend the example with using _extra_urls (see example 2 below).

Example 2

After completing Example 1 above, add the follwoing to the custom.js datei:

 _extra_urls['english']       = 'http://[scheduler_host]:[scheduler_port]/index.html';
 _extra_urls['russian']       = 'http://[scheduler_host]:[scheduler_port]/index.html#ru';
 _extra_urls['french']        = 'http://[scheduler_host]:[scheduler_port]/index.html#fr';

If you now call JOC, you will find links for selecting the language in the right top Extras menu.

FAQs

See JobScheduler_FAQ