Utilisation de la commande MAPSORTPAG et MAPQUALSPL

==<big>Introduction</big>==

Les commandes MAPSORTPAG et MAPQUALSPL permettent de trier, éclater et qualifier avec des codes OMR et numéro de page un fichier spool.																				

==<big>Principe de fonctionnement</big>==

Le principe est la mise en base (dans un fichier physique) d'un ou plusieurs fichiers spools afin d'en générer un autre à partir de ceux mis en base. Le ou les fichiers spool résultants peuvent être triés, éclatés ou qualifier avec les numéros de page ainsi que les codes OMR de mise sous pli automatique.

Voici un exemple d'utilisation avec la mise en base de 3 spools différents : 

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C) JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)                                                

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000003) JOB(QPADEV000D) JOBNUM(693998) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)                                                

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000004) JOB(QPADEV000E) JOBNUM(693997) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)                                                

La commande MAPQUALSPL va prendre le contenu du fichier physique LIBSORT/SORTDBFILE afin de créer un fichier spool. Dans ce cas le fichier créé s'appellera OUTPUT et sera créé dans l'OUTQ MAPFIL_JDI/JDIEU_OUTQ

 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT)                                    

==<big>Le fichier physique</big>==
===Généralités===

Afin de faire des tris, des éclatements, la commande MAPSORTPAG met le fichier spool traité dans un fichier physique IBM-i.
Le fichier physique temporaire créé peut etre visualisé via des requêtes SQL.

 strsql
 select PRTDTA from LIBSORT/SORTDBFILE

===En UCS2===
Dans le cas où le paramétrage du serveur est en UCS2, alors l'insertion dans le fichier physique se fera en Unicode.
Son contenu via sql sera alors pas possible. (l'émulateur 5250 attendant de l'EBCDIC, ne pourra pas afficher des caractères encodés en Unicode)

Pour pouvoir lire son contenu, il faudra l'afficher en HexaDécimale.

 select hex(PRTDTA) from LIBSORT/SORTDBFILE

Le contenu ressemblera alors à cela : 

 746F3A6A64696575406D617070696E6773756974652E636F6D20202020202020202020202020202020202020202020202020202020202020202020202020202020220202020204D617070696E6720537569746520532E412E2020202020202020202020202020202020202020202020202020202020202020202020202020202020202

<u>Explications</u> : 

Le résultat est en unicode : 74 représente le "t", 6F le "o" 3A le ":" etc

Les premiers caractères du spool mis en base est donc to:

Plus d'information sur l'encodage des caractères en Unicode : https://ss64.com/ascii.html

===Structure du fichier physique===

<br />
{| class="wikitable"
|PAGES
|CRITERE0
|CRITERE1
|CRITERE2
|CRITERE3
|CRITERE4
|CRITERE5
|CRITERE6
|CRITERE7
|CRITERE8
|CRITERE9
|NUMSPL
|NUMPAG
|NUMLGN
|PRTDTA
|-
|
|0012601
|
|
|
|
|
|
|
|
|
|1
|0
|0
|(contenu de la 1er ligne de la 1er page du  1er spool)
|-
|
|0012601
|
|
|
|
|
|
|
|
|
|1
|0
|1
|(contenu de la 2ième ligne de la 1er page du  1er spool)
|-
|
|…
|
|
|
|
|
|
|
|
|
|…
|…
|…
|…
|-
|
|0012601
|
|
|
|
|
|
|
|
|
|1
|1
|0
|(contenu de la 1er ligne  de la 2ième page du 1ère spool)
|-
|
|0012601
|
|
|
|
|
|
|
|
|
|1
|1
|1
|(contenu de la 2ièmeligne  de la 2ième page du 1ère spool)
|-
|
|…
|
|
|
|
|
|
|
|
|
|…
|…
|…
|…
|-
|
|0012601
|
|
|
|
|
|
|
|
|
|2
|0
|0
|(contenu de la 1er ligne de la 1er page du  2ième spool)
|-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|}

Détails de chacune des colonnes : 

