|
|
|
Modify a calendar definition.
The MODIFY command will change any of the fields that make up a calendar definition.
Windows/OpenVMS Format:
modify/calendar calendar_name [/qualifier = value]
UNIX/Linux Format:
chcal calendar_name [-qualifier = value]
/owner or -owner = uic
/protection or -protection = (s:rwed,o:rwed,g:rwed,w:rwed)
/comment or -comment= "any text string"
/[no]workdays or -[no]workdays [= noholiday, noweekend]
/flags or -flags= noholiday_runs, noweekend_runs
/fiscal or -fiscal= starting month
/date or -date= date to change
/mark or -mark = letter or letters
/[no]run or -[no]run
/standard_date or -standard_date
/log or -log
/confirm or -confirm
/node = target node
Windows:
Schedule> modify/calendar \mlevy\days /fiscal=july/log
Modified \mlevy\days
OpenVMS
Schedule> modify/calendar [mlevy]days /fiscal=july/log
Modified [mlevy]days
UNIX/Linux:
Schedule> chcal /mlevy/fun_days -fiscal=july -log
Modified [mlevy]fun_days
/comment or -comment="any text string"
The COMMENT qualifier is any useful description that you may want to add. This is an 80 character option.
/[no]confirm or -[no]confirm
CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.
/date or -date=date to change
The DATE qualifier is used to change a date on a calendar. The presence of the DATE qualifier selects a detail record modification.
/hostname or -node =hostname
The qualifier specifies what node (either local or remote) you want the operation performed on.
/fiscal or -fiscal =starting month
The FISCAL qualifier specifies which month is to begin the fiscal year. The default setting is January. The month may be entered as a number (1-12) or as text (e.g. "June").
/flags or -flags=noholiday_runs, noweekend_runs, skip, slide
The FLAGS qualifier allows the user to specify dates on which a job is to run. The various flags are:
Flag |
Description |
NOHOLIDAY_RUNS |
No jobs will run on a holiday |
NOWEEKEND_RUNS |
No jobs will run on a weekend |
SKIP |
Skip runs on disallowed days |
SLIDE |
Slide run forward on disallowed days |
Whenever multiple flags are used, they must be enclosed in parentheses.
/[no]log or -[no]log
The LOG qualifier causes each completed operation to issue a note to the user.
/mark or -mark="markings"
The MARK qualifier is used to mark certain days on a calendar.
/owner or -owner=uic
The OWNER qualifier specifies the owner UIC code for the calendar.
/protection or -protection=(s:rwed,o:rwed,g:rwed, w:rwed)
The PROTECTION qualifier specifies the UIC based access rights for the file.
/run or -run
/norun or -norun
The NORUN qualifier s marks the specified day as one on which no runs are allowed.
/standard_date or -standard_date
The STANDARD_DATE qualifier indicates that the date provided with the /DATE qualifier is a standard date. This is useful when modifying a particular date of a workday calendar. Only the work days of such a calendar have numbers. To mark a specific day using a standard date (i.e. the date from a wall calendar) this qualifier must be provided.
/workdays or -workdays[=noholiday(d), noweekend(d)]
/noworkdays or -nowrokdays
The WORKDAYS qualifier specifies which days a job will not run. The default settings are NOHOLIDAY and NOWEEKEND. To change a day on a WORKDAYS calendar that is not included in the defined workdays use the STANDARD_DATE qualifier . Either noholiday, noweekend or both may be used.