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

où :

HIGHEST

Trie dans l'ordre décroissant.

LOWEST

Trie dans l'ordre croissant. LOWEST est la valeur par défaut.

n

spécifie que seules les valeurs de champ de trin sont comprises dans le rapport.

sortfield

Est le nom du critère de tri.

text

Est l'en-tête de colonne à utiliser pour la colonne du critère de tri dans la sortie de rapport.

• En utilisant la commande d'affichage LIST avec une phrase BY, le compteur LIST est remis à 1 chaque fois que la valeur de tri principale change.
• La séquence de tri par défautest croissant, avec les variations suivantes pour les différents systèmes d'exécution. Sur z/OS et VM, la séquence est a-z, A-Z, 0-9 pour les champs alphanumériques ; 0-9 pour les champs numériques. Sur UNIX et Windows, la séquence est 0-9, A-Z, a-z pour les champs alphanumérique ; 0-9 pour les champs numériques. Vous pouvez spécifier d'autres séries de tri, comme décrit dans Spécifier l'ordre de tri.
• Les champs de texte ne peuvent pas servir de critères de tri. Les champs de texte sont ceux décrits dans le fichier Master dont la valeur FORMAT est TX.
• Vous pouvez utiliser un champ temporaire créé par une commande DEFINE, ou par l'attribut DEFINE dans un fichier maître, comme critère de tri. Cependant, il n'est pas possible d'utiliser un champ temporaire créé par une commande COMPUTE comme champ de tri. Vous pouvez le faire indirectement en créant premièrement un fichier HOLD contenant le champ, puis en faisant un rapport à partir du fichier HOLD (les fichiers HOLD sont décrits à la rubrique Enregistrer et réutiliser la sortie de rapport).
• Lorsque vous créez un rapport avec une source de données à chemins multiples et que vous spécifiez plusieurs critères de tri, tous les critères de tri doivent être sur le même chemin.
• Les phrases de tri ne peuvent pas contenir d'informations de format pour les champs.
• Chaque valeur de critère de tri ne s'affiche qu'une fois dans le rapport. Par exemple, s'il y a six employés dans le service MIS, une requête indiquant

  PRINT LAST_NAME BY DEPARTMENT

  n'imprime MIS qu'une fois, suivi des noms de six employés. Vous pouvez remplir chaque cellule de colonne de tri vertical d'une valeur, même si la valeur se répète, en utilisant le paramètre SET BYDISPLAY. Pour plus de détails, consultez Affichage de toutes les valeurs des critères de tri vertical (BY).

Ce qui suit illustre la façon d'afficher tous les identificateurs d'employés par service.

TABLE FILE EMPLOYEE
PRINT EMP_ID
BY DEPARTMENT
END

La sortie affiche une ligne pour chaque champ EMP_ID dans chaque service.

Dans un groupe de tri vertical, la valeur de critère de tri ne s'affiche que sur la première ligne des lignes composant son groupe de tri, et sur la première ligne d'une page. Cependant, à l'aide de la commande SET BYDISPLAY, vous pouvez afficher le champ BY approprié sur chaque ligne d'un rapport créé dans un format de sortie avec style.

Bien que la commande SET BYDISPLAY soit pris en charge par tous les formats de sortie avec style, elle est particulièrement importante pour rendre la sortie de rapport plus utilisable par Excel, qui ne peut pas trier les colonnes correctement lorsqu'il y a des valeurs vides sur des lignes.

Cette fonctionnalité vous permet d'éviter de spécifier le critère de tri deux fois, une fois comme champ d'affichage et l'autre comme critère de tri (avec l'option NOPRINT). Par exemple :

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

Vous pouvez organiser les informations dans un rapport en utilisant plus d'un critère de tri. Lorsque vous spécifiez plusieurs critères de tri, la séquence des phrases BY détermine l'ordre de tri. La première phrase BY définit le saut de tri principal, la deuxième phrase BY définit le deuxième saut de tri, et ainsi de suite. Chaque tri successif est imbriqué dans celui qui le précède.

La requête suivante utilise des champs de tri verticaux (BY) multiples.

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

La sortie est :

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

Dans une expression de tri, vous pouvez limiter le nombre de valeurs de tri affichées. Avec l'expression PLUS OTHER, vous pouvez regrouper toutes les autres valeurs dans un groupe séparé et afficher ce groupe comme une ligne de rapport supplémentaire.

[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