DOCUMENTATION NTi

Méthode CheckCLCommand()

Description

La méthode CheckCLCommand interroge l’API QCMDCHK pour valider une commande CL (*CMD).

Cette méthode permet de vérifier la syntaxe et la validité de la commande fournie sans l’exécuter. Elle est particulièrement utile pour s’assurer qu’une commande est correctement formatée avant de l’envoyer pour exécution.

Syntaxe

CheckCLCommand(string commandText)

Paramètres

Nom Type Description
commandText string Le texte complet de la commande à valider (longueur variable).

Retour

Si la commande est valide, aucune erreur n’est levée et la commande est considérée comme correcte avec un code de retour à 0.
Si la commande est incorrecte, une exception de type NTiProgramException est levée avec un code CPF provenant du système IBM i, indiquant une erreur de validation spécifique.

Exceptions

  • NTiProgramException : Lancée en cas d’échec de la validation de la commande, accompagnée d'un code d'erreur CPF pour détailler la nature de l’erreur.

Exemples d’utilisation

try 
{ 
    conn.CheckCLCommand("CRTLIB LIB(TESTLIB)"); 
    Console.WriteLine("✅ La commande est valide."); 
} 
catch (NTiProgramException ex)
{ 
    Console.WriteLine($"❌ La commande est incorrecte : {ex.Message}"); 
}

Références

Pour plus d’informations sur l’API QCMDCHK, consultez la documentation officielle IBM.