Programme utilisateur d'installation automatique lors de l'installation
Lorsque le programme utilisateur d'installation automatique est appelé pour l'installation d'une ressource IPCONN, CICS® lui transmet une liste de paramètres dans une zone de communication adressée par DFHEICAP.
La zone de communication à INSTALL pour IPCONNs
La zone de communication est mappée par l'assembleur DSECT DFHISAIC, qui est fourni dans CICSTS56.CICS.SDFHSAMP.Figure 1 : Installez automatiquement la zone de communication du programme utilisateur à l'installation. Pour les connexions IP.
ISAIC_FUNCTION DS CL1 Function code (X'F0' for Install)
ISAIC_RESPONSE DS CL1 Response code
DS CL2 Reserved
ISAIC_IPCONN DS CL8 Name for the autoinstalled IPCONN
ISAIC_APPLID DS CL8 The applid of remote system
ISAIC_SUGGESTED_APPLID DS CL8 Suggested applid, if isaic_applid
* is blank
ISAIC_NETWORKID DS CL8 Network ID of remote system
ISAIC_TCPIPSERVICE DS CL8 Name of the TCPIPSERVICE on which
* this connect flow arrived
ISAIC_TEMPLATE DS CL8 Name of the template IPCONN
ISAIC_HOST DS CL116 Host name of remote system
ISAIC_PORT DS F Call back port number of
* remote system
ISAIC_RECEIVECOUNT DS F Number of receive sessions wanted
* by remote system
isaic_applid (entrée/sortie)
Zone de 8 caractères contenant l'ID application du système distant qui tente de se connecter, comme envoyé sur le flux de connexion. Le programme utilisateur ne peut modifier cette valeur que s'il est vide en entrée (ce qui indique que le système de connexion est probablement un client Java™ ). S'il est vide dans la sortie, CICS utilise l' ID application suggéré désigné par la zone isaic_suggted_applid.
isaic_function (Entrée)
Code à 1 caractère indiquant la fonction pour laquelle le programme utilisateur d'installation automatique a été appelé. Contient X'F0'pour l'installation.
isaic_host (entrée/sortie)
Zone de 116 caractères contenant le nom d'hôte du système distant, tel que transmis dans le flux de connexion. Le programme utilisateur d'installation automatique est autorisé à modifier cela car il est possible qu'il ait une meilleure idée de ce que le système de connexion est appelé localement que le système lui-même.
isaic_ipconn (Sortie)
Zone de 8 caractères contenant le nom à utiliser pour la connexion IPCONN installée automatiquement. Le programme utilisateur doit fournir le nom.
isaic_networkid (entrée)
Zone de 8 caractères contenant l'ID réseau du système qui tente de se connecter, tel qu'il est envoyé sur le flux de connexion.
isaic_port (entrée/sortie)
Le numéro de port de rappel pour le client. - -1 signifie qu'aucun rappel n'est autorisé. Le programme d'installation automatique peut modifier cette valeur pour la même raison qu'il peut modifier le nom d'hôte, sauf s'il s'agit de -1, auquel cas il ne peut pas être modifié. Le programme d'installation automatique n'est pas non plus autorisé à modifier cette valeur à -1.
isaic_receivecount (Entrée)
Zone binaire de 4 octets contenant le nombre de sessions de réception que le système distant souhaite prendre en charge par cette IPCONN. (Il s'agit de sessions d'envoi à l'extrémité du système distant.)
isaic_response (Sortie)
Code de réponse: zéro signifie OK.
isaic_suggted_applid (Entrée)
Zone de 8 caractères contenant un ID application de système distant suggéré par CICS. Si l'ID application du système distant désigné par isaic_applid est vide, CICS utilise un compteur pour générer un nom de chiffre décimal à 8 caractères au format 00000027.
isaic_tcpipservice (Entrée)
Zone de 8 caractères contenant le nom du TCPIPSERVICE sur lequel ce flux de connexion est arrivé.
isaic_template (entrée/sortie)
Zone de 8 caractères contenant le nom d'un IPCONN installé à utiliser comme modèle pour la nouvelle ressource IPCONN.
Par défaut, cette zone est vide et CICS fournit les informations requises pour créer la ressource IPCONN.
Le programme utilisateur d'installation automatique peut modifier cette zone pour nommer un modèle de ressource IPCONN. Si le modèle de ressource IPCONN est hors service, la demande d'installation automatique est rejetée.