Manuel d'administration > Installation > Service Pack et installation de correctif > Installation de l'Agent pour OS/400

Installation de l'agent pour OS/400

Ce document décrit la procédure d'installation du correctif pour l'agent OS/400.

Pour chaque variante OS/400 prise en charge, un code à trois caractères a été attribué. Ce code est utilisé dans le nom du fichier de l'agent et il est décrit dans la terminologie (O41 pour OS/400 version V4R1M0 et supérieure).

Terminez toujours l'agent avant de commencer l'installation d'une mise à jour.

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)
Contenu :
IRSTRJOB	Programme utilitaire pour la génération de jobs
UCXBO41C	CallAPI
UCXJO41	Agent
UCXJO41M	Programme de messagerie pour l'agent OS/400
CLLE	Fichiers source CL pour démarrer et arrêter l'agent
INI	Fichier INI
MSL	Bibliothèque de messages
TMP	Fichier texte vide
STRUCAGENT	Programme de démarrage de l'agent
ENDUCAGENT	Programme d'arrêt de l'agent
MAKEMSL	Programme de génération de la bibliothèque des 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.

Procédure

	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('Automation Engine 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

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

	3.	Configuration de l'environnement système

Hôte
Le système AE doit être en cours d'exécution.
Hôte
Adaptez le fichier INIUC4/INI(UCXJO41).

Ordinateur administrateur ou ordinateur utilisateur.
Adaptez éventuellement HEADER.OS400, TRAILER.OS400 et RESTART.OS400. Voir :Job - Exécution.

Deux méthodes différentes peuvent être utilisées pour démarrer l'agent. La variante 1 requiert la création d'une routine CL pour chaque agent à démarrer (plus complexe). La variante 2 démarre/arrête l'agent via des programmes séparés.

Méthode 1 :

	4.	Création du programme de démarrage et d'arrêt

Hôte
Des programmes d'exemple de CL pour démarrer et arrêter l'agent sont fournis dans le membre de fichier CLLE. Ces derniers doivent être adaptés au système d'exploitation avant de pouvoir être compilés.
UC4/CLLE(UCEX_RUN) : démarre l'agent
UC4/CLLE(UCEX_END) : arrête l'agent

	5.	Démarrage/arrêt de l'agent

Hôte
Vous pouvez utiliser le programme UCEX_RUN pour démarrer l'agent.
Un objet agent sera créé automatiquement dans le client système 0000 et sauvegardé dans le dossier HOST.
Le programme UCEX_END arrête l'agent.
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. Un agent nouvellement connecté n'est visible que dans le client 0000 car il n'a pas encore été attribué à un client. Via l'objet agent, vous pouvez désormais attribuer le nouvel agent incluant les droits requis aux clients spécifiés.

Variante 2

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

Hôte
La bibliothèque (UC4) qui contient les programmes (tels que l'agent ou le CallAPI) doit être enregistrée dans la liste des bibliothèques. Ceci possible avec l'une des commandes suivantes :
ADDLIBLE UC4
ajoute une bibliothèque dans la liste des bibliothèques

ou :
CHGCURLIB UC4
modifie la bibliothèque courante pour ce job sur UC4

	5.	Démarrage/arrêt de l'agent

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

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

STRUCAGENT LIB(UC4) PATH('/user/uc4/ucxjo41.ini')
Démarre l'agent à partir de la bibliothèque en utilisant un fichier INI enregistré dans le système de fichiers IFS.
La commande ENDUCAGENT arrête l'agent.

ENDUCAGENT LIB(UC4) OPTION(*CNTRLD)
Arrête l'agent qui a été démarré à partir de la bibliothèque de manière contrôlée.

ENDUCAGENT LIB(UC4) OPTION(*IMMED)
Interrompt l'agent qui a été démarré à partir de la bibliothèque, à l'aide de ENDJOB.
Vous trouverez plus d'informations sur les commandes dans la Base de connaissances.