Manuel d'administration > Installation > Nouvelle installation > Installation de l'Agent pour OS/400

Installation de l'Agent pour OS/400

Vous trouverez ici des indications pour la nouvelle installation d'un Agent OS/400.

Les instructions suivantes décrivent l'installation de l'Agent dans un système AE sans procédure d'authentification.

Si vous désirez utiliser une méthode d'authentification, vous devez effectuer certaines opérations supplémentaires avant de démarrer et d'utiliser l'Agent. Vous trouverez plus d'informations sur la Sécurisation avancée dans ce document.

Pour chaque variante OS/400 prise en charge, un code à trois caractères a été attribué. Il est présent dans le nom de fichiers de l'Agent et est également décrit dans la terminologie.

Conditions

TCP/IP

Fichiers fournis

L'Agent OS/400 est fourni sous forme de SavFile binaire. Vous trouverez le fichier dans le sous-répertoire de IMAGE:AGENTS\AS400.

Nom du fichier AE CD	Description
UCXJO41.BIN	Agent OS/400 (SavFile binaire)
Sommaire :
IRSTRJOB	Programme d'aide pour la génération de Jobs
UCXBO41C	CallAPI
UCXJO41	Agent
UCXJO41M	Programme de connexion pour l'Agent OS/400
CLLE	Fichiers source CL pour démarrer et quitter l'Agent
INI	Fichier INI
MSL	Bibliothèque de messages
TMP	Fichier texte vide
STRUCAGENT	Programme de démarrage de l'Agent
ENDUCAGENT	Programme de fermeture de l'Agent
MAKEMSL	Programme de génération de la bibliothèque de messages
COMPRESS, GSS, LIBCPPRNT	Programmes de service (bibliothèques) pour les Agents, CallAPI et le programme MAKEMSL

Les fichiers de CallAPI et leur mise en œuvre sont décrits séparément.

Déroulement

	1.	Transfert du fichier vers l'hôte

Hôte
Créez une bibliothèque temporaire pour Save-File :
CRTLIB LIB(UC4TMP)
Créez un Save-File vide.
CRTSAVF FILE(UC4TMP/UC4)
Créez une bibliothèque pour la restauration du Save-File.
CRTLIB LIB(UC4AUSL) TYPE(*PROD) TEXT('UC4 Version 11.0.0')
Ordinateur administrateur
Connectez-vous à AS/400 via FTP et transférez UCXJO41.bin dans le Save-File "UC4" bibliothèque "UC4TMP". Exemple pour FTP via la ligne de commande de Windows :
ftp <MY.AS400>
<USER>
<PASSWORD>
cd UC4TMP
bin
put UCXJO41.bin UC4
quit

	2.	Création de la bibliothèque AE

Hôte
Créez la bibliothèque AE.
RSTOBJ OBJ(*ALL) SAVLIB(UC4AUSL) DEV(*SAVF) SAVF(UC4TMP/UC4)
Supprimez la bibliothèque temporaire.
DLTLIB LIB(UC4TMP)
Renommez la bibliothèque AE.
RNMOBJ OBJ(QSYS/UC4AUSL) OBJTYPE(*LIB) NEWOBJ(UC4)

	3.	Configuration de l'environnement système

Serveur
Le système AE doit être en cours d'exécution.
Hôte
Adaptez le fichier INI AE/INI(UCXJO41).
Ordinateur administrateur ou ordinateur utilisateur
Adaptez éventuellement HEADER.OS400, TRAILER.OS400 et RESTART.OS400. Voir : Job - Exécution

Il existe ensuite 2 variantes différentes pour démarrer l'Agent. La variante 1 requiert la création d'une routine CL pour chaque agent à démarrer et est par conséquent plus complexe. La variante 2 permet de démarrer/terminer l'Agent via un programme fourni.

Variante 1

	4.	Création du programme de démarrage et de fermeture

Hôte
Dans le membre de fichier CLLE fourni existent les programmes d'exemple CL pour démarrer et quitter l'Agent. Ces derniers doivent être adaptés au système d'exploitation avant de pouvoir être compilés.
UC4/CLLE(UCEX_RUN) - démarrage de l'Agent
UC4/CLLE(UCEX_END) - fermeture de l'Agent

	5.	Démarrage/fermeture de l'Agent

Hôte
L'Agent peut être démarré à partir du programme UCEX_RUN.
Un objet Agent sera alors automatiquement créé dans le Client système 0000 et sauvegardé dans le dossier "HOST".
Le programme UCEX_END permet de terminer l'Agent correctement.
Ordinateur administrateur ou Serveur
Vérifiez que l'Agent s'est connecté.
- Démarrez l'Interface Utilisateur pour le Client 0000. Affichez les informations sur les Agents dans la Supervision Système. Comme un Agent nouvellement connecté n'est pas encore attribué à un Client, il est uniquement visible dans le Client 0000. Il est maintenant possible d'attribuer à l'Agent nouvellement installé les droits souhaités à l'aide de l'objet Agent du Client.

Variante 2

	4.	Enregistrement de la bibliothèque dans la liste des bibliothèques

Hôte
La bibliothèque (AE) dans laquelle les programmes (Agent, CallAPI,...) se trouvent, doit être enregistrée dans la liste des bibliothèques. Ceci possible avec l'une des commandes suivantes :
ADDLIBLE UC4
Ajouter une bibliothèque dans la liste de bibliothèques

ou :
CHGCURLIB UC4
Modifier la bibliothèque actuelle pour le Job sur l'Automation Engine

	5.	Démarrage/fermeture de l'Agent

Hôte
Démarrez l'Agent avec la commande STRUCAGENT.
Les exemples suivants expliquent le démarrage de l'Agent :

STRUCAGENT LIB(UC4) FILE(UC4/INI) MBR(UCXJO41)
Démarrer l'Agent à partir de la bibliothèque AE en utilisant le fichier INI UC4/INI(UCXJO41).

STRUCAGENT LIB(UC4) PATH('/user/uc4/ucxjo41.ini')
Démarrer l'Agent à partir de la bibliothèque AE, un fichier INI se trouvant dans le système de Fichiers IFS est alors indiqué.
Utilisez la commande ENDUCAGENT pour quitter l'Agent.

ENDUCAGENT LIB(UC4) OPTION(*CNTRLD)
Quitter l'Agent qui a été démarré à partir de la bibliothèque AE de manière contrôlée

ENDUCAGENT LIB(UC4) OPTION(*IMMED)
L'Agent qui a été démarré à partir de la bibliothèque AE, est abandonné avec ENDJOB.
Vous trouverez plus d'informations sur les commandes dans la Base de connaissances.