Automation Engine 10. Automation Engine et SAP

Transcription

1 Automation Engine 10 ONE Automation Platform Automation Engine et SAP Version: Date de Publication: Automic Software GmbH

2 ii Copyright Copyright Les logos Automic et Automic sont des marques déposées appartenant à Automic Software GmbH (Automic). L'utilisation de toutes les marques déposées nécessite une autorisation explicite écrite et est soumise aux conditions de la licence. Les logiciels et/ou le programme sont la propriété protégée d'automic Software. L'accès et l'utilisation de ces derniers sont soumis à des conditions de licence devant être approuvées par écrit. Les logiciels et/ou le programme sont également protégés par des droits de reproduction par des contrats internationaux ainsi que par les lois nationales et internationales. Un accès et/ou une utilisation non autorisés peuvent entraîner des poursuites civiles et pénales. La copie non autorisée et d'autres formes de reproduction partielle ou totale, la décompilation, la reproduction, la modification, ou le développement de produits dérivés du logiciel sont strictement interdits. Le nonrespect de ces conditions peut entraîner des poursuites pénales. Sous réserve de modifications. Aucune responsabilité ne sera acceptée pour toute modification, omission, erreur d'impression ou de production. Toute reproduction, totale ou partielle, est strictement interdite. Copyright Automic Software GmbH. Tous droits réservés.

3 Automation Engine iii Contents 1 Solutions SAP et Job Scheduling avec l'automation Engine 1 2 SAP NetWeaver Automation Engine et SAP NetWeaver Intégration à People Intégration dans SAP Enterprise Portal (iviews) 4 Introduction 4 Démarrage de Tâches 5 Surveillance des activités Intégration d informations Planification des processus de chargement des données Planification des chaînes de processus Planification de requêtes dans le batch Intégration des processus Surveillance des canaux de communication SAP XI Plate-forme d'application ABAP 11 Gestion des variantes 11 JCL pour SAP 12 Gestion de BDC 12 JCL pour SAP 12 Gestion de Spool 13 JCL pour SAP 13 Gestion d'evènements 14 Evènement SAP 14 Prise en charge par l'automation Engine 15 JCL pour SAP 15 Gestionnaire de critères 15 JCL pour SAP 16 Reprise de Jobs SAP 16 Reprise des définitions de calendrier SAP Gestion des Jobs 20 Exécution de Jobs dans la pile ABAP (CCMS) 20

4 iv Contents JCL pour SAP 21 Processus fils 22 JCL pour SAP 23 Jobs interceptés 23 JCL pour SAP 24 Analyse du code retour d'application des steps SAP 24 Avec un élément de script 24 Avec le rapport de Liste de steps 24 Avec le rapport de Job JAVA 26 Agent Java EE/JMX pour SAP NetWeaver 26 JMX dans SAP NetWeaver 26 Surveillance du moteur J2EE 26 Démarrage et arrêt d'un service 27 Exécution de Jobs dans la pile Java (JXBP) 30 Rapport pour les statistiques du Job Java 30 Installation 30 Cas exceptionnels 31 Codes retour Gestion du cycle de vie Surveillance de SAP NetWeaver 31 Surveillance des moniteurs 31 JCL pour SAP 32 Surveillance des Evènements SAP 32 Déroulement 33 Conseils Intégration de l'automation Engine à SAP Solution Manager Inscription dans le système Landscape Directory Analyse du log système et du log application Commutation des modes de fonctionnement 38 3 SAP Banking Gestion de processus pour SAP for Banking 40 4 SAP Financial Closing Cockpit Intégration de l'automation Engine dans SAP Closing Cockpit 43

5 Automation Engine v 4.2 Activation d'objets avec SAP Closing Cockpit 47 5 SAP Solution Manager Intégration de SAP Solution Manager 51 Configuration et test SAP Solution Manager - Cas d'application Configurer une connexion avec l'interface Utilisateur 59 6 Solutions personnalisées Archivage des données dans SAP Traitements en masse Copie de Client dans SAP R/ Dialogue SAP pour l'automation Engine Automated SystemCopy for SAP 67 7 Liaison technique Automation Engine et SAP Plusieurs systèmes SAP Objets SAP Security Prise en compte d'attributs de Job Interfaces Interfaces Différences au niveau des fonctions Transport de l'interface 78 Nom du fichier 78 Importation des modules fonctionnels dans SAP 79 Requis : 79 Déroulement: Test de l'interface avec ABAP Workbench Agent pour SAP BW Paramètres d'archivage avec R3_ACTIVATE_REPORT ERROR/ERRORLEVEL dans R3_ACTIVATE_SESSIONS Résolution de problèmes Conseils sur la recherche d'erreurs 89 Rapport de Job 89 Attributs de l'objet activé 89 Utilisateur CPIC 89

6 vi Contents Transactions utiles 89 Fichiers log 89 Le log système SAP 89 Traces Problèmes lors de l'importation des modules fonctionnels Jobs SAP se terminant par ARCHIVE_INFO_NOT_FOUND Problème de stabilité avec des instances SAP chez de nombreux Agents SAP (connexion RFC) sur un serveur : Problème de transmission de mot de passe à SAP 92 8 Certification Résumé 95 Glossaire 96.1 A 96.2 B 96.3 C 97.4 D 98.5 E 98.6 F 99.7 G 99.8 H 99.9 I J L M O P Q R S T U V W

7 Automation Engine 1 1 Solutions SAP et Job Scheduling avec l'automation Engine Lorsque vous utilisez des solutions SAP et qu'il vous faut un Job Scheduling efficace, Automation Engine est une solution idéale. Elle permet une intégration rapide et transparente de toutes les applications SAP dans le contrôle de processus d'entreprise. Automation Engine prend en charge toutes les applications SAP, y compris SAP R/3, mysap Business Suite et SAP NetWeaver ainsi que les solutions sectorielles, se basant sur ces applications, pour les télécommunications, l'approvisionnement, la banque, etc. Résultat : les processus informatiques dans diverses applications SAP sont gérés et surveillés centralement et sont en phase avec le reste de votre exploitation informatique mondiale. Développé comme un planificateur d'entreprise, l'automation Engine ne nécessite aucun composant intergiciel, tel qu'un serveur d'applications JAVA, et il permet une fonctionnalité de planification très poussée sur l'ensemble de l'infrastructure informatique. Le système est directement lié à SAP NetWeaver et accélère ainsi la création et la maintenance de Jobs pour les applications SAP. Les rapports, variantes et tous les autres paramètres nécessaires sont disponibles au travers de l'interface graphique intuitive et conviviale de Automation Engine. Les problèmes relatifs aux accès manuels, aux erreurs de saisie ou aux listes de paramètres obsolètes sont éliminés de manière efficace. Il est facile de créer les Jobs avec la fonctionnalité de glisserdéposer, de plus, ceux-ci sont affichés graphiquement à l'écran. Cela assure une excellente visibilité et simplifie la gestion et le contrôle. Grâce à une automatisation complète de tous les processus informatiques, Automation Engine augmente la productivité au niveau de l'utilisation des solutions d'entreprise de SAP. Les Jobs d'arrière-plan et les processus des applications SAP sont surveillés centralement et automatisés. Automation Engine assure une meilleure performance grâce à un traitement d'arrière-plan optimisé et à un nombre réduit d'interruptions et d'erreurs du système. Rubriques connexes : Automation Engine et SAP NetWeaver

8 2 Chapter 2 SAP NetWeaver 2 SAP NetWeaver 2.1 Automation Engine et SAP NetWeaver Cette documentation suit l'architecture SAP NetWeaver et explique les fonctions AE en fonction de cette dernière. De plus, y sont expliquées les fonctions pour les solutions sectorielles ainsi que les solutions personnalisées. Intégration à People Ce domaine de SAP NetWeaver sert à l'intégration d'utilisateurs finaux. L'Automation Engine crée des interfaces spécifiques aux rôles et rend ainsi le département concerné responsable du démarrage des processus avec les paramètres qui conviennent. Cela permet de désactiver les sources d'erreur potentielles et l'automation Engine exécute les processus prédéfinis en Tâche d'arrière-plan, sans souci d'erreur. Fonctionnalités de l'automation Engine Intégration dans SAP Enterprise Portal (iviews) Business Intelligence Le point central de cette couche est la gestion de l'entreposage. Les processus de chargement des données et les chaînes de processus sont contrôlés par l'automation Engine et, avec des processus supérieurs, ils sont également intégrés à d'autres plateformes. L'analyse et la représentation automatiques des processus individuels d'une chaîne, jusqu'au niveau le plus bas, vont ainsi de soi. Fonctionnalités de l'automation Engine

9 Automation Engine 3 Planification des processus de chargement des données Planification des chaînes de processus Planification de requêtes dans le batch Intégration des processus Cette partie traite l'intégration des processus métier à SAP Exchange Infrastructure (SAP XI). En tant qu'integration Broker, les messages peuvent être validés directement dans l'automation Engine via les processus à adaptateur standard SAP XI et inversement. Fonctionnalités de l'automation Engine Surveillance des canaux de communication SAP XI Plateforme d'application La plateforme d'application forme la base de toutes les applications SAP. L'Automation Engine utilise l'abap ainsi que le domaine Java pour mettre à votre disposition des fonctionnalités utiles. Fonctionnalités de l'automation Engine ABAP : Exécution de Jobs dans la pile ABAP (CCMS) Processus enfants Jobs interceptés Analyse du code retour d'application des steps SAP Gestion des variantes Gestion de BDC Gestion de Spool Gestion d'evènements Reprise de Jobs SAP Reprise des définitions de calendrier SAP JAVA : Agent Java EE/JMX pour SAP NetWeaver JMX dans SAP NetWeaver Exécution de Jobs dans la pile Java (JXBP) Gestion du cycle de vie Cette partie comprend le contrôle et la surveillance de toutes les solutions utilisées sur la base de la technologie SAP NetWeaver. L'Automation Engine a accès à toutes les données de surveillance d'un côté et, d'un autre côté, y fournit ses propres données.

10 4 Chapter 2 SAP NetWeaver Fonctionnalités de l'automation Engine Surveillance des moniteurs Surveillance des Evènements SAP Intégration de l'automation Engine à SAP Solution Manager Inscription dans le système Landscape Directory Analyse du log système et du log application Commutation des modes de fonctionnement Développement d'applications L'Automation Engine vous soutient pour le développement d'applications avec une kyrielle de possibilités. Fonctionnalités de l'automation Engine ABAB : CallAPI pour SAP JAVA : Interface d'application 2.2 Intégration à People Intégration dans SAP Enterprise Portal (iviews) Introduction Les iviews pour Job Scheduling apportent des informations actuelles sur le fonctionnement de Job Scheduling dans les composants SAP Enterprise Portal de SAP NetWeaver et permettent aux utilisateurs finaux de démarrer des processus commerciaux critiques. Les Tâches peuvent être démarrées et surveillées directement à partir de SAP Enterprise Portal. L'utilisateur final peut démarrer des processus importants, même sans connaissance de Job Scheduling. Lorsque cela est nécessaire, les paramètres correspondants peuvent être définis. Chaque utilisateur peut surveiller le statut actuel du traitement en arrière-plan via SAP Enterprise Portal. Les processus démarrés à cet emplacement sont contrôlés et surveillés par Automation Engine. L'état actuel est mis à disposition de l'utilisateur via la technologie iview. Rubriques connexes : Démarrage de Tâches Surveillance des activités

11 Automation Engine 5 Démarrage de Tâches L'"ActivateObject" de iview permet aux utilisateurs de démarrer les objets activables dans l'automation Engine. Pour cela, enregistrez le nom de l'objet et une description explicative dans les propriétés de personnalisation. Il est important de définir l'alias du système. Il doit correspondre à la désignation que l'administrateur a définie dans les paramètres système. Vous pouvez avec les alias de système accéder à différents systèmes AE. Le bouton "Start" permet désormais d'activer l'objet. iview affiche le numéro courant (RunID) de l'exécution actuelle ou de la dernière. D'autres informations sont à votre disposition en utilisant le lien "Détail" qui ouvre la fenêtre de détails. De même que dans l'interface Utilisateur, vous y trouverez des renseignements sur l'heure de début ou le code retour. Si l'exécution de l'objet requiert une saisie utilisateur car l'instruction de Script :READ a été utilisée, un masque de saisie correspondant est créé dans iview. Les astérisques "*" rouges symbolisent les champs obligatoires. Rubriques connexes : Surveillance des activités

12 6 Chapter 2 SAP NetWeaver Surveillance des activités Les "Activities" de iview affiche les activités du système AE qui ont été démarrées sous l'utilisateur. De même que dans l'interface Utilisateur, vous y trouverez des renseignements sur la priorité, l'heure de début ou le statut des Tâches, par exemple. Les informations sur les activités peuvent uniquement être consultées. iview ne permet pas d'effectuer des modifications du type interruption ou traitement de la Tâche. Il est possible de fusionner certaines colonnes et ainsi d'adapter l'affichage à vos besoins. Utilisez pour cela la configuration personnalisée. Il est important de définir l'alias du système. Il doit correspondre à la désignation que l'administrateur a définie dans les paramètres système. Rubriques connexes :

13 Automation Engine 7 Démarrage de Tâches 2.3 Intégration d informations Planification des processus de chargement des données Un info package est un objet qui décrit dans BW les conditions de sélection pour la demande de données d'un système source. Cet objet peut être planifié et contrôle ainsi un processus de chargement des données à partir d'un système source. Un info package peut être contrôlé de l'extérieur à partir d'une interface standard. Cette interface est utilisée en conséquence par l'automation Engine. JCL pour SAP Eléments de script BW_ACTIVATE_ INFOPACKAGE BW_GET_ INFOPACKAGES BW_SET_ INFOPACKAGE_ SELECTION Description Planifie un ou plusieurs Info Packages pour un démarrage immédiat. Lit des Info Packages à partir du système BW. Les Info Packages disponibles sont enregistrés dans le rapport d'activation ou dans un fichier. Définit les paramètres de sélection utilisés pour la lecture des Info Packages à partir du système BW Planification des chaînes de processus Dans votre système BW, vous pouvez représenter des déroulements par des chaînes de processus. Une telle chaîne se compose d'un processus de démarrage, de processus d'application individuels et de processus collectifs. Il est également possible d'associer des info packages. Avec l'automation Engine, il vous est possible de démarrer et de surveiller des chaînes de processus. Vous pouvez voir chacun des processus dans la Fenêtre d'activités de l'interface Utilisateur. Les protocoles des processus sont, en outre, enregistrés dans l'automation Engine dans le rapport de l'objet Job.

14 8 Chapter 2 SAP NetWeaver JCL pour SAP Eléments de script BW_ ACTIVATE_ CHAIN BW_GET_ CHAINS BW_ RESTART_ CHAIN Description Démarre une chaîne de processus, surveille l'exécution et enregistre ses protocoles dans le rapport d'activation. Lit les chaînes de processus à partir du système BW. Les chaînes de processus disponibles sont enregistrées dans le rapport d'activation ou dans un fichier. Continue une chaîne de processus interrompue.

15 Automation Engine Planification de requêtes dans le batch A l'aide de la transaction RSCRM_BAPI, vous pouvez créer des interrogations dans votre système BW avec de soi-disant requêtes. Le résultat est soit stocké dans une table, soit dans un fichier. Utilisez l'automation Engine pour exécuter les requêtes à intervalles réguliers ou selon les besoins. Identifiez-vous, tout d'abord, dans le système BW et exécutez la transaction RSCRM_BAPI. Planifiez la requête que vous voulez automatiser avec l'automation Engine. Chaque requête possède son propre ID batch. Ouvrez le moniteur de batch et copiez ce numéro. Créez maintenant un Job SAP dans le système AE. Utilisez l'onglet Forme ou écrivez directement dans l'onglet Script la fonction suivante : R3_ACTIVATE_REPORT REP='RSCRMREPORT_BAPI' Passez ensuite à l'onglet "SAP" et entrez l'id batch copié précédemment dans le champ "Jobname".

16 10 Chapter 2 SAP NetWeaver Il est possible d'intégrer l'objet Job dans votre traitement, par exemple dans un objet Schedule, et il exécute la requête aux moments définis par vos soins. En raison du comportement de SAP, vous ne voyez pas toutes les exécutions dans le moniteur de batch, mais uniquement la dernière. 2.4 Intégration des processus Surveillance des canaux de communication SAP XI Les adaptateurs SAP XI servent à échanger des données avec SAP Exchange Infrastructure. Ils transforment les messages de manière à ce qu'ils puissent être transmis via les canaux de communication. L'Agent SAP met à votre disposition des fonctions vous permettant de contrôler des canaux de communication : démarrage des canaux de communication arrêt des canaux de communication demande d'informations concernant les canaux de communication

17 Automation Engine 11 Utilisez dans le Job SAP les fonctions XI_GET_CHANNEL et XI_SET_CHANNEL. Les informations sur les canaux de communication sont enregistrées sous forme de document XML dans le rapport de Job. Les éléments de script pour XML préparent les données. De plus, vous pouvez surveiller les canaux de communication à l'aide des objets Evènements de type "Console". A chaque changement de statut, un Evènement est déclenché. Activez l'interface XI du fichier INI de l'agent SAP avec les paramètres de la section [SAP_XI]. Pour l'accès au système XI, un objet Login avec des données d'identification valides est nécessaire. L'Utilisateur XI doit disposer des autorisations pour contrôler les canaux de communication XI. Utilisez différents objets Login pour les systèmes SAP et XI lorsque les deux sont installés sur le même hôte. Sinon le Login n'est pas sans ambiguïté. AE JCL pour XI Elément de script XI_GET_CHANNEL XI_SET_CHANNEL Description Enumère les canaux de communication. Démarre et arrête les canaux de communication. 2.5 Plate-forme d'application ABAP Gestion des variantes Les variantes facilitent le traitement dans SAP, étant donné que les Jobs à entrées prédéfinies peuvent être exécutés. L'Automation Engine prend bien entendu en charge l'utilisation des variantes et offre de nombreuses fonctions à cette fin. Celles-ci permettent par exemple la lecture, la copie ou la modification des variantes. Il est également possible de supprimer et d'énumérer. La vérification et la définition de variantes immédiatement avant l'exécution d'un programme ABAP est d'une très grande importance, étant donné que cela permet d'éliminer des sources d'erreur.

18 12 Chapter 2 SAP NetWeaver JCL pour SAP Eléments de script R3_ACTIVATE_REPORT R3_COPY_VARIANT R3_CREATE_VARIANT R3_DELETE_VARIANT R3_GET_VARIANT_ CONTENTS R3_GET_VARIANTS R3_MODIFY_VARIANT Description Peut exécuter un rapport après spécification d'une variante. Copie la variante d'un rapport. Crée une nouvelle variante. Supprime la variante d'un rapport. Affiche le contenu d'une variante. Affiche toutes les variantes disponibles dans le protocole d'activation. Modifie une entrée dans une variante. Gestion de BDC Batch input est une technique classique de reprise en masse des données à partir de systèmes externes vers le système SAP. Les dossiers batch input utilisés à cet effet contiennent une ou plusieurs exécutions de transaction, y compris des données de transaction. L'Automation Engine peut lire les dossiers, mais aussi les exécuter et les surveiller jusqu'à leur fin. Outre l'exécution de dossiers, l'automation Engine permet également l'exécution directe de transactions dont les données sont définies dans le Job (Call Transaction). JCL pour SAP Eléments de script R3_ACTIVATE_ SESSIONS R3_CALL_ TRANSACTION R3_GET_ SESSIONS Description Exécution des sessions batch input. Exécute une transaction SAP. Sélectionne des dossiers batch input et affiche le résultat dans le rapport d'activation ou dans un fichier.

