Net.Data Reference Guide

Web Registry Functions

A Web registry is a file with a key maintained by Net.Data to allow you to add, retrieve, and delete entries easily. You can create multiple Net.Data Web registries on a single system. Each registry has a name and can contain multiple entries. Net.Data provides functions to maintain registries and the entries they contain.

DTWR_ADDENTRY
DTWR_CLEARREG
DTWR_CREATEREG
DTWR_DELENTRY
DTWR_DELREG
DTWR_LISTREG
DTWR_LISTSUB
DTWR_RTVENTRY
DTWR_UPDATEENTRY

Note:

Do not use asterisks (*) for the registry, registryVariable, and registryData parameters when using OS/2.

DTWR_ADDENTRY

Purpose

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

X X X

Adds an entry to a Web registry.

Syntax

@DTWR_ADDENTRY(registry, registryVariable, registryData, index)

Parameters

Table 61. 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.

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.

Examples

Example 1:

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

Example 2:

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

DTWR_CLEARREG

Purpose

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

Clears entries from a Web registry.

Syntax

@DTWR_CLEARREG(registry)

Parameters

Table 62. DTWR_CLEARREG Parameters

Data Type Parameter Use Description
string registry IN The name of the registry to clear.

Data Type	Parameter	Use	Description
string	`registry`	IN	The name of the registry to clear.

Examples

Example 1:

@DTWR_CLEARREG("Myregistry")

DTWR_CREATEREG

Purpose

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

X X X

Creates a new Web registry.

Syntax

@DTWR_CREATEREG(registry, security)

Parameters

Table 63. DTWR_CREATEREG Parameters

Data Type Parameter Use Description
string registry IN The name of the registry to create.
string security IN The type of security with which to create the registry. On Unix platforms, the default security is the same as the directory where the registry is created. You specify security for the 3 security groups: user, group, and public. R gives read permission, W gives write permission, and X give execute permission. For example, to give all 3 groups full authority, specify *RWX, *RWX, *RWX for this parameter. .

Data Type	Parameter	Use	Description
string	`registry`	IN	The name of the registry to create.
string	`security`	IN	The type of security with which to create the registry. On Unix platforms, the default security is the same as the directory where the registry is created. You specify security for the 3 security groups: user, group, and public. R gives read permission, W gives write permission, and X give execute permission. For example, to give all 3 groups full authority, specify `RWX, RWX, *RWX` for this parameter. .

Examples

Example 1:

@DTWR_CREATEREG("myRegistry")

Example 2:

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

DTWR_DELENTRY

Purpose

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

X X X

Deletes an entry from a Web registry.

Syntax

@DTWR_DELENTRY(registry, registryVariable, index)

Parameters

Table 64. DTWR_DELENTRY Parameters

Data Type Parameter Use Description
string registry IN The name of the registry from which the entry is removed.
string registryVariable IN The value of the registryVariable string portion of the entry to remove.
string index IN The value of the index portion of the registryVariable string in an indexed entry. This is an optional parameter. If specified, the indexed entry is removed from the registry.

Data Type	Parameter	Use	Description
string	`registry`	IN	The name of the registry from which the entry is removed.
string	`registryVariable`	IN	The value of the registryVariable string portion of the entry to remove.
string	`index`	IN	The value of the index portion of the registryVariable string in an indexed entry. This is an optional parameter. If specified, the indexed entry is removed from the registry.

Examples

Example 1:

@DTWR_DELENTRY("Myregistry", "Jones")

Example 2:

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

DTWR_DELREG

Purpose

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

X X X

Deletes a Web registry

Syntax

@DTWR_DELREG(registry)

Parameters

Table 65. DTWR_DELREG Parameters

Data Type Parameter Use Description
string registry IN The name of the registry to delete.

Data Type	Parameter	Use	Description
string	`registry`	IN	The name of the registry to delete.

Examples

Example 1:

@DTWR_DELREG("Myregistry")

DTWR_LISTREG

Purpose

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

X X X

List an entire Web registry.

