IBM 書籍

參考手冊

Web 登記函數

Web 登記是一個讓您能輕易地新增、取回和刪除登錄而由 Net.Data 來維護鍵的檔案，您可以在一個單一系統上建立多重 Net.Data Web 登記。每個登記都具有一個名稱，並且可以包含多重登錄。Net.Data 提供 函數來維護登記和其所包含之登錄。

限制：

DTWR_ADDENTRY


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

將登錄新增至 Web 登記。

格式

@DTWR_ADDENTRY(registry, registryVariable, registryData, index)

@DTWR_ADDENTRY(registry, registryVariable, registryData)

參數

表 187. DTWR_ADDENTRY 參數

資料類型 參數 使用 說明
字串 registry IN 一個要新增登錄的登記名稱。
字串 registryVariable IN 所要新增之登記 registryVariable 字串部分的值。
字串 registryData IN 所要新增之登記 registryData 字串部分的值。
字串 index IN 在所要新增之索引登錄中， registryVariable 字串索引部分的值。這個參數是可選用的。如果有指定的話， 將會把一個索引的登錄新增至所指定的登記中。

回覆碼

表 188. DTWR_ADDENTRY 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3003 Web 登記內建函數無法在指定的登記中新增登錄，因為指定的登錄已存在。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3006 Web 登記內建函數無法建立指定的登記， 因為登記名稱中的路徑不存在。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

範例

範例 1： 

@DTWR_ADDENTRY("Myregistry", "Jones", "http://Advantis.com/~Jones/webproj")

範例 2： 

@DTWR_ADDENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/",
     "WORK_URL,")

DTWR_CLEARREG


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

從 Web 登記清除登錄。

格式

@DTWR_CLEARREG(registry)

參數

表 189. DTWR_CLEARREG 參數

資料類型 參數 使用 說明
字串 registry IN 所要清除的登記名稱。

回覆碼

表 190. DTWR_CLEARREG 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3006 Web 登記內建函數無法建立指定的登記， 因為登記名稱中的路徑不存在。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

範例

範例 1： 

@DTWR_CLEARREG("Myregistry")

DTWR_CLOSEREG


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT





X


目的

關閉 Web 登記

格式

@DTWR_CLOSEREG(registry)

參數

表 191. DTWR_CLOSEREG 參數

資料類型 參數 使用 說明
字串 registry IN 要關閉的登記名稱。

限制：在 Web 登記名稱中，不要使用特殊字元， 例如星號（*）與反斜線（\）。

回覆碼

表 192. DTWR_CLOSEREG 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。

範例

範例 1：關閉登記 

@DTWR_CLOSEREG("/qsys.lib/mylib.lib/myreg.file")

DTWR_CREATEREG


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

建立一個新的 Web 登記。

格式

@DTWR_CREATEREG(registry, security)

@DTWR_CREATEREG(registry)

參數

表 193. DTWR_CREATEREG 參數

資料類型 參數 使用 說明
字串 registry IN 所要建立的登記名稱。

限制：在 Web 登記名稱中，不要使用特殊字元， 例如星號（*）與反斜線（\）。

字串 security IN 要建立 registry 所要有的保密類型。在 UNIX 作業系統上， 預設安全與建立登記的目錄是相同的。為 3 個安全群組指定安全： 使用者、群組、和公用。R 提供讀取許可權、W 提供寫入許可權、 而 X 提供執行許可權。例如，若要提供所有 3 個群組完全的權限， 請將這個參數指定為 *RWX，*RWX，*RWX。這個參數是可選用的。

回覆碼

表 194. DTWR_CREATEREG 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3002 Web 登記內建函數無法刪除指定的登記。
3006 Web 登記內建函數無法建立指定的登記， 因為登記名稱中的路徑不存在。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。
3008 Web 登記內建函數無法建立指定的登記，原因不明。

範例

範例 1： 

@DTWR_CREATEREG("myRegistry")

範例 2： 

@DTWR_CREATEREG("URLLIST", "*RWX, *RWX, *R")

DTWR_DELENTRY


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

從 Web 登記中刪除登錄。

格式

@DTWR_DELENTRY(registry, registryVariable, index)

@DTWR_DELENTRY(registry, registryVariable)

參數

表 195. DTWR_DELENTRY 參數

