Propriétés de spécification d'activation

Les propriétés de spécification d'activation contiennent les informations de configuration du traitement des événements entrants pour un noeud final de message. Vous pouvez les configurer à l'aide de l'assistant de reconnaissance de service d'entreprise ou de la console d'administration WebSphere Process Server.

Les propriétés de spécification d'activation J2C (également appelées propriétés des noeuds finaux de message) correspondent à l'interface ActivationSpec de la spécification JCA (J2EE Connector Architecture). Ces propriétés s'appliquent à l'utilisation de l'interface ALE car une spécification d'activation est utilisée lors de l'activation des noeuds finaux. L'activation des noeuds finaux est le processus qui permet de notifier l'adaptateur que des programmes d'écoute d'événements sont admissibles. Pour le traitement des évé nements entrants, l'adaptateur utilise ces programmes d'écoute pour recevoir les événements de SAP avant de les transmettre au noeud final (un bean géré par message).

Lorsque vous configurez l'adaptateur, indiquez les propriétés de spécification d'activation mentionnées ci-dessous.

Tableau 1. Propriétés de spécification d'activation
Nom de propriété dans la reconnaissance de service d'entreprise Nom de propriété dans la console d'administration Type Description Valeur par défaut
Ale Failure Code aleFailureCode String (chaîne) Indique le code d'état de l'échec de distribution. Vous devez indiquer une valeur pour cette propriété (68 ou 58) pour que l'adaptateur mette à jour le code d'état de l'échec SAP une fois qu'il a extrait un objet IDoc pour le traitement des événements. SAP convertit cette valeur en 40. None
Ale Failure Text aleFailureText String (chaîne) Indique la description de l'échec de distribution. La spécification d'une valeur pour cette propriété est facultative, même si vous définissez AleUpdateStatus sur true. None
Ale Selective Update aleSelectiveUpdate String (chaîne) Indique les combinaisons de type d'IDoc et de type de message à mettre à jour lorsque l'adaptateur est configuré pour mettre à jour un code d'état SAP standard. Vous ne pouvez définir des valeurs pour cette propriété que si la propriété AleUpdateStatus est définie sur true.

La syntaxe de cette propriété est la suivante : IDocType: MessageType [;IDocType: MessageType [;...]], où une barre oblique (/) sépare chaque IDoc Type et MessageType et un point-virgule (;) délimite les entrées d'un ensemble.

L'exemple ci-après illustre deux ensembles. Dans l'exemple, MATMAS03 et DEBMAS03 sont les objets IDocs et MATMAS et DEBMAS sont les types de message :

MATMAS03/MATMAS;DEBMAS03/DEBMAS

 
Ale Status Message Code aleStatusMsgCode String (chaîne) Si nécessaire, cette propriété indique le code de message à utiliser lorsque l'adaptateur envoie l'objet IDoc du message ALEAUD (ALEAUD01). Configurez ce code de message dans le profil partenaire récepteur. Vous ne pouvez définir une valeur pour cette propriété que si la propriété AleUpdateStatus a été définie sur true. None
Ale Success Code aleSuccessCode String (chaîne) Indique le code d'état de réussite pour le document d'application envoyé. Vous devez indiquer une valeur pour cette propriété (52 ou 53) pour que l'adaptateur mette à jour le code d'état de réussite SAP une fois que l'interface a extrait un objet IDoc pour le traitement des événements. SAP convertit cette valeur en statut 41 (Document d'application créé dans le système récepteur). None
Ale Success Text aleSuccessText String (chaîne) Indique la description d'un document d'application correctement envoyé. La spécification d'une valeur pour cette propriété est facultative, même si vous définissez AleUpdateStatus sur true. None
Ale Update Status aleUpdateStatus Boolean Indique si une piste d'audit est requise pour tous les types de message. Définissez cette propriété sur true si vous souhaitez que l'adaptateur mette à jour un code d'état SAP standard après que l'adaptateur ait extrait u objet IDoc pour le traitement des événements. False
Application Server Host applicationServerHost String (chaîne) Lors de la configuration de l'adaptateur pour une exécution sans équilibrage de la charge, cette propriété indique l'adresse IP ou le nom du serveur d'applications que l'adaptateur utilise pour se connecter.Qu'il soit configuré ou non pour une exécution sans équilibrage de la charge, l'adaptateur considère que le nom de l'hôte passerelle correspond à la valeur spécifiée pour cette propriété. None
Assured Once only Delivery assuredOnceDelivery Boolean Si cette propriété est définie sur true, l'adaptateur tente de stocker des informations XID dans le magasin d'événements. Si elle est définie sur false, l'adaptateur ne tente pas de stocker les informations. La valeur true assure une seule distribution des événements. La valeur false n'assure aucune distribution des événements mais apporte de meilleures performances. Cette propriété n'est utilisée que si la MDB est transactionnelle. Si tel n'est pas le cas, vous ne pouvez utiliser aucune transaction, quelle que soit la configuration. True
Auto Create Event Table EP_CreateTable Boolean Indicateur qui indique si l'adaptateur doit créer automatiquement la table de reprise des événements si elle n'existe pas déjà. True
Client client String (chaîne) Numéro du client SAP sous lequel l'adaptateur se connecte. Cette valeur est souvent 100. 100
Codepage Number codepage Integer (nombre entier) Etablit une connexion au langage approprié. Cette propriété doit correspondre à la valeur spécifiée dans la propriété Language.

