DFHMSD

Operandos

BASE

Especifica que se utiliza la misma base de almacenamiento para las correlaciones de descripciones simbólicas de más de un conjunto de correlaciones. Se especifica el mismo nombre para cada conjunto de correlaciones que va a compartir la misma base de almacenamiento. Puesto que todos los conjuntos de correlaciones con la misma base describen el mismo almacenamiento, los datos relacionados con un conjunto de correlaciones utilizado anteriormente pueden sobrescribirse cuando se utiliza un nuevo conjunto de correlaciones. Diferentes correlaciones en el mismo conjunto de correlaciones también se superponen entre sí.

Este operando no es válido para programas de lenguaje ensamblador y no se puede utilizar cuando se ha especificado STORAGE=AUTO.

COLOR

Indica el color individual o el color predeterminado para el conjunto de mapas (donde sea aplicable). Esto se altera temporalmente mediante el operando COLOR de la macro DFHMDI, que a su vez se altera temporalmente mediante el operando COLOR de la macro DFHMDF.

Los colores válidos son azul, rojo, rosa, verde, turquesa, amarillo y neutro.

El operando COLOR se ignora a menos que el terminal dé soporte al color, tal como indica la opción COLOR (YES) de la definición RDO TYPETERM.

CTRL

Define las características de los terminales IBM® 3270. El uso de cualquiera de las opciones de control del mandato SEND MAP altera temporalmente todas las opciones de control de la macro DFHMDI, lo que a su vez altera temporalmente todas las opciones de control de la macro DFHMSD.

Si se utiliza CTRL con paginación BMS acumulativa (es decir, la opción ACCUM se utiliza en los mandatos BMS SEND MAP), debe especificarse en la última (o única) correlación de una página, a menos que se altere temporalmente mediante las opciones ALARM, FREEKB, etc. del mandato SEND MAP o SEND CONTROL acumulado.

Imprimir

Debe especificarse si la impresora debe iniciarse; si se omite, los datos se envían al almacenamiento intermedio de la impresora pero no se imprimen. Este operando se ignora si el conjunto de correlaciones se utiliza con pantallas 3270 sin la característica Adaptador de impresora.

LONGITUD

Indica la longitud de línea en la impresora; la longitud puede especificarse como L40, L64, L80o HONEOM. L40, L64y L80 fuerzan una nueva línea después de 40, 64 u 80 caracteres, respectivamente. HONEOM hace que se utilice la longitud de línea de impresora predeterminada. Si se omite esta opción, BMS establece la longitud de línea a partir del tamaño de página TCT.

FREEKB

Hace que el teclado se desbloquee después de escribir la correlación. Si no se especifica FREEKB, el teclado permanece bloqueado; la entrada de datos del teclado se inhibe hasta que se cambia este estado.

Alarma

Activa la alarma audible 3270. Para terminales non-3270 VTAM ®, establece el distintivo de alarma en el FMH. (Esta característica no está soportada por unidades lógicas interactivas y por lotes.)

FRSET

Especifica que los códigos de datos modificados (MDT) de todos los campos actualmente en el almacenamiento intermedio 3270 deben restablecerse a una condición no modificada (es decir, restablecimiento de campo) antes de que los datos de correlación se graben en el almacenamiento intermedio. Esto permite a la macro DFHMDF con el operando ATTRB controlar el estado final de cualquier campo escrito o reescrito en respuesta a un mandato BMS.

CURSLOC

Indica que para todas las operaciones RECEIVE MAP que utilizan esta correlación en terminales 3270, BMS establece un distintivo en el elemento de estructura de datos de aplicación para el campo donde se encuentra el cursor.

DFHBMCUR puede probar el distintivo (consulte el libro de copias DFHBMSCA en Constantes relacionadas con BMS).

Para probar el distintivo (ejemplo de COBOL):

(DFHBMSCA)
...
02  DFHBMEOF   PIC X VALUE X'80'.
02  DFHBMCUR   PIC X VALUE X'02'.
02  DFHBMEC    PIC X VALUE X'82'.
02  DFHBMFLG   PIC X.
  88  DFHERASE       VALUES ARE X'80', X'82'.
  88  DFHCURSR       VALUES ARE X'02', X'82'.
MOVE FLD1F TO DFHBMFLG.
IF DFHERASE THEN ...
            ELSE ...
IF DFHCURSR THEN ...
            ELSE ...

Nota:

