ConverseVar.printerAssociation

La variable de sistema ConverseVar.printerAssociation permite especificar, durante la ejecución, el destino de la salida al imprimir un formulario de impresión.

Puede utilizar esta variable de cualquiera de estas formas:
Las características de ConverseVar.printerAssociation son las siguientes:
Tipo primitivo
CHAR
Longitud de datos
Varías según el tipo de archivo
¿Se restaura siempre el valor después de una sentencia converse?

ConverseVar.printerAssociation se inicializa en el nombre de recurso del sistema especificado durante la generación o para la depuración. Si un programa pasa el control a otro programa, el valor de ConverseVar.printerAssociation se establece en el valor por omisión para el programa receptor.

Incluso cuandoIncluso cuando están permitidos múltiples trabajos de impresión para un formulario de impresión dado, la sentencia close cierra solamente el archivo relacionado con el valor actual de ConverseVar.printerAssociation.

Detalles específicos de la salida de Java

Para la salida Java, establecerá ConverseVar.printerAssociation como una serie de dos partes con dos puntos separadores:
  IDtrabajo:destino
IDtrabajo
Una secuencia de caracteres (sin los dos puntos) que identifica a cada trabajo de impresión de forma exclusiva. Los caracteres son sensibles a las mayúsculas y minúsculas (job01 es distinto a JOB01), y puede volver a utilizar IDtrabajo tras cerrarse un trabajo de impresión.
Puede utilizar distintos trabajos para promocionar una clase distinta de salida o un orden de salida distinto, dependiendo del flujo de eventos en el código. Por ejemplo, considere la siguiente secuencia de sentencias EGL:
  ConverseVar.printerAssociation = "job1";
  print form1;
  ConverseVar.printerAssociation = "job2";
  print form2;
  ConverseVar.printerAssociation = "job1";
  print form3;
Cuando finaliza el programa, se crean dos trabajos de impresión:
  • form1 seguido de form3
  • form2 solo
destino
La impresora o archivo que recibe la salida.
La serie destino es opcional y se ignora si el trabajo de impresión sigue abierto. Las siguientes sentencias son aplicables si no hay una serie:
  • Puede omitir los dos puntos antes de destino
  • En la mayoría de casos, el programa muestra un diálogo de presentación preliminar desde el que el usuario puede especificar una impresora o un archivo para la salida. La excepción se produce si se utiliza la biblioteca curses en UNIX; en ese caso, el trabajo de impresión va a la impresora por omisión.
Las siguientes sentencias corresponden al valor de destino al generar para Windows 2000/NT/XP:
  • Para enviar salida a la impresora por omisión, haga lo siguiente:
    • Especifique un valor que coincida con la propiedad fileName en el componente de asociaciones de recursos.
    • Cambie las propiedades de ejecución de Java de forma que spool (en lugar de seqws) sea el valor del tipo de archivo relacionado. Por ejemplo, en el componente de asociaciones de recursos, si el valor de la propiedad fileName es myFile y el valor de systemName es impresora, debe cambiar los valores de las propiedades de ejecución de Java de forma que vgj.ra.myFile.fileType esté establecido en spool en lugar de en seqws. Tras el cambio, las propiedades son las siguientes:
        vgj.ra.myFile.systemName=printer
        vgj.ra.myFile.fileType=spool
  • Para enviar salida a un archivo, especifique un valor que coincida con la propiedad fileName en el componente de asociaciones de recursos, cuando seqws es el valor de la propiedad fileType relacionada en el componente de asociaciones de recursos. La propiedad systemName es el componente de asociaciones de recursos que contiene el nombre del archivo del sistema operativo que recibe la salida.
  • No especifique el valor impresora como el valor de destino. Si lo hace, se visualizará el diálogo de presentación preliminar para el usuario, pero ese comportamiento podría cambiar en versiones posteriores de EGL.
Las siguientes sentencias corresponden al valor de destino al generar para UNIX:
  • Para enviar salida a la impresora por omisión (independientemente de si se está utilizando la biblioteca curses), especifique un valor que coincida con la propiedad fileName en el componente de asociaciones de recursos, cuando spool es el valor de la propiedad fileType relacionada en el componente de asociaciones de recursos.
  • Para enviar salida a un archivo, especifique un valor que coincida con la propiedad fileName en el componente de asociaciones de recursos, cuando seqws es el valor de la propiedad fileType relacionada en el componente de asociaciones de recursos. La propiedad systemName del componente de asociaciones de recursos contiene el nombre del archivo del sistema operativo que recibe la salida.
  • No especifique el valor impresora como el valor de destino. Si lo hace, (y si no se está utilizando la biblioteca curses) se visualizará el diálogo de presentación preliminar para el usuario, pero ese comportamiento podría cambiar en versiones posteriores de EGL.

