Programme

Con-nect bietet eine Schnittstelle, mit der Sie ein existierendes Natural-Programm dazu benutzen können, ein Dokument in Con-nect zu erstellen. Das Natural-Programm selbst wird nicht in Con-nect eingegeben, es wird Con-nect lediglich über eine Programmdefinition bekannt gegeben.

Sie können zum Beispiel ein Natural-Programm schreiben, um alle Einträge in einer Kundendatei auszugeben, die Einträge mit einer anderen Liste, in denen die Empfänger der letzten Werbekampagne enthalten sind, zu vergleichen, und um dann festzustellen, welcher Kunde einen Werbebrief erhalten hat. Wenn Sie ein Dokument mit diesem Programm erstellen, erscheinen die Ergebnisse dieses Programms sofort im "Editor Dokumentname"-Schirm, und Sie können diese Ergebnisse zum Beispiel in Ihren monatlichen Bericht einfließen lassen.

Das Beispiel am Ende dieses Abschnitt zeigt, wie Sie ein Con-nect-Dokument mit einem Natural-Programm erstellen können.

Dieses Dokument behandelt die folgenden Themen:


Programm eingeben

Wenn Sie ein Programm in Con-nect eingeben, verknüpfen Sie ein existierendes Natural-Programm mit einem Programmnamen, der von Con-nect identifiziert werden kann. Hierdurch wird das Natural-Programm nicht nach Con-nect importiert.

Geben Sie die folgende Befehlsfolge in der Befehlszeile eines beliebigen Con-nect-Schirms ein:

Programm EINGEBEN

Daraufhin erscheint der "Programm eingeben"-Schirm.

  11:33                * * *  C O N - N E C T  3  * * *                 9.Feb.94
  Buero LS                     Programm Eingeben                        Mittwoch
                                                                                
             Fach Arbeitsfach____ Ordner _______________                        
                                                                                
         Programm ________________________________                              
                                                                                
     Beschreibung ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                                                                                
                                                                                
         Programm ________ Bibliothek SYSCNT2_                                  
                                                                                
      Persoenlich _ oder Berechtigung zum Lesen 7 Aendern 7 Kopieren 7          
                                                                                
                                                                                
                                                                                
                                                                                
 Angaben ergaenzen und zum Eingeben EINGABE druecken                           
     Befehl /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Hilfe Menue Beend Post  Memo  Fach  Dokum Notiz Kalen Funkt Letzt BefZe  

Geben Sie im "Programm eingeben"-Schirm - zusätzlich zu den Eingaben, die Sie in jedem "Objekt eingeben"-Schirm machen müssen (siehe Die "Eingeben"-Schirme) - die folgenden Definitionskriterien für Programme ein:

Programm

Dies betrifft die obere Zeile mit diesem Namen.

Ein eindeutiger Name mit einer Länge von maximal 32 Zeichen, der das Programm in Con-nect identifiziert. Dieser Name und der Name des Natural-Programms (siehe unten) können identisch sein.

Programm

Dies betrifft die untere Zeile mit diesem Namen.

Das Natural-Programm, das ausgeführt werden soll, wenn ein Dokument eingegeben wird. Hierzu wird der oben eingegebene Programmname herangezogen.

Das Programm muss vorher vom Con-nect-Administrator, von Ihnen selbst oder von einem anderen Teilnehmer erstellt werden.

Bibliothek

Der Name der Natural-Bibliothek, in der das Programm katalogisiert ist. Als Vorgabe wird die als STEPLIB definierte Bibliothek angezeigt. Sie können die aktuelle Bibliothek durch Überschreiben der Vorgabe definieren. Sie können nur die Bibliothek, die als STEPLIB definiert ist oder die aktuelle Bibliothek eingeben.

Drücken Sie EINGABE, um das Programm zu erstellen.

Dokument mit einem Programm erstellen

Sie können mit den Programmen, die Sie in Con-nect über eine Programmdefinition bekannt gegeben haben, Dokumente erstellen.

Als Erstes müssen Sie ein Programm eingeben (siehe Programm eingeben).

