IBM Books

Net.Data 參考手冊

Web 登記函數

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

限制：當使用 OS/2 時， 不要在 registry、registryVariable 與 registryData 參數中使用星號（*）。

DTWR_ADDENTRY


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

目的

將登錄新增至 Web 登記。

格式

@DTWR_ADDENTRY(registry, registryVariable, registryData, index)

@DTWR_ADDENTRY(registry, registryVariable, registryData)

值

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

範例

範例 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 OS/2 OS/390 OS/400 SCO SUN Win NT
X X X
X X X X

目的

從 Web 登記清除登錄。

格式

@DTWR_CLEARREG(registry)

值

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

範例

範例 1： 

@DTWR_CLEARREG("Myregistry")

DTWR_CLOSEREG


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




X


目的

關閉 Web 登記

格式

@DTWR_CLOSEREG(registry)

值

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

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

範例

範例 1：關閉登記 

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

DTWR_CREATEREG


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

目的

建立一個新的 Web 登記。

Re

格式

@DTWR_CREATEREG(registry, security)

@DTWR_CREATEREG(registry)

值

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

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

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

範例

範例 1： 

@DTWR_CREATEREG("myRegistry")

範例 2： 

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

DTWR_DELENTRY


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

目的

從 Web 登記中刪除登錄。

格式

@DTWR_DELENTRY(registry, registryVariable, index)

@DTWR_DELENTRY(registry, registryVariable)

值

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

範例

範例 1： 

@DTWR_DELENTRY("Myregistry", "Jones")

範例 2： 

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

DTWR_DELREG


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

目的

刪除 Web 登記

格式

@DTWR_DELREG(registry)

值

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

範例

範例 1： 

@DTWR_DELREG("Myregistry")

DTWR_LISTREG


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

目的

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

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

在表格中一定是 2 直欄。 表格的「直欄」表頭將由「Web 登記」語言環境設定為 "REGISTRY_VARIABLE" 和 "REGISTRY_DATA"。

格式

@DTWR_LISTREG(registry, registryTable)

值

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

範例

範例 1： 

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

DTWR_LISTSUB


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







X

目的

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

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

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

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

格式

@DTWR_LISTSUB(registry, registryTable)

值

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

範例

範例 1： 

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

DTWR_OPENREG


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




X


目的

開啟 Web 登記。

格式

@DTWR_OPENREG(registry, commit)

@DTWR_OPENREG(registry)

值

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

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

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

範例

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

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

DTWR_RTVENTRY


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

目的

從 Web 登記中取回 registryData 字串。

格式

@DTWR_RTVENTRY(registry, registryVariable, registryData, index)

@DTWR_RTVENTRY(registry, registryVariable, registryData)

@DTWR_rRTVENTRY(registry, registryVariable, index)

@DTWR_rRTVENTRY(registry, registryVariable)

值

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

範例

範例 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 OS/2 OS/390 OS/400 SCO SUN Win NT
X X X
X X X X

目的

將所指定之登記的舊有 registryData 字串值置換成由呼叫者所指定的新值。無法變更 registryVariable 字串。

格式

@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)

@DTWR_UPDATEENTRY(registry, registryVariable, newData)

值

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

範例

範例 1： 

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

範例 2： 

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

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