Accueil
Contextes d'exécution
Descriptions des services d'exécution Link.
Map Command Server
Vous devez préparer les mappes pour l'exécution avant d'utiliser Map Command Server pour cette opération.
Commandes d'exécution
La présente documentation contient des informations relatives aux différents modes d'utilisation des commandes d'exécution, et à leurs options pour l'exécution des mappes. Les commandes d'exécution servent à indiquer comment s'exécutera la mappe.
Liste des commandes d'exécution
La présente documentation contient des informations relatives aux commandes d'exécution et aux options qui leur sont associées, notamment leur syntaxe et leurs particularités d'utilisation.
Fail on Warnings (-F)
La commande d'exécution Fail on Warnings (-F) sert à indiquer que la mappe doit échouer si l'un des codes d'avertissement indiqués est retourné.
Exemples d'utilisation de la commande Fail on Warnings (-F)
Les exemples suivants illustrent l'utilisation de Fail on Warnings (-F).

Contextes d'exécution
Descriptions des services d'exécution Link.
- API REST
  L'exécution REST fournit une API REST utilisée pour exécuter les mappes et les flux qui ont été déployés.
- Serveur de commande de flux
  Déployez un flux du Lien HCL vers le système de fichiers local à l'aide de la définition de serveur de flux d'exécution.
