Calendar Server 配置參數儲存在配置檔案 (包括 ics.conf 和 counter.conf) 中。
本章提供以下資訊︰
Calendar Server 配置參數儲存在以下檔案中︰
/etc/opt/SUNWics5/config/ics.conf
ics.conf 檔案為 ASCII 文字檔案,每行定義一個參數及其關聯值。這些參數在 Calendar Server 安裝期間初始化。安裝之後,您可以使用文字編輯器編輯該檔案。
僅能依 Sun 文件的說明或用戶支援代表的指導來修改 ics.conf 檔案中參數的設定。
例如:Calendar Server 不啟用遠端管理。請勿變更 service.admin.port 參數,因為 Calendar Server 已將其設定為其所需的值。否則,csadmind 程序可能無法正確執行。
以使用者身份登入,該身份具有對執行 Calendar Server 之系統的管理員權限。
移至 ics.conf 檔案所在的 /etc/opt/SUNWics5/config 目錄。
使用文字編輯器 (例如 vi) 編輯 ics.conf 檔案中的參數。參數的慣例包括︰
所有參數必須僅為小寫。
參數及其關聯值必須以等號 (=) 分隔,等號的前後均允許包含空格或定位點。例如:
service.http.idletimeout = "120"
參數值必須置於雙引號 (") 中。如果參數允許多個值,則整個值字串必須置於雙引號中。例如:
calstore.calendar.owner.acl= "@@o^a^rsf^g;@@o^c^wdeic^g"
註釋行以驚嘆號 (!) 開頭。註釋行僅用於提供資訊,且被 Calendar Server 忽略。
某些參數做為註釋發佈,以一個或兩個驚嘆號 (! 或 !!) 開頭。若要使用此類型的參數,您必須移除驚嘆號,提供一個值 (如果需要),然後重新啟動 Calendar Server 以使參數生效。
例如,若要使用 !!caldb.dwp.server.[hostname].ip,您必須移除驚嘆號 (!!),提供 hostname 值,然後重新啟動 Calendar Server。
如果某個參數不在 ics.conf 檔案中,請將該參數及其關聯值增加至該檔案。
如果參數出現多次,則所列出的最後一個參數值將置換先前的值。
所有選項必須從行首開始。
變更 ics.conf 檔案中的參數後,停止然後重新啟動 Calendar Server 以使新的配置值生效。
如果願意,您也可以先停止 Calendar Server,然後再編輯 ics.conf 檔案。如需更多資訊,請參閱12.1 啟動與停止 Calendar Server 6.3 程序。
本節小列出 ics.conf 檔案中的各種配置參數。為方便起見,將它們分為以下的功能群組:
以下列出的參數僅顯示其預設設定。若要實作特定功能,可能需要將一或多個參數變更為不同值。請參閱第 3 部分自訂 Calendar Server 配置的中各章節說明來瞭解如何實作功能,包括使用哪些參數及將哪些值指定給它們。
ics.conf 檔案中允許重複的參數。系統會使用檔案中參數的最後一個實例之值。
配置檔案太大。有太多參數。如果進行自訂,則可能很難找到這些自訂內容或忘記變更值的原因。為了避免混淆,請在您針對該用途所建立的區段中,於檔案結尾增加您的自訂資訊。例如,您可以建立包含以下文字的註釋行:! 我的 ics.conf 變更。然後增加新參數或您要修改的任何參數,並增加它們的值。為每個參數增加註釋,說明變更的原因及目前的日期。如此能提供您系統的變更歷程記錄,供後續參照。
每當您啟動或重新啟動 Calendar Server 時,系統會讀取整個配置檔案。系統必須處理的參數越多,啟動系統的時間就越長。若有許多重複的參數,則可能會大幅降低處理速度。為了避免這種情況,請將過時的重複參數標記為註釋。
下表顯示以 local. 開頭的配置參數及每個參數的預設值和說明。
表 E–1 ics.conf 檔案中的本機伺服器實例配置參數
參數 |
預設值 |
說明 |
---|---|---|
"yes" |
啟用 ("yes") 或停用 ("no") 使用者行事曆的自動佈建 |
|
"en" |
此 Calendar Server 實例中網域的預設語言。 |
|
" " |
安裝 Calendar Server 之機器的主機名稱。 |
|
cal-svr-base/SUNWics5/ cal |
安裝 Calendar Server 的目錄路徑位置。 |
|
cal-svr-base/SUNWics5/ cal |
安裝此 Calendar Server 實例之配置檔案和資料的目錄路徑位置。 |
|
cal-svr-base/SUNWics5/ cal/data/lock |
指定該伺服器實例之鎖定檔案的儲存位置。 |
|
cal-svr-base/SUNWics5/ cal/lib/counter |
指定該伺服器實例之計數器檔案的儲存位置。 |
|
" " |
安裝此 Calendar Server 實例之 CSAPI 外掛程式的目錄路徑位置。 |
|
"no" | ||
"icsgroup" | ||
"icsuser" | ||
"en" |
此 Calendar Server 實例的預設語言。 |
|
" " |
用於查找與電子郵件位址對應的與會者行事曆 ID 的預設網域名稱。例如,如果此設定的值為 "sesta.com",則 jsmith 解析為 jsmith@sesta.com。 |
|
"en" |
此 Calendar Server 實例支援的使用者語言。 |
參數 |
預設值 |
說明 |
---|---|---|
" " |
用於 LDAP 認證的基底 DN。如果未指定,則使用 local.ugldapbasedn。 |
|
"localhost" |
用於 LDAP 認證的主機。如果未指定,則使用 local.ugldaphost。 |
|
" " |
local.authldapbinddn 中指定的使用者連結憑證 (密碼)。 |
|
" " |
用於連結 LDAP 認證主機以搜尋使用者 dn 的 DN。若未指定,或值為 " ",則為匿名連結。 |
|
"389" |
用於 LDAP 認證的連接埠。如果未指定,則使用 local.ugldapport。 |
|
"1" |
為 LDAP 認證所維護的 LDAP 用戶端連線的最小數目。如果未指定,則使用 local.ugldappoolsize。 |
|
"1024" |
為 LDAP 認證所維護的 LDAP 用戶端連線的最大數目。如果未指定,則使用 local.ugldapmaxpool。 |
參數 |
預設值 |
說明 |
---|---|---|
"3" |
指定與會者查找搜尋中萬用字元搜尋的最小字串大小。零 (0) 表示始終進行萬用字元搜尋。 |
|
"localhost" |
儲存 LDAP 使用者喜好設定之機器的主機名稱。 |
參數 |
預設值 |
說明 |
---|---|---|
" " |
用於 LDAP 使用者喜好設定認證的連結憑證 (密碼)。 |
|
" " |
用於連結 LDAP 使用者喜好設定主機的 DN。無預設 DN。若值為 " " 或未指定,則假定匿名連結。 |
|
" " |
LDAP 使用者喜好設定的基底 DN。必須指定此基底 DN,且不能為空。 |
|
"ceColorSet, ceFontFace, ceFontSizeDelta, ceDateOrder, ceDateSeparator, ceClock, ceDayHead, ceDayTail, ceInterval, ceToolText, ceToolImage, ceDefaultAlarmStart, ceSingleCalendarTZID, ceAllCalendarTZIDs, ceDefaultAlarmEmail, ceNotifyEmail, ceNotifyEnable, ceDefaultView, ceExcludeSatSun, ceGroupInviteAll" |
icsExtendedUserPrefs 屬性中選項的值。 |
|
"uid=%u" |
用於使用者查找的篩選器。 |
下表顯示行事曆存放區配置參數以及每個參數的預設值和說明。行事曆存放區保存所有事件和待辦事項記錄。
表 E–5 ics.conf 檔案中的行事曆儲存區配置參數
參數 |
預設值 |
說明 |
---|---|---|
"anonymous" |
用於匿名登入的行事曆 ID (Calendar ID, calid)。 |
|
"yes" |
決定建立行事曆時使用者行事曆是否可以在同一時段排程多個事件︰
|
|
"@@o^a^r^g; @@o^c^wdeic^g; @^a^fs^g; @^c^^g; @^p^r^g" |
指定使用者建立行事曆時所使用的預設存取控制權限。格式由以分號分隔的存取控制項目 (ACE) 引數字串的清單指定。 如需有關 ACE 格式的詳細資訊,請參閱15.4 Calendar 存取控制 若要使用指令行公用程式為一個或多個行事曆指定存取控制項目,請參閱D.5 cscal。 |
|
"@@o^a^rsf^g; @@o^c^wdeic^g" |
指定行事曆所有者的預設存取控制設定。 |
|
calstore.calendar.create. lowercase |
"no" |
指定在建立新行事曆或使用 LDAP CLD 外掛程式查找行事曆時,Calendar Server 是否應將行事曆 ID (calid) 轉換為小寫。 |
"America/ New_York" |
出現以下情況時要使用的時區 ID︰
|
|
"yes" |
指定 Calendar Server 是否篩選 (識別) 私人和只有時間與日期 (機密) 的事件和工作。如果為 "no",則 Calendar Server 將它們視為公開事件和工作。 |
|
defaultcalendar |
"yes" |
指定使用者的預設行事曆是否包含在使用者的空閒/忙碌行事曆清單中。 |
defaultcalendar |
"no" |
指定是否可以從使用者的空閒/忙碌行事曆清單中移除使用者的預設行事曆。 |
"0" |
展開用於邀請的 LDAP 群組的大小上限。值 "0" 表示展開群組,而無大小限制。值 -1 表示不允許展開 LDAP 群組。 |
|
"60" |
可由週期性擴充建立之事件的最大數目。 |
|
defaultcalendar |
"yes" |
指定使用者的預設行事曆是否包含在使用者的訂閱行事曆清單中。 |
defaultcalendar |
"no" |
指定是否可以從使用者的訂閱行事曆清單中移除使用者的預設行事曆。 |
"200" |
從使用者搜尋的 LDAP 查找傳回之結果的最大數目。值 "0" 表示無限制。 |
|
fmt1.type |
"uid" |
為事件的與會者執行目錄查找時,指定 Calendar Server 如何處理字串,如 jdoe 或 jdoe:tv。允許值為︰uid、cn、 gid、res、mailto 和 cap。 |
fmt2.type |
"mailto" |
為事件的與會者執行目錄查找時,指定 Calendar Server 如何處理帶有 at 符號 (@) 的字串,如 jdoe@sesta.com。允許值為︰uid、cn、gid、res、mailto、cap。 |
fmt3.type |
"cn" |
為事件的與會者執行目錄查找時,指定 Calendar Server 如何處理帶有空格的字串,如 john doe。允許值為︰uid、cn、 gid、res、cap。 |
"." |
儲存行事曆資訊之主磁碟分割區的位置。 |
下表顯示行事曆記錄配置參數以及每個參數的預設值和說明。
表 E–6 ics.conf 檔案中的行事曆記錄配置參數
參數 |
預設值 |
說明 |
---|---|---|
"admin.log" |
用於記錄管理工具之記錄檔的名稱。 |
|
"0" |
記錄緩衝區的大小,以位元組為單位。 |
|
"dwp.log" |
用於記錄與資料庫連線協定相關的管理工具的記錄檔之名稱。 |
|
"604800" |
記錄檔過期之前的秒數。 |
|
"60" |
清除記錄檔緩衝區的間隔秒數。 |
|
"httpd.access" |
目前存取記錄檔的名稱。 |
|
"http.log" |
cshttpd 服務的目前記錄檔名稱。 |
|
logname |
"httpd.access" |
目前 HTTP 存取記錄檔的名稱。 |
"logs" |
記錄檔的目錄位置。 |
|
"NOTICE" |
決定伺服器將記錄的詳細資訊層級。每個記錄項目均被指定以下層級之一︰CRITICAL、ALERT、ERROR、WARNING、NOTICE、INFORMATION 和 DEBUG。 |
|
"10" |
記錄目錄中記錄檔的最大數目。 |
|
"2097152" |
每個記錄檔的最大大小 (以位元組為單位)。 |
|
"20971520" |
用於儲存所有記錄檔的最大磁碟空間 (以位元組為單位)。 |
|
diskspace |
"5242880" |
必須可用於記錄的最小可用磁碟空間 (以位元組為單位)。 |
"notify.log" |
csnotifyd 服務的記錄檔名稱。 |
|
"86400" |
旋轉記錄檔之前的秒數。 |
|
"store.log" |
儲存記錄檔名稱。 |
|
service.http.commandlog |
"no" |
此參數僅適用於除錯。若設為 "yes",系統會將所有傳入的指令記錄到 http.commands 記錄檔。 請勿在生產執行階段使用此參數。它會很快地填入記錄檔,並可能導致效能降低。 |
下表列出適合管理員的 ics.conf 參數。
表 E–7 管理員的配置參數
參數 |
預設值 |
說明 |
---|---|---|
cred |
" " |
被指定為 Calendar Server 管理員之使用者 ID 的密碼。此值在安裝時提供,而且是安裝程式所必需的。 |
userid |
"calmaster" |
被指定為 Calendar Server 管理員之人員的使用者 ID。此值在安裝時提供,而且是安裝程式所必需的。 |
overrides.accesscontrol |
"no" |
指示 Calendar Server 管理員是否可以置換存取控制。 |
service.admin.calmaster. wcap.allowgetmodify userprefs |
"no" |
指示 Calendar Server 管理員是否可以使用 WCAP 指令取得和設定使用者喜好設定。 |
"yes" |
如果為 "yes",則為 service.siteadmin.userid 中所指定之使用者的使用者認證啟用 LDAP。 |
下表顯示各種服務配置參數以及每個參數的預設值和說明。
表 E–8 ics.conf 檔案中的服務配置參數
參數 |
預設值 |
說明 |
---|---|---|
"yes" |
啟用 ("yes") 或停用 ("no") 管理工具的警示通知。 |
|
checkpoint.enable |
"yes" |
如果為 "yes",則啟動 csadmind 資料庫檢查點執行緒。 |
dbcachesize |
"8388608" |
用於管理階段作業之 Berkeley 資料庫的最大快取記憶體大小 (以位元組為單位)。 |
deadlock.enable |
"yes" |
如果為 "yes",則啟動 csadmind 資料庫死結偵測執行緒。 |
diskusage |
"no" |
如果為 "yes",則啟動 csadmind 低磁碟空間監視執行緒。 |
"yes" |
如果為 "yes",則在啟動所有服務時啟動 csadmind 服務,並在停止所有服務時停止 csadmind。 |
|
idletimeout |
"120" |
使 HTTP 連線在 csadmind 中逾時之前的秒數。 |
maxsessions |
"100" |
所允許的管理階段作業的最大數目。 |
maxthreads |
"10" |
每個管理階段作業的執行中執行緒的最大數目。 |
numprocesses |
不適用 |
所允許的同步運作之管理程序的最大數目。 |
不適用 |
**CAUTION** 由系統設定。請勿變更。 |
|
resourcetimeout |
"900" |
使管理連線逾時之前的秒數。 |
serverresponse |
"no" |
如果為 "yes",則啟動 csadmind 服務回應執行緒。 |
sessiondir.path |
" " |
管理階段作業請求的暫存目錄。 |
sessiontimeout |
"1800" |
使 HTTP 階段作業在 csadmind 中逾時之前的秒數。 |
sleeptime |
"2" |
在檢查已啟動、已停止或準備好的行事曆服務之間等待的秒數。 |
starttime |
"300" |
任一行事曆服務啟動之前需要等待的秒數。 |
stoptime |
"300" |
任一行事曆服務停止之前需要等待的秒數。 |
stoptime.next |
"60" |
在向任一行事曆服務傳送 stop 指令之間等待的秒數。 |
"o=internet" |
該目錄中 DC 樹狀結構的根尾碼。 |
|
dnsresolveclient |
"no" |
如果為 "yes",則會根據 DNS 檢查用戶端 IP 位址 (如果允許 HTTP 存取)。 |
loginpause |
"0" |
使用一般文字密碼成功認證使用者後延遲的秒數。 |
"calmaster" |
以空格分隔的對此 Calendar Server 具有管理權限的使用者 ID 清單。 |
|
allowadminproxy |
"yes" |
如果為 "yes",則允許經由代理登入。 |
allowanonymouslogin |
"yes" |
如果為 "yes",則允許匿名 (無認證) 存取。這是特殊類型的登入,只允許指定的受限制的存取 (通常僅讀取對公開行事曆的存取)。 |
.calendarhostname |
"" (Null) |
用於擷取 HTML 文件的 HTTP 主機。 |
"yes" | ||
dbcachesize |
"8388608" |
用於 HTTP 階段作業之 Berkeley 資料庫的最大快取記憶體大小。 |
domainallowed |
"" (Null) |
如果已指定且不為 "",則會進行篩選以允許基於 TCP 網域的存取。例如,"ALL: LOCAL.sesta.com" 將允許對 sesta.com 網域中的任何人進行本機 HTTP 存取。多個篩選器由 CR-LF (換行) 分隔。 |
domainnotallowed |
"" (Null) |
如果已指定且不為 " ",則會進行篩選以拒絕基於 TCP 網域的存取。例如,"ALL:LOCAL.sesta.com" 將拒絕對 sesta.com 網域中的任何人進行 HTTP 存取。多個篩選器必須由 CR-LF (換行) 分隔。 |
attachdir.path |
"." |
與暫時儲存匯入檔案之 local.queuedir 相對的目錄位置 (或指定的絕對路徑)。 |
ipsecurity |
"yes" |
如果為 "yes",則參照現有階段作業的所有請求均被驗證為來源於同一 IP 位址。 |
"yes" |
如果為 "yes",則在啟動所有服務時啟動 cshttpd 服務,並在停止所有服務時停止 cshttpd。 |
|
idletimeout |
"120" |
使 HTTP 連線逾時之前的秒數。 |
ldap.enable |
"yes" |
如果為 "yes",則建立並維護用於認證和使用者喜好設定的 LDAP 連線。 |
"INADDR_ANY" |
指定 HTTP 服務將為用戶端請求偵聽的 TCP 位址。"INADDR_ANY" 指示任一位址。 |
|
"no" |
如果為 "yes",則完全記錄至伺服器的 HTTP 連線。 |
|
maxsessions |
"5000" |
cshttpd 服務中 HTTP 階段作業的最大數目。 |
maxthreads |
"20" |
cshttpd 服務中回應 HTTP 請求之執行緒的最大數目。 |
numprocesses |
"1" |
應在某個伺服器上同步執行的 HTTP 服務 (cshttpd) 程序的最大數目。 如需有關具有多個 CPU 的伺服器的資訊,請參閱21.8 使用跨多個 CPU 的負載平衡功能 |
"80" |
來自 Calendar Server 使用者之 HTTP 請求的連接埠。 |
|
proxydomainallowed |
"" |
如果已指定且不為 "",則進行篩選以允許基於 TCP 網域的代理登入。語法與 service.http.domainallowed 相同。 |
resourcetimeout |
"900" |
使 HTTP 階段作業逾時之前的秒數。 |
sessiondir.path |
"http" |
HTTP 階段作業的暫存目錄。 |
"1800" |
使 HTTP 階段作業在 cshttpd 服務中逾時之前的秒數。 |
|
" " |
相對於可執行檔的目錄,其中儲存檔案的所有 URL 參照。 |
|
相對於可執行檔的目錄,其中儲存檔案的所有 URL 參照。 預設為:/var/opt/SUNWics5/tmp |
||
"html" |
包含預設行事曆用戶端的目錄。如果僅允許 WCAP 存取,則設定為 ""。 |
|
"no" |
如果為 "yes",則在 LDAP SDK 中使用快取記憶體。 |
|
"30" |
若 service.ldapmemcache 為 "yes",則將此值傳送至 LDAP SDK。這是快取項目的最大秒數。如果為 0,則對快取項目的時間沒有限制。 |
|
"131072" |
若 service.ldapmemcache 為 "yes",則將此值傳送至 LDAP SDK。這是快取將消耗之記憶體的最大容量 (以位元組為單位)。如果為 0,則快取記憶體無大小限制。 |
|
.allowpubliccalendarwrite |
"yes" |
如果為 "yes",則允許匿名使用者寫入公開可寫入的行事曆。 |
"text /calendar" |
指定目前僅適用於 freebusy 之指令的預設輸出格式。 |
|
freebusybegin |
"30" |
指定基於目前時間的預設偏移天數,做為偵測 get_freebusy 的範圍開始。 |
freebusyend |
"30" |
指定基於目前時間的預設偏移天數,做為偵測 get_freebusy 的範圍結束。 |
redirecturl |
““ |
針對遷移的目的,當僅進行了部分遷移時,行事曆在來源資料庫與 Calendar Server 目標資料庫之間才會分開。如果在 Calendar Server 資料庫中找不到行事曆,則在來源資料庫的 URL 中查找。 |
createcalendars |
"yes" |
如果為 "yes",則允許建立行事曆。 |
deletecalendars |
"yes" |
如果為 "yes",則允許刪除行事曆。 |
changepassword |
"no" |
若為 "yes",則允許變更使用者密碼。 |
publicwritablecalendars |
"yes" |
如果為 "yes",則允許使用者擁有公開可寫入行事曆。 |
setprefs.cn |
"no" |
如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 cn (LDAP 使用者的一般名稱)。 |
setprefs.givenname |
"no" |
如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 givenname (LDAP 使用者的名字)。 |
setprefs.icsCalendar |
"no" |
如果為 "yes",則允許 set_userprefs.wcap 修改使用者喜好設定 icsCalendar (使用者的預設行事曆識別碼)。 |
setprefs.mail |
"no" |
如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 mail (使用者的電子郵件位址)。 |
preferredlanguage |
"no" |
如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 preferredlanguage (LDAP 使用者的喜好語言)。 |
setprefs.sn |
"no" |
如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 sn (LDAP 使用者的姓氏)。 |
setprefs.nswccalid |
"no" |
如果為 "yes",則允許 set_userprefs.wcap 屬性修改使用者喜好設定 nswccalid,即使用者的預設行事曆 ID。 |
calendar.publicread |
"no" |
如果為 "yes",則預設使用者行事曆初始設定為公開讀取及私人寫入。如果為 "no",則預設使用者行事曆初始設定為私人讀取及寫入。 |
ldapproxyauth |
"no" |
如果為 "yes",則啟用 get_userprefs.wcap 指令的 LDAP 代理伺服器授權。如果為 "no",則執行匿名 LDAP 搜尋。 |
"no" |
如果為 "yes",則伺服器必須驗證行事曆的每個所有者均存在於目錄中 (透過 LDAP 或 CSAPI 相容的使用者目錄機制)。 |
|
"3.0" |
WCAP 版本。 |
下表顯示 ics.conf SSL 配置參數以及每個參數的預設值和說明。當大多數 SSL 參數使用預設值時,有兩個參數要求您將系統預設值變更為 SSL 值,如下所示:
service.http.ssl.usessl="yes"
service.http.ssl.port.enable="yes"
下表顯示 ics.conf 參數及其預設設定。驗證 ics.conf 參數是否具有適當的值:
表 E–9 SSL 的配置參數
以下三個參數可允許或禁止系統傳送取消、邀請和回覆通知。
表 E–11 ics.conf 檔案中的警示通知配置參數
參數 |
預設值 |
說明 |
---|---|---|
"yes" |
決定是否在取消事件後將電子郵件通知傳送給與會者。 |
|
"yes" |
決定是否將電子郵件通知傳送給被邀請參與事件的與會者。 |
|
"yes" |
決定是否在與會者回覆邀請時將電子郵件通知傳送給組織者。 |
下表顯示行事曆查找資料庫 (Calendar Lookup Database, CLD) 參數以及每個參數的預設值和說明。
表 E–13 ics.conf 檔案中的行事曆查找資料庫 (Calendar Lookup Database, CLD) 參數
參數 |
預設值 |
說明 |
---|---|---|
"no" |
啟用 ("yes") 或停用 ("no") 行事曆查找外掛程式。 |
|
"*" |
指定要載入的特定行事曆查找外掛程式的名稱。如果此值為星號 ("*"),則 Calendar Server 會載入所有外掛程式。 |
|
"local" |
針對所有項目皆位於同一台的機器或僅做為後端機器的機器,使用 "local"。 針對僅做為前端機器的機器或同時做為前端與後端機器的機器,使用 "directory"。 |
|
" " |
如果 LDAP 伺服器資料庫中的使用者行事曆項目或資源行事曆項目不具有 icsDWPHost 屬性,該參數將指定 Calendar Server 所使用之完全合格的預設 DWP 伺服器名稱。 若登入 Calendar Server 的使用者的 LDAP 項目 (login.wcap ) 沒有 icsDWPHost 屬性,則 Calendar Server 會使用此參數值來增加該屬性。 如果使用者 LDAP 項目已具有 icsDWPHost 屬性,則不會使用 caldb.dwp.server.default。 該名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。 |
|
"yes" |
啟用 ("yes") 或停用 ("no") 行事曆查找資料庫 (CLD) 的快取記憶體選項。若要獲得 LDAP CLD 外掛程式的最佳效能,請設定為 "yes"。 |
|
"10" |
指定檢查點檔案的最大大小 (以百萬位元組為單位)。 |
|
"4" |
指定共用記憶體的大小 (以百萬位元組為單位)。 |
|
"1000" |
指定資料庫執行緒的最大數目。 |
|
"." |
為 CLD 快取記憶體選項指定資料庫事件、工作和警示檔案的位置。預設值 "." 指定這些檔案儲存在 /var/opt/SUNWics5/csdb/cld_cache 目錄中。 |
|
"60" |
指定檢查點之間的間隔秒數。 |
|
"yes" |
指定為 CLD 快取記憶體選項同步化檢查點檔案之後是否移除這些檔案。 |
|
caldb.dwp.server.host-name .ip |
" " |
指定儲存行事曆資料庫之伺服器的主機名稱。伺服器必須在執行 DWP (csdwpd) 服務。該名稱必須可被您的網域名稱服務 (DNS) 解析成有效的 IP 位址。此參數由 LDAP CLD 外掛程式使用。 注意:在參數的每個部分中,host-name 必須相同且完全合格。例如: caldb.dwp.server.sesta.com.ip="sesta.com" |
"1" |
伺服器取得新網路連線之前積存請求的最大數目。 |
|
"2" |
資料庫連線協定服務用戶端連線至每個資料庫連線協定服務主機的連線初始數目。 |
|
"2" |
處理資料庫連線協定服務請求的執行緒初始數目。 |
|
"1000" |
使用資料庫連線協定服務的伺服器所允許的連線最大數目。 |
|
"20" |
使用資料庫連線協定服務的伺服器所允許的執行緒最大數目。 |
|
"no" |
指定伺服器是否執行所有資料庫連線協定服務請求的 MD5 (Message Digest 5) 單向雜湊檢查。(單向雜湊功能用於建立訊息認證的數位簽名。)
|
|
" " |
指定在指定機器的主機名稱中使用資料庫連線協定 (DWP) 服務之伺服器的 IP 位址。 |
|
"59779" |
指定在指定機器的主機名稱中使用資料庫連線協定 (DWP) 服務之伺服器的連接埠號。 |
|
" " |
在前端伺服器上,指定用於認證後端伺服器 DWP 連線的使用者 ID,其中 back-end-server 是該伺服器的名稱。 |
|
" " |
在前端伺服器上,指定用於認證後端伺服器 DWP 連線的密碼,其中 back-end-server 為該伺服器的名稱。 |
|
"65536" |
資料庫連線協定服務執行緒的堆疊大小。 |
|
無 |
LDAP 外掛程式用於行事曆尋找機制時要向其認證的基底 DN。 |
|
無 |
LDAP 外掛程式用於行事曆尋找機制時要存取之 LDAP 伺服器的主機名稱。 |
|
無 |
LDAP 外掛程式用於行事曆尋找機制時在 local.authldapbinddn 設定中指定的使用者連結憑證 (密碼)。 |
|
無 |
LDAP 外掛程式用於行事曆尋找機制時用於連結認證以搜尋使用者 DN 的 DN。 |
|
"389" |
LDAP 外掛程式用於行事曆尋找機制時要存取之 LDAP 伺服器的連接埠號。 |
|
"no" |
如果為 "yes",則僅載入 csapi.plugin.authentication.name 中指定的外掛程式,如果未指定,則按字母順序載入所有認證類別外掛程式。對於認證,則按字母順序使用每個外掛程式。 |
|
" " |
如果 csapi.plugin.loadall 為 "no" 且 csapi.plugin.authentication 為 "yes",則僅載入此特定的外掛程式。如果未指定或為空白 (" "),則載入所有認證類別外掛程式。 |
|
"0" |
資料庫連線協定服務記錄緩衝區的大小 (以位元組為單位)。 |
|
"604800" |
資料庫連線協定服務記錄檔過期之前的秒數。 |
|
"60" |
清除資料庫連線協定服務記錄檔緩衝區的間隔秒數。 |
|
"logs" |
資料庫連線協定服務記錄檔的目錄位置。 |
|
"Notice" |
決定伺服器將為資料庫連線協定服務記錄的詳細資訊層級。每個資料庫連線協定記錄項目均被指定以下層級之一 (從最嚴重的開始)︰Critical、Error、Warning、Notice、Information 和 Debug。如果您將此喜好設定設定為 Critical,伺服器將記錄最少的詳細資訊。如果您想要伺服器記錄最多的詳細資訊,請指定 Debug。例如,如果您指定 Warning,則僅記錄 Critical、Error 和 Warning 層級的記錄項目。 |
|
"10" |
記錄目錄中資料庫連線協定相關的記錄檔的最大數目。 |
|
"2097152" |
每個資料庫連線協定記錄檔的最大大小 (以位元組為單位)。 |
|
"20971520" |
用於儲存所有資料庫連線協定記錄檔的最大磁碟空間 (以位元組為單位)。 |
|
"5242880" |
需要用於記錄資料庫連線協定服務活動的最小可用磁碟空間 (以位元組為單位)。達到此值後,伺服器將嘗試透過清除舊記錄檔來釋放磁碟空間。如果空間無法被釋放,則所有記錄將暫停。 |
|
"86400" |
旋轉資料庫連線協定服務記錄檔之前的秒數。 |
|
" " |
在後端伺服器上,指定用於認證 DWP 連線的使用者 ID。此參數是選擇性的。如果後端伺服器未指定使用者 ID,則不會執行認證。 |
|
" " |
在後端伺服器上,指定用於認證 DWP 連線的密碼。此參數是選擇性的。如果後端伺服器未指定密碼,則不會執行認證。 |
|
"localhost" |
資料庫連線協定服務執行於其上之機器的主機名稱。 |
|
"1000" |
可並行運作的資料庫連線協定服務執行緒的最大數目。 |
|
"1" |
應在某個伺服器上執行之同步運作的資料庫連線協定 (DWP) 服務 (csdwpd) 程序的最大數目。 如需有關具有多個 CPU 的伺服器的資訊,請參閱21.8 使用跨多個 CPU 的負載平衡功能 |
|
"no" |
如果為 "yes",則在啟動所有服務時啟動 csdwpd 服務,並在停止所有服務時停止 csdwpd。 |
|
"86400" |
關閉閒置的資料庫連線協定服務的永久性連線之前的時間 (以秒為單位)。 |
|
"59779" |
資料庫連線協定服務偵聽的連接埠號。此值為 LDAP CLD 外掛程式的預設連接埠。 |
|
"yes" |
為資料庫連線協定 (csdwpd ) 服務的遠端使用者認證啟用 ("yes") 或停用 ("no") LDAP。 |
|
"yes" |
指定 Calendar Server 是先搜尋 LDAP 目錄然後搜尋行事曆資料庫 ("yes"),還是僅搜尋行事曆資料庫 ("no")。 |
下表說明 ics.conf 檔案中 LDAP 資料快取記憶體的配置參數。
表 E–14 LDAP 資料快取記憶體配置參數
參數 |
說明 |
---|---|
啟用 ("yes") 或停用 ("no") LDAP 資料快取記憶體。預設為 "no"。 |
|
指定檢查點執行緒靜止的秒數。預設時間為 "60" 秒。 |
|
指定是否移除舊的快取記憶體檔案。預設為 "yes"。 |
|
指定 LDAP 資料快取記憶體資料庫的實體位置。預設為 /var/opt/SUNWics5/csdb/ldap_cache。 |
|
指定檢查點檔案的最大大小 (以百萬位元組為單位)。預設為 "10" 百萬位元組。 |
|
指定 LDAP 資料快取記憶體資料庫執行緒的最大數目。預設為 "1000"。 |
|
指定共用記憶體的百萬位元組數目。預設為 "4" 百萬位元組。 |
|
指定 LDAP 資料快取記憶體項目的有效時間 (TTL) (以秒為單位)。預設為 "3600" 秒 (1 小時)。 |
|
指定是否在記錄檔中記錄對 LDAP 資料快取記憶體的存取情況並列印統計資料。預設為 "no"。 注意此參數僅適用於除錯模式。 |
|
指定各統計資料報告寫入記錄檔的間隔時間 (以秒為單位)。預設為 "1800" 秒 (30 分鐘)。 |
|
指定各資料庫清除作業之間的間隔時間 (以秒為單位)。預設為 "1800" 秒 (30 分鐘)。 |
若要配置群組和資源行事曆,請使用下表中的參數。
表 E–15 資源行事曆的配置參數
下表顯示您使用 Access Manager 時的 SSO 配置參數以及每個參數的預設值和說明。
表 E–16 ics.conf 檔案中的 SSO 配置參數 (透過 Access Manager)
下表顯示使用通訊伺服器信任圈技術時的 SSO 配置參數以及每個參數的預設值和說明。
表 E–17 ics.conf 檔案中使用通訊伺服器信任圈技術的 SSO 配置參數
下表顯示群組排程引擎 (GSE) 配置參數以及每個參數的預設值和說明。
表 E–18 ics.conf 檔案中的群組排程引擎 (GSE) 配置參數
下表列出用於配置資料庫處理的 ics.conf 參數,並提供每個參數的預設值及說明。
表 E–19 ics.conf 檔案中的資料庫配置參數
參數 |
預設值 |
說明 |
---|---|---|
.checkpointinterval |
"60" |
檢查點檢查資料庫作業事件的間隔秒數。 |
circularlogging |
"yes" |
如果為 "yes",則在同步化資料庫檢查點檔案的作業事件後移除這些檔案。請勿將其設定為 “no”,除非您已啟用自動備份。 |
deadlockinterval |
"100" |
檢查需要被打破的資料庫死結的間隔毫秒數。 |
homedir.path |
"." |
儲存資料庫事件、工作和警示檔案的目錄 (程式可執行檔的相對位置或指定的絕對路徑)。預設為 ".",其指定: /var/opt/SUNWics5/csdb |
logfilesizemb |
"10" |
資料庫檢查點檔案的最大百萬位元組。 |
maxthreads |
"10000" |
必須準備資料庫環境以容納的執行緒的最大數目。 |
mempoolsizemb |
"4" |
用於資料庫環境的共用記憶體的百萬位元組。 |
" " |
負責管理資料庫的使用者或別名的電子郵件。 |
|
"yes" |
如果為 "yes",將計數資料庫統計 (讀取、寫入和刪除)。 |
|
maxinstances |
"100" |
可以帶有計數器之行事曆的最大數目。使用 cscal 指令行公用程式可以為計數器啟用行事曆。 |
"en" |
指定 /etc/opt/SUNWics5/config 下包含本土化版本檔案的目錄,這些檔案可用於格式化電子郵件通知。 例如,"en" 指定英語本土化版本的目錄,"fr" 指定法語本土化版本的目錄。 |
|
"25" |
SMTP 主機的連接埠。 |
|
"no" |
定期檢查 Berkeley 資料庫是否處於死結狀態,如果是,則指示資料庫重設。 |
下表列出自動備份程序 (csstored) 使用的參數以及可用的預設值,並說明 ics.conf 參數。
表 E–20 自動備份程序使用的 ics.conf 參數
參數 |
預設值 |
說明 |
---|---|---|
defaultstore.log |
記錄檔的名稱。 |
|
"." |
記錄目錄的路徑。 |
|
path |
無 |
即時資料庫的路徑。 |
path |
無 |
歸檔備份的路徑。 |
path |
無 |
緊急備份的路徑。 |
enable |
"yes" |
啟用/停用自動歸檔備份。 |
enable |
"yes" |
啟用/停用自動緊急備份。 |
mindays |
"3" |
磁碟上保存的緊急備份副本的最小數目。 |
threshold |
"70" |
觸發清除舊的緊急備份副本的已佔用磁碟空間百分比。 |
interval |
"86400" |
每次備份之間的間隔 (以秒為單位)。預設為 24 小時,即 86400 秒。 |
mindays |
"3" |
磁碟上保存的歸檔備份副本的最小數目。 |
maxdays |
"7" |
磁碟上保存的歸檔備份副本的最大數目。 |
threshold |
"70" |
觸發清除舊的歸檔備份副本的已佔用磁碟空間百分比。 |
circularlogging |
"yes" |
啟用/停用管理備份副本數目及其佔用的磁碟空間。 |
interval |
"86400" |
每次備份相隔的時間 (以秒為單位)。 預設為 24 小時,即 86400 秒。 |
(不在 ics.conf 檔案中) |
"yes" |
允許使用 start-cal 啟動 csstored。如果您要禁止使用 start-cal 啟動 csstored,則必須將其增加至 ics.conf 檔案,並設定為 "no"。 |
下表說明用於配置行事曆資料庫的參數以及每個參數的預設值和說明。如果需要預設以外的值,您必須在 ics.conf 檔案中進行設定。
表 E–21 ENS 訊息的行事曆資料庫參數
可以將 Calendar Server 配置為使用稱為事件通知伺服器 (ENS) 的外部通用服務,該服務可接受按特定興趣分類的伺服器層級事件報告,並可通知其他已對特定種類的事件進行註冊的伺服器。Calendar Server 使用 ENS 來傳送和接收警示通知 (包括建立、刪除或修改行事曆事件和工作),以及一般作業警告和錯誤訊息。
下表顯示 ics.conf 中的事件通知伺服器 (Event Notification Server, ENS) 配置參數,以及每個參數的預設值和說明。
表 E–22 ics.conf 檔案中的事件通知伺服器 (ENS) 配置參數
下表顯示 Calendar Server API (CSAPI) 配置參數以及每個參數的預設值和說明。
表 E–23 ics.conf 檔案中的 CSAPI 配置參數
Calendar Server 計數器 (統計) 配置參數位於以下檔案中︰
/etc/opt/SUNWics5/config/counter.conf
counter.conf 檔案為 ASCII 文字檔案,每行定義一個計數器及其參數︰名稱、類型、大小 (以位元組為單位) 和說明。包含空格的參數必須置於雙引號 (" ") 中。註釋行必須以驚嘆號 (!) 開頭。註釋行僅用於提供資訊。
計數器名稱的第一部分可識別與 csstats 公用程式配合使用的計數器物件。如需有關指令行公用程式的更多資訊,請參閱附錄 DCalendar Server 指令行公用程式參照。
請勿修改 counter.conf 檔案,除非用戶支援人員指導您這樣做。
本小節說明 Calendar Server counter.conf 參數,包括︰
下表顯示每個警示計數器的名稱、類型、大小和說明。
表 E–24 counter.conf 檔案中的警示計數器
名稱 |
類型 |
大小 |
說明 |
---|---|---|---|
GAUGE |
4 |
最高記錄值。 |
|
GAUGE |
4 |
最低記錄值。 |
|
GAUGE |
4 |
目前監視值。 |
|
GAUGE |
4 |
警告狀態︰是 (1) 或否 (0)。 |
|
COUNTER |
4 |
超出臨界值的次數。 |
|
COUNTER |
4 |
已傳送的警告數目。 |
|
TIME |
4 |
最後一次設定目前值的時間。 |
|
TIME |
4 |
最後一次傳送警告的時間。 |
|
TIME |
4 |
最後一次執行重設的時間。 |
|
TIME |
4 |
最後一次變更警示狀態的時間。 |
下表顯示每個磁碟使用計數器的名稱、類型、大小和說明。
表 E–25 counter.conf 檔案中的磁碟使用計數器
名稱 |
類型 |
大小 |
說明 |
---|---|---|---|
GAUGE |
5 |
磁碟分割區中的可用空間總量。 |
|
TIME |
4 |
最後一次取得統計資料的時間。 |
|
STRING |
512 |
行事曆分割區路徑。 |
|
GAUGE |
4 |
磁碟分割區的可用空間百分比。 |
|
GAUGE |
5 |
磁碟分割區的空間總量。 |
下表顯示每個 HTTP 計數器的名稱、類型、大小和說明。
表 E–26 counter.conf 檔案中的 HTTP (httpstat) 計數器
名稱 |
類型 |
大小 |
說明 |
---|---|---|---|
GAUGE |
4 |
平均連線回應時間。 |
|
TIME |
4 |
Calendar Server 的啟動時間。 |
|
TIME |
4 |
最後一次接受新用戶端連線的時間。 |
|
COUNTER |
4 |
允許的並行運作連線的最大數目。 |
|
COUNTER |
4 |
允許的 WCAP 階段作業的最大數目。 |
|
COUNTER |
4 |
允許的連線的總數。 |
|
GAUGE |
4 |
作用中連線的目前數目。 |
|
GAUGE |
4 |
WCAP 階段作業的目前數目。 |
|
COUNTER |
4 |
允許的失敗連線的總數。 |
|
COUNTER |
4 |
由目前 HTTP 伺服器提供服務之成功登入的數目。 |
|
COUNTER |
4 |
由目前 HTTP 伺服器提供服務之失敗登入的數目。 |
下表顯示每個群組排程引擎 (GSE) 計數器的名稱、類型、大小和說明。
表 E–27 counter.conf 檔案中的群組排程引擎 (GSE) 計數器
名稱 |
類型 |
大小 |
說明 |
---|---|---|---|
TIME |
4 |
GSE 最後一次喚醒並處理工作的時間。 |
|
TIME |
4 |
GSE 最後一次處理工作的時間。 |
|
COUNTER |
4 |
GSE 所處理的工作總數。 |
|
COUNTER |
4 |
作用中工作者執行緒的總數。 |
下表顯示每個認證計數器的名稱、類型、大小和說明。
表 E–28 counter.conf 檔案中的認證 (authstat) 計數器
名稱 |
類型 |
大小 |
說明 |
---|---|---|---|
TIME |
4 |
使用者最後一次登入的時間。 |
|
COUNTER |
4 |
允許的成功登入的總數。 |
|
COUNTER |
4 |
允許的失敗登入的總數。 |
下表顯示每個 WCAP 計數器的名稱、類型、大小和說明。
表 E–29 counter.conf 檔案中的 WCAP (wcapstat) 計數器
名稱 |
類型 |
大小 |
說明 |
---|---|---|---|
COUNTER |
4 |
WCAP 請求的總數。 |
下表顯示每個資料庫計數器的名稱、類型、大小和說明。
表 E–30 counter.conf 檔案中的資料庫 (dbstat) 計數器
名稱 |
類型 |
大小 |
說明 |
---|---|---|---|
COUNTER |
4 |
資料庫讀取作業的總次數。 |
|
COUNTER |
4 |
資料庫寫入作業的總次數。 |
|
COUNTER |
4 |
資料庫刪除作業的總次數。 |
|
TIME |
4 |
資料庫最後一次讀取的時間。 |
|
TIME |
4 |
資料庫最後一次寫入的時間。 |
|
TIME |
4 |
資料庫最後一次刪除的時間。 |
下表顯示每個伺服器回應計數器的名稱、類型、大小和說明。
表 E–31 counter.conf 檔案中的伺服器回應計數器
名稱 |
類型 |
大小 |
比例 |
說明 |
---|---|---|---|---|
TIME |
4 |
最後一次取得統計資料的時間。 |
||
GAUGE |
4 |
2 |
伺服器回應時間 (以毫秒為單位)。 |
下表顯示每個階段作業狀態計數器的名稱、類型、大小和說明。
表 E–32 counter.conf 檔案中的階段作業狀態計數器
名稱 |
類型 |
大小 |
比例 |
說明 |
---|---|---|---|---|
COUNTER |
4 |
4 |
允許的 HTTP 階段作業的最大數目。 |
|
GAUGE |
4 |
2 |
HTTP 階段作業的目前數目。 |
Calendar Server 可傳送E.4.1 Calendar Server 電子郵件通知配置參數和格式檔案中說明的電子郵件訊息類型。這些訊息的格式由表中列出的關聯格式 (.fmt) 檔案控制。格式檔案位於以下目錄中每個語言環境 (例如 /en 為英文,/fr 為法語) 的特定目錄中︰
/etc/opt/SUNWics5/config
例如,英文版本的工作 (待辦事項) 警示訊息格式在以下檔案中指定︰
/etc/opt/SUNWics5/config/en/mail_todoalarm.fmt
本小節說明以下內容:
下表顯示每個 Calendar Server Mail 參數的郵件類型、ics.conf 參數名稱、預設格式檔案說明以及收件者。
表 E–33 ics.conf 檔案中的 Calendar Server 電子郵件格式
訊息類型 |
參數 |
格式檔案 (預設) |
說明 |
收件者 |
---|---|---|---|---|
事件發佈 |
fname |
宣佈事件或現有事件的變更 |
通知中列出的人員 |
|
事件取消 |
fname |
宣佈事件取消 |
通知中列出的人員 |
|
回覆事件 |
fname |
回覆事件通知。 |
通知中列出的人員 |
|
請求事件 |
fname |
訂閱事件通知。 |
通知中列出的人員 |
|
事件警示 |
fname |
提醒即將發生的事件 |
提醒通知中列出的人員 |
|
週期性事件通知 |
notificationrecur.fname |
"mail_event notificationrecur.fmt" |
週期性事件的通知 |
通知中列出的人員 |
事件取消通知 |
notification.fname |
notification.fmt" |
已取消事件的通知 |
通知中列出的人員 |
週期性事件取消通知 |
notificationrecur.fname |
notificationrecur.fmt" |
已取消的週期性事件的通知 |
通知中列出的人員 |
與會者回覆:接受通知 |
notification.fname |
notification.fmt" |
將與會者已接受邀請這一事項通知事件組織者。 |
事件組織者 |
與會者回覆:拒絕通知 |
notification.fname |
notification.fmt" |
將與會者已拒絕邀請這一事項通知事件組織者。 |
事件組織者 |
與會者回覆:暫訂接受通知 |
acceptnotification.fname |
acceptnotification.fmt" |
將與會者已暫訂接受邀請這一事項通知事件組織者。 |
事件組織者 |
與會者回覆:週期性事件的接受通知 |
notificationrecur.fname |
notificationrecur.fmt" |
將與會者已接受週期性事件邀請這一事項通知事件組織者。 |
事件組織者 |
與會者回覆:週期性事件的拒絕通知 |
notificationrecur.fname |
notificationrecur.fmt" |
將與會者已拒絕週期性事件邀請這一事項通知事件組織者。 |
事件組織者 |
與會者回覆:週期性事件的暫訂接受通知 |
tentativeaccept notificationrecur.fname |
acceptnotificationrecur.fmt" |
將與會者已暫訂接受週期性事件邀請這一事項通知事件組織者。 |
事件組織者 |
工作發佈 |
fname |
宣佈工作或現有工作的變更 |
通知中列出的人員 |
|
工作取消 |
宣佈工作取消 |
通知中列出的人員 |
||
回覆工作 |
fname |
回覆工作通知 |
通知中列出的人員 |
|
待辦事項請求 |
fname |
訂閱待辦事項通知。 |
通知中列出的人員 |
|
工作警示 |
fname |
提醒即將執行的工作 |
提醒通知中列出的人員 |
Calendar Server 透過將特定事件或工作與格式檔案內容相結合,來產生通知訊息。事件或工作中資料欄位的值可輸出至訊息。通知訊息還可以包含 MIME 標頭行及關聯的特殊值。使用特殊字元序列 (格式記號),您可以在訊息中包含事件、工作和 MIME 標頭的值。格式檔案中的行是特殊字元序列組成的格式字串,在產生郵件訊息時,這些字串將由行事曆資料欄位的實際值所取代。特殊字元序列由兩個字元組成,第一個為百分比符號 (%),第二個表示特定格式記號。
以下小節說明特殊字元序列︰
下表顯示事件通知所使用的特殊字元序列的格式代碼和含義。
表 E–34 事件通知的特殊字元序列
格式代碼 |
涵義 |
---|---|
%0 |
本土化格式的起始時間 |
%1 |
本土化格式的結束時間 |
%A |
iCalendar 格式的 exdates (以分號分隔的 ISO 8601 日期字串清單,可列出要排除的日期) |
%a |
iCalendar 格式的 rdates (以分號分隔的 ISO 8601 日期字串清單,可列出週期性日期) |
%B |
起始時間 (另請參閱 %Z) |
%b |
輸出 iCalendar 格式的起始時間和結束時間。如果起始時間參數具有等於日期的值,則僅輸出日期的月/日/年部分。如果結束時間包含與起始時間相同的月/日/年的值,則僅產生起始時間。 |
%C |
建立時間 |
%c |
事件類別 |
%d |
事件說明。(另請參閱 %F) |
%E |
結束時間 (另請參閱 %Z) |
%e |
iCalendar 格式的異常規則 |
%F |
事件說明 - 可換行,iCalendar 格式 (另請參閱 %d) |
%G |
事件的地理位置 (緯度和經度) |
%g |
組織者的電子郵件位址。(不保證此值的可靠性。) |
%K |
mailto:url 格式的組織者電子郵件 |
%k |
警示計數 |
%L |
位置 |
%l |
iCalendar 格式的週期性規則 |
%M |
修改時間 |
%N |
新一行 |
%n |
與 DTSTAMP 配合使用的目前時間戳記 |
%P |
優先順序 |
%r |
週期性 ID (如果此事件不重複發生,則為空白) |
%S |
事件序列號碼 |
%s |
摘要 |
%t |
事件狀態 |
%U |
唯一的事件識別碼 |
%Z |
與時間欄位代碼合用,以強制時間在 UTC 中被描繪。(%B 以本地時間顯示起始時間,而 %ZB 以 UTC 時間顯示起始時間。) |
%% |
顯示百分比 (%) 字元 |
% |
指定由代碼識別的資料的子格式。(如需詳細資訊,請參閱E.4.3 Calendar Server 通知日期子格式字串。) |
日期時間值可採用多種不同的格式。使用子格式,您可以提供附加資訊以說明日期時間值應採用何種格式。如果未指定子格式,伺服器將使用預設格式來輸出日期。使用子格式欄位可讓您指定要使用的確切格式。
例如,%B 指定輸出字串包含事件的起始時間。此預設格式可輸出日期、時間、時區以及有關日期的所有可能內容。日期值的子格式字串為 strftime 格式字串 (請參閱E.4.6 日期的特殊字元序列)。如果您僅需要起始時間的月份和年份,則不應使用 %B,而應使用:%(%m %Y)B。
以下範例︰
The event begins: %B%N The event ends: %(%b %d, %Y %I:%M %p)E%N |
可產生類似以下通知的輸出︰
The event begins Feb 02, 1999 23:30:00 GMT Standard Time The event ends Feb 03, 1999 02:30 AM |
title: %S%N start: %B%N end: %E%N |
可產生類似以下通知的輸出︰
title: Staff Meeting start: Feb 04, 1999 09:00:00 end: Feb 04, 1999 10:00:00 |
但是,以下兩個條件可讓上述範例產生易誤解或錯誤的結果︰
如果事件沒有結束時間
如果事件是在同一天開始並結束的「整日」事件
在這些情況下,最好不要列印結束時間。依預設,當時間戳記具有 all-day 屬性時,僅列印年、月和日。此外,如果事件起始時間具有 all-day 屬性,且事件在開始當天結束,則會設定特殊的條件式旗標。僅當未設定特殊的條件式旗標時才使用 ? 修飾鍵來列印條件式值。
例如,如果您將上述範例中的行變更為︰
title: %S%N start: %B%N end: %?E%N |
同一天開始和結束的整日事件的最後一行將不會列印。它將為典型整日事件 (如生日或紀念日) 產生以下輸出︰
title: Staff Meeting start: Feb 04, 1999 |
? 旗標可與其他修飾鍵結合使用。例如:
The event ends: %?(%b %d, %Y %I:%M %p)E%N
下表顯示工作通知的特殊字元序列的格式代碼和含義。
表 E–35 工作通知的特殊字元序列
格式代碼 |
涵義 |
---|---|
%A |
iCalendar 格式的 exdates (以分號分隔的 ISO 8601 日期字串清單,可列出要排除的日期) |
%a |
iCalendar 格式的 rdates (以分號分隔的 ISO 8601 日期字串清單,可列出週期性日期) |
%B |
起始時間 (另請參閱 %Z) |
%C |
建立時間 |
%c |
工作類別 |
%D |
截止日期和時間。 |
%d |
工作說明。(另請參閱 %F) |
%E |
IMIP 格式的截止日期和時間 |
%e |
iCalendar 格式的異常規則 |
%F |
工作說明 - 可換行,iCalendar 格式 (另請參閱 %d) |
%G |
此工作的地理位置、緯度和經度。 |
%g |
組織者的電子郵件位址 (無法保證此值的可靠性) |
%K |
mailto:URL 格式的組織者電子郵件 |
%k |
警示計數 |
%L |
位置 |
%l |
iCalendar 格式的週期性規則 |
%M |
修改時間 |
%N |
新一行 |
%n |
"now" (目前的時間戳記,與 DTSTAMP 配合使用) |
%P |
優先順序 |
%r |
週期性 ID (如果此工作不週期性出現,則為空白) |
%S |
工作的序列號碼 |
%s |
摘要 |
%t |
狀態 |
%U |
UID |
%Z |
與時間欄位代碼結合使用,以強制時間以 UTC 格式描繪 (%B 以本地時間顯示起始時間,而 %ZB 以 UTC 時間顯示起始時間) |
%% |
顯示 % 字元 |
% (子格式代碼) |
為代碼所識別的資料指定子格式 (如需詳細資訊,請參閱E.4.3 Calendar Server 通知日期子格式字串) |
下表顯示日期特殊字元序列的格式代碼和含義。
本小節中出現的特殊日期格式代碼僅為方便使用。Calendar Server 不會重寫任何代碼,而僅使用作業系統所採用的日期格式。
格式代碼 |
涵義 |
---|---|
%a |
縮寫的工作日名稱 |
%A |
完整的工作日名稱 |
%b |
縮寫的月份名稱 |
%B |
完整的月份名稱 |
%c |
適用於語言環境的日期和時間表示方法 |
%d |
一月中的某天,十進位數字 (01 - 31) |
%H |
24 小時制的小時 (00 - 23) |
%I |
12 小時制的小時 (01 - 12) |
%j |
一年中的某天,十進位數字 (001 - 366) |
%m |
月份,十進位數字 (01 - 12) |
%M |
分鐘,十進位數字 (00 - 59) |
%p |
目前語言環境的上午/下午指示器 (12 小時制時鐘) |
%S |
秒,十進位數字 (00 - 59) |
%U |
一年中的某一週 (十進位數字),以星期日做為一週的第一天 ( 00 - 53) |
%w |
工作日,十進位數字 (0 - 6;星期日為 0) |
%W |
一年中的某一週 (十進位數字),以星期一做為一週的第一天 ( 00 - 53) |
%x |
目前語言環境的日期表示方法 |
%X |
目前語言環境的時間表示方法 |
%y |
不包含世紀的年份,十進位數字 (00 - 99 ) |
%Y |
包含世紀的年份,十進位數字 |
%Z |
時區名稱或縮寫;如果時區未知,則無字元 |
%% |
百分比符號 |
以下範例顯示預設事件提醒通知訊息格式︰
1 EVENT REMINDER 2 ~~MIME-Version: 1.0%N 3 ~~Content-Type: text/plain; charset=%s%N 4 ~~Content-Transfer-Encoding: %x%N%N 5 Summary: %s%N 6 Start: %(%a, %d %b %Y %I:%M %p)B%N 7 End: (%a, %d %b %Y %I:%M %p)E%N 8 Location: %L%N%N 9 Description: %N%d%N |
此範例中每行的說明如下︰
第 1 行為訊息主題。
第 2 行以 ~~ 開頭,指示此行為 MIME 包裝程式行。即特殊字元序列的取代與內部 MIME 物件 (而不是事件或工作) 關聯。特殊序列 %N 可以換行。主題行不需要特殊的新行序,但其他所有行均需要。
第 3 行也是 MIME 標頭行。它包含特殊字元序列 %s,此特殊字元序列將由與傳送的事件或工作關聯的字元集替代。
第 4 行為最後一個 MIME 行,%x 為此訊息所需的內容傳輸編碼字串。
第 5 行列出事件摘要並以 %s 呼叫事件摘要。
第 6 行列出事件起始時間。它利用了特殊字元序列 %B 上的子格式字串。如需詳細資訊,請參閱E.4.3 Calendar Server 通知日期子格式字串。
第 7 行列出事件結束時間。
第 8 行列出事件的位置。
第 9 行列出事件的說明。
以下範例類似上述範例產生的通知訊息︰
From: jsmith@sesta.com (James Smith) Date: Wed, 15 Nov 1999 19:13:49 To: jsmith@sesta.com Subject: EVENT REMINDER MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Summary: smtp_rig event 1 Start: Tues, 16 Nov 1999 02:00 PM End: Tues, 16 Nov 1999 03:00 PM Location: Green Conference Room Description: This is the description for a randomly generated event. |
以下範例顯示較為複雜的多重訊息。此範例包含文字部分和 IMIP PUBLISH 部分。
EVENT PUBLICATION ~~MIME-Version: 1.0%N ~~Content-Type: multipart/mixed; boundary="%b"%N%N This is a multi-part message in MIME format.%N ~~--%b%N ~~Content-Type: text/plain; charset=%s%N ~~Content-Transfer-Encoding: %x%N%N Summary: %s%N Start: %(%a, %d %b %Y %I:%M %p)B%N End: %(%a, %d %b %Y %I:%M %p)E%N Location: %L%N%N Description: %N%d%N%N ~~--%b%N ~~Content-Type: text/calendar; method=%m; component=%c; charset=%s%N ~~Content-Transfer-Encoding: %x%N%N BEGIN:VCALENDAR%N PRODID:-//iPlanet/Calendar Hosting Server//EN%N METHOD:PUBLISH%N VERSION:2.0%N BEGIN:VEVENT%N ORGANIZER:%K%N DTSTAMP:%Zn%N DTSTART:%ZB%N DTEND:%ZE%N SUMMARY:%s%N UID:%U%N %R %A %a %e %l SEQUENCE:%S%N LOCATION:%L%N GEO:%G%N %F STATUS:%t%N END:VEVENT%N END:VCALENDAR%N ~~--%b-- |