READA

Autorización

En una solicitud READA, el programa de aplicación debe poseer el almacenamiento intermedio de destino especificado o se rechaza la solicitud. Puede obtener la propiedad de un almacenamiento intermedio si se emite un mandato START TRACE para un destino OPn. Si el ID de autorización primario o uno de los ID de autorización secundarios del proceso no tiene el privilegio MONITOR1 o MONITOR2, la solicitud se rechaza. Se comprueba la autorización de las solicitudes READA una vez por cada usuario de la hebra. (Varios usuarios pueden utilizar la misma hebra, pero se realiza una comprobación de autorización cada vez que cambia el usuario de la hebra.)

Sintaxis y opciones

Las llamadas READA a la interfaz de recurso de instrumentación tienen la sintaxis siguiente:

CALL DSNWLI,('READA   ',ifca,return-area),VL

ifca

Contiene información sobre el destino de la OPn y el valor del token de propiedad (IFCAOWNR) en el inicio de la llamada. Cuando finaliza la llamada a READA, IFCA contiene el código de retorno, el código de razón, el número de bytes trasladados al área de retorno, el número de bytes no trasladados al área de retorno si el área es demasiado pequeña, y el número de registros perdidos.

área-retorno

Contiene los registros de longitud variable que son devueltos por el recurso de instrumentación. Si el área de retorno es demasiado pequeña, se colocan en ella tantos datos de salida como quepan (un registro completo de longitud variable). Se devuelve el código de razón 00E60802 cuando el área de retorno del programa supervisor no es lo suficientemente grande para contener los datos devueltos.

FL 504 IFI asigna hasta 16 búferes OP a petición del almacenamiento privado en el espacio de direcciones MSTR de Db2 . IFI utiliza estos búferes para almacenar datos de seguimiento hasta que la aplicación propietaria realiza una solicitud READA para transferir los datos del búfer OP al área de retorno de la aplicación. Una aplicación se convierte en propietaria de un búfer OP cuando emite un comando START TRACE y especifica un destino de OP n u OPX. El tamaño de cada almacenamiento intermedio puede estar comprendido entre 256 KB y 16 MB. IFI asigna un máximo de 16 MB de almacenamiento para cada uno de los búferes OP. El tamaño predeterminado del almacenamiento intermedio de supervisión lo determina el parámetro de subsistema MONSIZE.