API de gestion et de création de PTF. Ces API ne sont valides que pour un logiciel définit en tant que produit (*PRDDFN) et chargé en tant que tel (*PRDLOD) sur la machine cible. Vous devez être famillié avec ces notions et avec les APi correspondantes Rappel: à une PTF est associé 1°/ un fichier de sauvegarde (QGPL) 2°/ un membre source (cover letter) 1°/ API de création de PTF. QPZCRTFX - CHAR(50) informations PTF . CHAR(7) ID PTF . CHAR(7) ID produit . CHAR(6) niveau du produit (VxRyMz) . CHAR(4) option du produit . CHAR(10) Bibliothèque des objets primaires . CHAR(4) ID chargement . CHAR(12) réservé - CHAR(10) Bibliothèque de developpement |
- CHAR(??) x fois 20c <--objet--><--bibli--> (liste des objets concernés par la PTF et donc à inclure lors de la sauvegarde dans le SAVF) - BIN(4) nombre d'objets (paramètre précédent) - CHAR(??) x fois 73c = document (chemin compris) (idem objets) - BIN(4) nombre de documents - CHAR(??) x fois 24 c = PTF prérequises . CHAR(7) ID PTF prérequise . CHAR(17) réservé - BIN(4) nombre de PTF prérequises - CHAR(??) x fois 84 c = liste des pgms d'exit (appellés lors de l'application ou du retrait) |
découpé comme suit: . CHAR(10) nom du pgm (si 2 PTF partagent le même pgm, la précédente est "recouverte") . CHAR(10) bibliothèque . CHAR7) option de lancement *BOTH : dans tous les cas *APPLY: lors d'une application(APY.) *REMOVE lors d'un retrait(RMV.) . CHAR(7) type de pgm d'exit *PTF : pgm à inclure dans la PTF *OBJLST : le pgm fait déja partie du produit(ne pas inclure) . CHAR(50) données utilisateur ( à envoyer en tant que paramètre) - BIN(4) nombre de pgms d'exit - CHAR(??) X fois 10c = liste des problèmes résolus par cette PTF. - BIN(4) nombre de problèmes |
- CHAR(??) x fois 44c = lettres d'acompagnement (cover letters) . CHAR(10) fichier source . CHAR(10) bibli source . CHAR(10) membre source . CHAR(4) ID langage . CHAR10) réservé - BIN(4) nombre de lettrres d'acompagnement - CHAR(??) code erreur Les pgms d'exit recoivent les paramètres suivants: 1°/ CHAR(7) ID produit 2°/ CHAR(7) ID PTF 3°/ CHAR(6) niveau du produit 4°/ CHAR(4) ID de l'option du produit 5°/ CHAR(4) ID chargement 6°/ CHAR(10) Bibliothèque de la PTF (là où les objets ont étés placés) 7°/ CHAR(50) Données utilisateur 8°/ CHAR(1) état/PTF 0=chargée,non appliquée/1=appliquée temporairement 9°/ CHAR(1) opération 0=RMV *temp /1=APY *temp /2=APY *perm /3=RMV *perm |
Cette API suifit pour générer un PTF (et donc un SAVF contenant les objets à modifier sur le système cible) Cette PTF peut être chargée via LODPTF DEV(unité) ou bien le SAVF transféré sur le système distant et la PTF chargée via LODPTF DEV(*SAVF) Le SAVF associé doit se trouver dans QGPL sous le nom Q<ID-PTF> Si vous souhaitez que cette PTF soit enregistrée comme étant reçue du service (comme avec SNDPTFORD), il faut utiliser l'API QPZLOGFX ce qui autorisera les commandes DSPPTF (cover letter) et LODPTF *SERVICE paramètres de l'API: - CHAR(50) infos PTF . CHAR(7) ID PTF . CHAR(7) ID produit . CHAR(6) version . CHAR(30) réservé - CHAR(10) demande: *LOGPTF PTF enregistrée *LOGCVR cover letter enreg. - CHAR(20) fichier source qualifié (*LOGCVR) - CHAR(10) membre source (*LOGCVR) - CHAR(??) code erreur |
ET ENFIN, vous pouvez obtenir des informations concernant une PTF, avec: QPZRTVFX - CHAR(??) variable en retour - BIN(4) lg de la variable précédente - CHAR(50) infos PTF . CHAR(7) ID PTF . CHAR(7) ID produit . CHAR(6) version . CHAR(30) réservé - CHAR(8) format PTFR0100 = informations de base PTFR0200 = liste des cover letters PTF0300 = liste des PTF prérequises - CHAR(??) code erreur |