1. Si se especifica CURSLOC=YES para las definiciones de MAP, y no hay datos para ningún campo de la estructura de datos de la aplicación, pero el cursor se encuentra en un campo conocido por la estructura de datos de la aplicación, BMS establece el distintivo de cursor para el campo adecuado, pero los datos para todos los campos de la estructura de datos de la aplicación son nulos, y no se produce la condición MAPFAIL. La corriente de datos no correlacionada no está disponible para el programa de aplicación a menos que sea una solicitud RECEIVE DATA FROM.
2. Una definición CURSLOC válida en DFHMDI altera temporalmente la definición en DFHMSD.

DATOS

Especifica el formato de los datos.

campo

Especifica que los datos se pasan como campos contiguos, teniendo cada campo el formato:

LL

A

campo de datos

LL es dos bytes que especifican la longitud de los datos como entrada del terminal (estos dos bytes se ignoran en el proceso de salida). A es un byte en el que el programador puede colocar un atributo para alterar temporalmente el especificado en la correlación utilizada para procesar estos datos (consulte el libro de copias DFHBMSCA en Constantes relacionadas con BMS).

BLOCK

Especifica que los datos se pasan como una corriente continua en el formato siguiente:

A

campo de datos

Espacio

Esta secuencia se procesa como segmentos de línea de la longitud especificada en la correlación utilizada para procesar los datos. Los datos están en el formato en el que aparecen en el terminal; es decir, contienen campos de datos y espacios en blanco intercalados correspondientes a los espacios que van a aparecer entre los campos en la salida. No puede utilizar DSATTS=YES, si especifica DATA=BLOCK.

Los datos de bloque se describen más adelante en Datos de bloque.

DSATOS

Especifica los tipos de atributo que se van a incluir en la correlación de descripción simbólica. Estos tipos pueden ser uno o más de los siguientes: COLOR, HILIGHT, ESQUEMA, PS, SOSI, TRANSP y VALIDN. Cualquier tipo incluido en DSATTS también debería incluirse en MAPATTS.

DECT

Especifica si el libro de copias generado da soporte a la forma normal o larga de la estructura de datos de aplicación (ADS).

ADS

Solicita la correlación del formato normal de ADS (valor predeterminado).

ADSL

Solicita la correlación del formato largo del ADS, donde todos los campos están alineados en límites de cuatro bytes. Este formulario es necesario para la interfaz 3270 Bridge para IBM MQ.

Esta opción requiere LANG=C.

EXTATT

Este operando está soportado para la compatibilidad con releases anteriores. Cada atributo ampliado se puede definir individualmente. Para correlaciones nuevas, utilice los operandos DSATTS y MAPATTS en su lugar.

NO

Es equivalente a no especificar ni el operando DSATTS ni el operando MAPATTS.

SÍ

Es equivalente a especificar los operandos siguientes:

MAPATTS=(COLOR,HILIGHT,PS,VALIDN)
DSATTS=(COLOR,HILIGHT,PS,VALIDN)

MAPONLY

Es equivalente a especificar el operando siguiente:

MAPATTS=(COLOR,HILIGHT,PS,VALIDN)

FLDSEP

Especifica la secuencia de separador de campo (1-4 caracteres) para la entrada de dispositivos non-3270 . La entrada de dispositivos non-3270 se puede especificar como una sola serie de datos con los campos de delimitador de secuencia de separador de campo. Los datos entre los separadores de campo se mueven a los campos de entrada en la correlación en orden.

DOBLEZ

Especifica si se deben generar caracteres en minúsculas o en mayúsculas en los programas de lenguaje C.

FOLD sólo está disponible para programas escritos en C.

HILIGHT

Especifica el atributo de resaltado predeterminado para todos los campos de todas las correlaciones de un conjunto de correlaciones. Esto se altera temporalmente mediante el operando HILIGHT de DFHMDI, que a su vez se altera temporalmente mediante el operando HILIGHT de DFHMDF.

DESAC.

Indica que no se utiliza ningún resaltado (el valor predeterminado).

BLINK

Especifica que el campo debe parpadear.

Inverso

Especifica que el carácter o campo se visualiza en contraste invertido, por ejemplo, en un 3278, caracteres negros en un fondo verde.

SUBRAYADO

Especifica que un campo está subrayado.

El operando HILIGHT se ignora a menos que el terminal soporte el resaltado, tal como indica HILIGHT (YES) en la definición RDO TYPETERM.

HTAB