*PAGE : Contient le nombre de pages pour une valeur de clé données (utilisé par l'option CONTROL SORT = V)
*CRITERE0 : Contenu de la 1er clé de tri
*CRITERE1 : Contenu de la 2ième clé de tri
*CRITERE2 : Contenu de la 3ième clé de tri
*CRITERE3 : Contenu de la 4ième clé de tri
*CRITERE4 : Contenu de la 5ième clé de tri
*CRITERE5 : Contenu de la 6ième clé de tri
*CRITERE6 : Contenu de la 7ième clé de tri
*CRITERE7 : Contenu de la 8ième clé de tri
*CRITERE8 : Contenu de la 9ième clé de tri
*CRITERE9 : Contenu de la 10ième clé de tri
*NUMSPL : Numéro de spool injecté (1 pour le spool du 1er MAPSORTPAG, 2 pour le 2ième MAPSORTPAG, etc)
*NUMPAG : Numéro de page du spool injecté (Incrémenté à chaque page et remis à 0 lorsqu'on change de spool injecté)
*NUMLGN  : Numéro de ligne du spool injecté (Remis à 0 à chaque nouvelle page)
*PRTDTA : Contenu de la ligne en question

==<big>Les différents paramètres des commandes</big>==
Chacune de ces 2 commandes (MAPSORTPAG et MAPQUALSPL) comporte son lot de paramètres, ayant des fonctions bien distinctes. 

===MAPSORTPAG===

Tri d'un fichier spool (MAPSORTPAG)

 Nom du fichier spool . . . . . . > LFN160I      Nom de 10 caractères maxi.
 N° du fichier spool . . . . . . > 000002        -1-999999, *LAST, *ONLY
 Nom du travail . . . . . . . . . > QPADEV0008   Nom de 10 caractères maxi.
 Numéro du travail . . . . . . . > 972046        de 000001 à 999999
 Utilisateur . . . . . . . . . . > MYUSER        Nom de 10 caractères maxi.
 Ligne index . . . . . . . . . .   10            Numéro de ligne (30 max)+ si autres valeurs
 Colonne index . . . . . . . . .   5             Numéro de colonne (30 max)+ si autres valeurs
 Longueur index . . . . . . . . .  10            Longueur (30 max)
 + si autres valeurs
 Créer un fichier spool . . . . .   *YES         *YES, *NO
 Nom du spool à créer . . . . . .  SORTSPLF      Valeur alphanumérique 10 max
 OUTQ sortie du MAPPING . . . . .  *JOB          Nom, *JOB, *DEV, *SPLIT
 Nom de la bibliothèque . . . .    *LIBL         Nom, *LIBL
 Retenir le fichier spool . . . .  N             O=Retenu, N=Prêt
 Bibliothèque . . . . . . . . . .  MAP$$SORT     MAP$$SORT,...
 Autres paramètres
 Database pour le tri . . . . . .  SORTDB        SORTDB
 Ajout Remplacement fichier tri    *ADDAUTO      *ADD *REPLACE *NONE
 Numéro fichier spool à trier . .  1             1, 2, ....
 Largeur du spool en entrée . . .  255           80, 132, 198, 255, 378
 Hauteur du fichier spool . . . .  255           De 66 à 255
 Ligne d'overflow . . . . . . . .  60            De 1 à 255
 Contrôle sort splfname . . . . .  Y             O/Y/N/V
 Nom pour le control sort . . . .  SORTNAME      SORTNAME, xxx
 Imprimer numéro fichier ajouté    N             N, x
 Code page . . . . . . . . . . .   *SPL          *SPL, 037, 1147, ...


====Attributs du spool en entrée====
Les 5 attributs du spool déterminant le fichier spool a traiter.

====Ligne index (KEYLINE) / Colonne index (KEYCOL) et Longueur index (KEYLGN)====

Ce paramètres permettent de définir l'emplacement des clés de tris et de ruptures au sein du fichier spool. (par exemple le numéro de facture)
On peut en définir au maximum 10 pour un document donné.

====Nom du fichier spool à créer (SPLFNAME) / OUTQ sortie du MAPPING (OUTQ) / Nom de la bibliothèque (OUTQLIB) / Retenir le fichier spool (RDY)====
Si le paramètre CREATE=YES alors la commande MAPSORTPAG crée un fichier spool portant le nom et se situant aux endroits spécifiés dans ces paramètres.</BR>
Celui-ci pourra être en statut "held" ou "ready"
</BR>

====Bibliothèque (LIB)====
Ce paramètre indique le nom de la bibliothèque où le fichier physique sera créé
</BR>

====Database pour le tri(NAME)====
Ce paramètre indique le nom du fichier physique qui sera créé
</BR>
====Ajout Remplacement fichier tri (MBROPT)====
Ce paramètre permet d'indiquer au programme comment insérer le spool en base

 <nowiki>*</nowiki>NONE (utilisé avec CREATE=YES)= Pas d’utilisation du numéro de fichier . Ce paramètre est utilisé avec l'option CREATE=YES. Celui-ci permettra de déclencher la création d'un spool avec le contenu du fichier sans injecter le spool traité dans le fichier
 <nowiki>*</nowiki>ADD  (associé avec le paramètre NUMSPL)= Ajout dans le fichier actuel, sans incrémentation du numéro de fichier. Dans ce cas-là, il faut renseigner un numéro de spool via le paramètre NUMSPL. La valeur sera alors insérée dans le fichier dans la colonne NUMSPL. (ce paramètre est utilisé pour donner des types de spool, par exemple : NUMSPL=1 pour les relevés client et NUMSPL=2 pour les factures. Les spools utilisés seront alors triés selon les critères, puis selon le numéro du spool, et enfin de la page.
 <nowiki>*</nowiki>ADDAUTO = Insère le contenu du spool avec incrémentation +1 de la variable NUMSPL à chaque spool injecté (pour chaque MAPSORTPAG)
 <nowiki>*</nowiki>REPLACE = Remplace le fichier. Le numéro de spool NUMSPL repasse à 1.
</BR>

====Numéro fichier spool à trier (NUMSPL)====
si MBROPT=<nowiki>*</nowiki>ADD
Ce paramètre permet de spécifier un numéro de spool. Cette valeur sera insérée en base dans la colonne NUMSPL.</BR>
Ce paramètre est utilisé pour insérer des type de fichier différents afin qu'ils soient retriés (par exemple : NUMSPL=1 pour les relevés client et NUMSPL=2 pour les factures)
</BR>

====Largeur du spool en entrée (SIZE) / Hauteur du fichier spool (HEIGHT) / Ligne d'overflow (OVERFLOW)====
Ces paramètres donnes la taille du fichier spool généré

</BR>

====Contrôle sort splfname (CONTROLE)====
Ce paramètre permet de lancer l'éclatement du fichier spool sur les indexes.

Pour ce paramètre, indiquez N si vous ne désirez qu’un seul spool, ou Y (ou O) si vous désirez un fichier spool par rupture. La référence du spool contiendra alors les 10 premiers caractères du code en rupture.
Si vous indiquez V dans la zone Control sort, les spools générés le seront par leur nombre de pages, ainsi que la référence de ces spools.

*Y
*O
*V
*N
</BR>

====Nom pour le control sort (NAMFORCTRL )====
Ce paramètre permet de donner un nom à l'appel du spécific MAP_C853P1 ou MAP_C853P2. Ce programme est appelé quand on a CONTROL SORT=Y. On peut donner une valeur testable dans le programme. Ce programme est exécutée à chaque rupture.  
Il faudrait avoir un usage programme pour compléter la documentation.
</BR>
</BR>

====Imprimer numéro fichier ajouté (ID)====
Indiquez Y ou O pour ajouter le numéro de spool ajouté sur la dernière ligne du spool généré. </BR>
Dans notre exemple précédent, on aura alors en dernière ligne de chaque page la valeur 1 ou 2 en fonction de si on est sur un relevé client ou une facture.
</BR>

====Code page (CP)====
Indique l'encodage du fichier spool en entrée.
</BR>

===MAPQUASPL===
Cette commande prend en paramètre le fichier physique créé précédement par les différentes éxécutions du MAPSORTPAG. Celle-ci va créer un fichier spool avec des données supplémentaires utilises pour la pagination et la mise sous pli automatique.
</BR>
</BR>

 Database for sort . . . . . . .  SORTDB          SORTDB
 Line number . . . . . . . . . .  1               1-255
 Column number . . . . . . . . .  1               1-360
 Create spooled file . . . . . .  *YES            *YES, *NO
 Spooled file name . . . . . . .  SORTSPLF        Nom
 OUTQ name . . . . . . . . . . .  *JOB            Nom, *JOB
 OUTQ library . . . . . . . . . . *LIBL           Nom, *LIBL
 Release new spooled file . . . . *NO             *YES, *NO
 Control sort splfname . . . . .  N               O, Y, N, V
 Width of input spooled file . .  255             80, 132, 198, 255, 378
 Spooled file height . . . . . .  255             66 to 255
 Overflow line . . . . . . . . .  60              1 to 255
 Translation code . . . . . . . . 7               7, 8, R, 4, F, T
 Sequence modulo . . . . . . . .  ' '             7, 8, R, 4, ' ', T
 Maximum Quota . . . . . . . . .  0               0,1,2,3,4,...
 Duplex . . . . . . . . . . . . . N               O, Y, N
 Add criteria size information .  N               O, Y, N
 Add number of break values . . . N               O, Y, N
 Insert tag on last page . . . .  N               O, Y, N
 Source Library . . . . . . . . . MAP$$SORT       MAP$$SORT,...
 Autres paramètres
 Spooled file name . . . . . . .                  Alphanum.       value,10max
 Spooled file number . . . . . .                  -1*LAST 00000-99999
 Job name . . . . . . . . . . . . *CURRENT        Name, *CURRENT
 Job number . . . . . . . . . . .                 Number on 6 digits
 Name on 10 characters max . . .  *CURRENT        Name, *CURRENT

====Exemple d'éxécutions====

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C) JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)
 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT)
