|
|
|
|
|
Modify a calendar definition.
The MODIFY command will change any of the fields that make up a calendar definition.
General Format
modify/calendar calendar_name [/qualifier = value]
Alternate
chcal calendar_name [-qualifier = value]
Qualifier Summary
applicable to the calendar header entry:
/owner = uic
/protection = (s:rwed,o:rwed,g:rwed,w:rwed)
/comment = "any text string"
/[no]workdays [= noholiday, noweekend]
/flags = noholiday_runs, noweekend_runs
/fiscal = starting month
applicable to the calendar month detail record
/date = date to change
/mark = letter or letters
/[no]run
/standard_date
general qualifiers:
/log
/confirm
/node = target node
Examples
C:\> schedule modify/calendar \mlevy\fun_days /fiscal=july/log
modified \mlevy\fun_days
Qualifiers
/comment="any text string"
The COMMENT qualifier is any useful description that you may want to add. This is an 80 character option.
/confirm
/noconfirm
CONFIRM requests that the user be prompted prior to any operation to verify that the selected entry is the correct one.
/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=host_name
The qualifier specifies what node (either local or remote) you want the operation performed on.
/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=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.
/log
/nolog
The LOG qualifier causes each completed operation to issue a note to the user.
/mark="markings"
The MARK qualifier is used to mark certain days on a calendar.
/owner=uic
The OWNER qualifier specifies the owner UIC code for the calendar.
/protection=(s:rwed,o:rwed,g:rwed, w:rwed)
The PROTECTION qualifier specifies the UIC based access rights for the file.
/run
/norun
The NORUN qualifier s marks the specified day as one on which no runs are allowed.
/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[=noholiday(d), noweekend(d)]
/noworkdays
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.