Base de connaissances > Automation Engine et systèmes cibles > NSK > Agent - Combinant AE et NSK

Agent - Interaction entre l'Automation Engine et NSK

L'Agent NSK interagit avec le système AE via une interface TCP/IP.

L'Agent NSK dispose des fonctionnalités suivantes :

traitement de Jobs,
exécution de Transferts de Fichiers,
CallAPI

Traitement de Jobs

Dans l'Automation Engine, les Jobs sont définis et gérés comme des objets à l'aide d'onglets. Les commandes et instructions sont définies dans l'onglet Script. Ils peuvent être munis d'une logique complexe à l'aide de scripts de l'Automation Engine.
Rubriques connexes : Manuel Utilisateur – Job et Job – Exécution.

Les Jobs NSK s'organisent en plusieurs sous-types en fonction du type de commande (Guardian, NetBatch et OSS).

Un Job est démarré dans l'Automation Engine à l'aide de mécanismes de contrôle comme les Workflows ou les Schedules, ou encore manuellement. Un Job exécutable est alors généré dans Le Automation Engine et transféré à l'Agent NSK par Transfert de Fichier.
Rubriques connexes : Interne AE – Exécution des objets

Les Jobs sont exécutés avec les informations logiques (nom de Groupe.nom Utilisateur) qui ont été indiquées dans l'objet Login que vous avez sélectionné dans l'onglet Attributs.

Le tableau indique à quel moment il est nécessaire de définir des mots de passe dans l'objet Login.

ID Utilisateur de l'Agent	Entrée dans l'objet Login
GROUP.USER	Mot de passe requis lorsque le Job fonctionne avec un autre nom de Groupe.nom Utilisateur.
GROUP.255	Mot de passe requis lorsque le Job fonctionne avec un autre nom de Groupe.
255.255	Aucun mot de passe requis.

Configuration recommandée:

