RMVHSTJS (Remove History using Job Scheduler)
Note: To use this command, have the 5722-JS1 (Job Scheduler for iSeries) licensed program installed.
RMVHSTJS Command syntax diagram
Purpose
The Remove History using Job Scheduler (RMVHSTJS) command allows you to remove history from the Job Scheduler job history file by specifying the amount of history you want to keep or remove. You can specify whether you want to keep a number of job history occurrences or you can remove history entries based on a date range that you specify.
Optional Parameters
- RMVTYPE
- Specifies how entries are to be selected from the Job Scheduler history log.
*OCCUR: History file entries are kept based on the number of occurrences specified in the NBROCCUR parameter.
*DAYS: History file entries are kept based on a date range specified in the SLTDATE parameter.
- NBROCCUR
- Specifies how many job history occurrences are to be kept in the history file. The number of occurrences begins with the oldest (earliest date) occurrence and progresses to the most recent. Occurrences can range from 1 to 999.
180: The number of occurrences for a job to be kept in the file is 180.
number-of-occurrences: Specify the number of occurrences for a job that are to be kept in the file.
- SLTDATE
- Specifies the range of dates that you want to remove from Job Scheduler history information. The From date is the beginning point in the Job Scheduler history file and the To date is the ending point.
Element 1: From date
*BEGIN: Uses the earliest Job Scheduler history entry as the beginning point into the Job Scheduler history.
*CURRENT: Uses the current date as the beginning entry point into the Job Scheduler history.
from-date: Specify the date in job date format with or without date separators, that is, 12/01/99 or 120194, that you want to be the beginning date of the range of dates.
number-of-days: Specify a number to represent the number of days before the current day that you want to use for the search. An example would be 10. If today's date were 3/12/99 (date format is mm/dd/yy), the From date for the Job Scheduler history file would be 3/2/99.
Element 2: To date
180: The number of days of history that remains is 180.
*CURRENT: Uses the current date as the ending date of the date range.
*END: The last date in the history file is used as the ending date for the date range.
to-date: Specify the date with or without date separators, that is, 12/01/99 or 120199, that you want to use as the ending date of the date range.
number-of-days: Specify a number to represent the number of days before the current day that you want to use for the search. An example would be 10. If today's date were 3/22/99 (date format is mm/dd/yy), the To date for the Job Scheduler history file would be 3/12/99.
Example for RMVHSTJS
Example 1: Removing All but 60 Days of History Information
RMVHSTJS RMVTYPE(*DAYS) SLTDATE(*BEGIN 60)In this example, 60 days of history information is kept. Information from the beginning of the history information that is older than 60 days is removed.
Error messages for RMVHSTJS