Cómo controlar atributos en archivos máster HOLD

Cómo controlar nombres de campo en un archivo máster

Cómo:

Controlar nombres de campo en un archivo máster

Referencia:

Notas sobre cómo controlar nombres de campo en archivos HOLD

Cuando SET ASNAMES está activado, se emplea el literal, MIXED o FOCUS, especificado en una frase AS de una solicitud de informe como nombre de campo en un archivo máster HOLD. Este comando también controla los nombres de campos ACROSS en archivos HOLD.

Principio de página

Sintaxis: Cómo Controlar nombres de campo en un archivo máster

SET ASNAMES = [ON|OFF|MIXED|FOCUS]

donde:

OFF: No utiliza el literal especificado en una frase AS como nombre de campo en archivos HOLD y no afecta la manera en que se pone nombre a los campos ACROSS.
ON: Convierte el literal especificado en la frase AS a mayúsculas y lo propaga como nombre del campo en el archivo máster HOLD. Crea nombres para campos ACROSS que constan de un valor de nombre AS, concatenado al principio del valor del campo ACROSS, y controlan la nomenclatura de los campos ACROSS en archivos HOLD de cualquier formato.
MIXED: Emplea el literal especificado para el nombre de campo en una frase AS, reteniendo el uso de mayúsculas y minúsculas del nombre AS, y genera nombres para los campos ACROSS que constan del mismo valor de nombre AS, concatenado al principio del valor del campo ACROSS.
FOCUS: Utiliza el literal especificado en una frase AS como el nombre de campo y controla la manera en que se nombran los campos ACROSS solamente en archivos HOLD en formato FOCUS. FOCUS es el valor predeterminado.

Principio de página

Referencia: Notas sobre cómo controlar nombres de campo en archivos HOLD

Si no se especifica ninguna frase AS para un campo, se usa el nombre del campo del archivo máster original. El atributo TITLE especificado en el archivo máster no se utiliza a menos que se haya emitido previamente SET HOLDATTRS.
Para garantizar que los campos mencionados más de una vez en una solicitud tengan nombres distintivos en el archivo máster, utilice SET ASNAMES.
Los caracteres especiales y los espacios en blanco utilizados en la frase AS se conservan en el nombre de campo que se crea cuando se utiliza SET ASNAMES. Emplee comillas simples para los nombres de campo que no sean estándar, al referirse a ellos en el archivo máster creado recientemente.
El texto especificado en una frase AS que contenga más de 66 caracteres se trunca a 66 caracteres en el archivo máster.
Los alias no se pasan al archivo máster. Se proporciona automáticamente un nuevo juego de alias. Estos alias se llaman E01 para el primer campo, E02 para el segundo y así sucesivamente.
Los nombres de campo duplicados pueden aparecer en el archivo máster de reciente creación como resultado de un truncamiento o de la manera en que se encuentran especificado las frases AS. Es este caso, refiérase a los campos por dichos alias; es decir, E01, E02 y así sucesivamente.
Cuando se usan comas como delimitadores para interrumpir líneas en los encabezados de columna, sólo se usa el literal hasta la primera coma como nombre del campo en el archivo máster. Por ejemplo, lo siguiente genera el nombre del campo PLACE, en el archivo máster HOLD:
```
PRINT COUNTRY AS 'PLACE,OF,ORIGIN'
```
Cuando se utiliza ACROSS en una solicitud de informe y los resultados se extraen a un archivo HOLD, las columnas generadas por la frase ACROSS tienen todas el mismo nombre de campo en el archivo máster HOLD. Si se emite SET ASNAMES, cada nueva columna puede tener un nombre de campo distintivo. Este nombre de campo distintivo consta del valor ASNAME especificado en el comando de visualización de la solicitud, concatenado al principio del valor del campo utilizado en la frase ACROSS. Este procedimiento no funciona si varios nombres de campo tienen las mismas letras.
Si se utiliza una frase AS para los campos en la frase ACROSS, cada nueva columna tiene un nombre de campo compuesto por el literal que aparece en la frase AS concatenado al principio del valor del primer campo utilizado en la frase ACROSS.

Principio de página