</BR>

====Analyse de la ligne ajoutée====
Les numéros suivants correspondent aux positions de début et de fin

Voici un exemple d'enrichissement : 

 <span style="background-color:green"> 1</span> <span style="background-color:yellow">2</span><span style="background-color:cyan">1</span><span style="background-color:lime">1</span><span style="background-color:pink">111</span><span style="background-color:#d1f2eb">1</span> <span style="background-color:#fcf3cf">1</span> <span style="background-color:#fdedec">3</span> 

*<span style="background-color:green">De 1 à 6</span> : Le numéro de la page à l’intérieur de la rupture.</BR>
*<span style="background-color:yellow">De 7 à 12</span> : Le nombre total de pages à l’intérieur de la rupture.</BR>
*<span style="background-color:cyan">De 13 à 13</span> : Le code de rupture. </BR>
&emsp;&emsp;&emsp;1 pour la première page de la rupture</BR>
&emsp;&emsp;&emsp;2 pour une page de suite dans la rupture</BR>
&emsp;&emsp;&emsp;3 pour la dernière page de la rupture</BR>
*De 14 à 18 : Code de mise sous pli type kern :</BR>
&emsp;&emsp;&emsp;<span style="background-color:lime">Bit de parité</span>. Si la somme des bits de sécurité et d’ejection est paire, alors valeur 1. (dans notre cas, si la somme des bits violet et jaune est paire, alors 1 sinon 0)</BR>
&emsp;&emsp;&emsp;<span style="background-color:pink">Bits de sécurité</span> : </BR>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;Si modulo 7, valeur décroissante de 7 à 1 (de 111 à 001 en binaire). Cela pour tout le lot de feuille, sans tenir compte des ruptures</BR>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;8, valeur décroissante de 7 à 0 (de 111 à 000 en binaire)</BR>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;T, valeur croissante de 1 à 7 (de 001 à 111 en binaire)</BR>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;R, valeur croissante de 0 à 7 (de 000 à 111 en binaire)</BR>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;4, valeur décroissante de 3 à 0 (de 11 à 00 en binaire)</BR>
&emsp;&emsp;&emsp;&emsp;&emsp;&emsp;F, valeur croissante de 1 à 15 (de 0001 à 1111 en binaire)</BR>
*<span style="background-color:#d1f2eb">De 19 à 19</span> : Code de fermeture enveloppe. Suivant la machine de mise sous pli, le code se situe sur la première page du paquet ou sur la dernière. Dans la commande MAPQUALSPL, paramétrer la valeur du paramètre « Insert tag on last page » est à O ou Y, alors le code sera sur la dernière page du paquet. Sinon, il sera sur la première page du paquet. (un paquet correspond à une enveloppe soit une facture par exemple)</BR>
*<span style="background-color:#fcf3cf">De 20 à 25</span> : Le numéro de pli (de rupture) en cours, si demandé (Si BREAKNB=Y)</BR>
*<span style="background-color:#fdedec">De 26 à 29</span> : Le code de sécurité pour le numéro du pli en cours, si demandé (SI BREAKNB=Y)</BR>
</BR>

