With the Admin Center Java Batch tool, you can
view the progress and status of your Java™ batch
jobs.
Before you begin
To use the Java Batch tool, you must enable the tool in Admin Center and have batch jobs to view:
- Ensure that the configuration file for the server that runs Admin Center has the following Liberty features:
- adminCenter-1.0
- batchManagement-1.0
- Add the Java Batch tool to your dashboard. See Customizing the Toolbox.
- Create and deploy a Java batch application and then submit batch jobs. The database of batch
jobs must be persisted. See Deploying Java batch applications in Liberty.
- If the job logs do not reside on the server that runs Admin Center, configure CORS on the remote server to enable
Admin Center to request job logs from the remote server.
See Configuring Cross Origin Request Sharing on a Liberty server.
About this task
View and filter your Java batch jobs by using the Java Batch tool.
Procedure
- Customize the dashboard.
- Select the number of job instances to display.
![[16.0.0.4 and later]](../ng_v16004.gif)
By
default, the dashboard displays 100 updated job instances, with the most recent displayed first.
From the dashboard footer, select the maximum number of job instances to display. Choices include
50,
100,
500, and
1000.
Tip: If the selection is 1000 and the job instance you want
to examine is not shown in the dashboard,
change the
filter options.
- Select the columns of job information to display.
Job information includes the batch job name
and ID, the application name, the job submitter, the date of the last update, and the job instance
state. You can choose the columns to display.
- Select Column Selection
.
- From the list, select the columns that you want displayed. Clear the columns that you don't want
displayed.
- View job executions.
- Hover over a Batch Job Name and expand the twistie
.
- Select the job execution ID number to view details about the job.
The job execution details page shows details about job steps and partitions. Partitions are
indicated by Partitions
.
- To view details about another job execution, you can change the number on the URL. For example, if you change 2 in the URL to 4, you can view Job Execution ID 4 without using
the interface. See the change in the following
URLs:
https://host_name:port_number/adminCenter/#javaBatch/jobexecutions/2
https://host_name:port_number/adminCenter/#javaBatch/jobexecutions/4
- Select Column Selection
to display more or less information about the job execution.
- View a log file for a batch job.
- Select View log file
.
- From the Log view footer, you can select Top of Logs and End
of Logs arrows to view lengthy log files.
- Select Download to download the log file.
- Filter information about job instances.
By default, the tool lists job instances of all states. You can set up numerous search criteria
options. If you search by using the same criteria, such as two instance states, the criteria are
filtered as or operators. If you filter by using different criteria, such as one
instance state and one instance ID, the criteria are filtered as and operators. To
change the information that is displayed, change the search criteria:
- Select Add Search Criteria
.
- From the list of search filter criteria, select one of the following options and specify a value:
- Instance State to display job instances that have one of following
states:
- All to display job instances with the most recently updated appearing
last
- Queued to view all instances of Submitted, JMS Queued, and JMS Consumed
states. Or select Submitted, JMS Queued, and
JMS Consumed individually.
- Dispatched
- Ended filters for all instances with Failed, Stopped, Completed, and
Abandoned states. Or select Failed, Stopped,
Completed, and Abandoned individually.
- Instance ID to display a job instance with the specified job execution
ID.
- Last Update to display job instances with the specified date.
JES Job Name to display job
instances with the specified job name.
JES Job ID to display job
instances with the specified job ID.
- Select Search
to run your query.
To clear your query, select Clear Search Field
.
What to do next
To refresh the current page, select Refresh
.
To return to the dashboard, select Dashboard
.