CHGEMLCFGE

Modifier poste configuration

En bref

La commande CHGEMLCFGE (Modifier un poste de configuration d'émulation) permet de changer les options d'une session d'émulation 3270 en modifiant un poste de configuration dans le fichier de configuration.

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

Syntaxe minimale

CHGEMLCFGE 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 CHGEMLCFGE 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

Vous pouvez également afficher les valeurs existantes pour une session d'émulation sans effectuer de modification en demandant l'invite de cette commande.

Paramètres

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

Poste de configuration (EMLCFGE)

Indique le nom du poste de configuration d'émulation que vous voulez modifier.

Ce paramètre est obligatoire.

QEMDFTCFGE: Le poste de configuration par défaut pour les sessions d'émulation 3270 est modifié.
nom-poste-configuration: Indiquez le nom du poste de configuration à modifier.

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.

*SAME: La valeur demeure inchangée.
*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).

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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 les points de trace de la conversion du flot de données du microcode sous licence (LIC) sont émis 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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur demeure inchangée.
*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.

*SAME: La valeur ne change pas.

*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.

*SAME: La valeur ne change pas.

*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.

*SAME: La valeur ne change pas.

*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.

*SAME: La valeur ne change pas.

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

Exemples

CHGEMLCFGE   EMLCFGE(ARTSDEPT)  EMLMAXSCR(*DEVD)
             EMLGRDLIN(*NO)

Cette commande modifie l'option de taille d'affichage maximale du poste de configuration d'émulation ARTSDEPT pour lui affecter la taille maximale de l'unité d'affichage. L'encadrement de zone est modifié pour s'afficher à l'écran.

Messages d'erreur

Messages *ESCAPE

CPF853E: Poste &1 de configuration d'émulation introuvable.
CPF854B: Erreur interne dans les procédures de configuration d'émulation.