====Database pour le tri (NAME)====
Ce paramètre prend le nom du fichier physique généré par les MAPSORTPAG
</BR>
</BR>

====Numéro de ligne (LINE) / Numéro de colonne (COL)====
Ce paramètre indiquer la position où ajouter les informations de mise sous pli. (Choisir de préférence une ligne vide.)
</BR>
</BR>

====Créer un fichier spool (CREATE)====
Ce paramètre indique la création ou nom d'un fichier spool
</BR>
</BR>

====Nom du fichier spool (SPLFNAME) / Nom de l'OUTQ (OUTQ) / Bibliothèque de l'OUTQ (OUTQLIB) / Fichier prêt en sortie (RDY)====
Si CREATE=YES
Ces paramètres indiquent le nom , l'emplacement et le statut du fichier spool à créer.
</BR>
</BR>

====Contrôle sort splfname (CONTROLE)====
Ce paramètre permet de lancer l'éclatement du fichier spool sur les indexes.

Pour ce paramètre, indiquez N si vous ne désirez qu’un seul spool, ou Y (ou O) si vous désirez un fichier spool par rupture. La référence du spool contiendra alors les 10 premiers caractères du code en rupture.
Si vous indiquez V dans la zone Control sort, les spools générés le seront par leur nombre de pages, ainsi que la référence de ces spools.