Especifica una o más posiciones de tabulación para utilizarlas con unidades lógicas interactivas y por lotes e impresoras SCS con control de formularios horizontal.

lang

Especifica el lenguaje fuente de los programas de aplicación en los que se copian las correlaciones de descripciones simbólicas del conjunto de correlaciones. COBOL es OS/VS COBOL, que no se puede ejecutar bajo esta versión de CICS y COBOL2 es Enterprise COBOL o VS COBOL II. Esta opción sólo necesita codificarse para DFHMSD TYPE=DSECT. Si un conjunto de correlaciones va a ser utilizado por más de un programa, y los programas no están todos escritos en el mismo lenguaje fuente, se debe definir una versión separada del conjunto de correlaciones para cada lenguaje de programación.

LDC

Especifica el código que utilizará CICS para determinar el nemotécnico de dispositivo lógico que se utilizará para una operación de salida BMS. Si no se ha especificado ningún operando LDC en ninguna salida BMS anterior en el mensaje lógico, este LDC se transmitirá en la cabecera de gestión de funciones a la unidad lógica. Este operando sólo se utiliza para terminales 3600 soportados por VTAM y unidades lógicas de proceso por lotes.

MAPATOS

Especifica los tipos de atributo que se van a incluir en la correlación física. Estos tipos pueden ser uno o más de los siguientes: COLOR, HILIGHT, ESQUEMA, PS, SOSI, TRANSP y VALIDN. Esta lista debe incluir todos los tipos de atributo que se deben especificar para campos individuales en la correlación (macro DFHMDF).

Siempre que sea posible, estos valores se deducirán de los operandos ya especificados en las macros DFHMDI y DFHMSD. Por ejemplo, si se ha especificado COLOR=BLUE, se presupone MAPATTS=COLOR.

MODE

Especifica si el conjunto de correlaciones debe utilizarse para entrada, salida o ambos.

OBFMT

Especifica si se va a utilizar el formato externo. Este operando sólo está disponible para 3650 unidades lógicas, o para un procesador de la serie 8100 que ejecuta DPS Release 2 y está definido en CICS como una unidad lógica LUTYPE2 . Para obtener más información, consulte Formato externo.

El operando OBFMT en DFHMSD se altera temporalmente mediante el operando OBFMT en DFHMDI.

SÍ

Especifica que todas las correlaciones de este conjunto de correlaciones se pueden utilizar en formato externo, excepto aquellas para las que se ha especificado OBFMT = NO en la macro DFHMDI.

NO

Especifica que no se pueden utilizar correlaciones en este conjunto de correlaciones en formato externo, excepto aquellas para las que se ha especificado OBFMT = YES en DFHMDI.

OUTLINE

Permite incluir líneas arriba, abajo, a la izquierda o a la derecha de un campo. Puede utilizar estas líneas en cualquier combinación para construir recuadros alrededor de campos o grupos de campos.

PARTN

Especifica la partición predeterminada que se va a asociar con correlaciones en este conjunto de correlaciones. Si se especifica la opción ACTIVATE, la partición especificada también se activa cuando las correlaciones de este conjunto de correlaciones se generan en un terminal que soporta particiones. Esta opción se altera temporalmente mediante el operando PARTN de la macro DFHMDI, que a su vez se altera temporalmente mediante cualquier opción OUTPARTN o ACTPARTN en el mandato SEND MAP, o la opción INPARTN en un mandato RECEIVE MAP.

El operando PARTN se ignora si el terminal de destino no soporta particiones, o si no hay ningún conjunto de particiones asociado a la transacción.

PS

Especifica que se van a utilizar símbolos programados. Esto se altera temporalmente mediante el operando PS de la macro DFHMDI, que a su vez se altera temporalmente mediante el operando PS de la macro DFHMDF.

BASE

Especifica que se va a utilizar el conjunto de símbolos base.

Psid

Especifica un único carácter EBCDIC, o un código hexadecimal con el formato X'nn ', que identifica el conjunto de símbolos programados que se van a utilizar.

El operando PS se ignora a menos que el terminal soporte símbolos programados, tal como indica PROGBOLOS (YES) en la definición RDO TYPETERM.

SOSI