Um ein Dokument mit einem Programm zu erstellen, geben Sie die folgende Befehlsfolge in der Befehlszeile eines beliebigen Con-nect-Schirms ein:

Dokument name EINGEBEN

Daraufhin wird der "Dokument eingeben"-Schirm angezeigt

Geben Sie, zusätzlich zu den Definitionskriterien für das Dokument, den Namen des Programms ein, mit dem das Dokument erstellt werden soll.

Drücken Sie EINGABE.

Daraufhin erscheint das vom Programm erstellte Dokument im "Editor Dokumentname"-Schirm, in dem Sie es mit allen Textverarbeitungsfunktionen bearbeiten können (siehe Textverarbeitung).

Nachdem Sie die Bearbeitung des Dokuments beendet haben, geben Sie den Befehl BEENDEN ein, um das Dokument zu sichern.

Programme verwalten

Um alle bestehenden Programme anzuzeigen, geben Sie die folgende Befehlsfolge in der Befehlszeile eines beliebigen Con-nect-Schirms ein:

Programm ZEIGEN

Daraufhin erscheint der "Programme zeigen"-Schirm:

  11:35                * * *  C O N - N E C T  3  * * *                 9.Feb.94
  Buero LS                      Programme zeigen                        Mittwoch
                                                                                
  Bef Programmname                   Programm Bibl.    Fach          Abgelegt am
  --- ------------------------------ -------- -------- ------------- -----------
  __  Besuchsbericht                 BESUCH   SYSCNT2  Arbeitsfach      4.Feb.94
  __  Urlaub                         URLIST   SYSCNT2  (S)              9.Feb.94
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 Geben Sie die Anfangsbuchstaben der unten gezeigten Befehle ein                
     Befehl /                                                              /    
  Ablegen  Aendern  Loeschen Oben     Senden   Zeigen                           
                                                                                

Die Programme sind alphabetisch sortiert. Ihre eigenen Programme werden zuerst angezeigt. Danach folgen die Programme, die der Administrator erstellt hat.

Zu jedem Programm werden folgende Informationen angezeigt:

Programmname

Der Con-nect-Programmname.

Programm

Der Name des Natural-Programms, auf das sich der Con-nect-Programmname bezieht.

Bibl.

Der Name des Natural-Bibliothek, in der das Programm katalogisiert ist.

Fach

Der Name des Fachs, in dem das Programm abgelegt ist. Programme, die vom Con-nect-Administrator erstellt wurden, sind mit (S) markiert; Sie können diese Programme benutzen, können sie aber nicht ablegen, ändern oder löschen.

Abgelegt am

Das Datum, an dem das Programm in diesem Büro abgelegt wurde.

Befehle für Programme

Die Befehlsanzeige des "Programme zeigen"-Schirms zeigt alle Befehle, die für Con-nect-Programme gültig sind. Die Befehle sind im Abschnitt Befehle beschrieben. Für Programme gelten folgende Ausnahmen:

AENDERN

Mit dem Befehl AENDERN können Sie die Definitionskriterien des Con-nect-Programms ändern. Das Natural-Programm selbst können Sie hiermit nicht ändern; Sie können jedoch den Namen eines anderen Natural-Programms eingeben, das für das Con-nect-Programm herangezogen werden soll.

SENDEN

Wenn Sie ein Con-nect-Programm SENDEN, erscheint der "Senden"-Schirm. In diesem Schirm geben Sie die Empfänger ein. Sie müssen ein Begleitschreiben verfassen. Anschließend geben Sie den Befehl BESTAETIGEN ein, um das Programm zu versenden.

Wenn der Empfänger diese neue Post in seinem Posteingangsfach anzeigt, wird zuerst das Begleitschreiben angezeigt. Es erscheint eine Nachricht, die besagt, dass die Post ein Programm ist. Um die Definitionskriterien des Programmes anzuzeigen, muss der Empfänger den Befehl BEENDEN eingeben.

Um mit dem Con-nect-Programm zu arbeiten, muss der Empfänger das Programm zuerst ABLEGEN und anschließend den Programmnamen im "Dokument eingeben"-Schirm eingeben (siehe Programm eingeben).

