Introduction

The JS7 - Lock Instruction specifies mutually exclusive jobs, i.e. it limits parallel execution of jobs. Resource Locks in a workflow are used to limit job access to resources and to force orders to wait before executing a job. Orders wait until the Resource Lock is released by other jobs holding the Resource Lock. There are two types of Resource Locks available with JS7:

• Exclusive Resource Lock: only one Lock Instruction can hold the Resource Lock at any given time. Any further Lock Instructions that try to acquire the same Resource Lock have to wait.
• Shared Resource Lock: the Resource Lock is assigned a limit that can be shared by a number of Lock Instructions. Each Lock Instruction carries a weight that counts towards the Resource Lock's limit.

Workflow

In the jdSharedLockSerial workflow a Shared Resource Lock is used. In the workflow, the Resource Lock has a limit to the number of times it can be shared across Lock Instructions. In the workflow, parallel execution is performed by Shared Resource Locks within the limit assigned to the Resource Lock.

To execute the workflow in the folder 06_MutualExclusion please follow the steps described below:

1. Click the folder 06_MutualExclusion and expand the jdSharedLockSerial workflow.
   
   
   
   
2. To add an order to the workflow click the action menu of the workflow and use Add Order from the drop-down menu.
   
   
   
   
3. When clicking Add Order a popup window will appear.
4. You can add an Order ID or leave the Order ID value empty, it will then use a default Order ID. Click the Submit button.
5. If you add a second order to the workflow, you can see that the Resource Locks are acquired and retained by the jobs executing the first order and that any jobs for the second order have to wait until the Resource Locks are released.
   
   
   
   
6. To check the status of the order click the name of the workflow. This will make the Order History panel appear.
   
   
   
   
7. From the Order History panel you can verify if the order is successful and has finished. Click the Order ID to see log output created by jobs executed for this order.
   
   
   
   
8. A log view window will open and the order log will be displayed. This log contains output to stdout/stderr from all jobs executed by the order.
9. You can download the log file by clicking the Download button in the upper right-hand corner of the log view window. Also, you can expand and collapse all job output using the chevron icons in the upper left-hand corner of the log view window.