Teilnehmer sortiert drucken

Dieses Dokument behandelt die folgenden Themen:

• Beschreibung

• Vorgehensweise

• Batch-Beispiel

Beschreibung

Programm

B07331

Funktion

Eine Liste der Teilnehmer drucken, sortiert nach Inhalt in der angegebenen Reihenfolge. Die gedruckte Liste enthält Teilnehmerkennzeichen, Telefon, Durchwahl, Abteilung und den vollen Namen. Sie enthält nicht die von Ihnen ausgewählten Sortierkriterien.

Online-Eingabebildschirm

  16:57                * * *  C O N - N E C T  3  * * *                18.Mae.94
  Buero LS                 Teilnehmer sortiert drucken                    B07331
                                                                                
  Von Teilnehmer ________ bis Teilnehmer ________ ('*' fuer alle Teilnehmer)    
                                                                                
  Sortierkriterien eingeben                                                     
  Inhalt             Laen Pos Von  Bis    Inhalt             Laen Pos Von  Bis  
  ------------------ ---- --- ---- ----   ------------------ ---- --- ---- ---- 
  Kennzeichen        8        1    8      Abteilungsnummer   10       1    10   
  Firma              32       1    32     Telefon            15       1    15   
  Titel              32       1    32     Landesvorwahl      2        1    2    
  Ort                32       1    32     Durchwahl          10       1    10   
  Adresse (Zeile 1)  60       1    60     Postleitzahl       10       1    10   
  Adresse (Zeile 2)  60       1    60     Nachname           32       1    32   
  Adresse (Zeile 3)  60       1    60     Vorname            32       1    32   
  Stadt              32       1    32     2. Vorname         1        1    1    
  Land               8        1    8      Transparente Daten 8        1    8    
  Abteilung          32       1    32                                           
  Exit fuer Teilnehmerpruefung eingeben  ________ mit Parameter ________        
  Exit fuer Ergebnisbearbeitung eingeben ________                               
                                                                                
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Menue Beend                                                        
 Ergaenzen Sie die Angaben und druecken Sie EINGABE                            

Dienstprogramm-Parameter

Vorgehensweise

Sortierkriterien

Die gewünschten Teilnehmer können nach neunzehn Sortierkriterien sortiert werden; mindestens ein Sortierkriterium muss eingegeben werden. Die ersten achtzehn Sortierkriterien enthalten die Con-nect-spezifischen Teilnehmer-Informationen (z.B. Nachname, Firma, Ort und Teilnehmerkennzeichen). Im Feld "Transparente Daten" können Sie eigene Werte angeben.

Folgende Regeln müssen beim Definieren der Sortierkriterien beachtet werden:

• Das Feld "Pos" (Position) muss eine Zahl zwischen 1 und 19 enthalten.

• Ein Sortierkriterium darf nur einmal angegeben werden.

• Der Wert im Feld "Von" darf nicht kleiner als 1 sein (1 bezeichnet das erste Byte der Information).

• Der Wert im Feld "Bis" darf nicht größer sein als die Feldlänge (wie im Feld "Laen" definiert).

• Der Wert im Feld "Von" darf nicht größer sein als der Wert im Feld "Bis".

Sortieren

Dieses Dienstprogramm beginnt den Sortiervorgang mit den angegebenen Sortierkriterien. Es endet, nachdem alle Teilnehmer eindeutig sortiert wurden, oder wenn alle Sortierkriterien berücksichtigt wurden.

Beispiel: Sie möchten eine Teilnehmerliste drucken, die nach den folgenden Kriterien und in der folgenden Reihenfolge sortiert ist:

1. Abteilung

2. Titel

3. Nachname

4. Land

Hierzu müssten Sie Folgendes angeben:

Das Dienstprogramm sortiert die Teilnehmer zuerst nach dem Abteilungsnamen. Wenn nicht alle Teilnehmer eindeutig sortiert werden können, werden die verbleibenden Teilnehmer nach dem Feld "Titel" sortiert. Danach fährt das Dienstprogramm mit dem Sortieren fort: entweder bis alle Teilnehmer eindeutig sortiert wurden, oder bis alle Sortierkriterien berücksichtigt wurden.

