Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The JITL CheckLicenseJob template can be used to monitor if the automate monitoring of the JS7 - License is about to expire or is expired expiration.

...

  • invoke the Wizard that is available from the job properties Job Properties tab in the Configuration view and select the JITL CheckLicenseJob and relevant arguments from the Wizard

...

  • Optional Arguments
    • validity_days : Specifies the number of days for which the license should be valid.
      • The job will terminate with return code 3 if the license will expire within the given number of days.
      • The job will terminate with return code 2 if the license is expired.
  • Note that the the check box provided with each argument has to be selected the argument is to be added to the arguments of the CheckHistoryJob template.

...

The Job Documentation including the full list of arguments can be found from: https://www.sos-berlin.com/doc/JS7-JITL/CheckHistoryJobCheckLicenseJob.xml

Anchor
arguments
arguments
Arguments

...

NameRequiredDefault ValuePurpose
validity_dateyesnon/a60

Specifies ...the number of days for which the license should be valid. 

Anchor
return_variables
return_variables
Return Variables

The CheckHistoryJob template returns the following variables:

Return VariableData TypePurposeExample
,,,BooleanReturns ....

subject

String

Returns ...

bodyString

Returns ... 

Job Dependencies

returnCodenumber

Signals the license check result:

  • Return code 3 signals that the license will expire within the given number of days.
  • Return code 2 signals that the license is expired.


subjectstring

The subject for an e-mail that can be send from a subsequent job:

  • For return code 3 the subject variable  holds the following value:
    • JS7 JobScheduler Notification: license expiration warning
  • For return code 2 the subject variable  holds the following value:
  • JS7 JobScheduler Notification: license expired


bodystring

The body for an e-mail that can be send from a subsequent job. The body return variable holds the output of the CheckHistoryJob  job.

.. Licence tpye: COMMERCIAL_VALID
.. license valid: true
.. License valid from: Wed May 05 12:22:41 GMT 2021
.. License valid to: Mon May 04 12:22:41 GMT 2026

Alert Workflow

The CheckLicenseJob template can be used to implement a workflow to alert about license expirationThe CheckHistoryJob template can be used to implement backward job dependencies:

  • Jobs based on the CheckHistoryJob template do not fail if the underlying query does not return results.
  • Instead, the CheckHistoryJob template provides Return Variables that can be inspected to determine further execution of jobs in a workflow.
  • JS7 offers the JS7 - If Instruction to check the values of Return Variables and to decide what instructions to execute next.

...