Ejemplo: Cómo controlar nombres de campo en un archivo máster

En el siguiente ejemplo, SET ASNAMES=ON hace que se use el texto en la frase AS como nombres de campo en el archivo máster HOLD1. Los dos campos en el archivo máster HOLD1, NATION y AUTOMOBILE, contienen los datos para COUNTRY y CAR.

SET ASNAMES=ON
TABLE FILE CAR
PRINT CAR AS 'AUTOMOBILE'
BY COUNTRY AS 'NATION'
ON TABLE HOLD AS HOLD1
END

Esta solicitud genera el siguiente archivo máster:

FILE=HOLD1, SUFFIX=FIX
 SEGMENT=HOLD1, SEGTYPE=S01,$
  FIELDNAME=NATION      ,ALIAS=E01   ,USAGE=A10  ,ACTUAL=A12     ,$
  FIELDNAME=AUTOMOBILE  ,ALIAS=E02   ,USAGE=A16  ,ACTUAL=A16     ,$

Principio de página

Ejemplo: Cómo dar nombres distintivos con SET ASNAMES

La siguiente solicitud genera un archivo máster HOLD con un nombre de campo distintivo para SALES y uno para AVE.SALES. Tanto SALES como AVE.SALES se llamarán SALES si no se hubiera utilizado SET ASNAMES.

SET ASNAMES=ON
TABLE FILE CAR
SUM SALES AND AVE.SALES AS 'AVERAGESALES'
BY CAR
ON TABLE HOLD AS HOLD2
END

Esta solicitud genera el siguiente archivo máster:

FILE=HOLD2, SUFFIX=FIX
 SEGMENT=HOLD2, SEGTYPE=S01,$
  FIELDNAME=CAR             ,ALIAS=E01  ,USAGE=A16 ,ACTUAL=A16   ,$
  FIELDNAME=SALES           ,ALIAS=E02  ,USAGE=I6  ,ACTUAL=I04   ,$
  FIELDNAME=AVERAGESALES    ,ALIAS=E03  ,USAGE=I6  ,ACTUAL=I04   ,$

Principio de página

Ejemplo: Cómo utilizar SET ASNAMES con una frase ACROSS

La siguiente solicitud genera un archivo máster HOLD con el literal CASH concatenado a cada valor de COUNTRY.

SET ASNAMES=ON
TABLE FILE CAR
SUM SALES AS 'CASH'
ACROSS COUNTRY
ON TABLE HOLD AS HOLD3
END

Esta solicitud genera el siguiente archivo máster:

FILE=HOLD3, SUFFIX=FIX
 SEGMENT=HOLD3, SEGTYPE=S01,$
  FIELDNAME=CASHENGLAND     ,ALIAS=E01   ,USAGE=I6  ,ACTUAL=I04  ,$
  FIELDNAME=CASHFRANCE      ,ALIAS=E02   ,USAGE=I6  ,ACTUAL=I04  ,$
  FIELDNAME=CASHITALY       ,ALIAS=E03   ,USAGE=I6  ,ACTUAL=I04  ,$
  FIELDNAME=CASHJAPAN       ,ALIAS=E04   ,USAGE=I6  ,ACTUAL=I04  ,$
  FIELDNAME=CASHW GERMANY   ,ALIAS=E05   ,USAGE=I6  ,ACTUAL=I04  ,$

Sin el comando SET ASNAMES, cada campo en el HOLD FILE se llama COUNTRY.

Para generar nombres de campos para valores ACROSS que incluyan solamente el valor de campo, utilice la frase AS seguida de dos comillas simples, como se muestra a continuación:

SET ASNAMES=ON
TABLE FILE CAR
SUM SALES AS ''
ACROSS COUNTRY
ON TABLE HOLD AS HOLD4
END

El archivo máster resultante tiene el siguiente aspecto:

