LODPTF

La commande LODPTF (Charger des PTF) charge les modifications provisoires du logiciel (PTF) pour un produit spécifié à partir d'un lecteur de disque optique ou enregistre le fichier dans la bibliothèque de PTF du produit. Chaque PTF contient un ou plusieurs objets, y compris des programmes, qui peuvent être appliqués à un produit à l'aide de la commande APYPTF.

Seules les PTF concernant un produit unique peuvent être chargées en même temps. Certaines PTF peuvent être sélectionnées ou omises lors du chargement de PTF pour le produit spécifié. Les PTF appliquées ne sont pas chargées.

Restrictions :

• Pour utiliser cette commande, vous devez disposer du droit *ALLOBJ sur tous les objets.

Paramètres

Produit (LICPGM)

Indique en 7 caractères l'identificateur du produit pour lequel les PTF sont chargées.

Ce paramètre est obligatoire.

Unité (DEV)

Indique l'unité à partir de laquelle les PTF sont chargées. Le nom de l'unité doit avoir déjà fait l'objet d'une description dans le système.

*SERVICE

Les PTF transmises par le système du service de maintenance sont chargées.

*SAVF

Les PTF sont chargées à partir d'un fichier sauvegarde. Si la valeur *SAVF est spécifiée, une valeur est requise pour le paramètre SAVF (Fichier sauvegarde).

nom

Spécifiez le nom de la bande ou du lecteur de disque optique utilisé pour charger les PTF.

Numéros de PTF à sélectionner (SELECT)

Indique les PTF chargées pour le produit désigné. Le paramètre Numéros de PTF à omettre (OMIT) ne peut pas être spécifié si des numéros de PTF sont spécifiés pour ce paramètre.

Remarque :Si SELECT(*ALL) et DEV(*SERVICE) sont indiqués, les PTF enlevées définitivement et endommagées ne sont pas prises en compte. Pour charger une PTF enlevée définitivement ou endommagée, spécifiez son numéro dans ce paramètre.

Valeurs uniques

*ALL

Toutes les PTF du produit désigné sont chargées.

