Show TOC

Background documentationAdvanced Job Search Locate this document in the navigation structure

 

To allow you to search overviews quickly, a job search box, named intelliSearch, has been implemented. This search is able to use the following phrases as criteria:

  • numbers - jobs ids

  • times - of requested start, run start, and run end time

  • remote - remote information

  • names - names of queues, process servers, job descriptions or job definitions

Prefixes are available to restrict the amount of results, all searches are case-insensitive.

Using Numbers

Any number is assumed to be a job id.

For example, 111 would display the job with job id 111. If this job is part of a job chain, the job will be shown expanded in the containing job chain. When searching on job id, the job(s) will also always be selected.

Times

Searches for all jobs between a specified time. The search-criteria has to be specified in 24h times. If no prefix is used, the search is done on all three times:

  • requested start time

  • run start

  • run end

There are different ways of searching by time:

The time is specified using the following codes: seconds (s), minutes (m), hours (h), weeks (w), months (M), and years (y).

  • hh:mm - without a range, the default range is +/- 15 minutes.

  • hh:mm:ss - without a range, the default range is +/- 1 minute.

  • hh:mm-hh:mm or hh:mm:ss-hh:mm:ss - range is from start time to end time.

  • hh:mm~nn{s,m,h,d,w,M,y} - the number indiated by nn defines a range.

  • hh:mm~now or hh:mm~ - if you use now in the range, or leave one blank, the current time is used.

For example, 22:00-23:00 would show all jobs that have one of the three times in the range of 22:00-23:00 and 22:00~90m would result in all jobs that have one of the three times in the range of 20:30-23:30 to get listed.

When you want to specificy a specific time, use a prefix.

Prefixes

  • q, requested - Requested start time

  • s, runstart - Run Start time

  • e, runend - Run End time

For example, runend:22:00-23:00 would restrict the above example to show only jobs which have a Run End Time in the specified range and q:22:00~90m would restrict the above example to display jobs which have a Requested Start Time in the specified range.

Remote

Allows you to query for jobs that run on remote systems with information of the remote system.

The following prefixes are available:

  • rid, remoteid - the remote id.

  • rsys, remotesystem - the remote system

  • rstat, remotestatus - the remote status of the job

For example, rid:A12S34H3 would display the job which has the remote id A12S34H3 and remotestatus:error would display all jobs that have the remote status error.

Names

When a string is entered without a prefix, the search is done in the following order.

  1. If the search string matches a queue name, return the results for queue matches

  2. if the search string matches an SAP queue name. return the results for SAP queue matches

  3. if the search string matches an SAP process server, return the results for SAP process server matches

  4. if the search string matches a process server name, return the results for process server matches

  5. if the search string matches a job definition name, return the results for job definition, matches

  6. if the search string matches a application name, return the results for application matches search for a partial or complete match of the job name (description).

Prefix

The following prefixes are available

If you want to search for a specific name, you can use one of the following prefixes.

  • q, queue - find jobs from a queue

  • sapq - find jobs that run in an SAP System queue

  • sapps - find jobs that run on an SAP System process server

  • ps, processserver - find jobs that run on a process server

  • jd, jobdefinition - find jobs from a job definition

  • a, application - find jobs from an application

  • j, jobname - find jobs with a job name

  • bg - include background jobs, default is false

For example, q:System would display all jobs are in the queue named System and jobdefinition:System_Info would display all jobs of the job definition System_info.

You can also specify multiple combinations of the above, when you specify more than one queue, for example, jobs of all specified queues will be displayed. For example, PR1_Queue PR2_Queue PR3_Queue q:QA4_Queue would display all jobs from the four queues PR1_Queue, PR2_Queue, PR3_Queue, and QA4_Queue. q:PR1_Queue PR2_Queue PR3_Queue ps:PR1_ProcSerVer would for example display all jobs that are on the specified process server as well as in the specified queues.

Note Note

Job descriptions can contain spaces, to specify a name with spaces, use double quotes (").

End of the note.

Note Note

A search on jobid, jobdefinition or jobname does not need a bg:true, because these automatically include all jobs that match the search criteria.

End of the note.

Note Note

If a specific search returns no results, the overview will be empty.

End of the note.