Wenn Sie das eigentliche Natural-Programm an einen anderen Teilnehmer senden wollen, müssen Sie das Programm erst IMPORTIEREN (siehe Nach Con-nect importieren) und anschließend SENDEN. Dies ist jedoch nicht notwendig, da jeder Teilnehmer auf ein Natural-Programm zugreifen kann.

ZEIGEN

Mit dem Befehl ZEIGEN können Sie die Definitionskriterien anzeigen, die beim Erstellen des Con-nect-Programms eingegeben wurden. (Das Programm selbst ist in einer Natural-Bibliothek abgelegt. Sie können es nur mit den entsprechenden Natural-Befehlen und Natural-Statements anzeigen).

Beispiel

Dieses Beispiel zeigt, wie ein Dokument erstellt wird, das alle Mitarbeiter einer bestimmten Abteilung auflistet, die mehr als 20 Tage Resturlaub für das laufende Jahr haben.

Zuerst muss ein Natural-Programm erstellt werden. Es soll Daten aus der Datenbank extrahieren, die restlichen Urlaubstage errechnen und das Dokument erstellen.

Das folgende Beispiel ist ein Natural-Programm, das ein Dokument mit dem API-Subprogramm Z-ADD11 erstellt.

0010 ****************************************************************
0020 * PROGRAMMNAME : URLIST
0030 * Erstellt von : Sonya Long
0040 * Datum        : 7.Feb.94
0050 *
0060 ***************************************************************
0070 DEFINE DATA LOCAL
0080 01 #CNT       (B10)
0090 01 #ABTEILUNG (A10)
0100 01 BEST-VIEW VIEW OF MITARBEITER
0110   02 NAME
0120   02 VORNAME
0130   02 ABT
0140   02 URLAUB-BEGINN (1:12)
0150   02 URLAUB-ENDE   (1:12)
0160   02 URLAUB-REST
0170 01 #I        (N1)
0180 01 #N        (N1)
0190 *
0200 * PARAMETER FUER API
0210 *
0220 01 RETURN-CODE  (N2)
0230 01 BUERONAME    (A8)
0240 01 PASSWORT     (A8)
0250 01 DOK-NAME     (A32)
0260 01 BETREFF      (A60/1:4)
0270 01 DOK-ISN      (P8)
0280 END-DEFINE
0290 *
0300 INPUT 'BITTE GEBEN SIE DIE ABTEILUNG EIN: ' #ABTEILUNG
0310 *
0320 DEFINE PRINTER (1) OUTPUT 'SOURCE'  /* AUSGABEBEREICH DEFINIEREN
0330 FORMAT(1) PS=0
0340 SET CONTROL 'Z'                     /* ARBEITSBEREICH LOESCHEN
0350 *
0360 MOVE *USER TO BUERONAME
0370 *
0380 WRITE (1)'DAS IST DIE LISTE ALLER MITARBEITER IN DER ABTEILUNG' #ABTEILUNG
0390 WRITE (1)'MIT MEHR ALS 20 TAGEN RESTURLAUB IN DIESEM JAHR'
0400 WRITE (1)'UND MIT DEM ZULETZT GEPLANTEN URLAUB'
0410 WRITE (1)' '
0420 WRITE (1)'NAME' 30T 'ABT' 40T 'URLAUB' 50T 'GEPLANT'
0430 WRITE (1)'--------------------------------------------------------'*DATE
0440 WRITE (1)' '
0450 READ BEST-VIEW BY ABT WHERE ((ABT=#ABTEILUNG) AND (URLAUB-REST > 20))
0460 *
0470 FOR #I=2 TO 5
0480  IF URLAUB-BEGINN(#I)= 000000 THEN
0490      COMPUTE #N = #I - 1
0500  END-IF
0510 MOVE 5 TO #I
0520 END-FOR
0530  WRITE (1) NOTITLE NAME 30T ABT
0540              40T URLAUB-REST 50T URLAUB-BEGINN(#N) URLAUB-ENDE(#N)
0550 *
0560 END-READ
0570 CALLNAT 'Z-ADD11' RETURN-CODE BUERONAME PASSWORT
0580              DOK-NAME BETREFF(*) DOK-ISN
0590 *
0600 *
0610 IF NOT RETURN-CODE = 51
0620   WRITE 'RETURN-CODE' RETURN-CODE
0630 END-IF
0640 END

Geben Sie das Programm ein (siehe Programm eingeben).

  11:35                * * *  C O N - N E C T  3  * * *                 9.Feb.94
  Buero LS                     Programm Eingeben                        Mittwoch
                                                                                
             Fach Arbeitsfach____ Ordner _______________                        
                                                                                
         Programm Urlaub__________________________                              
                                                                                
     Beschreibung ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                                                                                
                                                                                
         Programm URLIST__ Bibliothek SYSCNT2_                                  
                                                                                
      Persoenlich _ oder Berechtigung zum Lesen 7 Aendern 7 Kopieren 7          
                                                                                
                                                                                
                                                                                
                                                                                
 Angaben ergaenzen und zum Eingeben EINGABE druecken                           
     Befehl /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Hilfe Menue Beend Post  Memo  Fach  Dokum Notiz Kalen Funkt Letzt BefZe  

Erstellen Sie ein Dokument ("Dokument EINGEBEN") und geben Sie den Namen des Programms ein, mit dem das Dokument erstellt werden soll.

  11:36                * * *  C O N - N E C T  3  * * *                 9.Feb.94
  Buero LS                     Dokument eingeben                        Mittwoch
                                                                                
             Fach Arbeitsfach____ Ordner _______________                        
                                                                                
         Dokument Urlaubsliste____________________                              
                                                                                
    Erstellen mit Urlaub__________________________  ( Formular / Programm )     
                                                                                
     Beschreibung Urlaubsliste aller Mitarbeiter______________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                  ____________________________________________________________  
                                                                                
     Suchbegriffe _______________  _______________  _______________             
                  _______________  _______________  _______________             
                                                                                
      Persoenlich _ oder Berechtigung zum Lesen 7 Aendern 7 Kopieren 7 Drucken 7
                                                                                
      Ablaufdatum 9.Feb.95___ Zum Ablaufdatum archivieren x                     
 Angaben ergaenzen und zum Eingeben EINGABE druecken                           
     Befehl /                                                              /    
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Hilfe Menue Beend Post  Memo  Fach  Dokum Notiz Kalen Funkt Letzt BefZe  

Drücken Sie EINGABE.

Daraufhin erscheint der "Editor Dokumentname"-Schirm mit dem Dokument, das vom Programm erstellt wurde.

  11:37                * * *  C O N - N E C T  3  * * *                 9.Feb.94
  Buero LS          Editor Urlaubsliste                                 Mittwoch
   Fach Arbeitsfach     Ordner                           Seite     1 Zeile     1
    ....+....10...+....20...+....30...+....40...+....50...+....60...+....70...+.
    DAS IST DIE LISTE ALLER MITARBEITER IN DER ABTEILUNG COMP02                 
    MIT MEHR ALS 20 TAGEN RESTURLAUB IN DIESEM JAHR                             
    UND MIT DEM ZULETZT GEPLANTEN URLAUB                                        
                                                                                
    NAME                         ABT       URLAUB    GEPLANT                    
    --------------------------------------------------------94/02/09           
                                                                                
    GODEFROY                     COMP02     33       94/04/13 94/04/24          
    BESSON                       COMP02     33       94/06/01 94/06/05          
    GREGOIRE                     COMP02     33       94/03/16 94/03/20          
    VILLAR                       COMP02     25       94/04/27 94/04/27          
    NIEDA                        COMP02     24       94/02/17 94/02/28         
    ESPLA                        COMP02     22       94/02/26 94/02/28          
    PUERTAS                      COMP02     22       94/03/18 94/03/20          
    LLAGUNO                      COMP02     22       94/05/26 94/06/03          
    SERRANO                      COMP02     22       94/03/25 94/03/27         
 Befehl eingeben, PF-Taste druecken oder * zum Zeigen der Befehle               
     Befehl /                                          /belegt    % Ri + Zeich ,
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Hilfe Menue Beend Setzn       X     Oben  Unten Y     Funkt CX-Y  BefZe