19 Automation Engine 13 R3_SET_ BDCDATA Définit les données BDC. Gestion de Spool Dans l'automation Engine, le traitement des Tâches peut être contrôlé par des Jobs. Les paramètres de l'objet Job et divers scripts vous aident à y parvenir. Vous pouvez entrer des destinataires de la liste spool dans l'onglet SAP des Jobs SAP. Toutes les requêtes spool que le Job crée sont envoyées aux destinataires entrés ici. JCL pour SAP De nombreux scripts possèdent des paramètres à l'aide desquels il est possible d'influencer la sortie du Job. En outre, les fonctions suivantes, qui traitent précisément les requêtes spool, sont à votre disposition. Elément de script R3_CREATE_OUTPUT_ REQUEST R3_GET_JOB_SPOOL Description Crée un nouvel ordre d'édition pour une requête spool existante. Lit la liste spool d'un step de type "programme ABAP". Vous pouvez spécifier des paramètres de filtrage. R3_GET_SPOOL_REQUESTS R3_SEND_SPOOL_REQUEST Sélectionne des requêtes spool avec des Filtres prédéfinis. Envoie une requête spool existante.

20 14 Chapter 2 SAP NetWeaver Gestion d'evènements La gestion de processus doit être exécutée à partir d'evènements pour des applications modernes. Un contrôle purement chronologique des déroulements ne suffit pas pour prendre en compte la complexité des environnements d'applications et de systèmes, avec leurs processus imbriqués et leurs dépendances. Avec Event, l'automation Engine met à votre disposition une solution complète pour une gestion de processus orientée Evènements. Le traitement peut se faire en fonction d'un grand nombre de statuts et d'evènements du système. Event met à disposition cette fonctionnalité pour un grand nombre de plateformes de système d'exploitation et d'application. La définition et le traitement d'evènements se font de manière centrale et pour l'utilisateur, quelle que soit la plateforme. Le traitement d'arrière-plan SAP possède également un contrôle d'evènements. Les Evènements permettent de déclencher des processus d'arrière-plan SAP. En ce qui concerne la flexibilité et l'étendue des fonctions, les Evènements SAP sont loin des possibilités d'une mise en œuvre de l'automation Engine. Dans certains cas, il est cependant nécessaire de prendre en compte les Evènements SAP dans l'automation Engine. L'Automation Engine étend ainsi sa fonctionnalité à la prise en charge des Evènements SAP. Evènement SAP Un Evènement SAP est un indicateur qui est défini à l'aide de la transaction SM62. Un Evènement défini peut être déclenché (manuellement, à partir d'un Job du système d'exploitation ou d'un programme ABAP) et l'exécution d'un processus d'arrière-plan peut démarrer. Il existe deux types d'evènements SAP : Evènements système Ils sont définis par SAP et sont déclenchés automatiquement lorsque des Evènements système se produisent, comme l'activation d'un nouveau mode d'exploitation. Les Evènements système ne peuvent être modifiés. Evènements utilisateur Ils sont définis par l'utilisateur. Ces Evènements doivent être déclenchés par un ABAP ou un programme externe. Par exemple, un programme externe peut signaler au traitement d'arrière-plan SAP que des données externes sont prêtes à l'importation dans le système SAP.

21 Automation Engine 15 Prise en charge par l'automation Engine L'Automation Engine prend en charge les Evènements SAP et les intègre dans sa gestion de processus centrale. Cette fonctionnalité peut être nécessaire lorsque le contrôle d'arrière-plan de SAP travaille déjà avec un grand nombre d'evènements définis et qu'un changement à une mise en œuvre de l'automation Engine avec des Workflows et Event paraît trop compliqué. Dans la plupart des cas d'application, il est cependant utile de remplacer les Evènements SAP par les mises en œuvre de l'automation Engine correspondantes. L'Automation Engine peut utiliser les Evènements SAP pour sa gestion de processus. L'exécution des objets peut être soumise à la réalisation d'un Evènement SAP. Certains traitements peuvent ainsi par exemple dépendre de la fin d'une importation. Les Evènements définis dans SAP peuvent être déclenchés par l'automation Engine. L'ensemble des fonctions variées de l'automation Engine est à votre disposition pour définir la condition et le moment de déclenchement d'un Evènement SAP. Des processus du système SAP sont démarrés sur la base d'un tel Evènement. Pour la surveillance des Evènements SAP, un objet Evènement de type "Console" peut également être utilisé. L'Agent surveille les Evènements SAP déclenchés et transmet les informations aux Evènements de consoles. En utilisant des Filtres, vous pouvez sélectionner les Evènements SAP dont le moment de déclenchement marque le coup d'envoi d'un traitement séquentiel ou d'une Alerte. JCL pour SAP Elément de script R3_GET_EVENT R3_RAISE_EVENT Description Attend un Evènement déclenché dans SAP. Déclenche un Evènement défini dans SAP. Rubriques connexes : Surveillance des Evènements SAP Gestionnaire de critères Le gestionnaire de critères SAP permet de définir les conditions de l'historique des Evènements, de la réorganisation de l'historique des Evènements et de l'interception de Job dans les profils. Vous pouvez accéder directement au gestionnaire de critères dans le Job SAP. Fonctionnalités : Création et suppression de profils Activation et désactivation de profils Ajout, modification et suppression de conditions Dans l'onglet Forme, cliquez sur le bouton pour ouvrir le gestionnaire de critères. Vous devez obligatoirement utiliser XBP 3.0 pour accéder au gestionnaire de critères SAP.

22 16 Chapter 2 SAP NetWeaver JCL pour SAP Elément de script R3_ACTIVATE_CM_ PROFILE R3_DEACTIVATE_ CM_PROFILE Description Active un profil dans le Gestionnaire de critères SAP. Désactive un profil dans le Gestionnaire de critères SAP. Reprise de Jobs SAP Avec l'objet Job de l'automation Engine, il est non seulement possible de définir de nouveaux Jobs SAP, mais il est également possible de reprendre dans l'automation Engine des Jobs existants. Cela présente l'avantage de ne pas devoir créer une deuxième fois les Jobs. Pour la reprise de Jobs, l'interface Utilisateur doit être connectée au système SAP. Ouvrez un objet Job et passez à l'onglet "Forme". Dans coin supérieur gauche se trouvent de nombreux boutons. Cliquez sur le symbole. Une fenêtre s'ouvre dans laquelle vous pouvez saisir des Filtres pour les Jobs SAP, comme le nom ou le numéro de Job.

23 Automation Engine 17 Cliquez ensuite sur "Chercher". Tous les Jobs SAP correspondant au Filtre que vous avez saisi s'affichent. Sélectionnez le Job que vous souhaitez reprendre dans l'automation Engine, puis cliquez sur OK. L'objet Job reprend les instructions que contient ce Job. Des paramètres, comme la variante ou le périphérique de sortie, sont renseignés automatiquement comme vous pouvez le voir dans l'illustration suivante.

24 18 Chapter 2 SAP NetWeaver La reprise ne veut pas dire que le Job est supprimé du système SAP. Seuls les paramètres du Job sont lus et copiés dans l'objet Job. Cette méthode de reprise de Job est très pratique pour de petites quantités de Jobs. Pour un grand nombre de Jobs, nous recommandons d'utiliser ApplicationInterface. Attention : une reprise de Jobs en masse doit être bien réfléchie et planifiée! Essayez tout d'abord d'avoir une vue d'ensemble. Dans la plupart des cas, les Jobs qui se sont développés au fil du temps peuvent être retravaillés et donc simplifiés. Il se peut même que vous souhaitiez adapter certaines parties du traitement ou les remplacer par d'autres. Rubriques connexes : Reprise des définitions de calendrier SAP Reprise des définitions de calendrier SAP SAP offre la possibilité de définir le calendrier d'entreprise à l'aide de la transaction SCAL. L'interface contient un programme ABAP avec lequel vous pouvez exporter ces Groupes Calendriers sous forme de fichier XML, puis les transférer dans votre système AE. Les règles particulières du Groupe Calendrier sont également prises en compte. Une fois l'interface importée (voir instructions d'installation pour l'agent SAP), le programme ABAP "/SBB/UC4_CALE_CREATE" peut être exécuté. Outre l'id de calendrier d'entreprise, entrez également les informations de votre système AE, comme le montre l'illustration suivante. Les deux cases à cocher situées en fin de formulaire vous permettent de déterminer si la définition de calendrier doit être créée sous forme de liste spool et/ou sous forme de fichier XML. Dans le

25 Automation Engine 19 dernier cas, un dialogue s'ouvre dans lequel vous pouvez sélectionner le dossier où enregistrer le fichier. Importez ensuite le fichier XML dans votre système AE. Le calendrier d'entreprise est désormais disponible comme objet Groupe Calendrier. Le processus de reprise du Calendrier peut bien entendu être automatisé à l'aide d'un élément de script. Rubriques connexes : Groupe Calendrier Importation et Exportation d'objets Reprise de Jobs SAP

26 20 Chapter 2 SAP NetWeaver Gestion des Jobs Exécution de Jobs dans la pile ABAP (CCMS) L'Automation Engine vous offre, avec ses fonctionnalités, de nombreuses possibilités pour l'exécution de votre traitement dans SAP. A la base se trouve l'objet Job à l'aide duquel vous définissez les instructions devant être exécutées dans le système SAP. L'onglet Forme représente une interface graphique qui entretient une liaison au système SAP. La définition des instructions de traitement est ainsi simple et rapide, car vous pouvez sélectionner directement des données comme les variantes. L'Automation Engine permet l'exécution de : Jobs, rapports, commandes externes ; programmes externes, Jobs interceptés, et bien d'autres. Dans la Fenêtre d'activités de l'interface Utilisateur, vous voyez le statut de la Tâche et vous pouvez la redémarrer ou l'interrompre selon vos besoins. Les processus enfants sont également représentés. Une fois la Tâche terminée dans l'automation Engine, vous pouvez afficher le rapport qui contient également les messages du système SAP. Mais l'objet Job n'est pas le seul à pouvoir exécuter des traitements dans le système SAP. Le type d'objet "RemoteTaskManager" possède la fonctionnalité permettant de surveiller des Jobs dans SAP, mais aussi de les démarrer. Vous pouvez l'utiliser pour des Jobs ou en particulier pour des Jobs interceptés.

27 Automation Engine 21 JCL pour SAP Elément de script R3_ACTIVATE_EXT_ COMMAND R3_ACTIVATE_EXT_ PROGRAM R3_ACTIVATE_ INTERCEPTED_JOBS R3_ACTIVATE_JOBS R3_ACTIVATE_REPORT R3_GET_JOBS R3_MODIFY_JOB R3_SCHEDULE_JOB_ CANCEL Description Exécute une commande externe. Exécute un programme externe. Exécute des Jobs interceptés sous le contrôle de l'automation Engine. Exécute des Jobs déjà planifiés dans SAP sous le contrôle de l'automation Engine. Exécute le rapport indiqué. Sélectionne des Jobs SAP et affiche le résultat dans le rapport d'activation ou dans un fichier. Modifie un step ABAP. Réattribue le statut "Planifié" à un Job SAP déjà lancé. Rubriques connexes : Processus enfant Jobs interceptés RemoteTaskManager

28 22 Chapter 2 SAP NetWeaver Processus fils Les Jobs SAP peuvent être composés d'un seul ou de plusieurs sous-jobs (par ex. : pour les chaînes de processus). L'Automation Engine peut représenter ce qu'on appelle les processus fils. Ils sont affichés dans la Fenêtre d'activités et possèdent des enregistrements statistiques propres ainsi que des rapports. Activez la fonctionnalité Parent-enfant dans la transaction SE38 au moyen du programme INITXBP2. Le type d'objet des processus fils s'appelle JOBD. Pour qu'une réplication des processus fils puisse avoir lieu dans le système AE, il faut définir le paramètre REPLICATE=YES pour le Script approprié. Attention : les processus fils peuvent, à leur tour, posséder des processus fils. Ces cas-là sont reconnaissables à la colonne "Parent" de la Fenêtre d'activités et dans les statistiques. L'illustration suivante montre l'exécution d'une chaîne de processus dans laquelle c'est le cas : Dans la fenêtre de détails, le point "Texte du Statut" contient le numéro d'instance du système SAP. La désactivation des processus fils est contrôlée à partir du processus parent. Les Jobs SAP possèdent un onglet spécial nommé "Post-Traitement Lié". L'exécution a lieu dès qu'un processus fils individuel se termine. Une analyse du résultat peut alors être effectuée immédiatement après la fin d'un processus fils. Pour chaque processus fils, un enregistrement statistique et un rapport sont créés. Affichez-les tous deux à partir des statistiques du processus parent.

29 Automation Engine 23 Le rapport est structuré comme celui du processus parent le plus élevé ; il ne contient cependant que les contenus de l'étape du processus en question. Les paramètres du rapport de Job sont également repris par le processus parent (base de données, fichier, uniquement en cas d'erreur). En outre, vous pouvez déterminer la taille du rapport avec les paramètres JOBLOG=, PROCESSLOG= et LONGTEXT= dans les éléments de script BW_ ACTIVATE_CHAIN et BW_RESTART_CHAIN. JCL pour SAP Elément de script BW_ACTIVATE_CHAIN BW_RESTART_CHAIN R3_ACTIVATE_ INTERCEPTED_JOBS R3_ACTIVATE_JOBS R3_ACTIVATE_REPORT Description Démarre une chaîne de processus. Continue une chaîne de processus interrompue. Exécute des Jobs interceptés sous le contrôle de l'automation Engine. Exécute des Jobs déjà planifiés dans SAP sous le contrôle de l'automation Engine. Exécute le rapport indiqué. Rubriques connexes : Onglet Post-Traitement Lié Jobs interceptés Dans SAP, il est possible de définir dans la table TBCICPT1 des critères de filtrage pour les Jobs. En font partie les indications d'un Client, d'un nom de Job et de l'utilisateur. Si un Utilisateur entré ici démarre un Job correspondant aux critères de filtrage, alors celui-ci est mis en statut "Planifié" quelles que soient les conditions de démarrage (par exemple "Immédiatement"). Activez la fonctionnalité Interception dans la transaction SE38 au moyen du programme INITXBP2.

30 24 Chapter 2 SAP NetWeaver Dans l'onglet Forme des Jobs SAP, vous pouvez accéder à la table via l'icône entrées (XBP 2.0) ou utiliser le gestionnaire de critères (XBP 3.0). et gérer ses Il est possible de modifier dynamiquement les entrées de la table avec le script R3_MODIFY_ INTERCEPTION. Il existe plusieurs méthodes pour exécuter les Jobs interceptés : 1. Le Gestionnaire de File d'attente permet de contrôler et de surveiller les Jobs interceptés. 2. Utilisez R3_ACTIVATE_INTERCEPTED_JOBS. 3. Utilisez R3_GET_INTERCEPTION pour lire la table. Le résultat est enregistré dans un fichier auquel vous pouvez accéder à l'aide de PREP_PROCESS_FILE. Si vous démarrez les Jobs interceptés individuellement, et si vous les entrez comme type de démarrage d'un Groupe, vous pouvez définir le nombre de Jobs s'exécutant en parallèle. JCL pour SAP Elément de script R3_ACTIVATE_ INTERCEPTED_JOBS R3_GET_ INTERCEPTION R3_MODIFY_ INTERCEPTION Description Exécute des Jobs interceptés sous le contrôle de l'automation Engine. Lit la table de filtre pour les Jobs interceptés et enregistre dans le protocole d'activation ou un fichier. Modifie la table de filtre pour les Jobs interceptés. Rubriques connexes : Onglet Forme Analyse du code retour d'application des steps SAP Un step SAP peut également contenir un code retour d'application. Vous pouvez y accéder des façons suivantes : Avec un élément de script R3_GET_APPLICATION_RC peut vérifier le code retour d'application d'un ou plusieurs steps de Job et, le cas échéant, interrompre le Job. Avec le rapport de Liste de steps Ce type de rapport spécifique contient des informations sur les steps et également le code retour d'application. Lisez la valeur à l'aide d'un élément de script XML. Exemple : :SET &xmlreport# = XML_OPEN(REPORT,,SSTP)! Lire le premier élément :SET &job# = XML_GET_FIRST_CHILD(&rapport xml#) :SET &nom# = XML_GET_NODE_NAME(&job#)

31 Automation Engine 25 :PRINT "Premier élément : &nom#"! Lire le deuxième élément :SET &enfant# = XML_GET_FIRST_CHILD(&step#)! Lire les processus enfant du step :WHILE &enfant# <> "" :SET &nom# = XML_GET_NODE_NAME(&enfant#)! Lire le code retour d'application :IF &nom# = "RC" : SET &applrc# = XML_GET_NODE_TEXT(&enfant#) : PRINT "Code retour d'application : &applrc#" :ENDIF :SET &enfant# = XML_GET_NEXTSIBLING(&child#) :ENDWHILE :XML_CLOSE Avec le rapport de Job Les informations sur les steps de Job SAP sont journalisées dans le rapport de Job. Le code retour d'application est également spécifié dans le rapport de Job, si vous utilisez l'interface. Si un step ne possède pas de code retour d'application, "Appl-RC n/a" est spécifié dans le rapport de Job. La fonction de script PREP_PROCESS_REPORT vous permet de lire les codes retour d'application et de les traiter. Dans l'exemple suivant, un ABAP nommé ZZ_TEST_APPL_RC est exécuté une fois dans le Job. Son code retour d'application doit être lu.! Sélectionner la ligne contenant l'abap et le code retour d'application :SET &HND# = PREP_PROCESS_REPORT(,,REP,"*ZZ_TEST_APPL_RC*Appl-RC*") :PROCESS &HND# : SET &LIGNE# = GET_PROCESS_LINE(&HND#)! Trouver l'emplacement dans la ligne où commence "Appl-RC" : SET &POS_STR# = STR_FIND(&LIGNE#,"Appl-RC")! Le code retour d'application se trouve 8 caractères après : SET &POS_ARC# = ADD(&POS_STR#,8)! Lire le code retour d'application : SET &ARC# = STR_CUT(&LIGNE#,&POS_ARC#)! Vérifier si le step fournit vraiment un code retour d'application : IF &ARC# <> "n/a"! Comme la valeur lue est une séquence de caractères, elle doit être convertie en un nombre : SET &ARC#= CINT(&ARC#)! A partir d'ici se trouvent des instructions de script quelconques qui traitent le code retour d'application : PRINT &ARC# : ENDIF :ENDPROCESS Attention : le code retour d'application n'est pas disponible dans l'interface XBP.

