Paramètres de retour

Cette fonction renvoie une chaîne de données et un code retour.
Chaîne de données :
Voir le tableau suivant :
Octet Définition
Standard Etendu  
1 1 Correspond à l'une des valeurs suivantes :
  • Un nom court d'espace de présentation (PSID) à 1 caractère
  • Un espace vide ou Null indiquant un appel de fonction pour la présentation connectée à l'hôte
2–4 Réservé
2 5 Un caractère de code d'option, l'un des caractères suivants :
  • A pour ASCII renvoyé
  • M pour mnémonique de frappe
  • S pour mnémonique spécial
3–8 6–11 Ces 6 octets de l’espace tampon pré-alloué sont utilisés en interne pour mettre et retirer les frappes au clavier. Les combinaisons possibles incluent :
  • L'octet 3 contient un caractère ASCII et l'octet 4 contient X'00'
  • L'octet 3 contient le caractère d'échappement (soit @, soit un autre caractère spécifié à l'aide de l'option ESC=c de la fonction 9) et l'octet 4 contient une abréviation d'un octet pour une fonction. (Voir Mnémoniques ASCII)
  • Les octets 5 à 8 peuvent être similaires aux octets 3 et 4 si le mnémonique ASCII renvoyé est plus long que 2 octets (par exemple, si le mnémonique ASCII représente Attn @A@Q, l'octet 5 contient @ et l'octet 6 contient Q). S'ils ne sont pas utilisés, les octets 5 à 8 sont mis à zéro (X'00').
Pour plus de clarté, quelques exemples de chaînes de données renvoyées sont fournis ci-dessous :
Note : Le symbole @ est le caractère d'échappement par défaut. La valeur du caractère d'échappement peut être définie sur n'importe quelle frappe représentée en ASCII à l'aide de l'option ESC=c de la fonction Set Session Parameters (9). Si le caractère d'échappement a été remplacé par un autre caractère à l'aide de cette option, le symbole @ dans les exemples suivants est remplacé par l'autre caractère.