DATA/GET

Solicite al servidor de interfaz de usuario web CICSPlex ® SM que cree un conjunto de resultados de registros que satisfagan una consulta.

DATA/GET

Descripción

Inicialmente, se emite una solicitud DATA/GET para un nuevo conjunto de resultados de registros sin especificar una opción STUB en el mandato. La respuesta del servidor incluye una cabecera STUB que identifica el conjunto de resultados.

Puede reutilizar un conjunto de resultados emitiendo otro mandato DATA/GET que especifique un valor de apéndice anterior. Esto tiene el efecto de descartar los resultados antiguos y reutilizar los recursos para contener los resultados de la nueva solicitud DATA/GET.

El resultado de un mandato DATA/GET para STATUS OK se muestra en la Tabla 1.

Tabla| 1. Datos devueltos en la cabecera de respuesta del mandato DATA/GET
Campo de cabecera	Descripción
COUNT =	Número de registros del conjunto de resultados que coinciden con la consulta. Puede ser un valor cero.
OBJECT =	El nombre de recurso CICSPlex SM , tal como se especifica en el mandato DATA/GET.
RAZÓN=	El código de razón de la API CICSPlex SM , cuando sea aplicable.
RESPUESTA =	El código de respuesta de la API CICSPlex SM .
STUB=	El valor de apéndice que se utilizará para la siguiente solicitud relacionada con esta consulta. Puede ser otro GET, o un mandato FETCH o DISCARD.
ID de usuario=	El ID de usuario que ha iniciado la sesión en la sesión del servidor de interfaz de usuario web utilizada para esta solicitud.

El servidor de interfaz de usuario web de CICSPlex SM gestiona cada conjunto de resultados de interfaz de datos activo como una ventana de sesión de usuario único. Cada sesión de usuario puede tener en cualquier momento un máximo de 64 ventanas activas, que se comparten entre la interfaz de datos de la aplicación cliente y la interfaz HTML.

Datos: el mandato DATA/GET no devuelve ningún registro de datos después de los campos de cabecera de respuesta. El mandato crea un conjunto de resultados del que un mandato DATA/FETCH posterior puede recuperar registros.

Nota: Los filtros de atributos y parámetros especificados en el mandato DATA/GET siempre se agrupan mediante un operador AND lógico. No es posible utilizar ningún filtro con un operador OR.

Opciones

A_ attributeName = valor

Especifica el valor de un nombre de atributo conocido de una de las tablas de recursos CICSPlex SM . Por ejemplo, si su consulta consiste en encontrar todos los archivos desactivados utilizando la tabla de recursos LOCFILE, la palabra clave A_attributeName se convierte en A_ENABLESTATUS y el operando es DISABLED.

Los siguientes tipos de datos de atributo se pueden utilizar como filtros:

avg
AVG3
bin
CHAR
CODEBINA
CVDAS
CVDAT
DEC
EYUDA
HEX
INTVSTCK
PORCEN
PCT3
RATE
RATE3
SCLOCK
SCLOCK12
Suma
SUM3

Consulte Proporcionar acceso a vistas y menús de WUI para obtener información sobre los criterios de selección y Representación de datos para obtener información sobre la representación de datos.

CONTEXT =valor

Especifica el contexto para los recursos que utilizan el nombre CICSplex. El contexto debe ser el nombre de 1 a 8 caracteres de un CICSplex.

Si omite esta opción, el servidor utiliza el último CONTEXT para el STUB especificado, o el valor predeterminado del servidor si no especifica un STUB en el mandato.

CMASCONTEXT =valor

Especifica el contexto para los recursos que utilizan el nombre CMAS.

Si omite esta opción, el servidor utiliza el último CMASCONTEXT para el STUB especificado, o el valor predeterminado del servidor si no especifica un STUB en el mandato.

O_ attributeName = valor

Especifica el operador de filtro que se debe utilizar con un nombre de atributo conocido de una de las tablas de recursos CICSPlex SM . Para obtener una lista de los valores de operador para la variable de consulta O_attrname y sus significados, consulte Criterios de selección. Por ejemplo, si la consulta GET trata sobre el estado de habilitación de archivos en la tabla de recursos LOCFILE, el resultado de A_ENABLESTATUS=DISABLED con O_ENABLESTATUS=NE son todos los archivos que están en estado ENABLED, UNENABLED y DISDISABLED (es decir, todos los que no están DISABLED).

OBJECT =valor

Especifica el nombre de la tabla de recursos de la SM CICSPlex en la que A_attributeName es un atributo válido. Esta opción es necesaria y debe especificar el nombre de 1 a 8 caracteres de una tabla de recursos válida o una vista válida.

P_ parameterName = valor

Especifica un filtro de parámetros para los recursos. Por ejemplo, P_WORKLOAD=nombre en la tabla de recursos WLMAWAOR, donde nombre es el nombre de una carga de trabajo activa.

No todos los recursos tienen parámetros asociados. Consulte Representación de datos para obtener información sobre la representación de datos.

SCOPE=valor

Especifica el ámbito para los recursos que requieren un ámbito.

STUB=valor

Especifica el valor de apéndice de conjunto de resultados devuelto por el servidor en respuesta a una solicitud anterior. Es opcional y tiene el siguiente efecto:

Si omite la opción STUB, el servidor crea un nuevo conjunto de resultados. Si el servidor ha creado uno o más conjuntos de resultados de solicitudes anteriores, estos se conservan y no se ven afectados por esta solicitud.
Si especifica la opción STUB, el servidor reutiliza el almacenamiento del conjunto de resultados antiguo para la nueva consulta. En efecto, emitir una solicitud DATA/GET con un valor de apéndice es el equivalente a emitir un DATA/DISCARD seguido de un DATA/GET, y evita vincular los recursos del sistema que ya no son necesarios.

Nota: La aplicación cliente puede utilizar un valor de apéndice recibido del servidor de interfaz de usuario web una sola vez. Una vez que haya especificado un valor de apéndice en una solicitud a un servidor de interfaz de usuario web, no podrá volver a utilizar el mismo valor.

Valores STATUS

BADATTR

Una palabra clave A_attribueName no es válida. Si el mandato DATA/GET ha especificado un valor de apéndice, se respeta el DISCARD implícito y se descarta el conjunto de resultados asociado.

BADCOMMAND

El mandato pasado a la interfaz de datos por la interfaz web de usuario no se reconoce.

BADOBJECT

El valor especificado en la opción OBJECT no es válido. Si el mandato DATA/GET ha especificado un valor de apéndice, se respeta el DISCARD implícito y se descarta el conjunto de resultados asociado.

BADPARM

Una palabra clave P_parameterName no es válida. Si el mandato DATA/GET ha especificado un valor de apéndice, se respeta el DISCARD implícito y se descarta el conjunto de resultados asociado.

BADSTUB

El valor de apéndice no es válido para la solicitud. Esto podría deberse a una de las siguientes razones:

Ha especificado un valor de apéndice que no pertenece a la sesión de usuario en la que ha emitido el mandato.
El valor de apéndice está fuera de secuencia.

BUSYSTUB

El servidor de interfaz de usuario web sigue procesando una solicitud anterior para este apéndice.

CMASGONE

La interfaz web de usuario ha perdido su conexión con el CMAS. Como resultado, la sesión de usuario de la aplicación cliente finaliza.

MAXWIN

Se ha alcanzado el número máximo de ventanas (64) para la sesión de usuario.