32 26 Chapter 2 SAP NetWeaver JAVA Agent Java EE/JMX pour SAP NetWeaver Java Management Extensions (JMS) est une technologie qui configure des instruments pour contrôler et surveiller des applications, appareils et réseaux. Automation Engine offre la possibilité d'intégrer des applications Java dans des processus métiers à l'aide d'un Agent pour JMX. La connexion est établie via un Serveur MBean grâce auquel vous pouvez accéder aux MBeans à l'aide de fonctions. SAP NetWeaver comprend, par exemple, plus de 1600 MBeans dans sa version standard. Ceux-ci peuvent être contrôlés directement. Du côté JAVA, il n'est pas nécessaire de procéder à une prédéfinition de Jobs exclusifs. Un planificateur n'est pas non plus nécessaire au sein de JAVA, étant donné que cela est pris en charge par l'automation Engine. En raison du standard, cette fonctionnalité peut s'exécuter sur des sources Java d'autres éditeurs. Les serveurs d'applications qui sont pris en charge sont énumérés dans la check-list des prérequis. Des éléments de script sont disponibles dans l'automation Engine pour, par exemple, enregistrer, énumérer et supprimer les MBeans. Il est également possible d'exécuter des MBeans ainsi que de lire et définir des attributs et des informations. L'onglet Forme de l'objet Job offre une interface graphique dans laquelle il est aisé de sélectionner ces fonctionnalités. Rubriques connexes : Onglet Forme (JMX) Généralités sur JMX-JCL JMX dans SAP NetWeaver L'utilisation de MBeans dans SAP NetWeaver est possible via l'agent JMX AE. Surveillance du moteur J2EE A l'aide de JMX, il est possible de consulter le statut du moteur J2EE. Ces informations sont également affichées dans le Visual Administrator, sous Server -> Services -> Monitoring.

33 Automation Engine 27 Toutes les fonctions du Visual Administrator sont à votre disposition dans MBeans et peuvent donc également être utilisées par l'automation Engine. Il existe cependant une restriction : L'Automation Engine ne peut utiliser aucune opération ou attribut JMX qui utilise des classes spécifiques à SAP (par exemple com.sapmarkets.bam.application.user) ou des structures de données complexes (listes, cartes, séries, etc.). Le navigateur MBean de l'automation Engine dans le Job JMX affiche 300 entrées MBean au maximum. Le filtre de recherche (clic droit sur l'arborescence -> Appliquer le filtre...) permet de rechercher précisément certains MBeans. Exemple : vous voulez consulter le nombre de tentatives de connexion échouées. Dans la première illustration, cette valeur se trouve sous le nœud Security -> Aggregated Data. Il est ainsi possible de filtrer sur "*Security/Aggregated Data/UnsuccessfulLogonAttemptsCount*" dans le navigateur MBean. Dans notre environnement, cela renvoie exactement un MBean comme résultat. Ici, vous pouvez sélectionner un des attributs "Value", "MaxValue" ou "MinValue". Il est possible de planifier, dans un Job, une consultation périodique du nombre d'identifications échouées. Démarrage et arrêt d'un service Le Visual Administrator configure également les services, les démarre et les arrête. Etant donné que des MBeans JMX sont également utilisés ici, cette fonctionnalité peut être exécutée à l'aide de l'agent. Ces services sont énumérés dans le Visual Administrator, sous Server -> Services :

34 28 Chapter 2 SAP NetWeaver Exemple : le service Telnet doit être démarré ou arrêté. Pour afficher tous les services dans le navigateur MBean, il est possible de filtrer en fonction de "*SAP_J2EEServicePerNode*". Les MBeans renvoyés correspondent aux services. Tous les services ont une méthode "start" et "stop". Sélectionnez l'entrée "telnet" dans l'arborescence. Dans le détail, il est possible de sélectionner ensuite la méthode "stop". Après avoir cliqué sur OK, un Job qui arrête le service Telnet est créé :

35 La modification est immédiatement visible dans le Visual Administrator : Automation Engine 29

36 30 Chapter 2 SAP NetWeaver Exécution de Jobs dans la pile Java (JXBP) L'Automation Engine vous offre les possibilités suivantes pour gérer des Jobs dans le planificateur Java de SAP : Démarrer les Jobs avec les paramètres Interrompre les Jobs Reprendre le protocole dans le rapport de Job. Surveiller les Jobs par filtre à l'aide du RemoteTaskManager La définition du Job Java doit d'abord être déployée dans le planificateur Java. Elle est ainsi visible par l'agent SAP. Ce n'est qu'après que vous pouvez créer une instance à partir d'une définition de Job existante à l'aide d'un objet Job. Un objet Job SAP appartient toujours à une seule définition de Job Java. Créez un objet Job SAP pour les Jobs du planificateur Java et sélectionnez l'agent SAP ainsi qu'un objet Login. Vous pouvez sélectionner dans l'onglet Forme la définition de Job qui doit être exécutée. La partie inférieure de l'onglet affiche automatiquement les paramètres correspondants. L'onglet "Protocole du Job" contient les options suivantes : Supprimer après x jours - Le protocole du Job est supprimé après x jours dans le planificateur Java. Ne pas supprimer - Le protocole du Job n'est pas supprimé dans le planificateur Java. Utiliser les paramètres par défaut - Le paramètre de la définition du Job permet de définir le délai de suppression du protocole du Job dans le planificateur Java. Le protocole du Job est toujours supprimé avec l'instance du Job. Rapport pour les statistiques du Job Java Un objet Job SAP exécuté peut, entre autre, comporter un rapport (SJJI) contenant des informations relatives au Job Java. Dans l'objet Job, dans l'onglet SAP, cochez la case correspondante dans la zone "Rapports optionnels". Installation Création du planificateur externe dans SAP : 1. Connectez-vous à l'administrateur SAP Netweaver par le biais de l'interface web. 2. Sélectionnez l'onglet "Job". 3. Cliquez sur le lien "Planificateur Java" -> "Planificateur externe". 4. Ajoutez une nouvelle entrée dans la liste du planificateur Java externe enregistré à l'aide du bouton "Ajouter". 5. Renseignez les champs. Indiquez un nom et la description "Operations Manager". 6. Cliquez ensuite sur "Ajouter". Création d'un objet Connexion dans l'automation Engine : 1. Connectez-vous au Client système Créez un nouvel objet Connexion pour SAP. 3. Ouvrez l'objet Connexion et sélectionnez le type de connexion "Internet" dans l'onglet Attributs.

37 Automation Engine Allez dans l'onglet Internet et indiquez les données de connexion au planificateur Java SAP. Indiquez quel Utilisateur vous avez également utilisé lorsque vous avez ajouté l'automation Engine comme planificateur externe. 5. Enregistrez l'objet Connexion et fermez-le. 6. Allez dans le dossier "HOST" et ouvrez l'objet de l'agent SAP. 7. Sélectionnez l'objet Connexion dans l'onglet Agent dans le champ "Java Basis". 8. Sauvegardez l'objet Agent et fermez-le. 9. Si l'agent SAP est en cours d'exécution, vous devez le redémarrer. Cas exceptionnels Dans un environnement comportant plusieurs nœuds, les Jobs du planificateur Java sont exécutés sur le nœud sur lequel le service de planification est actif. Lorsqu'un nœud est désactivé ou défaillant, le traitement du Job se poursuit sur un autre nœud. Si l'agent perd la connexion au planificateur Java pendant l'exécution du Job, il tente périodiquement de restaurer la connexion. Le Job reste actif dans le système AE et a le statut "Attente d'un Système distant". Si l'appel du planificateur Java génère une erreur, le Job est alors interrompu. Dans ce cas, il n'existe pas de rapport sur les statistiques du Job Java. L'erreur est journalisée dans le rapport "Log d'agent" de l'objet Log et dans le fichier log de l'agent SAP. Le Job est interrompu avec le code retour 403. Une reprise est impossible. Dans la mesure où il n'y a aucun JCL AE, le Job complet est toujours relancé dans le planificateur Java. Codes retour Statut SAP COMPLETED HOLD RUNNING SCHEDULED STARTING UNKNOWN ERROR 501 CANCELLED 502 Code retour du Job dans l'automation Engine Gestion du cycle de vie Surveillance de SAP NetWeaver Surveillance des moniteurs SAP offre une série de moniteurs avec lesquels vous pouvez surveiller l'environnement SAP ainsi que les composants qui en font partie. La fonction R3_GET_MONITOR lit ses informations et les prépare en vue du traitement.

38 32 Chapter 2 SAP NetWeaver Dans l'exemple suivant, le moniteur "All Monitoring Contexts" est lu et enregistré dans un fichier texte : R3_GET_MONITOR MONITOR_SET="SAP CCMS Technical Expert Monitors", MONITOR="All Monitoring Contexts", FILE="C:\AE_und_ SAP\AllMonitoringContexts.txt" La fonction script PREP_PROCESS est très utile si vous ne souhaitez filtrer que certaines parties des informations du moniteur. Elle fournit, sur la base d'un Filtre, une séquence de données qui peut ensuite être traitée. L'Agent SAP prépare les informations du moniteur sous forme de colonnes. Dans l'exemple suivant, les lignes contenant "Enqueue" sont filtrées et quatre colonnes passent dans le traitement ultérieur : :SET &HND# = PREP_PROCESS("SAP01","R3MONITOR","*Enqueue*","MONSET=SAP CCMS Technical Expert Monitors","MONNAM=All Monitoring Contexts","COL=FILE","UC_LOGIN=LOGIN.SAP") :PROCESS &HND# : SET &Contexte# = GET_PROCESS_LINE(&HND#, CONTEXT) : SET &Nom# = GET_PROCESS_LINE(&HND#, NAME) : SET &Valeur# = GET_PROCESS_LINE(&HND#, VALUE) : SET &Statut# = GET_PROCESS_LINE(&HND#, STATUS) : PRINT "&Contexte# --- &Nom" : PRINT "Valeur : &Valeur#" : PRINT "Status: &Statut#" : PRINT "" :ENDPROCESS En arrière-plan, l'exemple exécute également la fonction R3_GET_MONITOR. Vous trouverez des informations plus précises dans la description de la fonction script PREP_PROCESS. L'objet RemoteTaskManager autorise également une surveillance dans le système SAP. Il affiche, à partir des critères de filtrage définis, les Jobs ayant été déclenchés par SAP. JCL pour SAP Elément de script R3_GET_MONITOR Description Lit des données d'un moniteur SAP. Surveillance des Evènements SAP Les Evènements ont une très grande importance dans le traitement en arrière-plan dans SAP. L'objet Evènement du type "console" peut être utilisé pour surveiller les Evènements SAP. L'Agent interroge périodiquement le système SAP au sujet des Evènements SAP survenus et les signale aux Evènements de console actifs. L'administrateur peut régler l'intervalle dans la Variable UC_HOSTCHAR_DEFAULT avec la clé JOB_CHECKINTERVAL. Un Filtre vous permet de définir les Evènements SAP que vous souhaitez suivre. Si l'agent annonce un Evènement SAP, les instructions de l'onglet "!Script" sont exécutées. Vous pouvez ainsi introduire d'autres étapes dans le traitement. Dans!Script, utilisez la fonction GET_EVENT_INFO. Elle vous fournit des détails sur l'evènement SAP qui s'est produit.

39 Automation Engine 33 Dans la table figurant dans la partie inférieure de l'onglet, il est possible d'entrer plusieurs lignes de filtrage. Si l'agent annonce un Evènement SAP correspondant à au moins une ligne de filtre, le!script est exécuté. S'il correspond à plusieurs filtres, le!script n'en est pas pour autant traité plusieurs fois. Des filtres se recoupant peuvent également se produire si vous utilisez plusieurs Evènements de console. En l'occurrence, l'agent annonce l'evènement SAP à tous les Evènements de console. Outre l'evènement de console, l'automation Engine met également à votre disposition des fonctions avec lesquelles vous pouvez traiter des Evènements SAP à partir des objets Job. R3_ GET_EVENT attend qu'un Evènement se déclenche dans SAP et avec R3_RAISE_EVENT, vous déclenchez vous-même un Evènement défini dans SAP. Déroulement 1. Créez un objet Evènement du type "console". 2. Ouvrez-le et passez à l'onglet "Console". Il est possible d'y spécifier l'agent qui est lié au système SAP et les critères de filtre pour les Evènements SAP. 3. Dans l'onglet "!Script", vous entrez les instructions de Script devant être exécutées dès qu'un Evènement SAP correspondant aux critères de filtre est annoncé. La fonction script GET_EVENT_INFO peut vous fournir des détails sur l'evènement SAP. 4. Renseignez selon les besoins les autres onglets de l'evènement de console et enregistrez l'objet. 5. L'Evènement de console peut désormais être activé pour relier les Evènements SAP dans votre traitement. Conseils La condition requise pour la surveillance d'evènements SAP par le type d'evènement "Console" est XBP 3.0. L'utilisation de l'interface XBP 3.0 doit être définie par l'administrateur dans le fichier

40 34 Chapter 2 SAP NetWeaver INI de l'agent SAP. Si l'agent perd la connexion au système SAP, un certain nombre d'evènements SAP s'accumulent et l'agent n'est pas capable de les transmettre aux Evènements de console. Une fois la connexion rétablie, il vérifie cette situation et annonce également ces Evènements SAP aux Evènements de console concernés. En raison de l'éventuelle grande quantité de données, il ne lit pas tous les Evènements SAP en une seule fois. L'administrateur peut configurer en conséquence le comportement à l'aide du paramètre maxeventtimespan= du fichier INI de l'agent. Si l'agent est terminé, il ne peut surveiller aucun Evènement SAP pendant l'arrêt. Après redémarrage, l'agent détermine le moment auquel il a surveillé pour la dernière fois les Evènements SAP et annonce également les Evènements SAP qui se sont produits durant l'arrêt. Tous les Agents reliés au système SAP demandent les Evènements SAP. Autrement dit, chaque Agent annonce tous les Evènements SAP survenus à tous les Evènements de console. Si l'heure du système SAP retarde par rapport à l'heure du système AE, les premiers Evènements SAP ne peuvent pas être recueillis, s'ils tombent dans l'intervalle de temps situé entre les différences d'heure. Rubriques connexes : Gestion d'evènements Exemple - Réaction à des Evènements externes Intégration de l'automation Engine à SAP Solution Manager SAP Solution Manager est fourni avec tous les systèmes SAP à partir de Web Application Server (WAS) Il doit devenir le logiciel central de surveillance pour les systèmes SAP, mais aussi pour les applications externes. Cela conduit à une centralisation de tous les services dans le cadre d'un environnement SAP. L'Agent SAP permet à l'automation Engine d'intégrer l'ensemble des processus de gestion de l'entreprise dans SAP Solution Manager. Surveillance La surveillance centrale est un des éléments essentiels de SAP Solution Manager. La partie de surveillance se décompose, à son tour, en deux domaines essentiels : exploitation surveillance des processus métier Alors que pour le premier domaine, il s'agit principalement de déroulements et d'états techniques, le domaine de la surveillance des processus métier représente les processus métier logiques des systèmes SAP ainsi que leur surveillance.

41 Automation Engine 35 Surveillance de l'exploitation Dans le domaine Surveillance de l'exploitation, Solution Manager collabore avec l'infrastructure de surveillance existante dans CCMS (Computing Center Management Systems). Les statuts des systèmes et des processus sont représentés dans une arborescence. Jusqu'à présent, ces moniteurs se limitaient aux systèmes SAP. Désormais, SAP met à disposition des interfaces pour applications externes, pour annoncer leurs propres données de statut à Solution Manager et pour les afficher dans l'arborescence de surveillance. L'Agent SAP utilise une telle interface pour accéder à la structure du moniteur dans CCMS. Il utilise pour cela un objet Connexion pour ABAP Basis. A l'aide de scripts, vous pouvez créer et modifier des attributs et supprimer des nœuds : Elément de script R3_DELETE_NODE R3_SET_LOG_ATTR R3_SET_PERF_ ATTR R3_SET_STATUS_ ATTR R3_SET_TEXT_ ATTR Description Suppression d'un nœud. Définition d'un attribut log. Définition d'un attribut de performance. Définition d'un attribut de statut. Définition d'un attribut de texte. L'onglet Forme des Jobs SAP vous permet d'examiner les nœuds. Un navigateur séparé affiche le moniteur "All Monitoring Contexts" de l'ensemble de moniteurs "SAP CCMS Technical Expert Monitors". Les couleurs des nœuds correspondent au statut d'alerte actuel.

42 36 Chapter 2 SAP NetWeaver Surveillance des processus métier Chacun des processus et systèmes informatiques forment la base des processus métier. Avec SAP Solution Manager, ces contextes peuvent être définis et affichés. Toutes les données disponibles dans la surveillance de l'exploitation sont à disposition pour modéliser les processus métier. L'Automation Engine contrôle les processus centraux de tous les systèmes et applications de l'entreprise. Grâce à l'intégration de l'automation Engine à SAP Solution Manager, il est possible de représenter dans le système SAP les processus métier de l'entreprise et de les surveiller.

43 Automation Engine 37 Si une erreur se produit dans un processus métier, son origine peut être constatée immédiatement. Le temps nécessaire à la correction de l'erreur est ainsi réduit et le processus métier redémarre le plus vite possible. Contrôle des processus Solution Manager contient également la fonctionnalité pour le contrôle des processus d'arrière-plan. A l'heure actuelle, cette fonctionnalité est accessible via les transactions SM36 et SM37. Ces fonctions sont entièrement prises en charge par l'automation Engine. L'ensemble du traitement d'arrière-plan SAP peut être contrôlé et surveillé de manière centralisée avec l'automation Engine. En outre, l'automation Engine associe ces processus SAP aux processus de tous les autres systèmes et applications de l'entreprise. Rubriques connexes : Monitor SAP NetWeaver Inscription dans le système Landscape Directory Le système Landscape Directory (SLD) de SAP donne un aperçu des composants logiciels installés. Vous pouvez configurer l'agent SAP de sorte qu'il s'inscrive dans le SLD au démarrage. Les étapes suivantes sont nécessaires :

