DFHMDI

Operandos

COLOR

indica el color individual o el color predeterminado para el conjunto de mapas (cuando sea aplicable). Lo altera temporalmente 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 soporte el color, tal como indica la opción de definición RDO TYPETERM COLOR (YES).

Columna

especifica la columna en una línea en la que se va a colocar el mapa, es decir, establece el margen de mapa izquierdo o derecho. El operando JUSTIFIQUE de la macro DFHMDI controla si la selección de correlación y margen de página y el recuento de columnas deben estar en el lado izquierdo o derecho de la página. Las columnas entre el margen de mapa especificado y el margen de página no están disponibles para su uso posterior en la página para cualquier línea incluida en el mapa.

NUMBER

es la columna del margen de página izquierdo o derecho en la que debe establecerse el margen del mapa izquierdo o derecho.

SIGUIENTE

indica que el margen del mapa izquierdo o derecho se colocará en la siguiente columna disponible desde la izquierda o derecha en la línea actual.

SAME

indica que el margen de mapa izquierdo o derecho debe establecerse en la misma columna que la última correlación no de cabecera o no de cola utilizada que ha especificado COLUMN=número y los mismos operandos JUSTIFIQUE que esta macro.

Para las operaciones de entrada, la correlación se coloca en el extremo izquierdo o derecho, dependiendo de si se ha especificado JUSTIFY=LEFT o JUSTIFY=RIGHT.

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 se puede especificar como L40, L64, L80o HONEOM. L40, L64y L80 fuerzan una nueva línea después de 40, 64 u 80 caracteres. 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 el mapa. 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.

Nota: no se puede especificar CTRL en las macros DFHMDI y DFHMSD en el mismo conjunto de correlaciones.

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 MAP y no hay datos para ningún campo de la estructura de datos de la aplicación, pero el cursor se encuentra dentro de 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" son dos bytes que especifican la longitud de los datos como entrada del terminal (se ignora 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.

EXTATT

este operando está soportado para la compatibilidad con releases anteriores. Cada uno de los atributos ampliados se puede definir individualmente. Para correlaciones nuevas, en su lugar se deben utilizar los operandos DSATTS y MAPATTS.

NO

es equivalente a no especificar el operando DSATTS o el operando MAPATTS.

SÍ

es equivalente a:

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

MAPONLY

es equivalente a:

MAPATTS=(COLOR,HILIGHT,PS,VALIDN)

Campos

especifica si el mapa contiene campos. Si especifica FIELDS=NO, crea un mapa nulo que define un "agujero" en la vista de pantalla de BMS. BMS no puede cambiar el contenido de dicho agujero después de que lo haya creado enviando un mapa nulo.

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.

Cabecera

permite utilizar la correlación durante la creación de páginas sin terminar la condición OVERFLOW. Este operando se puede especificar para más de una correlación en un conjunto de correlaciones.

HILIGHT

especifica el atributo de resaltado predeterminado para todos los campos de todas las correlaciones de un conjunto de correlaciones. Esto lo altera temporalmente el operando HILIGHT de DFHMDF.

DESAC.

es el valor predeterminado e indica que no se utiliza ningún resaltado.

BLINK

especifica que el campo debe parpadear.

Inverso

especifica que el carácter o campo se visualiza en el vídeo inverso, 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,

Justificación

especifica la posición del mapa en la página.

LEFT

especifica que el mapa debe situarse empezando por la columna especificada desde el margen izquierdo de la línea especificada.

DERECHA

especifica que el mapa debe situarse empezando por la columna especificada desde el margen derecho en la línea especificada.

PRIMERO

especifica que el mapa debe situarse como el primer mapa de una página nueva. Se considera que se ha completado cualquier página con formato parcial de los mandatos BMS anteriores. Este operando sólo se puede especificar para una correlación por página.

Último

indica que el mapa se colocará al pie de la página actual. Este operando se puede especificar para que varias correlaciones se coloquen en una página. Sin embargo, los mapas que no sean el primer mapa para el que se ha especificado deben poder colocarse horizontalmente sin que sea necesario utilizar más líneas.

Inferior

para un mandato SEND MAP ACCUM tiene el mismo efecto que LAST. Para un mandato SEND MAP (sin ACCUM) y un mandato RECEIVE MAP, JUSTIFY=BOTTOM coloca el mapa al pie de la pantalla si el número de líneas del mapa se especifica en el operando SIZE. No se tienen en cuenta las correlaciones de cola en el conjunto de correlaciones. JUSTIFY=BOTTOM es equivalente a especificar

LINE=(screendepth-mapdepth+1)

en la definición de mapa, pero permite que se utilice el mismo mapa para diferentes tamaños de pantalla. JUSTIFY=BOTTOM se ignora si no se especifica también el número de líneas. Si se especifican JUSTIFY=BOTTOM y LINE, se ignora el valor especificado en LINE.

