Keywords › CALENDAR Keyword—Create and Use a Calendar

CALENDAR Keyword—Create and Use a Calendar

Valid on z/OS, z/VSE, and z/VM.

Use the CALENDAR keyword to:

• Provide a name for CA Top Secret to reference a CALENDAR record
• Add, remove, replace, or list an existing calendar in the SDT Record
• Permit or revoke a CALENDAR to an ACID (When defined to the SDT)

When used with ADDTO, this keyword has the following format:

TSS ADDTO(SDT) CALENDAR(calname) 
               [YEAR(yyyy)] 
               [DAYS(daywk1,,,)]
               [INCLUDE(mm/dd)]
               [EXCLUDE(mm/dd)]

calname

Specifies a record ID that must be unique for each calendar. It can contain letters, numbers, and special characters.

Length: 8 characters

DAYS

Specifies the days to include in the calendar.

INCLUDE

Specifies the days to include in the calendar.

EXCLUDE

Specifies the days to exclude from the calendar.

When used with PERMIT, this keyword has the following format:

TSS PERMIT(acid) RESOURCE(resource‑name)
                 ACCESS(level)
                CALENDAR(calname

ACCESS

Specifies one of following access levels: ALL, CREATE, CONTROL, FETCH, NONE, READ, SCRATCH, UPDATE, or WRITE.

Default: READ

This keyword is used with:

• The commands ADDTO, DELETE, PERMIT, REMOVE, REPLACE, REVOKE, and LIST
• The SDT Record exclusively
• MISC3(SDT) authority to ADDTO or REMOVE records or fields in the SDT
• MISC8(LISTSDT) authority to list calendars in the SDT only
• Access control methods expiration, facility, and actions

Examples: CALENDAR keyword

This example creates a calendar for the present year called CAL1:

TSS ADDTO(SDT) CALENDAR(CAL1)

This example creates a calendar called CAL1 for the days Monday through Friday in the year 2009:

TSS ADDTO(SDT) CALENDAR(CAL1)
               YEAR(2009)
               DAYS(WEEKDAY)

This example permits a user to update the inventory master file data set INV.MASTER.FILE with the personnel department's CALENDAR CAL1:

TSS PERMIT(USR01) DSNAME('INV.MASTER.FILE')
                  ACCESS(UPDATE)
                 CALENDAR(CAL1)

This example revokes access:

TSS REVOKE(USR01) DSNAME('INV.MASTER.FILE')