44 38 Chapter 2 SAP NetWeaver 1. Connectez-vous au Client système Créez un nouvel objet Connexion pour SAP. 3. Ouvrez l'objet Connexion et sélectionnez le type de connexion "Internet" dans l'onglet Attributs. 4. Allez dans l'onglet Internet et indiquez les données de connexion au SLD. 5. Enregistrez l'objet Connexion et fermez-le. 6. Allez dans le dossier "HOST" et ouvrez l'objet de l'agent SAP. 7. Sélectionnez l'objet Connexion dans le champ "Moniteur" de l'onglet Agent. 8. Sauvegardez l'objet Agent et fermez-le. L'Agent SAP essaie désormais de se connecter au SLD à chaque démarrage. Même si l'inscription échoue, par exemple à cause d'une erreur dans les paramètres de connexion, l'agent SAP n'interrompt pas le démarrage. Le fichier log de l'agent SAP contient un message indiquant si l'inscription à SLD a réussi Analyse du log système et du log application L'Automation Engine permet la lecture de logs SAP. En font partie les logs application mais aussi le log système. Les deux types de log fournissent des informations pour le traitement et les éventuelles situations d'erreur. Avec les fonctions mises à disposition par l'automation Engine, vous pouvez lire les entrées en utilisant des Filtres et les enregistrer dans le rapport ou dans les fichiers. Il est ensuite possible d'analyser le résultat avec PREP_PROCESS et PREP_PROCESS_FILE. Pour le log système, il existe une autre particularité. Les Jobs interrompus peuvent enregistrer les dernières lignes du log système dans un rapport spécial nommé SLOG. Cela vous facilite l'analyse des erreurs. L'objet Connexion de l'agent SAP permet de définir entre autres paramètres le nombre de lignes du log système prises en compte. JCL pour SAP Eléments de script R3_GET_ APPLICATIONLOG R3_GET_SYSTEMLOG Description Cherche les messages du log application et les génère dans le rapport ou le fichier. Lit les informations d'une période donnée d'un logging système SAP Commutation des modes de fonctionnement Avec les modes de fonctionnement de SAP, les ressources système disponibles sont utilisées de manière optimale. Il est possible de définir, en fonction de l'heure du jour, divers paramètres pour le traitement d'arrière-plan ou par dialogue. Ce type d'attribution des ressources ne nécessite aucun redémarrage du système R/3.

45 Automation Engine 39 L'Automation Engine prend, bien entendu, en charge cette fonctionnalité SAP. L'élément de script R3_SWITCH_OPMODE est à votre disposition pour commuter les modes de fonctionnement pour tous les serveurs d'applications SAP ou seulement pour certains. JCL pour SAP Eléments de script R3_SWITCH_OPMODE Description Change le mode de fonctionnement dans SAP.

46 40 Chapter 3 SAP Banking 3 SAP Banking 3.1 Gestion de processus pour SAP for Banking SAP développe, en collaboration avec d'importantes banques européennes, une solution dédiée à la gestion des comptes dans SAP for Banking. Les développeurs de l'automation Engine ont travaillé à l'intégration de cette nouvelle solution SAP dans la gestion de processus éprouvée de l'automation Engine. Il en résulte la création d'agent for SAP AM/BCA offrant des capacités complètes de gestion de processus pour les transactions bancaires. L'Automation Engine intègre cette nouvelle solution SAP dans sa gestion de processus centrale et assure les processus métier pour toute l'entreprise et sur toutes les plateformes. Déroulements dans SAP Banking Une des particularités de SAP Transaction Banking est que des déroulements entiers peuvent être enregistrés dans la personnalisation. La définition du déroulement correspond à un type de Workflow (sous forme tabulaire). Les déroulements sont en fait de soi-disant traitements de fin de journée (TEV). Le contrôle de ces déroulements doit prendre en compte les facteurs suivants : Réseau de processus Le réseau de processus est créé et surveillé à l'aide d'une fonction de menu d'une définition de déroulement dans la personnalisation. Il possède un ID unique devant être attribué pour chaque cycle. Le réseau de processus se compose d'une série de processus. Un processus est une fonction d'application qui est toujours traitée, d'un point de vue technique, en deux étapes : 1. La fonction d'application même 2. La partie de surveillance de cette fonction d'application. La partie de surveillance n'est cependant exécutée que si le processus a été initié via un réseau de processus. Il est désormais possible de traiter de façon synchrone et asynchrone l'ensemble de la fonction d'application, y compris la partie de surveillance. Traitement synchrone La fonction d'application, y compris la surveillance, est traitée de façon synchrone à partir d'un composant de fonction, c'est-à-dire que le composant de fonction se termine de façon synchrone avec la fonction d'application. Traitement asynchrone La fonction d'application ainsi que la surveillance sont démarrées en tant que Jobs d'arrière-plan, sachant que le Job de surveillance suit toujours le Job d'application. Processus avec parallélisation Pour certains processus (avec données de masse), une parallélisation du traitement (similaire à IS- U/IS-T) est prévue. Il n'existe, hélas, aucune fonctionnalité de base pour ce type d'exigence.

47 Automation Engine 41 Un processus avec parallélisation crée des Jobs d'arrière-plan parallèles, c'est-à-dire un Job d'arrière-plan parallèle ainsi qu'un Job de surveillance le suivant. Si le processus est démarré de façon asynchrone, un "Job père" est créé et il est suivi d'un Job de surveillance qui reste actif pour l'ensemble de la durée du processus. Les processus ont un code de retour d'application Les processus comportent un code retour d'application. Le statut technique normal (par ex. Job terminé) ne suffit pas à garantir un traitement réussi. En outre, un log d'application est généré par rapport à chacun des composants d'un processus (composant de fonction, ABAP, ABAP de surveillance, etc.). Démarrage de réseaux de processus et de processus Les réseaux de processus sont liés à des fonctions de dialogue et sont initiés par celles-ci. Selon le cas applicatif, les processus sont alors démarrés de façon synchrone ou asynchrone. (les grands cycles de façon asynchrone, bien entendu). Exigences sur l'automation Engine Un Workflow AE correspond à une définition du déroulement de la personnalisation. Les Tâches du Workflow représentent alors les processus. Le contrôle de Job de la base SAP n'offre pas des moyens appropriés pour le contrôle de processus dans AM/BCA. Pour le contrôle des processus individuels, il n'est pas possible de créer des Jobs d'arrière-plan standard, étant donné que la partie de surveillance de la fonction d'application n'a pas été démarrée et qu'ainsi aucun code retour d'application n'a pu être généré. Cela n'aurait pas été judicieux de modifier toutes les applications de façon à ce que cette fonction de surveillance se déroule de façon implicite. Cela aurait créé un trop grand nombre de programmes ; de plus, le code retour d'application aurait dû être communiqué via le log de Job. C'est pourquoi il est resté l'alternative de créer pour chaque Tâche à partir du Workflow AE un réseau de processus à ID distinct dans le système SAP. Ce réseau de processus ne contient jamais qu'un seul processus. Si le processus est démarré à l'aide du réseau de processus, cela conduit en fin de compte toujours à la création de deux Jobs batch asynchrones dans le système SAP, la fonction d'application et la fonction de surveillance. Pour l'automation Engine, des éléments de script contrôlant les processus ont été définis (BCA_ ACTIVATE_PROCESS). Pour permettre la surveillance (vérification de statut) par l'automation Engine, SAP a étendu l'interface avec une fonction correspondante. Description de fonction AE Démarrage et surveillance de processus Cette fonction encapsule un seul processus dans un réseau de processus, démarre le processus et le surveille. Avec la fin du processus, le réseau de processus est également terminé parce qu'il ne contient que ce processus. Exploitation des codes retour d'application Les processus individuels renvoient des codes retour d'application. Ceux-ci peuvent être analysés dans l'automation Engine. (par exemple dans Postscript). Exploitation des logs d'application

48 42 Chapter 3 SAP Banking Les processus d'un réseau de processus génèrent des logs d'application. Il n'existe cependant pas un rapport de 1:1 entre les processus ou les réseaux de processus et les logs d'application. C'est pourquoi l'exploitation des logs d'application est une procédure distincte dans l'automation Engine. Cette fonction met à une disposition une possibilité de sélectionner les logs d'application en fonction de certains critères (des numéros de log sont le résultat). Les messages et textes du log d'application correspondants peuvent ensuite être lus en fonction des numéros de log. Les textes sont générés dans un fichier texte ou dans un rapport. Intégration dans les réseaux de Job Les processus contrôlés par l'automation Engine dans SAP AM/BCA peuvent être intégrés aux Workflows d'entreprise. Les dépendances pour les traitements peuvent être mises en œuvre et surveillées facilement dans d'autres systèmes SAP, mais aussi dans d'autres systèmes. Statistiques complètes Pour tous les processus contrôlés avec l'automation Engine, des statistiques complètes sont à disposition pour des analyses et planifications ultérieures. Il en va bien entendu de même pour les processus de SAP for Banking. JCL pour SAP Elément de script BCA_ACTIVATE_ PROCESS Description Démarre et surveille un processus qui se déroule dans un réseau de processus distinct.

49 Automation Engine 43 4 SAP Financial Closing Cockpit 4.1 Intégration de l'automation Engine dans SAP Closing Cockpit SAP Financial Closing Cockpit permet de planifier différentes Tâches qui doivent être réalisées dans un ordre déterminé et à moment précis. Grâce à l'intégration de l'automation Engine dans cette fonctionnalité, il est possible d'activer des objets dans un système AE via des Tâches Closing Cockpit. Conditions Service Web Internal L'utilisation du service Web Internal est possible pour les serveurs d'application suivants : Sun Glassfish JBoss IBM WAS CE SAP Netweaver CE Pour l'installation, suivez la description de l'installation pour le serveur d'application souhaité. Veillez à utiliser la version actuelle du service Web Internal. Version SAP Pour SAP Basis, il convient d'utiliser une version de Support Package spécifique ou supérieure. Elle dépend de la version de SAP Release utilisée. Release Package Name 700 SABKB SABKB SABKB71007 Une condition supplémentaire est l'utilisation de SAP ERP version Fichiers fournis Les fichiers cryptés sont fournis dans le fichier SAP_CloCo.zip.ucc du répertoire IMAGE:FRAMEWORK\SAPCLOSINGCOCKPIT. Installation 1. Décryptage du fichier fourni Pour le décryptage du fichier SAP_CloCo.zip.ucc, utilisez le programme UCYBCRYP.EXE qui se trouve sur le CD Automation Engine, dans le dossier IMAGE:\TOOLS\ENCRYPT. Exécutez maintenant le programme via la ligne de commande avec les paramètres suivants : UCYBCRYP.EXE -d -f SAP_CloCo.zip.ucc -lfichier de licence

50 44 Chapter 4 SAP Financial Closing Cockpit Le fichier de licence vous est fourni par le Support (Numéro de Client.TXT). Vous obtenez le fichier compressé nommé SAP_CloCo.ZIP Décompressez le fichier SAP_CloCo.ZIP 2. Chargement des transports SAP Pour l'intégration, des programmes ABAP spécifiques qui doivent être chargés au moyen de l'importation dans le système SAP sont nécessaires. Vous trouverez pour cela 2 fichiers dans l'archive SAP_CloCo.ZIP KNNNNNN.SID - Fichier d'information RNNNNNN.SID - Fichier de données Copiez ces fichiers dans le répertoire de transport de SAO (par exemple, /usr/sap/trans/). Le fichier R doit être enregistré dans le sous-dossier "data" et le fichier K dans "cofiles". Connectez-vous au système SAP et importez l'ordre correspondant avec la transaction STMS. A la fin de l'importation, ouvrez et vérifiez le protocole de transport de l'ordre : toutes les étapes doivent posséder le code retour 0 (terminé avec succès) ou 4 (terminé avec avertissement). 3. Etablissement de la connexion RFC HTTP Exécutez la transaction SM59 et choisissez le point "Connexion HTTP au serveur externe". Etablissez ensuite une nouvelle connexion. Attribuez un nom à la destination RFC (par exemple, UC4_WEBSERVICE) avec une description. Onglet : Configurations techniques : Dans le champ "Machine cible", il faut entrer le nom d'hôte du serveur d'application sur lequel s'exécute le service Web Internal. Définissez le numéro de port avec le champ "N de service". Onglet : Connexion et sécurité : Sélection de l'option "Authentification par défaut". Il faut désormais indiquer les données pour l'accès au système AE : Pour cela, entrez dans le champ "Utilisateur" le client AE, le nom d'utilisateur et le service, séparés par une barre oblique. Une fois le mot de passe saisi, enregistrez la connexion RFC.

51 Automation Engine Définition du port logique Démarrage de la transaction Ipconfig Remplissez les champs comme suit : Classe de proxy : /UC4/CO_UC4PORT_TYPE Port logique : UC4 Définissez l'option "Port par défaut". Le bouton "Nouveau" permet de créer le port logique. Ensuite, d'autres paramètres s'affichent. Ils doivent être définis comme suit : Configurations générales : Onglet Exécution : Web Service Infrastructure Onglet "Paramètre d'appel" : HTTP Destination Nom de la destination RFC établie (voir "Etablissement de la connexion RFC HTTP") Suffixe du chemin : /uc4ws/uc4ws

52 46 Chapter 4 SAP Financial Closing Cockpit Configurations propres à l'application : Désactivez toutes les options dans l'onglet "Configurations globales". Enregistrez puis activez le port logique. 5. Enregistrement du rapport ABAP pour Closing Cockpit Exécutez la transaction SM30 et ouvrez le tableau SCMAPROGRAMS pour effectuer des modifications (bouton "Modifier"). Il faut ensuite ajouter une entrée avec les valeurs suivantes : Colonne Programme Application Valeur /UC4/CC_ REPORT CUSTOMER Enregistrez la nouvelle entrée. 6. Test de la connexion

53 Automation Engine 47 Pour tester la connexion d'abap au système AE, le programme AE/CC_REPORT doit être démarré au moyen de la transaction SE38. Rubriques connexes : Services Web AE Internal 4.2 Activation d'objets avec SAP Closing Cockpit L'intégration permet d'activer des objets exécutables via des Tâches dans SAP Financial Closing Cockpit. Vous trouverez l'installation à ce sujet au chapitre Installation de l'intégration de SAP Financial Closing Cockpit. Ce document explique plus précisément le fonctionnement et l'utilisation. Une fois le service Web Internal et l'intégration de Closing Cockpit installés, des objets exécutables peuvent être attribués aux modèles dans Closing Cockpit. Vous trouverez dans la description cidessous les étapes nécessaires et le comportement à adopter lors de l'exécution. Configuration Identifiez-vous dans le système SAP et exécutez la transaction CLOCOC. Ouvrez un modèle (Modifier) et sélectionnez ensuite à l'emplacement de votre choix de la structure organisationnelle la commande "Ajouter Tâche" via le menu contextuel. Définissez toutes les valeurs nécessaires dans le dialogue qui s'affiche. Pour l'option "Type de Tâche", sélectionnez "Programme" et entrez dans le champ associé /UC4/CC_REPORT. Il faut ensuite sélectionner ou recréer une variante associée. La variante enregistre le nom de l'objet à exécuter. Les champs restants sont facultatifs et sont transférés à l'objet activé en tant que valeurs supplémentaires via le tampon de lecture.

54 48 Chapter 4 SAP Financial Closing Cockpit Si l'assistant de saisie (F4) est appelé pour le champ "Nom d'un objet", tous les objets exécutables du Client qui a été indiqué dans Connexion RFC s'affichent. Le nom, le type, le titre et le chemin des objets s'affichent.

55 Automation Engine 49 Les champs supplémentaires dans le dialogue Variante servent à transférer les valeurs supplémentaires à l'objet activé. Vous trouverez dans la liste suivante les noms des Variables de Script qui sont mises à la disposition de l'objet dans le cache : Paramètre / champ Périmètre de résultat Période Année fiscale Nom de la Variable de Script AE KOKRS PERIO AFISCALE Les "Paramètres supplémentaires" permettent d'inscrire des valeurs autodéfinies dans le tampon de lecture. La colonne "Variable" permet de déterminer le nom de la Variable de tampon de lecture. Les valeurs de ces Variables de Script peuvent être lues dans le Script à l'aide de l'élément de script :READ. Exemple : :READ &KOKRS#,,'KOKRS', Enregistrez ensuite la variante et la Tâche. Créez un plan de Tâches à partir du modèle.

56 50 Chapter 4 SAP Financial Closing Cockpit Exécution La transaction CLOCO permet d'exécuter des plans de Tâches de Closing Cockpit. Ouvrez un plan de Tâches contenant des Tâches qui activent des objets. Planifiez ces Tâches et contrôlez leur statut. Si la Tâche a été exécutée et que le statut dans SAP affiche "Terminé", la Tâche s'est terminée dans le système AE avec le statut ENDED_OK. Tout autre statut entraîne l'affichage du message "Erreur" dans Closing Cockpit. Pour afficher le rapport du Job, ouvrez le Spool de la Tâche dans Closing Cockpit. Le Spool contient tous les types de rapport AE (ACT, REP, LOG,...) ainsi que les RunID de la Tâche exécutée. Dans la configuration de Closing Cockpit (CLOCOC), des dépendances peuvent aussi être définies pour les Tâches qui démarrent des programmes ou des transactions. Pour cela, il faut ouvrir un modèle ou un plan de Tâches et appeler la vue "Dépendances". Les Tâches peuvent être ajoutées dans la zone de dépendances par glisser-déposer. Cette fonction est aussi prise en charge pour les Tâches qui exécutent des objets. Les dépendances permettent de déterminer qu'une Tâche ne doit démarrer qu'après la fin d'une Tâche spécifique. Rubriques connexes : Intégration de l'automation Engine dans SAP Closing Cockpit

57 Automation Engine 51 5 SAP Solution Manager 5.1 Intégration de SAP Solution Manager L'Agent SAP permet d'accéder à un système AE grâce au SAP Solution Manager, d'y lire diverses informations et d'y gérer des processus. La configuration et les utilisations précises de cette connexion sont décrites ci-dessous. Certaines fonctionnalités ne peuvent être exécutées directement dans Solution Manager. Mais la configuration d'une liaison spéciale permet cependant d'ouvrir directement le Solution Manager via l'interface Utilisateur et d'accéder rapidement à ces fonctions. Les fonctionnalités concrètes et la configuration de cette connexion sont disponibles dans la description. Configuration et test Pour utiliser le SAP Solution Manager pour l'automation Engine, les paramètres de l'interface SMSE (Solution Manager Scheduling Enabler) doivent être configurés dans l'objet Connexion de l'agent. L'Agent SAP concerné doit ensuite être redémarré. Un Agent SAP propre est nécessaire pour l'intégration de SAP Solution Manager. Dans l'objet Connexion de l'agent SAP devant être utilisé pour l'intégration, configurez tout d'abord la connexion au système SAP (objet CONN : Généralités -> Paramètres de connexion). Ensuite, tous les champs de l'objet CONN dans la zone Interfaces -> SMSE doivent être renseignés : Cliquez sur Activer pour modifier les champs. Sous Utilisateur AE, vous devez saisir le Client, le nom, le département et le mot de passe d'un objet Utilisateur AE existant. Le Client AE peut également être indiqué dans le SAP Solution Manager. Dans ce cas, l'utilisateur indiqué dans l'objet Connexion doit aussi exister dans le Client. Sous Serveur RFC, vous devez définir la passerelle SAP et la connexion RFC. La destination RFC est créée automatiquement au démarrage de l'agent SAP. L'ID du programme et le nom de la connexion RFC peuvent ainsi être choisis librement.

