AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X |
|
| X |
| X |
|
| X |
Purpose
Adds an entry to a Web registry.
Format
@DTWR_ADDENTRY(registry, registryVariable, registryData, index)
@DTWR_ADDENTRY(registry, registryVariable, registryData)
Parameters
Table 190. DTWR_ADDENTRY Parameters
Data Type | Parameter | Use | Description |
---|---|---|---|
string | registry | IN | The name of the registry to which the entry is added. |
string | registryVariable | IN | The value of the registryVariable string portion of the registry entry to add. |
string | registryData | IN | The value of the registryData string portion of the registry entry to add. |
string | index | IN | The value of the index portion of the registryVariable string in an indexed entry to add. This parameter is optional. If specified, an indexed entry is added to the specified registry. |
Return Codes
Table 191. DTWR_ADDENTRY Return Codes
Return Code | Explanation |
---|---|
-1001 | The server could not process a Net.Data request to allocate memory. |
1001 | An input parameter contained a NULL value. |
1002 | An input parameter contained a string value which consisted of the null-terminating character. |
1003 | An incorrect number of parameters were passed on a function call. |
1005 | A parameter passed on a function call, required to be a string variable, was of a different variable type. |
1007 | A parameter contains a value which is not valid. |
3003 | A Web registry built-in function could not add an entry to the specified registry because the specified entry already exists. |
3005 | A Web registry built-in function could not use the specified registry because it cannot be found. |
3006 | A Web registry built-in function could not create the specified registry because a path in the registry name does not exist. |
3007 | A Web registry built-in function could not complete the specified operation because the requestor does not have the proper authority to the specified registry. |
Examples
Example 1:
@DTWR_ADDENTRY("Myregistry", "Jones", "http://Advantis.com/~Jones/webproj")
Example 2:
@DTWR_ADDENTRY("URLLIST", "SMITH", "http://www.ibm.com/software/", "WORK_URL,")