Angenommen, die letzten sechs Bytes des Abteilungsnamens enthalten die Buchstaben "center". Sie können diese sechs Bytes aus den Suchkriterien entfernen, um den Sortiervorgang zu beschleunigen. Dazu müssen Sie Folgendes angeben:

Durch das Entfernen der letzten sechs Bytes wird die Gesamtzahl der für jeden Teilnehmer zu sortierenden Bytes von 104 auf 98 verringert. Dadurch wird der Sortiervorgang schneller durchgeführt.

User-Exits

Zusätzlich zu den Sortierkriterien können Sie eigene User-Exits schreiben, um die Teilnehmerdaten vor dem Sortiervorgang zu überprüfen, oder um die sortierten Daten für andere Zwecke zu benutzen.

Die User-Exits werden zu unterschiedlichen Phasen dieses Dienstprogramms aufgerufen:

Phase I

Das Dienstprogramm beginnt mit dem Lesen der angegebenen Teilnehmersätze. Wenn im Feld "Exit fuer Teilnehmerpruefung eingeben" ein User-Exit angegeben wurde, wird der User-Exit nach dem Lesen jedes einzelnen Teilnehmersatzes aufgerufen.

Phase II

Das Dienstprogramm beginnt mit dem Sortieren der Teilnehmersätze. Es wird kein User-Exit aufgerufen.

Phase III

Das Dienstprogramm beginnt mit dem Drucken der sortierten Teilnehmersätze. Wenn im Feld "Exit fuer Ergebnisbearbeitung eingeben" ein User-Exit angegeben wurde, wird der User-Exit nach dem Drucken jedes einzelnen Teilnehmersatzes aufgerufen.

Die Benutzung der User-Exits wird auf den folgenden Seiten beschrieben.

Teilnehmerprüfung

Mit dieser Art von User-Exit können Sie:

• die Liste der ausgegebenen Teilnehmer einschränken, indem Sie zusätzliche Kriterien eingeben, die erfüllt werden müssen. Zum Beispiel, Sie wollen nur eine Liste der Teilnehmer drucken, die in der Abteilung "Finanzen" arbeiten und deren Titel "Buchhalter" ist. Alle Teilnehmer, die diese Bedingungen nicht erfüllen, werden nicht berücksichtigt, wenn Sie das entsprechende Statement im User-Exit benutzen und den Parameter "Akzeptieren" auf False setzen.

• verschiedene Listen mit demselben User-Exit erstellen. Beispiel: In Ihrer Firma gibt es 100 verschiedene Abteilungen. Sie wollen für jede Abteilung eine Telefonliste erstellen, wobei immer dieselben Sortierkriterien gelten sollen. Sie können einen User-Exit schreiben, der das Feld "Parameter" überprüft und anhand dieses Werts die Teilnehmersätze für eine bestimmte Abteilung holt. Somit können Sie verschiedene Listen mit nur einem User-Exit erstellen.

• die Integrität der akzeptierten Informationen überprüfen. Beispiel: Sie haben die Telefondurchwahl als Hauptsortierkriterium angegeben, jedoch ist das Format der Telefonnummern in der Datenbank linksbündig. Wenn diese Informationen linksbündig bleiben, können die Telefonnummern nicht, wie beabsichtigt, in aufsteigender Reihenfolge sortiert werden. Mit diesem User-Exit können Sie jedoch das Format der Telefonnummern in rechtsbündig ändern; nun können Sie sicher sein, dass die Teilnehmersätze in aufsteigender Telefonnummern-Reihenfolge sortiert werden.

  Anmerkung:
  Die Datenbank wird nicht modifiziert. Geändert werden nur die Informationen, die während der Ausführung dieses User-Exits benötigt werden.

  Standardmäßig werden diese Formatänderungen nicht berücksichtigt, wenn die sortierten Teilnehmersätze gedruckt werden. Wenn Sie den Parameter "Aenderungen-ausgeben" jedoch auf True setzen, werden die Änderungen mit ausgedruckt und an den zweiten User-Exit für weitere Zwecke übergeben.