58 52 Chapter 5 SAP Solution Manager Redémarrez l'agent et exécutez ensuite la transaction EXTSDL dans le système SAP. La connexion RFC qui a été définie dans l'objet Connexion devrait y être listée et définie comme valeur par défaut. Le bouton "Connection Test" vous permet alors de vérifier si la connexion à l'automation Engine a été établie avec succès. Fonctionnalité Après la configuration réussie, les fonctionnalités suivantes peuvent être exécutées via le SAP Solution Manager : Fonctionnalité Lire des Clients Interrompre des tâches Définir le statut des tâches Déterminer le dossier Etablir la liste du système SAP Demander la liste de la Queue Déterminer les types d'objets exécutables Description Liste de tous les Clients du système AE et descriptions. Commandes possibles : Interrompre, Stop, Stop (récursif), Go, Go (récursif). Demander le statut d'une certaine activité. Une liste est fournie avec l'id, le nom de dossier, le titre de dossier et le nom du dossier subordonné. Les noms des dossiers et des dossiers parents sont tronqués à partir de 80 caractères. La longueur maximale du titre est de 255 caractères. Les dossiers spéciaux comme la corbeille, le conteneur Transport, <Aucun dossier>, etc. ne sont pas affichés dans la liste. Nom et description de l'agent SAP de chaque Client. La description supplémentaire contient la version SAP de base et la version Automation Engine de l'agent. Nom de l'objet, titre et slots max. des Queues. Liste avec le type et la description des objets exécutables (par ex. : notification CALL, etc.)

59 Automation Engine 53 Déterminer les objets exécutables Déterminer le filtre de statut Demander la liste des activités Liste avec le nom et le type d'objet des objets exécutables. Il est possible de mentionner ici un certain dossier dont les objets doivent être listés. Il est également possible le nom ou le type d'objet comme filtre de recherche. Liste des groupements de statuts utilisés pour le filtrage d'activités (par ex. :ANY_OK, ANY_ABEND, etc.) Contenu de la Fenêtre d'activités de chaque Client. Il est possible d'indiquer un filtre de statut et un ordre de tri (croissant / décroissant) afin de limiter les résultats. Liste des rapports d'une tâche Lire le contenu d'un rapport Déterminer l'utilisateur d'une tâche Lire les paramètres Prompts d'une définition d'objet Lire les paramètres d'une tâche Créer / supprimer des évènements BAE dans l'automation Engine Les champs heure/date (par ex. heure de début) sont convertis et affichés dans UTC. On considère ici que le Fuseau horaire en vigueur dans l'automation Engine correspond au fuseau horaire local. Liste de tous les rapports / sorties d'une tâche. Cette liste contient le type de rapport (par ex. REP ou ACT) et le type de sortie ("L" = Joblog, "S" = Spool-Liste, "A" = ApplicationLog, "O" = Other). Déterminer le contenu d'un rapport d'une tâche. Déterminer le nom et le département de l'utilisateur qui a démarré la tâche. Lus à partir du détail des statistiques. Si le nom dépasse 40 caractères, il est alors tronqué. Les paramètres suivants peuvent alors être lus : -) Nom de l'objet PromptSet -) Variable de référence -) Type d'élément PromptSet ("N" = Nombre, "D" = Marque horaire, "S" = Tous les autres types) -) Valeur de l'élément PromptSet -) Propriété "Valeur nécessaire" ("X" = Option activée, " " = Option non activée ou inconnue) -) Assistant de saisie disponible ("X" = Oui, " " = Non ou inconnu) Lire le nom et la valeur des variables Objet et PromptSet d'une activité (Détail - Variables d'objet) Créer / supprimer des évènements BAE en tant qu'objet Sync Les objets Sync représentant des évènements BAE ont défini la valeur "SMSE" comme index d'archivage 1. Il est donc possible de rechercher / filtrer ces objets spéciaux. En outre, les objets Sync disposent seulement de deux statuts CLEARED (état initial) et RAISED.

60 54 Chapter 5 SAP Solution Manager Lire des évènements BAE à partir de l'automation Engine Déterminer le statut des évènements BAE à partir de l'automation Engine Interroger les instances d'un évènement BAE Lire des messages Lire le texte de messages Confirmer un message Planifier, modifier et démarrer des tâches Déterminer les objets Sync qui représentent les évènements BAE (type d'objet = SYNC, Index d'archivage 1 = SMSE) Il est alors possible de réaliser un filtrage sur le nom de l'objet. Statut actuel d'un objet Sync représentant un évènement BAE. Le Moniteur Sync est alors lu. De plus, le titre de l'objet est fourni comme description. Valeurs possibles: R (RAISED) ou C (CLEARED) Liste des tâches en attente d'un objet Sync représentant un évènement BAE. Est également lue à partir du Moniteur Sync. Lire le Moniteur d'objets Message actifs ou achevés Sont fournis : -) Objet -) Possibilités de réponse -) Texte du message -) Activateur (RunID) -) Heure de début -) Statut (en fonction du type de message. Alarme / Requête : "Q" = actif, "R" = achevé. Message : "N" = actif, "R" = achevé) -) Type de l'objet Déclencheur Déterminer le texte d'un message actif Paramètre de saisie : RunID du message Accepter ou refuser un message actif Paramètre de saisie : RunID du message Les actions suivantes sont possibles : -) Activer une tâche une fois ou périodiquement -) Reprise d'une tâche -) Reprise d'une tâche à partir du dernier point de reprise -) Modification de la planification. Lorsque l'activation est par exemple basculée de périodique à unique, la tâche est à nouveau planifiée (nouveau RunID). Ces fonctionnalités (hormis "Lire des Clients") se rapportent au Client AE mentionné dans l'objet Connexion pour l'interface SMSE. 5.2 SAP Solution Manager - Cas d'application Le document suivant décrit les cas d'application typiques de la SAP Solution Manager Integration. L'intégration avec SAP Solution Manager permet l'accès aux fonctionnalités. De plus, la planification des tâches est possible à partir du Job Scheduling Workcenter dans SAP Solution Manager.

61 Automation Engine 55 La planification peut s'effectuer soit directement, soit à partir de la documentation de Job SAP. L'Automation Engine peut ainsi être intégré dans SAP Change Management ou le Service Desk. Vous trouverez les informations sur la configuration et le test de l'intégration au chapitre SAP Solution Manager Integration. Pour les cas d'application suivants, le Job Scheduling Workcenter (Transaction : SOLMAN_ WORKCENTER) du SAP Solution Manager doit être démarré. Cas d'application 1: rechercher le Job via le Solution Manager 1. Dans le SAP Solution Manager Workcenter, à la rubrique Job Monitoring, sélectionnez l'élément "External Job Scheduler". 2. Il est ensuite possible de définir des critères de filtrage pour rechercher les jobs. Le Groupe Isolation correspond alors au client AE. 3. Un clic sur "Apply" vous permet d'afficher les Jobs trouvés dans la table. Cas d'application 2 : planification des tâches à partir d'une documentation de Job Pour planifier des objets dans l'automation Engine à partir de la documentation de Job SAP, veuillez procéder de la manière suivante : 1. Ouvrez une documentation de Job SAP et sélectionnez un système dans l'onglet "Systèmes". 2. Le bouton "Scheduling" vous permet d'accéder à l'interface de planification des tâches. 3. Définissez les paramètres requis tels que le client AE (champ : Separation Group), la connexion RFC, l'objet Queue, la priorité et le nom de l'objet à démarrer (champ : définition du Job).

62 56 Chapter 5 SAP Solution Manager Un Assistant de saisie est mis à disposition pour la sélection de l'objet à démarrer (définition du Job). Dans l'assistant de saisie, tous les objets exécutables du client AE précédemment indiqué sont listés. La liste peut être filtrée selon le dossier (ID of an application), le type d'objet (Definition Type) ou le nom de l'objet (Job Definition).

63 Automation Engine Le bouton "Schedule/Change Externally" vous permet de planifier ensuite la tâche dans l'automation Engine. Le RunID de la tâche activée s'affiche ensuite comme message de retour dans la zone supérieure. 5. Le bouton "External Notes" vous permet d'ajouter des commentaires concernant une exécution. 6. "External Logs" affiche les rapports AE de la tâche. Toutefois, les rapports externes ne sont pas disponibles! Cas d'application 3 : planification directe des tâches Après l'ouverture du Job Scheduling Workcenter, l'élément de menu "Schedule Jobs" permet de planifier directement des objets dans l'automation Engine. 1. Lors de la sélection du planificateur, l'élément "SMSE" doit être sélectionné pour l'automation Engine. 2. Sélectionnez ensuite la connexion RFC avec le client AE correspondant. Veuillez noter que le client AE s'affiche en tant que Groupe de séparation. Dans l'automation Engine, le Groupe de séparation doit donc toujours afficher un chiffre (p. ex. : 1010). L'élément RFC avec Separation Group GLOBAL peut être ignoré.

64 58 Chapter 5 SAP Solution Manager 3. Redéfinissez les paramètres requis pour l'objet à démarrer (connexion RFC, Separation Group, queue, priorité et nom de l'objet). Le nom de l'objet à démarrer doit être indiqué dans le champ "Job Definition" ; un Assistant de saisie est alors mis à disposition. De même que pour le cas d'application 2, la tâche est planifiée dans l'automation Engine via le bouton "Schedule/Change Externally". Des objets Calendrier temporaires sont générés dans l'automation Engine pour les conditions de démarrage. Définissez l'option "Schedule Stopped", la tâche planifiée reste dans l'automation Engine avec le statut d'attente "Attente de libération manuelle", jusqu'à ce qu'elle soit libérée manuellement. Vous avez également la possibilité de modifier ultérieurement les planifications déjà existantes. Après l'adaptation, cliquez sur le bouton "Reschedule" pour appliquer les modifications dans l'automation Engine.

65 5.3 Configurer une connexion avec l'interface Utilisateur Automation Engine 59 Certaines fonctionnalités, comme par exemple l'ouverture de Jobs, ne peuvent être directement effectuées dans SAP Solution Manager. Avec une configuration spéciale, il est cependant possible d'ouvrir l'interface Utilisateur via Solution Manager à l'emplacement correspondant et d'accéder ainsi rapidement à ces fonctionnalités. Il s'agit alors concrètement des fonctionnalités suivantes : Créer et modifier des objets Job Lister les objets Job existants Créer et modifier des Workflows Suivez les étapes suivantes pour configurer l'intégration de l'interface Utilisateur. La configuration générale de l'intégration de SAP Solution Manager est décrite dans le présent document. Fichiers fournis L'Interface Utilisateur est fournie sous forme d'application Web à intégrer à un serveur d'application Tomcat. Un serveur d'application Tomcat (version 7) est donc nécessaire pour l'installation. L'application Web est disponible dans le répertoire fourni suivant : IMAGE:\AGENTS\SAP\_ SOLMAN\ Nom du fichier UC4WEBSTART.WAR Description Interface Utilisateur pour le serveur d'application Déroulement 1. Configuration de l'application Web UI Hôte Copiez le fichier UC4WEBSTART.WAR dans le dossier "webapps" situé dans le répertoire de programme du serveur d'application Tomcat. Procédez ensuite à un redémarrage du serveur d'application. Le nouveau sous-dossier "UC4WEBSTART" est créé dans le répertoire "webapps". Ne supprimez pas le fichier WAR, sinon Tomcat fera de même avec le dossier "UC4WEBSTART". 2. Adaptation du fichier de configuration Hôte Cette étape décrit à quel système AE l'interface Utilisateur doit se connecter. Veuillez noter qu'une seule connexion peut être configurée pour l'interface Utilisateur! Ouvrez le fichier de configuration : <Répertoire Tomcat>/webapps/uc4webstart/WEB-INF/web.xml. Adaptez les paramètres suivants à votre environnement système : Nom du serveur : Nom ou adresse IP de l'ordinateur sur lequel est exécuté le système AE.

66 60 Chapter 5 SAP Solution Manager Nom du système : Nom du système AE Numéro de port : Numéro de port du CP avec lequel la connexion doit être établie. Exemple de partie pertinente et à adapter du fichier web.xml : <init-param> <param-name>nom du serveur</param-name> <param-value>saphost01</param-value> </init-param> <init-param> <param-name>nom du système</param-name> <param-value>uc4</param-value> </init-param> <init-param> <param-name>numéro de port</param-name> <param-value>2217</param-value> </init-param> 3. Configuration de l'agent Ordinateur de l'agent Ouvrez le fichier INI de l'agent SAP pour lequel l'intégration du SAP Solution Manager a été configuré. Saisissez l'url de l'application Web Interface Utilisateur comme valeur du paramètre WebStartURL= (section [SMSE]). Enregistrez le fichier INI, puis redémarrez l'agent. Exemple : [SMSE] webstarturl= 4. Affichage de l'interface Utilisateur Lorsqu'une des fonctionnalités mentionnées est affichée dans Solution Manager, l'url indiquée dans le fichier INI de l'agent est ouverte. Dans le navigateur Web, la page qui s'affiche contient le lien "Démarrer l'interface Utilisateur". Après avoir cliqué dessus, la boîte de dialogue de connexion à l'interface Utilisateur apparaît. Après la connexion réussie, la fonction sélectionnée est exécutée dans l'interface Utilisateur. Exemple : Lorsqu'un nouveau Job est créé via le SAP Solution Manager, l'interface Utilisateur est ouverte et la boîte de dialogue qui s'affiche nécessite de saisir un nom pour le nouvel objet Job.

67 Automation Engine 61 6 Solutions personnalisées 6.1 Archivage des données dans SAP L'archivage des données dans le système SAP sert à supprimer de la base de données les données de masse n'étant plus nécessaires dans le système, mais devant toutefois être conservées pour être exploitables. Vous pouvez, bien entendu, contrôler l'archivage des données de façon centrale avec l'automation Engine. Les données à archiver sont rassemblées au sein d'"objets d'archivage" (par ex. l'objet d'archivage SD_VBAK comporte toutes les données relatives aux documents de vente). Les cycles d'archivage sont intégrés au ADK (Archive Development Kit). L'ADK représente la base technique de la transaction d'archivage (SARA). Pour chaque objet d'archivage, il existe en règle générale un programme qui marque les données à archiver sur la base de durées de résidence réglables. Dans de nombreux cas, l'utilisation des indicateurs s'effectue en 2 étapes : un repère de suppression est défini après écoulement de la durée de résidence 1 (par ex. 6 mois), puis remplacé par un indicateur de suppression après écoulement de la durée de résidence 2. L'objet devient alors archivable. Le processus d'archivage se compose en fait de quatre étapes : 1. Cycle préparatoire (indicateur de suppression) : le cycle préparatoire marque les données à archiver. Le cycle préparatoire peut également être exécuté indépendamment du cycle d'archivage. 2. Création de fichiers d'archive : lors de l'archivage, les données à archiver sont tout d'abord écrites séquentiellement dans des fichiers d'archive nouvellement créés. 3. Début du programme de suppression : sur la base des fichiers d'archive créés, le programme de suppression supprime les données de la base de données. 4. Stockage des fichiers d'archive : les fichiers d'archive créés peuvent ensuite être stockés dans un système de stockage ou alors, par exemple, être enregistrés sur bande magnétique. Le stockage dans le système de stockage peut être enclenché automatiquement ou manuellement. Du point de vue de la transaction SARA, l'exécution d'un cycle d'archivage peut se faire manuellement ou semi-automatiquement (suppression et stockage). L'Automation Engine automatise les cycles d'archivage des données en principe pour toutes les versions de SAP. Pour une exécution de l'archivage des données hors transaction SARA, il faut toujours tenir compte des remarques suivantes en ce qui concerne SAP : Archivage des données avec un planificateur de Job externe Archivage des données hors transaction SARA Contrôle avec l'automation Engine Au niveau technique, les cycles d'archivage SAP, quel que soit l'objet d'archivage, sont toujours organisés selon les étapes suivantes : 1. Programme d'écriture (WRI) Le programme d'écriture comprend le cycle préparatoire et la création des fichiers d'archive. Il s'agit d'un programme normal, pouvant s'exécuter en Tâche d'arrière-plan, paramétré à

68 62 Chapter 6 Solutions personnalisées l'aide d'une seule variante. 2. Programme de suppression Le programme d'écriture crée automatiquement pour chaque fichier d'archive un Job de suppression (DEL), si cela a été défini ainsi dans la personnalisation de l'objet d'archivage concerné. Le Job DEL contient le programme de suppression. 3. Stockage des fichiers d'archive (STO) Le programme de suppression crée automatiquement un Job de stockage (STO). Le Job STO contient le programme de stockage. 4. Post-traitement éventuel (END) Les Jobs de post-traitement se produisent également automatiquement, mais ne sont cependant pas disponibles pour tous les objets d'archivage. Prérequis dans SAP 1. Programme de suppression automatique Dans la personnalisation de chaque objet d'archivage, il faut définir que le programme de suppression est démarré automatiquement. 2. Les Jobs DEL, STO et END ne peuvent pas être démarrés automatiquement dans SAP Pour contrôler les Jobs DEL, STO et END à l'aide de l'automation Engine, il faut éviter que ces derniers ne démarrent automatiquement dans le système SAP. Pour ce faire, on utilise la fonctionnalité "Job Interception" à partir de la version 4.6C. Il faut activer celle-ci avec le programme ABAP INITXBP2. La table de décision pour l'interception de Job doit contenir les noms de Job des Jobs DEL, STO et END des cycles d'archivage. Objets L'ensemble du déroulement est contrôlé à l'aide d'un Workflow. Le Workflow comporte 3 étapes : 1. Début et surveillance du programme d'écriture La fonction AE "Exécuter Programme ABAP" crée le Job WRI dans SAP et le surveille jusqu'à sa fin. 2. Début et surveillance du Job de suppression Les Jobs DEL créés par le Job WRI sont démarrés et surveillés à l'aide de la fonction AE "Sélectionner et démarrer les Jobs interceptés". 3. Début et surveillance des Jobs de stockage Les Jobs de stockage créés par le Job DEL sont également démarrés et surveillés à l'aide de la fonction AE "Sélectionner et démarrer les Jobs interceptés".

69 Automation Engine 63 Déroulement 1. Activation du Workflow L'Utilisateur peut également consulter le nom de l'objet d'archivage à l'aide d'un masque :READ. 2. Moniteur de Workflows Après sélection ou indication de l'objet d'archivage, le Workflow est automatiquement démarré et affiché sur le moniteur. Il ne s'arrête que lorsque toutes les étapes du traitement se sont bien terminées. 3. Surveillance et contrôle L'ensemble du déroulement peut être suivi au sein de l'automation Engine, mais également de SAP. Tous les protocoles pour l'analyse automatique sont disponibles dans l'automation Engine. Il est également possible de déterminer l'objet d'archivage utilisé pour le déroulement dans la fonction de gestion à partir du côté SAP (transaction SARA). Récapitulatif L'archivage des données SAP est facile à réaliser avec la fonctionnalité standard de l'automation Engine. Avec une mise en œuvre restreinte, une telle méthode offre une série d'avantages : Automatisation continue Le contrôle de l'archivage de données par Automation Engine permet l'automatisation continue de l'ensemble du système de gestion SAP. Nul besoin d'interventions manuelles. Les dépendances mutuelles aux autres processus sont faciles à mettre en œuvre. Economies L'archivage régulier des données permet d'assurer des dimensions de base de données optimales, améliore la performance tout en économisant de l'espace. Contrôlé centralement et exécuté automatiquement, cet avantage peut être obtenu sans frais supplémentaires, grâce à l'automation Engine. Exploitation optimale des ressources En raison de contrôles centraux et automatisés, les ressources disponibles peuvent être utilisées de manière optimale. Les conflits et les goulots d'étranglement sont ainsi évités. Un fonctionnement sans encombre de SAP est assuré. Haute fiabilité L'automatisation de tous les paramètres système réduit nettement le nombre de sources potentielles d'erreur. Décharge du personnel Les spécialistes SAP sont libérés des Tâches manuelles contraignantes. Ils peuvent ainsi concentrer leurs compétences sur les domaines les plus importants : l'amélioration des systèmes et des niveaux de service. Contrôle et surveillance centralisés Tous les processus du système SAP sont surveillés et contrôlés de manière centralisée.

