Différence entre versions

Version actuelle datée du 21 décembre 2020 à 13:58

Sommaire

1 Introduction
2 Principe de fonctionnement
3 Syntaxe
4 Exemple
5 Interprétation côté Onyx

Introduction

Depuis la version 10.3.0 de MAPPING IBM-i, il est possible d'enrichir un fichier spool avec ses attributs grâce à la commande MAPENRSPLF. Cette commande est incluse depuis cette version lors de l'installation de MAPPING IBM-i. En effet, le spool une fois enrichi pourra alors être envoyé à MAPPING Windows/Linux via une simple remote outq native à l'OS400. Les attributs présents dans le fichier spool pourront alors être utilisés dans les traitements des workflows de MAPPING Windows/Linux.

Principe de fonctionnement

La commande MAPENRSPLF permet de prendre un fichier spool en entrée et de générer le spool à l'identique mais avec à la fin de la 1er page, tous les attributs de ce dît spool.

Syntaxe

La commande MAPENRSPLF comprend les paramètres suivants :

Spool file name  . . . . . . . .                 Nom                            Nom du spool d'origine
Spool file number  . . . . . . .   *LAST         Valeur alphanum, *LAST, *ONLY  Numéro du spool d'origine
Job name . . . . . . . . . . . .   *CURRENT      Nom, *CURRENT                  Nom du spool d'origine
Job number . . . . . . . . . . .                 Valeur alphanum                Numéro de job du spool d'origine
User name  . . . . . . . . . . .   *CURRENT      Nom, *CURRENT                  Utilisateur du spool d'origine
Outq name  . . . . . . . . . . .                 Nom                            Nom de l'OUTQ du spool de destination
Outq library . . . . . . . . . .                 Nom, *LIBL                     Nom de la bib de l'OUTQ du spool de destination
                                                                             
                          Autres paramètres                                  
                                                                             
Spool file name  . . . . . . . .   *SAME         Nom, *SAME                     Nom du fichier spool de destination
Delete original after  . . . . .   *NO           *NO, *YES                      Supprimer le fichier spool d'origine ?
Hold the generated spool . . . .   *SAME         *NO, *YES, *SAME               Suspendre le spool de destination
Save the generated spool . . . .   *SAME         *NO, *YES, *SAME               Sauvegarde le spool de destination
Starting page  . . . . . . . . .   *SPLF         Nombre, *SPLF, *ENDPAGE        Première page du spool d'origine à traiter
Ending page  . . . . . . . . . .   *SPLF         Nombre, *SPLF, *END            Dernière page du spool d'origine à traiter

Exemple

MAPENRSPLF SPLF(A000000001) SPLNUM(39) JOB(QPADEV0001) JOBNUM(001687) USER(JDIEU) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) SPLFOUT(MAPENRSPLF)

Cette commande prend en entrée le fichier spool SPLF(A000000001) SPLNUM(39) JOB(QPADEV0001) JOBNUM(001687) USER(JDIEU). La commande génèrera un fichier spool portant pour nom MAPENRSPLF et ayant le contenu suivant à la fin de sa première page

[%---------- MAPPING ENRICHMENT ----------%]  
     [%SPLF%] A000000001                     
   [%SPLNUM%] 000039                         
      [%JOB%] QPADEV0001 
   [%JOBNUM%] 001687     
     [%USER%] JDIEU      
    [%OWNER%] JDIEU      
  [%ACGCODE%]            
 [%USERDATA%]            
  [%PRTTEXT%]            
 [%USERTEXT%]            
[%USERDFNDTA%] *NONE      
 [%FORMTYPE%] *STD       
     [%HOLD%] *NO        
     [%SAVE%] *YES       
 [%TOTPAGES%] 000004     
 [%PRTPAGES%] 000004     
  [%STRPAGE%] 000001     
  [%ENDPAGE%] 000004     
   [%COPIES%] 001        
      [%LPI%] 06         
      [%CPI%] 10
  [%PRIORITY%]  5         
      [%OUTQ%] TESTAUTO   
   [%OUTQLIB%] TESTAUTO   
  [%OPENDATE%] 1180726    
  [%OPENTIME%] 180759     
    [%DEVICE%] RESTOREPAG 
 [%DEVICELIB%] MAPCERT72  
      [%PROG%]            
   [%PROGLIB%]            
[%PAGEHEIGHT%] 255        
 [%PAGEWIDTH%] 360        
[%OVRFLWLINE%] 060        
     [%CHRID%] *DEVD      
     [%CCSID%] 065535

Interprétation côté Onyx

Avec cet exemple, il suffit ensuite de récupérer chacune des valeurs correspondantes à l'aide de boites workflow Attribut. Il sera alors possible de les utiliser dans le ou les workflows de traitements.

@@ Ligne 3 : / Ligne 3 : @@
 En effet, le spool une fois enrichi pourra alors être envoyé à MAPPING Windows/Linux via une simple remote outq native à l'OS400.
 Les attributs présents dans le fichier spool pourront alors être utilisés dans les traitements des workflows de MAPPING Windows/Linux.