Autres valeurs (jusqu'à 50 répétitions)

valeur-alphanumérique

Entrez les numéros d'identification des PTF à charger.

Numéros de PTF à omettre (OMIT)

Indique que toutes les PTF doivent être chargées, à l'exception de celles précisées dans ce paramètre. Vous pouvez indiquer jusqu'à 50 numéros.

Remarque :Aucune valeur ne peut être indiquée au paramètre OMIT si des numéros de PTF sont spécifiés au paramètre SELECT (Numéros de PTF à sélectionner).

valeur-alphanumérique

Spécifiez les numéros d'identification des PTF simples qui ont été omises (non chargées).

PTF remplacées (SPRPTF)

Indique l'opération qui est effectuée pour les PTF appliquées provisoirement et remplacées par des PTF rencontrées au cours de cette opération de chargement. Ce paramètre spécifie également l'opération effectuée pour les PTF appliquées provisoirement qui sont des PTF de mise à jour technologique requises (*TRREQ) pour les PDF en cours de chargement.

*APYPERM

Pour le produit concerné, toute PTF appliquée provisoirement, et remplacée par des PTF présentes sur la bande, est automatiquement appliquée de manière définitive avant le chargement des PTF de remplacement. Toutes les PTF de mise à jour technologique appliquées provisoirement qui sont requises (*TRREQ) pour les PTF en cours de chargement sont automatiquement appliquées définitivement avant le chargement des PTF qui leur sont associées. Si les PTF remplacées ou les PTF de mise à jour technologique requises (*TRREQ) nécessitent l'application préalable d'autres PTF, elles sont également appliquées définitivement lors de cette opération.

*NOAPY

L'opération de chargement s'arrête lorsque des PTF appliquées provisoirement sont remplacées par des PTF stockées sur la bande. Les PTF appliquées provisoirement qui se font remplacer, doivent être appliquées définitivement (commande APYPTF) ou enlevées (commande RMVPTF) avant que la commande LODPTF ne puisse être relancée.

Le chargement s'arrête si l'une des PTF de mise à jour technologique requises (*TRREQ) pour les PTF en cours de chargement est appliquée provisoirement. Les PTF de mise à jour technologique requises (*TRREQ) doivent être appliquées définitivement (commande APYPTF) avant que la commande LODPTF puisse être relancée.

Edition (RLS)

Indique le niveau d'édition des PTF devant être chargées.

*ONLY

Cette valeur n'est admise que lorsqu'une seule édition de l'option de base du produit est installée sur le système. Les PTF associées à toutes les options installées du produit sont chargées, quel que soit le niveau d'édition de l'option.

caractère-valeur

Indiquez le niveau d'édition dans l'un des formats suivants :

• VxRyMz, où Vx représente le numéro de version, Ry le numéro d'édition et Mz le niveau de modification. Les variables x et y peuvent être un nombre de 0 à 9. La variable z peut être un nombre de 0 à 9 ou une lettre de A à Z.
• vvrrmm, où la version vv et l'édition rr doivent être des nombres compris entre 00 et 35, et la modification mm doit être un chiffre compris entre 00 et 09 ou une lettre comprise entre 0A et 0Z. Les zéros de début sont obligatoires. Ce format doit être utilisé si la version ou l'édition du produit est supérieure à 9.

Si le niveau d'édition indiqué est celui de l'option de base du produit, les PTF relatives à toutes les options installées du produit sont chargées, quel que soit le niveau d'édition de l'option.

Si le niveau d'édition indiquée n'est pas celui de l'option de base du produit, seules sont chargées les PTF relatives aux options installées à ce niveau d'édition.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence du volume de bande où commence le chargement des données PTF. Ce paramètre n'est admis que si un nom d'unité de bande est indiqué au paramètre DEV (Unité).

*SEARCH

La recherche du premier fichier de PTF pour le produit indiqué s'effectue sur le volume de bande. Le premier fichier de PTF trouvé est chargé.

1-16777215

Entrez le numéro de séquence du fichier de PTF en cours de chargement. Ce numéro doit figurer sur la bande.

Option de fin de support (ENDOPT)

Indique l'opération automatiquement effectuée après une opération de PTF sur le volume de bande ou le volume optique.

Remarque :Ce paramètre n'est admis que si un nom d'unité de bande ou d'unité optique est précisé au paramètre DEV. Pour les unités optiques, seule la valeur spéciale *UNLOAD est acceptée. Les valeurs *REWIND et *LEAVE ne seront pas prises en compte.

*REWIND

A la fin de l'opération, la bande est rebobinée automatiquement, mais elle n'est pas déchargée.

*LEAVE

La bande n'est pas rembobinée ou déchargée à la fin de l'opération. Elle conserve sa position.

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération. Certaines unités optiques éjecteront le volume une fois l'opération terminée.

ID chemin (PATHID)

Indique le numéro permettant d'identifier un fichier sur le support optique contenant les PTF à charger. Un numéro de chemin est attribué à chacun des fichiers de PTF relatifs à chaque produit et édition stockés sur le support optique. Ils peuvent ainsi être traités dans un ordre précis. Seules les PTF provenant de l'ID chemin spécifié sont chargées sur votre système.

Remarque :Ce paramètre n'est admis que si un nom d'unité optique est indiqué au paramètre DEV.

*FIRST

Le premier fichier de PTF relatif au produit et à l'édition indiqués est recherché sur le support optique en fonction de la sélection indiquée au paramètre SELECT.

• Lorsqu'un identificateur de PTF spécifique est indiqué au paramètre SELECT, cette PTF est chargée dès la première occurrence.
• Lorsque *ALL est indiqué au paramètre SELECT, le fichier de PTF existant associé à l'ID chemin le moins élevé est chargé.

*SELECT

La liste des fichiers de PTF stockés sur le support optique et correspondant au produit et à l'édition s'affiche. Vous pouvez sélectionner le fichier à partir duquel les PTF sont chargées. Cette valeur ne peut pas être sélectionnée en mode de traitement par lots.

1-9999

Spécifiez le numéro d'identificateur du chemin d'accès du fichier de PTF existant à partir duquel les données des PTF sont chargées.

Fichier sauvegarde (SAVF)

Spécifie le fichier de sauvegarde à partir duquel les PTF sont chargées. Ce paramètre n'est admis que si la valeur *SAVF est spécifiée au paramètre DEV (Unité).

Qualificatif 1 : Fichier sauvegarde

nom

Entrez le nom du fichier sauvegarde à partir duquel sont chargées les PTF.

Qualificatif 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier sauvegarde est recherché dans la bibliothèque en cours du travail. Si aucune bibliothèque en cours n'est indiquée en tant que bibliothèque en cours du travail, la bibliothèque QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque qui contient le fichier sauvegarde.

Copier lettre d'accompagnement (COVER)

Indique si la lettre d'accompagnement de la PTF doit être copiée dans un fichier physique. Ce paramètre n'est admis que lorsqu'une bande ou une unité optique est indiquée au paramètre DEV (Unité).

*YES

La lettre d'accompagnement est copiée dans un fichier physique après le chargement de la PTF.

*NO

La lettre d'accompagnement n'est pas copiée dans un fichier physique.

*ONLY

La lettre d'accompagnement est copiée dans un fichier physique, mais la PTF n'est pas chargée. Si le paramètre SEQNBR est indiqué, il doit avoir pour valeur le numéro de séquence du fichier contenant la PTF.

*SRVATT

L'attribut de maintenance CPYPTF permet de déterminer si la lettre d'accompagnement pour la PTF doit être copiée dans un ficher physique. La commande DSPSRVA affiche des informations sur la configuration du système. Ces informations indiquent notamment si les fichiers sauvegarde et les lettres d'accompagnement des PTF seront copiés dans *SERVICE lorsque celles-ci seront chargées. La commande CHGSRVA peut être utilisée pour modifier l'attribut de maintenance CPYPTF.

Copier fichier sauveg de PTF (CPYSAVF)

Permet d'indiquer si les fichiers sauvegarde des PTF doivent être copiés dans *SERVICE lorsque celles-ci sont chargées. Les fichiers sauvegarde de PTF doivent se trouver dans *SERVICE lors de la distribution de PTF sur d'autres systèmes ou lors de l'utilisation de la commande SAVSYSINF. Ce paramètre n'est admis que lorsqu'une bande ou une unité optique est indiquée au paramètre DEV (Unité).

*SRVATT

L'attribut de maintenance CPYPTF permet de déterminer si les fichiers sauvegarde des PTF seront copiés dans *SERVICE lorsque celles-ci seront chargées. La commande DSPSRVA affiche des informations sur la configuration du système. Ces informations indiquent notamment si les fichiers sauvegarde et les lettres d'accompagnement des PTF seront copiés dans *SERVICE lorsque celles-ci seront chargées. La commande CHGSRVA peut être utilisée pour modifier l'attribut de maintenance CPYPTF.

*YES

Les fichiers sauvegarde de PTF qui n'existent pas encore sont copiés dans *SERVICE lorsque les PTF sont chargées.

*NO

Les fichiers sauvegarde des PTF ne sont pas copiés dans *SERVICE lorsque celles-ci sont chargées.

Exemples

Exemple 1 : omission de PTF

LODPTF   LICPGM(57xxSS1)  OMIT(SI00003 SI00008 SI00014)

Cette commande permet de charger toutes les PTF à partir du système du service de maintenance (*SERVICE) pour le produit 57xxSS1, à l'exception des PTF SI00003, SI00008 et SI00014. La commande APYPTF peut ensuite être utilisée pour appliquer ces PTF au produit 57xxSS1.

Exemple 2 : Sélection de PTF

LODPTF   LICPGM(57xxSS1) DEV(OPT01)  SELECT(SI00009 SI00010)

Cette commande charge les PTF nommées SI00009 et SI00010 à partir du lecteur de disque optique nommé OPT01. La commande APYPTF peut ensuite être utilisée pour appliquer ces PTF au produit 57xxSS1.

Messages d'erreur

Messages *ESCAPE

CPF35AA

La PTF microcode &2 est déjà appliquée.

CPF35AB

PTF microcode &2 non appliquée.

CPF35AE

PTF &1 trouvée en double.

CPF35A0

La bibliothèque &1 ne peut pas être attribuée.

CPF35A1

Mauvais exemplaire du microcode sous licence utilisé.

CPF35A2

Modifications préalables du matériel non installées pour PTF &2.

CPF35A3

PTF microcode &2 non appliquée provisoirement.

CPF35A5

PTF microcode &2 non appliquée définitivement.

CPF35A6

Option langue &1 non installée pour logiciel sous licence.

CPF35A8

Aucune PTF à charger.

CPF35A9

Erreur lors du traitement de la PTF microcode.

CPF35CC

La bibliothèque requise pour une opération liée à des PTF existe déjà.

CPF35CF

PTF &1-&2 non appliquée.

CPF35C1

Opération LODPTF arrêtée. Plus de mémoire disponible.

CPF35C9

PTF &1-&2 &4 non valide.

CPF35EB

Plusieurs éditions du produit &1 installées.

CPF35E3

Erreur d'interface détectée.

CPF35FA

PTF &1-&2 non appliquée.

CPF35F4

Erreur pendant le traitement de lettres d'accompagnement.

CPF35F6

L'index principal des PTF de la bibliothèque &1 a été supprimé et créé.

CPF354A

*SELECT non admis pour l'identificateur de chemin.

CPF354C

Traitement de fichiers PTF sur volume optique impossible.

CPF354D

Unité &1 non admise.

CPF354E

Aucun fichier sélectionné.

CPF354F

Le fichier de PTF requis ne peut pas être traité.

CPF355B

Plusieurs éditions du produit &1 ont été trouvées sur le support.

CPF355C

PTF introuvables dans l'identificateur de chemin &1.

CPF3558

Impossible d'allouer &1 dans &3 de type *&2. Cannot allocate &1 in &3 type *&2.

CPF3564

PTF &1-&2 endommagée.

CPF358A

Édition non valide. Release not valid.

CPF3586

Liste de PTF incorrecte.

CPF3587

PTF non chargées.

CPF3590

PTF &1-&2 &5 non chargée.

CPF3598

Fonction PTF déjà en cours.

CPF36BE

PTF non chargées, erreur liée à une mise à jour technologique prérequise.

CPF3606

Produit &1 &3 non installé.

CPF361D

L'ordre d'application des PTF ne peut pas être déterminé.

CPF3612

Bibliothèque &1 non trouvée.

CPF3616

Aucune PTF chargée.

CPF3619

PTF pour l'édition &4 trouvées sur l'unité.

CPF3657

PTF non chargées par suite d'erreur.

CPF3693

Service function ended because error occurred.

CPF3924

PTF non chargée.

CPF3931

Programmes requis non trouvés. PTF incomplète.

CPF3945

Enregistrement des PTF supprimé pour logiciel sous licence.

CPF3992

Aucune PTF ne figure sur le support de sauvegarde/restauration pour le logiciel sous licence &1 &3.

CPF6602

PTF &1-&2 &4 non trouvée.

CPF8191

Définition de produit &4 de &9 endommagée.

CPF8193

Objet de chargement de produit &4 de &9 endommagé.