Manuel d'intégration des applications > CallAPI > CallAPI et programme dédié > Cobol

 Cobol

CallAPI vous offre la possibilité d'exécuter des Scripts dans le système AE à partir de vos propres programmes Java.

 Les fichiers fournis contiennent également des exemples de programmes qui vous montrent comment une activation de Script peut être mise en œuvre.

Généralités

Le processus d'activation de Script se déroule toujours dans l'ordre suivant :

  1. Connexion au système AE
  2. Transmission du Script au système AE
  3. Déconnexion du système AE

 Vous pouvez bien sûr vous connecter simultanément à plusieurs systèmes AE et exécuter plusieurs Scripts. Une licence de dialogue est utilisée pour chaque connexion.

Appel

Exécutez CallAPI à l'aide de la commande CALL UCCALL3. L'exécution indique le code retour 0 lorsque l'action a réussi ou un numéro de message en cas d'erreur.

Description

Appel

Connexion au système AE

CALL UCCALL3 USING structure,données de connexion,connexion

Format des données de connexion :  
Client, Utilisateur, [Département, [Mot de passe]]

Format des données de connexion pour le processus de communication :
nom DNS:numéro de port
ou
adresse TCP/IP:numéro de port

Activation d'un Script

CALL UCCALL3 USINGstructure, Script

Déconnexion du système AE

CALL UCCALL3 USING structure

Variables

Le programme d'exemple présente l'organisation de la structure UC4-RECORD. Elle contient les Variables suivantes :

Variable

Type de données

Description

UC-OPERATION

PIC X(4)

Code d'opération

Cette Variable doit être définie lorsque la fonction universelle est utilisée.

Valeurs autorisées :
"OPC_LOGON" - Connexion au système AE
"OPC_LOGOFF " - Déconnexion du système AE
"OPC_ACTIVATE_SCRIPT" - Activation d'un Script

UC-ERROR-CODE

PIC X

Le code d'erreur dans cErrorCode est défini automatiquement et peut contenir l'une des valeurs suivantes :

" " - Aucune erreur ne s'est produite
"P" - Paramètre(s) non valide(s)
"O" - Opcode non valide
"I" - Echec de l'initialisation
Q" - Echec de la connexion
"R" - Echec de la mémoire
"L" - Echec de la libération d'espace mémoire
"S" - Erreur du connecteur
"T" - Délai dépassé
"U" - Message d'erreur du système AE

UC-INTERFACE-NR

PIC X(3)

Le numéro d'interface doit toujours contenir la valeur 3.

UC-SYSTEM-NAME

PIC X(8)

Nom du système AE auquel la connexion doit être établie

UC-TIMEOUT

PIC 9(4) COMP-4

Durée, en secondes, pendant laquelle CallAPI attend une confirmation du système AE

UC-LANGUAGE

PIC X

Langue utilisée dans les messages

FILLER

PIC X(2)

non utilisé

UC-FLAG1

PIC X

Selon la valeur définie, cet indicateur agit sur l'une des options de traitement suivantes :

"CALL_FLAG1_INI_SERVER" - La connexion au processus de communication est déterminée à partir du fichier INI.
"CALL_FLAG1_INI_LOGIN" - Les données de connexion sont déterminées à partir du fichier INI.
"CALL_FLAG1_INI_USEMSL" - Convertit les Variables du message en texte.
"CALL_FLAG1_INI_USEALL" - Les réglages de la section [GLOBAL] du fichier INI sont utilisés.
"CALL_FLAG1_TRC_HANDLE" - uniquement pour le traitement CallAPI en interne
"CALL_FLAG1_LOG_HANDLE" - uniquement pour le traitement CallAPI en interne
"CALL_FLAG1_INI_FILE" - Nom du fichier INI
"CALL_FLAG1_TRC_OUTPUT" - uniquement pour le traitement CallAPI en interne

FILLER

PIC X(2)

non utilisé

UC-OUTPUT-LEN

PIC 9(8) COMP-4

non utilisé

UC-RUNNR

PIC 9(8) COMP-4

RunID du Script

UC-RETURN-CODE

PIC 9(8) COMP-4

Code retour de l'exécution du Script

UC-MESSAGE-TEXT

PIC X(256)

Partie Variable du message qui explique l'arrière-plan du code retour

UC-PRT-INI

PIC S9(8)

uniquement pour le traitement interne de CallAPI

UC-HND-LOG

PIC S9(8)

uniquement pour le traitement interne de CallAPI

UC-HND-TRC

PIC S9(8)

uniquement pour le traitement interne de CallAPI

UC-HND-HLP

PIC S9(8)

uniquement pour le traitement interne de CallAPI

UC-POINTER

PIC S9(8)

uniquement pour le traitement interne de CallAPI

FILLER

PIC X(12)

non utilisé

UC-INIFILE

PIC X(45)

Chemin et nom du fichier INI

 

Rubriques connexes : 

Généralités sur CallAPI