Enregistrement d'un espace adresse externe sur un serveur Liberty local à l'aide d'adaptateurs locaux optimisés

Pour que WebSphere Optimized Local Adapters (WOLA) puisse envoyer un appel sortant à votre groupe d'adaptateurs locaux optimisés local ou un appel entrant sur un serveur Liberty, vous devez lier l'espace adresse courant au serveur Liberty et définir des attributs de connexion à l'aide de l'API Register.

Avant de commencer

Activez l'environnement de serveur Liberty en vue de l'utilisation de WOLA. Pour plus d'informations, voir Enabling the Liberty server environment to use optimized local adapters.

Le serveur Liberty doit être actif sur l'image z/OS de laquelle provient la demande d'enregistrement.

Si vous utilisez CICS (Customer Information Control System), activez la prise en charge des adaptateurs locaux optimisés dans CICS. Pour plus d'informations, voir Activation de la prise en charge des adaptateurs locaux optimisés de Liberty dans CICS. Activez le programme d'exit utilisateur associé à une tâche (TRUE) avant d'établir une connexion entre CICS et le serveur Liberty.

Procédure

  1. Choisissez les paramètres à utiliser lorsque vous enregistrez l'espace adresse à l'aide de l'API Register, BBOA1REG.
    L'API accepte des paramètres pour les éléments suivants :
    • Les trois parties du nom de groupe WOLA que vous avez spécifiées lorsque vous avez ajouté la fonction au fichier server.xml
    • Le nom d'enregistrement
    • Le nombre minimal de connexions initiales
    • Le nombre maximal de connexions
    • Les mots d'indicateur d'enregistrement spécifiant le comportement de la fonction de trace

    Pour les appels entrants sur un serveur Liberty, un contexte de sécurité contenant l'ID utilisateur de l'espace adresse à l'origine de la demande est toujours propagé sur le serveur Liberty. Pour CICS, l'indicateur d'enregistrement reg_flag_C2Wprop propage l'ID utilisateur de la tâche CICS plutôt que l'ID utilisateur de l'espace adresse.

    Pour les appels sortants provenant du serveur Liberty, l'indicateur d'enregistrement reg_flag_W2Cprop indique au serveur Liberty qu'il doit propager l'ID utilisateur dans CICS. Ensuite, CICS tente de démarrer le programme cible avec cet ID utilisateur.

    Pour plus d'informations sur les paramètres d'API, voir API d'adaptateurs locaux optimisés sur Liberty pour z/OS et Sécurisation des adaptateurs locaux optimisés dans Liberty pour z/OS.

  2. Vérifiez qu'un autre groupe d'adaptateurs locaux optimisés auquel cet espace adresse est connecté n'utilise pas déjà le nom d'enregistrement sélectionné. Si le nom d'enregistrement est utilisé par un autre groupe d'adaptateurs locaux optimisés, un code retour d'erreur est renvoyé et la demande d'enregistrement échoue.
  3. Appelez l'API Register pour votre programme appelant depuis l'application en langage natif dans l'espace adresse client avec les paramètres que vous avez sélectionnés.

    Le code retour et anomalie 0 indique que l'espace adresse client est désormais lié au serveur Liberty.

Résultats

La chaîne de nom d'enregistrement transmise est réservée dans l'espace adresse courant. Aucun autre appel d'enregistrement ne peut être effectué avec ce jeton tant qu'un appel d'API Unregister n'a pas été reçu pour l'enregistrement.
Important : Si vous utilisez le paramètres de nombre minimal de connexions dans cet appel, le résultat est un pool de connexions établies préalablement au serveur cible et qui attendent des demandes.
Un contexte d'entrée d'enregistrement ou un bloc de contrôle est également créé et associé à la chaîne de nom d'enregistrement. Chaque nom d'enregistrement possède un contexte d'enregistrement spécifique. Plusieurs noms d'enregistrement associés au même espace adresse et à la même unité d'exécution peuvent être liés à un ou plusieurs groupes d'adaptateurs locaux optimisés Liberty.

Que faire ensuite

Vous pouvez utiliser l'enregistrement pour effectuer des appels entrants et sortants entre l'environnement Liberty et l'espace adresse externe. Pour plus d'informations, voir Développement d'applications en vue de l'utilisation d'adaptateurs locaux optimisés dans Liberty.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_dat_register.html