70 64 Chapter 6 Solutions personnalisées Les problèmes potentiels sont reconnus immédiatement, la durée jusqu'à la correction d'erreurs est réduite au minimum absolu. 6.2 Traitements en masse IS-U est la solution sectorielle de SAP pour le secteur de l'approvisionnement. IS-U, en tant que système de facturation pour les sociétés d'approvisionnement et de prestation de services en particulier est personnalisé par rapport aux exigences des activités d'approvisionnement. Grâce à l'intégration d'is-u aux composants neutres de la norme R/3 et grâce à des interfaces vers des systèmes externes, SAP offre aux sociétés d'approvisionnement une solution globale, intégrée et d'entreprise pour le traitement des informations commerciales. Le volume des transactions des entreprises d'approvisionnement, avec leurs millions de Clients, différents types d'approvisionnement et éventuellement une facturation mensuelle, est traité, pour sa plus grande part, dans des tâches d'arrière-plan. En voici des exemples : Création de documents de lecture Contraintes de remise règlement/facturation Cycle de relance Cycle de paiement etc. Définition L'Automation Engine est capable d'automatiser ces exigences d'arrière-plan. Pour réussir le traitement de ces gros volumes de données avec un débit le plus optimal possible, un "traitement en masse" spécial a été développé pour le traitement d'arrière-plan. Les caractéristiques de ce traitement en masse sont les suivantes un nombre dynamique de Jobs fractionnés naît d'un Job maître Chaque cycle de traitement en masse nécessite un jeu de paramètres, identifié par la date et l'id de cycle Une des exigences particulières du traitement en masse est également le respect d'un certain ordre, par exemple "Règlement" doit se dérouler avec "Facturation", les deux étant un traitement en masse. Technique Le traitement en masse comprend un répartiteur qui génère avec l'aide de la définition des paramètres des Jobs fractionnés parallèles. Le répartiteur est lui-même défini dans le traitement d'arrière-plan comme "Job maître" lors de l'ordonnancement du traitement en masse. Si le Job maître est exécuté, il crée un certain nombre dynamique de Jobs fractionnés. Le nombre de Jobs fractionnés dépend des paramètres définis. Le contrôle se fait avec l'automation Engine. L'ordonnancement peut également être effectué dans l'automation Engine ou dans SAP.

71 Automation Engine Copie de Client dans SAP R/3 SAP R/3, tout comme Automation Engine, est une application orientée client. Chacun des Clients est une unité entièrement indépendante. Dans plusieurs cas, un échange de données régulier entre les Clients est nécessaire. L'Automation Engine permet d'automatiser ces processus. Le "Client" est le terme de classement le plus élevé pour les applications R/3. Les définitions au niveau des Clients sont valides dans toutes les structures de l'organisation de l'entreprise sous R/3. Le Client est une unité indépendante au niveau de la gestion des données, au niveau de la gestion de l'entreprise et au niveau de l'organisation. Dans la pratique, ce concept de Client peut, par exemple, être utilisé pour héberger dans un centre de calcul de nombreux Clients sur un système R/3 configurer sur un système R/3 plusieurs Clients avec diverses Tâches, par exemple : Client de livraison SAP (Client 000) Client de personnalisation (001) Client test Client d'assurance qualité Client de production Dans un tel environnement, il est souvent nécessaire de fournir à un Client d'assurance qualité ou à un Client test des données cohérentes. Vous obtiendrez au mieux ces données en copiant le Client de production. Pour un environnement de test réaliste, des copies de Client doivent être créées régulièrement. Copie de Client dans SAP R/3 La copie de Clients dans SAP R/3 comporte une série de problèmes. En particulier, des copies régulières pour fournir des données actuelles aux systèmes de test sont synonymes d'une certaine quantité de travail. SAP prend en charge la copie en ligne ou le transport des Clients. Etant donné qu'il s'agit ici de transactions, ces méthodes ne sont adaptées qu'à une exécution périodique (SAP version 4.0 à 4.6D). Le contrôle d'arrière-plan de SAP ne peut pas non plus exécuter régulièrement de telles transactions, car des variantes dynamiques sont utilisées. Exposé du problème Lors de la copie d'un Client, de grandes quantités de données sont déplacées. Un Client sans données d'application nécessite environ 500 Mo de mémoire dans la base de données. La copie peut donc durer plusieurs heures. Pendant ce temps, un ou plusieurs processus de dialogue sont occupés. Aucun Utilisateur ne doit travailler dans le Client source ou cible pendant le processus de copie. Les Utilisateurs d'autres Clients utilisent des ressources supplémentaires et rallongent le processus de copie. Avant la copie d'un Client, un cycle de test doit être exécuté. Cela permet de déterminer les tables qui doivent être modifiées. En outre, le système vérifie si la base de données dispose d'un espace mémoire suffisant. Avant la copie d'un Client, le Client cible est souvent supprimé. Tous les Groupes Utilisateurs sont alors également supprimés. Seul l'utilisateur SAP* peut encore s'identifier dans le Client cible.

72 66 Chapter 6 Solutions personnalisées Copie de Client dans R/3 avec l'automation Engine Des copies périodiques des Clients peuvent être effectuées plus facilement et de façon plus sécuritaire avec l'automation Engine. Les cycles de test et le processus de copie peuvent être exécutés automatiquement. L'exécution normale est ininterrompue. Le processus de copie est démarré en fonction des résultats du cycle de test et de la disponibilité des ressources. Si des erreurs se déclarent au cours du traitement, l'automation Engine informe immédiatement le personnel de garde responsable. Pour que l'automation Engine puisse créer des copies de Client, il faut que les prérequis suivants soient remplis dans le système SAP : Les Groupes Utilisateurs ne doivent pas être supprimés avant la copie. L'Automation Engine utilise un compte utilisateur normal pour l'identification à SAP étant donné qu'il ne peut s'identifier avec l'utilisateur SAP*. SAP offre la possibilité de ne pas supprimer le Client cible avant la copie. Il est également possible de supprimer les grandes tables à l'aide d'abap spéciaux (voir également SAP Service Marketplace, conseil numéro ). Le rapport RSCLXCOP doit être modifié, afin de pouvoir traiter les variantes du rapport. Un Job de copie de Client obtient les informations nécessaires d'une variante. Lors de l'exécution d'une copie de Client, celle-ci est remplacée par les données issues du Client source, ou alors elle est supprimée. Lors d'une exportation de Client, le numéro de la copie se trouvant dans la variante est entré pour de bon. Cela provoque des problèmes pour les ordonnancements périodiques. C'est pourquoi des variantes identiques (du même nom) doivent être créées dans le Client source et cible pour le rapport RSCLXCOP. La procédure exacte est détaillée dans le conseil numéro de SAP Service Marketplace. Une fois ces prérequis remplis, il est possible de créer dans l'automation Engine un Job pour l'exécution d'une copie de Client. Cela permet de représenter des dépendances au sein d'un Workflow. Le cycle de test ainsi que le processus de copie peuvent être exécutés automatiquement. L'Automation Engine s'assure que des ressources suffisantes soient disponibles. Des copies régulières des Clients peuvent ainsi être effectuées bien plus facilement et de façon bien plus sécuritaire. 6.4 Dialogue SAP pour l'automation Engine Dialogue SAP pour l'automation Engine est une interface pour les Utilisateurs de SAP R/3 à partir de laquelle vous pouvez déclencher des traitements dans le système AE. Les Tâches définissables dans SAP sont transmises au système AE avec CallAPI pour SAP. La transaction "/sbb/uc4dc" affiche l'interface de l'utilisateur final qui contient la vue des Tâches. Ainsi, seules les Tâches auxquelles il est autorisé à accéder sont proposées à l'utilisateur. Elles peuvent être divisées en classes et portent un nom évocateur. Pour en sélectionner une, il suffit de cliquer dans la liste. Ensuite, en fonction de la définition, l'interrogation des Variables ou des attributs, ou la maintenance d'une variante. Chaque activation de Tâche est enregistrée dans les statistiques. Activation avec saisie d'attributs définissables librement Les attributs sont définissables librement et sont transmis à l'automation Engine via :PUT_ READ_BUFFER. Connexion directe à la maintenance des variantes par défaut L'utilisation d'abap standard via l'automation Engine permet d'avoir une connexion directe à la maintenance des variantes. Seule la variante prédéfinie peut être maintenue.

73 Automation Engine 67 Création de Workflows Il est possible de créer un Workflow à l'aide des Variables. Vous pouvez ainsi, par exemple, sélectionner les composants devant être exécutés à partir d'un déroulement prédéfini. La communication vers le Workflow au sein de l'automation Engine se fait uniquement par la définition de Variables. Statistiques et suivi du statut L'Utilisateur dispose de statistiques permettant de comprendre toutes les activations. En outre, une Tâche peut, par exemple, être interrompue précisément ou un statut actuel peut être synchronisé. Le dialogue SAP pour l'automation Engine ne remplace pas l'interface Utilisateur à tous les niveaux. Il aide les Utilisateurs qui utilisent uniquement l'interface utilisateur SAP et qui souhaitent contrôler à l'aide de l'automation Engine ses Tâches d'arrière-plan (Jobs, Workflows) à partir de SAP. Le dialogue SAP pour l'automation Engine est une solution de consultant et ne fait pas partie du produit! Il ne bénéficie donc pas d'une maintenance! 6.5 Automated SystemCopy for SAP Cette solution AE vous permet d'exécuter une copie du système SAP de manière entièrement automatisée. Le procédé peut être adapté à votre convenance et vous pouvez déterminer exactement quelles étapes doivent être réalisées. Automated SystemCopy for SAP est une solution de consultant et ne reçoit donc aucune maintenance! La documentation relative à cette solution est disponible sous forme de document externe.

74 68 Chapter 7 Liaison technique 7 Liaison technique 7.1 Automation Engine et SAP La connexion entre l'automation Engine et SAP est établie via un Agent. Dans son fichier INI se trouve les données de connexion à un système AE déterminé. Les données de connexion à un système SAP sont consignées dans des objets Connexion. L'Agent a besoin d'au moins un objet Connexion dans lequel l'utilisateur CPIC est entré avec ses données de connexion. Un Job requiert la spécification d'un Agent et d'un objet Login. Dans les informations de connexion, vous définissez dans quel Client SAP le Job sera exécuté. Lors de la création d'un Job, l'onglet "Forme" est utile. Il offre une interface graphique dans laquelle les lignes de script peuvent être créées aisément. En outre, certaines données peuvent être fournies par le système SAP (par exemple : variantes disponibles). L'Agent SAP établit la connexion requise au système SAP. Les nom d'utilisateur, mot de passe et Client sont repris depuis l'objet Connexion pour "ABAP Basis" Rubriques connexes : Onglet Forme 7.2 Plusieurs systèmes SAP Cette description montre de quelle façon est réalisée la configuration lors de l'utilisation de plusieurs Agents SAP exécutés sur différents systèmes SAP. Agents SAP supplémentaires 1. Renseignez le fichier de définition du ServiceManager UC4.SMD. Entrez les autres Agents dans le fichier de définition du ServiceManager en fonction de l'exemple suivant. La chaîne *OWN est automatiquement remplacée par le chemin dans lequel le ServiceManager se trouve (ucybsmgr.exe).! Les lignes de commentaires commencent par un point d'exclamation!! Les sous-services sont maintenant définis!define Automation Engine;*OWN\UCServer.exe;*OWN DEFINE UC4 C11-Agent;*OWN\C11\UCXJR3X.exe -i*own\ucxjc11.ini;*own DEFINE UC4 XYZ-Agent;c:\uc4global\bin\XYZ\UCXJRX3.exe - ic:\uc4global\bin\xyz\ucxjxyz.ini;*own\xyz Ces entrées peuvent également être dupliquées et adaptées avec le dialogue du ServiceManager dans le fichier UC4.SMD. 2. Créer les fichiers *.INI.

75 Automation Engine 69 Créez, pour chaque nouvel Agent entré, un fichier UCXJ*.INI du nom convenu dans l'automation Engine.SMD. Idéalement, copiez le fichier d'un Agent existant (par exemple UCXJR3X.INI vers UCXJC11.INI). Renseignez ou vérifiez UCXJ*.INI dans les fichiers créés. 3. Renseigner SAPRFC.INI (uniquement lors de l'utilisation de SAPRFC.INI) Complétez plusieurs chapitres de SAPRFC.INI (anciennement SIDEINFO) comme ils sont indiqués dans les fichiers UCXJ*.INI, en fonction de l'exemple suivant : DEST=UC_C11 LU=R33 TP=sapdp00 GWHOST=R33 GWSERV=sapgw00 PROTOCOL=I DEST=UC_XYZ LU=R33 TP=sapdp01 GWHOST=R33 GWSERV=sapgw01 PROTOCOL=I 4. Terminer et démarrer le ServiceManager. Terminez le ServiceManager et redémarrez-le. Ensuite, les autres Agents devraient être disponibles. N'oubliez pas de créer l'utilisateur pour RFCLOGIN dans le système SAP correspondant! 7.3 Objets SAP Security Les autorisations requises pour les Jobs AE dépendent de l'installation et des fonctions utilisées dans l'automation Engine. Dans le présent document sont mentionnés tous les objets d'autorisation dont a besoin l'utilisateur CPIC pour une utilisation complète de toutes les fonctionnalités. Le tableau suivant part du principe que vous connaissez bien le concept d'autorisation de SAP. Objet d'autorisation Connexion à l'ae Nom du champ Valeur S_RFC Lorsque vous définissez le paramètre de profil auth/rfc_authority_check, SAP vérifie si l'utilisateur RFC dispose de l'autorisation d'exécuter le groupe de fonction. ACTVT RFC_ NAME RFC_ TYPE * * *

76 70 Chapter 7 Liaison technique S_BTCH_JOB Traitement de batch : Opérations sur les Jobs de batch AE crée des Jobs SAP dynamiquement et nécessite donc l'autorisation de planifier des Jobs, de les surveiller et de les libérer. AE crée, en outre, des Jobs en utilisant le programme ABAP standard RSBDCBTC pour exécuter des sessions BDC. JOBACTION JOBGROUP * * S_BTCH_ADM Traitement de batch : Administrateur de batch : Pour que les Jobs SAP existants puissent être exécutés, AE doit adapter les Jobs correspondants. Les interfaces AE et standard utilisent le module fonctionnel standard BP_ JOB_MODIFY pour exécuter les Jobs et nécessitent donc l'autorisation administrateur de batch. Cette dernière est également nécessaire pour afficher la liste spool d'un Job si celui-ci n'a pas été créé par l'utilisateur CPIC. BTCADMIN Y S_BTCH_NAM S_BTCH_ADM permet des sélections indépendantes du Client dans les Jobs existants. L'exécution de l'instruction AE R3_ACTIVATE_JOBS avec un Utilisateur CPIC possédant cette autorisation, peut, en fonction des critères de filtrage, mener au démarrage de Jobs dans plusieurs Clients SAP (par exemple, le même nom de Job existe dans deux Clients SAP). L'Utilisateur CPIC doit disposer de cette autorisation pour créer et exécuter des Jobs pour d'autres Utilisateurs SAP. BTCUNAME *

77 Automation Engine 71 S_SPO_DEV Spooler : autorisations de périphérique S_TMS_ACT S_XMI_PROD S_XMI_LOG S_WFAR_OBJ ArchiveLink : autorisations pour l'accès aux documents Pour pouvoir spécifier le paramètre d'impression "Impression Immédiate" au sein d'un step de Job, l'utilisateur CPIP nécessite l'autorisation pour le périphérique de sortie en question. Pour que la page de garde d'une liste spool puisse être transmise à AE, il est utile d'afficher le paramètre de la variante qui a été utilisée pour l'exécution ABAP. Cette information fait partie de la page de garde. Cet objet d'autorisation est utilisé pour l'identification à l'interface standard. Les applications externes doivent tout d'abord s'y identifier pour pouvoir faire appel à ses fonctions. L'objet d'autorisation n'est pas requis pour l'automation Engine. Lors de l'utilisation de l'interface standard, des entrées sont toutefois écrites dans le log XML (Online Transaction Code RZ15), qu'il n'est possible d'afficher ou de supprimer qu'avec cette autorisation. AE permet de spécifier des paramètres d'archivage (type d'objet, type de document). Grâce à ceuxci, vous pouvez transférer immédiatement la liste d'impression d'un programme ABAP à une archive optique (si cela est installé dans le système SAP). SPODEVICE * STMSACTION STMSOBJECT STMSOWNER EXTCOMPANY EXTPRODUCT INTERFACE - - ACTVT OAARCHIV OADOCUMENT OAOBJEKTE * * * * * * * * * *

78 72 Chapter 7 Liaison technique S_WFAR_PRI ArchiveLink : autorisations pour l'accès aux listes d'impression Pour que les listes d'impression puissent être créées dans les archives optiques, l'utilisateur CPIC doit posséder cette autorisation. ACTVT OAARCHIV OADOKUMENT OAOBJEKTE PROGRAM * * * * * S_PROGRAM ABAP : Vérifications du déroulement du programme AE requiert cette autorisation pour planifier des programmes ABAP auxquels des groupes d'autorisation sont attribués (champ d'autorisation P_ ACTION=BTCSUBMIT) et pour contrôler les variantes (P_ACTION=VARIANT). P_ACTION P_GROUP BTCSUBMIT,VARIANT * S_SPO_ACT Spool : Actions Le champ SPOACTION doit autoriser les actions BASE et DISP pour les Utilisateurs correspondants pour que les listes spool qui n'ont pas été créées par l'utilisateur CPIC puissent être transmises. SPOACTION SPOAUTH BASE,DISP * S_ADMI_FCD Autorisations système Le champ S_ADMI_FCD doit au moins autoriser l'action SP0R pour que les listes spool qui n'ont pas été créées par l'utilisateur CPIC puissent être transmises. S_ADMI_FCD SP0R S_RS_ISOUR Administrator Workbench - InfoSource (mise à jour flexible) L'autorisation est uniquement requise si la fonction Business Warehouse BW_ ACTIVATE_ INFOPACKAGE est utilisée et si la mise à jour flexible est appliquée. ACTVT RSAPPLNM RSISOURCE RSISRCOBJ * * * * S_RS_ISOUR Administrator Workbench - InfoSource (mise à jour directe) L'autorisation est uniquement requise si la fonction Business Warehouse BW_ ACTIVATE_ INFOPACKAGE est utilisée et si la mise à jour directe est appliquée. ACTVT RSAPPLNM RSISOURCE RSISRCOBJ * * * *

79 Automation Engine 73 S_DEVELOP ABAP Workbench S_RS_ICUBE Administrator Workbench - InfoCube S_RS_ADMWB Administrator Workbench - Objets S_RS_DS S_RS_DTP S_RS_ODSO S_RS_PC S_RZL_ADM S_TABU_DIS L'autorisation est uniquement requise si la fonction Business Warehouse BW_ ACTIVATE_CHAIN est utilisée. L'autorisation est uniquement requise si la fonction Business Warehouse BW_ ACTIVATE_CHAIN est utilisée. L'autorisation est uniquement requise si les fonctions Business Warehouse sont utilisées. L'autorisation est uniquement requise si les fonctions Business Warehouse sont utilisées. L'autorisation est uniquement requise si les fonctions Business Warehouse sont utilisées. L'autorisation est uniquement requise si les fonctions Business Warehouse sont utilisées. L'autorisation est uniquement requise si les fonctions Business Warehouse sont utilisées. Lancement de Jobs interceptés (Gestionnaire de File d'attente, R3_ activate_intercepted_jobs) Pour l'utilisation des formulaires SAP - Aucune autorisation SAP spécifique n'est nécessaire pour les fonctions AE supplémentaires comme il n'existe aucun risque de sécurité. ACTVT DEVCLASS OBJNAME OBJTYPE P_ GROUP ACTVT RSICUBEOBJ RSINFOAREA RSINFOCUBE ACTVT RSADMWBOBJ * * * * * * * * * * * ACTVT 01 ACTVT DICBERCLS 03 SPFL *) Nous vous recommandons de créer des autorisations en fonction de vos conventions de noms spécifiques.

