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.