• dem Sortierkriterium "Transparente Daten" einen Wert zuordnen (z.B. die interne Personalnummer), damit dieser während des Sortiervorgangs benutzt werden kann.

Der Name für diesen User-Exit muss mit USR004 beginnen.

Wenn im Feld "Exit fuer Teilnehmerpruefung eingeben" ein User-Exit angegeben wurde, wird der User-Exit nach dem Lesen jedes einzelnen Teilnehmersatzes mit den folgenden Parametern aufgerufen:

Ergebnisbearbeitung

Mit dem zweiten User-Exit können Sie die sortierten Daten für andere Zwecke benutzen: z.B. zum Erstellen von Dokumenten oder zum Ablegen der Liste.

Der Name für diesen User-Exit muss mit USR005 beginnen.

Wenn im Feld "Exit fuer Ergebnisbearbeitung eingeben" ein User-Exit angegeben wurde, wird der User-Exit nach dem Drucken jedes einzelnen Teilnehmersatzes mit den folgenden Parametern aufgerufen:

Drucken

Nachdem der Sortiervorgang abgeschlossen ist, druckt dieses Dienstprogramm die sortierten Informationen auf dem Drucker aus, der in Ihrem Teilnehmerprofil angegeben wurde. Die gedruckte Liste enthält Teilnehmerkennzeichen, Telefon, Durchwahl, Abteilung und den vollen Namen.

Technische Information

Wenn die Länge der Sortierkriterien unter 35 Bytes liegt, wird gleich mit dem sortierten Ausdruck begonnen.

Dieses Dienstprogramm benötigt keine JCL-Sortier-Statements und benutzt auch nicht den Natural-SORT; die Sortierung basiert auf Adabas (daher gibt es keine Beschränkungen bezüglich der Anzahl der Teilnehmersätze, die zur gleichen Zeit sortiert werden können). Dieses Dienstprogramm überprüft die Sortiersätze und löscht alle Sätze, die bereits gedruckt wurden.

Jedes Mal, wenn dieses Dienstprogramm aufgerufen wird, sucht es sortierte Sätze, die älter als ein Tag sind, und löscht sie. Dadurch wird gewährleistet, dass die sortierten Sätze, die wegen einer Systemunterbrechung immer noch vorhanden sind, immer gelöscht werden.

Batch-Beispiel

Wenn dieses Dienstprogramm im Batch-Betrieb läuft, ersetzen Sie die Tabelle mit den Sortierkriterien durch eine alphanumerische Eingabezeichenkette. Mit dieser Zeichenkette können Sie bis zu zehn Sortierkriterien angeben.

Pro Sortierkriterium müssen Sie einen sechsstelligen Werte angeben, der aus folgenden Teilen besteht:

• Eine zweistellige Zahl, die den Inhalt bestimmt, der als Sortierkriterium benutzt werden soll. Wenn z.B. das Teilnehmerkennzeichen als Sortierkriterium gelten soll, müssen Sie 01 angeben; Firma wäre 02 und Telefon 12. (Der Wert entspricht der Reihenfolge, in der der Inhalt im Online-Bildschirm für dieses Dienstprogramm aufgelistet ist.)

• Eine zweistellige Zahl als Anfangswert (von Wert) für das Sortierkriterium.

• Eine zweistellige Zahl als Endwert (bis Wert) für das Sortierkriterium.

Die Reihenfolge, in der Sie das Kriterium in der Eingabezeichenkette angeben, bestimmt die Position und damit die Sortierreihenfolge. Falsche Angaben (wenn z.B. "von Wert" größer ist als "bis Wert") werden ignoriert.

Das folgende Beispiel druckt alle Teilnehmer sortiert nach Land (in voller Länge), Stadt (von Byte 1 bis 12), Nachname (in voller Länge) und Vorname (in voller Länge). Außerdem wird der User-Exit USR00501 zum Drucken der sortierten Daten aufgerufen.

LOGON SYSCNT2B
MENU
B07331 *,,090108080112160132170132,,,USR00501
FIN