Onglet Script END_DD

Cet onglet permet de déclencher un script et d'arrêter la distribution à l'apparition d'un enregistrement de transaction (mouvement) sur un fichier donné.

L'objectif de départ est de déclencher une procédure sur la machine cible à un moment donné de l'exploitation, par exemple dès que tous les mouvements d'un lot donné sont répliqués vers la cible.

Pour ce faire, sur une machine AS/400 IBMi :

• Créez un fichier END_DD01, par exemple. Le nom du fichier doit se composer de END_DD, suivi par quatre caractères de votre choix. Le fichier END_DD01 peut être créé dans n'importe quelle bibliothèque, car la bibliothèque n'est pas attribuée. Cependant, avec les sources non AS/400 IBMi, la table doit être créée dans la base de données suivie par le modèle.

• Journalisez le fichier END_DD01 dans le même journal que les fichiers à distribuer.

• Effectuez une E/S sur le fichier END_DD01 à la fin du lot.

  Note InformationsAvertissement : Une opération de mise à jour effectue deux E/S, il est donc préférable d'exécuter une opération CLRPFM ou une autre opération, comme un ajout, par exemple.

• Dans Talend Change Data Capture, dans la configuration de la distribution sur la cible souhaitée, spécifiez END_DD01 dans le nom du fichier END_DD déclenchant le script et saisissez le script à exécuter.

Au cours de l'opération, si l'E/S dans le fichier END_DD01 est appliquée par Talend Change Data Capture pour cette paire vers la cible sélectionnée, le script est exécuté sur la cible et, à la fin du script, la distribution du modèle sur la cible est arrêtée. Si le script s'arrête à cause d'une erreur, la distribution s'arrête également avec erreur·s.

Si vous souhaitez redémarrer la distribution sur la cible sélectionnée, vous devez le faire manuellement, soit en utilisant l'onglet Supervise (Superviser), soit en utilisant la commande DDCTL AS/400 IBMi. Le Scheduler ne redémarre pas automatiquement une distribution arrêtée sur une condition END_DD.

Exemple de script sur une cible Windows

 

Exemple de script sur une cible AS/400 IBMi

Lorsque vous saisissez du texte, vous pouvez appuyer sur les touches Ctrl+Z simultanément, pour annuler votre action.

Cette propriété est utilisée pour spécifier le nom exact du fichier dont le nom commence par END_DD et qui déclenche le script.

Lorsque vous saisissez le nom de fichier dans ce champ, la fenêtre de saisie du script s'ouvre.

Utilisez cette fenêtre pour saisir le script à exécuter.

Les instructions du script dépendent du type de machine (cible) sur laquelle le script sera exécuté (AS/400 IBMi ou NT).

OnError CONTINUE
        STOP

La distribution du modèle sélectionné sur la cible s'arrête également avec erreur·s.

Vous pouvez modifier à tout moment l'action à effectuer en cas d'erreur. 

Par exemple, si vous souhaitez utiliser par défaut l'option ONERROR stop (Arrêter en cas d'erreur), mais que pour une opération de suppression d'un fichier vous souhaitez continuer même en cas d'erreur, vous pouvez saisir le code suivant :

ONERROR continue
    DELETE File
    ONERROR stop
     :
    The rest of the script

Par défaut, si une erreur survient, le script s'arrête.

/* comment line

Cette propriété est utilisée pour saisir une ligne de commentaire.

END

Le script est arrêté sans indiquer d'erreur lorsque cette instruction est rencontrée. La distribution est arrêtée. 

Sans cette instruction, la procédure de réplication continue au poste suivant.

RCONNECT IP address

Établit une connexion propriétaire à la machine AS/400 IBMi qui répond à l'adresse IP indiquée.

Vous pouvez spécifier le nom DNS de l'AS/400 IBMi s'il est reconnu par la machine NT sur laquelle le script s'exécute.

Chaque demande de connexion ferme la connexion précédente.

RMTCMD Program in parameter1 …

Cela lance la commande spécifiée dans AS/400Command (Commande AS/400) sur la machine AS/400 IBMi connectée via la commande RCONNECT. 

Ces paramètres sont ceux requis par la commande AS/400 IBMi de votre choix.

Vous pouvez utiliser toutes les commandes AS/400 IBMi, y compris CALL.

Vous pouvez utiliser toutes les commandes AS/400 IBMi avec la même syntaxe que celle utilisée dans l'invite de commande AS/400 IBMi.

Exemple :

CHGCURLIB MYLIB
CALL BIB/PGM

"c:\program files\appli\file.ext"

CREATE File

COPY SourceFile DestinationFile

MOVE SourceFile DestinationFile

DELETE File   

RENAME SourceFile DestinationFile

SHELL ProgramName parameter1 …

SHELLW ProgramName parameter1 …