Solaris Common Desktop Environment: Programmer's Guide

Calendar Attributes

Table 10-4 lists the calendar attributes supported in the CDE implementation. See the relevant man page for more information. The list of calendar attributes is extensible through the extended naming convention.

Table 10-4 CSA Calendar Attributes


Attribute Name	Symbolic Name	Server Version	Data Version	Read Only?
Access List	CSA_CAL_ATTR_ACCESS_LIST_	2-5	1-4	No
Calendar Name	CSA_CAL_ATTR_CALENDAR_NAME	2-5	1-4	Yes*
Calendar Owner	CSA_CAL_ATTR_CALENDAR_OWNER	2-5	1-4	Yes*
Calendar Size	CSA_CAL_ATTR_CALENDAR_SIZE	5	3,4	Yes
Character Set	CSA_CAL_ATTR_CHARACTER_SET	5	4	Yes
Data Version**	CSA_X_DT_CAL_ATTR_DATA_VERSION	2-5	1-4	Yes
Date Created	CSA_CAL_ATTR_DATE_CREATED	5	4	Yes
Number Entries	CSA_CAL_ATTR_NUMBER_ENTRIES	2-5	1-4	Yes
Product Identifier	CSA_CAL_ATTR_PRODUCT_IDENTIFIER	2-5	1-4	Yes
Server Version**	CSA_X_DT_CAL_ATTR_SERVER_VERSION	2-5	1-4	Yes
Time Zone	CSA_CAL_ATTR_TIME_ZONE	5	4	Yes
Version	CSA_CAL_ATTR_VERSION	2-5	1-4	Yes

*specified when the calendar is created and read-only afterwards

**CDE only

The following Calendar attributes are not supported:

CSA_CAL_ATTR_COUNTRY 
CSA_CAL_ATTR_LANGUAGE  
CSA_CAL_ATTR_WORK_SCHEDULE

The following descriptions provide additional information about some of the calendar attributes listed in Table 10-4 .

Access List

When a new calendar is added and if no access list is specified, the default access list contains a special user world and its corresponding access right is CSA_VIEW_PUBLIC_ENTRIES, which provides access right to list and read calendar entries with public classification. The special user world includes all users.
Calendar Name

The calendar name is specified when the calendar is created using csa_add_calendar(). It becomes read-only and cannot be changed after the calendar is created.
Calendar Owner

The calendar owner is set to the user who is running the application that calls csa_add_calendar() to create the calendar. It becomes read-only and cannot be changed after the calendar is created.
Character Set

The CDE common locale name should be used to set this value.

The followings are CDE-defined calendar attributes:

Server Version

This read-only attribute shows the version number of the server managing the calendar. This attribute is a CSA_VALUE_UINT32 type of attribute.
Data Version

This read-only attribute shows the data version of the calendar. This attribute is a CSA_VALUE_UINT32 type of attribute.