Installer l'agent pour z/OS

Cette rubrique explique comment installer un agent dans un système AE où l'authentification n'est pas utilisée. Des étapes d'installation supplémentaires sont nécessaires avant de démarrer et d'utiliser l'agent si vous désirez utiliser l'une des méthodes d'authentification. Vous trouverez plus d'informations dans le document Authentification des agents.

Un agent démarre dans un SYSPLEX et chaque LPAR doit exécuter un moniteur d'événements. L'agent, responsable de la communication avec Automation Engine, effectue le transfert de fichiers et est connecté à tous les moniteurs d'événements. En cas de problème d'un LPAR, l'agent peut démarrer sur un autre LPAR (automatiquement avec des règles WLM, par exemple) et tous les moniteurs d'événements se reconnectent directement à l'agent.

Le moniteur d'événements surveille les événements Job, Console et Système de fichiers et les transfère à Automation Engine via l'agent.

Prérequis

JES2 ou JES3
TCP/IP V3R2M0 ou supérieure
Autorisation APF pour la bibliothèque de chargement
Bibliothèque d'exécution C, version V1R5M0 ou supérieure
Une MSGCLASS en statut HOLD qui n'appelle pas de programme ultérieur (writer externe)
Accès UPDATE pour la classe JESSPOOL RACF (afin de traiter les sorties des jobs)
Un qualificateur de fichier pour les fichiers, les logs et les traces temporaires

SMP/E

Cette rubrique décrit l'installation normale d'un agent z/OS. Notez qu'une installation SMP/E doit être effectuée par le personnel de maintenance du logiciel z/OS.

À partir de la version v12, vous devrez peut-être utiliser SMP/E par IBM, afin d'installer et gérer l'agent z/OS, CallAPI, le moniteur de jobs externes et le moniteur d'événements.
À partir de la version v12, l'agent z/OS de AE est également proposé au format Sysmod.

L'implémentation de CallAPI pour z/OS est décrite dans une rubrique distincte.

Module de chargement