LEFT y RIGHT se excluyen mutuamente, al igual que FIRST y LAST. Si no se especifica FIRST o LAST, los datos se correlacionan en la siguiente posición disponible tal como lo determinan otros parámetros de la definición de correlación y la operación de correlación actual. Se ignora FIRST o LAST a menos que se especifique ACCUM en los mandatos SEND MAP; de lo contrario, sólo se coloca una correlación en cada página.

Nota: Si un campo se inicializa mediante una correlación de salida o contiene datos de cualquier otro origen, los datos que se teclean como entrada sólo sobrescriben la longitud equivalente de los datos existentes; los datos existentes sobrantes permanecen en el campo y podrían provocar una interpretación inesperada de los nuevos datos.

line

especifica la línea inicial de una página en la que se van a formatear los datos de un mapa.

NUMBER

es un valor comprendido entre 1 y 240, especificando un número de línea inicial. Una solicitud para correlacionar, en una línea y columna, datos que se han formateado en respuesta a un mandato BMS anterior, hace que la página actual se trate como si estuviera completa. Los nuevos datos se formatean en la línea y columna solicitadas en una página nueva.

SIGUIENTE

especifica que el formato de los datos debe comenzar en la siguiente línea vacía disponible. Si se especifica LINE=NEXT en la macro DFHMDI, se ignora para las operaciones de entrada y se presupone LINE=1 .

SAME

especifica que el formato de los datos debe comenzar en la misma línea que la utilizada para un mandato BMS anterior. Si se especifica COLUMN=NEXT, se ignora para las operaciones de entrada y se asume COLUMN=1 . Si los datos no caben en la misma línea, se colocan en la siguiente línea disponible que esté vacía.

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.

OBFMT

especifica si se va a utilizar el formateo 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 altera temporalmente el operando OBFMT en la macro DFHMSD.

SÍ

especifica que esta definición de correlación se puede utilizar en formato externo.

NO

especifica que esta definición de correlación no se puede utilizar en formato externo.

OUTLINE

permite que las líneas se incluyan por encima, por debajo, 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 altera temporalmente la opción PARTN de la macro DFHMSD y la altera temporalmente cualquier opción OUTPARTN o ACTPARTN en el mandato SEND MAP o la opción INPARTN en un mandato RECEIVE MAP.

La opción 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 altera temporalmente el operando PS de la macro DFHMSD y lo altera temporalmente 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.

SIZE

especifica el tamaño de una correlación.

línea

es un valor en el rango 1-240, especificando la profundidad de un mapa como un número de líneas.

columna

es un valor en el rango 1-240, especificando el ancho de un mapa como un número de columnas.

Este operando es necesario en los casos siguientes:

• Se utiliza una macro DFHMDF asociada con el operando POS.
• Se debe hacer referencia a la correlación en un mandato SEND MAP con la opción ACCUM.
• La correlación se debe utilizar cuando se hace referencia a datos de entrada de un terminal que no sea 3270 en un mandato RECEIVE MAP.
• La correlación se debe utilizar para enviar o recibir datos a través de CICS 3270 Web Bridge.

SOSI

indica que el campo puede contener una mezcla de datos EBCDIC y DBCS. Los subcampos DBCS dentro de un campo EBCDIC están delimitados por 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, si 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.

TERM

para mantener la compatibilidad con versiones anteriores.

TIOAPFX

especifica si BMS debe incluir un relleno en las correlaciones de descripciones simbólicas para permitir el prefijo TIOA no utilizado. Este operando altera temporalmente el operando TIOAPFX especificado o predeterminado para la macro DFHMSD. Si no se especifica, se utiliza el valor especificado o predeterminado en la macro DFHMSD.

SÍ

especifica que el relleno debe incluirse en los mapas de descripción simbólica. Utilice siempre TIOAPFX=YES para programas de aplicación de nivel de mandatos.

NO

especifica que no se debe incluir el relleno.

REMOLQUE

permite utilizar la correlación durante la creación de páginas sin terminar la condición OVERFLOW. Este operando se puede especificar para más de una correlación en un conjunto de correlaciones. Si se utiliza una correlación de remolque distinta de la del entorno de desbordamiento, el espacio reservado normalmente para correlaciones de remolque de desbordamiento no se reserva al correlacionar la correlación de remolque.

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.

VALIDN

especifica que:

• la validación se va a utilizar en un terminal 8775
• este campo puede ser procesado por las salidas de usuario globales de BMS

Lo altera temporalmente el operando VALIDN de la macro DFHMDF y altera temporalmente el operando VALIDN de la macro DFHMSD. '

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á totalmente conectada con el atributo ampliado de validación de campo tal como se define en la arquitectura de corriente de datos 3270.