STRPRTEML

La commande STRPRTEML démarre l'émulation d'imprimante 3270 en utilisant une unité d'émulation imprimante BSC ou SNA ainsi qu'un fichier imprimante. Elle permet d'imprimer des informations d'un système hôte de type IBM 370 sur un système iSeries. Utilisez cette commande lorsque vous travaillez sur un système iSeries et que les informations figurent sur un système de type IBM 370.

Pour plus d'informations, consultez le manuel 3270 Device Emulation Support, SC41-5408.

Paramètres

Contrôleur d'émulation (EMLCTL)

Indique le nom d'une description de contrôleur BSC ou SNA associée à des descriptions d'unités d'émulation d'imprimante 3270. Lorsque ce paramètre est défini, le travail d'émulation d'imprimante utilise une unité d'émulation d'imprimante 3270 associée à cette description de contrôleur. Le demandeur doit être autorisé au contrôleur et au moins à une unité, laquelle doit être disponible.

Répondez soit à cette invite et à Unité d'émulation (paramètre EMLDEV), soit à Lieu d'émulation (paramètre EMLLOC).

Unité d'émulation (EMLDEV)

Indique le nom d'une unité d'émulation d'imprimante BSC ou SNA (EMLDEV(3284, 3286, 3287, 3288 ou 3289)) utilisée par l'émulation d'imprimante pour émuler une imprimante de type 3270. L'utilisateur doit posséder des droits sur l'unité et celle-ci doit être disponible.

Lieu d'émulation (EMLLOC)

Indique le nom de lieu éloigné des unités d'émulation d'imprimantes 3270. Ce nom est défini lors de la configuration des unités et correspond au lieu éloigné où la communication s'établit. Si ce paramètre est défini, une unité d'émulation d'imprimante disponible est choisie parmi celles utilisées par ce lieu. Une unité au moins de ce type doit être disponible, et le travail exécutant l'émulation doit être autorisé à l'utiliser.

Répondez soit à cette invite et à Contrôleur d'émulation (paramètre EMLCTL), soit à Unité d'émulation (paramètre EMLDEV).

Unité imprimante (PRTDEV)

Indique le nom de l'imprimante utilisée avec le fichier d'unité imprimante afin de lancer l'impression. Ce paramètre est ignoré lorsque les données d'impression sont envoyées dans le spoule. Lorsque la sortie n'est pas spoulée et que l'unité imprimante est en cours d'utilisation lors du lancement du travail, la session d'émulation est interrompue.

Remarque :Si vous n'avez pas indiqué de nom d'imprimante, la sortie est envoyée à l'unité imprimante mentionnée en regard de l'invite Unité (paramètre DEV) de la commande CRTPRTF (Créer un fichier imprimante). Cette unité peut être affichée à l'aide de la commande DSPFD (Afficher une description de fichier).

Travail (JOB)

