Previous Topic

Next Topic

Create a calendar (create/calendar or mkcal)

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]

Qualifier Summary

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

Examples

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"

Qualifiers

/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.

See Also

CALENDAR commands

Copy a calendar (copy/calendar or cpcal)

Delete a calendar (delete/calendar or rmcal)

Display calendar properties (directory/calendar or lscal)

Modify a calendar's properties (modify/calendar or chcal)

Rename a calendar (rename/calendar or mvcal)

Type a calendar's months (type/calendar or morecal)