Create a new calendar definition.
The CREATE command will add a new calendar definition to the database.
General Format
create/calendar calendar_name [/qualifiers]
Alternate
mkcal calendar_name [/qualifiers]
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 (default), noweekend (default)]
/flags = noholiday_runs, noweekend_runs
/fiscal = starting month (default = january)
general qualifiers:
/node = node name
/[no]log
/[no]confirm
Examples
C:\> schedule create/calendar monthly_accounting/log
created \mhattar\monthly_accounting
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 job is the correct one.
/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.
/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.
/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.