Guia de Referência do Net.Data

Funções de Registro da Web

O registro da Web é um arquivo com uma chave mantida pelo Net.Data que permite que se inclua, recupere e elimine entradas com facilidade. Diversos registros da Web Net.Data podem ser criados em um único sistema. Cada registro possui um nome e pode conter diversas entradas. O Net.Data fornece funções para manter os registros e as entradas que estes contêm.

DTWR_ADDENTRY
DTWR_CLEARREG
DTWR_CREATEREG
DTWR_DELENTRY
DTWR_DELREG
DTWR_LISTREG
DTWR_LISTSUB
DTWR_RTVENTRY
DTWR_UPDATEENTRY

Nota:

Não utilize asteriscos (*) para os parâmetros registro, variávelRegistro e dadosRegistro ao utilizar o OS/2.

DTWR_ADDENTRY

Objetivo

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

X X X

Acrescenta uma entrada em um registro da Web.

Sintaxe

@DTWR_ADDENTRY(registro, variávelRegistro, dadosRegistro, índice)

Parâmetros

Tabela 61. Parâmetros DTWR_ADDENTRY

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro no qual a entrada é acrescentada.
cadeia variávelRegistro IN O valor da porção da cadeia variávelRegistro da entrada de registro a ser incluída.
cadeia dadosRegistro IN O valor da porção da cadeia dadosRegistro da entrada de registro a ser incluída.
cadeia índice IN O valor da porção de índice da cadeia variávelRegistro na entrada de índice a ser incluída. Esse parâmetro é opcional. Se especificado, uma entrada indexada será incluída no registro especificado.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro no qual a entrada é acrescentada.
cadeia	`variávelRegistro`	IN	O valor da porção da cadeia variávelRegistro da entrada de registro a ser incluída.
cadeia	`dadosRegistro`	IN	O valor da porção da cadeia dadosRegistro da entrada de registro a ser incluída.
cadeia	`índice`	IN	O valor da porção de índice da cadeia variávelRegistro na entrada de índice a ser incluída. Esse parâmetro é opcional. Se especificado, uma entrada indexada será incluída no registro especificado.

Exemplos

Exemplo 1:

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

Exemplo 2:

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

DTWR_CLEARREG

Objetivo

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

Limpa entradas de um registro da Web.

Sintaxe

@DTWR_CLEARREG(registro)

Parâmetros

Tabela 62. Parâmetros DTWR_CLEARREG

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro a ser limpo.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro a ser limpo.

Exemplos

Exemplo 1:

@DTWR_CLEARREG("Meuregistro")

DTWR_CREATEREG

Objetivo

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

X X X

Cria um novo registro da Web.

Sintaxe

@DTWR_CREATEREG(registro, segurança)

Parâmetros

Tabela 63. Parâmetros DTWR_CREATEREG

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro a ser criado.
cadeia segurança IN O tipo de segurança com a qual criar o registro. Em plataformas Unix, a segurança padrão é igual ao diretório no qual o registro foi criado. Você especificará a segurança para os três grupos de segurança: usuário, grupo e público. R fornece permissão para leitura, W fornece permissão para gravação e X concede permissão para execução. Por exemplo, para conceder autoridade completa aos 3 grupos, especifique *RWX, *RWX, *RWX para este parâmetro..

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro a ser criado.
cadeia	`segurança`	IN	O tipo de segurança com a qual criar o registro. Em plataformas Unix, a segurança padrão é igual ao diretório no qual o registro foi criado. Você especificará a segurança para os três grupos de segurança: usuário, grupo e público. R fornece permissão para leitura, W fornece permissão para gravação e X concede permissão para execução. Por exemplo, para conceder autoridade completa aos 3 grupos, especifique `RWX, RWX, *RWX` para este parâmetro..

Exemplos

Exemplo 1:

@DTWR_CREATEREG("meuRegistro")

Exemplo 2:

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

DTWR_DELENTRY

Objetivo

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

X X X

Elimina uma entrada de um registro da Web.

Sintaxe

@DTWR_DELENTRY(registro, variávelRegistro, índice)

Parâmetros