80 74 Chapter 7 Liaison technique Pour disposer de la fonctionnalité minimale dans l'automation Engine, l'utilisateur RFC doit avoir un profil Utilisateur qui contient l'objet d'autorisation S_BTCH_JOB. Ce dernier doit contenir les autorisations standard S_BTCH_ALL ou avoir saisi les valeurs suivantes : Activités sur les Jobs : DELE, PLAN, PROT, RELE, SHOW Résumé des Jobs pour un Groupe : * 7.4 Prise en compte d'attributs de Job L'onglet spécifique à l'hôte pour les Jobs SAP contient plusieurs attributs ayant une influence sur plusieurs scripts. Le tableau suivant les énumère. Les scripts SAP n'apparaissant pas dans cette liste n'utilisent aucun attribut. Elément de script Logi n Langu e No m de Job Class e de Job Systèm e cible Mode de démarra ge Supprim er dans CCMS Destinatai re de la liste spool BCA_ ACTIVATE_ PROCESS R3_ ACTIVATE_ EXT_ COMMAND R3_ ACTIVATE_ EXT_ PROGRAM R3_ ACTIVATE_ INTERCEPTE D_JOBS R3_ ACTIVATE_ JOBS R3_ ACTIVATE_ REPORT R3_ ACTIVATE_ SESSIONS R3_CALL_ TRANSACTIO N R3_GET_ EVENT R3_GET_JOB_ SPOOL

81 Automation Engine 75 R3_MODIFY_ JOB R3_RAISE_ EVENT Rubriques connexes : Onglet SAP pour les Jobs SAP 7.5 Interfaces Interfaces Les Agents communiquent avec le système SAP sur la base de RFC (Remote Function Call) de SAP. Pour ce faire, des modules fonctionnels sont exécutés. Parallèlement aux interfaces par défaut, l'agent peut utiliser l'interface qui donne accès à des fonctionnalités supplémentaires. Nous faisons généralement la distinction dans la documentation entre L'interface est composée de modules de fonctions développés par l'automation Engine. Les interfaces standard sont composées de modules de fonctions développés par SAP. L'Automation Engine utilise plusieurs de ces interfaces à différentes fins. Les interfaces se répartissent en XMB (external Monitoring Basics) XAL (external ALerting) XBP (external Batch Processing) *) XMW (external Monitoring Write) BW-STA (Business Warehouse - data STAging) *) Attention : l'interface XBP 2.0 doit être activée avec le programme SAP INITXBP2. Cela fait partie de l'installation XBP 2.0. Sinon, les relations parent-enfant et la fonction de Jobs interceptés ne peuvent pas être utilisées. Operations Manager prend en charge les interfaces XBP 2.0 et XBP 3.0 de SAP NetWeaver. Des modules SAP utilisant cette interface peuvent donc être utilisés. En font par exemple partie SAP 4.7, NetWeaver Stack 2004s, ECC5, ECC6, etc. La version de l'interface XBP est indépendante de celle du kernel. SAP assure une certaine compatibilité. Cela signifie que lorsqu'une nouvelle version de l'interface est disponible, un certain nombre des versions de kernel prennent en charge l'ancienne version. L'interface requiert BABP XBP V2.0. Vérifiez la version de votre système AE et installez, le cas échéant, le package de prise en charge actuel Différences au niveau des fonctions Le tableau récapitulatif suivant montre quels Scripts SAP exigent l'interface (Script). Les Scripts qui possèdent des paramètres pour lesquels l'utilisation de l'interface est requise sont également identifiés (Paramètre).

82 76 Chapter 7 Liaison technique Scripts et interfaces utilisées Script Description Interface nécessaire R3_ACTIVATE_ CM_PROFILE R3_ACTIVATE_ EXT_COMMAND R3_ACTIVATE_ EXT_PROGRAM R3_ACTIVATE_ INTERCEPTED_ JOBS R3_ACTIVATE_ JOBS R3_ACTIVATE_ REPORT R3_ACTIVATE_ SESSIONS R3_CALL_ TRANSACTION R3_COPY_ VARIANT R3_CREATE_ OUTPUT_ REQUEST R3_CREATE_ VARIANT R3_DEACTIVATE_ CM_PROFILE R3_DELETE_ NODE R3_DELETE_ VARIANT R3_GET_ APPLICATIONLOG R3_GET_ APPLICATIONLOG R3_GET_EVENT R3_GET_ INTERCEPTION R3_GET_JOB_ SPOOL Active un profil dans le Gestionnaire de critères SAP. Exécute une commande externe. Exécute un programme externe. Exécute les Jobs interceptés. Exécute les Jobs déjà planifiés. Exécute un programme ABAP. Exécute des dossiers batch input. Exécute une transaction SAP. Copie la variante d'un rapport. Crée un nouvel ordre d'édition pour une requête spool existante. Crée une nouvelle variante. Désactive un profil dans le Gestionnaire de critères SAP. Supprime un nœud de l'architecture de moniteur SAP. Supprime la variante d'un rapport. Vérifie le code retour d'application d'une ou de plusieurs étapes de Job. Cherche les messages du logging d'application et les génère dans le rapport ou le fichier. Attend un Evènement déclenché dans SAP. Lit la table de filtre pour les Jobs interceptés et enregistre dans le protocole d'activation ou un fichier. Lit la liste spool d'un step de type "programme ABAP". Script Paramètres

83 Automation Engine 77 R3_GET_JOBLOG R3_GET_JOBS R3_GET_ MONITOR R3_GET_ SESSIONS R3_GET_ SPOOLREQUESTS R3_GET_ SYSTEMLOG R3_GET_ VARIANTS R3_GET_ VARIANT_ CONTENTS R3_MODIFY_ INTERCEPTION R3_MODIFY_JOB R3_MODIFY_ VARIANT R3_RAISE_EVENT R3_SCHEDULE_ JOB_CANCEL R3_SEND_ SPOOL_REQUEST R3_SET_ BDCDATA R3_SET_FREE_ SELECTION R3_SET_LOG_ ATTR R3_SET_PERF_ ATTR R3_SET_PRINT_ DEFAULTS R3_SET_SELECT_ OPTION R3_SET_STATUS_ ATTR Cherche le logging d'un Job SAP dans SAP et l'affiche dans un rapport. Sélectionne des Jobs SAP et affiche le résultat dans le rapport d'activation. Lit des données d'un moniteur SAP. Sélectionne des dossiers batch input et affiche le résultat dans le rapport d'activation ou dans un fichier. Sélectionne des requêtes spool avec des Filtres prédéfinis. Lit les informations d'une période donnée d'un logging système SAP. Lit le catalogue des variantes. Affiche le contenu d'une variante. Modifie la table de filtre pour les Jobs interceptés. Modifie un step ABAP. Modifie une valeur dans une variante. Déclenche un Evènement défini dans SAP. Réattribue le statut "Planifié" à un Job SAP déjà lancé. Envoie une requête spool existante. Définit les données BDC. Définit une limite libre. Ajoute un attribut de logging dans l'architecture de moniteur SAP Ajoute un attribut de performance dans l'architecture de moniteur SAP Définit des valeurs par défaut pour les paramètres d'impression utilisés lors de l'exécution de rapports. Définit un critère de sélection. Ajoute un attribut de statut dans l'architecture de moniteur SAP

84 78 Chapter 7 Liaison technique R3_SET_TEXT_ ATTR R3_SWITCH_ OPMODE Ajoute un attribut de texte dans l'architecture de moniteur SAP Change le mode de fonctionnement dans SAP. Rubriques connexes : Généralités sur le JCL AE pour les applications Transport de l'interface Généralités Pour utiliser les fonctionnalités de l'interface, les modules fonctionnels doivent d'abord être transportés dans le système SAP. Ils sont développés sous forme d'objets de développement ABAP. Ces objets sont fournis dans le package "correction et transport" du système SAP: KNNNNNN.SID Fichier d'information, par exemple K T45 RNNNNNN.SID Fichier de données, par exemple R T45 ENNNNNN.txt Protocole d'exportation, par exemple E txt Outre les modules fonctionnels, des espaces de noms sont également transportés dans des ordres individuels. Vous trouverez une liste des ordres de transport en cours de validité dans le fichier TRANSPRT.TXT. En cas de nouvelle installation, tous les ordres de transport doivent être exécutés. En cas de mise à jour de l'installation, seuls les modules fonctionnels (interface) sont mis à jour, car les espaces de noms ne changent pas. Les noms des objets de développement sont décrits dans la terminologie. Les abréviations suivantes sont utilisées dans ce document: NNNNNN pour le numéro d'ordre de transport du système source et SID pour le nom du système source. TID est utilisé pour le nom du système cible (dans lequel les modules fonctionnels sont importés). Nom du fichier Dans la mesure où le système SAP peut être installé dans différents environnements (UNIX, Windows...), les particularités du système doivent être prises en compte dans les noms des fichiers. Dans ce document, nous écrivons généralement des noms de fichiers, qui concernent l'environnement SAP, avec la syntaxe UNIX (également avec "/"). Dans l'environnement Windows, les noms sont identiques, à la différence seulement que dans ce cas, on utilise "\".

85 Automation Engine 79 Importation des modules fonctionnels dans SAP Pour utiliser les fonctionnalités de l'interface, les modules fonctionnels doivent d'abord être transportés dans le système SAP. Requis : Les autres activités du système de transport doivent impérativement être exécutées avec l'utilisateur d'administration SAP (SIDadm). Le système de transport doit être configuré et paramétré correctement, généralement lors de l'installation du système SAP. Au moins deux processus de travail de batch (BTC) doivent fonctionner dans cette instance SAP pour l'importation Contrôle: Outils Administration Moniteur Surveillance système Sélection de processus (transaction SM50). Le démon de transport du système SAP (Job d'arrière-plan "RDDIMPDP") doit être planifié et validé dans le Client 000 pour l'importation d'objets de développement. Contrôle: Voir ci-dessous La fonctionnalité peut être vérifiée comme suit:cd usr/sap/trans/bin... Changement dans le répertoire de transport SAP tp checkimpdp TID... Vérifier si le démon de transport RDDIMDP est actif dans SAP tp connect TID... Tester la connexion au système SAP Le système de transport est décrit dans la documentation SAP en ligne, dans le chapitre SYSTEME DE BASE PILOTAGE DU CONTROLE. Veuillez noter que l'option "Ignorer les versions des composants" inadaptées doit être activée lors de l'importation. Déroulement: Reprise du fichier de transport fourni dans l'environnement de transport SAP: Sur l'ordinateur SAP: Accédez au sous-répertoire adapté à la version SAP sous IMAGE:AGENTS\SAP\_TRANS. Copie des fichiers dans les répertoires suivants: KNNNNNN.SID par /usr/sap/trans/cofiles RNNNNNN.SID par /usr/sap/trans/data Lorsque SAP est installé sous UNIX, le transfert des fichiers s'effectue généralement via FTP. Indiquez impérativement "bin" pour les transferts binaires. Le fichier ENNNNNN.TXT du CD contient le protocole d'exportation complet et peut être utilisé pour une éventuelle analyse. Importation de la livraison dans le système SAP: Sur l'ordinateur SAP (connexion avec l'utilisateur d'administration SAP (SIDadm)). Les fichiers de transport repris (RNNNNNN.SID et KNNNNNN.SID) ne doivent pas être protégés en écriture (attention lors de la copie à partir du CD)!

86 80 Chapter 7 Liaison technique Si besoin, il est possible de créer un répertoire des objets contenus dans l'ordre de transport: cd usr/sap/trans/data... Changement dans le répertoire de transport SAP r3trans -l RNNNNNN.SID... Crée un fichier trans.log (liste des objets transportés) Génération d'une entrée de tampon pour le système cible. cd usr/sap/trans/bin... Changement dans le répertoire de transport SAP tp addtobuffer SIDkNNNNNN TID[pf=<nom profil, par défaut TPPARAM>] Si besoin, il est possible de vérifier l'entrée de tampon: tp showbuffer TID [pf=<nom profil, par défaut TPPARAM>] Vous devez décider avant l'importation avec quels modes inconditionnels (u) l'importation doit être exécutée: 4...est valable uniquement pour la version SAP 3.x: sachant que le nom du système cible indiqué lors de l'exportation ne correspond pas au nom du système cible réel (TID). Dans la mesure où le système cible réel n'est pas connu lors de l'exportation, ce mode doit toujours être spécifié! 1...doit être indiqué lorsque l'importation doit être répétée. Lancement de l'importation avec la commande: tp import SIDkNNNNNN bzw. tp import SIDkNNNNNN TPPARAM>] TIDu4 [client123] [pf=<nom profil, par défaut TPPARAM>] TID u14 [client123] [pf=<nom profil, par défaut Les modes inconditionnels diffèrent selon la version TP. Vous pouvez consulter la documentation SAP pour plus d'informations à ce sujet. Respectez les points suivants lors de l'importation: Contrôle: Au moins 2 tâches de batch doivent fonctionner dans l'instance pour les importations! Bien que l'ordre de transport ne contienne aucune donnée propre au Client, il peut arriver qu'un Client soit requis lors de l'importation. Dans ce cas, un Client valable pour votre environnement doit être spécifié à l'aide du paramètre client=nnn (l'export a eu lieu avec le Client 010). L'importation peut prendre quelques minutes, plus particulièrement lorsque le démon de transport RDDIMPDP n'est pas déclenché par un évènement, mais est contrôlé par une horloge. Message "no profile used ": Aucun profil n'est indiqué lors de l'exécution interne du programme sur "sapevt". C'est pourquoi ce message est généré pour chaque exécution sur sapevt. Il peut être ignoré en temps normal! D'autres messages peuvent être générés. Cependant, seul le Code retour est important (voir ci-dessous Contrôle). En raison de la complexité du système de transport et de l'environnement SAP, seul un expert qui connaît l'environnement d'installation peut réaliser un diagnostic d'erreur complet et apporter des corrections. Un non-spécialiste peut toutefois évaluer si l'importation s'est bien passée à l'aide des conseils suivants:

87 Automation Engine 81 Des fichiers log sont générés lors de l'importation. Ils se trouvent dans le répertoire /usr/sap/trans/log sous le nom SIDsNNNNNN.TID s correspond à l'étape de transport: G... Génération de rapports et d'écran H... R3TRANS Dictionnaire d'importation I... R3TRANS Importation principale Le code exit (= Code retour) de ces trois fichiers log doit être contrôlé (il est toujours indiqué à la fin du fichier). Il ne doit pas dépasser "4"! Un expert peut naturellement contrôler ces fichiers log dans le système SAP Test de l'interface avec ABAP Workbench Ce document contient des explications relatives au test de l'interface permettant la connexion au système SAP. 1. Démarrer l'environnement de développement et ouvrir les modules fonctionnels. Démarrez l'environnement de développement (ABAP/4-Workbench) et ouvrez, à l'aide du navigateur d'objets, les modules fonctionnels pour les groupes de fonction /SBB/UC4_JOB : Outils ABAP/4-Workbench Résumé Object Navigator, sélectionnez le groupe de fonctions /SBB/UC4_JOB, ouvrez les modules fonctions, positionnez le curseur sur l'objet et sélectionnez Tester dans le menu contextuel. Le nom des modules fonctionnels a toujours UC4 comme préfixe. 2. Tester le module fonctionnel UC4_JOB_OPEN. Paramètre à indiquer : JOBNAME - Nom quelconque, par exemple 'TEST'. JOBCLASS - A, B ou C Le paramètre JOBCOUNT est fourni. Cette valeur doit être notée ou le mieux est de la copier dans le presse-papiers.

88 82 Chapter 7 Liaison technique 3. Tester le module fonctionnel UC4_JOB_SUBMIT Paramètre à indiquer : JOBCOUNT - introduire la valeur ou l'ajouter depuis le presse-papiers, JOBNAME - comme pour le modèle fonctionnel UC4_JOB_OPEN, REPORT_ID - 'RSM04000' ou 'RSM04000_ALV'.

89 Automation Engine 83 Après l'exécution, il faut s'assurer qu'aucune exception ne s'est produite. Les paramètres sont certes fournis ici, mais ils ne sont pas impérativement nécessaires pour le test. 4. Tester le module fonctionnel UC4_JOB_CLOSE. Paramètre à indiquer : JOBCOUNT - introduire la valeur ou l'ajouter depuis le presse-papiers, JOBNAME - comme pour le modèle fonctionnel UC4_JOB_OPEN. Après l'exécution, il faut s'assurer qu'aucune exception ne s'est produite.

90 84 Chapter 7 Liaison technique Le Job est maintenant démarré et peut être affiché à l'aide de la transaction standard SM37 (Système Services Jobs Résumé de Job). Une fois le Job terminé, cela vient confirmer que les modules fonctionnels élémentaires pour le contrôle de Job au sein du système SAP fonctionnent.

