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)