El tipo de datos almacenados: ACTUAL

ACTUAL describe el tipo y la longitud de los datos, tal como se encuentran almacenados en el origen de datos. Mientras algunos tipos de datos, como los alfanuméricos, son universales, otros difieren de un origen de datos a otro. Algunos orígenes de datos admiten tipos de datos únicos. Por este motivo, los valores que puede asignar al atributo ACTUAL difieren en cada tipo de origen de datos.

Atributo ACTUAL

Cómo:

Especificar el atributo ACTUAL

Referencia:

Este atributo describe el tipo y la longitud de los datos, tal como existen en el origen de datos El origen de esta información es la descripción existente del origen de datos (como una declaración COBOL FD). El atributo ACTUAL es una de las características distintivas de un archivo máster, en orígenes de datos que no sean FOCUS. Como este atributo solo existe para describir el formato de una estructura de datos no FOCUS, no se emplea en el archivo máster de estructuras FOCUS.

Si su origen de datos tiene una fecha almacenada como campo alfanumérico y necesita convertirla en una fecha WebFOCUS, con fines de clasificación o agregación en un informe, puede utilizar el atributo DATEPATTERN en el archivo máster. A continuación, WebFOCUS emplea el patrón especificado, para convertir la fecha alfanumérica en una fecha deWebFOCUS.

Principio de página

Sintaxis: Cómo Especificar el atributo ACTUAL

ACTUAL = format

donde:

format

Consiste de los valores tomados de la siguiente tabla, que muestra los códigos de los tipos de datos que se puede leer.

Tipo ACTUAL
Significado
DATE
El formato interno de número entero de cuatro bytes, que representa la diferencia entre la fecha que se va a introducir y la fecha base.
An
Donde n = 1-4095, para los orígenes de datos secuenciales de formato fijo y VSAM, y 1-256, para el resto de orígenes de datos no FOCUS. Caracteres alfanuméricos A-Z, 0-9 y otros caracteres especiales, en el modo de visualización EBCDIC.
An acepta todos los formatos de cadenas fecha-hora, además de los formatos de visualización Hn. ACTUAL=An también acepta un campo de fecha-hora, como ocurre en los archivos HOLD alfanuméricos o SAVE.
D8
Números de punto flotante, de precisión doble, almacenados internamente en ocho bytes.
F4
Números de punto flotante, de precisión simple, almacenados internamente en cuatro bytes.
Hn
H8, H10 o H12 acepta un campo de fecha-hora, como tiene lugar en archivos HOLD binarios o SAVE.
In
Números enteros binarios:
I1 = número entero binario de un byte.
I2 = número entero binario de media palabra (2 bytes).
I4 = número entero binario de palabra completa (4 bytes).
I8 = número entero binario de palabra doble (8 bytes). Nota: USAGE debe ser P o D. Se respetan los decimales, con la conversión apropiada a los decimales de USAGE P o D.
Pn
Donde n = 1-16. Formato interno de decimal empaquetado. n es el número de bytes, cada uno con dos dígitos, excepto el último, que contiene un dígito y el signo (+ o -). Por ejemplo, P6 significa 11 dígitos más un signo.
Zn
Donde n = 1-31. Formato interno de decimal en zonas. n es el número de dígitos, cada uno ocupando un byte de almacenamiento. El último dígito contiene un dígito y el signo.
Si el campo contiene un punto decimal asumido, represente el campo con un formato ACTUAL de Zn y un formato USAGE de Pm.d, donde m es el número total de dígitos mostrado, más el punto decimal asumido, d es el número de posiciones decimales y m debe tener al menos una unidad más que el valor de n. Por ejemplo, un campo con ACTUAL=Z5 y una posición decimal requiere USAGE=P6.1 (o P7.1, o superior).