*Y
*O
*V
*N
</BR>

====Largeur du spool en entrée (SIZE) / Hauteur du fichier spool (HEIGHT) / Ligne d'overflow (OVERFLOW)====
Ces paramètres donnes la taille du fichier spool généré
</BR>
</BR>

====Code traductions (MODULO)====
Ce paramètre indique comment les bits de sécurités doivent être insérés. Cela dépend de la machine de mise sous pli.
Ce paramètre donne la séquence d'éxécution des bits de sécurité affichés en rose dans notre exemple ci-dessus. </BR>
'''La différence par rapport à la séquence modulo (paramètre suivant)''', c'est que les bits ne sont pas remis à 0 lors d'un changement de lot (numéro de facture par exemple).
'''La séquence se suit de la 1er page du spool jusqu'à la dernière.''' (voir les exemples en bas de ce document)
</BR></BR>
*Si modulo 7, valeur décroissante de 7 à 1 (de 111 à 001 en binaire). 
*8, valeur décroissante de 7 à 0 (de 111 à 000 en binaire)</BR>
*T, valeur croissante de 1 à 7 (de 001 à 111 en binaire)</BR>
*R, valeur croissante de 0 à 7 (de 000 à 111 en binaire)</BR>
*4, valeur décroissante de 3 à 0 (de 11 à 00 en binaire)</BR>
*F, valeur croissante de 1 à 15 (de 0001 à 1111 en binaire)</BR>
</BR>
Rappel : Cela pour tout le lot de feuilles, sans tenir compte des ruptures</BR>

 1 210<span style="background-color:yellow">111</span>1
</BR>

====Modulo sur séquence (MODSEQ)====
Contrairement au MODULO simple, la séquence de bit est réinialisée au début de chaque nouveau lot. (voir les exemples en bas de ce document)
 1 2101111 <span style="background-color:yellow">111</span>