Par exemple, si la propriété Language est définie sur JA (Japonais), la propriété Codepage doit avoir la valeur 8000, comme indiqué par l'application SAP.

Reportez-vous à la documentation SAP pour connaître les valeurs exactes des propriétés Language et Codepage.

 
Database Schema Name EP_SchemaName String (chaîne) Schéma permettant de créer automatiquement la table de reconnaissance des événements. None
DataSource Name BiDi Special Format biDiContext_EDTDatasource BiDiSpecialFormat String (chaîne) Contrôle le format bidirectionnel spécifique pour toutes les propriéts EP.  
EIS BiDi Format biDiContextEIS String (chaîne) Format bidirectionnel utilisé par SAP pour ses données métier.  
EIS BiDi Special Format biDiContextSpecialFormat String (chaîne) Indique la catégorie des valeurs soumises à un traitement spécial lors de l'appel de transformation BiDi, afin de garantir l'exactitude de la transformation de catégorie. Plusieurs catégories sont prédéfinies (FTP, URL et adresses électroniques par exemple).  
EIS Connection Retry Interval retryInterval Integer (nombre entier) Indique le délai d'attente avant la tentative de redémarrage des programmes d'écoute d'événement ALE. La valeur doit être exprimée en millisecondes.  
EIS Connection Retry Limit retryLimit Integer (nombre entier) Indique le nombre de tentatives de redémarrage des programmes d'écoute d'événements ALE effectuées par l'adaptateur. A value of 0 indicates an infinite number of retries. 0
Event Persistence BiDi Format biDiContext_EDTTablenameEIS String (chaîne) Indique le format bidirectionnel de la propriété Event Persistence. ILYNN
Event Recovery DataSource (JNDI) Name EP_DataSource_JNDIName String (chaîne) Nom JNDI de la source de données configurée pour la reprise des événements. None
Event Recovery Table Name EP_TableName String (chaîne) Nom de la table de reprise des événements.  
Gateway Host gatewayHost String (chaîne) Hôte passerelle SAP sur lequel le service passerelle est exécuté. None
Gateway Service gatewayService String (chaîne) Identificateur du serveur de passerelle. Cette valeur est souvent sapgw00. 00 est le numéro système du serveur exécutant la passerelle SAP (généralement un serveur d'applications). Cette valeur ne peut pas être 00 si vous possédez plusieurs serveurs. sapgw00
Logon Group logonGroup String (chaîne) Lors de la configuration de l'adaptateur pour l'équilibrage de la charge, cette propriété indique le nom du groupe de connexion qui représente un groupe de serveurs d'applications. None
Ignore IDoc Packet Errors ignoreIDocPacketErrors Boolean (booléen) Si l'adaptateur rencontre une erreur lors du traitement du paquet IDoc, il peut se comporter de deux manières différentes.

Si cette propriété est définie sur false, l'adaptateur arrête le traitement des objets IDoc restants du paquet en cours et signale une erreur au système SAP.

Si cette propriété est définie sur true, l'adaptateur consigne une erreur et poursuit le traitement des objets IDoc de ce paquet.

Cette propriété n'est pas utilisée pour les objets IDoc uniques et pour les paquets IDoc non partagés.

 
Language language String (chaîne) Langue dans laquelle l'adaptateur se connecte. E pour anglais
Message Server Host messageServerHost String (chaîne) Lors de la configuration de l'adaptateur pour l'équilibrage de la charge, cette propriété indique le nom du serveur de messages. None
Metadata BiDi format biDiContextMetadata String (chaîne) Indique le format bidirectionnel des métadonnées de configuration.  
Number Of Listeners numberofListeners Integer (nombre entier) Indique le nombre de programme d'écoute d'événements qui doivent être démarrés. 1
Partner Charset partnerCharset String (chaîne) Indique un codage PartnerCharset. Lorsqu'un codage est spécifié, il est utilisé. Dans le cas contraire, c'est le codage par défaut qui est utilisé. None
Password password String (chaîne) Mot de passe du compte utilisateur de l'adaptateur du système SAP.  
Password BiDi Format biDiContext_PasswordEIS String (chaîne) Indique le format bidirectionnel de la valeur Password. ILYNN
Password to connect to Event Datasource EP_Password String (chaîne) Mot de passe permettant de se connecter à la base de données. None
RFC Program ID rfcProgramID String (chaîne) Identificateur du programme sous lequel le programme du serveur RFC s'enregistre. None
RFC Trace On RFCTraceOn Boolean Indique si un fichier texte détaillant l'activité RFC de chaque programme d'écoute dévénements doit être généré. Vous pouvez spécifier la valeur sur true ou false. La valeur true active le traçage qui génère un fichier texte. N'utilisez ces fichiers texte que dans un environnement de développement car leur taille augmente rapidement. False
SAP System ID SAPSystemID String (chaîne) Lors de la configuration de l'adaptateur pour l'équilibrage de la charge, cette propriété indique le nom logique du système SAP (également appelé nomR3). None
Skip BiDi Transformation biDiContextSkip String (chaîne) Contrôle l'appel de transformation bidirectionnelle. Les valeurs possibles sont true ou false. Une valeur vide fait intervenir le mécanisme de recherche.  
Skip BiDi Transformation for DataSource Name biDiContext_EDTDatasourceEIS Boolean Contrôle l'appel du support de transformation bidirectionnelle du texte pour la propriété Password. True
Skip BiDi Transformation for Event Persistence biDiContext_EDTTablenameSkip Boolean Contrôle l'appel du support de transformation bidirectionnelle du texte pour la propriété Event Persistence. True
Skip BiDi Transformation for Password biDiContext_PasswordSkip Boolean Contrôle l'appel du support de transformation bidirectionnelle du texte pour la propriété Password. True
Skip BiDi Transformation for User Name biDiContext_UserNameSkip Boolean Contrôle l'appel du support de transformation bidirectionnelle du texte pour la propriété User name. True
System Number systemNumber String (chaîne) Numéro système du serveur d'applications. Cette valeur correspond à un numéro à deux chiffres (souvent 00). 00
User Name userName String (chaîne) Nom du compte utilisateur de l'adaptateur sur le système SAP. None
User Name BiDi Format biDiContext_UserNameEIS String (chaîne) Indique le format bidirectionnel de la propriété User name. ILYNN
Username to connect to Event Datasource EP_UserName String (chaîne) Nom d'utilisateur permettant de se connecter à la base de données. None
Référence associée
Propriétés de connexion de l'assistant de reconnaissance de service d'entreprise
Propriétés de l'adaptateur de ressources
Propriétés des fabriques de connexions (J2C) gérées
Paramètres de contrôle de la transformation bidirectionnelle

Conditions d'utilisation |


(c) Copyright IBM Corporation 2005, 2006.
Ce centre de documentation repose sur la technologie Eclipse (http://www.eclipse.org)