Indique le nom du travail associé à l'émulation d'imprimante. Si le paramètre EMLDEV n'a pas été défini et qu'un travail par lots est soumis (vous avez répondu *YES à l'invite Soumettre le travail (paramètre SBMJOB)), vous devez indiquer le nom de ce travail. Ce paramètre n'est pas pris en compte si vous avez indiqué *NO en regard du paramètre SBMJOB.

*EMLDEV

Le nom du travail est identique à celui de l'unité d'émulation d'imprimante.

nom-travail

Indiquez un nom pour ce travail d'émulation d'imprimante.

Ejection sur End Bracket SNA (ENDBKTEJT)

Indique si l'émulation d'imprimante SNA doit forcer la sortie de l'émulation lorsque End Bracket (EB) SNA est reçu du système hôte. Pour forcer la sortie de l'émulation, le fichier imprimante de l'émulation indiqué au paramètre PRTFILE est fermé puis rouvert. Après éjection de la sortie imprimante, un saut de page est généré. Pour les émulations d'imprimante BSC, la valeur par défaut *NO est indiquée à ce paramètre.

*NO

La sortie de l'émulation n'est pas déclenchée quand l'émulation d'imprimante SNA reçoit l'instruction End Bracket.

*YES

La sortie de l'émulation est déclenchée dès que l'émulation d'imprimante SNA reçoit l'instruction End Bracket et ce, seulement si le fichier imprimante ouvert contient des données en provenance du système hôte.

Fichier imprimante (PRTFILE)

Indique le fichier imprimante qui imprime les données provenant du système hôte. Ce fichier peut ou non être placé en spoule.

QPEMPRTF

Le fichier imprimante standard, indiquant SPOOL(*YES), livré avec l'émulation 3270 est utilisé.

nom-fichier-imprimante

Indiquez le nom du fichier imprimante que vous avez défini, ainsi que la bibliothèque où il se trouve.

Pour la bibliothèque, les valeurs possibles sont :

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le système recherche le fichier imprimante dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque contenant le fichier imprimante.

Délai d'éjection (TIMOUTEJT)

Indique si l'émulation d'imprimante déclenche la sortie lorsque le délai d'attente imparti pour l'acheminement des données depuis le système hôte est écoulé. La sortie n'est déclenchée que si le fichier imprimante ouvert contient des données du système hôte. Le délai d'attente peut être indiqué en minutes ou en secondes. Si une valeur est précisée à la fois pour les minutes et les secondes, ces valeurs seront additionnées.

Remarque :L'éjection de la sortie de l'émulation entraîne automatiquement l'exécution d'un saut de page.

*NONE

L'éjection de la sortie de l'émulation n'est fixée par aucun délai d'attente.

*IMMED

L'éjection de la sortie de l'émulation est immédiate.

minutes-secondes

Indiquez le délai d'attente, exprimé en minutes ou en secondes, ou en minutes et secondes.

Minutes

Les valeurs admises sont comprises entre 0 et 99.

Secondes

Les valeurs admises sont comprises entre 0 et 59.

Différer impression spoule (DFRPRTOUT)

Indique si l'impression de la sortie spoule doit être immédiate ou différée. Ce paramètre n'est pas pris en compte lorsque *NO est précisé en regard du paramètre SPOOL (Sortie en spoule).

*PRTFILE

La valeur SCHEDULE du fichier imprimante contrôle l'impression de la sortie spoule.

*YES

La sortie spoule est imprimée dès la fermeture du fichier spoule.

*NO

L'impression peut démarrer avant la fermeture du fichier spoule. La sortie imprimée ne contient pas toutes les données envoyées par le système hôte tant que le fichier spoule n'est pas fermé. Si l'imprimante n'utilise pas le spoule, ce paramètre est ignoré.

Remarque :Une fois que l'imprimante a commencé à imprimer la sortie de l'émulation d'unité 3270, la sortie spoule des autres travaux se partageant l'imprimante ne peut s'effectuer que lorsque l'impression du fichier en cours est achevée.

Sortie en spoule (SPOOL)

Indique si les données en sortie à destination du fichier d'unité imprimante doivent être envoyées dans le spoule. Si la valeur de ce paramètre est *NO, la sortie est envoyée sur l'imprimante indiquée en regard de l'invite Unité imprimante (paramètre PRTDEV). Si la valeur de ce paramètre est *YES, la sortie est envoyée dans la file d'attente indiquée en regard de l'invite File d'attente en sortie (paramètre OUTQ) de la commande CRTPRTF (Créer un fichier imprimante) pour le fichier imprimante mentionné au paramètre PRTFILE. La valeur indiquée pour la file d'attente en sortie peut être affichée à l'aide de la commande DSPFD (Afficher une description de fichier) et en précisant le nom du fichier imprimante.

Remarque :Si la valeur *JOB est indiquée au paramètre OUTQ, la sortie est envoyée dans la file d'attente en sortie mentionnée au paramètre OUTQ de la description de travail précisée pour le paramètre JOBD. Cette valeur peut être affichée à l'aide de la commande DSPJOBD (Afficher une description de travail) et en indiquant le nom de la description de travail.

*PRTFILE

La valeur indiquée en regard de l'invite Sortie en spoule (paramètre SPOOL) de la commande CRTPRTF (Créer un fichier imprimante) détermine si l'impression est en spoule ou non.

*YES

Les données sont envoyées dans le spoule.

*NO

Les données ne sont pas envoyées dans le spoule. Elles sont directement imprimées au fur et à mesure du traitement.

Ouverture fichier imprimante (OPNPRTF)

Indique si le fichier imprimante est ouvert pendant la session d'émulation d'imprimante 3270 SNA. Si les données ne sont pas envoyées dans le spoule, l'imprimante sera affectée à votre travail à l'ouverture du fichier imprimante. Dans le cas contraire, l'éditeur de spoule sera affecté à votre travail après l'ouverture du fichier imprimante, suivant la valeur indiquée en regard du paramètre DFRPRTOUT.

Ce paramètre n'est pas admis dans le cadre d'une émulation d'imprimante 3270 BSC.

*IMMED

L'ouverture du fichier imprimante suit immédiatement le démarrage de la session d'émulation d'imprimante 3270.

*RCVDTA

L'ouverture du fichier imprimante suit la réception des données du système hôte.

Positions d'impr par ligne (NUMCOL)

Indique le nombre de colonnes par ligne de la sortie imprimée.

*PRTFILE

Le nombre de colonnes par ligne est défini par la valeur PAGESIZE(largeur) du fichier imprimante. Cette valeur sera utilisée si *IMMED est indiqué au paramètre OPNPRTF (Ouverture fichier imprimante), ou si *RCVDTA est affectée à ce paramètre et que la valeur MPP (Positions d'impression maximales) n'est pas envoyée par le système hôte. Sinon, la valeur MPP sera utilisée.

nombre-colonnes

Indiquez le nombre de colonnes par ligne de la sortie imprimée. Les valeurs possibles sont comprises entre 1 et 378.

Lignes par page (NUMLIN)

Indique le nombre de lignes par page de la sortie imprimée.

*PRTFILE

Le nombre de lignes par page est défini par la valeur PAGESIZE(hauteur) du fichier imprimante. Cette valeur sera utilisée si *IMMED est indiqué au paramètre OPNPRTF (Ouverture fichier imprimante), ou si *RCVDTA est affecté à ce paramètre et que la valeur MPL (Longueur maximale de page) n'est pas envoyée par le système hôte. Sinon, la valeur MPL sera utilisée.

nombre-lignes

Indiquez le nombre de lignes par page de la sortie imprimée. Les valeurs possibles sont comprises entre 1 et 255.

Lignes par pouce (LPI)

Indique le nombre de lignes par pouce de la sortie imprimée.

*PRTFILE

Le nombre de lignes par pouce est défini par la valeur LPI du fichier imprimante. Cette valeur sera utilisée si *IMMED est indiqué au paramètre OPNPRTF (Ouverture fichier imprimante), ou si *RCVDTA est affectée à ce paramètre et que la valeur SDL (Définir densité de ligne) n'est pas envoyée par le système hôte. Sinon, la valeur SDL sera utilisée.

lignes-par-pouce

Indiquez le nombre de lignes par pouce de la sortie imprimée. Les valeurs admises sont 3, 4, 6, 7.5, 7,5, 8 et 9.

File attente messages (MSGQ)

Indique le nom de la file d'attente de messages vers laquelle sont envoyés les messages d'exploitation de cette unité.

*DSPDEV

C'est la file d'attente de messages associée au clavier-écran en cours qui est utilisée.

*NONE

Les messages ne sont envoyés qu'à l'historique du travail d'émulation d'imprimante.

Pour la bibliothèque, les valeurs possibles sont :

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La file d'attente de messages est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

nom-file-attente-messages

Indiquez le nom et la bibliothèque de la file d'attente recevant les messages lors de l'exécution du travail d'émulation d'imprimante.

Jeu de caractères de la langue (CHRSET)

Indique l'identificateur (3 caractères) de langue du clavier utilisé dans votre pays ou votre région. Cet identificateur est représentatif d'un CHRID spécifique (identificateur de caractères indiquant un jeu de caractères et une page de codes), lequel est utilisé par l'imprimante en cours d'émulation.

*SYSVAL

La valeur système en cours QKBDTYPE est utilisée.

identificateur-langue-clavier

Indiquez l'identificateur de langue du clavier utilisé dans votre pays ou votre région.

*TRNTBL

Permet l'utilisation d'une table de conversion définie par l'utilisateur. Le type de conversion est précisé dans la table figurant en regard de l'invite Table de conversion en sortie (paramètre TRNTBLOUT). Le CHRID associé à la valeur système QKBDTYPE sera utilisé par l'imprimante émulée.

Soumettre le travail (SBMJOB)

Indique si l'émulation d'imprimante doit constituer un travail ou être intégrée au travail en cours.

*YES

Un travail particulier est soumis pour l'émulation d'imprimante. Les attributs sont définis dans la description de travail figurant en regard de l'invite Description de travail (paramètre JOBD). Le travail utilise votre profil utilisateur.

*NO

L'émulation d'imprimante est intégrée dans le travail en cours.

Description de travail (JOBD)

Indique la description du travail soumis pour l'émulation d'imprimante 3270. Ce paramètre n'est pas pris en compte si vous avez indiqué *NO en regard de l'invite Soumettre le travail (paramètre SBMJOB).

QBATCH

La description de travail QBATCH est utilisée pour ce travail.

Pour la bibliothèque, les valeurs possibles sont :

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le système recherche le nom de la description de travail dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque contenant la description de travail.

nom-description-travail

Indiquez le nom de la description associée à ce travail, ainsi que la bibliothèque où elle se trouve.

Table de conversion en sortie (TRNTBLOUT)

Indique la table permettant de convertir les données en sortie du système hôte vers l'émulation 3270.

*CHRSET

Indiquez que la conversion s'effectue lors de l'envoi des données du système hôte et ce, à l'aide du jeu de caractères défini en regard de l'invite Jeu de caractères de la langue (paramètre CHRSET).

Pour la bibliothèque, les valeurs possibles sont :

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La table de conversion est recherchée dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque contenant la table de conversion.

nom-table

Indique le nom de la table de conversion en sortie et la bibliothèque où elle se trouve.

File d'attente de travaux (JOBQ)

Indique le nom de la file d'attente de travaux dans laquelle doit être placé ce travail associé à l'émulation d'imprimante 3270. Ce paramètre n'est pas pris en compte si vous avez indiqué *NO en regard de l'invite Soumettre le travail (paramètre SBMJOB).

*JOBD

Le travail soumis est placé dans la file d'attente de travaux associée à la description de travail indiquée dans le paramètre JOBD.

nom-file-attente-travaux

Indiquez le nom et la bibliothèque de la file d'attente de travaux qui contiendra le travail soumis.

Pour la bibliothèque, les valeurs possibles sont :

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La file d'attente de travaux est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque contenant la file d'attente de travaux.

Conditions arrêt émulation (ENDCOND)

Indique les conditions susceptibles de mettre fin à la session d'émulation d'imprimante 3270 SNA.

Ce paramètre n'est pas admis dans le cadre d'une émulation d'imprimante 3270 BSC.

*NONE

Aucune condition n'est requise pour mettre fin à l'émulation d'imprimante 3270.

*DACTLU

La session d'émulation d'imprimante 3270 prend fin si elle reçoit un DACTLU SNA de la part du système hôte.

*ENDBKT

La session d'émulation d'imprimante 3270 prend fin si elle reçoit un End bracket SNA de la part du système hôte. Cette condition d'arrêt suppose certaines précautions :

• elle ne devrait être utilisée que lorsque vous devez imprimer un seul fichier du système hôte au cours de la session. Un End bracket pourrait se produire après l'impression du premier fichier, entraînant ainsi l'arrêt de la session 3270 avant l'impression d'un second fichier.

*UNBIND

La session d'émulation d'imprimante 3270 prend fin si elle reçoit un UNBIND SNA de la part du système hôte. Cette condition d'arrêt suppose certaines précautions :

• elle ne devrait être utilisée que lorsque vous devez imprimer un seul fichier du système hôte au cours de la session. Un UNBIND pourrait se produire après l'impression du premier fichier, entraînant ainsi l'arrêt de la session 3270 avant l'impression d'un second fichier.

Confirmer alimentation papier (FORMFEED)

Indique si une instruction d'alimentation papier placée en première position sur la première ligne d'impression d'une imprimante LU3 DSC 3270 doit être confirmée ou non.

Ce paramètre n'est pas pris en compte pour une imprimante SCS LU1 SNA.

*YES

L'instruction d'alimentation papier est confirmée. L'impression se poursuit sur une nouvelle page.

*NO

L'instruction d'alimentation papier n'est pas prise en compte. L'impression ne se poursuit pas sur une nouvelle page.

Poste de configuration (EMLCFGE)

Indique si un poste de configuration est utilisé pour cette session. Les postes de configuration définissent les options de configuration de l'émulation 3270. Ils sont créés à l'aide de la commande ADDEMLCFGE (Ajouter un poste de configuration).

*NONE

Aucun poste de configuration n'est précisé. Les valeurs par défaut sont utilisées.

QEMDFTCFGE

Le poste de configuration par défaut QEMDFTFGE est utilisé. Il est prédéfini et peut être mis à jour à l'aide de la commande CHGEMLCFGE (Modifier un poste de configuration d'émulation).

nom-poste-configuration

Indiquez le nom du poste de configuration à utiliser. Si ce poste est introuvable dans le fichier de configuration, les options de configuration par défaut sont utilisées.

Exemples

Exemple 1 : impression de données dans un fichier imprimante d'émulation standard

STRPRTEML   EMLDEV(HOSTPRT4)

Cette commande permet de lancer un travail par lots en acceptant des données de l'unité HOSTPRT4 et d'imprimer des données dans le fichier imprimante d'émulation standard (QPEMPRTF). Le travail est nommé HOSTPRT4 et s'exécute jusqu'à son annulation. Des messages sont envoyés à la file d'attente de messages du poste de travail en cours.

Exemple 2 : émulation d'une imprimante dans le travail en cours

STRPRTEML   EMLDEV(HOSTPRT5)  SBMJOB(*NO)

Cette commande permet de procéder à une émulation d'imprimante dans le travail en cours en acceptant des données de l'unité HOSTPRT5 et en les écrivant dans le fichier imprimante d'émulation standard (QPEMPRTF). La demande est active jusqu'à ce qu'elle soit interrompue par la commande ENDPRTEML (Arrêter l'émulation d'imprimante) ou jusqu'à ce que le travail soit annulé.

Exemple 3 : impression immédiate de la sortie

STRPRTEML   EMLCTL(EMLCTL1)  TIMOUTEJT(10)
            DFRPRTOUT(*NO)  NUMLIN(96)

Cette commande permet de lancer un travail par lots en acceptant des données de l'unité et en les imprimant dans le fichier imprimante (QPEMPRTF). Dans le cas d'un délai d'attente de 10, l'émulation d'imprimante force la sortie de l'émulation. La sortie s'imprime immédiatement (96 lignes maximum par page).

Messages d'erreur

Messages *ESCAPE

CPF85EB

Fin de la session d'émulation d'unité 3270.

CPF85ED

Valeurs différentes de ENDCOND(*NONE) non acceptées.

CPF85EE

Valeur *RCVDTA non acceptée pour le paramètre OPNPRTF.

CPF8510

Erreur interne sur l'unité &1.

CPF8511

Emulation interrompue par des erreurs sur l'unité &2.

CPF8512

Emulation interrompue car unité &2 suspendue.

CPF8513

Emulation interrompue par des erreurs sur l'unité &2.

CPF8514

Rétablissement après erreur arrêté sur unité &1.

CPF8515

Session d'émulation 3270 interrompue par l'hôte.

CPF8516

Aucune concordance entre l'hôte et l'unité &2.

CPF8517

Nombre de zones reçues supérieur au maximum admis.

CPF8518

Emulation interrompue par erreur interne au système.

CPF8519

Anomalie de fonctionnement dans l'émulation 3270.

CPF8561

Emulation imprimante non démarrée.

CPF8564

Interruption du travail d'émulation d'imprimante &3/&2/&1.

CPF8570

La conversion du flot des données de l'imprimante 3270 a échoué.

CPF8579

Impossible d'ouvrir fichier imprimante &1 de &2.

CPF8580

&1 n'est pas un fichier imprimante ou a été substitué.

CPF8582

Impossible de rouvrir fichier imprimante &1 de &2.

CPF8583

Emulation imprimante ne peut ouvrir le fichier requis.