</BR>

====Quota maximum (QUOTA)====


On souhaite éditer un spool avec mise sous pli, mais on a un code client ou plus qui ont trop de pages. La machine de mise sous pli n’arrive pas à mettre plus de 10 pages dans le même pli. Dans ce cas, utilisez la zone quota pour limiter le nombre de pages dans un seul pli. 
                                             
 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C) JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)
 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) '''QUOTA(2)'''  LIB(LIBSORT)                  

Cela aura pour effet de changer le bit du code de fermeture enveloppe. Etant donnée que celui-ci vaut 1 à chaque début d'enveloppe, celui-ci vaudra donc 1 pour les page 1, 3, 5 (vu qu'on demande de faire rentrer uniquement 2 pages par enveloppe)

Page 1 : 1     611111'''1'''</BR>
Page 2 : 2     621110'''0'''</BR>
Page 3 : 3     620101'''1'''</BR>
Page 4 : 4     620100'''0'''</BR>

</BR>
</BR>

====Recto/Verso (DUPLEX)====

On décide d’imprimer en recto.verso afin de gagner en nombre de pages.

Il suffit alors d’indiquer O ou Y dans la zone Duplex. Le calcul des codes OMR tiendra compte de cette option dans le calcul des bits de sécurité.
                                            
 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C) JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)                                                 


 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) '''DUPLEX(Y)''' LIB(LIBSORT)                 

Page 1 : 1     1311111</BR>
Page 2 : 1     1311111</BR>
Page 3 : 1     2101101</BR>
Page 4 : 1     2101101</BR>
Page 5 : 2     2311010</BR>
Page 6 : 2     2311010</BR>
Page 7 : 1     2111001</BR>
Page 8 : 1     2111001</BR>
Page 9 : 2     2310110</BR>
Page 10 : 2     2310110</BR>

Nous pouvons voir que la séquence retournée par le MAPQUALSPL est la même sur 2 pages consécutives.</BR>
Cela est normal vu que la page 2 se situe sur la 1er feuille. Donc les valeurs de la page 1 et 2 sont les mêmes (idem pour 3 et 4, 5 et 6, etc)

remarque : Les 2 premiers bit ne donnent pas le numéro de pages mais le numéro de feuilles.
</BR>

====Ajouter la taille du critère (SORTPAGE)====
A compléter
</BR>

====Ajouter le nombre de ruptures (BREAKNB )====
Ce paramètre permet d'imprimer le numéro de rupture en cours ainsi que le code de sécurité pour le numéro de pli en cours. </BR>

                                              
 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C) JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)                                                 
 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) '''BREAKNB(Y)''' LIB(LIBSORT)                           

 1     6111111     '''1     3'''                                                                  


De 20 à 25 : Le numéro de pli (de rupture) en cours, si demandé (Si BREAKNB=Y)</BR>
De 26 à 29 : Le code de sécurité pour le numéro du pli en cours, si demandé (SI BREAKNB=Y)</BR>
</BR>

====Insérer mot sur dernière page (INSLAST )====


Selon les machines de mise sous pli,le code de fermeture enveloppe indiquant qu’il faut changer d’enveloppe doit figurer sur la première page du nouveau paquet ou sur la dernière page de l’ancien paquet.
Saisir O ou Y imprimera ce code sur la dernière page du paquet. N l’imprimera sur la première page.
</BR>

====Bibliothèque Origine (LIB)====
Ce paramètre indique le nom de la bibliotèque contenant le fichier physique à traiter

==Exemples==

===MODULO(7)=== 

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C)  JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)         

 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) SORTPAGE(N) BREAKNB(N) LIB(LIBSORT)               


{| class="wikitable"
|-
! Page !! Code retournée par MAPQUALSPL
|-
| 1 || 1     2111111
|-
| 2 || 2     2311100
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 3 || 1     4101011
|-
| 4 || 2     4201000
|-
| 5 || 3     4210110
|-
| 6 || 4     4300100
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 7 || 1     4110011
|-
| 8 || 2     4201110
|-
| 9 || 3     4211100
|-
| 10 || 4     4311010
|-
|}


