Accessing the Job Explorer view

To access the Job Explorer view, perform the following steps:

1. Click View > Open View > Job Explorer.
   Or
   Press Ctrl+J to open the panel. 
2. In the panel view, click JOB EXPLORER. You can see the search container in the Job Explorer panel. if the search container is not visible, click . 
   Select any one of the following options to search for the jobs:
   • Show Search by Prefix/Owner
   • Show Search by Job ID

3. If you have selected Show Search by Prefix/Owner, in the Prefix field, enter the prefix to search available output. An asterisk wildcard character can be used. If you have selected Show Search by Job ID, in the Job ID field, enter the job ID and search for the specific job.

   Important

   • If no HCI connection is present and you click Search or the connect icon (), DevX Explorer prompts with the error message No HCI Connection Exists and shows the Create HCI Connection option. You can click Create HCI Connection to create an HCI connection. For more information to create an HCI connection, see Creating-HCI-connection.
   • When a single HCI Connection is present, by default that connection will get selected.
   • When multiple HCI Connections are present, you can view the quick pick with the list of HCI connections. You can select the required HCI connection. While accessing the jobs if you wish to change the HCI connection, you can click the connect icon () present in the top-right corner of the panel view and select the required HCI connection. 

4. In the Owner field, enter the job owner name to search available output. An asterisk wildcard character can be used and click Search.
   The list of jobs is displayed. You can see the job count in the status bar.

   The default job limit is 500. If the number of jobs is more than the default value, you will see the following notification.

   

   Important

   As explained in the notification message, you can set the job limit by clicking Settings > Limit number of jobs.

   You can see the following fields for the jobs.  

   • Job: Job name
   • Job ID: Job number
   • Owner: Owner information
   • Status: The status of the job. For example, Hold and Executing.
   • Max RC: Return code of completed tasks
   • Class: STC, TSU, or Batch indicator
   • Programmer: JES2 programmer name
   • Submit Time: Time the job was read in
   • End Time: Time execution ended
   • Position: The position of the job in the JES queue, if available. The position is equal to what SDSF displays, however, it will not usually have a non-zero value for jobs awaiting execution. This field is helpful when the execution job is being monitored while it is waiting for the initiator.
   • Start Time: Time execution began
   • CPU%: The percentage of CPU used by the job
   • CPU Time: The amount of CPU time used by the job
   • System: System name of the execution jobs

   • EXCPs: The jobs EXCP count

     Important

     • You can click the above fields and sort them in ascending or descending order.
     • You can hide or show columns of the Job Explorer panel from Settings.
       

     On selecting a job, you can also view the following information about the job:

     • Records: Number of Lines in the file.
     • Step: The environment where the lines got executed.
     • DSID: File generation id. Unique id to identify the Job output file.

You can perform the following actions for the jobs:

Open a job

Double-click any field of the selected job row, and it will open the job file (<jobName>_<jobId>.jes) in the editor in READ-ONLY mode.
Or
Right-click on any field of the selected job and select Open. This will also open the job file in the editor in READ-ONLY mode.

Refresh a job

Right-click any field of the selected job and select Refresh. This refreshes the status of the selected job.

Cancel a job

Select a single or multiple jobs, right-click, and then select Cancel. This action cancels the executing jobs.

Extract a Job JCL

1. Right-click any field of the selected job and click Extract Job JCL.
2. The submitted JCL for that job is displayed in the editor.
3. If you want to edit the JCL, then edit as required and submit the JCL from View > Command Palette > Workbench Explorer: Submit JCL from Active Editor.
   It will submit the JCL with updated contents, but the original JCL will not change.
   

Resubmit a job

Resubmit job dynamically extracts the JCL and resubmits the job.

Right-click a job and click Resubmit. You will be able to resubmit the job for all statuses.

On re-submitting a job, you will see a notification message as Job <Job ID> submitted. If you click the Job ID, it searches the Job ID and shows the connection name of the Job ID.

You will receive a job completion notification once the job is completed or errored out or completed with a warning. You can click the Open Job Output option to see the details.

View Data Definition of the job

Click each job to fetch the job's Data Definition (DD).

Refresh the job explorer table

Click present in the top-right corner of the panel view to refresh the explorer table. The job explorer table will get the latest updates based on the search criteria (prefix or owner details).

Purge job

You can purge one or multiple jobs.

To purge one or multiple jobs

1. In the Job Explorer panel, search for jobs.
   The list of jobs is displayed.

2. (For Single job) Right-click a row and click Purge.
   
   
   

   Important

   If you want to purge multiple jobs, select multiple rows, right-click and click Purge.
   
   
   

3. Click Yes to purge the job.
   The status of the respective job gets changed to Purge command issued.  

4. Right-click the job and click Refresh. That job will be removed from the job list. If you click Cancel, the status of the respective job remains unchanged.
   
   
   
   

   Important

   Sometimes, if you do not have access to purge that job, a notification message is displayed as Purge request can not be issued for job <jobId>: <errorMessage>. In this case, the status of the job will not change.