FILE=HOLD4, SUFFIX=FIX
 SEGMENT=HOLD4, SEGTYPE=S0,$
  FIELDNAME=ENGLAND    ,ALIAS=E01   ,USAGE=I6  ,ACTUAL=I04    ,$
  FIELDNAME=FRANCE     ,ALIAS=E02   ,USAGE=I6  ,ACTUALI04     ,$
  FIELDNAME=ITALY      ,ALIAS=E03   ,USAGE=I6  ,ACTUALI04     ,$
  FIELDNAME=JAPAN      ,ALIAS=E04   ,USAGE=I6  ,ACTUALI04     ,$
  FIELDNAME=W GERMANY  ,ALIAS=E05   ,USAGE=I6  ,ACTUALI04     ,$

Cómo controlar campos en un archivo máster HOLD

Cómo:

Controlar campos en un archivo HOLD

Puede utilizar el comando SET HOLDLIST para restringir los campos en los archivos máster HOLD sólo a aquellos que aparecen en una solicitud.

Principio de página

Sintaxis: Cómo Controlar campos en un archivo HOLD

SET HOLDLIST = {PRINTONLY|ALL|ALLKEYS|EXPLICIT}

donde:

PRINTONLY: Especifica que sólo aquellos campos que aparecerían en el informe se incluyan en el archivo HOLD generado. Los campos no mostrados en una solicitud (designados como campos NOPRINT, explícita o implícitamente) no están incluidos en el archivo HOLD.
prefijo ALL: Especifica que todos los campos de visualización mencionados en una solicitud aparezcan en un archivo HOLD, incluyendo los valores calculados. ALL es el valor predeterminado. Se puede utilizar OLD como sinónimo de ALL.
Nota: Los campos de clasificación vertical (BY), especificados en la solicitud con la opción NOPRINT, no están incluidos en el archivo HOLD, aun cuando HOLDLIST=ALL.
ALLKEYS: Propaga todos los campos, incluidos los campos NOPRINTed BY.
La propiedad ALLKEYS permite guardar todos los datos necesarios para manipular un informe activo, en la caché.
EXPLICIT: Incluye los campos de los archivos HOLD y PCHOLD omitidos explícitamente en la salida del informe, por medio de la opción NOPRINT en la solicitud, pero no aquellos designados con un NOPRINT explícito. Por ejemplo, si se modifica el formato de un campo en la solicitud, habrá dos versiones del campo, la versión con el formato nuevo y la del formato original, designado con un NOPRINT implícito.

Tenga en cuenta que también se puede emitir SET HOLDLIST desde dentro de una solicitud TABLE. Cuando se utiliza con MATCH, SET HOLDLIST siempre se comporta como si HOLDLIST estuviera ajustado para ALL.

Principio de página

Ejemplo: Cómo utilizar HOLDLIST=ALL

Cuando HOLDLIST ha sido ajustado a ALL, la siguiente solicitud TABLE genera un archivo HOLD que contiene todos los campos especificados, incluyendo campos NOPRINT y valores calculados con el comando COMPUTE.

SET HOLDLIST=ALL
 
TABLE FILE CAR
PRINT CAR MODEL NOPRINT
COMPUTE TEMPSEATS=SEATS+1;
BY COUNTRY
ON TABLE HOLD
END
 
? HOLD

La salida es:

NUMBER OF RECORDS IN TABLE= 18	LINE=	18

DEFINITION OF HOLD FILE: HOLD
FIELDNAME	ALIAS	FORMAT

COUNTRY	E01	A10
CAR	E02	A16
MODEL	E03	A24
SEATS	E04	I3
TEMPSEATS	E05	D12.2

Principio de página

Ejemplo: Cómo utilizar HOLDLIST= PRINTONLY

Cuando HOLDLIST ha sido ajustado a PRINTONLY, la siguiente solicitud TABLE genera un archivo HOLD que contiene solamente campos que aparecerían en salida de informe:

SET HOLDLIST=PRINTONLY
 
TABLE FILE CAR
PRINT CAR MODEL NOPRINT
COMPUTE TEMPSEATS=SEATS+1;
BY COUNTRY
ON TABLE HOLD
END
 
? HOLD

La salida es:

NUMBER OF RECORDS IN TABLE= 18	LINES=	18

DEFINITION OF HOLD FILE: HOLD
FIELDNAME	ALIAS	FORMAT

COUNTRY	E01	A10
CAR	E02	A16
TEMPSEATS	E03	D12.2

Principio de página