Tabela 64. Parâmetros DTWR_DELENTRY

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro do qual a entrada é removida.
cadeia variávelRegistro IN O valor da porção da cadeia variávelRegistro da entrada a ser removida.
cadeia índice IN O valor da porção de índice da cadeia variávelRegistro em uma entrada indexada. Esse é um parâmetro opcional. Se especificado, a entrada indexada será removida do registro.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro do qual a entrada é removida.
cadeia	`variávelRegistro`	IN	O valor da porção da cadeia variávelRegistro da entrada a ser removida.
cadeia	`índice`	IN	O valor da porção de índice da cadeia variávelRegistro em uma entrada indexada. Esse é um parâmetro opcional. Se especificado, a entrada indexada será removida do registro.

Exemplos

Exemplo 1:

@DTWR_DELENTRY("Meuregistro", "Jones")

Exemplo 2:

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

DTWR_DELREG

Objetivo

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

X X X

Elimina um registro da Web

Sintaxe

@DTWR_DELREG(registro)

Parâmetros

Tabela 65. Parâmetros DTWR_DELREG

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro a ser eliminado.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro a ser eliminado.

Exemplos

Exemplo 1:

@DTWR_DELREG("Meuregistro")

DTWR_LISTREG

Objetivo

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

X X X

Lista um registro inteiro da Web.

Ela retorna informações sobre as entradas de registro em uma variável de tabela OUT passada pelo usuário. A variável de tabela é definida na macro do usuário antes de ser passada como parâmetro ao bloco FUNCTION para a operação de registro LISTREG. Se o usuário definiu a variável de tabela usando a opção TODAS para o número máximo de linhas para a tabela, essa operação relaciona todas as entradas de registro disponíveis na tabela, uma para cada linha da tabela. Por outro lado se o usuário especificou um valor X para o número máximo de linhas da tabela, então se houver mais de X entradas no registro especificado apenas as primeiras X entradas são relacionadas e um código de erro é enviado de volta para indicar que apenas uma listagem parcial pôde ser feita porque insuficientes linhas de tabela estavam disponíveis para relacionar entradas adicionais. Todas as entradas de registro são relacionadas se o valor X exceder o número de entradas disponível no registro especificado. Há sempre 2 colunas na tabela. Os cabeçalhos de coluna para a tabela são definidos como "REGISTRY_VARIABLE" e "REGISTRY_DATA" pelo ambiente de linguagem do Registro da Web.

Sintaxe

@DTWR_LISTREG(registro, tabelaRegistro)

Parâmetros

Tabela 66. Parâmetros DTWR_LISTREG

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro a ser relacionado.
cadeia tabelaRegistro OUT O nome da variável de tabela na qual as entradas de registro são colocadas.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro a ser relacionado.
cadeia	`tabelaRegistro`	OUT	O nome da variável de tabela na qual as entradas de registro são colocadas.

Exemplos

Exemplo 1:

%DEFINE TabelaRegistro = %TABLE(ALL)

@DTWR_LISTREG("URLLIST", TabelaRegistro)

DTWR_LISTSUB

Objetivo

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

X

Lista entradas de sub-chave imediatas em um registro da Web.

Ela retorna informações sobre as entradas de registro em um parâmetro de tabela OUT passado pelo usuário. A variável de tabela é definida no macro antes de ser passada como um parâmetro para a operação de registro LISTSUB. Se o usuário definiu a variável de tabela usando a opção TODAS para o número máximo de linhas para a tabela, essa operação relaciona todas as entradas de registro disponíveis na tabela, uma para cada linha da tabela. Por outro lado, se o usuário especificou um valor X para o número máximo de linhas da tabela, então se houver mais de X entradas no registro especificado apenas as primeiras X entradas são relacionadas e um código de erro é enviado de volta para indicar que apenas uma listagem parcial pôde ser feita porque insuficientes linhas de tabela estavam disponíveis para relacionar entradas adicionais. Todas as entradas de registro são relacionadas se o valor X exceder o número de entradas disponível no registro especificado. O número de colunas na tabela é sempre um. O cabeçalho de coluna para a tabela é definido como "REGISTRY_SUBKEY".

Essa função é válida apenas em sistemas operacionais que sejam compatíveis com Registradores de Sistema Windows95.

Sintaxe

@DTWR_LISTSUB(registro, tabelaRegistro)

Parâmetros

