OPALE - 10.0 - Utilisation - MAPRMTPROC
Différence entre versions
(Cette version a été marquée pour être traduite) |
|||
| Ligne 1 : | Ligne 1 : | ||
<translate> | <translate> | ||
| − | ==Généralités== | + | ==Généralités== <!--T:1--> |
Le Workflow Mapping est le nouveau moteur de règles disponible à partir de Mapping Windows et Mapping UNIX 7.0.36. En termes de fonctionnalités et de performances, le Workflow Mapping est bien plus puissant que le Robot Mapping sur iSeries. | Le Workflow Mapping est le nouveau moteur de règles disponible à partir de Mapping Windows et Mapping UNIX 7.0.36. En termes de fonctionnalités et de performances, le Workflow Mapping est bien plus puissant que le Robot Mapping sur iSeries. | ||
| + | <!--T:2--> | ||
Un connecteur iSeries Workflow a donc été développé de manière à pouvoir bénéficier des fonctionnalités du Workflow Mapping sur les documents iSeries. Pour cela, nous utilisons le MapSOAPServer connecté au Workflow sur la partie hôte (UNIX ou Windows) ainsi que la commande MAPRMTPROC sur la partie client (iSeries). Par conséquent, Mapping doit être installé des deux côtés. | Un connecteur iSeries Workflow a donc été développé de manière à pouvoir bénéficier des fonctionnalités du Workflow Mapping sur les documents iSeries. Pour cela, nous utilisons le MapSOAPServer connecté au Workflow sur la partie hôte (UNIX ou Windows) ainsi que la commande MAPRMTPROC sur la partie client (iSeries). Par conséquent, Mapping doit être installé des deux côtés. | ||
| + | <!--T:3--> | ||
Lorsque les fichiers spool iSeries sont envoyés au serveur Mapping, une règle Workflow exécute une série de commandes et génère l'output. Si nécessaire, l'output peut ensuite être renvoyé à l'iSeries avec des messages log. | Lorsque les fichiers spool iSeries sont envoyés au serveur Mapping, une règle Workflow exécute une série de commandes et génère l'output. Si nécessaire, l'output peut ensuite être renvoyé à l'iSeries avec des messages log. | ||
| + | <!--T:4--> | ||
[[Fichier:MAPRMTPROC GENERALITE.png|centré|837x837px|alt=|sans_cadre]] | [[Fichier:MAPRMTPROC GENERALITE.png|centré|837x837px|alt=|sans_cadre]] | ||
| − | ==Pré-requis== | + | ==Pré-requis== <!--T:5--> |
Veuillez vérifier que la communication réseau entre l'iSeries et le serveur Mapping distant sur lequel tourne le Workflow puisse être établie par l'intermédiaire du protocole HTTP – vérifier adresses IP, pare-feu, antivirus, etc. | Veuillez vérifier que la communication réseau entre l'iSeries et le serveur Mapping distant sur lequel tourne le Workflow puisse être établie par l'intermédiaire du protocole HTTP – vérifier adresses IP, pare-feu, antivirus, etc. | ||
| + | <!--T:6--> | ||
Le MapSOAPServer doit être configuré correctement. Vous trouverez les paramètres de configuration détaillée du MapSOAPServer dans la documentation sur les Services Web Mapping. | Le MapSOAPServer doit être configuré correctement. Vous trouverez les paramètres de configuration détaillée du MapSOAPServer dans la documentation sur les Services Web Mapping. | ||
| − | ==Boites de Workflow utiles== | + | ==Boites de Workflow utiles== <!--T:7--> |
| − | ===Convert from iSeries=== | + | ===Convert from iSeries=== <!--T:8--> |
La commande “Convert from iSeries” (dans le groupe Mapping) permet de convertir un fichier spool EBCDIC en Unicode. | La commande “Convert from iSeries” (dans le groupe Mapping) permet de convertir un fichier spool EBCDIC en Unicode. | ||
| + | <!--T:9--> | ||
(Voir documentation « WorkFlow_ConvertFromISeries.pdf » pour plus d’informations) | (Voir documentation « WorkFlow_ConvertFromISeries.pdf » pour plus d’informations) | ||
| − | ===iSeries Response=== | + | ===iSeries Response=== <!--T:10--> |
La commande « iSeries Response » (dans le groupe Web Interactivity) permet d'envoyer une réponse à la commande iSeries. La réponse peut être un fichier (*USERASCII ou *AFPDS) ou un message (entrée JOBLOG ou mise à jour d'une DTAARA). | La commande « iSeries Response » (dans le groupe Web Interactivity) permet d'envoyer une réponse à la commande iSeries. La réponse peut être un fichier (*USERASCII ou *AFPDS) ou un message (entrée JOBLOG ou mise à jour d'une DTAARA). | ||
| + | <!--T:11--> | ||
(Voir documentation « WorkFlow_ISeriesResponse.pdf » pour plus d’informations) | (Voir documentation « WorkFlow_ISeriesResponse.pdf » pour plus d’informations) | ||
| − | ==MAPRMTPROC== | + | ==MAPRMTPROC== <!--T:12--> |
Cette commande AS/400 permet d’envoyer un spool file de l’AS/400 vers le moteur de règles (Workflow) de M-Processing Server. | Cette commande AS/400 permet d’envoyer un spool file de l’AS/400 vers le moteur de règles (Workflow) de M-Processing Server. | ||
| − | ===Paramètres de la commande sur AS/400=== | + | ===Paramètres de la commande sur AS/400=== <!--T:13--> |
{| class="wikitable" | {| class="wikitable" | ||
|Spooled File | |Spooled File | ||
| Ligne 66 : | Ligne 72 : | ||
|OUTQ de destination du fichier d'entrée. Laisser vide si | |OUTQ de destination du fichier d'entrée. Laisser vide si | ||
| + | <!--T:14--> | ||
N/A | N/A | ||
|Alpha | |Alpha | ||
| Ligne 80 : | Ligne 87 : | ||
|Nom de la règle du workflow à exécuter (laisser vide si | |Nom de la règle du workflow à exécuter (laisser vide si | ||
| + | <!--T:15--> | ||
workflow root) | workflow root) | ||
|Alpha | |Alpha | ||
| Ligne 108 : | Ligne 116 : | ||
|} | |} | ||
| − | ===Paramètres reçus par le workflow=== | + | ===Paramètres reçus par le workflow=== <!--T:16--> |
Les paramètres de fichier spool suivants sont envoyés avec le fichier spool et sont à disposition dans le Workflow. | Les paramètres de fichier spool suivants sont envoyés avec le fichier spool et sont à disposition dans le Workflow. | ||
| + | <!--T:17--> | ||
• HTTP_HOST= adresse IP de l'hôte | • HTTP_HOST= adresse IP de l'hôte | ||
| + | <!--T:18--> | ||
• HTTP_ISERIES_CONTENT= type de données envoyées (spool_data) | • HTTP_ISERIES_CONTENT= type de données envoyées (spool_data) | ||
| + | <!--T:19--> | ||
• HTTP_ISERIES_JOB_NAME= nom du job | • HTTP_ISERIES_JOB_NAME= nom du job | ||
| + | <!--T:20--> | ||
• HTTP_ISERIES_USR_NAME= nom de l'utilisateur | • HTTP_ISERIES_USR_NAME= nom de l'utilisateur | ||
| + | <!--T:21--> | ||
• HTTP_ISERIES_JOB_NUMBER= numéro du job | • HTTP_ISERIES_JOB_NUMBER= numéro du job | ||
| + | <!--T:22--> | ||
• HTTP_ISERIES_SPLF_NAME= nom du fichier spool | • HTTP_ISERIES_SPLF_NAME= nom du fichier spool | ||
| + | <!--T:23--> | ||
• HTTP_ISERIES_FORM_TYPE= type de formulaire | • HTTP_ISERIES_FORM_TYPE= type de formulaire | ||
| + | <!--T:24--> | ||
• HTTP_ISERIES_USR_DATA= données utilisateur | • HTTP_ISERIES_USR_DATA= données utilisateur | ||
| + | <!--T:25--> | ||
• HTTP_ISERIES_OUTQ_NAME= outq du fichier d'entrée | • HTTP_ISERIES_OUTQ_NAME= outq du fichier d'entrée | ||
| + | <!--T:26--> | ||
• HTTP_ISERIES_OUTQ_LIB= bibliothèque de l'outq | • HTTP_ISERIES_OUTQ_LIB= bibliothèque de l'outq | ||
| + | <!--T:27--> | ||
• HTTP_ISERIES_PGM_NAME= programme qui a ouvert le fichier | • HTTP_ISERIES_PGM_NAME= programme qui a ouvert le fichier | ||
| + | <!--T:28--> | ||
• HTTP_ISERIES_PGM_LIB= bibliothèque du programme | • HTTP_ISERIES_PGM_LIB= bibliothèque du programme | ||
| + | <!--T:29--> | ||
• HTTP_ISERIES_COUNT_CODE= code compta | • HTTP_ISERIES_COUNT_CODE= code compta | ||
| + | <!--T:30--> | ||
• HTTP_ISERIES_USER_TEXT= données spécifiques utilisateur | • HTTP_ISERIES_USER_TEXT= données spécifiques utilisateur | ||
| + | <!--T:31--> | ||
• HTTP_ISERIES_PRINTER_DEVICE_TYPE= type de device imprimante | • HTTP_ISERIES_PRINTER_DEVICE_TYPE= type de device imprimante | ||
| + | <!--T:32--> | ||
• HTTP_ISERIES_SPLF_NUMBER= numéro du fichier spool | • HTTP_ISERIES_SPLF_NUMBER= numéro du fichier spool | ||
| + | <!--T:33--> | ||
• HTTP_ISERIES_PAGE_LENGTH= longueur de la page | • HTTP_ISERIES_PAGE_LENGTH= longueur de la page | ||
| + | <!--T:34--> | ||
• HTTP_ISERIES_PAGE_WIDTH= largeur de la page | • HTTP_ISERIES_PAGE_WIDTH= largeur de la page | ||
| + | <!--T:35--> | ||
• HTTP_ISERIES_CCSID= CCSID | • HTTP_ISERIES_CCSID= CCSID | ||
| + | <!--T:36--> | ||
• HTTP_ISERIES_TOTAL_COPIES= nombre total de copies | • HTTP_ISERIES_TOTAL_COPIES= nombre total de copies | ||
| + | <!--T:37--> | ||
• HTTP_ISERIES_LINES_PER_INCH= lignes par inch | • HTTP_ISERIES_LINES_PER_INCH= lignes par inch | ||
| + | <!--T:38--> | ||
• HTTP_ISERIES_CHAR_PER_INCH= caractères par inch | • HTTP_ISERIES_CHAR_PER_INCH= caractères par inch | ||
| + | <!--T:39--> | ||
• HTTP_ISERIES_OUTPUT_PRIORITY= priorité d'output | • HTTP_ISERIES_OUTPUT_PRIORITY= priorité d'output | ||
| + | <!--T:40--> | ||
• HTTP_ISERIES_DEV_FILE_NAME= nom du fichier device | • HTTP_ISERIES_DEV_FILE_NAME= nom du fichier device | ||
| + | <!--T:41--> | ||
• HTTP_ISERIES_DEV_FILE_LIB= bibliothèque du fichier device | • HTTP_ISERIES_DEV_FILE_LIB= bibliothèque du fichier device | ||
| + | <!--T:42--> | ||
• HTTP_ISERIES_TIME_FILE_OPEN= temps pendant lequel le fichier a été ouvert | • HTTP_ISERIES_TIME_FILE_OPEN= temps pendant lequel le fichier a été ouvert | ||
| + | <!--T:43--> | ||
• HTTP_ISERIES_DATE_FILE_OPEN= date à laquelle le fichier a été ouvert | • HTTP_ISERIES_DATE_FILE_OPEN= date à laquelle le fichier a été ouvert | ||
| + | <!--T:44--> | ||
• HTTP_ISERIES_PRINT_TEXT= impression texte | • HTTP_ISERIES_PRINT_TEXT= impression texte | ||
| + | <!--T:45--> | ||
• HTTP_ISERIES_SOURCE_DRAWER= bac source | • HTTP_ISERIES_SOURCE_DRAWER= bac source | ||
| + | <!--T:46--> | ||
• HTTP_ISERIES_OUTPUT_BIN= bac de sortie | • HTTP_ISERIES_OUTPUT_BIN= bac de sortie | ||
| + | <!--T:47--> | ||
• HTTP_ISERIES_JOB_SYSTEM_NAME= nom système du job | • HTTP_ISERIES_JOB_SYSTEM_NAME= nom système du job | ||
| − | ===Réponses reçues par la commande=== | + | ===Réponses reçues par la commande=== <!--T:48--> |
Le type de réponse dépend des paramètres configurés dans le workflow. La réponse peut être : | Le type de réponse dépend des paramètres configurés dans le workflow. La réponse peut être : | ||
| + | <!--T:49--> | ||
*Un fichier spool (*USERASCII ou *AFPDS) | *Un fichier spool (*USERASCII ou *AFPDS) | ||
*Un message dans la JOBLOG actuelle (*INFO ou *MESSAGE) | *Un message dans la JOBLOG actuelle (*INFO ou *MESSAGE) | ||
*Des données dans la DTAARA MAPRMTPROC dans QTEMP | *Des données dans la DTAARA MAPRMTPROC dans QTEMP | ||
| − | ==Exemples== | + | ==Exemples== <!--T:50--> |
| − | ===Envoi d’un spool vers ONYX Server=== | + | ===Envoi d’un spool vers ONYX Server=== <!--T:51--> |
| + | <!--T:52--> | ||
Le but est d’envoyer le spool file ayant les informations suivantes vers le workflow MAPRMTPROC.rules.xml de ONYX Server : | Le but est d’envoyer le spool file ayant les informations suivantes vers le workflow MAPRMTPROC.rules.xml de ONYX Server : | ||
| + | <!--T:53--> | ||
Spooled file . . . . . . . . . . > OLP | Spooled file . . . . . . . . . . > OLP | ||
| + | <!--T:54--> | ||
Spooled file number . . . . . . > 237 | Spooled file number . . . . . . > 237 | ||
| + | <!--T:55--> | ||
Job Name . . . . . . . . . . . . > QPRTJOB | Job Name . . . . . . . . . . . . > QPRTJOB | ||
| + | <!--T:56--> | ||
Job number . . . . . . . . . . . > 109341 | Job number . . . . . . . . . . . > 109341 | ||
| + | <!--T:57--> | ||
User . . . . . . . . . . . . . . > QTMPLPD | User . . . . . . . . . . . . . . > QTMPLPD | ||
| + | <!--T:58--> | ||
Différents points à réaliser : | Différents points à réaliser : | ||
| + | <!--T:59--> | ||
#Sur ONYX, créer un workflow : Ici appelé MAPRMTPROC | #Sur ONYX, créer un workflow : Ici appelé MAPRMTPROC | ||
#'''Remarque : Inutile de créer un point d’entrée''' | #'''Remarque : Inutile de créer un point d’entrée''' | ||
| Ligne 203 : | Ligne 251 : | ||
| + | <!--T:60--> | ||
a) Spécifier les attributs du spool file à envoyer | a) Spécifier les attributs du spool file à envoyer | ||
| + | <!--T:61--> | ||
[[Fichier:1A.png|centré|771x771px|alt=|sans_cadre]]<br />[[Fichier:2A.png|centré|795x795px|alt=|sans_cadre]] | [[Fichier:1A.png|centré|771x771px|alt=|sans_cadre]]<br />[[Fichier:2A.png|centré|795x795px|alt=|sans_cadre]] | ||
| + | <!--T:62--> | ||
b) Login et mot de passe pour le webservice (Apache) | b) Login et mot de passe pour le webservice (Apache) | ||
| + | <!--T:63--> | ||
c) Remote Server : L’adresse du Mapping Windows | c) Remote Server : L’adresse du Mapping Windows | ||
| + | <!--T:64--> | ||
d) Move to Queue : Pas obligatoire, cela dépend si on veut sauvegarder le spool dans une outqueue ou pas | d) Move to Queue : Pas obligatoire, cela dépend si on veut sauvegarder le spool dans une outqueue ou pas | ||
| + | <!--T:65--> | ||
e) Workflow name : Nom du workflow a exécuter sur Mapping Windows (si vide alors root sera utilisé) | e) Workflow name : Nom du workflow a exécuter sur Mapping Windows (si vide alors root sera utilisé) | ||
| + | <!--T:66--> | ||
f) Timeout de connexion éventuel | f) Timeout de connexion éventuel | ||
| + | <!--T:67--> | ||
L’envoi se fait via web service. Par conséquent, il ne faut pas s’attendre à avoir un spool dans le spooler. Le fichier arrive simplement dans le workflow. Pour le récupérer, il faut par exemple utiliser une boite de copie. Pour obtenir les variables récupérées, on peut faire un set qui est redirigé vers un fichier. | L’envoi se fait via web service. Par conséquent, il ne faut pas s’attendre à avoir un spool dans le spooler. Le fichier arrive simplement dans le workflow. Pour le récupérer, il faut par exemple utiliser une boite de copie. Pour obtenir les variables récupérées, on peut faire un set qui est redirigé vers un fichier. | ||
| + | <!--T:68--> | ||
Voici les variables récupérées : | Voici les variables récupérées : | ||
| + | <!--T:69--> | ||
*CONTENT_TYPE=text/plain | *CONTENT_TYPE=text/plain | ||
*CONTENT_LENGTH=16324 | *CONTENT_LENGTH=16324 | ||
| Ligne 258 : | Ligne 316 : | ||
| + | <!--T:70--> | ||
Toutes ces variables peuvent être utilisées dans le workflow (pour des conditions, nommage, ou autres). | Toutes ces variables peuvent être utilisées dans le workflow (pour des conditions, nommage, ou autres). | ||
| − | ===Renvoi du fichier généré par le workflow vers une outq iSeries=== | + | ===Renvoi du fichier généré par le workflow vers une outq iSeries=== <!--T:71--> |
| + | <!--T:72--> | ||
Le but est de renvoyer à l’iSeries un fichier provenant du workflow. | Le but est de renvoyer à l’iSeries un fichier provenant du workflow. | ||
| + | <!--T:73--> | ||
Le workflow ci-dessous reçoit un spool de l’AS/400, le convertit en Unicode et renvoie le fichier unicode vers l’AS/400 via la boite « iSeries Response » | Le workflow ci-dessous reçoit un spool de l’AS/400, le convertit en Unicode et renvoie le fichier unicode vers l’AS/400 via la boite « iSeries Response » | ||
| + | <!--T:74--> | ||
[[Fichier:3A.png|centré|alt=|sans_cadre|360x360px]] | [[Fichier:3A.png|centré|alt=|sans_cadre|360x360px]] | ||
| + | <!--T:75--> | ||
Détail de la boite « iSeries Response » : | Détail de la boite « iSeries Response » : | ||
| + | <!--T:76--> | ||
[[Fichier:4A.png|centré|1076x1076px|alt=|sans_cadre]] | [[Fichier:4A.png|centré|1076x1076px|alt=|sans_cadre]] | ||
| + | <!--T:77--> | ||
Résultat sur l’iSeries (dans l’Outq FMERCIER) : | Résultat sur l’iSeries (dans l’Outq FMERCIER) : | ||
| + | <!--T:78--> | ||
[[Fichier:5A.png|centré|1054x1054px|alt=|sans_cadre]] | [[Fichier:5A.png|centré|1054x1054px|alt=|sans_cadre]] | ||
| + | <!--T:79--> | ||
Remarque : | Remarque : | ||
| + | <!--T:80--> | ||
On pourrait de la même façon renvoyer un fichier XPS vers l’iSeries afin de l’imprimer à travers l’OutQ de l’AS/400 et non du spooler ONYX Server. | On pourrait de la même façon renvoyer un fichier XPS vers l’iSeries afin de l’imprimer à travers l’OutQ de l’AS/400 et non du spooler ONYX Server. | ||
| − | ==En cas de problème de connexion== | + | ==En cas de problème de connexion== <!--T:81--> |
| + | <!--T:82--> | ||
En cas de problème de connexion entre OPALE et ONYX , le job MAPRMTPROC va continuer à envoyer le spool jusqu’à ce que le timeout de connexion soit atteint (si un timeout est indiqué). | En cas de problème de connexion entre OPALE et ONYX , le job MAPRMTPROC va continuer à envoyer le spool jusqu’à ce que le timeout de connexion soit atteint (si un timeout est indiqué). | ||
| + | <!--T:83--> | ||
Si pendant ce temps plusieurs MAPRMTPROC sont réalisés, ils seront tous en "processing" sur le serveur jusqu’à ce que la connexion soit établie ou alors jusqu’à ce que le timeout soit atteint. | Si pendant ce temps plusieurs MAPRMTPROC sont réalisés, ils seront tous en "processing" sur le serveur jusqu’à ce que la connexion soit établie ou alors jusqu’à ce que le timeout soit atteint. | ||
<!-- Envoi spool AS400 // Migration AS400 Windows --> | <!-- Envoi spool AS400 // Migration AS400 Windows --> | ||
</translate> | </translate> | ||
Version du 28 mai 2019 à 08:13
Sommaire
Généralités
Le Workflow Mapping est le nouveau moteur de règles disponible à partir de Mapping Windows et Mapping UNIX 7.0.36. En termes de fonctionnalités et de performances, le Workflow Mapping est bien plus puissant que le Robot Mapping sur iSeries.
Un connecteur iSeries Workflow a donc été développé de manière à pouvoir bénéficier des fonctionnalités du Workflow Mapping sur les documents iSeries. Pour cela, nous utilisons le MapSOAPServer connecté au Workflow sur la partie hôte (UNIX ou Windows) ainsi que la commande MAPRMTPROC sur la partie client (iSeries). Par conséquent, Mapping doit être installé des deux côtés.
Lorsque les fichiers spool iSeries sont envoyés au serveur Mapping, une règle Workflow exécute une série de commandes et génère l'output. Si nécessaire, l'output peut ensuite être renvoyé à l'iSeries avec des messages log.
Pré-requis
Veuillez vérifier que la communication réseau entre l'iSeries et le serveur Mapping distant sur lequel tourne le Workflow puisse être établie par l'intermédiaire du protocole HTTP – vérifier adresses IP, pare-feu, antivirus, etc.
Le MapSOAPServer doit être configuré correctement. Vous trouverez les paramètres de configuration détaillée du MapSOAPServer dans la documentation sur les Services Web Mapping.
Boites de Workflow utiles
Convert from iSeries
La commande “Convert from iSeries” (dans le groupe Mapping) permet de convertir un fichier spool EBCDIC en Unicode.
(Voir documentation « WorkFlow_ConvertFromISeries.pdf » pour plus d’informations)
iSeries Response
La commande « iSeries Response » (dans le groupe Web Interactivity) permet d'envoyer une réponse à la commande iSeries. La réponse peut être un fichier (*USERASCII ou *AFPDS) ou un message (entrée JOBLOG ou mise à jour d'une DTAARA).
(Voir documentation « WorkFlow_ISeriesResponse.pdf » pour plus d’informations)
MAPRMTPROC
Cette commande AS/400 permet d’envoyer un spool file de l’AS/400 vers le moteur de règles (Workflow) de M-Processing Server.
Paramètres de la commande sur AS/400
| Spooled File | Nom du fichier spool (SPLF) | Alpha |
| Spooled File Number | Numéro du fichier spool (SPLNUM) | Alpha |
| Job Name | Nom du job (JOB) | Alpha |
| Numéro du job | Numéro du job | Num. |
| User | Nom de l'utilisateur | Alpha |
| Login | Utilisateur du Workflow Mapping | Alpha |
| Password | Mot de passe du Workflow Mapping | Alpha |
| Remote Server | Adresse IP du Workflow Mapping | Alpha |
| Move to Queue | OUTQ de destination du fichier d'entrée. Laisser vide si
N/A |
Alpha |
| Library | Bibliothèque de l'OUTQ de destination. | Alpha |
| Delete File | Suppression du fichier d'entrée. Y(O) ou N. | Alpha |
| Workflow Name | Nom de la règle du workflow à exécuter (laisser vide si
workflow root) |
Alpha |
| Protocol | Type de protocole de la connexion : http ou https | Alpha |
| Remote Port | Port de connexion au Workflow Mapping | Num. |
| Remote Backup Server | Adresse IP du Workflow Mapping de back-up | Alpha |
| Remote Backup Port | Port de connexion au Workflow Mapping de back-up | Alpha |
| Advanced Parameter | Commande HTTP pour traitement spécifique | Alpha |
| Timeout | Délai de connexion exprimé en secondes | Num. |
Paramètres reçus par le workflow
Les paramètres de fichier spool suivants sont envoyés avec le fichier spool et sont à disposition dans le Workflow.
• HTTP_HOST= adresse IP de l'hôte
• HTTP_ISERIES_CONTENT= type de données envoyées (spool_data)
• HTTP_ISERIES_JOB_NAME= nom du job
• HTTP_ISERIES_USR_NAME= nom de l'utilisateur
• HTTP_ISERIES_JOB_NUMBER= numéro du job
• HTTP_ISERIES_SPLF_NAME= nom du fichier spool
• HTTP_ISERIES_FORM_TYPE= type de formulaire
• HTTP_ISERIES_USR_DATA= données utilisateur
• HTTP_ISERIES_OUTQ_NAME= outq du fichier d'entrée
• HTTP_ISERIES_OUTQ_LIB= bibliothèque de l'outq
• HTTP_ISERIES_PGM_NAME= programme qui a ouvert le fichier
• HTTP_ISERIES_PGM_LIB= bibliothèque du programme
• HTTP_ISERIES_COUNT_CODE= code compta
• HTTP_ISERIES_USER_TEXT= données spécifiques utilisateur
• HTTP_ISERIES_PRINTER_DEVICE_TYPE= type de device imprimante
• HTTP_ISERIES_SPLF_NUMBER= numéro du fichier spool
• HTTP_ISERIES_PAGE_LENGTH= longueur de la page
• HTTP_ISERIES_PAGE_WIDTH= largeur de la page
• HTTP_ISERIES_CCSID= CCSID
• HTTP_ISERIES_TOTAL_COPIES= nombre total de copies
• HTTP_ISERIES_LINES_PER_INCH= lignes par inch
• HTTP_ISERIES_CHAR_PER_INCH= caractères par inch
• HTTP_ISERIES_OUTPUT_PRIORITY= priorité d'output
• HTTP_ISERIES_DEV_FILE_NAME= nom du fichier device
• HTTP_ISERIES_DEV_FILE_LIB= bibliothèque du fichier device
• HTTP_ISERIES_TIME_FILE_OPEN= temps pendant lequel le fichier a été ouvert
• HTTP_ISERIES_DATE_FILE_OPEN= date à laquelle le fichier a été ouvert
• HTTP_ISERIES_PRINT_TEXT= impression texte
• HTTP_ISERIES_SOURCE_DRAWER= bac source
• HTTP_ISERIES_OUTPUT_BIN= bac de sortie
• HTTP_ISERIES_JOB_SYSTEM_NAME= nom système du job
Réponses reçues par la commande
Le type de réponse dépend des paramètres configurés dans le workflow. La réponse peut être :
- Un fichier spool (*USERASCII ou *AFPDS)
- Un message dans la JOBLOG actuelle (*INFO ou *MESSAGE)
- Des données dans la DTAARA MAPRMTPROC dans QTEMP
Exemples
Envoi d’un spool vers ONYX Server
Le but est d’envoyer le spool file ayant les informations suivantes vers le workflow MAPRMTPROC.rules.xml de ONYX Server :
Spooled file . . . . . . . . . . > OLP
Spooled file number . . . . . . > 237
Job Name . . . . . . . . . . . . > QPRTJOB
Job number . . . . . . . . . . . > 109341
User . . . . . . . . . . . . . . > QTMPLPD
Différents points à réaliser :
- Sur ONYX, créer un workflow : Ici appelé MAPRMTPROC
- Remarque : Inutile de créer un point d’entrée
- Sur AS/400, exécuter la commande MAPRMTPROC :
a) Spécifier les attributs du spool file à envoyer
b) Login et mot de passe pour le webservice (Apache)
c) Remote Server : L’adresse du Mapping Windows
d) Move to Queue : Pas obligatoire, cela dépend si on veut sauvegarder le spool dans une outqueue ou pas
e) Workflow name : Nom du workflow a exécuter sur Mapping Windows (si vide alors root sera utilisé)
f) Timeout de connexion éventuel
L’envoi se fait via web service. Par conséquent, il ne faut pas s’attendre à avoir un spool dans le spooler. Le fichier arrive simplement dans le workflow. Pour le récupérer, il faut par exemple utiliser une boite de copie. Pour obtenir les variables récupérées, on peut faire un set qui est redirigé vers un fichier.
Voici les variables récupérées :
- CONTENT_TYPE=text/plain
- CONTENT_LENGTH=16324
- HTTP_HOST=192.168.217.16
- HTTP_ACCEPT_ENCODING=gzip
- HTTP_ISERIES_CONTENT=spool_data
- HTTP_ISERIES_JOB_NAME=QPRTJOB
- HTTP_ISERIES_USR_NAME=QTMPLPD
- HTTP_ISERIES_JOB_NUMBER=109341
- HTTP_ISERIES_SPLF_NAME=OLP
- HTTP_ISERIES_FORM_TYPE=SJJI
- HTTP_ISERIES_USR_DATA=OWABSOC022
- HTTP_ISERIES_OUTQ_NAME=FMERCIER
- HTTP_ISERIES_OUTQ_LIB=QGPL
- HTTP_ISERIES_PGM_NAME=OWABSOC022
- HTTP_ISERIES_PGM_LIB=DIPOBJ
- HTTP_ISERIES_COUNT_CODE=
- HTTP_ISERIES_USER_TEXT=
- HTTP_ISERIES_PRINTER_DEVICE_TYPE=*SCS
- HTTP_ISERIES_SPLF_NUMBER=237
- HTTP_ISERIES_PAGE_LENGTH=48
- HTTP_ISERIES_PAGE_WIDTH=136
- HTTP_ISERIES_CCSID=1027
- HTTP_ISERIES_TOTAL_COPIES=1
- HTTP_ISERIES_LINES_PER_INCH=6,00
- HTTP_ISERIES_CHAR_PER_INCH=10,00
- HTTP_ISERIES_OUTPUT_PRIORITY=
- HTTP_ISERIES_DEV_FILE_NAME=QPRINT
- HTTP_ISERIES_DEV_FILE_LIB=QGPL
- HTTP_ISERIES_TIME_FILE_OPEN=111007
- HTTP_ISERIES_DATE_FILE_OPEN=1140425
- HTTP_ISERIES_PRINT_TEXT=
- HTTP_ISERIES_SOURCE_DRAWER=1
- HTTP_ISERIES_OUTPUT_BIN=0
- HTTP_ISERIES_JOB_SYSTEM_NAME=S65C7FEE
Toutes ces variables peuvent être utilisées dans le workflow (pour des conditions, nommage, ou autres).
Renvoi du fichier généré par le workflow vers une outq iSeries
Le but est de renvoyer à l’iSeries un fichier provenant du workflow.
Le workflow ci-dessous reçoit un spool de l’AS/400, le convertit en Unicode et renvoie le fichier unicode vers l’AS/400 via la boite « iSeries Response »
Détail de la boite « iSeries Response » :
Résultat sur l’iSeries (dans l’Outq FMERCIER) :
Remarque :
On pourrait de la même façon renvoyer un fichier XPS vers l’iSeries afin de l’imprimer à travers l’OutQ de l’AS/400 et non du spooler ONYX Server.
En cas de problème de connexion
En cas de problème de connexion entre OPALE et ONYX , le job MAPRMTPROC va continuer à envoyer le spool jusqu’à ce que le timeout de connexion soit atteint (si un timeout est indiqué).
Si pendant ce temps plusieurs MAPRMTPROC sont réalisés, ils seront tous en "processing" sur le serveur jusqu’à ce que la connexion soit établie ou alors jusqu’à ce que le timeout soit atteint.
