5 Exécution de tâches de postinstallation sur d'autres logiciels ELS

Ce chapitre décrit les tâches de postinstallation des logiciels pour mainframe supplémentaires inclus dans le package ELS. Il inclut les rubriques suivantes :

Avant de continuer, vérifiez que vous avez effectué les tâches d'installation décrites à la section Chapitre 2, Installation d'ELS et de logiciels supplémentaires..

Tâches de postinstallation LCM

Cette section décrit les tâches de postinstallation LCM requises. Il inclut les rubriques suivantes :

Autorisation de la bibliothèque de chargement LCM

LCM doit être exécuté en tant que programme autorisé dans MVS. De ce fait, vous devez effectuer les étapes suivantes pour autoriser la bibliothèque de chargement LCM via APF :

  1. Ajoutez la bibliothèque de chargement LCM au membre IEAAPFzz ou PROGzz de SYS1.PARMLIB.

  2. Exécutez les commandes décrites dans la section Autorisation de la bibliothèque de chargement LCM pour autoriser la bibliothèque de chargement.

Ajout de la bibliothèque de chargement LCM au membre IEAAPFzz

Ajoutez l'entrée suivante au membre IEAAPFzz pour autoriser la bibliothèque de chargement LCM :

votre.LCMLINK volser,

Avant d'ajouter cette entrée à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Si plusieurs entrées sont présentes dans le membre IEAAPFzz, chaque entrée (sauf la dernière) doit finir par une virgule pour indiquer la continuation. Omettez la virgule dans la dernière entrée.

Remarque :

Si la bibliothèque de chargement LCM est située sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, ne spécifiez pas le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

Ajout de la bibliothèque de chargement LCM au membre PROGzz

Ajoutez l'entrée suivante au membre PROGzz pour autoriser la bibliothèque de chargement LCM :

APF ADD
    DSNAME(your.LCMLINK)
    VOLUME(volser) | SMS

Avant d'ajouter cette entrée à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Remarque :

Si la bibliothèque de chargement LCM est située sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, spécifiez le SMS littéral après le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

Autorisation de la bibliothèque de chargement LCM

L'ajout d'une entrée aux membres IEAAPFzz et PROGzz est nécessaire pour autoriser la bibliothèque en cas d'IPL. Dans le même temps, autorisez la bibliothèque de manière dynamique sur votre système en cours d'exécution en émettant l'une des commandes système MVS suivantes :

Si la bibliothèque est gérée par SMS :

SETPROG APF,ADD,DSN=your.LCMLINK,SMS

Si la bibliothèque n'est pas gérée par SMS :

SETPROG APF,ADD,DSN=your.LCMLINK,volser

Modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Exclusion des CDS HSC d'EDI

Si vous utilisez la fonction Enhanced Data Integrity (EDI) d'un système z/OS 1.5 ou version ultérieure, toutes les copies des CDS HSC doivent être exclues du traitement par la fonction EDI. Pour plus d'informations, reportez-vous à la section DFSMS : Utilisation des jeux de données pour connaître la/les versions(s) ou le système z/OS installés permettant des entrées appropriées dans le membre PARMLIB IFGPSEDI.

Vérification de l'installation de LCM

Vous pouvez personnaliser le membre LCMRUN de SAMPLIB LCM et l'exécuter afin de vérifier l'installation LCM. LCMRUN exécute LCM avec l'option CHECK, ce qui empêche LCM d'apporter des modifications au LSM, à la base de données HSC ou au fichiers du système de gestion des bandes. Pour plus d'informations sur l'option CHECK, reportez-vous au manuel LCM User’s Guide. LCMRUN s'exécute avec les techniques de gestion et les rapports par défaut de LCM.

Avant d'appeler LCMRUN, modifiez la tâche comme suit :

  • Fournissez le nom du jeu de données du catalogue de gestion des bandes (TMC) ou du fichier maître du volume (VMF) de votre système.

  • Assurez-vous que les noms du jeu de données de l'instruction STEPLIB DD pour LCM et HSC sont adaptés à votre système.

  • Fournissez le nom du fichier de paramètres à utiliser pour la vérification. Sélectionnez le fichier de paramètres de vérification approprié à partir du membre SAMPLIB fourni, comme décrit dans le Tableau 5-1.

Remarque :

Pour un fonctionnement efficace, il est recommandé d'allouer une zone d'au moins 32 Mo. Certains environnements plus volumineux peuvent nécessiter de spécifier une taille supérieure.

Tableau 5-1 Fichiers de paramètres du membre SAMPLIB

Système de gestion des bandes Membre SAMPLIB

CA-1

LCMVCA1

CA-TLMS

LCMVTLMS

DFSMSrmm

LCMVRMM

TMS CUSTOM

LCMVCUST

TMS COMMON

LCMVCOMM

aucun

LCMVNTMS


Installation et configuration de l'agent LCM (facultatif)