Tipo ACTUAL	Significado
DATE	El formato interno de número entero de cuatro bytes, que representa la diferencia entre la fecha que se va a introducir y la fecha base.
An	Donde n = 1-4095, para los orígenes de datos secuenciales de formato fijo y VSAM, y 1-256, para el resto de orígenes de datos no FOCUS. Caracteres alfanuméricos A-Z, 0-9 y otros caracteres especiales, en el modo de visualización EBCDIC. An acepta todos los formatos de cadenas fecha-hora, además de los formatos de visualización Hn. ACTUAL=An también acepta un campo de fecha-hora, como ocurre en los archivos HOLD alfanuméricos o SAVE.
D8	Números de punto flotante, de precisión doble, almacenados internamente en ocho bytes.
F4	Números de punto flotante, de precisión simple, almacenados internamente en cuatro bytes.
Hn	H8, H10 o H12 acepta un campo de fecha-hora, como tiene lugar en archivos HOLD binarios o SAVE.
In	Números enteros binarios: I1 = número entero binario de un byte. I2 = número entero binario de media palabra (2 bytes). I4 = número entero binario de palabra completa (4 bytes). I8 = número entero binario de palabra doble (8 bytes). Nota: USAGE debe ser P o D. Se respetan los decimales, con la conversión apropiada a los decimales de USAGE P o D.
Pn	Donde n = 1-16. Formato interno de decimal empaquetado. n es el número de bytes, cada uno con dos dígitos, excepto el último, que contiene un dígito y el signo (+ o -). Por ejemplo, P6 significa 11 dígitos más un signo.
Zn	Donde n = 1-31. Formato interno de decimal en zonas. n es el número de dígitos, cada uno ocupando un byte de almacenamiento. El último dígito contiene un dígito y el signo. Si el campo contiene un punto decimal asumido, represente el campo con un formato ACTUAL de Zn y un formato USAGE de Pm.d, donde m es el número total de dígitos mostrado, más el punto decimal asumido, d es el número de posiciones decimales y m debe tener al menos una unidad más que el valor de n. Por ejemplo, un campo con ACTUAL=Z5 y una posición decimal requiere USAGE=P6.1 (o P7.1, o superior).

Nota:

A menos que sus datos hayan sido creados por un programa, todos los caracteres serán de tipo A (alfanuméricos) o Z (decimal en zonas).
Los formatos ACTUAL admitidos en valores de fecha-hora son An, H8, H10 y H12. An acepta todos los formatos de cadenas fecha-hora, además del formato de visualización Hn USAGE. ACTUAL=H8, H10 o H12 acepta un campo de fecha-hora, como tiene lugar en archivos HOLD binarios o SAVE. ACTUAL=An acepta un campo de fecha-hora, como ocurre en los archivos HOLD alfanuméricos o SAVE.
Si crea un archivo HOLD binario a partir de un origen de datos con un campo de fecha-hora, el formato ACTUAL de ese campo tendrá la forma Hn. Si crea un archivo HOLD alfanumérico a partir de un origen de datos con un campo de fecha-hora, el formato ACTUAL de ese campo tendrá la forma An.

Principio de página

Referencia: Conversión de ACTUAL a USAGE

Las siguientes conversiones del formato ACTUAL al formato USAGE (visualización) se manipulan de forma automática y no necesitan invocar una función:

ACTUAL	USAGE
A	A, D, F, I, P, date format, date-time format
D	D
DATE	date format
F	F
H	H
I	I, date format
P	P, date format
Z	D, F, I, P

Principio de página

Referencia: Conversión de una imagen COBOL al formato USAGE

La tabla siguiente muestra los formatos USAGE y ACTUAL de las descripciones de COBOL, FORTRAN, PL1 y el campo Ensamblador.

COBOL USAGE FORMAT	BYTES OF COBOL PICTURE	INTERNAL STORAGE	ACTUAL FORMAT	USAGE FORMAT
DISPLAY DISPLAY DISPLAY DISPLAY	X(4) S99 9(5)V9 99	4 2 6 2	A4 Z2 Z6.1 A2	A4 P3 P8.1 A2
COMP COMP COMP* COMP COMP-1**	S9 S9(4) S9(5) S9(9) —	4 4 4 4 4	I2 I2 I4 I4 F4	I1 I4 I5 I9 F6
COMP-2***	—	8	D8	D15
COMP-3 COMP-3 COMP-3	9 S9V99 9(4)V9(3)	8 8 8	P1 P2 P4	P1 P5.2 P8.3
FIXED BINARY(7) (COMP-4)	B or XL1	8	I4	I7

* Equivalente a INTEGER en FORTRAN, FIXED BINARY(31) en PL/1, y F en Ensamblador.

** Equivalente a REAL en FORTRAN, FLOAT(6) en PL/1, y E en Ensamblador.

*** Equivalente a DOUBLE PRECISION o REAL*8 en FORTRAN, FLOAT(16) en PL/1, y D en Ensamblador.

Nota:

Las longitudes mostradas para USAGE son valores mínimos. Pueden ser más largas. También puede añadir opciones de edición adicionales.
En los formatos USAGE, es obligatoria la presencia de una posición de carácter adicional para el signo negativo, si espera tener valores negativos.
Las cláusulas PICTURE no se admiten con elementos de punto flotante.
La longitud de USAGE debe admitir el máximo número de dígitos posible.
En los formatos USAGE, es obligatoria la presencia de una posición de carácter adicional para el punto decimal.

Para más información sobre cómo usar ACTUAL con orígenes de datos secuenciales, VSAM e ISAM, consulte Cómo describir un origen de datos secuencial, VSAM o ISAM. Para otros tipos de orígenes de datos, consulte la documentación de su adaptador. Tenga en cuenta que los orígenes de datos no utilizan el atributo ACTUAL, si no que emplean el atributo USAGE para especificar el formato y almacenamiento de un campo.