Manuel d'intégration des applications > CallAPI > Plateformes pour les CallAPI > CallAPI pour BS2000

CallAPI pour BS2000

La description suivante contient des informations et des conseils relatifs à l'utilisation de CallAPI pour BS2000.

Dans le fichier INI de CallAPI de BS2000, vous pouvez décider de la Table de Codes à utiliser. Dans le paramètre codetable= de la section [GLOBAL], entrez le nom de l'objet Table de Codes.

	1.	CallAPI et programme dédié

Vous pouvez exécuter CallAPI à partir de votre propre programme. Il est pour cela nécessaire d'avoir des connaissances du langage de programmation dans lequel ce programme a été écrit.

CallAPI et programme dédié

Tous les paramètres requis sont transmis dans le programme. Il faut uniquement associer le grand module UCCALL ou le télécharger dynamiquement pour l'exécution.

	2.	CallAPI et l'utilitaire

Sur le CD fourni se trouve l'utilitaire UCXBB2?C qui peut être utilisé dans les déroulements BS2000 ou dans les Jobs d'entrée.

CallAPI et l'utilitaire

Les données nécessaires pour se connecter au Automation Engine sont lues par l'utilitaire via SYSDTA. Le Script AE peut provenir d'un fichier ou directement de SYSDTA. Si l'on utilise pour cela un fichier, celui-ci doit être affecté avec le nom de concaténation de fichier UCSCRIPT avant l'appel du programme.

Exemples

Dans le premier exemple, aucun nom de chaîne de fichier UCSCRIPT n'est attribué. Le Script AE exécuté est lu jusqu'à la commande /EOF de SYSDTA.

/FILE UCXBB22C.INI,LINK=INI
/EXEC UCXBB22C
04,RS,PROG,PASSWORD
:SET &RUNID = ACTIVATE_UC_OBJECT(JOBS,EXEMPLE1)
:IF &RUNID = '0000000'
: SET &ERROR = SYS_LAST_ERR_NR
: SET &ERROR = SYS_LAST_ERR_NR
: STOP MSG,51,'ERREUR LORS DE L'ACTIVATION: &ERROR'
:ELSE
: STOP NOMSG,50,'LE JOB A ETE DEMARRE AVEC RUNID &RUNID'
:ENDIF
/EOF

Dans cet exemple, le Script à exécuter se trouve dans le fichier MON.FICHIER.SCRIPT.

/FILE UCXBB22C.INI,LINK=INI
/FILE MON.FICHIER.SCRIPT,LINK=UCSCRIPT
/EXEC UCXBB22C
04,RS,PROG,PASSWORD

L'exemple suivant fournit le RunID, le code d'erreur et le texte d'erreur du CallAPI. Ces trois valeurs sont enregistrées dans une Variable de Job.

/CREATE-JV JV-NAME=#UC.RETCODE
/SET-JV-LINK LINK-NAME=UCRETC,JV-NAME=#UC.RETCODE
/CREATE-JV JV-NAME=#UC.RETTEXT
/SET-JV-LINK LINK-NAME=UCRETT,JV-NAME=#UC.RETTEXT
/CREATE-JV JV-NAME=#UC.RUNID
/SET-JV-LINK LINK-NAME=UCRUNID,JV-NAME=#UC.RUNID
/EXEC UCXBB23C
*INI
:SEND_MSG RS,DEV,'NACHRICHT DER BS2000 CALL-SCHNITTSTELLE &NAME.'
/EOF
/SHOW-JV JV-CONTENTS=*LINK(LINK-NAME=UCRUNNR)
/STEP
/SHOW-JV JV-CONTENTS=*LINK(LINK-NAME=UCRETC)
/SHOW-JV JV-CONTENTS=*LINK(LINK-NAME=UCRETT)

Rubriques connexes :

Généralités sur CallAPI
Utilisation de CallAPI