Create a new calendar definition.
The CREATE command will add a new calendar definition to the database.
Windows/OpenVMS Format:
create/calendar directory_name [/qualifiers]
UNIX/Linux Format:
mkcal directory_name [-qualifiers]
Applicable to the calendar header entry:
/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 (default), noweekend (default)]
/flags or -flags = noholiday_runs, noweekend_runs
/fiscal or -fiscal = starting month (default = january)
General Qualifiers:
/node or -node = node name
/[no]log or -[no]log
/[no]confirm or -[no]confirm
Windows/OpenVMS
Schedule> create /calendar my_special_calendar /flags=noholidayruns /comment="My Holiday calendar"
UNIX/Linux
Schedule> mkcal my_special_calendar -flags=noholidayruns -comment="My Holiday calendar"
/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 job is the correct one.
/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.
/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.
/workdays or -workdays[=noholiday(d), noweekend(d)]
/noworkdays or -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.