+==Principe de fonctionnement==
+La commande MAPENRSPLF permet de prendre un fichier spool en entrée et de générer le spool à l'identique mais avec à la fin de la 1er page, tous les attributs de ce dît spool.
 ==Syntaxe==
@@ Ligne 12 : / Ligne 15 : @@
   Job number . . . . . . . . . . .                 Valeur alphanum                <span style="color:red">Numéro de job du spool d'origine</span>
   User name  . . . . . . . . . . .   *CURRENT      Nom, *CURRENT                  <span style="color:red">Utilisateur du spool d'origine</span>
-  Outq name  . . . . . . . . . . .                 Nom                            <span style="color:red">Nom de l'OUTQ du spool d'origine</span>
+  Outq name  . . . . . . . . . . .                 Nom                            <span style="color:red">Nom de l'OUTQ du spool de destination</span>
-  Outq library . . . . . . . . . .                 Nom, *LIBL                     <span style="color:red">Nom de la bib de l'OUTQ du spool d'origine/span>
+  Outq library . . . . . . . . . .                 Nom, *LIBL                     <span style="color:red">Nom de la bib de l'OUTQ du spool de destination</span>
                             Autres paramètres
@@ Ligne 19 : / Ligne 22 : @@
   Spool file name  . . . . . . . .   *SAME         Nom, *SAME                     <span style="color:red">Nom du fichier spool de destination</span>
   Delete original after  . . . . .   *NO           *NO, *YES                      <span style="color:red">Supprimer le fichier spool d'origine ?</span>
-  Hold the generated spool . . . .   *SAME         *NO, *YES, *SAME               <span style="color:red">Suspendre le spool de destination </span>
+  Hold the generated spool . . . .   *SAME         *NO, *YES, *SAME               <span style="color:red">Suspendre le spool de destination</span>
-  Save the generated spool . . . .   *SAME         *NO, *YES, *SAME
+  Save the generated spool . . . .   *SAME         *NO, *YES, *SAME               <span style="color:red">Sauvegarde le spool de destination</span>
-  Starting page  . . . . . . . . .   *SPLF         Nombre, *SPLF, *ENDPAGE
+  Starting page  . . . . . . . . .   *SPLF         Nombre, *SPLF, *ENDPAGE        <span style="color:red">Première page du spool d'origine à traiter</span>
-  Ending page  . . . . . . . . . .   *SPLF         Nombre, *SPLF, *END
+  Ending page  . . . . . . . . . .   *SPLF         Nombre, *SPLF, *END            <span style="color:red">Dernière page du spool d'origine à traiter</span>
+==Exemple==
+ MAPENRSPLF SPLF(A000000001) SPLNUM(39) JOB(QPADEV0001) JOBNUM(001687) USER(JDIEU) OUTQ(JDIEU_OUTQ) OUTQLIB(MAPFIL_JDI) SPLFOUT(MAPENRSPLF)
+Cette commande prend en entrée le fichier spool SPLF(A000000001) SPLNUM(39) JOB(QPADEV0001) JOBNUM(001687) USER(JDIEU). La commande génèrera un fichier spool portant pour nom '''MAPENRSPLF''' et ayant le contenu suivant à la fin de sa première page
+ [%---------- MAPPING ENRICHMENT ----------%]
+      [%SPLF%] A000000001
+    [%SPLNUM%] 000039
+       [%JOB%] QPADEV0001
+    [%JOBNUM%] 001687
+      [%USER%] JDIEU
+     [%OWNER%] JDIEU
+   [%ACGCODE%]
+  [%USERDATA%]
+   [%PRTTEXT%]
+  [%USERTEXT%]
+ [%USERDFNDTA%] *NONE
+  [%FORMTYPE%] *STD
+      [%HOLD%] *NO
+      [%SAVE%] *YES
+  [%TOTPAGES%] 000004
+  [%PRTPAGES%] 000004
+   [%STRPAGE%] 000001
+   [%ENDPAGE%] 000004
+    [%COPIES%] 001
+       [%LPI%] 06
+       [%CPI%] 10
+   [%PRIORITY%]  5
+       [%OUTQ%] TESTAUTO
+    [%OUTQLIB%] TESTAUTO
+   [%OPENDATE%] 1180726
+   [%OPENTIME%] 180759
+     [%DEVICE%] RESTOREPAG
+  [%DEVICELIB%] MAPCERT72
+       [%PROG%]
+    [%PROGLIB%]
+ [%PAGEHEIGHT%] 255
+  [%PAGEWIDTH%] 360
+ [%OVRFLWLINE%] 060
+      [%CHRID%] *DEVD
+      [%CCSID%] 065535
+==Interprétation côté Onyx==
+Avec cet exemple, il suffit ensuite de récupérer chacune des valeurs correspondantes à l'aide de '''boites workflow Attribut'''.
+Il sera alors possible de les utiliser dans le ou les workflows de traitements.