Indica que el campo puede contener una mezcla de datos EBCDIC y DBCS. Los subcampos DBCS de un campo EBCDIC están delimitados por los caracteres SO (desplazamiento a teclado ideográfico) y SI (desplazamiento a teclado estándar). Tanto SO como SI ocupan una única posición de pantalla (normalmente se visualiza como un espacio en blanco). Se pueden incluir en cualquier campo no DBCS en la salida siempre que estén emparejados correctamente. El usuario de terminal puede transmitirlos de entrada si ya están presentes en el campo, pero puede añadirlos a un campo EBCDIC sólo si el campo tiene el atributo SOSI.

STORAGE

El significado de este operando depende del idioma en el que se escriben los programas de aplicación, como se indica a continuación:

Para un programa COBOL , STORAGE=AUTO especifica que las correlaciones de descripción simbólicas del conjunto de correlaciones deben ocupar áreas de almacenamiento separadas (es decir, no redefinidas). Este operando se utiliza cuando las correlaciones de descripción simbólicas se copian en la sección de almacenamiento de trabajo y el almacenamiento para las correlaciones separadas en el conjunto de correlaciones se va a utilizar simultáneamente.

Para un programa C , STORAGE=AUTO especifica que las correlaciones de descripción simbólicas deben definirse como que tienen la clase de almacenamiento automático. Si no se especifica STORAGE=AUTO, se declaran como punteros.

Para un programa PL/I , STORAGE=AUTO especifica que las correlaciones de descripción simbólicas deben declararse como que tienen la clase de almacenamiento AUTOMATIC. Si no se especifica STORAGE=AUTO, se declaran como BASED.

Para un programa de lenguaje ensamblador , STORAGE=AUTO especifica que las correlaciones individuales de un conjunto de correlaciones deben ocupar áreas separadas de almacenamiento en lugar de superponerlas entre sí.

Para todos los idiomas:

• No puede especificar BASE=nombre y STORAGE=AUTO para el mismo conjunto de mapas.
• Si se especifica STORAGE=AUTO y TIOAPFX no, se asume TIOAPFX=YES.

Sufijo

Especifica un sufijo dependiente de dispositivo definido por el usuario de un carácter para este conjunto de correlaciones, como alternativa a un sufijo generado por el operando TERM. El sufijo especificado por este operando debe coincidir con el valor de una transacción definida en el atributo ALTSUFFIX de una definición TYPETERM o ALTSFX en la tabla de control de terminal TYPE=TERMINAL. Utilice un valor numérico para evitar conflictos con los sufijos generados por el operando TERM.

TERM

Especifica el tipo de terminal o unidad lógica (LU) asociado con el conjunto de correlaciones. Si no se especifica ningún tipo de terminal o LU, se asume 3270. Los tipos de terminal y las LU que puede especificar, junto con sus sufijos generados, se muestran en la Tabla 1.

Además, debe tener en cuenta lo siguiente:

Si se especifica ALL, asegúrese de que los caracteres dependientes del dispositivo no estén incluidos en el conjunto de mapas y que las características de formato como el tamaño de página sean adecuadas para todas las operaciones de entrada/salida (y todos los terminales) en los que se aplica el conjunto de mapas. Por ejemplo, algunos terminales están limitados a 480 bytes, otros a 1920 bytes; el 3604 está limitado a seis líneas de 40 caracteres cada una. Dentro de estas pautas, el uso de TODOS puede ofrecer ventajas importantes. Puesto que se necesita una ejecución de ensamblaje para cada generación de correlación, el uso de ALL, que indica que se va a utilizar una correlación para más de un terminal, puede dar como resultado un ahorro de tiempo y almacenamiento significativo.

Sin embargo, se consigue un mejor rendimiento en tiempo de ejecución para las correlaciones utilizadas por tipos de terminal únicos si se especifica el tipo de terminal (en lugar de ALL). De forma alternativa, el soporte de BMS para conjuntos de correlaciones dependientes de dispositivo se puede omitir especificando NODDS en el operando BMS de los parámetros de inicialización del sistema.

Tabla| 1. Tipos de terminal BMS

