PANTALLA
El verbo DISPLAY devuelve información de configuración y valores operativos actuales para el nodo SNA.
Se recomienda usar la función de extensión getAppcConfig de Windows para obtener información de configuración del sistema relacionada con las LU de APPC. Los usuarios de 5250 emuladores, en particular, deben usar la extensión GetAPPCConfig de Windows.
Nota
Debido a la naturaleza de la arquitectura de cliente/servidor, la implementación del verbo DISPLAY en Host Integration Server contiene diferencias importantes de IBM Extended Services para OS/2 versión 1.0 (IBM ES para OS/2 versión 1.0) en la que se basaba.
Nota
En el caso de las aplicaciones que usan el verbo APPC DISPLAY en IBM ES para el modo de compatibilidad de OS/2 versión 1.0 y que no usan las extensiones de Host Integration Server para enumerar todos los servidores y conexiones activos, Host Integration Server elegirá aleatoriamente una conexión DISPLAY predeterminada, a menos que se haya configurado una conexión DISPLAY predeterminada específica en SNA Manager. Esta conexión se usa como base para todas las solicitudes DISPLAY . Para obtener información sobre cómo especificar la conexión DISPLAY predeterminada, vea Ayuda de Host Integration Server.
En la estructura siguiente se describe el bloque de control de verbo utilizado por el verbo DISPLAY .
Sintaxis
struct display {
unsigned short opcode;
unsigned char reserv2[2];
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned long init_sect_len;
unsigned long buffer_len;
unsigned char FAR * buffer_ptr;
unsigned long num_sections;
unsigned long display_len;
unsigned long area_needed;
unsigned char sna_global_info;
unsigned char lu62_info;
unsigned char am_info;
unsigned char tp_info;
unsigned char sess_info;
unsigned char link_info;
unsigned char lu_0_3_info;
unsigned char gw_info;
unsigned char x25_physical_link_info;
unsigned char sys_def_info;
unsigned char adapter_info;
unsigned char lu_def_info;
unsigned char plu_def_info;
unsigned char mode_def_info;
unsigned char link_def_info;
unsigned char ms_info;
struct sna_global_info_sect FAR * sna_global_info_ptr;
struct lu62_info_sect FAR * lu62_info_ptr;
struct am_info_sect FAR * am_info_ptr;
struct tp_info_sect FAR * tp_info_ptr;
struct sess_info_sect FAR * sess_info_ptr;
struct link_info_sect FAR * link_info_ptr;
struct lu_0_3_info_sect FAR * lu_0_3_info_ptr;
struct gw_info_sect FAR * gw_info_ptr;
struct x25_physical_link_info_sect FAR * x25_physical_link_info_ptr;
struct sys_def_info_sect FAR * sys_def_info_ptr;
struct adapter_info_sect FAR * adapter_info_ptr;
struct lu_def_info_sect FAR * lu_def_info_ptr;
struct plu_def_info_sect FAR * plu_def_info_ptr;
struct mode_def_info_sect FAR * mode_def_info_ptr;
struct link_def_info_sect FAR * link_def_info_ptr;
struct ms_info_sect FAR * ms_info_ptr;
} DISPLAY;
Members
opcode
Parámetro proporcionado. Especifica el código de operación de verbo, AP_DISPLAY.
reserv2
Un campo reservado, este valor debe establecerse en NULL.
primary_rc
Parámetro devuelto. Especifica el código de retorno principal que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.
secondary_rc
Parámetro devuelto. Especifica el código de retorno secundario que establece APPC al finalizar el verbo. Los códigos de retorno válidos varían en función del verbo APPC que se emita. Consulte la sección de códigos de retorno para obtener los códigos de error válidos para este verbo.
init_sect_len
Parámetro proporcionado. Especifica el número de bytes de la sección inicial del VCB, hasta el principio de punteros de información. Este parámetro y el parámetro num_sections deben establecerse en valores específicos en función del formato que se solicite. Consulte las notas siguientes para obtener detalles.
buffer_len
Parámetro proporcionado. Especifica la longitud (de 0 a 65535 bytes) del búfer de datos de visualización pasado.
buffer_ptr
Parámetro proporcionado. Proporciona la dirección del búfer de datos para mostrar que contendrá la información solicitada.
num_sections
Parámetro proporcionado. Especifica el número máximo de secciones de información que el verbo puede devolver. Este parámetro y el parámetro init_sect_len deben establecerse en valores específicos en función del formato que se solicite. Consulte las notas siguientes para obtener detalles.
display_len
Parámetro devuelto. Proporciona el número total de bytes usados que se devuelven en el búfer de datos para mostrar.
area_needed
Parámetro devuelto. Proporciona el número total de bytes necesarios para todos los datos mostrados.
sna_global_info
Parámetro proporcionado. Especifica si se solicita información global. Los valores permitidos son AP_YES y AP_NO.
lu62_info
Parámetro proporcionado. Especifica si se solicita información sobre todas las LU activas, sus asociados y sus modos. Los valores permitidos son AP_YES y AP_NO.
am_info
Parámetro proporcionado. Especifica si se solicita información de Attach Manager sobre el TP definido. Los valores permitidos son AP_YES y AP_NO.
Nota
Esta opción no es compatible con Host Integration Server y este parámetro debe establecerse en AP_NO.
tp_info
Parámetro proporcionado. Especifica si se solicita información sobre los CSP activos y las conversaciones activas. Los valores permitidos son AP_YES y AP_NO.
Nota
Esta opción no es compatible con Host Integration Server y este parámetro debe establecerse en AP_NO.
sess_info
Parámetro proporcionado. Especifica si se solicita información sobre las sesiones. Los valores permitidos son AP_YES y AP_NO.
link_info
Parámetro proporcionado. Especifica si se solicita información sobre las líneas lógicas SNA activas. Los valores permitidos son AP_YES y AP_NO.
lu_0_3_info
Parámetro proporcionado. Especifica si se solicita información sobre el tipo de unidades lógicas 0, 1, 2 y 3. Los valores permitidos son AP_YES y AP_NO.
gw_info
Parámetro proporcionado. Especifica si se solicita información sobre la puerta de enlace de SNA. Los valores permitidos son AP_YES y AP_NO.
x25_physical_link_info
Parámetro proporcionado. Especifica si se requiere información X.25. Los valores permitidos son AP_YES y AP_NO.
Nota
Esta opción no es compatible con Host Integration Server y este parámetro debe establecerse en AP_NO.
sys_def_info
Parámetro proporcionado. Especifica si se solicita información sobre la LU predeterminada, los nombres de nodo y los parámetros predeterminados para los asociados implícitos entrantes y salientes. Los valores permitidos son AP_YES y AP_NO.
adapter_info
Parámetro proporcionado. Especifica si se solicita información sobre los adaptadores de comunicaciones configurados. Los valores permitidos son AP_YES y AP_NO. Este parámetro debe establecerse en AP_NO cuando se solicite el formato NS/2.
lu_def_info
Parámetro proporcionado. Especifica si se solicita información sobre las LU definidas. Los valores permitidos son AP_YES y AP_NO.
plu_def_info
Parámetro proporcionado. Especifica si se solicita información sobre las LU de asociado definidas. Los valores permitidos son AP_YES y AP_NO.
mode_def_info
Parámetro proporcionado. Especifica si se solicita información sobre los nodos definidos. Los valores permitidos son AP_YES y AP_NO.
link_def_info
Parámetro proporcionado. Especifica si se solicita información sobre los vínculos lógicos definidos. Los valores permitidos son AP_YES y AP_NO.
ms_info
Parámetro proporcionado. Especifica si se solicita información sobre los servicios de administración. Los valores permitidos son AP_YES y AP_NO. Este parámetro debe establecerse en AP_NO cuando se solicite el formato NS/2.
sna_global_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información global de SNA en el búfer de datos.
lu62_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de LU 6.2 en el búfer de datos.
am_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información del Administrador de adjuntar en el búfer de datos.
Nota
Esta opción no es compatible con Host Integration Server.
tp_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de TP en el búfer de datos.
Nota
Esta opción no es compatible con Host Integration Server.
sess_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de sesión en el búfer de datos.
link_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de vínculo en el búfer de datos.
lu_0_3_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de LU en el búfer de datos.
gw_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de puerta de enlace en el búfer de datos.
x25_physical_link_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información X.25 en el búfer de datos.
Nota
Esta opción no es compatible con Host Integration Server.
sys_def_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información predeterminada del sistema en el búfer de datos.
adapter_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información del adaptador en el búfer de datos.
lu_def_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de definición de LU local en el búfer de datos.
plu_def_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de definición de LU del asociado en el búfer de datos.
mode_def_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de definición del modo en el búfer de datos.
link_def_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de definición de vínculo en el búfer de datos.
ms_info_ptr
Parámetro devuelto. Indica la dirección del principio de la información de los servicios de administración en el búfer de datos.
Códigos de retorno
AP_OK
Código de retorno principal; el verbo se ha ejecutado correctamente.
AP_PARAMETER_CHECK
Código de retorno principal; el verbo no se ha ejecutado debido a un error en un parámetro.
AP_DISPLAY_INVALID_CONSTANT
Código de retorno secundario; el valor proporcionado para NUM_SECTIONS o INIT_SEC_LEN no es válido.
AP_STATE_CHECK
Código de retorno principal; el verbo no se ejecutó porque se emitió en un estado no válido.
AP_DISPLAY_INFO_EXCEEDS_LEN
Código de retorno secundario; la información de VISUALIZACIÓN devuelta no cabe en el búfer.
AP_INVALID_DATA_SEGMENT
Código de retorno secundario; el segmento que contiene el búfer de datos es demasiado pequeño para la longitud de datos especificada.
AP_COMM_SUBSYSTEM_ABENDED
Código de retorno principal; indica una de las condiciones siguientes:
El nodo usado por esta conversación ha encontrado un ABEND.
La conexión entre el TP y el tipo de nodo 2.1 se ha interrumpido (un error de LAN).
SnaBase en el equipo TPs ha encontrado un ABEND.
AP_COMM_SUBSYSTEM_NOT_LOADED
Código de retorno principal; no se pudo cargar o finalizar un componente necesario durante el procesamiento del verbo. Por tanto, no se pudo establecer la comunicación. Consulte con el administrador del sistema para aplicar una acción correctiva.
AP_INVALID_VERB_SEGMENT
Código de retorno principal; el bloque de control de verbo (VCB) se ha extendido más allá del final del segmento de datos.
AP_STACK_TOO_SMALL
Código de retorno principal; el tamaño de la pila de la aplicación es demasiado pequeño para ejecutar el verbo. Aumente el tamaño de pila de la aplicación.
AP_UNEXPECTED_DOS_ERROR
Código de retorno principal; el sistema operativo devolvió un error a APPC al procesar una llamada de APPC desde el TP local. El código de retorno del sistema operativo se devuelve a través de secondary_rc. Aparece en el orden de intercambio de bytes de Intel. Si el problema persiste, consulte con el administrador del sistema.
Comentarios
DISPLAY identifica una LU solo por alias. Si se usa el mismo alias de LU local varias veces en un dominio (con fines de copia de seguridad u otros fines) y ese alias de LU se especifica a través de DISPLAY, el verbo puede fluir a una LU diferente de la prevista.
Para que el verbo DISPLAY se devuelva correctamente, se debe definir una conexión específica en el cuadro de diálogo Mostrar verbo del programa administrador de SNA. IBM definió originalmente el verbo DISPLAY con el producto IBM OS/2 Extended Edition que asume una única conexión. Sin embargo, dado que Host Integration Server admite varias conexiones, se debe configurar la conexión específica asociada al verbo DISPLAY .
El verbo DISPLAY requiere un búfer proporcionado por el usuario para la devolución de información del sistema. Si el búfer no es lo suficientemente grande, APPC devuelve el código de devolución AP_DISPLAY_INFO_EXCEEDS_LEN, junto con el tamaño realmente necesario en el momento de la solicitud (en el parámetro area_needed ). Una posible estrategia para el uso de este verbo es la siguiente:
Si el valor de buffer_len es menor que el valor de area_needed devuelto por APPC, y la longitud necesaria es inferior a 64 kilobytes (KB), aumente el tamaño del búfer de presentación a igual o mayor que el valor de area_needed .
Si el valor de area_needed es mayor que 64 KB, puede solicitar cada sección de información individualmente. O bien, puede realizar los pasos siguientes:
Procese las secciones de información con información completa, cuyo número total mostrado es igual al número real total.
Elija un subconjunto de las secciones de información que solicitó que contiene información incompleta y vuelva a emitir el verbo que solicita esas secciones de información.
Repita los pasos a y b según sea necesario.
Nota
Si una sección de información individual es superior a 64 KB, no podrá obtener toda la información solicitada de APPC.
El verbo DISPLAY no se debe ejecutar desde subprocesos diferentes del mismo proceso, ya que no es seguro para subprocesos.
El verbo DISPLAY devuelve AP_DISPLAY_INVALID_CONSTANT si no se establecen los siguientes valores para los parámetros proporcionados para init_sect_len y num_sections:
| Formato NS/2 | Formato IBM EE | Formato NS/2 (solo Windows) | Formato IBM EE (solo Windows) | |
|---|---|---|---|---|
| init_sect_len | 50 | 44 | 52 | 48 |
| num_sections | 16 | 9 | 16 | 9 |
El AP_DISPLAY_INVALID_CONSTANT también se devuelve cuando los parámetros siguientes no se establecen correctamente:
reserv2 debe establecerse en NULL.
am_info debe establecerse en AP_NO.
tp_info debe establecerse en AP_NO.
adapter_info debe establecerse en AP_NO si se solicita el formato NS/2.
ms_info debe establecerse en AP_NO si se solicita el formato NS/2.
Consulte también
Extensiones de Host Integration Server
Diferencias por tipo de información