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

Installation de l'agent pour z/OS

Vous trouverez ici des indications pour la nouvelle installation d'un agent z/OS.

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écurité avancée dans ce document.

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

Fichiers fournis

Les fichiers suivants sont disponibles dans le répertoire IMAGE:AGENTS\MVS.

Nom du fichier AE CD	Description	Nom de fichier z/OS
UCXJM25-IBM.BIN	Agent z/OS Créé avec l'utilitaire TSO TRANSFER	UC4.UCXJM25.LOAD
UCXJM25.INI	Fichier INI de l'agent z/OS	UC4.UCXJM25.INI
UCXEM25.INI	Fichier INI du moniteur d'événements	UC4.UCXEM25.INI
UCX.MSL	Bibliothèque de messages	UC4.UC.MSL
STC25.TXT	JCL pour la Started Task
UC4JCLE.ASM	Module d'exemple pour l'Exit JCL.
UC4EJM.INI	Fichier INI du moniteur de job externe.

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

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)

Procédure

	1.	Transfert des fichiers vers l'hôte

Hôte
Transférez les fichiers appropriés à partir de IMAGE:AGENTS\MVS\ via un transfert de fichier.

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
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

	2.	Création de la bibliothèque de chargement

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 NOPREFIX
  RECEIVE USERID(UC4USER) INDSN('MYDSN.UCXJ.WORK')
  DSNAME('UC4.UCXJM25.LOAD') -
  UNIT(3390) VOLUME(??????)
/*

Il est également possible d'utiliser la méthode suivante :

Sur l'hôte z/OS:
TSO RECEIVE indsn ('MYDSN.UCXJ.WORK')
Appuyez sur la touche Entrée et saisissez la ligne de commande suivante :
dsname('UC4.UCXJM25.LOAD')

	3.	Autorisation APF pour la bibliothèque de chargement

Hôte
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 :

SETPROG APF,ADD,DSN=UC4.UCXJM25.LOAD,[SMS] [VOLUME=xxx]

	4.	Créer la Started Task pour l'agent

Hôte

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 :

Profil 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 de l'ensemble des données AE.
Notez que l'agent a besoin des droits sur tous les jeux de données qu'il utilise.

Segment OMVS (autorisation TCP/IP)
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)

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
//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)

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. Vous trouverez de plus amples informations dans la documentation IBM sous l'instruction DD STEPLIB.
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.

Les instructions DD pour TCP/IP doivent être inscrites dans l'objet Include MVS.JOBMD_DEFINITIONS. Sinon 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 :

Segment OMVS
Autorisation ALTER pour les jeux de données propres (par exemple : UC4.*)
La Started Task requiert les autorisations appropriées pour lire les listes JES

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) -
)
//* Charge un pseudo-enregistrement
//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
/* Transfert des informations pour chaque ensemble de données/fichier stocké en tant qu'enregistrement dans l'ensemble de données VSAM. La taille de l'enregistrement d'information varie en fonction de la taille de l'ensemble de 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.

	5.	Configuration de l'environnement système

Hôte
Adaptez le fichier INI. Le fichier INI ne doit pas utiliser l'attribut de fichier NUMBER ON.
Adaptez éventuellement HEADER.MVS, TRAILER.MVS et RESTART.MVS. Voir : Job - Exécution

	6.	Démarrage de l'agent

Serveur
Le système AE doit être en cours d'exécution.
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.
Ordinateur administrateur ou Serveur
Vérifiez que l'agent s'est connecté.
- Démarrez l'interface utilisateur pour le client 0000. Reportez-vous à la supervision système 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 maintenant être assigné aux clients avec les droits requis via l'objet agent.

	7.	Arrêt de l'agent

Hôte
Terminez la Started Task de l'agent via la console système à l'aide d'une commande MODIFY (par exemple avec modify UC4RUN,end). Vous pouvez également utiliser la commande d'arrêt stop UC4RUN.

	8.	Le moniteur d'événements comme Started Task autonome

Adaptez le fichier INI.
Créez la tâche AE démarrée pour le moniteur d'événement.

Exemple :

//UC4EMRUN PROC
//EVENTM EXEC PGM=UCXEM25,REGION=0M,
//    PARM='TRAP(OFF),HEAP(4M,4M,ANY,FREE)/UC4.UCXJM25.EM.INI'
//STEPLIB   DD DISP=SHR,DSN=UC4.UCXJM25.LOADLIB
//SYSPRINT DD SYSOUT=*
//UCEVENT   DD DISP=SHR,DSN=UC4.UCEVENT.VSAM
//UCFILTER DD DISP=SHR,DSN=UC4.UCFILTER

Créez les jeux de données (UCFILTER et UCEVENT).

Exemple :

//CRTEMDS JOB ####,'XXX',NOTIFY=&SYSUID,MSGLEVEL=(1,1)
//* Créer des ensembles de données pour moniteur d'événements UC4
//UCFILTER EXEC PGM=IEFBR14
//UCFILTER DD DISP=(NEW,CATLG,CATLG),DSN=UC4.UCFILTER,
//        RECFM=VB,LRECL=1024,BLKSIZE=8192,SPACE=(CYL,(1,1))
//UCEVENT EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
  DEFINE -
  CLUSTER ( -
  NAME(UC4.UCEVENT.VSAM) -
  INDEXED -
  VOLUMES(DSK30D) -
  TRACKS(1 1) -
  ) -
  DATA ( -
  NAME(UC4.UCEVENT.VSAM.DATA) -
  KEYS(20 0) -
  RECORDSIZE(1024 1024) -
  FREESPACE(10 5) -
  ) -
  INDEX ( -
  NAME(UC4.UCEVENT.VSAM.INDEX) -
  )
/*

Initialisez les jeux de données

Exemple :

//INITEMDS JOB ####,'XXX',NOTIFY=&SYSUID,MSGLEVEL=(1,1)
//INITVSAM EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//OUT1 DD DISP=SHR,DSN=UC4.UCEVENT.VSAM
//SYSIN DD *
REPRO INFILE(IN1) OFILE(OUT1)
//IN1 DD *
DUMMY
/*

Démarrez le moniteur d'événement avec start UC4EMRUN
Arrêtez le moniteur d'événement avec modify UC4EMRUN,end
Notez que l'autorisation RACF est nécessaire pour l'exécution du moniteur d'événements lorsque la console étendue MVS est protégée.

	9.	Le moniteur externe de Job comme Started Task autonome

Ajustez le fichier INI.
Créez la tâche AE démarrée pour le moniteur de job externe.

Exemple :

//UC4EJM PROC
//UCZEJM EXEC PGM=UC4EJM,PARM='TRAP(OFF)/ ZUC800A1.EJM.INI',REGION=0M
//STEPLIB DD DISP=SHR,DSN=UC800A.LOADLIB
//SYSPRINT DD SYSOUT=*
//STDOUT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
Démarrez le moniteur externe de job avec start UC4EJM
Arrêtez le moniteur externe de job avec modify UC4EJM,end

Rubriques connexes :

Agent - Interaction entre Automation Engine et z/OS
Exit SMF
Moniteur d'événements
Evénement de système de fichiers automatique
Moniteur de job externe