Elementos de asociación

Como se describen en las Asociaciones de recursos, el componente de asociaciones de recursos se compone de elementos de asociación. Cada elemento es específico de un nombre de archivo (propiedad fileName) y contiene un conjunto de entradas, cada una de ellas con estas propiedades:
Los valores de las propiedades system y fileType determinan las propiedades adicionales que están disponibles de las de la siguiente lista:

commit

Indica (para programas Java generados por EGL en iSeries) si debe habilitarse el control de compromiso.

Seleccione uno de los siguientes valores:
NO (valor por omisión)
La utilización de sysLib.commit o sysLib.rollback no tiene ningún efecto.
YES
Puede utilizar sysLib.commit y sysLib.rollback para definir el final de una unidad de trabajo lógica.

conversionTable

Especifica el nombre de la tabla de conversión utilizada por un programa Java generado durante el acceso de una cola de mensajes MQSeries.

Para obtener más información, consulte el apartado Conversión de datos.

duplicates

Especifica (para un programa COBOL generado por EGL en iSeries) si un archivo VSAM al que se accede puede contener claves duplicadas. Los valores válidos son NO (valor por omisión) y YES.

El valor de duplicados debe ser coherente con el uso de la palabra clave UNIQUE en la especificación de descripción de datos (DDS) que describe el archivo físico en iSeries. Si el valor de duplicados es YES, por ejemplo, no debe especificar UNIQUE.

La tabla siguiente muestra las consecuencias de una incoherencia en los dos valores.

Palabra clave DDS Valor de duplicados en el elemento de asociación Código de retorno COBOL tras abrir un archivo Código de retorno EGL tras abrir un archivo Valor de error de E/S de EGL
UNIQUE YES 95 00000220 format
no UNIQUE NO 95 00000220 format

fileType

Especifica la organización de archivos del sistema destino. Puede seleccionar un tipo explícito, como por ejemplo seqws. Como alternativa, puede seleccionar el valor default, que es el valor por omisión de la propiedad fileType. La utilización del valor por omisión significa que se seleccionará automáticamente un tipo de archivo:
  • Para una combinación determinada de sistema destino y tipo de registro EGL; o
  • Para salida impresa, cuando el nombre de archivo sea printer.

El apartado Referencias cruzadas de tipos de registro y tipos de archivo muestra los valores explícitos de fileType, así como el valor utiliza do si selecciona default.

fileName

Hace referencia a un nombre de archivo lógico, según lo especificado en uno o varios registros. Está creando un elemento de asociación que relaciona este nombre con un recurso físico de uno o varios sistemas destino. (Para la salida impresa, especifique el valor printer.)

Puede utilizar un asterisco (*) como carácter de sustitución global en un nombre de archivo lógico; sin embargo, ese carácter sólo es válido como último carácter. Para obtener detalles, consulte el apartado Asociaciones de recursos y tipos de archivos.

formFeedOnClose

Indica si se emite una alimentación de papel cuando finaliza la salida de un formulario de impresión. (Un formulario de impresión se produce cuando el código emite una sentencia print).

Esta propiedad sólo está disponible si el valor de fileName es printer en uno de los siguientes casos:
  • El valor de system es aix, iSeriesj o linux, y el valor de fileType es seqws o spool; o
  • El valor de system es win y el valor de fileType es seqws.
Seleccione uno de los siguientes valores:
YES
Se produce una alimentación de papel (valor por omisión)
NO
No se produce una alimentación de papel

replace

Especifica si, al añadir un registro al archivo, se sustituye el archivo en lugar de realizar adiciones al mismo. Esta entrada sólo se utiliza en estos casos:
  • Está generando código Java; y
  • El registro es del tipo de archivo seqws.
Seleccione uno de los siguientes valores:
NO
Se efectúan adiciones al archivo (valor por omisión)
YES
Se sustituye el archivo

system

Especifica la plataforma destino. Seleccione uno de los siguientes valores:
aix
AIX
iseriesj
iSeries
linux
Linux
zosbatch
z/OS por lotes
zoscics
CICS para z/OS
uss
z/OS UNIX System Services
win
Windows 2000/NT/XP
any
Cualquier plataforma destino; para obtener detalles, consulte el apartado Asociaciones de recursos y tipos de archivos.

