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

Installation de l'agent pour z/OS

Ce document décrit ma procédure d'installation du correctif pour d'un agent z/OS.

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

Prérequis

JES2 ou JES3
TCP/IP V3R2M0 ou supérieure
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)

Fichiers fournis

Les fichiers suivants se trouvent dans le répertoire MAGE:AGENTS\MVS\ZSERIES:

Nom du fichier AE CD	Description	Nom de fichier z/OS
UCX.MSL	Bibliothèque de messages	UC4.UC.MSL
ucxjm25-ibm.bin	Agent z/OS Créé avec l'utilitaire TSO TRANSFER	UC4.UCXJM25.LOAD
ucxbm25c.ini ucxem25.ini Ucxjm25.ini	Fichiers INI.	UC4.UCXJM25.INI
stc25.txt	JCL for the started task.
uc4jcle.asm	Module d'exemple pour l'Exit JCL.

Les fichiers suivants se trouvent dans le répertoire IMAGE:AGENTS\MVS\ZSERIES\EXAMPLE:

Nom du fichier AE CD	Description
stc25.txt	JCL for the started task.
uc4jcle.asm	Module d'exemple pour l'Exit JCL.

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)

Déroulement

	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.UCXJM25.BIN'
asci
put UCXJM25.ini 'UC4.UCXJM25.INI'
quote site recfm=vb lrecl=500 blksize=27998
put ucx.msl 'UC4.UC.MSL'

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

Hôte
Créez la bibliothèque LOAD à 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('UC4.UCXJM25.BIN')
  DSNAME('UC4.UCXJM25.LOAD') -
  UNIT(3390) VOLUME(??????)
/*

Elle peut aussi être créée comme suit :

Dans l'hôte z/OS :
TSO RECEIVE indsn('UC4.UCXJM25.BIN')
Appuyez sur la touche Entrée et saisissez la ligne suivante :
dsname('UC4.UCXJM25.LOAD')

	3.	Création de la Started Task AE

Hôte
Les bibliothèques STEPLIB nécessitent une autorisation APF.
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=*
//*
Les fichiers suivants doivent être inclus dans la chaîne de liens :

CEE.V1R5M0.SCEERUN
CEE.V1R5M0.SCEELKED
TCPIP.V3R1.SEZACMTX

Il existe une solution alternative si vous ne voulez pas configurer votre système comme décrit ci-dessus. Vous pouvez inscrire la bibliothèque AE 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'instructions DD STEPLIB.
Appliquez les étapes suivantes si MVS ou le Language Environment Resolver ne fonctionnent pas correctement

Les instructions DD pour TCP/IP doivent être inscrites dans la Started Task pour que l'agent puisse établir une connexion TCP/IP.

Exemple :
//SYSTCPD DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20OEDA),DISP=SHR
//PROFILE DD DSN=TCPIP.SYSTSMS.TCPPARMS(DT20VIPA),DISP=SHR

Les instructions exactes sont écrites dans la Started Task de TCP/IP.
Les instructions DD pour TCP/IP doivent être inscrites dans l'objet 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 :

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

Création de 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
/*

	4.	Configuration de l'environnement système

Hôte
Si recommandé par les notes de mise à jour courantes, adaptez le fichier INI. Reportez-vous aussi au fichier INI UCXJ???.ORI.INI fourni avec l'installation de mise à jour. Le fichier INI ne doit pas utiliser l'attribut de fichier NUMBER ON.

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