Field Descriptions

Table Information

FAQs

Monitor Job Status

What can I do in this screen?

This screen displays the status of a specific queue and information on the Costpoint web jobs that the queue contains.

This screen is similar to the Job Queues screen (Administration\Maintain\Job Management), which is often restricted to system administrator access because of the ability to also create new queues, change the status of existing queues, and update any jobs waiting for execution on the job server.

This screen consists of two blocks, Identification and Scheduled Jobs, that display simultaneously, as follows:  

Note:  You can only edit submitted jobs in this screen.

You cannot enter new jobs in this screen.  New jobs should be submitted to the queue using the Submit Job to Queue screen (Administration\Transactions\Job Management).

You can update or delete jobs previously sent to the queue if "Aborted," "Hold," or "Scheduled" displays in the Status field. When a job is being executed through the job server, the Status field displays "Executing" and you cannot edit that job.

After you update or delete jobs in this screen, save the screen to retain your changes.

If the job has not executed successfully (as a result of application server failure), the Status field in this screen will display "Aborted."

Note:  The system automatically changes the job status to "Aborted" if the application fails as a result of server failure. Any jobs with a status of "Executing" will be set to "Aborted" when a server is brought up after failure.
 

When should I use this screen?

You must first create a job in the Jobs screen (Administration\Maintain\Job Management).  You must also submit a job to the queue via the Submit Job to Queue screen (Administration\Transactions\Job Management) before it will display in this screen.  Use Query to select the desired queue.

If you send a job to the queue and its status is "Scheduled," the scheduled time and date determine when the job is executed on the job server.

FAQs

What steps should I follow to submit a job to the job server?

  1. Selection Parameters

Create and save the screen selection parameters to be used in the individual computation, process, or report application(s).

  1. Job Groups (Optional)

If you want to organize your jobs into groups (for organizational purposes only), you should first create job groups in the Job Groups screen (Administration\Maintain\Job Management).

  1. Jobs

Set up the details of the specific job in the Jobs screen (Administration\Maintain\Job Management), including the name, description, and how the job should behave if an application task fails.

You must also enter one or more application tasks to be executed in the job as well as the parameter ID for each specific task.

  1. Submit Job to Queue 

Use the Submit Job to Queue screen (Administration\Transactions\Job Management) to select the timing parameters and specify the queue.

Click on the Submit to Queue pushbutton.

Which screens can I use to monitor and report on my jobs?

  1. Job Report screen

Run the job report from this screen to review the jobs you have created in Costpoint web.  This report lists the parameter ID(s) and sequential application(s) associated with each job.

  1. Monitor Job Status screen

Use the Monitor Job Status screen (Administration\Transactions\Job Management) to view the job information and the status of jobs scheduled for a specific job queue.

Note:  You can only edit submitted jobs in this screen.

  1. Update Job Queue List Status screen

Use the Update Job Queue List Status screen (Administration\Transactions\Job Management) to make a queue active or inactive on the job server and to allow a new queue to be recognized when the job server is already running.

  1. Process and Report Status Inquiry screen

Use the Process and Report Status Inquiry screen (Administration\Review\Job Management) to view job status by application.

  1. Print/Purge Job History screen 

Use the Print/Purge Job History screen (Administration\Utilities\Job Management) to print and/or purge the history of jobs that have been previously executed on the job server.

Which job screens are normally the responsibility of a system administrator?

  1. Job Queues screen

The system administrator will normally create the job queues for jobs to run in and can manage all job queues from this screen (Administration\Maintain\Job Management\Job Queues) based on the display of queue status and specific job information.

  1. Start/Stop Job Server screen

The system administrator will normally manage the job server operation from this screen (Administration\Transactions\Job Management\Start/Stop Job Server) via the Start, Stop, and Reset pushbuttons and the Daily Shutdown Time and Daily Restart Time fields.

Job queue activation/deactivation can also be controlled from this screen.

Field Descriptions

Identification

Use the fields in this block to select the job queue, specify whether jobs should be run sequentially, and to view whether the queue is active or inactive on the job server.

