Mots-clés Compléments DSPF,sous fichier

BoTTom |    Changer de couleur
 
 
********************************************************
*       C O M P L E M E N T S       D S P F            *
********************************************************
 
FRCDTA
          Niveau format.
          Force l'écriture immédiate d'un format.
           (par défaut écriture differée si DFTWTR(*YES) sur l'objet.)
 
RTNDTA
          Niveau format.
          Permet à un programme lors d'une relecture d'un format de ne
           relire que le buffer sans que le programme s'arrete et
           de façon transparente pour l'utilisateur.
 
INVITE
          Niveau format.
          Invitation des unités à une lecture différée.
 
 


|    Changer de couleur
 
 
INZINP
          Niveau format.
          Permet d'effacer les zones en entrée quand PUTOVR et
           ERASEINP(*ALL) sont en fonction.
 
UNLOCK    (*ERASE/*MDTOFF/*ERASE *MDTOFF/*MDTOFF *ERASE)
          Niveau format.
          Permet de ne pas verrouiller le clavier après un ordre de lecture.
 
USRDSPMGT
          Niveau format.
          Permet de ne pas mettre à blanc le fichier écran à l'ouverture.
 
VLDCMDKEY(indicateur 'texte')
          Niveau fichier ou format.
          Renvoi l'indicateur associé en fonction si une touche
           de commande valide a été  utilisée.
 
 
 


|    Changer de couleur
 
********************************************************
*           S O U S - F I C H I E R S                  *
********************************************************
 
SFL
          Niveau format.
          Definit un format d'enregistrement de sous-fichier.
 
SFLCTL(nom fmt enreg.)
          Niveau format.
          Definit un format de contrôle de sous-fichier.
 
SFLSIZ(taille).
          Niveau format de ctl.
          Donne la taille initiale d'un sous-fichier.
          Si SFLSIZ est > a SFLPAG le système incrementera la taille
           du sous-fichier suivant ses besoins.
 
SFLPAG(nb enreg)
          Niveau format de ctl.
          Donne le nombre d'enregistrements d'une page de sous-fichier.


|    Changer de couleur
SFLDSP
          Niveau format de ctl.CONDITIONNABLE.
          Provoque l'affichage du sous-fichier.
 
SFLDSPCTL
          Niveau format de ctl.CONDITIONNABLE.
          Provoque l'affichage du format de contrôle.
 
SFLCLR
          Niveau format de ctl.CONDITIONNABLE.
          Provoque le nettoyage du sous-fichier.
 
SFLDLT
          Niveau format de ctl.CONDITIONNABLE.
          Provoque la suppression du sous-fichier(12 actifs maxi)
 
SFLEND(*MORE)
          Niveau format de ctl.CONDITIONNABLE.
          Provoque la suppression du "+" en bas a droite du sous-fichier
           à l'affichage de la derniere page.
          *MORE provoque l'apparition de A Suivre ... sur une ligne à part.
           (ATTENTION AUX RECOUVREMENTS !!)


|    Changer de couleur
 
SFLRCDNBR(/CURSOR)
          Niveau ZONE d'un format de ctrl.
          Permet de spécifier à l'OS d'afficher la page contenant
           l'enregistrement dont le n° est precisé dans la zone SFLRCDNBR.
          Si CURSOR est précisé le curseur sera postionné dessus.
 
SFLDROP(CAxx/CFxx).
          Niveau format de ctl.
          Permet pour un sous-fichier multilignes
            (enregistrement sur plus d'une ligne)
          l'affichage de chaque enregistrement
             - Soit partiellement(sur une ligne)  AFFICHAGE INITIALE 
             - Soit complétement(toutes les lignes)
          SFLPAG doit contenir le nombre d'enregistrements que
           peut contenir une page quand il sont affichés entièrement.
 
SFLFOLD(CAxx/CFxx).
          Niveau format de ctl.
          Idem SFLDROP mais l'affichage initial est multilignes.
 
 SFLDROP et SFLFOLD compatibles si conditionnés. 


|    Changer de couleur
 
SFLENTER(CAxx/CFxx)
          Niveau format de ctl.
          Associe la touche "ENTER" à la fonction ROLLUP
          la touche de commande CAxx ou CFxx remplacant alors la
          touche entrée.
 
SFLINZ
          Niveau format de ctl.Conditionnable.
          Demande à l'OS d'initialiser tous les enregistrements
           du sous-fichier.S'utilise en général avec SFLRNA ou SFLPGMQ.
 
SFLLIN(nb espaces)
          Niveau format de ctl.
          Permet d'afficher plusieurs enregistrements sur une seule ligne
           écran.Entrer le nombre d'espaces séparant chaque enregistrement.
           ATTENTION les enregistrements sont placés comme suit:
     N°:      ________1________  ________3________  ________5_______
 
              ________2________  ________4________  ________6_______
                              !  !
                              !__!<-- ICI SFLLIN = 2


|    Changer de couleur
 
SFLMSG('texte du message' Indic)
          Niveau format de ctl.CONDITIONNABLE.
          Permet d'associer un message d'erreur a un format de ctrl,
           la fonction ERRMSG étant interdite pour une zone appartenant
           à un format d'enregistrement.
          C'est le pgm qui gèrera l'inversion d'image de la zone en
           erreur et la position du curseur.(DSPATR(RI PC) sur le fmt-enreg)
          S'utilise avec SFLNXTCHG.
 
SFLMSGID(ID-du-message Fichier-message/.bibli/ indic)
          Niveau format de ctl.CONDITIONNABLE.
          Meme principe que SFLMSG le texte du message étant pré-défini
           dans un fichier message.
 
SFLRNA
          Niveau format de ctl.CONDITIONNABLE.
          Associé a SFLINZ permet de na pas considérer les enregistrements
           d'un sous-fichier initialisé par l'OS, comme actifs.
          Ils ne seront actifs que s'il sont modifiés à l'aide du clavier.
 
 


|    Changer de couleur
 
SFLROLVAL
          Niveau ZONE d'un format de ctrl.
          Permet de spécifier à l'OS que l'utilisateur peut entrer
           une valeur dans cette zone qui représentera le nombre de ligne
           à défiler par ROLLUP.
          Si SFLROLVAL n'est pas précisé le nombre de ligne à defiler
           est égal à SFLPAG.
 
SFLCSRRRN(nom-zone)
          Niveau format de control.
          Permet de demander à l'OS de placer dans cette zone le n° de rang
           de l'enregistrement correspondant à la position curseur.
          La zone doit appartenir au format.(utilisation H/cachée)
 
SFLMODE(nom-zone)
          Niveau format de control.
          Permet de demander à l'OS de placer dans cette zone le type
           d'affichage du fichier multilignes('1' =tronqué,'0' = multiligne)
          La zone doit appartenir au format.(utilisation H/cachée)
 
 


|    Changer de couleur
********************************************************
*   S O U S - F I C H I E R S   M E S S A G E S        *
********************************************************
 
SFLMSGRCD(N° ligne)
          Niveau format d'enregistrement.
          Définit un sous-fichier message."N° de ligne" indique la ligne
           ou afficher le premier message.
SFLMSGKEY
          Niveau zone d'un format d'enregistrement.
          Associé a un nom de zone (la zone ne doit pas être définie,
          elle est 4 ALPHA/) devra contenir la cle du message à écrire
           dans le sous-fichier message ou sera renseignée automatiquement
           si vous utilisez SFLINZ.
SFLPGMQ
          Niveau zone d'un format d'enregistrement ET niveau zone
           d'un format de contrôle.
          Associé a un nom de zone (la zone ne doit pas être définie
          elle est 10 ALPHA/) devra contenir le nom de la PGMQ (nom pgm)
          qui contient le message à écrire dans le sous-fichier message.
          ou le nom de la PGMQ avec laquelle l'OS va initialiser le sous
          fichier si SFLINZ (peut être "*" en RPG et COBOL).


|    Changer de couleur
 
***** METHODE D'UTISATION D'UN SOUS-FICHIER MESSAGE ****
 
     I/  Sans SFLINZ.
     A* FORMAT D'ENREGISTREMENT
     A          R SFLMSG                    SFL SFLMSGRCD(23)
     A            ZONCLE                    SFLMSGKEY
     A            ZONPGMQ                   SFLPGMQ
     A* FORMAT DE contrôle
     A          R CTLMSG                    SFLCTL(SFLMSG)
     A                                      SFLSIZ(3)
     A                                      SFLPAG(2)
     A  XX                                  SFLDSP
     A            ZONPGMQ                   SFLPGMQ
 
          Le pgm place dans la zone ZONCLE la cle du message et
           dans la zone ZONPGMQ le nom de la PGMQ,puis ecrit
           un enregistrement du sous-fichier.
          Lorsque le sous-fichier est chargé le pgm l'affiche
           en écrivant le format de contrôle.
 
 


|    Changer de couleur
 
     II/ Avec SFLINZ.
      * FORMAT D'ENREGISTREMENT IDENTIQUE
     A
      * FORMAT DE contrôle
     A          R CTLMSG                    SFLCTL(SFLMSG)
     A                                      SFLSIZ(3)
     A                                      SFLPAG(2)
     A                                      SFLDSP
     A                      ------------>   SFLINZ
     A            ZONPGMQ                   SFLPGMQ
 
          Le pgm place dans la zone ZONPGMQ le nom de la PGMQ.
           (ou "*" en RPG et COBOL)
          Lors de l'affichage du sous-fichier l'O ira chercher
           tous les messages de la PGMQ
           (==>tous les messages reçus par le pgm si "*")
           et remplira le sous-fichier avec ces messages.
 
          Le programme n'a plus à renseigner ZONCLE,ni à écrire dans
           le sous-fichier, il se contente d'écrire le format de contrôle.
 


|    Changer de couleur
 
********************************************************
*          S E Q U E N C E S  D ' A I D E              *
********************************************************
 
         H en colonne 17 Définit une séquence d'aide
         La touche HELP doit être autorisée.
 
 
 
 HLPDOC  AIDE dans un document
 ou
 HLPRCD  AIDE dans un format de fichier écran (le même ou un autre)
 
 
 HLPAREA(X1 Y1 X2 Y2) ou (*RCD)
 Définition d'une fenetre d'aide
     X1 Y1 coordonnées de l'angle supérieure gauche de la fenetre.
     X1 Y1 coordonnées de l'angle inférieure droit de la fenetre.
     *RCD fenetre = format
 
 


|    Changer de couleur
 
 HLPBDY  Frontiere d'AIDE.
         Par défaut Rollup affiche le format d'aide suivant
                    Rolldown le précédent.
 
 HLPSEQ(Groupe Seq)
        Groupe = Regroupement de plusieurs format d'AIDE
        Seq    = Sequence de classement dans le groupe (01 à 10)
                    Rollup affiche la séquence suivante.
                    Rolldown la précédente dans le même groupe
 
 HLPRTN(indicateur)
         La touche AIDE est gérée par le pgm,
          l'indicateur associé est mis en fonction.
 
 
 
 
 
 
 
 


|    Changer de couleur
 
EXEMPLE:
     A                                      HELP
     A                                      HLPRCD(FAIDG)
     A          R FMT                       OVERLAY
     A          H                           HLPRCD(FAID1)
     A                                      HLPAREA(*RCD)
     A          H                           HLPRCD(FAID2)
     A                                      HLPAREA(4 2 4 30)
     A                                  4  2'N° Article  :'
     A            NOART     R           4 20
     A          R FAIDG
     A                                  2  2'Aide valable pour tout le fichier -
     A                                      écran'
     A          R FAID1
     A                                  2  2'Aide valable pour tout le format'
     A          R FAID2
     A                                  2  2'Aide valable pour la fenetre 4-2  -
     A                                      4-30 (article)'
 
 
 





©AF400