BY {HIGHEST|LOWEST} [n] sortfield [AS 'text']

donde:

HIGHEST

Clasifica en orden descendente.

LOWEST

Clasifica en orden ascendente. El valor por defecto es LOWEST.

n

Especifica que sólo se incluyen n valores de campo de clasificación en el informe.

sortfield

Es el nombre del campo de clasificación.

text

Es el encabezado de la columna utilizada para el campo de clasificación, en la salida del informe.

• Cuando use el comando de visualización LIST con una frase BY, el contador de LIST se reajustará a uno cada vez que cambien los valores de clasificación principales.
• La secuencia de clasificación predeterminada es de menor a mayor, con las siguientes variaciones para diferentes sistemas operativos. En z/OS, la secuencia es a-z, A-Z, 0-9, en campos alfanuméricos, y 0-9, en campos numéricos. En UNIX y Windows la secuencia es 0-9, A-Z, a-z, en campos alfanuméricos y 0-9, en campos numéricos. Puede especificar otras secuencias de clasificación, tal como se describe en Cómo especificar el orden de clasificación.
• No puede utilizar los campos de texto como campos de clasificación. Los campos de texto se describen en el archivo máster con una valor FORMAT de TX.
• Puede utilizar un campo temporal creado con un comando DEFINE o con el atributo DEFINE, en un archivo máster, como campo de clasificación. Sin embargo, no puede utilizar un campo temporal creado con un comando COMPUTE como campo temporal. Puede lograr esto de forma indirecta creando un archivo HOLD que incluya el campo, y luego creando un informe desde el archivo HOLD ( los archivos HOLD se describen en Cómo guardar y reutilizar su salida de informes.
• Si especifica varios campos de clasificación al informar desde un origen de datos de rutas múltiples, todos los campos de clasificación deben estar en la misma ruta.
• Las frases de clasificación no deben contener información para campos.
• Cada valor de campo de clasificación aparece solamente una vez en el informe. Por ejemplo, si hay seis empleados en el departamento MIS, una solicitud que declare

  PRINT LAST_NAME BY DEPARTMENT

  imprime MIS una vez, seguido de seis nombres de empleados. Puede suministrar con datos cada celda de columna de clasificación vertical con un valor, aún en el caso de que se repita el valor, mediante el parámetro SET BYDISPLAY. Para obtener información detallada, consulte Cómo mostrar todos los valores verticales (BY) de campos de clasificación.

A continuación se explica cómo mostrar todas las identificaciones de los empleados, por departamento.

TABLE FILE EMPLOYEE
PRINT EMP_ID
BY DEPARTMENT
END

La salida muestra una fila para cada EMP_ID en cada departamento.

Dentro de un grupo de clasificación vertical, el valor de campo de clasificación se muestra sólo en la primera línea de las filas de su grupo de clasificación y en la primera línea de una página. Ahora bien, con el comando SET BYDISPLAY, puede mostrar el campo BY adecuado en cada fila de informe generada en un formato de salida con estilo.

Aunque todos los formatos de salida con estilo admiten SET BYDISPLAY, éste tiene especial importancia porque hace que Excel pueda usar con mayor facilidad las salidas de informe, que no pueden clasificar las columnas con facilidad cuando hay varias filas con valores en blanco.

Esta característica le libra de especificar dos veces el mismo campo de clasificación, una como un campo de visualización y otra para clasificar (con la opción NOPRINT). Por ejemplo:

PRINT FIRST_NAME LAST_NAME
BY FIRST_NAME NOPRINT

SET BYDISPLAY = {OFF|ON}

ON TABLE SET BYDISPLAY {OFF|ON}

SET BYDISPLAY = ON
TABLE FILE CENTHR
PRINT LNAME
BY FNAME
WHERE FNAME EQ 'CAROLYN' OR 'DAVID'							  ON
TABLE PCHOLD FORMAT EXL2KEND

Puede organizar información en un informe con más de un campo de clasificación. Cuando especifica varios campos de clasificación, la secuencia de las frases BY determina el orden de clasificación. La primera frase BY establece el salto de clasificación principal; la segunda frase BY establece el segundo salto de clasificación y así sucesivamente. Cada clasificación sucesiva se inserta en la anterior.

La solicitud que aparece a continuación usa múltiples campos de clasificación vertical (BY).

TABLE FILE EMPLOYEE
PRINT CURR_SAL
BY DEPARTMENT BY LAST_NAME
WHERE CURR_SAL GT 21500
END

La salida es:

DEPARTMENT  LAST_NAME               CURR_SAL
----------  ---------               --------
MIS         BLACKWOOD             $21,780.00
            CROSS                 $27,062.00
PRODUCTION  BANNING               $29,700.00
            IRVING                $26,862.00

Se puede restringir el número de valores de clasificación mostrados en una frase de clasificación. La frase PLUS OTHERS le permite agregar todos los otros valores a un grupo distinto y mostrar este grupo como una fila adicional del informe.

[RANKED] BY {HIGHEST|LOWEST|TOP|BOTTOM}  n							srtfield [AS 'text'] 
            [PLUS OTHERS AS 'othertext'] 
            [IN-GROUPS-OF m1 [TOP n2]] 
            [IN-RANGES-OF m3 [TOP n4]

TABLE FILE EMPLOYEE
PRINT CURR_SAL LAST_NAME
  BY HIGHEST 2 ED_HRS
  PLUS OTHERS AS 'Others'
END

ED_HRS         CURR_SAL  LAST_NAME
------         --------  ---------
 75.00       $21,780.00  BLACKWOOD
 50.00       $18,480.00  JONES
             $16,100.00  MCKNIGHT
Others      $165,924.00

TABLE FILE EMPLOYEE
PRINT CURR_SAL LAST_NAME
  BY HIGHEST 2 ED_HRS
  PLUS OTHERS AS 'Others'
IN-GROUPS-OF 25 TOP 50
END

ED_HRS         CURR_SAL  LAST_NAME
------         --------  ---------
 50.00       $18,480.00  JONES
             $21,780.00  BLACKWOOD
             $16,100.00  MCKNIGHT
 25.00       $11,000.00  STEVENS
             $13,200.00  SMITH
             $26,862.00  IRVING
              $9,000.00  GREENSPAN
             $27,062.00  CROSS
Others       $78,800.00

TABLE FILE EMPLOYEE
PRINT CURR_SAL LAST_NAME
  BY LOWEST 2 ED_HRS
  PLUS OTHERS AS 'Others'
IN-GROUPS-OF 25 TOP 50
END

ED_HRS         CURR_SAL  LAST_NAME
------         --------  ---------
   .00        $9,500.00  SMITH
             $29,700.00  BANNING
             $21,120.00  ROMANS
             $18,480.00  MCCOY
 25.00       $11,000.00  STEVENS
             $13,200.00  SMITH
             $26,862.00  IRVING
              $9,000.00  GREENSPAN
             $27,062.00  CROSS
Others       $56,360.00