Paramètres de retour

Cette fonction renvoie une longueur et un code retour.
Longueur :
Pour la fonction Convert Position (P comme deuxième caractère dans la chaîne de données appelante), un nombre compris entre 1 et 43 (pour PC/3270) ou 27 (pour PC400) est renvoyé. Cette valeur est le numéro de la ligne qui contient la position PS contenue dans le paramètre de position PS appelant. La limite supérieure peut être inférieure à 43 (pour PC/3270) ou 27 (pour PC400) en fonction de la configuration de l'espace de présentation hôte.

Pour la fonction Convert RowCol (R comme deuxième caractère dans la chaîne de données appelante), une valeur de 0 indique une erreur dans la valeur d'entrée pour la ligne (paramètre de longueur d'appel).

Code retour :
La fonction Convert Position or RowCol est l'exception à la règle selon laquelle le quatrième paramètre de retour contient toujours un code retour. Pour cette fonction, la valeur renvoyée dans le quatrième paramètre est appelée code de statut. Ce code de statut peut contenir des données ou un code retour. Votre application doit prévoir le traitement de ce code de statut pour éviter des résultats imprévisibles ou une erreur.
  • Si la valeur du quatrième paramètre est 0, 9998 ou 9999, il s'agit d'un code retour.
  • Pour la fonction Convert Position (P comme deuxième caractère de la chaîne de données appelante), une valeur comprise entre 1 et 132 est le numéro de la colonne qui contient la position PS transmise dans le paramètre PS Position appelant. La limite supérieure peut être inférieure à 132 selon la configuration de l'espace de présentation hôte.
  • Pour la fonction Convert RowCol (R comme deuxième caractère de la chaîne de données appelante), une valeur comprise entre 1 et 3 564 représente la position de l'espace de présentation hôte qui correspond aux valeurs de ligne et de colonne transmises dans les paramètres de longueur d'appel et de position PS, respectivement. La limite supérieure peut être inférieure à 3 564 selon la configuration de l'espace de présentation hôte.

Les codes de statut suivants sont définis :

Code de statut Explication
0 Il s’agit d’une position ou d’une colonne PS incorrecte.
>0 Il s'agit de la position ou de la colonne PS.
9 998 Un ID d'espace de présentation hôte incorrect a été spécifié ou une erreur système s'est produite.
9999 Le caractère 2 de la chaîne de données n'est ni P ni R.