Aller au contenu

CPF4788

La commande flot de données 3270 est incorrecte dans l'en-tête API 3270 SNA.

Gravité 20 · Erreur

Cause

Un programme d'application utilisant API 3270 SNA doit fournir une commande de flot de données 3270 valide dans le premier des 20 octets qui constituent l'en-tête commun. Cet en-tête doit se trouver au début de chaque mémoire tampon de sortie, dans les 20 ou 32 premiers octets. Cette longueur dépend du type de format indiqué au paramètre EMLDEV.

Que faire

Modifiez le premier octet de l'en-tête commun afin qu'il contienne une commande de flot de données 3270 valide, et renouvelez l'opération de sortie. Si nécessaire, recompilez votre programme.

Description technique

La zone de commande de l'en-tête commun de l'API SNA 3270 n'est validée que pour les sessions API 3270 formatées. Les codes de commande valides sont : Erase All Unprotected - '6F'X Erase Write Request - 'F5'X Erase Write Alternate - '7E'X Read Buffer - 'F2'X Read Modified - 'F6'X Read Modified All - '6E'X Write - 'F1'X Write Structured Field - 'F3'X AID avec données éventuelles - '00'X L'en-tête commun de l'API SNA 3270 est obligatoire dans toutes les opérations de sortie dont la longueur d'enregistrement est supérieure à zéro. Si le type de format sans format (*UNFORMAT) est indiqué pour le paramètre d'unité d'émulation (EMLDEV) de la commande Ajouter une entrée d'unité ICF (ADDICFDEVE), Modifier une entrée d'unité ICF (CHGICFDEVE) ou Substituer une entrée d'unité ICF (OVRICFDEVE), l'en-tête commun de l'API SNA 3270 indique si les données qui suivent constituent un flot de données 3270 ou un flot de données de point de contrôle des services système (SSCP) fourni par l'utilisateur. Si le type de format zone (*FIELD), zone étendue (*EXTFIELD) ou sans zone (*NOFIELD) est indiqué pour le paramètre EMLDEV de la commande ADDICFDEVE, CHGICFDEVE ou OVRICFDEVE, l'en-tête commun de l'API SNA 3270 fournit des informations sur la conversion des données d'écran ou d'imprimante qui suivent en flot de données 3270. Il doit contenir des informations indiquant l'un des éléments suivants : les données sont un flot de données LU-LU, une réponse à une interrogation ou un flot de données SSCP.

The command field in the SNA 3270 API common header is validated only for formatted 3270 API sessions. Valid command codes are: Erase All Unprotected - '6F'X Erase Write Request - 'F5'X Erase Write Alternate - '7E'X Read Buffer - 'F2'X Read Modified - 'F6'X Read Modified All - '6E'X Write - 'F1'X Write Structured Field - 'F3'X AID with possible data - '00'X The SNA 3270 API common header is required in all output operations with record length greater than zero. If the format type unformat (*UNFORMAT) is specified for the emulation device (EMLDEV) parameter on the Add ICF Device Entry (ADDICFDEVE) command, the Change ICF Device Entry (CHGICFDEVE) command or the Override ICF Device Entry (OVRICFDEVE) command then the SNA 3270 API common header provides an indication about whether the data that follows is a 3270 data stream or a user-provided system services control point (SSCP) data flow. If the format type field (*FIELD), extended field (*EXTFIELD) or no field (*NOFIELD) is specified on the EMLDEV parameter on the ADDICFDEVE, CHGICFDEVE or OVRICFDEVE command, then the SNA 3270 API common header provides information about translating the display or printer data that follows into a 3270 data stream. It must contain information indicating one of the following: the data is an LU-LU data flow, a query reply, or an SSCP data flow.

Sur votre IBM i

Afficher la description complète du message :

DSPMSGD RANGE(CPF4788) MSGF(QSYS/QCPFMSG)

L'intercepter dans un programme CL, quand il est envoyé comme message d'échappement :

MONMSG MSGID(CPF4788) EXEC(DO)
  /* traitement de l'erreur */
ENDDO