Tabela 67. Parâmetros DTWR_LISTSUB

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro a ser relacionado.
cadeia tabelaRegistro OUT O nome da variável de tabela na qual as entradas de registro são colocadas.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro a ser relacionado.
cadeia	`tabelaRegistro`	OUT	O nome da variável de tabela na qual as entradas de registro são colocadas.

Exemplos

Exemplo 1:

%DEFINE TabelaRegistro = %TABLE(ALL)

@DTWR_LISTSUB("URLLIST", TabelaRegistro)

DTWR_RTVENTRY

Objetivo

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

X X X

Recupera a cadeia dadosRegistro de uma entrada de registro da Web.

Sintaxe

@DTWR_RTVENTRY(registro, variávelRegistro, dadosRegistro, índice)
@DTWR_rRTVENTRY(registro, variávelRegistro, índice)

Parâmetros

Tabela 68. Parâmetros DTWR_RTVENTRY

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro que possui as entradas a serem recuperadas.
cadeia variávelRegistro IN O valor da porção da cadeia variávelRegistro da entrada de registro cuja cadeia dadosRegistro está recuperada.
cadeia dadosRegistro OUT Retorna o valor da porção da cadeia dadosRegistro da entrada de registro que corresponde à variávelRegistro.
cadeia índice IN O valor da porção de índice da cadeia variávelRegistro em uma entrada indexada cuja cadeia dadosRegistro é retornada. Esse é um parâmetro opcional. Se especificado, a cadeia dadosRegistro da entrada indexada é retornada.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro que possui as entradas a serem recuperadas.
cadeia	`variávelRegistro`	IN	O valor da porção da cadeia variávelRegistro da entrada de registro cuja cadeia dadosRegistro está recuperada.
cadeia	`dadosRegistro`	OUT	Retorna o valor da porção da cadeia dadosRegistro da entrada de registro que corresponde à variávelRegistro.
cadeia	`índice`	IN	O valor da porção de índice da cadeia variávelRegistro em uma entrada indexada cuja cadeia dadosRegistro é retornada. Esse é um parâmetro opcional. Se especificado, a cadeia dadosRegistro da entrada indexada é retornada.

Exemplos

Exemplo 1:

%DEFINE DadosRegistro = ""
@DTWR_RTVENTRY("Meuregistro", "Jones", RegistryData)

Exemplo 2:

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

Exemplo 3:

@DTWR_rRTVENTRY("Meuregistro", "Jones")

Exemplo 4:

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

DTWR_UPDATEENTRY

Objetivo

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

X X X

Substitui o valor existente da cadeia dadosRegistro para a entrada de registro especificada pelo novo valor especificado pelo chamador. A cadeia variávelRegistro não pode ser alterada.

Sintaxe

@DTWR_UPDATEENTRY(registro, variávelRegistro, novosDados, índice)

Parâmetros

Tabela 69. Parâmetros DTWR_UPDATEENTRY

Tipo de Dados Parâmetro Uso Descrição
cadeia registro IN O nome do registro que possui a entrada a ser atualizada.
cadeia variávelRegistro IN O valor da porção da cadeia variávelRegistro da entrada de registro a ser atualizada.
cadeia novosDados IN O novo valor para a porção da cadeia dadosRegistro do registro de entrada a ser atualizado.
cadeia índice IN O valor da porção de índice da cadeia variávelRegistro em uma entrada indexada a ser atualizado. Esse é um parâmetro opcional. Se especificado, a entrada indexada será atualizada.

Tipo de Dados	Parâmetro	Uso	Descrição
cadeia	`registro`	IN	O nome do registro que possui a entrada a ser atualizada.
cadeia	`variávelRegistro`	IN	O valor da porção da cadeia variávelRegistro da entrada de registro a ser atualizada.
cadeia	`novosDados`	IN	O novo valor para a porção da cadeia dadosRegistro do registro de entrada a ser atualizado.
cadeia	`índice`	IN	O valor da porção de índice da cadeia variávelRegistro em uma entrada indexada a ser atualizado. Esse é um parâmetro opcional. Se especificado, a entrada indexada será atualizada.

Exemplos

Exemplo 1:

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

Exemplo 2:

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

[ Início da Página | Página Anterior | Próxima Página | Tabela de Conteúdos | Índice ]