Exécuter une commande CL

Introduction

Cet exemple montre comment implémenter un appel de commande CL depuis NTi en C#.

Etape 1/2: Création et ouverture d'une connexion

On commence par déclarer une nouvelle instance de NTiConnection que l'on ouvre:

var conn = new NTiConnection(connectionString);
conn.Open();

Etape 2/2: Appeler la commande

On peut ensuite à partir de la connexion ouverte exécuter une commande CL à l'aide de la méthode ExecuteClCommand() de la classe NTiConnection:

conn.ExecuteClCommand("CRLIB LIB(MYLIB) TEXT('My new library')");

En cas d'erreur dans l'exécution de la commande, une erreur de type NTiException est levée avec un message détaillant le problème, on peut donc implémenter un try ... catch ... pour intercepter une éventuelle erreur:

try{
  conn.ExecuteClCommand("CRLIB LIB(MYLIB) TEXT('My new library')");
}
catch(Exception ex){
  Console.WriteLine(ex.Message);
}

Ainsi en cas d'erreur le message sera écrit dans la console.

Récapitulatif du code

Le code final pour exécuter une commande CL depuis .NET avec NTi - avec une gestion d'erreur de base - est le suivant:

//Ouverture de la connexion
var conn = new NTiConnection(connectionString);
conn.Open();

//Execution de la commande CL
try{
  conn.ExecuteClCommand("CRLIB LIB(MYLIB) TEXT('My new library')");
}
catch(Exception ex){
  Console.WriteLine(ex.Message);
}

//Fermeture de la connexion
conn.Close();

On pense également à fermer la connexion à la fin du traitement si on ne souhaite plus la réutiliser. Malgré tout, lors de la destruction de l'objet conn à la fin du programme ou à la sortie de la méthode en cours, la connexion sera automatiquement fermée.