Previous Topic

Next Topic

Book Contents

Book Index

create/calendar

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.

See Also

CALENDAR commands

copy/calendar

delete/calendar

directory/calendar

modify/calendar

rename/calendar

type/calendar