DTWR_UPDATEENTRY

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

X
X

X

Purpose

Updates a registry string value in the Web registry.

Format

@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)

@DTWR_UPDATEENTRY(registry, registryVariable, newData)

Parameters

Table 210. DTWR_UPDATEENTRY Parameters
Data Type Parameter Use Description
string registry IN The name of the registry with the entry to update.
string registryVariable IN The value of the registryVariable string portion of the registry entry to update.
string newData IN The new value for the registryData string portion of the registry entry to update.
string index IN The value of the index portion of the registryVariable string in an indexed entry to update. This is an optional parameter. If specified, the indexed entry is updated.

Return Codes

Table 211. DTWR_UPDATEENTRY 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.
3004 A Web registry built-in function could not remove or retrieve an entry from the specified registry because the specified entry does not exist.
3005 A Web registry built-in function could not use the specified registry because it cannot be found.
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.

Usage Notes

The registry entry name corresponding to the value cannot be changed.

Examples

Example 1:

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

Example 2:

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


[ Top of Page | Previous Page | Next Page | Index ]