It returns information about the registry entries in an OUT table variable passed by the user. The table variable is defined in the user macro before being passed as a parameter to the FUNCTION block for the LISTREG registry operation. If the user defined the table variable using the ALL option for the maximum number of rows for the table, this operation lists all available registry entries in the table, one for each table row. On the other hand if the user specified a value X for the maximum number of table rows, then if there are more then X entries in the specified registry only the first X entries are listed and an error code is sent back to indicate that only a partial listing could be done because not enough table rows were available to list additional entries. All registry entries are listed if the value X exceeds the number of available entries in the specified registry. There are always 2 columns in the table. The Column headers for the table are set to "REGISTRY_VARIABLE" and "REGISTRY_DATA" by the Web Registry language environment.

Syntax

@DTWR_LISTREG(registry, registryTable)

Parameters

Table 66. DTWR_LISTREG Parameters

Data Type Parameter Use Description
string registry IN The name of the registry to list.
string registryTable OUT The name of the table variable in which the registry entries are placed.

Data Type	Parameter	Use	Description
string	`registry`	IN	The name of the registry to list.
string	`registryTable`	OUT	The name of the table variable in which the registry entries are placed.

Examples

Example 1:

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

DTWR_LISTSUB

Purpose

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

X

Lists immediate subkey entries in a Web registry.

It returns information about the registry entries in an OUT table parameter passed by the user. The table variable is defined in the macro before being passed as a parameter to the LISTSUB registry operation. If the user has defined the table variable using the ALL option for the maximum number of rows for the table, this operation lists all available registry entries in the table, one for each table row. On the other hand, if the user specified a value X for the maximum number of table rows then if there are more then X entries in the specified registry only the first X entries are listed and an error code is sent back to indicate that only a partial listing could be done because not enough table rows are available to list additional entries. All registry entries are listed if the value X exceeds the number of available entries in the specified registry. The number of columns in the table is always one. The column header for the table is set to "REGISTRY_SUBKEY".

This function is only valid on operating system that are compatible Windows95 System Registries.

Syntax

@DTWR_LISTSUB(registry, registryTable)

Parameters

Table 67. DTWR_LISTSUB Parameters

Data Type Parameter Use Description
string registry IN The name of the registry to list.
string registryTable OUT The name of the table variable in which the registry entries are placed.

Data Type	Parameter	Use	Description
string	`registry`	IN	The name of the registry to list.
string	`registryTable`	OUT	The name of the table variable in which the registry entries are placed.

Examples

Example 1:

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

DTWR_RTVENTRY

Purpose

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

X X X

Retrieve the registryData string from a Web registry entry.

Syntax

@DTWR_RTVENTRY(registry, registryVariable, registryData, index)
@DTWR_rRTVENTRY(registry, registryVariable, index)

Parameters

Table 68. DTWR_RTVENTRY Parameters

Data Type Parameter Use Description
string registry IN The name of the registry with entries to retrieve.
string registryVariable IN The value of the registryVariable string portion of the registry entry whose registryData string is retrieved.
string registryData OUT Returns the value of the registryData string portion of the registry entry that matches the registryVariable.
string index IN The value of the index portion of the registryVariable string in an indexed entry whose registryData string is returned. This is an optional parameter. If specified, the registryData string of the indexed entry is returned.

Data Type	Parameter	Use	Description
string	`registry`	IN	The name of the registry with entries to retrieve.
string	`registryVariable`	IN	The value of the registryVariable string portion of the registry entry whose registryData string is retrieved.
string	`registryData`	OUT	Returns the value of the registryData string portion of the registry entry that matches the registryVariable.
string	`index`	IN	The value of the index portion of the registryVariable string in an indexed entry whose registryData string is returned. This is an optional parameter. If specified, the registryData string of the indexed entry is returned.

Examples

Example 1:

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

Example 2:

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

Example 3:

@DTWR_rRTVENTRY("Myregistry", "Jones")

Example 4:

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

DTWR_UPDATEENTRY

Purpose

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

X X X

Replaces the existing registryData string value for the specified registry entry with the new value specified by the caller. The registerVariable string cannot be changed.

Syntax

@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)

Parameters

Table 69. 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.

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.

Examples

Example 1:

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

Example 2:

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

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