===MODULO(F)===

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C)  JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)         

 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQ LIB(MAPFIL_JDI) MODULO(F) SORTPAGE(N) BREAKNB(N) LIB(LIBSORT)     
        

{| class="wikitable"
|-
! Page !! Code retournée par MAPQUALSPL
|-
| 1 || 1     211'''0001'''1
|-
| 2 || 2     230'''0010'''0
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 3 || 1     410'''0011'''1
|-
| 4 || 2     420'''0100'''0
|-
| 5 || 3     421'''0101'''0
|-
| 6 || 4     431'''0110'''0
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 7 || 1     411'''0111'''1
|-
| 8 || 2     420'''1000'''0
|-
| 9 || 3     421'''1001'''0
|-
| 10 || 4     431'''1010'''0
|-
|}


On peut voir qu'il y a un bit en plus pour le code de sécurité. (avec le modulo=7 on avait 3 bits alors qu'avec le F on en a 4 (pour aller des valeurs 1 à 15)
Dans notre exemple, on va de 1 à 10. 

===MODULO(7) et MODSEQ(7)===
 
 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C)  JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)         

 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) SORTPAGE(N) BREAKNB(N) LIB(LIBSORT) MODSEQ(7)              

{| class="wikitable"
|-
! Page !! Code retournée par MAPQUALSPL
|-
| 1 || 1     2101111            111
|-
| 2 || 2     2301100            111
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 3 || 1     4101011            110
|-
| 4 || 2     4201000            110
|-
| 5 || 3     4210110            110
|-
| 6 || 4     4300100            110
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 7 || 1     4110011            101
|-
| 8 || 2     4201110            101
|-
| 9 || 3     4211100            101
|-
| 10 || 4     4311010            101
|-
|}


La valeur de séquence de modulo change à chaque rupture de lot. Dans notre exemple, le MODSEQ=7  génère 3 bits commençant par 15 (111) et décroit à chaque changement de lot (110,etc) 

===BREAKNB(Y) et MODULO(7)===

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C)  JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)         

 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) SORTPAGE(N) BREAKNB(Y) LIB(LIBSORT)               

{| class="wikitable"
|-
! Page !! Code retournée par MAPQUALSPL
|-
| 1 || 1     2111111     1     3
|-
| 2 || 2     2311100     1     3
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 3 || 1     4101011     2     3
|-
| 4 || 2     4201000     2     3 
|-
| 5 || 3     4210110     2     3 
|-
| 6 || 4     4300100     2     3
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 7 || 1     4110011     3     3
|-
| 8 || 2     4201110     3     3
|-
| 9 || 3     4211100     3     3
|-
| 10 || 4     4311010     3     3
|-
|}

L'option NBBREAK ajoute les 2 dernier bit correspondant au lot en cours et au nombre total de lot.


===DUPLEX(Y) et MODULO(7)===

 MAPSORTPAG SPLF(SORTPAG1) SPLNUM(000002) JOB(QPADEV000C)  JOBNUM(693999) USER(JDIEU) KEYLINE(3) KEYCOL(71) KEYLGN(7) CREATE(*NO) SPLFNAME(MAPSORTPAG) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) LIB(LIBSORT) NAME(SORTDBFILE)         

 MAPQUALSPL NAME(SORTDBFILE) SPLFNAME(OUTPUT) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) SORTPAGE(N) DUPLEX(Y) LIB(LIBSORT)               


{| class="wikitable"
|-
! Page !! Code retournée par MAPQUALSPL
|-
| 1 || 1     1311111
|-
| 2 || 1     1311111
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 3 || 1     2101101
|-
| 4 || 1     2101101
|-
| 5 || 2     2311010
|-
| 6 || 2     2311010
|-
| RUPTURE DE FACTURE || RUPTURE DE FACTURE
|-
| 7 || 1     2111001
|-
| 8 || 1     2111001
|-
| 9 || 2     2310110
|-
| 10 || 2     2310110
|-
|}

<u>Remarque</u> : Les 2 premiers bit retournent non pas la page et le nombre de page total du lot mais la feuille et le nombre total de feuille du lot.