- Map Command Server
  Vous devez préparer les mappes pour l'exécution avant d'utiliser Map Command Server pour cette opération.
  - Présentation
    Map Command Server permet de développer, de tester et d'exécuter des mappes dans des environnements de développement. Il peut également être utilisé pour exécuter des commandes dans des environnements de production.
  - Exécution d'une mappe
    Lorsqu'une mappe a été construite pour une plateforme d'exécution spécifique et transférée, elle peut être exécutée à l'aide de Map Command Server.
  - Outils d'identification des problèmes
  - Interfaces externes pour applications, EXIT et RUN
    Les mappes peuvent s'interfacer avec d'autres mappes, des fonctions dans des bibliothèques ou des programmes à l'aide de la fonction EXIT, de la fonction RUN ou d'un adaptateur en tant que source ou cible de données.
  - Plateformes Windows
    Vous pouvez effectuer plusieurs activités avec Map Command Server installé dans votre environnement Windows.
  - Commandes d'exécution
    La présente documentation contient des informations relatives aux différents modes d'utilisation des commandes d'exécution, et à leurs options pour l'exécution des mappes. Les commandes d'exécution servent à indiquer comment s'exécutera la mappe.
    - Présentation de Command Server
      Les commandes d'exécution vous serviront à remplacer les paramètres de mappe ou de carte dans une mappe compilée, lorsqu'une mappe est exécutée à l'aide de l'une des méthodes suivantes :
    - Utilisation des commandes de Command Server
      Lorsque vous exécutez une mappe, vous pouvez :
    - Liste des commandes d'exécution
      La présente documentation contient des informations relatives aux commandes d'exécution et aux options qui leur sont associées, notamment leur syntaxe et leurs particularités d'utilisation.
      - Disponibilité des commandes
        Certaines commandes sont limitées, car elles ne peuvent être utilisées qu'avec Command Server, pas depuis une fonction RUN() ou à l'aide de l'API de plateforme. De plus, certaines commandes ne sont pas disponibles sur toutes les plateformes. Map Designer et Command Server ont une interface utilisateur pour ces commandes lorsqu'elles s'appliquent.
      - MapAudit (-A)
        La commande d'exécution MapAudit (-A) sert à contrôler la création des informations du journal d'audit.
      - Close Window (-B)
        Lors de l'exécution d'une mappe avec Command Server for Windows™ ou AS/400® OS/400®, la commande d'exécution Close Window (-B) vous servira à quitter l'application Command Server une fois la mappe terminée.
      - Century (-D)
        La commande d'exécution Century (-D) set à indiquer le début d'une plage de 100 ans, utilisée pour compléter le siècle manquant pour une Date & Time.
      - Fail on Warnings (-F)
        La commande d'exécution Fail on Warnings (-F) sert à indiquer que la mappe doit échouer si l'un des codes d'avertissement indiqués est retourné.
        Exemples d'utilisation de la commande Fail on Warnings (-F)
        Les exemples suivants illustrent l'utilisation de Fail on Warnings (-F).
      - Ignore Validation Options (-G)
        La commande d'exécution Ignore Validation Options (-G) sert à indiquer les propriétés de l'objet qui doivent être ignorées pendant la validation.
      - Input Source Override - Application (-IA)
        La commande d'exécution Input Source Override - Application (-IA) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Input Source Override - Database (-ID)
        La commande d'exécution Input Source Override - Database (-ID) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Input Source Override - Echo (-IE)
        La commande d'exécution Input Source Override - Echo (-IE) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Input Source Override - File (-IF)
        La commande d'exécution Input Source Override - File (-IF) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Input Source Override - Message (-IM)
        La commande d'exécution Input Source Override - Message (-IM) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Input Source Override - Pointer (-IP)
        La commande d'exécution Input Source Override - Pointer (-IP) est réservée aux utilisateurs de l'API de plateforme et permet de transférer des données via un pointeur et non une mémoire tampon.
      - List (-L)
        Lorsque vous utilisez Command Server sur une plateforme autre que Windows™, utilisez la commande d'exécution List (-L) pour afficher une liste de sources et de cibles de données qui sont compilées dans un fichier de mappe.
      - Initialization File Override (-N)
        Pour remplacer le fichier d'initialisation par défaut (dtx.ini) pour Command Server, utilisez l'option de commande -N comme première commande vers Command Server, selon la syntaxe suivante :
      - Output Target Override - Application (-OA)
        La commande d'exécution Output Target Override - Application (-OA) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en sortie donnée et une seule exécution de la mappe.
      - Output Target Override - Database (-OD)
        La commande d'exécution Input Source Override - Database (-OD) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Output Target Override - Echo (-OE)
        La commande d'exécution Input Source Override - Echo (-OE) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Output Target Override - File (-OF)
        La commande d'exécution Output Target Override - File (-OF) sert à remplacer les spécifications de destination de données d'une carte en sortie précise dans un fichier de mappe compilée, pour une seule exécution de la mappe.
      - Output Target Override - Message (-OM)
        La commande d'exécution Input Source Override - Message (-OM) sert à remplacer les spécifications dans un fichier de mappe compilée, pour une carte en entrée donnée et une seule exécution de la mappe.
      - Output Target Override - Pointer (-OP)
        La commande d'exécution Output Target Override - Pointer (-OP) est réservée aux utilisateurs de l'API de plateforme et permet de renvoyer des données via un pointeur et non une mémoire tampon.
      - WorkSpace PageSize (-P)
        Lorsqu'un espace de travail par fichiers est utilisé, la quantité de mémoire accessible à un moment donné dépend du nombre de pages et de la taille des pages que vous configurez pour l'exécution d'une mappe. La commande d'exécution WorkSpace PageSize (-P) sert à indiquer la taille des pages et leur nombre.
      - Refresh Status (-R)
        La commande d'exécution Refresh Status (-R) sert à indiquer la fréquence de mise à jour du statut de la mappe, lors de l'affichage dans la fenêtre Command Server sous Windows™, ou sur la console pour un autre système d'exploitation.
      - MapTrace (-T)
        La commande d'exécution MapTrace (-T) crée un fichier de trace utilisé pour diagnostiquer des données ou des définitions de types incorrectes.
      - Stop Validation (-V)
        La commande d'exécution Stop Validation (-V) indique d'arrêter la validation au niveau de la carte où est détectée la première erreur.
      - Time Zone (-TZ)
        Les 39 fuseaux horaires suivants sont identifiés ici, pour être utilisés avec la commande -TZ.
      - WorkSpace (-W)
        Lorsque vous exécutez une mappe, Command Server utilise son propre modèle de pagination pour accéder le plus efficacement possible aux informations sur les données. Des portions des données de l'espace de travail et des données réelles sont paginées de la façon requise. L'espace de travail peut associer des fichiers et la mémoire, ou n'utiliser que la mémoire. Lorsqu'un espace de travail par fichiers est utilisé, la quantité de mémoire accessible à un moment donné dépend du nombre de pages et du nombre configuré pour l'exécution de la mappe.
      - Retry (-Y)
        La commande d'exécution Retry (-Y) sert à indiquer la fréquence des nouvelles tentatives de relance pour les fichiers non basés sur des données et auxquels il est fait accès pendant l'exécution de la mappe.
      - Ignore Warnings (-Z)
        La commande d'exécution Ignore Warnings (-Z) indique pour une mappe que certains codes d'avertissement doivent être ignorés, et qu'un code retour 0 doit être émis.
    - Exemples
      La présente documentation présente divers exemples qui impliquent l'exécution de mappes en utilisant diverses commandes d'exécution dans une fonction RUN() et à partir de la ligne de commande dans les environnements UNIX™ et Windows™.
    - Commandes INI pour le débogage de mappes
      La présente documentation décrit les commandes du fichier dtx.ini (INI), utilisées pour déboguer les connexions de l'adaptateur pour les mappes exécutées à l'aide de méthodes non basées sur les événements.
  - Utility commands
    You can use the utility commands to do various functions.