Tipo	Sufijo	Notas
CRLP	A	Impresora de entrada/salida de línea de lector de tarjetas
TAPE	B
DISK	C
TWX	D
1050	E
2740	F
2741	G
2770	I
2780	J
3780	K
3270-1 (40 columnas)	L
3270-2 (80 columnas)	M
INTLU/3767/3770I/SCS	p	Todas las LU interactivas, incluidas las LU de función completa 3790 y las LU de impresora SCS (3270 y 3790).
2980	Q
2980-4	R
3270	en blanco	Valor predeterminado si se omite TERM. Igual que ALL; se utiliza cuando no es necesario distinguir entre modelos.
3601	U
3653	V	Más host-conv (3653) LU.
3650UP	W	Más LU de intérprete.
3650/3270	X	Plus host-conv (32700 LU.
BCHLU/3770B	Y	Más todas las LU por lotes y BDI.
ALL (todo lo anterior)	en blanco

TIOAPFX

Especifica si BMS debe incluir un relleno en las correlaciones de descripción simbólicas para permitir el prefijo TIOA no utilizado.

SÍ

Especifica que el relleno debe incluirse en las correlaciones de descripción simbólicas. Si se especifica TIOAPFX=YES, todas las correlaciones del conjunto de correlaciones tienen el relleno, excepto cuando se especifica TIOAPFX=NO en la macro DFHMDI. TIOAPFX=YES es el valor predeterminado si se especifica STORAGE=AUTO. TIOAPFX=YES siempre debe utilizarse para programas de aplicación a nivel de mandatos.

NO

Es el valor predeterminado, a menos que se especifique STORAGE=AUTO, y especifica que no se debe incluir el relleno. El relleno todavía se puede incluir para una correlación si se especifica TIOAPFX=YES en DFHMDI.

TRANSP

Determina si el fondo de un campo alfanumérico es transparente u opaco, es decir, si un espacio de presentación subyacente (gráfico) es visible entre los caracteres.

TRIGRAFO

Especifica las secuencias de trigrafía que se van a utilizar en las correlaciones de descripciones simbólicas de lenguaje C.

Cuando TRIGRAPH=YES, se generan secuencias de trigraph:

{

se imprime como??? <

}

se imprime como? ?>

[

imprime como?? (

]

imprime como??)

Esta opción sólo está disponible para programas escritos en C.

TIPO

Especifica el tipo de correlación que se va a generar utilizando la definición. Ambos tipos de correlación deben generarse antes de que un programa de aplicación pueda utilizar el conjunto de correlaciones. Si se necesitan correlaciones de descripciones simbólicas alineadas, debe asegurarse de que especifica SYSPARM=ADSECT y SYSPARM=AMAP al ensamblar las correlaciones simbólicas y físicas respectivamente.

DECT

Especifica que se va a generar una correlación de descripción simbólica. Las correlaciones de descripciones simbólicas deben copiarse en el programa fuente antes de que se conviertan y compilen.

MAP

Especifica que se va a generar una correlación física. Las correlaciones físicas deben ensamblarse o compilarse, editarse con enlaces y catalogarse en la biblioteca de programas CICS para que un programa de aplicación pueda utilizarlas.

Si se van a generar tanto la correlación como DSECT en el mismo trabajo, se puede utilizar la opción SYSPARM en el paso de ejecución del trabajo de ensamblador.

VALIDN

Especifica que:

• La validación se debe utilizar en un terminal 8775
• Este campo puede ser procesado por las salidas de usuario globales de BMS

Esto se altera temporalmente mediante el operando VALIDN de la macro DFHMDI, que a su vez se altera temporalmente mediante el VALIDN de la macro DFHMDF.

MUSTFILL

Especifica que el campo debe rellenarse completamente con datos. Un intento de mover el cursor desde el campo antes de que se haya rellenado, o de transmitir datos desde un campo incompleto, genera la condición INHIBIR ENTRADA.

MUSTENTER

Especifica que los datos deben introducirse en el campo, aunque no es necesario rellenarlos. Un intento de mover el cursor desde un campo vacío genera la condición INHIBIR ENTRADA.

DESENCADENANTE

Especifica que este campo es un campo desencadenante. Los campos de desencadenante se describen en Soporte de campo de desencadenante.

USEREXIT

Especifica que este campo debe ser procesado por las salidas de usuario globales BMS, XBMIN y XBMOUT, si este campo se recibe o se transmite en una corriente de datos 3270 cuando se habilita la salida respectiva.

Las especificaciones MUSTFILL, MUSTENTER y TRIGGER sólo son válidas para los terminales que dan soporte al atributo ampliado de validación de campo; de lo contrario, se ignoran. La especificación USEREXIT se aplica a todos los dispositivos 3270.

Nota: La especificación USEREXIT no está conectada con el atributo ampliado de validación de campo tal como se define en la arquitectura de corriente de datos 3270.

VTAB

Especifica una o más posiciones de tabulación para utilizarlas con unidades lógicas interactivas y por lotes e impresoras SCS con control de formularios vertical.