Maintaining Special Security Records › SDT Record › Define CALENDAR Records to the SDT

Define CALENDAR Records to the SDT

Use the ADDTO command to add a calendar record.

To define a new CALENDAR record to the SDT, enter the command:

TSS ADDTO(SDT) CALENDAR(cal‑name)
               DESCRIPT(descript‑name)
               YEAR(yyyy)
               DAYS(days,...)
               EXCLUDE(mm/dd,mm/dd,...) 
               INCLUDE(mm/dd,mm/dd,...)

CALENDAR

Specifies an eight‑character, user‑defined calendar ID that must be unique for each calendar. It can contain letters, numbers, and special characters.

DESCRIPT

Designates an optional 32‑character, user‑description field that is used as a logical name for this record. If the description field contains blanks, you must enclose it in single quotes.

YEAR

Specifies the year in which this calendar record is active; optional. If not specified, the current year is used (the default). A defined calendar expires at the end of the year (12/31/xx). To keep the calendar active, you must redefine it specifying the new year for yyyy. If the new calendar is not defined by January 1, then the permission will no longer be valid and the expected access will no longer exist.

DAYS

Indicates which days of the week to include in the calendar. Valid entries are: SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, WEEKDAYS, and WEEKENDS. When defining a calendar, it is important to remember that all days to be included in the calendar must be explicitly specified.

EXCLUDE

Lists specific dates that are to be excluded from the calendar. These dates are in addition to the days specified on the DAYS keyword. EXCLUDE has no effect unless DAYS or INCLUDE match the dates excluded.

INCLUDE

Lists specific dates that are to be included in the calendar. These dates are in addition to the days specified on the DAYS keyword.

Examples: calendar records

This example creates a calendar, but there is no valid days to use it:

TSS ADDTO(SDT) CALENDAR(CAL1)

This example create a calendar that includes all days:

TSS ADDTO(SDT) CALENDAR(CAL1) 
               DAYS(WEEKDAYS,WEEKENDS)

This example creates a calendar for the present year called CAL1 that includes the days Monday through Friday:

TSS ADDTO(SDT) CALENDAR(CAL1) 
               DAYS(WEEKDAYS)

This example creates a calendar for the present year with a user‑description field called PAYROLL CALENDAR:

TSS ADDTO(SDT) CALENDAR(CAL1) 
               DESCRIPT(‘PAYROLL CALENDAR’)
               DAYS(WEEKDAYS)

This example creates a 1999 calendar named FIN98:

TSS ADDTO(SDT) CALENDAR(FIN8) 
               YEAR(1999) 
               DAYS(WEEKDAYS)

This example creates a calendar for the present year with every Monday, Wednesday, Thursday and Friday enabled:

TSS ADDTO(SDT) CALENDAR(CAL1)
               DAYS(MON,WED,THUR,FRI)

This example creates a calendar for the present year with April 16 disabled:

TSS ADDTO(SDT) CALENDAR(CAL1) 
               DAYS(WEEKDAYS,WEEKENDS) 
               EXCLUDE(04/16)

This example creates a calendar for the present year with April 22 and April 29 enabled:

TSS ADDTO(SDT) CALENDAR(CAL1)
               INCLUDE(04/22,04/29)