systemName

Especifica el nombre de recurso del sistema del archivo o conjunto de datos asociado con el nombre de archivo. Especifique este valor entre comillas o apóstrofos si el valor incluye un espacio o alguno de los siguientes caracteres:
  % = , ( ) /

Al generar un programa COBOL, el significado del nombre de recurso del sistema varía según el sistema destino.

systemName para CICS para z/OS

Cuando el sistema destino es CICS para z/OS, el nombre del registro del sistema es un nombre de la tabla de control de archivos (FCT) CICS, excepto en los casos siguientes:
  • Cuando el valor de fileType es mq (en cuyo caso no se utiliza ninguna entrada de tabla CICS); o
  • Cuando está implicada la salida impresa, como ocurre cuando el valor de fileName es printer o cuando una sentencia print presenta un formulario.
Los detalles de los tipos de archivo son los siguientes:
MQ
El nombre de recurso del sistema es el nombre de una cola MQSeries. El valor por omisión es el nombre de la cola EGL.
SEQ
El nombre de recurso del sistema es el nombre de un archivo serie o de impresión asociado con un archivo JES SPOOL. Para archivos serie, el nombre por omisión es el nombre de archivo EGL.

SPOOL
El nombre de recurso del sistema es el nombre de un archivo serie o de impresión asociado con un archivo JES SPOOL. Para archivos serie, el nombre por omisión es el nombre de archivo EGL. Para la salida impresa, el valor por omisión es printer.
TEMPMAIN
El nombre de recurso del sistema es el nombre de la cola de almacenamiento principal. El valor por omisión es el nombre del archivo EGL.
TEMPAUX
El nombre de recurso del sistema es el nombre de una cola de almacenamiento temporal auxiliar. El valor por omisión es el nombre del archivo EGL.
TRANSIENT
El nombre de recurso del sistema es el nombre de una cola de almacenamiento temporal auxiliar. Para archivos serie, el valor por omisión son los cuatro primeros caracteres del nombre de archivo EGL. Para la salida impresa, el valor por omisión es printer.
VSAM
El nombre de recurso del sistema es el nombre de un archivo VSAM. El valor por omisión es el nombre del archivo EGL.

systemName para z/OS por lotes

Si el sistema destino es z/OS por lotes, se aplican las siguientes normas:
  • Si el valor de fileType es mq, el nombre de recurso del sistema es el nombre de la cola MQSeries.
  • De lo contrario, las normas son las siguientes:
    • Si el número de caracteres del nombre de recurso del sistema es 8 o menos y no contiene paréntesis ni puntos, el nombre se considera un nombre DD y se intenta asociar el registro con ese nombre DD. Si la asociación no es posible, el resultado depende del tipo de archivo:
      • Si el valor de fileType es vsam o seq, el trabajo finaliza con un error.
      • Si el valor de fileType es vsamrs o seqrs, se intenta asociar el registro con un conjunto de datos cuyo nombre sea el del recurso del sistema. Si esa asociación no es posible, el trabajo finaliza con un error.
    • Si el número de caracteres del nombre de recurso del sistema es mayor que 8 o si incluye paréntesis o puntos, el resultado también depende del tipo de archivo:
      • Si el valor de fileType es vsam o seq, el trabajo finaliza con un error.
      • Si el valor de fileType es vsamrs o seqrs, se intenta asociar el registro con un conjunto de datos cuyo nombre sea el del recurso del sistema. Si esa asociación no es posible, el trabajo finaliza con un error.

text

Especifica si debe provocarse que un programa Java generado haga lo siguiente al acceder a un archivo por medio de un registro serie:
  • Añadir caracteres de fin de línea durante la operación add. En plataformas no UNIX, esos caracteres son los de retorno de carro y salto de línea; en plataformas UNIX, el único carácter es es salto de línea.
  • Eliminar los caracteres de fin de línea durante las operaciones get o get next.
Seleccione uno de los siguientes valores:
NO
El valor por omisión es no añadir ni eliminar los caracteres de fin de línea
YES
Efectuar cambios, que resulta de utilidad si el programa generado intercambia datos con productos que esperan que los registros finalicen con los caracteres de fin de línea
Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.