N CSCI

En este capítulo, se describe el componente Interfaz de comunicaciones del servidor del cliente (CSCI, Client Server Communications Interface).

Este capítulo trata sobre los siguientes temas:

  • Visión general de CSCI

  • Mensajes de error

  • Variables de entorno

La instalación de CSCI debe ser seguida a la instalación del sistema operativo y la instalación y configuración de ACSLS.

Nota:

Para que ACSLS funcione adecuadamente, la variable de configuración START_CSCI_PROCESS debe establecerse en TRUE (verdadero). Esto se hace en la opción 1 de acsss_config. Consulte Configuración de variables que controlan el comportamiento de ACSLS.

Visión General de la CSCI

La Interfaz de comunicaciones del servidor del cliente (CSCI) es un componente independiente responsable de aprobar la solicitud y los paquetes de respuesta entre un sistema de cliente y un sistema de servidor. CSCI es un componente opcional que les permite a los clientes de MVS o RMLS/CSC comunicarse con ACSLS. Si no usa CSCI, usa CSI por defecto para comunicarse con ACSLS.

Conectividad de CSCI

CSCI proporciona conectividad IPC y TCP/IP para enlazar el servidor ACSLS con clientes MVS o RMLS/CSC.

Arquitectura y subsistemas

La siguiente figura muestra una arquitectura general de CSCI y sus subsistemas.

Figura N-1 Arquitectura y subsistemas de CSCI

El texto adyacente describe Figura N-1 .

La siguiente figura muestra cómo se conecta el subsistema CSCI con la interfaz de red. Del lado del servidor, los datos fluyen del concentrador de red a través de la interfaz TCP/IP, hasta la interfaz CSCI. Desde aquí, los datos fluyen a través de una interfaz IPC hasta el software ACSLS en ambas direcciones, pero en un modo medio dúplex, por ejemplo: una dirección a la vez.

Figura N-2 Sistema CSCI con interfaz Token Ring

El texto adyacente describe Figura N-2 .

Mensajes Error

Los mensajes de error de instalación y configuración de CSCI se relacionan con las siguientes condiciones:

  • Propiedad incorrecta

  • Permiso de acceso incorrecto

  • Variables de entorno indefinidas

  • Una variedad de condiciones diferentes

  • Configuración de CSCI y TCP/IP incorrecta

Mensajes de Error Comunes

Communication failure, verb = cmroutine, rc = xx, errno = yyy IPC failure on Socket CSCIzzzzz

Explicación: falló la lectura en la conexión mencionada.

Variable:

  • xx es el código de retorno de IBM CPI

  • yyy es el valor de errno de UNIX en /usr/include/sys/errno.h

  • CSCIzzzzz es el número de socket que estaba en uso

  • cmroutine es el nombre de la rutina de IBM CPI que falló

Read failed for connection: connection_name

Explicación: falló la lectura en la conexión mencionada.

Variable: connection_name es el nombre de la conexión en la que falló la lectura.

Write failed for connection: connection_name

Explicación: falló la escritura en la conexión mencionada.

Variable: connection_name es el nombre de la conexión en la que falló la escritura.

Variable de entorno

csciTcpServer.sh invoca CSCI, un Nombre de programa de transacción (TPN, Transaction Program Name) en el directorio /$ACS_HOME/bin donde los ejecutables de ACSLS residen. Esta secuencia de comandos de shell define las variables de entorno de CSCI.

La siguiente tabla describe las variables de entorno de CSCI para el subsistema de servidor y una secuencia de comandos de shell similar a la proporcionada en la distribución del software de ACSLS/CSCI. TCP/IP inicia esta secuencia de comandos de shell en el servidor.

Tabla N-1 Variables de entorno de subsistema del servidor CSCI

Nombre Descripción

START_CSCI_PROCESS

Inicia automáticamente CSCI al inicio de ACSLS (TRUE o FALSE)

CSCI_TRACE

Esta variable indica si el rastreo de CSCI está ON (ACTIVADO) u OFF (DESACTIVADO).

CSCI_SLEEP_TIME

Esta variable indica el tiempo de suspensión de PER al final de cada bucle de operación por turnos mediante una tabla de conexión (timeout de sondeo). El valor por defecto es 100 ms.

CSCI_INITIAL_CONNECTION

Esta variable indica que se abra primero el nombre de conexión inicial de la CSCI. Este es el nombre del servicio de conexión que requiere E/S en el inicio de la CSCI. Los clientes generalmente abren IPC primero; los servidores abren TCP/IP primero.

CSCI_SERVER_NAME

Esta variable indica el nombre del servidor CSCI. Se debe establecer el mismo para todos los clientes de CSCI definidos en un solo servidor CSCI. El nombre del servidor debe coincidir con el CSCI_SERVER_NAME de sus clientes de CSCI. La coincidencia de CSCI_SERVER_NAME del servidor y el cliente proporciona un enlace lógico integral entre equipos. Finalmente, este nombre se une posteriormente para el “nombre de conexión” en otras variables del entorno. El valor asignado a CSCI_SERVER_NAME se debe replicar en la parte del nombre de conexión de las variables posteriores.

CSCI_connectionname_NET_TYPE

Esta variable indica el tipo de red para el que está configurada esta CSCI desde el subsistema CIF. NETTYPE define la capa de transporte utilizada por esta CSCI. Las asignaciones válidas son LU62 o IPC.

CSCI_connectionname_INPUT_
SOCKET

Esta variable indica el número de socket de entrada para usar como entrada para esta CSCI. Este número debe coincidir con el número de socket de salida de la aplicación de servidor o cliente.

CSCI_connectionname_CON_
TYPE

Esta variable indica este tipo de CSCI. Este CON_TYPE define que la CSCI es un SERVER (servidor) o un CLIENT (cliente).

CSCI_connectionname_
TRANSLATE_TYPE

Esta variable indica el tipo de CSCI XDR que se empleará durante la ejecución. Se puede asignar XDR o NONE (ninguno).

CSCI_connectionname_
DESTINATION_SOCKET

Esta variable indica el número de socket de salida o destino utilizado por el servidor CSCI. Este número de socket debe coincidir con el número de socket de entrada a la aplicación de servidor de CSCI.