Job Queue

This non-editable field displays the job queue ID of the queried record.

Process Sequentially

This non-editable checkbox displays whether the queried job queue is processed sequentially.

Active for Server

This non-editable field displays "Y" if this queue is active for the server and "N" if this queue is not active for the server.

Scheduled Jobs

Use the fields in this table window block to view the details of scheduled jobs and to make selective edits.  Only submitted jobs are editable in this screen.  

Job

This non-editable field displays the job ID of each job that has been submitted to the queue.

Description

This non-editable field displays the description of the job ID that displays in the Job field.

The description for this job was set up with the job in the Jobs screen (Administration\Maintain\Job Management).

Status *

The current status of the job ("Scheduled," "Hold," "Executing," or "Aborted") displays in this field.

To execute a job, select "Scheduled" in this field and enter the scheduled date and time.

If you change the Status field from "Scheduled" to "Hold," the system will automatically clear data from the Start Date and Start Time fields after the record is saved.

If you change the Status field from "Hold" to "Scheduled" and you have not entered a start date or time, the system will automatically display the current date and time as a default in from the Start Date and Start Time fields after the record is saved.

Start Date

Enter, or use Calendar Lookup to select, the scheduled date on which to execute this job on the job server.

If you selected the "Start Time/Date" execution option from the Execution Option drop-down box in the Submit Job to Queue screen (Administration\Transactions\Job Management), the system automatically displays that date in this field, where it can be edited, if desired.   

If you enter data in this field OR in the Start Time field, entry in both fields is required.  

If you change the Status field from "Scheduled" to "Hold," the system will automatically clear data from the Start Date and Start Time fields after the record is saved.

If you change the Status field from "Hold" to "Scheduled" and you have not entered a start date or time, the system will automatically display the current date and time as a default in from the Start Date and Start Time fields after the record is saved.

Start Time

Enter the scheduled time at which to execute this job on the job server.

If you selected the "Start Time/Date" execution option from the Execution Option drop-down box in the Submit Job to Queue screen (Administration\Transactions\Job Management), the system automatically displays that time in this field, where it can be edited, if desired.  

Use the standard hh:mm:ss AM/PM format, where hh = hour, mm = minute, and ss = second.

If you enter data in this field OR in the Start Date field, entry in both fields is required.  

If you change the Status field from "Scheduled" to "Hold," the system will automatically clear data from the Start Date and Start Time fields after the record is saved.

If you change the Status field from "Hold" to "Scheduled" and you have not entered a start date or time, the system will automatically display the current date and time as a default in from the Start Date and Start Time fields after the record is saved.

Recur Every

If this is to be a recurring job, enter the number (of hours, days, weeks, or months), as appropriate, to specify when this job should recur after it has been initially executed on the job server.

Choose the frequency of recurrence in the drop-down box to the right of this field.  Select "Hours," "Days," "Weeks," or "Months."

If you enter data in this field OR in the Recurring Timeframe field, entry in both fields is required.  

Recurring Timeframe

Select the frequency of recurrence from these drop-down box options:  "Hours," "Days," "Weeks," or "Months," as applicable.

If you enter data in this field OR in the Recur Every field, entry in both fields is required.  

End Date

Enter, or use Calendar Lookup to select, the date at which the recurring job should end.  This field is only available for recurring jobs.

If you enter data in this field OR in the End Time field, entry in both fields is required.  

End Time

Enter the scheduled time at which to end the recurring job on the job server. This field is only available for recurring jobs.

If you enter data in this field OR in the End Date field, entry in both fields is required.  

Use the standard hh:mm:ss AM/PM format, where hh = hour, mm = minute, and ss = second.

Submitting User

This non-editable field displays the user ID of the user who submitted the job to the queue.

Submitted Date/Time

This non-editable field displays the date and time that the job was submitted to the queue.

* A red asterisk denotes a required field.

Table Information

This screen accesses data from the following tables: JOB_QUEUE (Job Queue) and JOB_SCHEDULE (Job Schedule).

 

Top of Page