Las secciones que siguen describen el efecto de una sentencia EGL set:
La tabla siguiente describe las sentencias set que afectan a un registro como un todo, aun registro fijo como un todo o a una matriz de cualquiera de los dos.
Formato de sentencia set | Efecto |
---|---|
set record empty | Vacía cada uno de los campos elementales. Para un registro, se vacía cada
registro subordinado, como está cada subordinado de esos subordinados, etc. Para un registro fijo
(que puede estar en un registro), los campos elementales están en el nivel más bajo de la
estructura fija. El efecto sobre cada campo elemental depende del tipo primitivo de ese campo:
|
set record initial | Restablece los valores de campo en los especificados por la propiedad
value durante el desarrollo, tal como es posible para un registro o
registro fijo declarado en un pageHandler o formulario. Un valor establecido por asignación no se
reintegra nunca. Si la propiedad value no tiene ningún valor o si el registro no está en un pageHandler o formulario, el efecto de set record initial es el mismo que el efecto de set record empty con una excepción: para un campo de tipo ANY, la sentencia set elimina cualquier especificación de tipo distinto a ANY. |
set record position | Establece la posición en el archivo VSAM asociado a un registro
fijo de tipo indexedRecord, (descrito posteriormente) o establece la posición en la base
de datos DL/I asociada con un registro de tipo DLISegment (también descrito
posteriormente). Este formato de sentencia set no está disponible para una matriz. |
Puede combinar formatos de sentencia insertando una coma para separar las opciones. Para un recuerdo dado, las opciones entran en vigor por el orden en el que aparecen en la sentencia set. Además, también puede especificar varios registros insertando una coma para separar uno de otro.
El diagrama de sintaxis es el siguiente:
La tabla siguiente describe las sentencias set que afectan a la totalidad de un formulario.
Formato de sentencia set | Efecto |
---|---|
set form alarm | Sólo para formularios de texto; hace sonar una alarma la próxima vez que una sentencia converse presenta el formulario. |
set form empty | Vacía el valor de cada campo en el formulario, borrando el contenido. El
efecto sobre un campo determinado depende del tipo primitivo:
|
set form initial | Restablece cada campo del formulario en su estado definido originariamente, según lo indicado en la declaración de formulario. Los cambios efectuados por el programa se cancelan. Para un campo de tipo ANY, la sentencia set elimina cualquier especificación cuyo tipo sea distinto a ANY. |
set form initialAttributes | Restablece cada campo del formulario en su estado definido originariamente, según lo indicado en la declaración de formulario. El contenido del campo no se ve afectado, ni (en el caso de un campo de tipo ANY) es el tipo afectado. |
Puede combinar formatos de sentencia insertando una coma para separar opciones como empty y alarm. Además, también puede especificar varios formularios insertando una coma para separar un formulario del siguiente.
El diagrama de sintaxis es el siguiente:
Las opciones son las descritas en la tabla anterior.
La tabla siguiente describe el formato de la sentencia set que afecta a un campo en cualquier contexto.
Formato de sentencia set | Efecto |
---|---|
set field empty | Vacía el campo o (para un campo fijo con una subestructura) vacía cada campo
elemental, subordinado. El efecto depende del tipo primitivo de un campo:
|
set field null | Anula el campo, si ello es válido. Para conocer detalles acerca de cuándo es válida la operación, consulte la sección itemsNullable. |
El diagrama de sintaxis es el siguiente:
Puede seleccionar una u otra opción y cada una se describe en la tabla anterior.
La tabla siguiente describe las sentencias set que afectan a un campo o a una matriz de campos de un formulario de texto. Una sentencia set determinada puede combinar opciones solamente mediante un conjunto de métodos determinado, como se describe más adelante. Muchas de las acciones descritas dependen del dispositivo en el que se visualice el formulario de texto. Se recomienda probar la salida de cada uno de los dispositivos soportados.
Formato de sentencia set | Efecto |
---|---|
set field blink | Provoca que el texto parpadee repetidamente. Esta opción solo está disponible en programas COBOL. |
set field bold | Hace que el texto aparezca en negrita. |
set field cursor | Sitúa el cursor en el campo especificado. Si el campo identifica una matriz y no tiene valor de apariciones, el cursor se sitúa en el primer elemento de matriz por omisión. Si el programa ejecuta varias sentencias en el formato set field cursor, la última de ellas estará en vigor cuando se ejecute la sentencia converse. |
set field defaultColor | Establece la propiedad color específica del campo en defaultColor, lo que significa que otras condiciones determinan el color visualizado. Para obtener detalles, consulte el apartado Propiedades de presentación de campos. |
set field dim | Hace que el campo aparezca con menos intensidad de la normal. Utilice este efecto para quitar énfasis al contenido de un campo. En entornos COBOL, la cláusula tiene el mismo efecto que set field normalIntensity, provocando que el campo sea visible, sin negritas. |
set field empty | Inicializa el valor del campo, borrando el contenido. El efecto sobre un campo determinado depende del tipo primitivo, como se describe en el apartado Inicialización de datos. |
set field full | Establece un campo vacío, en blanco o nulo en una serie de caracteres idénticos antes de que se presente el formulario:
Los caracteres del formulario sólo se devuelven al programa si el código de datos modificados del campo se establece según lo descrito en el apartado Código y propiedad de datos modificados. Un usuario que cambie el campo debe eliminar todos los caracteres que se encuentren en el campo para evitar que vuelvan al programa. La utilización de set field full sólo tiene efecto si el grupo de formularios se genera con la opción setFormItemFull del descriptor de construcción. Un campo de tipo MBCHAR se considera vacío si sólo contiene espacios de un solo byte. En relación a este tipo de campos, set field full asigna una serie de caracteres de un solo byte. |
set field initial | Vuelve a establecer el campo en el estado definido originariamente, independientemente de los cambios efectuados por el programa |
set field initialAttributes | Vuelve a establecer el campo en el estado definido originariamente, sin utilizar la propiedad value (que especifica el contenido actual del campo) |
set field invisible | Hace invisible el texto del campo |
set field masked | Adecuado para los archivos de contraseña. Si el formulario de texto lo presenta un programa Java, se visualiza un asterisco en lugar de cualquier carácter distinto de un espacio en blanco que teclee el usuario en un campo de entrada. Si el formulario de texto lo presenta un programa COBOL, esta opción hace invisible el texto del campo. |
set field modified | Establece el código de datos modificados según lo descrito en el apartado Código y propiedad de datos modificados. |
set field noHighlight | Elimina los efectos especiales de parpadeo, inversión y subrayado. |
set field normal | Vuelve a establecer los campos según lo descrito en relación a los
siguientes formatos:
Para obtener detalles, consulte la tabla siguiente. |
set field normalIntensity | Establece el campo como visible, sin negrita. |
set field protect | Establece el campo de forma que el usuario no pueda sobreescribir el valor en él. Consulte también el formato set field skip. |
set field reverse | Invierte los colores del texto y del fondo, de forma que (por ejemplo), si la pantalla tiene un fondo oscuro y el texto claro, el fondo pasa a ser claro y el texto pasa a ser oscuro. |
set field colorSeleccionado | Establece la propiedad color en el valor especificado. Los valores válidos para colorSeleccionado son los siguientes:
|
set field skip | Establece el campo de forma que el usuario no pueda sobreescribir el valor en él. Además, el cursor pasa por alto el campo en cualquiera de estos casos:
|
set field underline | Coloca un subrayado en la parte inferior del campo. |
set field unprotect | Establece el campo de forma que el usuario pueda sobreescribir el valor en él. |
El diagrama de sintaxis es el siguiente:
Las opciones son las descritas en la tabla anterior.