Cette section indique comment installer et configurer l'agent LCM. L'agent LCM est une tâche MVS permettant d'accéder aux informations TMS à partir de plusieurs hôtes MVS sans périphérique de stockage d'accès direct (DASD) partagé. Le programme LCM de base est exécuté sur le même hôte MVS que HSC. Il utilise TCP/IP pour communiquer avec un agent LCM sur chaque hôte. Chaque instance d'un agent LCM fonctionne comme une tâche démarrée sur l'hôte MVS auquel elle est rattachée.

Installez la base LCM comme décrit dans ce guide avant d'installer et de configurer l'agent LCM. Reportez-vous au manuel LCM User’s Guide pour plus d'informations sur les commandes de l'agent LCM.

Mise en garde :

L'hôte qui exécute la tâche par lots LCM doit disposer de la même version que les hôtes qui exécutent l'agent LCM. L'agent LCM situé sur des hôtes où LCM 4.0 est installé est incompatible avec les tâches par lot exécutées sur des hôtes équipés de LCM 5.0.0 ou version supérieure.

Pour installer et configurer l'agent LCM :

  1. Pour les serveurs eNetwork Communications Server sur OS/390 version V2R6 ou ultérieure, assurez-vous que le système de fichiers root OpenEdition est installé.

    L'agent LCM requiert que le fichier root OpenEdition soit installé avec l'ensemble de ses fonctionnalités. Reportez-vous au manuel Guide de planification OpenEdition d'IBM pour plus d'informations sur la création d'un fichier root HFS, la modification du membre PARMLIB BPXPRMxx et la création de répertoires de système de fichiers root.

  2. Créez le jeu de données des codes d'accès de l'agent LCM en personnalisant le membre SAMPLIB LCMCODES.

    Vérifiez que le jeu de données des codes d'accès spécifie une liste d'hôtes autorisés à récupérer des informations pour chaque code d'accès défini. Une fois le jeu de données des codes d'accès de l'agent LCM créés, remplissez-le de données sous forme d'une chaîne de caractères aléatoires qui seront utilisés pour les codes d'accès. Vérifiez également que le jeu de données des codes d'accès spécifie une liste d'hôtes autorisés à récupérer des informations pour chaque code d'accès défini. Une copie exacte de ce jeu de données doit exister à la fois sur l'hôte de l'agent LCM et sur l'hôte exécutant la tâche par lots LCM. La tâche par lots LCM utilisera les codes d'accès pour communiquer avec l'agent LCM. Si les codes d'accès utilisés sur les deux hôtes ne sont pas identiques, l'accès aux informations distantes TMS sera refusé par l'agent LCM.

  3. Utilisez le logiciel de sécurité de votre système (par exemple RACF, ACF-2 ou TopSecret) pour octroyer à l'ID utilisateur associé à une tâche de l'agent LCM l'accès en LECTURE aux jeux de données référencés.

    Ces jeux de données incluent les jeux de données des codes d'accès à l'agent LCM créés à l'étape 2, ainsi que tout catalogue de gestion des bandes auquel l'agent LCM accède.

    Le logiciel de sécurité de votre système vous octroie également les accès suivants :

    • Accès en ECRITURE aux jeux de données des codes d'accès pour le personnel chargé de la maintenance des codes d'accès

    • Accès en LECTURE aux jeux de données des codes d'accès pour les tâches LCM

    Créez une procédure pour les tâches d'agent LCM en personnalisant le membre SAMPLIB LCMAGENT.

    Pour plus d'informations, reportez-vous à la section "Paramètres de tâche de l'agent LCM."

    Remarque :

    • Vous devez spécifier les jeux de données des codes de sécurité (DDname LCMSECUR) dans le JCL à la fois pour la tâche de l'agent LCM et pour la tâche par lots LCM de base. Par exemple :

      //LCMSECUR DD DSN=<agent access code file>,DISP=SHR

    • Si vous utilisez l'interface personnalisée du module TMS, incluez le module de chargement adapté contenant le module TMS personnalisé dans le ddname STEPLIB.

    • Lorsque vous démarrez plusieurs agents dans un environnement partagé, chaque agent doit posséder un jeu de données de vidage ayant un nom qui lui est propre.

  4. Installez la procédure de tâche d'agent dans votre système PROCLIB.

  5. Pour connecter la tâche par lots LCM à un agent LCM, effectuez l'une des actions ci-dessous :

    • Définissez les paramètres d'instruction TMS suivants dans la tâche LCM :

      • Pour CA1, utilisez TMCDSN pour identifier le nom de jeu de données du catalogue TMS de l'agent LCM.

      • Pour TLMS, utilisez VMFDSN pour identifier le nom de jeu de données du catalogue TMS de l'agent LCM.

      • Pour tous les autres types de TMS, utilisez DSN pour identifier le nom du jeu de données du catalogue TMS de l'agent LCM.

    • Dans Explorer, utilisez l'onglet d'accès de la feuille de propriétés du TMS.

  6. Si vous avez spécifié une autre valeur que celle du port par défaut (3002) à l'étape 6, insérez une entrée de service ("lcm­agent") pour ce numéro de port dans votre fichier TCP/IP ETC.SERVICES.

    Par exemple :

    lcm­agent 4096/tcp # LCM Agent

  7. Vous pouvez également réserver l'utilisation du port TCP/IP à l'agent LCM en spécifiant l'instruction PORT dans votre profil de configuration TCP/IP.

    Cette action est recommandée pour éviter des conflits entre les ports. Dans l'exemple suivant, la première colonne correspond au numéro du PORT :

    PORT
    7 UDP MISCSERV          ; Miscellaneous Server 
    .
    3002 TCP LCMAGENT       ; LCM Agent ******* ADD THIS LINE ** 
    

    Remarque :

    Vous devez redémarrer votre espace d'adressage TCP/IP ou utiliser la commande OBEYFILE ou MVS VARY TCPIP pour forcer une exécution d'espace d'adressage TCP/IP afin de réserver le numéro de port ajouté.
  8. Vous pouvez également définir l'espace d'adressage TCP/IP pour qu'il contrôle l'agent LCM.

    Cette action est recommandée car cette configuration entraîne le démarrage ou l'arrêt automatique de la tâche de l'agent LCM lors du démarrage ou de l'arrêt de l'espace d'adressage TCP/IP. En outre, l'espace d'adressage TCP/IP interroge l'état de l'agent LCM de façon périodique et le redémarre lorsqu'il n'est pas actif. Vous pouvez définir cette configuration dans l'instruction AUTOLOG du profil de configuration TCP/IP.

    Par exemple :

    AUTOLOG
                          FTPSERVE  ; FTP Server 
                    LPSERVE         ; LPD Server 
                    NAMESRV         ; Domain Name Server 
                          NCPROUT   ; NCPROUTE Server 
                    PORTMAP         ; Portmap Server 
                          ROUTED    ; RouteD Server 
                          RXSERVE   ; Remote Execution Server 
                          SMTP      ; SMTP Server 
                          SNMPD     ; SNMP Agent Server 
                                  SNMPQE    ; SNMP Client 
                          MISCSERV  ; Miscellaneous Server 
                          LCMAGENT  ; LCM Agent *****ADD THIS LINE ******* 
    ENDAUTOLOG  
    