Ejemplo: Cómo comparar archivos máster creados mediante distintas propiedades HOLDLIST

La siguiente solicitud, basada en el origen de datos GGSALES, tiene dos campos de visualización (DOLLARS, UNITS) cuyo formato ha sido modificado. Además, el campo DOLLARS también es un campo NOPRINT. El campo BY llamado CATEGORY también se trata de un campo NOPRINT explícito:

SET HOLDLIST=ALL
TABLE FILE GGSALES
SUM UNITS/I5 DOLLARS/D12.2 NOPRINT
BY REGION BY CATEGORY NOPRINT
ON TABLE HOLD FORMAT FOCUS
END

Si ejecuta la solicitud con SET HOLDLIST=ALL, se genera el siguiente archivo máster HOLD. Tenga en cuenta que los campos DOLLARS y UNITS se han incluido dos veces, una con el formato original (designado implícitamente como NOPRINT, si el informe se hubiese imprimido en lugar de retenido) y otra con el formato nuevo. Sin embargo, el campo BY designado como NOPRINT (CATEGORY) no está incluido:

FILENAME=HOLD, SUFFIX=FOC     , $
  SEGMENT=SEG01, SEGTYPE=S1, $
    FIELDNAME=REGION, ALIAS=E01, USAGE=A11,
      TITLE='Region', DESCRIPTION='Region code', $
    FIELDNAME=UNITS, ALIAS=E02, USAGE=I08,
      TITLE='Unit Sales', DESCRIPTION='Number of units sold', $
    FIELDNAME=UNITS, ALIAS=E03, USAGE=I5,
      TITLE='Unit Sales', $
    FIELDNAME=DOLLARS, ALIAS=E04, USAGE=I08,
      TITLE='Dollar Sales', DESCRIPTION='Total dollar amount of reported sales', $
    FIELDNAME=DOLLARS, ALIAS=E05, USAGE=D12.2,
      TITLE='Dollar Sales', $

Si ejecuta la solicitud con SET HOLDLIST=ALLKEYS, se genera el siguiente archivo máster HOLD. Tenga en cuenta que los campos DOLLARS y UNITS se han incluido dos veces, una con el formato original, designado implícitamente como NOPRINT, si el informe se hubiese imprimido en lugar de retenido, y otra con el formato nuevo. Sin embargo, el campo BY designado como NOPRINT (CATEGORY) está incluido:

FILENAME=HOLD, SUFFIX=FOC     , $
  SEGMENT=SEG01, SEGTYPE=S2, $
    FIELDNAME=REGION, ALIAS=E01, USAGE=A11,
      TITLE='Region', DESCRIPTION='Region code', $
    FIELDNAME=CATEGORY, ALIAS=E02, USAGE=A11,
      TITLE='Category', DESCRIPTION='Product category', $
    FIELDNAME=UNITS, ALIAS=E03, USAGE=I08,
      TITLE='Unit Sales', DESCRIPTION='Number of units sold', $
    FIELDNAME=UNITS, ALIAS=E04, USAGE=I5,
      TITLE='Unit Sales', $
    FIELDNAME=DOLLARS, ALIAS=E05, USAGE=I08,
      TITLE='Dollar Sales', DESCRIPTION='Total dollar amount of reported sales', $
    FIELDNAME=DOLLARS, ALIAS=E06, USAGE=D12.2,
      TITLE='Dollar Sales', $

Si ejecuta la solicitud con SET HOLDLIST=PRINTONLY, se genera el siguiente archivo máster HOLD. Los únicos campos que hubieran aparecido realmente en la salida del informe están incluidos: REGIONS y UNITS, con el formato nuevo (I5). Se excluyen todos los campos NOPRINT explícitos e implícitos, incluido el campo BY (CATEGORY):

FILENAME=HOLD , SUFFIX=FOC     , $
  SEGMENT=SEG01, SEGTYPE=S1, $
    FIELDNAME=REGION, ALIAS=E01, USAGE=A11,
      TITLE='Region', DESCRIPTION='Region code', $
    FIELDNAME=UNITS, ALIAS=E02, USAGE=I5,
      TITLE='Unit Sales', $

