MAPRMTPROC

Autres langues :

Sommaire

1 Généralités
2 Pré-requis
3 Boites de Workflow utiles
- 3.1 Convert from iSeries
- 3.2 iSeries Response
4 MAPRMTPROC
5 Exemples
- 5.1 Envoi d’un spool vers ONYX Server
- 5.2 Renvoi du fichier généré par le workflow vers une outq IBM i
6 En cas de problème de connexion

Généralités

Le Workflow Mapping est le nouveau moteur de règles disponible à partir de Onyx Server 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 IBM i.

Un connecteur IBM i Workflow a donc été développé de manière à pouvoir bénéficier des fonctionnalités du Workflow Mapping sur les documents IBM i. Pour cela, nous utilisons le MapSOAPServer connecté au Workflow sur la partie hôte (UNIX ou Onyx) ainsi que la commande MAPRMTPROC sur la partie client (IBM i). Par conséquent, Mapping doit être installé des deux côtés.

Lorsque les fichiers spool IBM i 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'IBM i avec des messages log.

Pré-requis

Veuillez vérifier que la communication réseau entre l'IBM i 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 IBM i permet d’envoyer un spool file de l’IBM i vers le moteur de règles (Workflow) de M-Processing Server.

Paramètres de la commande sur IBM i

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 système d'impression

• 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

Passage de paramètres personnalisées

En plus des paramètres HTTP_XXX envoyés, il est possible d'en envoyer d'autres. Pour ce faire, on utilisera le paramètre "Paramètre avancé" en indiquant le nom du paramètre et sa valeur sous la forme :&key=MYPARAM&value=MYVALUEPARAM (avec key et value en minuscule)

Exemple

Nous prenons pour exemple le passage de la valeur de l'attribut USRDFNDTA. Voici la commande a mettre dans l'action exécutée par le robot MAPPING :

MAPRMTPROC SPLF(&SPLF) SPLNUM(&SPLNUM) JOB(&JOB) JOBNUM(&JOBNUM) USER(&USER) LOGIN(mapadmin) PASSWD(mapadmin) SERVER('192.168.217.32') 
WORKFLOW(MAPRMTPROC) ADVANCEPAR('&key=USERDEFINEDDATA&value=&TRIM&USRDFNDTA')

Onyx recevra alors, en plus de tous les paramètres HTTP_XXX, le paramètre USERDEFINEDDATA ayant pour valeur la valeur USRDFNDATA du spooled file envoyé.

Remarques : Noter bien les paramètres &key et &value devant obligatoirement être en minuscule et noter bien le &TRIM ayant pour effet de supprimer les blancs non significatifs après la valeur du USRDFNDTA. Si tag &TRIM n'est pas mis, alors le &USRDFNDTA aura une longueur de 35 caractères avec des blancs. La commande MAPRMTPROC se mettra en alors en erreur.

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 IBM i, 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 serveur Onyx

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 Onyx (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 IBM i

Le but est de renvoyer à l’IBM i un fichier provenant du workflow.

Le workflow ci-dessous reçoit un spool de l’IBM i, le convertit en Unicode et renvoie le fichier unicode vers l’IBM i via la boite « iSeries Response »

Détail de la boite « iSeries Response » :

Résultat sur l’IBM i (dans l’Outq FMERCIER) :

Remarque :

On pourrait de la même façon renvoyer un fichier XPS vers l’IBM i afin de l’imprimer à travers l’OutQ de l’IBM i 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.