91 Automation Engine Agent pour SAP BW Généralités La Automation Engine prend en charge la composante SAP Business Information Warehouse (SAP BW) comme s'il s'agissait d'un système d'exploitation propre. D'un point de vue technique, cette collaboration est réalisée de sorte que des modules fonctionnels sont appelés au sein du système SAP par le biais des RFC (Remote Function Call) de SAP. La communication vers le système SAP est effectuée uniquement via les RFC et est ainsi indépendante de l'environnement dans lequel SAP BW est installé. La configuration du paramètre de connexion a lieu dans l'objet Connexion de l'agent. De plus, cet Agent peut être activé pour toutes les versions de SAP BW prises en charge par l'automation Engine. L'Agent pour SAP BW peut également exécuter des Jobs dans le système de base SAP (Jobs en arrière-plan standard). Le tableau suivant indique les versions de SAP BW et de SAP Basis pour lesquelles un Agent est disponible pour SAP BW. Version BW SAP Basis Agent pour SAP BW 1,2B 4,5A Non pris en charge. 2,0B 4.6C Disponible à partir de la version Automation Engine 2.63C. 2.1C 4.6D Disponible à partir de la version Automation Engine 2.63C. 3,0B 6.10 Disponible à partir de la version Automation Engine 2.63D. >3.0B 6.x Disponible à partir de la version Automation Engine 2.63D Support Packages pour SAP BW Pour utiliser l'agent, nous vous recommandons d'installer les Support Packages de SAP BW ciaprès. Version SAP BW 2,0B C 24 3,0B C 08 >3.1C Niveau du Support Package Pas de niveau de Support Package connu Si un Support Package de niveau inférieur est installé sur l'agent, les messages suivants peuvent s'afficher. Vous trouverez de plus amples informations dans les notes SAP spécifiées. Numéro de note SAP Message short dump "DYNPRO_SEND_IN_BACKGROUND" Message E089(RSM1) "Job not (yet?) started" BAPI_IPAK_CHANGE ignores InfoPackage Parameter

92 86 Chapter 7 Liaison technique Vérification du statut Dans la Automation Engine, le statut technique communiqué lors de l'appel de fonction pour vérifier le statut est considéré comme un "statut final". La description de ce terme dans Interface Repository est la suivante: Le paramètre TECHSTATUS est le statut technique de la demande. Il dispose toujours l'une des valeurs suivantes : G Vert (la demande est enregistrée avec succès) Y Jaune (la demande est en cours de traitement) R Rouge (la demande génère une erreur ou est interrompue) Le statut n'est cependant visiblement pas un "statut final". Il peut passer plusieurs fois en "rouge" pendant un court instant (erreur ou interruption) puis passer de nouveau en "jaune" ou en "vert". Le système AE en tient compte ; il est possible d'activer un délai de vérification du statut, par exemple lorsque le statut est "rouge", le système vérifie encore x fois si le statut reste réellement "rouge". Les paramètres maxruntime= et repeat_check= (section [SAP_BW]) se trouvent dans le fichier INI de l'agent SAP à cet effet. Une fonction est également appelée pour la vérification du statut des chaînes de processus. Les valeurs des statuts sont les suivantes : "R" Interruption "G" Fin normale "F" Fin normale "A" Poursuivre la surveillance "X" Interruption "P" Poursuivre la surveillance "S" Interruption (mais uniquement après un redémarrage de la chaîne de processus) "Q" Poursuivre la surveillance "Y" Poursuivre la surveillance " " Poursuivre la surveillance Ces statuts sont ensuite convertis en Codes Retour dans l'automation Engine: Code retour Statut Statut SAP 0 ENDED_OK G ou F 4 ENDED_NOT_OK R 8 ENDED_NOT_OK X 12 ENDED_NOT_OK S 7.7 Paramètres d'archivage avec R3_ ACTIVATE_REPORT Les paramètres d'archivage qu'un utilisateur peut spécifier pour R3_ACTIVATE_REPORT correspondent aux zones de saisie illustrées ci-dessous. La boîte de dialogue s'affiche dans le système SAP si "Archivage" a été sélectionné comme mode dans les paramètres d'impression.

93 Automation Engine 87 Paramètres de SAP Type d'objet Type de Document Information Texte Paramètres pour R3_ACTIVATE_REPORT ARCHIVE_SAPOBJECT ARCHIVE_OBJECT ARCHIVE_INFO ARCHIVE_TEXT Rubriques connexes : R3_ACTIVATE_REPORT 7.8 ERROR/ERRORLEVEL dans R3_ ACTIVATE_SESSIONS Lors de l'exécution de R3_ACTIVATE_SESSIONS, le système SAP cherche tout d'abord la liste des dossiers à exécuter. Chaque dossier est exécuté par un seul Job SAP. Ce Job est appelé replayer dans le présent document. Le replayer utilise l'abap "RSBDCBTC" pour l'exécution. ERROR Se rapporte au résultat (statut) du replayer. Le résultat peut être "A" pour interrompu, ou "F" pour terminé avec succès. ERROR=IGNORE Le prochain dossier de la liste des correspondances est toujours exécuté. Le résultat du replayer précédent est ignoré.

94 88 Chapter 7 Liaison technique ERROR=ABEND La lecture des dossiers est immédiatement arrêtée lorsqu'un replayer se termine avec le statut "A". Le Job est interrompu. ERRORLEVEL Se rapporte toujours au dossier et est vérifié à la fin du replayer. Il définit le pourcentage des transactions d'un dossier qui ne se sont pas exécutées avec succès. Si la valeur des dossiers est dépassée, le traitement du Job est interrompu. Aucun autre dossier de la liste des correspondances n'est démarré. Si ERRORLEVEL n'est pas indiqué, aucune vérification des transactions inscrites avec succès n'est effectuée.

95 Automation Engine Résolution de problèmes Conseils sur la recherche d'erreurs Vous trouverez ici une liste des sources d'informations qui permettent de reconnaître une situation d'erreur lorsque l'agent ne fonctionne pas correctement (ou que partiellement), ou qu'il n'exécute pas correctement certaines Tâches. Rapport de Job La source la plus proche est le rapport du Job pour SAP. Y sont journalisées pour chacune des Tâches les actions que l'agent a exécutées par rapport au système SAP ainsi que la façon dont elles se sont terminées. Attributs de l'objet activé Il est possible que l'origine de l'erreur se trouve tout simplement dans les attributs de l'objet activé (par exemple Client ou Utilisateur erronés). Vérifiez les attributs de l'objet correspondant. Utilisateur CPIC Pour la connexion au système SAP, un Utilisateur SAP (Client, nom, mot de passe) doit être défini dans un objet Login. Cet Utilisateur doit également exister avec le même mot de passe dans tous les Clients du système SAP dans lesquels des Tâches sont exécutées. Vérifiez l'objet Login mais aussi les Utilisateurs du système SAP. L'Agent est représenté par l'utilisateur CPIC au sein du système SAP. Cet Utilisateur doit, bien entendu, disposer des droits correspondants, par exemple droit d'opérateur pour le traitement en arrière-plan. Vérifiez les droits de l'utilisateur CPIC dans le système SAP. Transactions utiles La transaction "SM37" offre également des informations sur l'exécution de Job dans le log de Job et dans la liste de spool. Le log XMI, qui peut être exécuté avec "RX15", fournit également des enregistrements utiles. Fichiers log Vous trouverez des informations détaillées sur l'heure en question dans les fichiers log de l'agent et du Serveur. Vous pouvez également afficher le contenu des fichiers dans la Supervision Système. Au début, l'intégralité du fichier INI est tout d'abord journalisée. Dans cette section, vous pouvez reconnaître les paramètres avec lesquels l'agent ou le Serveur s'exécute. Toutes les actions exécutées sont ensuite enregistrées chronologiquement. Le log système SAP Les situations d'erreur se produisant au sein du système SAP sont journalisées dans le log système SAP. Vous pouvez afficher le log système avec la transaction SAP "SM21". Dans certains cas, par exemple lorsque la planification d'un step de Job par un Agent échoue, le log système SAP est automatiquement transféré dans le rapport de Job. Il peut alors être affiché dans un nouvel onglet du rapport.

96 90 Chapter 7 Liaison technique Traces Les traces journalisent, sous forme de fichiers log, des informations encore plus détaillées sur les processus. Elles contiennent, par exemple, les transmissions de messages entre l'agent et le Serveur ou entre l'agent et le système SAP. Dans le dernier cas, on parle d'une trace RFC. Les traces doivent être activées soit dans le fichier INI de l'agent, soit dans la Supervision Système. Les contenus des traces sont enregistrés dans des fichiers dans le répertoire de travail de l'agent ou dans le répertoire spécifié. Les traces sont conçues pour une analyse par le support ou le développement. Envoyez toujours ce genre de documents à votre demande de support. Attention : lors de l'activation de la trace RFC, des fichiers sont non seulement enregistrés côté Agent, mais également sur la machine du serveur d'application SAP! N'activez donc la trace que pendant quelques instants, afin d'économiser de l'espace sur le disque dur. Pour empêcher toute création de fichiers de trace dans le système SAP, vous pouvez définir le paramètre gw/accept_ remote_trace_level sur 0. Vous trouverez des informations complémentaires sur la trace RFG dans la note SAP Problèmes lors de l'importation des modules fonctionnels Le programme tp ne se termine pas Symptôme Lors de l'importation des objets de développement, le programme tp ne se termine pas (il s'exécute normalement pendant quelques minutes). Après interruption avec (Ctrl-C), le message suivant figure dans le fichier SLOG. Background Job RDDIMPDP could not be started or terminated abnormally Origine L'importation des objets de développement est exécutée par le Job RDDIMPDP. Cela est normalement planifié en tant qu'evènement et est déclenché par l'evènement "SAP_TRIGGER_ RDDIMPDP" du programme tp. En l'occurrence, le démarrage de ce Job par l'evènement ne fonctionne pas, tp attend donc sans fin. Solution Vérifiez que l'evènement "SAP_TRIGGER_RDDIMPDP" est défini (transaction SM64). Contrôlez que les entrées pour le contrôle de l'evènement ont été entrées correctement dans TPPARAM. Recherchez d'éventuels conseils dans le SAP Service Portal avec le mot-clé "SAP_TRIGGER_ RDDIMPDP".

97 Automation Engine 91 En cas d'urgence, utilisez le RDDIMPDP qui dure 5 minutes ; il peut être planifié par ABAP RDDPUTPP avec SE Jobs SAP se terminant par ARCHIVE_INFO_NOT_ FOUND Symptôme Les Jobs SAP se terminent par le message ci-dessous : U RFC Returntext: ARCHIVE_INFO_NOT_FOUND Origine ARCHIVE_INFO_NOT_FOUND est une exception du module fonctionnel "GET_PRINT_ PARAMETERS". Ce module fonctionnel est un module fonctionnel standard du système SAP. ARCHIVE_INFO_NOT_FOUND n'a pas nécessairement un rapport avec la zone d'informations des paramètres d'archivage. ARCHIVE_INFO_NOT_FOUND se rapporte à tous les paramètres d'archivage, à savoir : ARCHIVE_O[BJECT]= catégorie de document ARCHIVE_S[APOBJECT]= type d'objet ARCHIVE_T[EXT]= texte ARCHIVE_I[NFO]= zone d'informations ARCHIVE_INFO_NOT_FOUND peut avoir toute une série de causes, telles que : La catégorie de document ou le type d'objet indiqué n'est pas défini dans le système SAP. La catégorie de document est affectée à une archive inexistante dans le système SAP (Content Repository). L'utilisateur ne possède pas les droits d'accès (voir l'objet d'autorisation S_WFAR_PRI). Si l'automation Engine transmet correctement les paramètres au module fonctionnel, la cause de l'exception existe la plupart du temps dans le système SAP. Solution Vérifiez, à l'aide de la trace RFC, si l'automation Engine a correctement transmis les paramètres au module fonctionnel. Vérifiez les paramètres relatifs à "Business Documents" et "ArchiveLink" dans le Customizing du système SAP ainsi que les autorisations de l'utilisateur CPIC. Rubriques connexes : R3_ACTIVATE_REPORT Paramètres d'archivage pour R3_ACTIVATE_REPORT

98 92 Chapter 7 Liaison technique Problème de stabilité avec des instances SAP chez de nombreux Agents SAP (connexion RFC) sur un serveur : Symptôme Le Serveur RFC/CPIC externe ne peut ouvrir de nouvelle connexion et le message d'erreur suivant s'affiche : LOCATION CPIC (TCP/IP) on local host ERROR max no. of 100 conversations exceeded Origine Le nombre de connexions parallèles pouvant être maintenues dans la bibliothèque est limité à 100. Solution La Variable d'environnement CPIC_MAX_CONV vous permet d'augmenter cette valeur. Windows : set CPIC_MAX_CONV=<n> p. ex. set CPIC_MAX_CONV=500 (pour 500 connexions) Unix : setenv CPIC_MAX_CONV <n> ( csh ) p. ex. setenv CPIC_MAX_CONV 500 (pour 500 connexions) Unix : export CPIC_MAX_CONV=<n> ( ksh ) p. ex. export CPIC_MAX_CONV=500 (pour 500 connexions) iseries : ADDENVVAR ENVVAR(CPIC_MAX_CONV) VALUE(<n>) p. ex. ADDENVVAR ENVVAR(CPIC_MAX_CONV) VALUE(500) (pour 500 connexions) Problème de transmission de mot de passe à SAP Après la mise à jour vers les versions 2004s et ultérieures de SAP Netweaver, la connexion de l'utilisateur CPIC ne fonctionne plus Symptôme Les essais de connexions basées sur mot de passe (sur les systèmes : ABAP à partir de la version 7.00 / NetWeaver 2004s / mysap ERP 2005) échouent, même si l'utilisateur a enregistré un mot de passe a priori correct dans un composant frontal ou la destination d'un autre système. Cependant, une connexion directe SAPGUI avec le même mot de passe réussit.

99 Automation Engine 93 Origine Les systèmes ABAP à partir de la version 2004s (7.00) de NetWeaver prennent en charge des mots de passe de 40 caractères maximum, et sensibles à la casse. Dans les anciennes versions, la limite était de 8 caractères et toutes les minuscules étaient mises en majuscules. Si un mot de passe non rétrocompatible est utilisé dans le nouveau système, et si le composant frontal ou intermédiaire ne peut traiter correctement ces mots de passe, la connexion échoue. La raison en est en général la conversion (invisible) minuscule/majuscule. En effet, le mot de passe entré par l'utilisateur n'arrive pas au Serveur sous sa forme originale, mais sous une forme modifiée soit directement après la saisie, soit lors de la transmission (qui s'effectue à travers de nombreux composants). Définitions Mot de passe : rétrocompatible / non rétrocompatible Un mot de passe est rétrocompatible s'il a 8 caractères au maximum et ne contient aucune minuscule. Un mot de passe n'est pas rétrocompatible s'il a plus 8 caractères au maximum et/ou contient au moins une minuscule. Les anciennes versions des systèmes ABAP ne prennent en charge que les mots de passe rétrocompatibles. A partir de la version 7.00, les deux sortes de mots de passe peuvent être utilisées. Comme les minuscules ne sont plus converties en majuscules, les mots de passe des nouvelles versions des systèmes ABAP ne sont généralement pas rétrocompatibles. Méthode de hachage de mots de passe / Versions de Code Les systèmes ABAP ne sauvegardent pas les mots de passe en clair. Ils calculent à partir des données saisies une somme de contrôle qu'ils sauvegardent avec les méta-données décrivant le mode de hachage ("version de code"). Ces informations sont enregistrées dans les données de référence de l'utilisateur et utilisées lors de la vérification du mot de passe. A partir du mot de passe saisi, une somme de contrôle est calculée avec la version de code enregistrée dans les données de référence de l'utilisateur et comparée à celle de ces mêmes données. La quantité des méthodes de hachage dépend de la version du programme, les nouvelles prenant toujours en charge celles des versions précédentes. De cette façon, la connexion protégée par mot de passe est toujours possible, même après une mise à jour. Seules les méthodes de hachage de mot de passe des versions à partir de 7.00 prennent aussi en compte les mots de passe non rétrocompatibles. Les anciennes versions ne prennent en charge que les mots de passe rétrocompatibles. Ce sont donc les données enregistrées dans les données de référence de l'utilisateur (version de code) qui déterminent tout d'abord la prise en compte éventuelle de la connexion effectuée avec des mots de passe non rétrocompatibles. Solution Emploi d'utilisateurs techniques (dans des destinations RFC) :

100 94 Chapter 7 Liaison technique Nous vous conseillons d'utiliser le type d'utilisateur SYSTEM (ou SERVICE, si la fonction SAPGUI est nécessaire) sur le Serveur, car c'est le seul type pour lequel la durée de validité du mot de passe est illimitée. Tant que le mot de passe doit être saisi dans une destination RFC d'une version ancienne d'un système (= Client RFC), il doit être défini de façon rétrocompatible au niveau du Serveur Cela est toujours possible aux types SYSTEM ou SERVICE, même si les règles de définition des mots de passe obligent l'utilisation de mots de passe non rétrocompatibles (avec login/min_password_lng > 8 ou login/min_ password_lowercase > 0 par ex.). Emploi d'anciens composants frontaux ou intermédiaires et connexion d'utilisateurs "normaux" (de type DIALOG) : Dans ce cas, il n'est pas indiqué de modifier les mots de passe des nombreux Utilisateurs (comme dans le cas précédent des utilisateurs techniques). Vous devrez dans ce cas remplacer les composants frontaux / intermédiaires obsolètes. La remarque SAP énumère les versions à partir desquelles certains composants frontaux et intermédiaires prennent en charge les mots de passe non rétrocompatibles. Il peut être de plus nécessaire d'actualiser d'autre composants logiciels (d'autres fournisseurs par ex.) dépendant de ces mêmes composants, dans le cas notamment où ces composants ont une fenêtre de dialogue de saisie de mot de passe propre mais ne prennent pas en charge les mots de passe non rétrocompatibles. Provisoirement et à titre de test, vous pouvez définir le paramètre de profil login/password_ downwards_compatibility sur 2 ou 3. Dans ce cas, le Serveur vérifie si le Client a envoyé un mot de passe rétrocompatible (coupé après 8 caractères et converti en majuscules) au lieu du mot passe non rétrocompatible attendu. Cela est alors journalisé dans le système (pour analyse des erreurs) et la connexion est considérée comme réussie (paramètre sur 3) Le paramètre peut être modifié dynamiquement, sans redémarrage du système avec la transaction SAP RZ 11.

101 Automation Engine 95 8 Certification 8.1 Résumé Les fonctionnalités liées à SAP sont naturellement certifiées. Le tableau suivant présente une liste de tous les certificats : Solution Interface Software Interface SAP Agent AE for SAP BC-XBP Background Processing, Job Scheduling 6.10 (Vers. 2.0) BC-XBP Background Processing, Job Scheduling 7.0 (Vers. 3.0) JAVA-JXBP 7.1 Agent AE for SAP BW BW-SCH Scheduling for SAP BW 3.0 Agent AE for J2EE/JMX JAVA-EE-STD 7.1 Rubriques connexes : Partenaires SAP SAP Developer Network (SDN)