N CSCI

Ce chapitre décrit le composant CSCI (Client Server Communications Interface).

Ce chapitre traite les sujets suivants :

• Présentation de l'interface CSCI

• Messages d'erreur

• Variables d'environnement

L'installation de la CSCI doit être postérieure à l'installation du système d'exploitation et à l'installation et la configuration d'ACSLS.

Remarque :

Pour qu'ACSLS fonctionne correctement, la variable de configuration START_CSCI_PROCESS doit être définie sur TRUE. Cette opération s'effectue dans l'option 1 de acsss_config. Voir Définition des variables contrôlant le comportement d'ACSLS.

Présentation de l'interface CSCI

L'interface CSCI (Client Server Communications Interface) est un composant autonome responsable de la transmission de paquets de demande et de réponse entre deux systèmes client et serveur. L'interface CSCI est un composant facultatif qui permet à des clients MVS ou RMLS/CSC de communiquer avec ACSLS. Si vous ne vous servez pas de la CSCI, vous l'utilisez par défaut pour communiquer avec ACSLS.

Connectivité CSCI

La CSCI fournit la connectivité IPC et TCP/IP pour lier le serveur ACSLS aux clients MVS ou RMLS/CSC

Architecture et sous-systèmes

La figure suivante présente l'ensemble de l'architecture et des sous-système CSCI.

Figure N-1 Architecture et sous-systèmes CSCI

La figure suivante présente la connexion du système CSCI avec l'interface réseau. Côté serveur, les données circulent du hub réseau à l'interface CSCI, via l'interface TCP/IP. A partir de là, les données circulent via un interface IPC vers le logiciel ACSLS dans les deux sens, mais en mode semi-duplex , par exemple, un sens à la fois.

Figure N-2 Système CSCI avec une interface Token Ring

Messages d'erreur

Les messages d'erreur relatifs à l'installation et la configuration de la CSCI relèvent des conditions suivantes :

• Propriété incorrecte

• Autorisation d'accès incorrecte

• Variables d'environnement non définies

• Ensemble de conditions diverses

• Configuration CSCI et TCP/IP incorrecte

Messages d'erreur communs

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

Explication : échec de lecture sur la connexion nommée.

Variable :

• xx est un code de retour CPI IBM

• yyy est le numéro d'erreur UNIX dans /usr/include/sys/errno.h

• CSCIzzzzz est le numéro de socket utilisé

• cmroutine est le nom de la routine CPI IBM qui a échoué

Echec de lecture pour la connexion : connection_name

Explication : échec de lecture sur la connexion nommée.

Variable : connection_name est le nom de la connexion sur laquelle la lecture a échoué.

Echec d'écriture pour la connexion : connection_name

Explication : échec d'écriture sur la connexion nommée.

Variable : connection_name est le nom de la connexion sur laquelle l'écriture a échoué.

Variables d'environnement

La CSCI est appelée parcsciTcpServer.sh, un nom de TP (Transaction Program Name) dans le répertoire /$ACS_HOME/bin où les exécutables ACSLS résident. Ce script shell définit les variables d'environnement CSCI.

Le tableau suivant décrit les variables d'environnement CSCI pour le sous-système serveur et un script shell similaire à celui fourni dans la distribution des logiciels ACSLS/CSCI. Ce script shell démarre par TCP/IP sur le serveur.

Tableau N-1 Variables d'environnement du sous-système serveur CSCI

Nom	Description
START_CSCI_PROCESS	Démarre automatiquement la CSCI au démarrage d'ACSLS (TRUE ou FALSE)
CSCI_TRACE	Cette variable indique si le suivi CSCI est ON (activé) ou OFF (désactivé).
CSCI_SLEEP_TIME	Cette variable indique la durée d'inactivité de PER à la fin de chaque boucle de tourniquet (round-robin) sur la table de connexions (délai d'attente d'l'interrogation). La durée par défaut est 100 ms.
CSCI_INITIAL_CONNECTION	Cette variable indique le nom de la connexion initiale de la CSCI à ouvrir en premier. Il s'agit du nom du service de connexion nécessitant des E/S au démarrage initial de la CSCI. Généralement, les clients ouvrent IPC en premier et les serveurs ouvrent TCP/IP en premier.
CSCI_SERVER_NAME	Cette variable indique le nom du serveur CSCI. Elle doit être identique pour tous les clients de la CSCI définis sur un seul serveur CSCI. Le nom du serveur doit correspondre à la valeur CSCI_SERVER_NAME de ses clients CSCI. La correspondance de la valeur CSCI_SERVER_NAME entre le serveur et les clients fournit un lien logique de bout en bout entre les machines. Enfin, ce nom est utilisé ultérieurement comme paramètre "connectionname" dans d'autres variables d'environnement. La valeur assignée au CSCI_SERVER_NAME doit être répliquée dans la partie connectionname des variables suivantes.
CSCI_connectionname_NET_TYPE	Cette variable indique le type de réseau pour lequel la CSCI est configurée à partir du sous-système CIF. NETTYPE définit la couche de transport utilisée par la CSCI. Les valeurs valides sont LU62 ou IPC.
CSCI_connectionname_INPUT_ SOCKET	Cette variable indique le numéro de socket d'entrée à utiliser comme entrée pour la CSCI. Il doit correspondre au numéro de socket de sortie de l'application serveur ou client.
CSCI_connectionname_CON_ TYPE	Cette variable indique le type de la CSCI. CON_TYPE définit la CSCI en tant que serveur ou client.
CSCI_connectionname_ TRANSLATE_TYPE	Cette variable indique le type XDR de la CSCI à utiliser pendant l'exécution. La valeur assignée peut être XDR ou NONE.
CSCI_connectionname_ DESTINATION_SOCKET	Cette variable indique le numéro de socket de destination ou de sortie que le serveur CSCI doit utiliser. Il doit correspondre au numéro de socket d'entrée de l'application serveur CSCI.