APi de création et de gestion de PTF

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





©AF400