Paramètres de tâche de l'agent LCM

La liste suivante répertorie les paramètres d'exécution que vous pouvez spécifier dans le JCL de la tâche de l'agent LCM en ajoutant PARM= à l'instruction EXEC :

  • PORT

    Ce paramètre spécifie le numéro de port des connexions client. La valeur par défaut est 3002.

  • UPPERCASE

    Ce paramètre indique que les messages sont en majuscules.

  • MODLEVEL

    Ce paramètre affiche le niveau de service de l'agent LCM.

  • MAXCONN

    Ce paramètre spécifie le nombre maximal de connexions client simultanées. La valeur par défaut est 50.

  • LOG(SYSTEM|DD)

    Ce paramètre spécifie le routage des messages.

  • SYSTEM

    Ce paramètre route les messages vers la console du système.

  • DD

    Ce paramètre route les messages vers le ddname LWSLOG (défini par défaut).

  • SWAPpable

    Ce paramètre indique si l'agent LCM Agent est enfichable pendant les périodes d'inactivité. Par défaut, il n'est pas enfichable.

    OPTFILE('filename') or OPTFILE(DD:ddname)

    Spécifie un jeu de données MVS complet ou un ddname MVS complet contenant les paramètres d'exécution de l'agent LCM. Cette instruction vous permet de contourner les limitations de longueur de paramètre du JCL lorsque vous codez plusieurs paramètres d'exécution. Si vous codez un ddname plutôt qu'un nom de jeu de données, faites-le précéder du préfixe "DD:". Par exemple :

    OPTFILE(DD:LCMOPTS)

Installation de LCM Explorer (facultatif)

LCM Explorer est fourni dans le membre LCMXPLR du jeu de données LCMGUI. Les mises à jour vers LCM Explorer sont distribuées sous forme de correctifs PTF qui remplacent ce membre. Pour déterminer le niveau de version de LCM Explorer installé sur une station de travail, consultez l'élément "About LCM Explorer" de son menu Aide.

Pour mettre à jour LCM Explorer sur une station de travail :

  1. Installez le correctif PTF LCM contenant la mise à jour Explorer sur un hôte MVS exécutant LCM.

  2. Envoyez une copie via FTP du jeu de données LCMGUI du membre LCMXPLR à chaque PC exécutant Explorer et renommez le membre LCMINST.EXE, comme décrit ci-dessous :

    ftp <host name>
    User: <userid> 
    Password: <password> 
    ftp> binary 
    ftp> get ’LCM.LCMGUI(LCMXPLR)’ LCMINST.EXE 
    ftp> quit 
    
  3. Exécutez LCMINST.EXE sur chaque station de travail et suivez les instructions de l'assistant de configuration.

Allocation de la bibliothèque de fichiers de configuration Explorer

