Manual de consulta

DTWR_LISTREG


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

X
X

X

Finalidad

Lista el contenido de un registro Web.

Formato

@DTWR_LISTREG(registro, Tablaregistro)

Parámetros

Tabla 211. Parámetros de DTWR_LISTREG
Tipo de datos Parámetro Uso Descripción
serie registro IN El nombre del registro que ha de listarse.
tabla Tablaregistro OUT El nombre de la variable de tabla en la que van a colocarse las entradas de registro.

Códigos de retorno

Tabla 212. Códigos de retorno de DTWR_LISTREG
Código de retorno Explicación
-1001 El servidor no ha podido procesar una petición de Net.Data para asignar memoria.
1001 Un parámetro de entrada contenía un valor NULL.
1002 Un parámetro de entrada contenía un valor de serie que consistía en el carácter de terminación nulo.
1003 Se ha transmitido un número incorrecto de parámetros en una llamada de función.
1004 Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de tabla de macro Net.Data, pero era de un tipo de variable diferente.
1005 Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente.
1006 Se ha transmitido una serie literal en una llamada de función para un parámetro que debería haber sido un parámetro de salida.
1007 Un parámetro contiene un valor que no es válido.
3005 Una función incorporada de registro Web no ha podido utilizar el registro especificado porque no se puede encontrar.
3007 Una función incorporada de registro Web no ha podido completar la operación especificada porque el peticionario no tiene la autorización adecuada para el registro especificado.

Notas de utilización

DTWR_LISTREG devuelve información sobre las entradas de registro en una variable de tabla OUT que ha transmitido el usuario. La variable de tabla se ha definido en la macro de usuario antes de transmitirse como parámetro al bloque FUNCTION para la operación de registro LISTREG.

Si el usuario ha definido la variable de tabla utilizando la opción ALL para el número máximo de filas para la tabla, esta operación lista todas las entradas de registro disponibles en la tabla, una por cada fila de tabla. Por otro lado, si el usuario ha especificado un valor X para el número máximo de filas de tabla, si a continuación hay más entradas X en el registro especificado, sólo se listan las primeras entradas X y se envía de nuevo un código de error para indicar que sólo puede hacerse un listado parcial ya que no hay suficientes filas de tabla disponibles para listar entradas adicionales. Se listan todas las entradas de registro en el caso de que el valor X supere el número de entradas disponibles en el registro especificado.

Siempre hay 2 columnas en la tabla. Las cabeceras de columna para la tabla se establecen en REGISTRY_VARIABLE y REGISTRY_DATA.

Ejemplos

Ejemplo 1:

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


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]