DOCUMENTATION NTi

Méthode RetrieveSystemValues()

Description

Les méthodes RetrieveSystemValues() et RetrieveSystemValue() interroge l’API QWCRSVAL pour récupérer une ou plusieurs valeurs système d'IBM i.

  • RetrieveSystemValue(): Récupère une seule valeur système spécifique et la renvoie sous forme d’objet SystemValueInformation contenant des détails comme le nom, le type de données, et la valeur.
  • RetrieveSystemValues(): Récupère plusieurs valeurs système simultanément et les retourne sous forme de tableau SystemValueInformation, ce qui permet d’obtenir un ensemble de valeurs en un seul appel.

Syntaxe

// Récupération d'une seule valeur système
RetrieveSystemValue(string value)

// Récupération de plusieurs valeurs système
RetrieveSystemValues(string[] values)

Paramètres

Nom Type Description
value string Nom de la valeur système à interroger (max 10 caractères).
validSystemValues string[] Un tableau contenant les noms des valeurs système à récupérer. Chaque nom ne doit pas dépasser 10 caractères et le tableau peut contenir jusqu’à 158 valeurs système.

Retour

  • RetrieveSystemValue(): Retourne un objet de type SystemValueInformation contenant les détails de la valeur système demandée.
  • RetrieveSystemValues(): Retourne un tableau d’objets SystemValueInformation[] correspondant aux valeurs système demandées.

Classe SystemValueInformation

Propriété Type Description
SystemValue string Le nom de la valeur système.
DataType string Le type de données de la valeur système, représenté sous forme de chaîne.
InformationStatus string Statut de l’information de la valeur système.
LengthOfData int Longueur des données de la valeur système, en nombre d’octets.
Data object La valeur réelle de la valeur système sous forme d'objet générique.

Exceptions

  • ArgumentOutOfRangeException : Lancée si le tableau contient plus de 158 noms de valeurs systèmes.
  • InvalidOperationException : Lancée si la taille des données retournées est insuffisante pour traiter la requête, ou si une erreur survient lors de l’exécution.

Exemples d’utilisation

Récupération d’une seule valeur système

var systemValue = conn.RetrieveSystemValue("QTIME"); 
Console.WriteLine($"System Value: {systemValue.SystemValue}, Data: {systemValue.Data}");

Récupération de plusieurs valeurs système

var systemValues = conn.RetrieveSystemValues(new string[] { "QTIME", "QDATE" }); 
foreach (var systemValue in systemValues) 
{
    Console.WriteLine($"System Value: {systemValue.SystemValue}, Data: {systemValue.Data}");
}

Références

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