CADSDEL : utilitaire qui permet de libérer un Common Dataspace (CADS) alloué par un moniteur d'événement.
UC4END : messager de fin pour la technique de messages SMF (écrit une liste d'étapes et les codes retour dans JESMSGLG)
UC4RESTR : messager de reprise pour la technique de messages SMF (pseudo-programme, comme IEFBR14)
UC4START : messager de démarrage pour la technique de messages SMF (pseudo-programme, comme IEFBR14)

Installer l'agent pour z/OS

Transférez les fichiers vers l'hôte. Sur l'hôte, transférez les fichiers appropriés à partir de IMAGE:AGENTS\MVS\ via un transfert de fichier. Par exemple :

Hôte ouvert

Utilisez un utilisateur FTP avec les droits appropriés

Nom d'utilisateur : UC4

Mot de passe : <comme défini>
bin
quote site recfm=fb lrecl=80 blksize=6080
quote site pri=1 sec=1 CY
put UCXJM25-???.bin 'UC4.UCXJX.WORK'
asci
quote site lrecl=500 blksize=27500
put UCXJM25.ini 'UC4.UCXJM25.INI'
put UCXEM25.ini 'UC4.UCXEM25.INI'
quote site recfm=vb lrecl=500 blksize=27998
put ucx.msl 'UC4.UC.MSL'
quit
Sur l'hôte, créez la bibliothèque de chargement à l'aide de l'utilitaire TSO RECEIVE. Les paramètres en caractères gras sont des données spécifiques au système.
//UC4LOAD JOB (ACCT#),'UC4USER',
// CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=UC4USER
//*************************************************
//STEP01 EXEC PGM=IKJEFT01,DYNAMNBR=30
//SYSPRINT DD SYSOUT=*
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *
  PROFILE NOPREFIXRECEIVE USERID(UC4USER)INDSN ('UC4.UCXJX.WORK')
DSNAME('UC4.UCXJM25.LOAD') -
  RECEIVE USERID(UC4USER) INDSN('MYDSN.UCXJ.WORK')
  DSNAME('UC4.UCXJM25.LOAD') -
  UNIT(3390) VOLUME(??????)
/*

Alternately, you can create it as follows:

On the z/OS host:
TSO RECEIVE indsn('UC4.UCXJX.WORK')
Press Enter and type the following line:
dsname('UC4.UCXJM25.LOAD')
L'autorisation APF est requise pour la bibliothèque de chargement. Celle-ci doit être attribuée ou peut être ajoutée dynamiquement sur la console système avec la commande suivante sur l'hôte :
SETPROG APF,ADD,DSN=UC4.UCXJM25.LOAD, [SMS] [VOLUME=xxx]
Créez la tâche démarrée pour l'agent.
- Utilisateurs, groupes et ensemble de données
  L'utilisateur avec lequel l'agent s'exécute doit posséder les droits correspondants sur les jeux de données via la définition de l'utilisateur ou du groupe. Utilisez les profils des ensembles de données pour attribuer les droits correspondants.
  Le droit Alter est requis pour le qualificateur du jeu de données AE.
  Remarque : L'agent a besoin des droits sur tous les jeux de données qu'il utilise.
- Segment OMVS (autorisation TCP/IP)
  Avertissement ! Assurez-vous que les droits OMVS de l'utilisateur et du groupe par défaut sont définis.
- Ressource générale
  D'habitude, une ressource générale est disponible pour les tâches démarrées (STC). Les droits standards y sont attribués pour que l'agent puisse fonctionner comme STC. Vous pouvez aussi définir l'utilisateur qui doit être utilisé pour exécuter l'agent (STDATA).
- Paramètres RACF nécessaires pour les transferts de fichiers lorsque le système de fichier USS est utilisé :
  - Classe FACILITY profil BPX.DAEMON avec UACC(READ)
  - de la classe PROGRAM profil * MEMBER(loadlib//NOPADCHK)
- Paramètres RACF recommandés pour utiliser le paramètre de fichier INI ft_thread_level_security=
- L'utilisateur STC ou un autre utilisateur peut être utilisé pour le démarrage des jobs AE ou du transfert de fichier.
  
  Utilisation de l'utilisateur STC pour l'ensemble de l'exécution :
  
  L'utilisateur STC doit avoir accès à toutes les ressources z/OS utilisées dans les jobs et les transferts de fichiers. Cet utilisateur doit également être spécifié dans l'objet Login utilisé. Les utilisateurs sans mot de passe (utilisateurs batch) doivent être spécifiés dans l'objet Login sans mot de passe. Le paramètre askRACF dans le fichier INI de l'agent doit être défini à "0" ou "4" pour désactiver la vérification du mot de passe.
  
  Utilisation de différents utilisateurs :
  
  Un segment OMVS approprié doit être défini pour tous les utilisateurs en plus des ressources nécessaires afin d'établir la connexion TCP/IP au Automation Engine. L'objet LOGIN souhaité est indiqué dans les attributs du job. Si un utilisateur batch (sans mot de passe) est utilisé pour l'exécution, l'utilisateur STC a besoin d'une autorisation Surrogate pour cet utilisateur particulier. Dans ce cas, spécifez l'utilisateur souhaité sans mot de passe dans l'objet Login et désactivez la vérification du mot de passe (dans le fichier INI de l'agent, le paramètre askRACF doit être défini à "0" ou à "4").
- Exemple de Started Task :
  //UC4RUN PROC
  //UCEX EXEC PGM=UCXJM25,PARM='TRAP(OFF),HEAP(4M,4M,ANY,FREE)/UC4.UCXJM25.INI',
  // REGION=4M,TIME=1440
  //STEPLIB DD DISP=SHR,DSN=UC4.UCXJM25.LOAD
  //SSTORE DD DISP=SHR,DSN=UC4.UCXJM25.SSTORE
  //SYSPRINT DD SYSOUT=*
  //STDOUT DD SYSOUT=*
  //SYSCPRT DD SYSOUT=*
  //JOBOUT DD SYSOUT=(A,INTRDR)
  //SYSUDUMP DD SYSOUT=*
  //*
- La Started Task doit être autorisée à lire les listes JES.
- Les fichiers suivants doivent aussi être inclus dans la chaîne de liens :
  
  CEE.V1R5M0.SCEERUN : (Language Environment dynamic runtime library)
  CEE.V1R5M0.SCEELKED : (Language Environment linkage editor library)
  TCPIP.V3R1.SEZACMTX : (TCP/IP runtime library)
  
  Avertissement ! Il existe une solution alternative si vous ne voulez pas interférer avec votre système comme décrit ci-dessus. Vous pouvez inscrire la bibliothèque LOAD dans la STEPLIB, mais aussi dans la carte DD EDCMTF de l'environnement C. De plus amples informations sont disponibles dans la documentation IBM - Instruction STEPLIB DD.
- Appliquez les étapes suivantes si MVS ou le Language Environment Resolver ne fonctionnent pas correctement :
  
  Les instructions DD doivent être incluses dans la tâche démarrée. Sinon, l'agent ne peut pas établir de connexion TCP/IP.
  
  Exemple :
  //SYSTCPD DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20OEDA),DISP=SHR
  //PROFILE DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20VIPA),DISP=SHR
  
  Les instructions complètes se trouvent dans la tâche démarrée TCP/IP.
  
  Avertissement ! Les instructions DD pour TCP/IP doivent aussi être inclues dans l'objet Include Include MVS.JOBMD_DEFINITIONS. Sinon, le messager de job ne pourra pas ouvrir de connexion TCP/IP et les jobs prendront le statut ENDED_VANISHED.
- Copiez la procédure UC4RUN dans une bibliothèque de procédures, par exemple SYS1.PROCLIB.
- Autorisations nécessaires pour l'utilisateur STC dans RACF :
- Générer les jeux de données pour le StatusStore
  
  Exemple :
  
  //CREATESS EXEC PGM=IDCAMS
  //SYSPRINT DD SYSOUT=*
  //SYSIN DD *
    DEFINE -
    CLUSTER ( -
    NAME(UC4.UCXJM25.SSTORE) -
    INDEXED -
    VOLUMES(volume) -
    CYLINDERS(10 5) -
    ) -
    DATA ( -
    NAME(UC4.UCXJM25.SSTORE.DATA) -
     KEYS(16 0) -
     RECORDSIZE(256 4096) -
    FREESPACE(10 10) -
     ) -
    INDEX ( -
    NAME(UC4.UCXJM25.SSTORE.INDEX) -
  )
  //* Charger un enregistrement bidon
  //DUMMYREC EXEC PGM=IDCAMS
  //SYSPRINT DD SYSOUT=*
  //OUT1 DD DISP=SHR,DSN=UC4.UCXJM25.SSTORE
  //SYSIN DD *
  REPRO INFILE(IN1) OFILE(OUT1)
  /*
  //IN1 DD *
  DUMMY
  /*
Les informations de tranfert pour chaque ensemble de données/fichier sont stockées en tant qu'enregistrement dans l'ensemble de données VSAM. La taille de l'enregistrement des informations varie en fonction de la taille de l'ensemble des données et des fichiers. 260 octets est une taille moyenne. Les valeurs d'espace suggérées sont 10,5 cylindres = (10 + 15 * 5) * 849,960 octets ~ 75.553 kilooctets, qui devrait être suffisant pour environ 282K entrés de transfert.
L'agent s'exécute sur l'hôte en tant que Started Task. Les fichiers fournis incluent un exemple de JCL. Copiez ce JCL dans une bibliothèque de procédures et spécifiez le nom du fichier INI et de la bibliothèque de chargement. L'utilisateur STC requiert aussi les autorisations suivantes :
Configuration de l'environnement système.
- Hôte
- Adaptez le fichier INI. Le fichier INI de l'Agent z/OS ne doit pas utiliser l'attribut de fichier NUMBER ON.
- Modifiez éventuellement HEADER.MVS, TRAILER.MVS et RESTART.MVS. Voir : Exécuter des jobs.
Démarrez l'agent.
- Sur l'ordinateur du serveur, le système AE (voir Fonctionnement multi-serveurs pour plus d'informations) doit être en cours d'exécution.
- Sur l'hôte, démarrez à l'aide de start UC4RUN via la console système.
  Un objet agent est créé automatiquement dans le client système 0000 et il est enregistré dans le dossier "HOST".
- Sur l'ordinateur administrateur ou serveur, vérifiez que l'agent s'est connecté. Démarrez l'AWI pour le client 0000. Reportez-vous à la Perspective Administration pour afficher des informations sur les agents. Comme un agent nouvellement connecté n'est pas encore attribué à un client, il est uniquement visible dans le client 0000. Le nouvel agent peut désormais être affecté aux clients avec les droits requis que vous avez définis à la Page Autorisations de l'objet Agent.
Sur l'hôte, quittez la tâche démarrée de l'agent via la console système, en utilisant une commande MODIFY (telle que modify UC4RUN,end). Vous pouvez également utiliser la commande d'arrêt stop UC4RUN. La commande Modify UC4RUN,shutdown peut être utilisée pour arrêter l'agent et tous les moniteurs d'événements connectés.
Le moniteur d'événements comme Started Task autonome.
1. Pour adapter le fichier INI, voir : z/OS Event Monitor
2. Créez un jeu de données INI distinct pour chaque LPAR UC4.UCXEM25.INI -> UC4.UCXEM25.INI.SYSID
  - Créez la tâche Automation Engine démarrée pour le moniteur d'événement. Par exemple :
  - Créez le jeu de données UCEVENT pour chaque LPAR. Par exemple :
  - Démarrez le moniteur d'événement avec start UC4EMRUN.
  - Arrêtez le moniteur d'événements avec la commande Modify UC4EMRUN,end (qui arrête le STC, mais laisse l'exit SMF actif : tous les enregistrements SMF manqués seront traités au prochain démarrage du moniteur d'événements) ou la commande Modify UC4EMRUN,shutdown/modify UC4EMRUN,end (arrêt du STC et de l'exit SMF).