Si ejecuta la solicitud con SET HOLDLIST=EXPLICIT, se genera el siguiente archivo máster HOLD. Los campos que hubieran aparecido realmente en la salida del informe están incluidos y, por tanto, son campos NOPRINT explícitos (el campo de visualización DOLLARS y el campo BY CATEGORY). Los campos NOPRINT implícitos (DOLLARS y UNITS en su formato original) quedan omitidos:

FILENAME=HOLD, SUFFIX=FOC     , $
  SEGMENT=SEG01, SEGTYPE=S2, $
    FIELDNAME=REGION, ALIAS=E01, USAGE=A11,
      TITLE='Region', DESCRIPTION='Region code', $
    FIELDNAME=CATEGORY, ALIAS=E02, USAGE=A11,
      TITLE='Category', DESCRIPTION='Product category', $
    FIELDNAME=UNITS, ALIAS=E03, USAGE=I5,
      TITLE='Unit Sales', $
    FIELDNAME=DOLLARS, ALIAS=E04, USAGE=D12.2,
      TITLE='Dollar Sales', $

Cómo controlar los atributos TITLE y ACCEPT en el archivo máster HOLD

Cómo:

Controlar los atributos TITLE y ACCEPT

El comando SET HOLDATTR controla si los atributos TITLE y ACCEPT en el archivo máster original se propagan al archivo máster HOLD. SET HOLDATTR no afecta la manera en que se nombran los campos en el archivo máster HOLD.

Tenga en cuenta que si un campo en un origen de datos carece del atributo TITLE especificado en el archivo máster, pero existe una frase AS especificada para el campo en una solicitud de informe, el campo correspondiente en el archivo HOLD se nombra de acuerdo con la frase AS.

Principio de página

Sintaxis: Cómo Controlar los atributos TITLE y ACCEPT

SET HOLDATTR =[ON|OFF|FOCUS]

donde:

ON: Utiliza el atributo TITLE tal como se especifica en el archivo máster original en archivos HOLD en cualquier formato. El atributo ACCEPT se propaga al archivo máster HOLD sólo cuando se trata de archivos HOLD en formato FOCUS.
OFF: No usa los atributos TITLE o ACCEPT desde el archivo máster original en el archivo máster HOLD.
FOCUS: Usa los atributos TITLE y ACCEPT sólo para los archivos HOLD en formato FOCUS. FOCUS es el valor predeterminado.

Principio de página

Ejemplo: Cómo controlar los atributos TITLE y ACCEPT en un archivo máster HOLD

En este ejemplo, el archivo máster para el origen de datos CAR especifica los atributos TITLE y ACCEPT:

FILENAME=CAR2, SUFFIX=FOC
SEGNAME=ORIGIN, SEGTYPE=S1
  FIELDNAME =COUNTRY, COUNTRY, A10, TITLE='COUNTRY OF ORIGIN',
             ACCEPT='CANADA' OR 'ENGLAND' OR 'FRANCE' OR 'ITALY' OR
                    'JAPAN' OR 'W GERMANY',
             FIELDTYPE=I,$
SEGNAME=COMP, SEGTYPE=S1, PARENT=ORIGIN
  FIELDNAME=CAR, CARS, A16, TITLE='NAME OF CAR',$
.
.
.

Con SET HOLDATTR=FOCUS, la solicitud siguiente

SET HOLDATTR = FOCUS
TABLE FILE CAR2
PRINT CAR
BY COUNTRY ON TABLE HOLD FORMAT FOCUS AS HOLD5
END

genera este archivo máster HOLD:

FILE=HOLD5, SUFFIX=FOC
 SEGMENT=SEG01, SEGTYPE=S02
  FIELDNAME=COUNTRY ,USAGE=E01   ,ACTUAL=A10
      TITLE='COUNTRY OF ORIGIN',
      ACCEPT=CANADA ENGLAND FRANCE ITALY JAPAN 'W GERMANY',$
  FIELDNAME=FOCLIST ,USAGE=E02   ,ACTUAL=I5     ,$
  FIELDNAME=CAR     ,USAGE=E03   ,ACTUAL=A16    ,
      TITLE='NAME OF CAR' ,$