資料類型 參數 使用 說明
字串 registry IN 從中除去登錄的登記名稱。
字串 registryVariable IN 所要除去之登錄的 registryVariable 字串部分的值。
字串 index IN 在索引的登錄中，registryVariable 字串之索引部分的值。 這是一個可選用的參數。 如果指定的話，從登記中將索引的登錄除去。

回覆碼

表 196. DTWF_DELENTRY 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3004 Web 登記內建函數無法在指定的登記中除去或取回登錄，因為指定的登錄不存在。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

範例

範例 1： 

@DTWR_DELENTRY("Myregistry", "Jones")

範例 2： 

@DTWR_DELENTRY("URLLIST", "SMITH", "WORK_URL")

DTWR_DELREG


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

刪除 Web 登記

格式

@DTWR_DELREG(registry)

參數

表 197. DTWR_DELREG 參數

資料類型 參數 使用 說明
字串 registry IN 要刪除登記的名稱。

回覆碼

表 198. DTWR_DELREG 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

範例

範例 1： 

@DTWR_DELREG("Myregistry")

DTWR_LISTREG


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

列示 Web 登記的目次。

格式

@DTWR_LISTREG(registry, registryTable)

參數

表 199. DTWR_LISTREG 參數

資料類型 參數 使用 說明
字串 registry IN 所要列示的登記名稱。
表格 registryTable OUT 放置登記之表格變數的名稱。

回覆碼

表 200. DTWR_LISTREG 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1004 函數呼叫上傳遞的參數必須是 Net.Data 巨集表變數，但卻是不同的變數類型。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1006 文字字串傳遞給函數呼叫中的參數， 但此參數必須是輸出參數。
1007 參數包含的值無效。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

用法注意事項

DTWR_LISTREG 傳回由使用者所傳送之 OUT 表格變數中的有關登記的資訊。表格變數在被當作參數般傳送至 FUNCTION 區塊以供 LISTREG 登記作業使用之前， 已在使用者巨集中定義過了。

如果使用者為表格的最大列數而使用 ALL 選項來定義表格變數，則這個作業會列示所有在表格中可用的登記， 每個表格列都有一個。換句話說，如果使用者將表格列的最大數目指定為值 X， 然後若在所指定的登記中的登錄多於 X 個登錄， 則將只有前 X 個登錄會被列示出來且將會傳回一個錯誤碼， 以表示因為可用來列示其它登錄的表格列不足， 所以只可完成部分的列示。如果值 X 超過在指定之登記中可用登錄的數目的話， 則將會列示出所有的登記登錄。

在表格中一定是 2 直欄。 表格的「直欄」表頭設定為 REGISTRY_VARIABLE 和 REGISTRY_DATA。

範例

範例 1： 

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTREG("URLLIST", RegistryTable)

DTWR_LISTSUB


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT








X

目的

列示在 Web 登記中的立即子鍵。

格式

@DTWR_LISTSUB(registry, registryTable)

參數

表 201. DTWR_LISTSUB 參數

資料類型 參數 使用 說明
字串 registry IN 所要列示的登記名稱。
表格 registryTable OUT 放置登記之表格變數的名稱。

回覆碼

表 202. DTWR_LISTSUB 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1006 文字字串傳遞給函數呼叫中的參數， 但此參數必須是輸出參數。
1007 參數包含的值無效。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

用法注意事項

  1. DTWR_LISTSUB 傳回有關由使用者傳回在 OUT 表格參數中的登記。在表格變數被當作參數傳送至 LISTSUB 登記作業之前， 將會在巨集中對表格變數下定義。

    如果使用者為表格的最大列數而使用 ALL 選項來定義表格變數，則這個作業會列示在表格中所有可用的登記， 每個表格列都有一個。換句話說，如果使用者將表格列的最大數目指定為 X， 然後若在所指定的登記中的登錄多於 X 個登錄， 則將只有前 X 個登錄會被列示出來且將會傳回一個錯誤碼， 以表示因為可用來列示其它登錄的表格列不足， 所以只可完成部分的列示。如果值 X 超過在指定之登記中可用登錄的數目的話， 則將會列示出所有的登記登錄。在表格中的直欄數一定是一。

    表格的直欄表頭將被設定為 "REGISTRY_SUBKEY"。

  2. 這個函數只有在「Windows95 系統登記」相容的作業系統上才有效。

範例

範例 1： 

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTSUB("URLLIST", RegistryTable)

DTWR_OPENREG


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT





X


目的