Lancer l'Agent NSK avec l'ID Utilisateur. SUPER.SUPER n'est généralement pas requis. L'Utilisateur approprié doit être associé aux exigences de fonctionnement.
Définir le nom de Groupe.nom Utilisateur dans les objets Login.
Définir le paramètre logon=1 dans le fichier INI de l'Agent NSK.
Définir l'Utilisateur par défaut ERP_LOGIN dans le Client 0000. Il s'agit alors de l'Utilisateur standard. Vous devez utiliser une combinaison ID Utilisateur/mot de passe valide. Un Utilisateur avec très peu de droits doit pourtant pouvoir accéder à l'application. Cet Utilisateur dispose uniquement de la fonction de reprise des processus TACL planifiés avec très peu de droits (et ainsi un risque d'erreur limité).

Le Job annonce à l'Agent le début et la fin de l'exécution, lequel transmet à son tour ces informations au Automation Engine. Le Code Retour du Job est disponible dans l'Automation Engine, ce qui peut être réalisé par le biais de l'en-tête et du pied de page.

Le contenu de l'en-tête et du pied de page est ajouté automatiquement au script défini pour le Job. La Variable "RETCODE" est définie dans l'en-tête propre à NSK. Le contenu de cette Variable est transmis au Automation Engine à la fin du Job. Cette valeur est le Code Retour du Job. Elle peut servir à définir les dépendances entre les différents Jobs dans un Workflow.

Pour configurer le paramètre "RETCODE" sur "1" par exemple, lorsqu'une erreur de syntaxe survient dans le script, il est possible d'utiliser les en-têtes et pieds de page suivants définis par l'utilisateur: HEADER.NSK.USER.HEAD, TRAILER.NSK.USER.HEAD et RESTART.NSK

L'Agent crée des fichiers automatiquement sur l'ordinateur pour les rapports de Jobs (si cette option est activée pour l'objet) et les Jobs. Leur désignation est formée comme suit :

	Désignation
Fichier de Job	<UC_EX_PATH_TEMP>J<RunID>
Fichier de rapport de Job	<UC_EX_PATH_JOBREPORT>O<RunID>

Pour UC_EX_PATH_TEMP et UC_EX_PATH_JOBREPORT, il s'agit de Variables d'Agent. Le RunID est représenté sous forme de séquence comportant 7 à 10 caractères. Vous pouvez spécifier cette séquence lors de la recherche de statistique et également la convertir avec la fonction de script ALPHA2RUNNR pour obtenir le chiffre correspondant.

Exécution de Transferts de Fichiers

Dans l'Automation Engine, les Transferts de Fichiers sont définis et gérés comme des objets à l'aide d'onglets. Ils sont exécutés avec la conversion de caractères qui y figure, par exemple "UC_CODE".

Particularités: l'Agent NSK développe chaque ordre de Transfert de Fichiers via un processus qui lui est propre lorsque le nouveau protocole de Transfert de Fichiers est utilisé. Pour activer cette fonctionnalité, l'Agent dispose d'un port d'écoute supplémentaire doté du numéro suivant le plus élevé par rapport au port de l'Agent.

Il est également possible d'indiquer des attributs supplémentaires dans l'objet Transfert de Fichier pour le fichier cible (objectifs – attributs) ou de reprendre les attributs du fichier source (option "Conserver les attributs originaux de fichier"). Vous pouvez également remplacer les attributs originaux par des indications supplémentaires dans l'objet Transfert de Fichier. Les attributs de fichiers NSK suivants sont pris en charge:

Attribut	Description
CREATE_OPTS	Options de création de fichier, masque de bits (<15> est le bit le plus petit d'un mot de 2 octets): <10> Refresh EOF – Le libellé de fichier est immédiatement écrit sur le disque dur <11> Index compression – Comprimer des entrées dans un bloc d'index à partir de fichiers séquencés par clés. La valeur 0 doit être utilisée pour d'autres types de fichiers <12> Data compression – Comprimer la clé des entrées des blocs de données à partir des fichiers séquencés par clés. Valeur 0 pour d'autres types de fichiers. <13> Audit compression – Comprimer les données de contrôle des fichiers vérifiés (fichiers audités). <14> Audited – Vérification du fichier dans le sous-système Transaction Management Facility (TMF). Cette option doit être configurée sur 0 pour les systèmes ne disposant pas du sous-système TMF. <15> Odd unstructured – Nombre de transferts E/S de fichiers non structurés. Si cette option n'est pas activée, les Transferts sont arrondis à une limite d'octets précise. Cette option doit être configurée sur 0 pour les autres types de fichiers.
File format	Cet attribut est automatiquement défini en fonction de la taille actuelle du fichier 1 – pour les fichiers inférieurs à 2Go, 2 – tous les autres fichiers
FILECODE	Non pertinent lorsque les transferts ne concernent que des fichiers textes et des fichiers binaires
FILETYPE	0 – non structuré 1 – relatif 2 – séquencé par entrée 3 – séquencé par clé Non pertinent lorsque les transferts ne concernent que des fichiers textes et des fichiers binaires
KEY_LEN	Non pertinent lorsque les transferts ne concernent que des fichiers textes et des fichiers binaires
KEY_OFFS	Non pertinent lorsque les transferts ne concernent que des fichiers textes et des fichiers binaires
MAXEXT	Nombre maximum d'extensions pour le fichier.
PEXT	Nombre de pages 2k pour l'extension primaire
RECLEN	Non pertinent lorsque les transferts ne concernent que des fichiers textes et des fichiers binaires
SEXT	Nombre de pages 2k pour les extensions secondaires

Voir : Manuel de l'utilisateur – Transfert de Fichier

CallAPI

Il permet d'exécuter des programmes dans l'Automation Engine à partir de programmes tiers. Le CallAPI peut être utilisé sans programmation préalable grâce à un utilitaire appelable par exemple à partir de la ligne de commande du système d'exploitation, d'un script ou d'un Job.

Rubriques connexes :

Manuel de l'utilisateur – CallAPI
Interne AE – Architecture de l'agent AE pour HP NonStop Server