- SDK
  L'interface de programmation LNK inclut des méthodes et des objets spécifiques au langage qui fournissent des fonctionnalités communes à plusieurs environnements.

Exemples d'utilisation de la commande Fail on Warnings (-F)

Les exemples suivants illustrent l'utilisation de Fail on Warnings (-F).

-F: Un message d'échec de mappe est retourné lorsque l'un des codes d'avertissement est rencontré.
-F!: Un message d'échec de mappe est retourné lorsque l'un des codes d'avertissement est rencontré.
-F18: Un message d'échec de mappe est retourné lorsqu'une Erreur de compteur d'utilisation de page (18) est rencontrée.
-F!18: A l'exception de l'Erreur de compteur d'utilisation de page (18), un message d'échec de mappe est retourné pour tous les autres codes d'avertissement.
-F18:27:28: Un message d'échec de mappe est retourné lorsque l'un des codes d'avertissement spécifiés est rencontré (18, 27 ou 28 dans ce cas).
-F34: Un message d'échec de mappe est renvoyé lorsqu'une erreur 34 (Nombre de pages demandées insuffisant, nombre de pages affectées plus élevé) se produit.

Si la commande -F est utilisée et que la mappe échoue pour la raison associée à l'avertissement spécifié, l'audit d'exécution inclut un statut de mappe d'Erreur avec le code d'avertissement approprié, précédé d'un signe moins et du message d'échec de mappe.

Par exemple :


<Summary MapStatus="Error" Return="-28">
   <ElapsedTimeInSec>0.0898</ElapsedTimeInSec>
   <Message>Input type contains errors.</Message>
   <CommandLine>'install_dir\example\ansiack\receiveEDI.mmc'
   </CommandLine>
   <ObjectsFound>0</ObjectsFound>
   <ObjectsBuilt>0</ObjectsBuilt>
</Summary>

Lorsque vous utilisez cette commande, vous ne pouvez pas indiquer le même code d'avertissement à l'aide de la commande -Z. Si vous le faites, c'est la valeur indiquée dans la dernière commande qui est utilisée. Par exemple, si votre ligne de commande contient -F18:26 -Z18:27:28, un code retour 18 (erreur de compteur d'utilisation de page) est ignoré car la commande Ignore Warnings (-Z) suit la commande Fail on Warnings (-F).

Un message d'échec de mappe est renvoyé lorsque l'un des codes d'avertissement est rencontré pour les commandes -F et -F!.

Rate this topic

5 stars 4 stars 3 stars 2 stars 1 star

Comment on this topic.

By clicking this box, you acknowledge that you are NOT a U.S. Federal Government employee or agency, nor are you submitting information with respect to or on behalf of one. HCL provides software and services to U.S. Federal Government customers through its partners immixGroup, Inc. Contact this team at https://hcltechsw.com/resources/us-government-contact. Do not include any personal data in this Comment box. Note: To report a problem or question about the product software, do not use this form. Instead, go to the HCL Software Support site.