Contents of the Print/Purge Job History Screen

Use the fields and options to configure the Print/Purge Job History screen.

Identification

Use the fields in this block to create a new parameter ID or to retrieve a previously saved parameter ID. A parameter ID represents a set of screen selection parameters. After you have saved a parameter ID and its related parameters, you can retrieve them using Query.

You can use the retrieved parameters to produce reports and run processes more efficiently and with greater consistency. The saved parameters are also useful and necessary when you want to run the process as part of a batch job. Many users save a unique set of parameters for each different way they run a report or process. When you select a previously saved parameter ID or parameter description, the associated saved screen selection parameters automatically display as selection defaults. The page setup and print options, if there are any, are also included in the saved parameter ID. You can change any of the associated selection defaults as necessary.

Field Description
Parameter ID

Enter, or click to select, a parameter ID of up to 15 alphanumeric characters. Choose characters for your parameter ID that help identify the type of selections you made on the screen, such as PERIOD or QUARTERLY.

When you save your record, all the selections made on the screen are stored with the parameter ID. Later, you can retrieve the parameter using Query.

You can use the parameter to run the process more efficiently because you can select the parameter ID with its previously defined screen selections. After the default selections display on the screen, you can override the defaults.

Description

Enter, or click to select, a parameter description of up to 30 alphanumeric characters.

Selection Ranges

Use this block to select the information associated with the jobs you want to purge, as applicable.

Field Description
Job

Use this drop-down box to select the range of jobs you want to purge for this process. The following options are available:

  • All: Select this option to include all available records. The Startand End fields are disabled for if you select this option.
  • One: Select this option to include only one record. You must enter that value in the Start field. The End field is disabled if you select this option.
  • Range: Select this option to include a contiguous range of records. You must enter the beginning value for the range in the Startfield and the ending value of the range in the Endfield.
  • From Beginning: Select this option to include all the records from the beginning of the available records to a specific record in the range. You must enter the last value for the range in the Endfield. The Start field is disabled if you select this option.
  • To End: Select this option to include all the records from a specific record to the end of all the available records. You must enter the value from which the range should begin in the Startfield. The End field is disabled if you select this option.

The default selection for this field is All. If you have a large number of jobs, you may not want to use this default option.

Submitting User

Use this drop-down box to select the range of submitting users you want to use for this process. The following options are available:

  • All: Select this option to include all available records. The Startand End fields are disabled for if you select this option.
  • One: Select this option to include only one record. You must enter that value in the Start field. The End field is disabled if you select this option.
  • Range: Select this option to include a contiguous range of records. You must enter the beginning value for the range in the Startfield and the ending value of the range in the Endfield.
  • From Beginning: Select this option to include all the records from the beginning of the available records to a specific record in the range. You must enter the last value for the range in the Endfield. The Start field is disabled if you select this option.
  • To End: Select this option to include all the records from a specific record to the end of all the available records. You must enter the value from which the range should begin in the Startfield. The End field is disabled if you select this option.

The default selection for this field is All. If you have a large number of jobs, you may not want to use this default option.

Start Date

Use this drop-down box to select the range of start dates you want to use for this process. The following options are available:

  • All: Select this option to include all available records. The Startand End fields are disabled for if you select this option.
  • One: Select this option to include only one record. You must enter that value in the Start field. The End field is disabled if you select this option.
  • Range: Select this option to include a contiguous range of records. You must enter the beginning value for the range in the Startfield and the ending value of the range in the Endfield.
  • From Beginning: Select this option to include all the records from the beginning of the available records to a specific record in the range. You must enter the last value for the range in the Endfield. The Start field is disabled if you select this option.
  • To End: Select this option to include all the records from a specific record to the end of all the available records. You must enter the value from which the range should begin in the Startfield. The End field is disabled if you select this option.

The default selection for this field is All. If you have a large number of jobs, you may not want to use this default option.

Completion Date

Use this drop-down box to select the range of completion dates you want to use for this process. The following options are available:

  • All: Select this option to include all available records. The Startand End fields are disabled for if you select this option.
  • One: Select this option to include only one record. You must enter that value in the Start field. The End field is disabled if you select this option.
  • Range: Select this option to include a contiguous range of records. You must enter the beginning value for the range in the Startfield and the ending value of the range in the Endfield.
  • From Beginning: Select this option to include all the records from the beginning of the available records to a specific record in the range. You must enter the last value for the range in the Endfield. The Start field is disabled if you select this option.
  • To End: Select this option to include all the records from a specific record to the end of all the available records. You must enter the value from which the range should begin in the Startfield. The End field is disabled if you select this option.

The default selection for this field is All. If you have a large number of jobs, you may not want to use this default option.

Start

Use this field to enter, or use to select, the starting job group, as applicable.

End

Use this field to enter, or use to select, the ending job group, as applicable.

Options

Use this group box to specify additional options you want to use for this process.

Field Description
Days Prior to Current Date

Use this field to enter the number of days prior to the current date to purge, based on the job completion date. The completion date is stored as the ACT_COMPLETE_DTT field in the JOB_SCHEDULE_HIST table.

All processes, reports, and/or computations that fall within that range and that also meet your other selection criteria (jobs, submitting users, start dates) will be printed and/or purged.

For example, if the current date is 3-14-05, if a job completed on 12-31-04, and you specify 60 in this field, the application will print and/or purge job server history data in the range from the current date out to the number of days prior to the current date.

     Current Date:  3-14-05

     Data in JOB_SCHEDULE_HIST table, ACT_COMPLETE_DTT field:

          12-03-04

          12-16-04

          2-15-05

          3-14-05

     Days Prior to Completion:  

          1-26:        3-14-05

          27-87:      3-14-05, 2-15-05

          88-100:    3-14-05. 2-15-05, 12-16-04

          101:         3-14-05, 2-15-05, 12-16-04, 12-02-04

Note: If you select any range option other than Allin the Completion Date field, you must not use this field. Costpoint will display an error message if you try to enter data for both the Completion Date selection field and this field.