LCM Explorer produit un fichier de configuration qui doit se trouver sur l'hôte MVS utilisé pour exécuter LCM. La bibliothèque utilisée pour stocker les fichiers de configuration doit être de type PDS. Les informations d'allocation sont accessibles sur le membre SAMPLIB LCMINSTH.

Installation de la procédure JCL pour les tâches soumises par l'Explorer

LCM Explorer 7.3 peut soumettre les tâches par lots LCM. Cette fonction requiert de placer une procédure cataloguée pour appeler LCM dans SYS1.PROCLIB ou à un autre emplacement, par exemple un JCLLIB privé. Le membre SAMPLIB LCMEXEC contient un exemple de procédure JCL.

Le JCL de la procédure catalogué dans SYS1.PROCLIB (LCMEXEC) doit contenir les mêmes instructions DD que celles requises pour exécuter l'application LCM par lots. Il s'agit notamment des instructions DD telles que LCMTMSDB (catalogue du système de gestion des bandes), LCMSECUR (fichier des codes d'accès de l'agent LCM) et, si vous utilisez l'interface UUI SMC 7.3, la carte DD SEALINK (qui pointe vers les bibliothèques SMC 7.3).

Tâches de postinstallation MVS/CSC

Cette section décrit les tâches de postinstallation MVS/CSC. Il inclut les rubriques suivantes :

Définition de MVS/CSC en tant que sous-système MVS

MVS/CSC s'exécute en tant que sous-système secondaire sous le sous-système Job Entry principal.

Pour définir SMC en tant que sous-système MVS, ajoutez une ligne à votre tableau de noms de sous-système (membre SYS1.PARMLIB IEFSSNzz) en identifiant les éléments suivants :

  • Le nom du sous-système MVS/CSC composé de un à quatre caractères qui correspond au nom de la procédure de tâche MVS/CSC.

  • Le nom de routine d'initialisation du sous-système MVS/HSC, qui doit être SCSBPREI.

Partant du principe que votre nom de sous-système MVS/CSC est CSC0, la ligne suivante ajoute correctement MVS/CSC à votre tableau de noms de sous-système. Cet exemple d'entrée est contenu dans le membre IEFSSNYY de l'exemple de bibliothèque MVS/CSC.