開啟 Web 登記。

格式

@DTWR_OPENREG(registry, commit)

@DTWR_OPENREG(registry)

參數

表 203. DTWR_OPENREG 參數

資料類型 參數 使用 說明
字串 registry IN 要開啟的登記名稱。
字串 commit IN 單一符號或文字字串，用來指定是否要在確定控制下開啟登記。可能值如下：

Y
在確定控制下開啟登記。

N
不在確定控制下開啟登記。
預設值為 N

回覆碼

表 204. DTWR_OPENREG 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

範例

範例 1：在確定控制下開啟登記 

@DTWR_OPENREG("/qsys.lib/mylib.lib/myreg.file", "Y")

DTWR_RTVENTRY


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

從 Web 登記取回登記字串值。

格式

@DTWR_RTVENTRY(registry, registryVariable, registryData, index)

@DTWR_RTVENTRY(registry, registryVariable, registryData)

@DTWR_rRTVENTRY(registry, registryVariable, index)

@DTWR_rRTVENTRY(registry, registryVariable)

參數

表 205. DTWR_RTVENTRY 參數

資料類型 參數 使用 說明
字串 registry IN 具有所要取回登錄之登記的名稱。
字串 registryVariable IN 其 registryData 字串被取回之登記登 錄之 registryVariable 字串部分的值。
字串 registryData OUT 傳回符合 registryVariable 之登記之 registryData 字串部分的值。
字串 index IN 其被傳回之 registryData 字串之索引登錄中的 registryVariable 字串索引部分的值。 這是一個可選用的參數。 如果有指定的話，將會傳回索引之登錄的 registryData 字串。

回覆碼

表 206. DTWR_RTVENTRY 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1006 文字字串傳遞給函數呼叫中的參數， 但此參數必須是輸出參數。
1007 參數包含的值無效。
3004 Web 登記內建函數無法在指定的登記中除去或取回登錄，因為指定的登錄不存在。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

範例

範例 1： 

%DEFINE RegistryData = ""
@DTWR_RTVENTRY("Myregistry", "Jones", RegistryData)

範例 2： 

@DTWR_RTVENTRY("URLLIST", "SMITH", RegistryData, "WORK_URL")

範例 3： 

@DTWR_rRTVENTRY("Myregistry", "Jones")

範例 4： 

@DTWR_rRTVENTRY("URLLIST", "SMITH", "WORK_URL")

DTWR_UPDATEENTRY


AIX HP-UX Linux OS/2 OS/390 OS/400 SCO SUN Win NT
X

X
X

X

目的

更新 Web 登記中的登記字串值。

格式

@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)

@DTWR_UPDATEENTRY(registry, registryVariable, newData)

參數

表 207. DTWR_UPDATEENTRY 參數

資料類型 參數 使用 說明
字串 registry IN 具有所要更新之登錄的登記名稱。
字串 registryVariable IN 所要更新之登記的 registryVariable 字串部分的值。
字串 newData IN 所要更新之登記的 registryData 字串部分的新值。
字串 index IN 在所要更新之索引登錄中， registryVariable 字串索引部分的值。 這是一個可選用的參數。 如果指定的話，將會更新索引登錄。

回覆碼

表 208. DTWR_UPDATEENTRY 回覆碼

回覆碼 說明
-1001 伺服器無法處理 Net.Data 的配置記憶體要求。
1001 輸入參數包含 NULL 值。
1002 輸入參數包含的字串有空字元結尾。
1003 函數呼叫中傳遞的參數超過容許數目，或少於函數要求的最小數目。
1005 函數呼叫上傳遞的參數必須是字串變數，但卻是不同的變數類型。
1007 參數包含的值無效。
3003 Web 登記內建函數無法在指定的登記中新增登錄，因為指定的登錄已存在。
3004 Web 登記內建函數無法在指定的登記中除去或取回登錄，因為指定的登錄不存在。
3005 Web 登記內建函數無法使用指定的登記，因為找不到此登記。
3007 Web 登記內建函數無法完成指定的作業， 因為要求者對於指定的登記並無適當的權限。

用法注意事項

不能變更對應到值的登錄項目名稱。

範例

範例 1： 

@DTWR_UPDATEENTRY("Myregistry", "Jones", "http://advantis.com/~Jones/personal")

範例 2： 

@DTWR_UPDATEENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/personal", "WORK_URL")

[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]