Commande CL IBM i (AS/400)

ADDEMLCFGE

Ajouter poste configuration

En bref

La commande ADDEMLCFGE (Ajouter un poste de configuration d'émulation) permet d'ajouter un poste de configuration pour une session d'émulation d'unité 3270 dans le fichier de configuration.

ADDEMLCFGE se lit ADD (Ajouter) + EMLCFGE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDEMLCFGE EMLCFGE(…)

Paramètres

EMLCFGE Poste de configuration obligatoire
EMLDBGJOB Débogage
EMLSIG Gérer les signaux
EMLATR Gérer les attributs
EMLMAXSCR Taille maximale de l'écran
EMLTRC Trace VLIC
EMLSTR TRCJOB émulation imprimante
EMLINLSCN Ecran initial
EMLGRDLIN Quadrillage
EMLDBCS Graphic DBCS
EMLPRTFMT Mise en page de l'impression
EMLSNACLR Traitement de CLEAR
EMLBUF Mémoire tampon de quadrillage
EMLVLG VLOG conditionnel généré
EMLSCS Gérer erreurs de commandes SCS
EMLNML Activer verrouillage num 5250
EMLMSG Envoi de message si UNBIND SNA

Astuce : dans une session 5250, tapez ADDEMLCFGE puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande ADDEMLCFGE (Ajouter un poste de configuration d'émulation) permet d'ajouter un poste de configuration pour une session d'émulation d'unité 3270 dans le fichier de configuration. Vous pouvez indiquer des options relatives à l'affichage et à l'émulation d'imprimante, telles que la taille maximale de l'image pour un écran ou la trace du flot de données pour une imprimante.

Les valeurs indiquées sont utilisées au cours d'une session d'émulation lorsque le poste de configuration est spécifié dans les commandes STREML3270 (Démarrer l'émulation d'écran 3270) ou STRPRTEML (Démarrer l'émulation d'imprimante).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
EMLCFGE	Poste de configuration	Nom, QEMDFTCFGE	Obligatoire, positionnel 1
EMLDBGJOB	Débogage	NOTRACE, TRACE	Facultatif
EMLSIG	Gérer les signaux	SAVE, IGNORE	Facultatif
EMLATR	Gérer les attributs	IGNORE, REJECT	Facultatif
EMLMAXSCR	Taille maximale de l'écran	DEVD, MOD2, *MOD5	Facultatif
EMLTRC	Trace VLIC	NOTRACE, TRACE	Facultatif
EMLSTR	TRCJOB émulation imprimante	NOTRACE, TRACE	Facultatif
EMLINLSCN	Ecran initial	YES, NO	Facultatif
EMLGRDLIN	Quadrillage	NO, YES	Facultatif
EMLDBCS	Graphic DBCS	NO, YES	Facultatif
EMLPRTFMT	Mise en page de l'impression	NO, YES	Facultatif
EMLSNACLR	Traitement de CLEAR	RETRY, IGNORE	Facultatif
EMLBUF	Mémoire tampon de quadrillage	FRONT, BACK	Facultatif
EMLVLG	VLOG conditionnel généré	NO, YES	Facultatif
EMLSCS	Gérer erreurs de commandes SCS	NO, YES	Facultatif
EMLNML	Activer verrouillage num 5250	NO, YES	Facultatif
EMLMSG	Envoi de message si UNBIND SNA	NO, YES	Facultatif

Poste de configuration (EMLCFGE)

Indique le nom du poste de configuration d'émulation que vous ajoutez au fichier de configuration.

Remarque :Le fichier de configuration est livré avec le poste de configuration par défaut QEMDFTCFGE pour les sessions d'émulation 3270.

Ce paramètre est obligatoire.

Débogage (EMLDBGJOB)

Indique si le flot de données de l'imprimante transmis au gestionnaire des fonctions d'impression doit être tracé lorsque la commande TRCJOB (Tracer un travail) est utilisée pour le débogage d'un travail utilisant l'émulation d'imprimante.

*NOTRACE: Le flot de données de l'imprimante n'est pas tracé dans la sortie TRCJOB.
*TRACE: Le flot de données de l'imprimante est tracé dans la sortie TRCJOB.

Gérer les signaux (EMLSIG)

Indique comment un travail d'émulation qui n'est pas en mode envoi répond à une demande SNA pour obtenir la permission d'envoyer des données (ou signaux).

*SAVE: Le travail d'émulation enregistre le signal SNA et, si nécessaire, accorde à l'hôte la permission d'émettre pendant la réception de données alors que l'indicateur de changement de direction (CD) est reçu.
*IGNORE: Le travail d'émulation n'accorde pas à l'hôte la permission d'émettre.

Gérer les attributs (EMLATR)

Indique comment l'émulation 3270 répond à la réception d'un attribut de caractère ou d'une valeur d'attribut incorrects au cours d'une session pour jeux de caractères à un octet (SBCS). Pour le flot de données 3270, un attribut de caractère est une instruction de définition d'attribut (ordre SA) et une valeur d'attribut est la valeur sur laquelle opère l'instruction.

*IGNORE: La valeur incorrecte est ignorée par le travail d'émulation.
*REJECT: Le travail d'émulation renvoie une réponse négative au flot de données contenant l'attribut de caractère ou la valeur d'attribut incorrects.

Taille maximale de l'écran (EMLMAXSCR)

Indique la taille maximale de l'image à afficher sur l'écran.

*DEVD: La taille maximale est celle que peut accepter l'unité.
*MOD2: La taille maximale correspond à 24 lignes de 80 colonnes.
*MOD5: La taille maximale correspond à 27 lignes de 132 colonnes.
Remarque :Si cette taille n'est pas acceptée par l'unité, elle correspondra par défaut à 24 lignes de 80 colonnes.

Trace VLIC (EMLTRC)

Indique si des points de trace sont émis par le composant de conversion de flot de données du microcode sous licence lorsque les conditions suivantes sont vérifiées :

Le travail utilise l'interface de programmation (API) de conversion du flot de données.
La commande TRCJOB (Tracer un travail) s'exécute sur le travail utilisant l'API de conversion du flot de données.
Une trace LIC source/sink est également en cours d'exécution.

*NOTRACE: Les points de trace de conversion de flot de données ne sont pas émis.
*TRACE: Les points de trace de conversion de flot de données sont émis.

TRCJOB émulation imprimante (EMLSTR)

Indique si la commande TRCJOB (Tracer un travail) doit être appelée lors du démarrage d'une émulation d'imprimante.

*NOTRACE: La commande TRCJOB n'est pas appelée.
*TRACE: La commande TRCJOB est appelée.

Ecran initial (EMLINLSCN)

Indique si l'écran informant que l'initialisation de l'émulation est en cours doit s'afficher lorsqu'une session d'émulation 3270 démarre.

*YES: L'écran s'affiche.
*NO: L'écran ne s'affiche pas.

Quadrillage (EMLGRDLIN)

Indique s'il faut supprimer ou non l'encadrement de zone à l'écran.

*NO: L'encadrement de zone n'est pas supprimé.
*YES: L'encadrement de zone est supprimé.

Graphic DBCS (EMLDBCS)

Indique s'il faut prendre en charge la chaîne de caractères graphiques DBCS pour les zones d'entrée. Specifies whether to support the DBCS-graphic character string for input fields.

Remarque : Ce paramètre n'est valide que pour les applications client qui indiquent des attributs de zone ou des attributs de caractères pour toute la zone d'entrée. Si seule une partie d'une zone est définie avec l'attribut graphique DBCS, les résultats sont imprévisibles. Remarque :This parameter is valid only for customer applications that specify field attributes or that specify character attributes for the entire input field. If only part of a field is defined with the DBCS-graphic attribute, you will get unpredictable results.

*NO: La chaîne de caractères graphiques DBCS n'est pas prise en charge. The DBCS-graphic character string is not supported.
*YES: La chaîne de caractères graphiques DBCS est prise en charge. The DBCS-graphic character string is supported.

Mise en page de l'impression (EMLPRTFMT)

Indique si les valeurs définissant le nombre de lignes (paramètre NUMLIN) et le nombre de colonnes (paramètre NUMCOL) précisées dans la commande STRPRTEML doivent être utilisées à la place des valeurs figurant dans le fichier imprimante.

Remarque :Ce paramètre est admis uniquement pour les sessions d'impression SCS.

*NO: Les valeurs indiquées dans la commande STRPRTEML pour le nombre de lignes et le nombre de colonnes ne sont pas utilisées.
*YES: Les valeurs indiquées dans la commande STRPRTEML pour le nombre de lignes et le nombre de colonnes sont utilisées.
Remarque :Les valeurs de la commande STRPRTEML restent valables jusqu'à ce que l'hôte envoie une commande de format horizontal ou vertical.

Traitement de CLEAR (EMLSNACLR)

Indique le mode de reprise d'un travail d'émulation 3270 lorsque la lecture des données envoyées par le système hôte échoue après réception de la commande SNA CLEAR.

Remarque :Ce paramètre est admis uniquement dans les sessions d'émulation d'écran.

*RETRY: Le travail d'émulation essaie de nouveau de lire les données.
*IGNORE: Le travail d'émulation ne fait pas de nouvelle tentative.

Mémoire tampon de quadrillage (EMLBUF)

Indique si la mémoire tampon d'avant-plan ou d'arrière-plan est utilisée lorsque les quadrillages de base sont affichés. Ce paramètre ne concerne pas les lignes de quadrillage stratégiques.

*FRONT: La mémoire tampon d'avant-plan est utilisée.
*BACK: La mémoire tampon d'arrière-plan est utilisée.

VLOG conditionnel généré (EMLVLG)

Indique si un historique VLIC doit être généré lorsque les sous-programmes de conversion de flot de données envoient une réponse négative au système hôte parce qu'une commande ou une instruction est incorrecte.

*NO: Aucun historique VLIC n'est généré.
*YES: Un historique VLIC est généré. La session d'émulation se poursuit.

Gérer erreurs de commandes SCS (EMLSCS)

Pour des sessions imprimante SCS uniquement, ce paramètre indique si une architecture doit être respectée et si par défaut la valeur égale à 1 ligne doit être affectée à la taille ou à la largeur de page lorsqu'un format horizontal incorrect ou un format vertical incorrect est reçu.

*NO: L'architecture est respectée. La taille de page a pour valeur une ligne.
*YES: L'architecture n'est pas respectée ; les valeurs entrées dans la commande STRPRTEML (Démarrer émulation imprimante) sont affectées par défaut à la taille et à la largeur de la page.

Activer verrouillage num 5250 (EMLNML)

Indique si le composant de conversion de flot de données du microcode sous licence doit forcer le verrouillage numérique 5250 lorsque le travail utilise l'API de conversion de flot de données.

*NO: Le verrouillage numérique 5250 n'est pas forcé.
*YES: Le verrouillage numérique 5250 est forcé.

Envoi de message si UNBIND SNA (EMLMSG)

Indique si un message doit s'afficher à l'écran lorsqu'une commande UNBIND est reçue.

*NO: Aucun message ne s'affiche.
*YES: Un message s'affiche.

Exemples

Exemple 1 : ajout d'un poste de configuration

ADDEMLCFGE   EMLCFGE(ARTSDEPT)  EMLMAXSCR(*MOD5)
             EMLGRDLIN(*YES)

Cette commande permet d'ajouter un poste de configuration d'émulation nommé ARTSDEPT pour un affichage en taille maximale d'écran correspondant à 27 lignes de 132 colonnes. L'encadrement de zone n'est pas affiché.

Exemple 2 : ajout d'un poste de configuration pour une imprimante

ADDEMLCFGE   EMLCFGE(FASBPRINT)  EMLDBGJOB(*TRACE)
             EMLATR(*REJECT)

Cette commande permet d'ajouter un poste de configuration d'émulation nommé FASBPRINT au fichier de configuration. Le poste de configuration FASBPRINT trace le flot de données de l'imprimante lorsqu'un travail s'exécute avec une trace et envoie une réponse négative en cas de réception de données incorrectes.

Messages d'erreur

Messages *ESCAPE

CPF853A: Le poste d'émulation &1 existe déjà.
CPF854B: Erreur interne dans les procédures de configuration d'émulation.