SUBSYS SUBNAME(CSC0) INITRTN(SCSBPREI) /* keyword

Vous pouvez également définir le nom de sous-système MVS/CSC de manière dynamique à l'aide de la commande MVS SETSSI. Par exemple :

SETSSI ADD,SUB=CSC0,INITRTN=SCSBPREI

CSC0 est le nom du sous-système MVS/CSC et où SCSBPREI est le nom de la routine d'initialisation du sous-système MVS/CSC.

Remarque :

  • Si vous ne définissez pas le nom du sous-système MVS/CSC de manière dynamique, vous devez effectuer un IPL du système hôte MVS avant que l'entrée du nom du sous-système MVS/CSC soit appliquée.

  • MVS/CSC n'interagit plus avec les systèmes de gestion des bandes dans le traitement des messages MVS. De ce fait, l'ordre de définition du sous-système HSC et d'un sous-système de gestion des bandes n'est pas pertinent. Toutefois, la définition du sous-système SMC, si spécifiée, doit suivre l'entrée du système de gestion des bandes.

  • Reportez-vous aux publications IBM z/OS pour obtenir plus d'informations sur la définition des noms de sous-systèmes.

Définition de l'exécution de plusieurs sous-systèmes MVS/CSC sur le même système hôte MVS

Plusieurs sous-systèmes MVS/CSC peuvent s'exécuter sur le même système hôte MVS. Chaque MVS/CSC doit être défini en tant que sous-système MVS distinct. L'utilisation de plusieurs sous-systèmes MVS/CSC requiert uniquement de l'espace disque supplémentaire pour les procédures de démarrage JCL multiples, les fichiers des paramètres de démarrage supplémentaires et les jeux de données de journaux des événements, de suivi et de définition TAPEREQ facultatifs.

Si vous avez l'intention d'exécuter plusieurs MVS/CSC, chacun connecté à un serveur distinct, prenez en compte les exigences et restrictions de fonctionnement suivantes :

  • Tous les sous-systèmes MVS/CSC doivent s'exécuter à partir d'une même copie de modules exécutables.

  • Chaque MVS/CSC requiert sa propre définition de sous-système MVS, sa propre procédure cataloguée, ses propres paramètres de démarrage, son propre stockage virtuel et ses propres jeux de données de journaux des événements, de suivi et de définition TAPEREQ facultatifs.

  • Les exits utilisateur MVS/CSC doivent exécuter la même version sur chaque sous-système MVS/CSC.

  • Les caractères du préfixe de la commande de l'opérateur peuvent être identiques ou varier en fonction des préférences d'utilisation locales.

Remarque :

Le SMC interroge les sous-systèmes MVS/CSC à l'aide des informations relatives au volume et à la stratégie afin d'identifier le sous-système possédant la demande d'allocation. L'ordre d'interrogation est déterminé par les commandes SMC LIBRARY (si celles-ci sont spécifiées). Si aucune commande LIBRARY n'est spécifiée, l'ordre des MVS/CSC du tableau SSCVT est utilisé.

Les éléments suivants doivent être définis pour chaque sous-système :

  • Connexion au serveur

  • Fichier des paramètres de démarrage

  • Liens de communications

  • Procédure de démarrage de MVS/CSC

Vous pouvez également définir des jeux de données de journaux des événements et de suivi pour chaque sous-système.

Le texte du paramètre USERDATA spécifié dans le fichier des paramètres de démarrage est transmis à ces exits utilisateur. Vous pouvez utiliser ce texte et la liste de paramètres (contenant le nom de tâche, le nom du jeu de données et d'autres informations) pour spécifier au SMC quel sous-système MVS/CSC actif est considéré comme le détenteur de la demande d'allocation.

Remarque :

  • Pour plus d'informations sur les exits utilisateur MVS/CSC, reportez-vous à la section ELS Legacy Interfaces Reference.

  • Pour plus d'informations sur les tâches de configuration de MVS/CSC, reportez-vous à la section MVS/CSC Configuration Guide.

  • Pour plus d'informations sur procédures d'utilisateur de MVS/CSC, reportez-vous à la section MVS/CSC Operator’s Guide.

Autorisation de la bibliothèque de chargement MVS/CSC

MVS/CSC doit être exécuté en tant que programme autorisé dans MVS. De ce fait, vous devez effectuer les étapes suivantes pour autoriser les bibliothèques de chargement MVS/CSC via APF :

  1. Ajoutez les bibliothèques de chargement MVS/CSC au membre IEAAPFzz ou PROGzz de SYS1.PARMLIB.

  2. Exécutez les commandes décrites dans la section Autorisation des bibliothèques de chargement MVS/CSC pour autoriser la bibliothèque de chargement.

Ajout des bibliothèques de chargement MVS/CSC au membre IEAAPFzz

Ajoutez les entrées suivantes au membre IEAAPFzz pour autoriser les bibliothèques de chargement MVS/CSC :

your.SCSLINK volser,
your.SACLINK volser,
your.CSLLINK volser,

Avant d'ajouter ces entrées à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Si plusieurs entrées sont présentes dans le membre IEAAPFzz, chaque entrée (sauf la dernière) doit finir par une virgule pour indiquer la continuation. Omettez la virgule dans la dernière entrée.

Remarque :

  • Si les bibliothèques de chargement MVS/CSC sont situées sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, ne spécifiez pas le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

  • La bibliothèque de chargement TCPLINK est requise si vous utilisez CA Unicenter TCPaccess Communications Server :

    your.TCPLINK volser,

Reportez-vous aux publications CA pour obtenir plus d'informations. Si vous utilisez le protocole TCP/IP d'IBM, cette bibliothèque de chargement n'est pas requise.

Ajout des bibliothèques de chargement MVS/CSC au membre PROGzz

Ajoutez les entrées suivantes au membre PROGzz pour autoriser les bibliothèques de chargement MVS/CSC :

APF ADD
    DSNAME(your.SCSLINK)
    VOLUME(volser) | SMS
APF ADD
    DSNAME(your.SACLINK)
    VOLUME(volser) | SMS
APF ADD
    DSNAME(your.CSLLINK)
    VOLUME(volser) | SMS

Avant d'ajouter ces entrées à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Remarque :

  • Si les bibliothèques de chargement MVS/CSC sont situées sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, indiquez le SMS littéral après le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

  • La bibliothèque de chargement TCPLINK est requise si vous utilisez CA Unicenter TCPaccess Communications Server :

    APF ADD    DSNAME(your.TCPLINK)    VOLUME(volser) | SMS
    

    Reportez-vous aux publications CA pour obtenir plus d'informations. Si vous utilisez le protocole TCP/IP d'IBM, cette bibliothèque de chargement n'est pas requise.

Autorisation des bibliothèques de chargement MVS/CSC

L'ajout d'une entrée aux membres IEAAPFzz et PROGzz est nécessaire pour autoriser la bibliothèque en cas d'IPL. Dans le même temps, autorisez la bibliothèque de manière dynamique sur votre système en cours d'exécution en émettant l'un des jeux de commandes système MVS suivants :

Si les bibliothèques sont gérées par SMS :

SETPROG APF,ADD,DSN=your.SCSLINK,SMS
SETPROG APF,ADD,DSN=your.SACLINK,SMS
SETPROG APF,ADD,DSN=your.CSLLINK,SMS

Si les bibliothèques ne sont pas gérées par SMS :

SETPROG APF,ADD,DSN=your.SCSLINK,volser
SETPROG APF,ADD,DSN=your.SACLINK,volserSETPROG APF,ADD,DSN=your.CSLLINK,volser

Autorisation de la bibliothèque d'exits utilisateur MVS/CSC

La bibliothèque d'exits utilisateur MVS/CSC peut être la même que la bibliothèque de chargement MVS/CSC, ou une autre bibliothèque. Si la bibliothèque d'exits utilisateur MVS/CSC est une autre bibliothèque, vous devez effectuer les étapes suivantes pour autoriser via APF la bibliothèque de chargement d'exits utilisateur MVS/CSC :

  1. Ajoutez la bibliothèque de chargement d'exits utilisateur MVS/CSC au membre IEAAPFzz ou PROGzz de SYS1.PARMLIB.

  2. Exécutez les commandes décrites dans la section Autorisation de la bibliothèque de chargement d'exits utilisateur MVS/CSC pour autoriser la bibliothèque de chargement.

Ajout de la bibliothèque de chargement d'exits utilisateur MVS/CSC au membre IEAAPFzz

Ajoutez les entrées suivantes au membre IEAAPFzz pour autoriser la bibliothèque de chargement d'exits utilisateur MVS/CSC.

your.SCSLINK   volser,
your.CSC_USEREXIT.LOAD   volser,

Avant d'ajouter ces entrées à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Si plusieurs entrées sont présentes dans le membre IEAAPFzz, chaque entrée (sauf la dernière) doit finir par une virgule pour indiquer la continuation. Omettez la virgule dans la dernière entrée.

Remarque :

Si la bibliothèque de chargement d'exits utilisateur MVS/CSC est située sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, ne spécifiez pas le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

Ajout de la bibliothèque de chargement d'exits utilisateur MVS/CSC au membre PROGzz

Ajoutez l'entrée suivante au membre PROGzz pour autoriser la bibliothèque de chargement d'exits utilisateur MVS/CSC :

APF ADD    DSNAME(your.SCSLINK)    VOLUME(volser) | SMSAPF ADD    DSNAME(your.CSC_USEREXIT.LOAD)    VOLUME(volser) | SMS

Avant d'ajouter cette entrée à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Remarque :

Si la bibliothèque de chargement d'exits utilisateur MVS/CSC est située sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, spécifiez le SMS littéral après le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

Autorisation de la bibliothèque de chargement d'exits utilisateur MVS/CSC

L'ajout d'une entrée aux membres IEAAPFzz et PROGzz est nécessaire pour autoriser la bibliothèque en cas d'IPL. Dans le même temps, autorisez la bibliothèque de manière dynamique sur votre système en cours d'exécution en émettant l'une des commandes système MVS suivantes :

Si la bibliothèque est gérée par SMS :

SETPROG APF,ADD,DSN=your.CSC_USEREXIT.LOAD,SMS

Si la bibliothèque n'est pas gérée par SMS :

SETPROG APF,ADD,DSN=your.CSC_USEREXIT.LOAD,volser

Modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Copie ou déplacement du module SCSBPREI vers une bibliothèque LINKLIST MVS

Le module de routine de pré-initialisation du sous-système MVS/CSC (SCSBPREI), situé sur la bibliothèque SCSLINK, doit également être placé sur une bibliothèque LINKLIST MVS. Vous pouvez copier ou déplacer le module SCSBPREI du SCSLINK vers une bibliothèque LINKLIST.

Le module de routine de pré-initialisation SCSBPREI est compatible entre les versions MVS/CSC du point de vue fonctionnel. Pour assurer la compatibilité future, utilisez toutefois la dernière version du module de pré-initialisation SCSBPREI.

Ajout de MVS/CSC au tableau des propriétés du programme MVS

Vous devez modifier le tableau des propriétés du programme (PTT, Program Properties Table) MVS pour y inclure une entrée pour le sous-système MVS/CSC.

Remarque :

Le MVS/CSC doit s'exécuter en touche lente (entre 1 et 7). Les exemples de cette section utilisent la touche 3. Les résultats de l'utilisation des touches comprises entre 8 et 15 sont imprévisibles.

Ajoutez l'entrée suivante au membre SCHEDzz de SYS1.PARMLIB :

PPT PGMNAME(SCSBINIT),PRIV,SYST,KEY(3)

Allocation de jeux de données de journaux des événements et de trace MVS/CSC

Le jeu de données de journaux des événements permet d'enregistrer des événements consignés par l'utilitaire de journal des événements MVS/CSC. Le jeu de données de suivi enregistre la sortie de suivi produite par l'utilitaire de suivi MVS/CSC. Si vous prévoyez d'utiliser les utilitaires de journaux des événements et de suivi MVS/CSC, vous devez allouer des jeux de données de journaux des événements et de suivi pour enregistrer la sortie produite par ces utilitaires. Le tableau suivant fournit des recommandations relatives aux définitions de taille. Les numéros fournis pour les blocs correspondent au minimum requis pour les jeux de données.

Pour plus d'informations sur les utilitaires de journaux des événements et de suivi MVS/CSC, reportez-vous aux manuels MVS/CSC Configuration Guide et MVS/CSC System Programmer’s Guide.

Le tableau suivant répertorie les jeux de données de journaux des événements et de suivi MVS/CSC :

Tableau 5-2 Jeux de données des journaux des événements et de suivi MVS/CSC

Nom du jeu de données DSORG RECFM LRECL BLKSIZE Pistes Blocs de répertoire

TRACE

PS

VB

3076

1000

2000

N/A

EVENT LOG

PS

VB

3076

1000

2000

N/A


Tâches de postinstallation de LibraryStation

Ce chapitre décrit les tâches de postinstallation de LibraryStation requises. Il inclut les rubriques suivantes :

Autorisation de la bibliothèque de chargement LibraryStation

LibraryStation doit être exécuté en tant que programme autorisé dans MVS. De ce fait, vous devez effectuer les étapes suivantes pour autoriser les bibliothèques de chargement LibraryStation via APF :

  1. Ajoutez les bibliothèques de chargement LibraryStation au membre IEAAPFzz ou PROGzz de SYS1.PARMLIB.

  2. Exécutez les commandes décrites dans la section Autorisation des bibliothèques de chargement LibraryStation pour autoriser la bibliothèque de chargement.

Ajout des bibliothèques de chargement LibraryStation au membre IEAAPFzz

Ajoutez les entrées suivantes au membre IEAAPFzz pour autoriser les bibliothèques de chargement LibraryStation :

your.SLCLINK volser
your.SACLINK volser
your.CSLLINK volser

Avant d'ajouter ces entrées à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Si plusieurs entrées sont présentes dans le membre IEAAPFzz, chaque entrée (sauf la dernière) doit finir par une virgule pour indiquer la continuation. Omettez la virgule dans la dernière entrée.

Remarque :

  • Si la bibliothèque de chargement LibraryStation est située sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, ne spécifiez pas le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

  • La bibliothèque de chargement TCPLINK est requise si vous utilisez CA Unicenter TCPaccess Communications Server pour les communications TCP/IP :

    your.TCPLINK volser,

    Reportez-vous aux publications CA pour obtenir plus d'informations. Si vous utilisez le protocole TCP/IP d'IBM, cette bibliothèque de chargement n'est pas requise.

Ajout des bibliothèques de chargement LibraryStation au membre PROGzz

Ajoutez les entrées suivantes au membre PROGzz pour autoriser les bibliothèques de chargement LibraryStation :

APF ADD    DSNAME(your.SLCLINK)    VOLUME(volser) | SMSAPF ADD    DSNAME(your.SACLINK)    VOLUME(volser) | SMSAPF ADD    DSNAME(your.CSLLINK)    VOLUME(volser) | SMS

Avant d'ajouter ces entrées à votre liste de programmes autorisés, modifiez le qualificatif de haut niveau et le volser avec les valeurs appropriées pour votre système.

Remarque :

  • Si les bibliothèques de chargement LibraryStation sont situées sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, indiquez le SMS littéral après le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

  • Si les bibliothèques de chargement LibraryStation sont situées sur un volume géré par SMS, vous n'avez pas à spécifier de volume dans l'entrée de bibliothèque autorisée. Le cas échéant, indiquez le SMS littéral après le nom de la bibliothèque, pour indiquer que la bibliothèque est gérée par SMS. La bibliothèque ne peut pas être autorisée si vous spécifiez le mauvais volume.

    APF ADD    DSNAME(your.TCPLINK)    VOLUME(volser) | SMS
    

    Reportez-vous aux publications CA pour obtenir plus d'informations. Si vous utilisez le protocole TCP/IP d'IBM, cette bibliothèque de chargement n'est pas requise.

Autorisation des bibliothèques de chargement LibraryStation

L'ajout d'une entrée aux membres IEAAPFzz et PROGzz est nécessaire pour autoriser la bibliothèque en cas d'IPL. Dans le même temps, autorisez la bibliothèque de manière dynamique sur votre système en cours d'exécution en émettant l'un des jeux de commandes système MVS suivants :

Si les bibliothèques sont gérées par SMS :

SETPROG APF,ADD,DSN=your.SLCLINK,SMSSETPROG APF,ADD,DSN=your.SACLINK,SMSSETPROG APF,ADD,DSN=your.CSLLINK,SMS

Si les bibliothèques ne sont pas gérées par SMS :

SETPROG APF,ADD,DSN=your.SLCLINK,volser
SETPROG APF,ADD,DSN=your.SACLINK,volser
SETPROG APF,ADD,DSN=your.CSLLINK,volser

Définition du Persistent Data File (PDF, fichiers de données persistantes) (facultatif)

Le logiciel LibraryStation inclut un gestionnaire de base de données (DBM, Database Manager) qui est initialisé en même temps que LibraryStation. Le DBM gère plusieurs objets de données persistantes qui ne sont pas conservés par le HSC, y compris les verrouillages de ressources et les états du lecteur.

Les objets de données gérés par le DBM sont stockés dans un ou plusieurs fichiers VSAM. On appelle l'ensemble de ces fichiers "fichier de données persistantes" (Persistent Data File, PDF). Le PDF contient les enregistrements lockid ainsi que ceux du volume et du lecteur.

Remarque :

  • Si vous migrez à partir d'une version précédente de LibraryStation, vous devez supprimer le PDF existant et en définir un nouveau pour la nouvelle version.

  • Vous devez définir un PDF si LibraryStation est utilisé sur des clients hétérogènes (par exemple des clients autres que MVS). Si LibraryStation est utilisé sur des clients MVS dans un environnement sysplex, ne définissez pas le PDF. Le PDF n'est pas pris en charge sur les environnements sysplex. Pour plus d'informations sur le PDF, reportez-vous au manuel LibraryStation Configuration and Administration Guide.

  • Vous devez définir un PDF si LibraryStation est utilisé sur des clients hétérogènes (par exemple des clients autres que MVS). Si LibraryStation est utilisé sur des clients MVS dans un environnement sysplex, ne définissez pas le PDF. Le PDF n'est pas pris en charge sur les environnements sysplex. Pour plus d'informations sur le PDF, reportez-vous au manuel LibraryStation Configuration and Administration Guide.

Vous devez définir le PDF lorsque LibraryStation est utilisé sur des clients hétérogènes. Utilisez IDCAMS pour définir les jeux de données du PDF.

L'exemple suivant montre le JCL utilisé pour définir les jeux de données du PDF. Ce JCL se trouve dans le membre SLGDBCR de la bibliothèque d'exemples LibraryStation.

Exemple 5-1 JCL permettant de définir les jeux de données LibraryStation

//SLGDBCR JOB job card info,REGION=1M
//*
//* NOTE: A minimum of 1 Meg of virtual storage is needed
//*    for this job (i.e., use REGION=1M on the job card)
//*
//CREATEDB EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//INPUT  DD *
000000000000 DB INITIALIZATION RECORD
//SYSIN  DD *
  DELETE (cluster_name) CLUSTER 
  DEFINE CLUSTER (                       _
    NAME(cluster_name)                   _
    VOLUMES(volser)                      _
    RECORDS(nr,2*nr)                     _
    RECORDSIZE(30 100)                   _
    KEYS(12 0)                           _
    UNIQUE )
  REPRO INFILE(INPUT)                    _
     OUTDATASET(cluster_name)
  DEFINE ALTERNATEINDEX (                _
    NAME(alternate_index_name)           _
    RELATE(cluster_name)                 _
    KEYS(10 2)                           _
    RECORDS(nr,2*nr)                     _
    RECORDSIZE(27 27)                    _
    VOLUMES(volser)                      _
    UNIQUEKEY                            _
    UNIQUE                               _
    UPGRADE )                            _
  DEFINE PATH (
    NAME(path_name)                      _
    PATHENTRY(alternate_index_name))     _
  BLDINDEX               _
    INDATASET (cluster_name)             _
    OUTDATASET (alternate_index_name) 
  LISTCAT ENTRIES (                      _
    cluster_name                         _
    alternate_index_name                 _
    path_name) ALL
//*

Vous devez fournir ou modifier les informations suivantes :

  • Informations relatives à la carte JOB

  • Nom des jeux de données du PDF

  • Emplacement du volume du PDF

  • Valeurs de mot clé de l'enregistrement

Nom des jeux de données du PDF

Vous devez spécifier des noms pour les jeux de données répertoriés dans le tableau suivant :

Tableau 5-3 Nom des jeux de données du PDF

Mot clé du nom Description

CLUSTER

Nom du cluster de base SLSPDF (nom_cluster), par exemple, LSTAT.PDF.

ALTERNATEINDEX

Nom de l'autre index SLSPDFX (nom_autre_index), par exemple, LSTAT.PDFAIX.

PATH

Nom du chemin d'accès à SLSPDFX (nom_chemin), par exemple, LSTAT.PDFPATH.


Remarque :

Aucune convention de nommage prédéfinie n'existe pour les noms de jeux de données. Vous pouvez utiliser le même préfixe pour les trois jeux de données et fournir le même type de fichier pour chaque nom.

Emplacement du volume

Un seul PDF est défini pour LibraryStation et le système hôte où LibraryStation est initialisé doit avoir accès au volume DASD où se trouve le PDF. Ainsi, dans un environnement d'hôtes multiples où plusieurs hôtes peuvent initialiser LibraryStation, le PDF doit se trouver sur un volume DASD partagé accessible pour chaque hôte d'initialisation.

Le PDF peut être alloué à n'importe lequel des volumes DASD disponibles. Le DASD est identifié par son volser.

Valeurs des mots-clés d'enregistrement

Le calcul de l'espace d'enregistrement du PDF (nr) (montré ci-dessous) est basé sur le nombre maximum de volumes (nv) verrouillés simultanément par tous les systèmes client et sur le nombre total de lecteurs de cartouches de bande qui sera utilisé par les clients réseau (nd).

nombre d'enregistrements (nr) = (nv + nd) x 1.1

L'allocation de l'espace secondaire du PDF correspond à deux fois le nombre d'enregistrements (2 x nr).

Définir les enregistrements principaux sur 2 000 et les enregistrements secondaires sur 4 000 convient à la plupart des installations LibraryStation. Toutefois, pour vérifier les enregistrements de votre installation, utilisez les formules d'allocation avec le nombre de volumes et les données du client réseau de votre site.