Detalles específicos de la salida de COBOL para iSeries

En relación a COBOL iSeries, establezca la variable de sistema ConverseVar.printerAssociation en el valor de una propiedad fileName en el componente de asociaciones de recursos que se utiliza durante la generación. El tipo de archivo debe ser SEQ y no del tipo SPOOL.

No están soportados múltiples trabajos de impresión para los programas COBOL generados pasa iSeries, y cuando ConverseVar.printerAssociation está establecido, el entorno de ejecución de EGL cierra el archivo antiguo (para completar la salida de datos anterior); utiliza el mandato de iSeries OVRPRTF para alterar temporalmente el nombre de archivo y abre el nuevo archivo.

Antes de utilizarlo, el valor de ConverseVar.printerAssociation se pasa a mayúsculas; pero el valor en la propia variable de sistema permanece sin alterar. El valor de ConverseVar.printerAssociation se resuelve en true cuando se compara con una versión en minúsculas si la variable de sistema se ha inicializado con una versión en minúsculas.

El valor establecido en ConverseVar.printerAssociation se propaga desde el nivel de llamada y se cambia en todos los niveles de llamada subordinados. No obstante, el valor no se propaga si el programa ha abierto el archivo anteriormente.

Detalles específicos del proceso por lotes de z/OS

Para un programa generado como un programa de proceso por lotes de z/OS, el valor de la variable puede ser un nombre de conjunto de datos de 54 bytes o un nombre DD de 8 bytes; y puede haber varios archivos abiertos simultáneamente. El valor inicial de la variable es el nombre del archivo asignado al nombre DD EZEPRINT o (en ausencia de ese nombre DD, o si el archivo referenciado no es del tipo SEQRS) es el nombre de recurso del sistema especificado para el nombre de archivo impresora durante la generación.

Puede establecer la variable de sistema ConverseVar.printerAssociation para hacer referencia a un archivo de tipo SEQRS solamente.

Al establecer ConverseVar.printerAssociation, el archivo se conecta mediante una asignación dinámica SVC99. La opción DISP de SVC99 se establece en SHR, lo que significa que el conjunto de datos vuelve a escribirse cada vez que se abre para la salida.

Antes de utilizarlo, el valor de ConverseVar.printerAssociation se pasa a mayúsculas; pero el valor en la propia variable de sistema permanece sin alterar. El valor de ConverseVar.printerAssociation se resuelve en true cuando se compara con una versión en minúsculas si la variable de sistema se ha inicializado con una versión en minúsculas.

Detalles específicos de CICS

En CICS, el valor de la opción printDestination del descriptor de construcción determina el valor inicial de ConverseVar.printerAssociation o interactúa con la función de sistema sysLib.startTransaction para determinar el valor inicial:
  • Si printDestination está establecido en PROGRAMCONTROLLED, el valor inicial de ConverseVar.printerAssociation es el valor especificado para el nombre de archivo impresora durante la generación.
  • Si la opción printDestination se establece en TERMINALID, si la transacción se inicia mediante invocación de sysLib.startTransaction, y si el parámetro termID de esa función se establece en ceros binarios, el valor inicial de ConverseVar.printerAssociation es el valor especificado para el parámetro prID de esa función.

Si un programa CICS por lotes no se ha iniciado mediante sysLib.startTransaction, ConverseVar.printerAssociation toma por omisión el valor de CICS EIBTRMID, como está indicado para un programa que se inicia en un terminal.

Los siguientes tipos de archivos están sujetos a consideraciones especiales:
SPOOL
El valor de ConverseVar.printerAssociation es el nombre del archivo de salida de un archivo JES SPOOL asociado con un archivo serie. Puede haber varios archivos abiertos simultáneamente.
El nombre de archivo de salida tiene el siguiente formato e incluye 19 bytes como máximo:
  IDnodo.IDusuario.clase

IDnodo es un ID de nodo de sistema de entre 1 y 8 caracteres o un asterisco (*). IDusuario es un ID de usuario de sistema entre 1 y 8 caracteres o un asterisco (*). clase es opcional y es una clase de spool de 1 carácter cuyo valor por omisión es A. Si no se especifica clase, IDusuario también es opcional y toma por omisión el ID de usuario de CICS (el mismo valor almacenado en sysVar.userID).

Consulte el manual de personalización de CICS para obtener más información.

TRANSIENT
El valor es un nombre de DCT de 4 bytes para una cola de datos temporal asociada con un archivo serie. El nombre de la cola de datos temporal debe definirse para CICS.

Puede haber varios archivos abiertos simultáneamente.

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.