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.

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.