ADS Anwendungssteuerung Entwicklerhandbuch

Kapitel 3. Schritte, um ein Pakte einzubinden

3.1 Neues Paket in ADS einbinden

Folgende Schritte sind nötig, um ein neues Paket in ADS einzubinden:

Anlegen Paketleitsatz

Mit der Funktion 'Paketleitsatzwartung (PKLW)' wird ein neuer Paketleitsatz angelegt. Hier wird auch definiert, welcher Bibliothek das neue Paket zuzuordnen ist.

Anlegen Aktivität

Mit der Funktion 'Wartung Aktivität (AKTW)' werden die Aktivitäten für das Paket erfasst.

Hinweis

Die in den Aktivitäten referenzierten Objekte (Programme, Befehle, ...) müssen bereits in der Paketbibliothek oder in der ADS-Bibliothek vorhanden sein.

Anlegen Menüs

Die definierten Aktivitäten können mit der Funktion 'Wartung Menüs (MENW)' zu Menüs gruppiert werden.

Anlegen Expert-Codes

Für die definierten Aktivitäten können mit der Funktion 'Wartung Expertcodes (EXPW)' Expertcodes für den Direkt-Aufruf definiert werden.

Anlegen Ausschluss-Definitionen

Mit der Funktion 'Wartung Ausschlüsse (AUSW)' können die Ausschlüsse zwischen einzelnen Aktivitäten oder für Aktivitäten innerhalb eines ganzen Bereichs definiert werden.

Anlegen Paketzuordnungssaätze

Für alle mit dem Paket gemeinsam installierbaren Pakete müssen mit der Funktion 'Wartung Paketzuordnungssätze (PKZW)' Paketzuordnungssätze angelegt werden.

Installation für Firma

Um schlussendlich die Aktivitäten aufrufen zu können muss das Paket mit der Funktion 'Installation Paket zu Firma (INSPF)' für eine bestehende Firma installiert werden.

3.2 Schnittstellenprogramme von ADS

Folgende Programme werden von ADS als Dummy-Programm ohne Funktion ausgeliefert. Sie können unter dem gleichen Namen bei Paketen mitgeliefert werden, um an gewissen Stellen einer Funktion bestimmte paketspezifische Aufgaben auszuführen.

3.2.1 ADSOPEN

paketspezifische Initialisierung

Parameter

&S1

*CHAR 1024

&LASTPKT

*CHAR 10

Eingabeparameter

&S1

vorbereitet für Aktivitätsaufruf

&LASTPKT

Paket der zuletzt aufgerufenen Aktivität

Ausgabeparameter

&S1

vorbereitet für Aktivitätsaufruf

Aufruf

Vor dem ersten Aufruf einer Aktivität nach einem Firmenwechsel, oder nach Durchführung einer Aktivität eines anderen Pakets mit Ausnahme von ADS. Die Bibliotheksliste ist bereits für den Aktivitätsaufruf vorbereitet.

Ziel

Durchführung paketspezifischer Initialisierungen, wie z. B.: OPNDBF für die wichtigsten verwendeten Dateien oder Vorbereiten der anwendungsspezifischen Daten in der Datei S1.

3.2.2 ADSCLOSE

paketspezifische Abschlussarbeiten

Parameter

&S1

*CHAR 1024

&LASTPKT

*CHAR 10

Eingabeparameter

&S1

vorbereitet für Aktivitätsaufruf

&LASTPKT

Paket der zuletzt aufgerufenen Aktivität

Ausgabeparameter

&S1

vorbereitet für Aktivitätsaufruf

Aufruf

Vor Durchführung einer Aktivität eines anderen Pakets mit Ausnahme von ADS, vor Aufruf eines Firmenwechsels oder bei Beendigung von ADS mit F3, falls ADSOPEN für dieses Paket bereits aufgerufen wurde.

Ziel

Durchführung paketspezifischer Abschlussarbeiten, wie z. B.: CLOF für die in ADSOPEN eröffneten Dateien.

3.2.3 ADSENT-INSTALL

Parameter

&S1

*CHAR 1024

&DEVICE

*CHAR 10

&LIBRP

*CHAR 512

&PAKET

*CHAR 10

Eingabeparameter

&DEVICE

die bei der Installation verwendete Rücksicherungseinheit

&LIBRP

die Bibliothek, in die das Paket installiert wird

&PAKET

der Name des installierten Paketes

Ausgabeparameter

&S1

Stellen 344-361 Erfolgs- oder Fehlermeldung

Funktion

Die Funktion dieses Programmes hängt von den Anforderungen des installierten Paketes ab. Die folgenden Aktionen können als Anhaltspunkte für den Programmablauf verstanden werden:

· Einspielen aller für das Paket benötigten Objekte in die entsprechende Bibliothek (&LIBRP)

· MRGMSGF das paketbezogene Massage-File in das ADSMSGF der ADS-Bibliothek (ADS-Bibliothek steht zu diesem Zeitpunkt an der zweiten Stelle der Bibliotheksliste, hinter &LIBRP. Ihr Name ist in der S1 auf den Stellen 284-293 eingetragen)

· Aufruf paketspezifischer Funktionen

· Setzen einer Erfolgs- oder Fehlermeldung in der S1; als Erfolgsmeldung sollte die Standardmeldung ADS-1390 verwendet werden.

Alle weiteren für die Installation des Paketes benötigten Objekte. Diese Objekte müssen mit dem Programm INSTALL geladen werden.

Beachten Sie:

Die ausgelieferten Objekte sollten das Benutzerprofil ADS als Eigner haben. Dieses Benutzerprofil wird von ADS zur Verfügung gestellt und ist Voraussetzung für die Arbeiten mit ADS.

3.2.4 ADSENT-PKTFIRCHK

Paketspezifische Prüfung für Installation Paket zu Firma

Das Programm PKFIRCHK ist ein Schnittstellenprogramm, um paketspezifische Prüfungen im Rahmen der Installation durchführen zu können.

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Inhalt lt. Aktivität für Installation Paket zu Firma Expertcode INSPF mit Ausnahme von

Stelle 91-100 Kurzname des installierten Paketes

Stelle 284-293 Paketbibliothek

Ausgabeparameter

&S1

Stellen 344-361 Fehlermeldung

Funktion

Die Funktion dieses Programmes hängt von den Anforderungen des installierten Paketes ab.

3.2.5 ADSENT-PKTFIR

Paketspezifische Installation Paket zu Firma

Das Programm PKTFIR ist ein Schnittstellenprogramm, um paketspezifische Installationsfunktionen durchführen zu können.

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Inhalt lt. Aktivität für Installation Paket zu Firma Expertcode INSPF mit Ausnahme von

Stelle 91-100 Kurzname des installierten Paketes

Stelle 284-293 Paketbibliothek

Ausgabeparameter

&S1

Stellen 344-361 Fehlermeldung

Funktion

Die Funktion dieses Programmes hängt von den Anforderungen des installierten Paketes ab. Beispielsweise können folgende Programme durchgeführt werden:

· Anlegen der paketspezifischen Dateien

· Initialisieren dieser Dateien mit Musterdaten

3.2.6 ADSUSR02

Paketspezifische Korrekturen nach der PTF-Einspielung

Das Programm ADSUSR02 ist ein Schnittstellenprogramm, das am Ende der PTF-Einspielung je Paket aufgerufen wird.

Hier können beispielsweise andere Schnittstellenprogramme ausgetauscht werden oder firmenindividuelle logische Sichten ergänzt werden.

Die angeführten Parameter sollten nicht geändert werden.

Parameter

&S1

*CHAR 1024

Stellen 344-361 Fehlermeldung

&DEVICE

*CHAR 10

verwendeter Datenträger bei der PTF-Einspielung

&LIBR

*CHAR 10

Bibliothek in der das PTF-Paket installiert wurde

&PAKET

*CHAR 10

Paket, für das die PTFs eingespielt wurden

&PKTVERSI

*CHAR 512

diverse Informationen für die PTF-Einspielung

Funktion

Das Programm enthält keine speziellen Funktionen – diese müssen vom Anwender ergänzt werden.

3.2.7 IFSUSR01

Prüfung IFS-Pfad

Das Programm IFSUSR01 ist ein Schnittstellenprogramm, das vor der Prüfung eines IFS-Pfades aufgerufen wird.

Die angeführten Parameter sollten nicht geändert werden.

Parameter

&PFAD

*CHAR 50

Funktion

Das Programm enthält keine speziellen Funktionen – diese müssen vom Anwender ergänzt werden.

3.2.8 IFSUSR02

Vor Ausgabe Datei ins IFS

Das Programm IFSUSR02 ist ein Schnittstellenprogramm, das vor der Ausgabe einer Datei ins IFS aufgerufen wird.

Die angeführten Parameter sollten nicht geändert werden.

Parameter

&PFAD+FILENAME

*CHAR 256

Funktion

Das Programm enthält keine speziellen Funktionen – diese müssen vom Anwender ergänzt werden.

3.2.8 IFSUSR03

Nach Ausgabe Datei ins IFS

Das Programm IFSUSR03 ist ein Schnittstellenprogramm, das vor der Ausgabe einer Datei ins IFS aufgerufen wird.

Die angeführten Parameter sollten nicht geändert werden.

Parameter

&PFAD+FILENAME

*CHAR 256

Funktion

Das Programm enthält keine speziellen Funktionen – diese müssen vom Anwender ergänzt werden.

3.3 Utitlity-Programme von ADS

Allgemeines

Utility-Programme sind allgemeine Hilfsprogramme die spezielle Aufgaben erledigen. Diese Programme werden von ADS zur Verfügung gestellt und können auch von anderen Anwendungen aufgerufen werden.

Beachten Sie:

Diese Utility-Programme sind Bestandteil von ADS und könnten daher jederzeit geändert werden - überprüfen Sie daher bei der Auslieferung von neuen ADS PTFs ob sich dies geändert haben.

· ADSALCBIB

· ADSALCFA

· ADSBPFCL

· ADSDEVCL

· ADSDLCBIB

· ADSDLCFA

· ADSFABCL

· ADSINZCL

· ADSIS1CL

· ADSJBACL

· ADSJNF

· ADSJPF

· ADSMSGCL

· ADSPFACL

· ADSPFBCL

· ADSPFLCL

· ADSPFPCL

· ADSSBMJOB

3.3.1 ADSALCBIB

Zuordnen Bibliothek

Parameter

&S1

*CHAR 1024

&STATUS

*CHAR 7

Eingabeparameter

&S1

Stellen 284-293 enthalten die zuzuordnende Bibliothek

&STATUS

enthält den Sperrstatus (gültige Werte: siehe Systembefehl ALCOBJ)

Ausgabeparameter

&S1

Stellen 344-361 enthalten eine Meldung, falls Zuordnung nicht erfolgreich war

Funktion

In der angegebenen Bibliothek wird, wenn noch nicht vorhanden, eine Data-Area angelegt und mit dem Befehl ALCOBJ zugeordnet.

Ziel

Dieses Programm sollte im Anwendungs-Startprogramm (ADSOPEN) aufgerufen werden, wenn die Anwendung Objekte zuordnet und diese am Ende einer Aktivität nicht wieder freigibt (z. B.: Dateien eröffnen). Damit kann verhindert werden, dass exklusive Operationen auf Objekte dieser Bibliothek durchgeführt werden, obwohl das Ausschluss-Prüfprogramm von ADS keine aktiven Funktionen erkennt.

Anmerkung:

Bei der Paketsicherung wird von ADS das Programm 'ADSALCBIB' mit STATUS(*EXCL) aufgerufen, um sicherzustellen, dass die Objekte der Bibliothek für die Sicherung verfügbar sind.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSADSBIB realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.2 ADSALCFA

Zuordnen Firma

Parameter

&S1

*CHAR 1024

&STATUS

*CHAR 7

Eingabeparameter

&S1

Stellen 448-457 enthalten die zuzuordnende Bibliothek

&STATUS

enthält den Sperrstatus (gültige Werte: siehe Befehl ALCOBJ)

Ausgabeparameter

&S1

Stellen 344-361 enthalten eine Meldung, falls Zuordnung nicht erfolgreich war

Funktion

In der angegebenen Bibliothek wird, wenn noch nicht vorhanden, eine Data-Area angelegt und mit dem Befehl ALCOBJ zugeordnet.

Ziel

Anmerkung:

Bei der Paketsicherung wird von ADS das Programm 'ADSALCBIB' mit STATUS(*EXCL) aufgerufen, um sicherszustellen, dass die Objekte der Bibliothek für die Sicherung verfügbar sind.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSADSFA realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.3 ADSBPFCBL

Prüfen Installation, Paket und Berechtigung zu Firma

Funktion

Das Programm ruft der Reihe nach die Programme

ADSPFACBL (Prüfen Firmeninstallation)

ADSPFBCBL (Prüfen Firmenberechtigung) und

ADSPFPCBL (Prüfen Paketinstallation)

auf. Die Parameter und Funktionen sind bei den jeweiligen Programmen beschrieben.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSBPFCL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.4 ADSDEVCL

Auswahl/Prüfen Sicherungs-/Rücksicherungsmedium

Parameter

&S1

*CHAR 1024

&DEVICE

*CHAR 10

&DEVTYP

*CHAR 3

&INXX

*CHAR 2

Eingabeparameter

&S1

Stellen 5-14 aktueller Firmenkurzname

Stellen 15-44 aktueller Firmenlangname

Stellen 102-131 Langname der aufgerufenen Aktivität

&DEVICE

wenn = ' ' wird ein Bildschirm zur Eingabe einer Einheit angezeigt, sonst erfolgt sofort die Prüfung

&INXX

Steuerung der Bildschirmtexte

'40' für Sicherung

'41' für Rücksicherung

Ausgabeparameter

&S1

Stellen 435-436 ausgewählte Einheit

&DEVTYP

Art der Einheit (TAP oder DKT)

Funktion

Wird im Parameter &DEVICE ' ' übergeben, wird der Benutzer aufgefordert, den Namen einer Sicherungseinheit anzugeben. Ist der Parameter &DEVICE nicht leer, entfällt diese Aufforderung. Der angegebene Name wird überprüft, ob er eine gültige Sicherungseinheit bezeichnet. Ist dies nicht der Fall erhält der Benutzer eine entsprechende Meldung und kann den Namen korrigieren oder das Programm mit F3 beenden.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSDEVCL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.5 ADSDLCBIB

Freigeben Bibliothek

Ziel

Dies ist das Gegenstück zu ADSALCBIB.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSDLCBIB realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.6 ADSDLCFA

Freigeben Firma

Ziel

Dies ist das Gegenstück zu ADSALCFA.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSDLCFA realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.7 ADSFABCL

Ermitteln Firmenbibliothek

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Stellen 5-14 Kurzname der Firma, deren Bibliothek ermittelt werden soll.

Ausgabeparameter

&S1

Stellen 448-457 Name der Bibliothek, in der die Firma installiert ist

Stellen 344-361 Fehlermeldung

Funktion

Aus der Installationsdatei wird aus dem Firmenleitsatz die Bibliothek ermittelt, in der die übergebene Firma installiert ist. Wurde der Firmenleitsatz nicht gefunden, oder ist in der Firma ein Firmenausschluss aktiv, wird eine entsprechende Meldung zurückgegeben.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSFABCL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.8 ADSINZCL

Initialisieren Sicherungsmedium

Parameter

&S1

*CHAR 1024

&VOLID

*CHAR 6

&DEVICE

*CHAR 10

&DEVTYP

*CHAR 3

&SIZE

*DEC 10

Eingabeparameter

&S1

für Bildschirmanzeige

Stellen 5-14 aktueller Firmenkurzname

Stellen 15-44 aktueller Firmenlangname

Stellen 102-131 Langname der aufgerufenen Aktivität

&VOLID

neuer Name des Sicherungsmediums

&DEVICE

Name der Sicherungseinheit

&DEVTYP

Art der Sicherungseinheit

&SIZE

Größe der/des später zu sichernden Objekte(s) in Byte

Ausgabeparameter

&S1

Stellen 435-436 letzte Befehlstaste

&DEVICE

ausgewählte Einheit

&DEVTYP

Art der Einheit

Funktion

Wird im Parameter &DEVICE oder &DEVTYP kein Wert übergeben, wird das Programm ADSDEVCL aufgerufen, um dem Benutzer die Möglichkeit zu geben, eine Einheit auszuwählen. Aufgrund des Parameters &SIZE sowie der Kapazität des aufgrund von &DEVICE zu erwartenden Mediums wird die Anzahl der Sicherungsmedien errechnet. Diese Anzahl wird gemeinsam mit der Aufforderung, das erste Medium in die Einheit einzulegen, dem Benutzer angezeigt. Der Benutzer hat die Möglichkeit, den Wert für die Anzahl zu ändern.

Ist das eingelegte Medium bereits mit einer anderen VOLID initialisiert, muss der Benutzer den Löschvorgang bestätigen. Es werden so viele Medien initialisiert, wie errechnet bzw. eingegeben wurden.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSINZCL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.9 ADSIS1CL

Initialisieren S1

Parameter

&S1

Eingabeparameter

&S1

*CHAR 1024

Ausgabeparameter

&S1

*CHAR 1024

Funktion

Die S1 wird initialisiert. Alle Stellen mit Ausnahme der folgenden werden ' ' initialisiert:

Stelle 1 (Befehlseingabe)

Stelle 2 (Benutzergruppe)

Stelle 3 (BS-Ebenen-Anz)

Stelle 4 (Fa-Paketbezogen)

Stelle 45-54 (WSID)

Parameter JOB aus RTVJOBA

Stelle 55-64 (USERID)

Parameter USER aus RTVJOBA

Stelle 65-70 (JOB-Nummer)

Parameter NBR aus RTVJOBA

Stelle 71-72 (JOB-Nr-ADS)

Stelle 73 (Restart-verw)

Stelle 74 (Sicherhkl)

Stelle 75 (Syst-VA)

Stelle 76-77 (Versionsnr)

X'000F'

Stelle 78-79 (Mode-Nr)

X'000F'

Stelle 132 (Aufruf-Art)

6 (bei interaktivem Job)

7 (bei Batch-Job)

Stelle 283 (Ausschl-setzen)

Stelle 284-293 (Bibliothek)

Parameter CURLIB aus RTVJOBA

Stelle 357-361 (Meldung)

00000

Stelle 383 (Berechtpruef-Kz)

Stelle 384 (Exp-Code-Kz)

Stelle 385 (Installpruef-Kz)

Stelle 386 (Restart)

Stelle 390 (Verzweigen)

Stelle 391 (Rueckk-nach-Verzw)

Stelle 392 (Z7-sperren)

Stelle 393 (Testmodus)

Stelle 394 (Ausschl-warten)

Stelle 435-436 (Letzte-BT)

Stelle 437 (Abschluß-Kz)

Stelle 458 (SBM-AP-Pgm)

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSIS1CL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.10 ADSJBACL

Prüfen, ob Job aktiv ist

Parameter

&WSID

*CHAR 10

&USER

*CHAR 10

&JOBNR

*CHAR 6

&CPFMLDDEF

*CHAR 15

&CPFMSGTXT

*CHAR 69

Eingabeparameter

&WSID, &USER, &JOBNR

die Job-Identifikation des zu testenden Jobs

Ausgabeparameter

&CPFMLDDEF

Meldung (ADS-Format), falls Job nicht aktiv ist

&CPFMSGTXT

zugehöriger Meldungstext

Funktion

Das Programm prüft, ob der angegebene Job in aktiv ist, oder in einer JOBQ auf seine Ausführung wartet. In beiden Fällen gilt er für ADS als 'aktiv'. Steht der Job bereits in einer OUTQ, oder ist er überhaupt nicht im System vorhanden, gilt er für ADS als nicht aktiv. In diesem Fall wird eine Meldung zurückgegeben. (Die Prüfung erfolgt mit dem Systembefehl 'CHGJOB SWS(XXXXXXXX)', der nur dann erfolgreich ist, wenn der Job für ADS als aktiv gilt.)

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSJBACL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.11 ADSJNF

Installation neue Firma (Batch)

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Stellen 133-142 Kurzname der neuen Firma

Stellen 143-172 Langname der neuen Firma

Ausgabeparameter

&S1

Stellen 344-361 Fehlermeldung

Funktion

Eine neue Firma wird angelegt. Die Funktion des Programms entspricht der Funktion 'Installieren Firma (INSF)'. Die Eingabeparameter werden anstatt am Schirm über die S1 angegeben. Eine eventuelle Fehlermeldung wird nicht am Schirm sondern in der S1 ausgegeben.

3.3.12 ADSJPF

Installation Paket zu Firma (Batch)

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Stellen 133-142 Kurzname des Pakets

Stellen 143-172 Langname des Pakets

Ausgabeparameter

&S1

Stellen 344-361 Fehlermeldung

Funktion

Ein Paket wird der aktuellen Firma zugeordnet. Die Funktion des Programms entspricht der Funktion 'Installieren Paket zu Firma (INSPF)'. Die Eingabeparameter werden anstatt am Schirm über die S1 angegeben. Eine eventuelle Fehlermeldung wird nicht am Schirm sondern in der S1 ausgegeben.

3.3.13 ADSMSGCL

Anzeigen ADS-Nachricht

Parameter

&S1

*CHAR 1024

&FORMAT

*CHAR 10

&MLD

*CHAR 7

&ANTW

*CHAR 1

&MSGDTA

*CHAR 69

&MSGFX

*CHAR 10

Eingabeparameter

&S1

für Bildschirmanzeige

Stellen 5-14 aktueller Firmenkurzname

Stellen 15-44 aktueller Firmenlangname

Stellen 102-131 Langname der aufgerufenen Aktivität

&FORMAT

Anzuzeigendes Bildschirmformat

MSGJN

Format mit Eingabefeld für Ja/Nein (0/1) als Antwort auf die Meldung

MSGENTER

Format ohne Eingabefeld, Meldung muss mit EINGABE bestätigt werden

MSG

Format ohne Eingabefeld, Meldung wird angezeigt, Eingabe ist unterdrückt; das Programm wird sofort beendet, die Meldung bleibt am Bildschirm angezeigt

&MLD

auszugebende Meldung im System-Format

&ANTW

Vorschlagswert für die Antwort, falls &FORMAT = MSGJN

&MSGDTA

Nachrichtendaten für Nachrichten mit variablen Texten

&MSGFX

Nachrichtendatei in der die Meldung enthalten ist

Ausgabeparameter

&S1

Stellen 435-436 letzte Befehlstaste (Formate MSGJN und MSGENTER)

&ANTW

eingegebene Antwort bei Format MSGJN

Funktion

Das Bildschirmformat wird mit der Meldung und (im Falle von MSGJN) mit der vorzuschlagenden Antwort aufbereitet. Am Format MSGJN wird die eingegebene Antwort auf Gültigkeit (Ja/Nein) überprüft. Ein Abbruch der Eingabe mit F3 ist zulässig.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSMSGCL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.14 ADSPFACBL

Prüfen Firma

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Stellen 5-14 zu testender Firmenkurzname

Ausgabeparameter

&S1

Stellen 344-361 Meldung, falls Firma nicht gefunden

Stelle 383 Status der Berechtigungsprüfung in dieser Firma

Funktion

Der Firmenleitsatz wird in der Installationsdatei gesucht. Ist er vorhanden, wird der Wert des Berechtpruef-Kz der Firma, andernfalls eine Meldung in der S1 übergeben.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSPFACL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.15 ADSPFBCBL

Prüfen Benutzerberechtigung je Firma

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Stellen 5-14 Firmenkurzname

Stellen 55-64 USERID

Stelle 383 Berechtpruef-Kz der Firma

Ausgabeparameter

&S1

Stellen 344-361 Meldung, falls Benutzer in der Firma nicht berechtigt ist

Funktion

Der dem Berechtpruef-Kz der Firma entsprechende Berechtigungssatz in der Berechtigungsdatei wird gesucht. Ist der Satz nicht vorhanden, wird eine Meldung in der S1 übergeben. Eine u. U. definierte Kennwort-Prüfung wird nicht durchgeführt.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSPFBCL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.16 ADSPFLCL

Prüfen, ob Paket in Bibliothek installiert

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Stellen 91-100 Paket

Stellen 284-293 Bibliothek

Ausgabeparameter

&S1

Stellen 344-361 Meldung, falls Paket nicht in der Bibliothek installiert ist

Funktion

Die Firmenpaketzuordnungssätze der Installationsdatei werden durchsucht, ob für eine Firma das angegebene Paket in der angegebenen Bibliothek installiert ist. Wird kein entsprechender Satz gefunden, wird eine Meldung in der S1 ausgegeben.

3.3.17 ADSPFPCBL

Prüfen, ob Paket für Firma installiert ist

Parameter

&S1

*CHAR 1024

Eingabeparameter

&S1

Stellen 5-14 Firmenkurzname

Stellen 91-100 Paket

Ausgabeparameter

&S1

Stellen 344-361 Meldung, falls Paket nicht für die Firma installiert ist

Funktion

Der Firmen-Paketzuordnungssatz der Installationsdatei wird für die angegebene Firma und das angegebene Paket gesucht. Ist der Zuordnungssatz nicht vorhanden, wird eine Meldung in der S1 ausgegeben.

Beachten Sie:

Bis inkl. ADS-Version V03.M06 war diese Funktion mit OPM-Programm ADSPFPCL realisiert - ab Version V03.M07 ist diese Funktion Bestandteil des Serviceprogrammes SVADSALG.

3.3.18 ADSSBMJOB

Submit ADS-Job

Ziel

Um ADS-Aktivitäten auch von außerhalb ADS aufrufen zu können (z. B.: DKS-Tagesabschluss aus einem individuellen Tagesabschluss-Programm), wurde der Befehl ADSSBMJOB implementiert. Mit diesem Befehl kann eine, für den Stapelbetrieb vorgesehene Aktivität von außerhalb des ADS übergeben werden.

Syntax

>>--ADSSBMJOB--firma--expcode-->

Erforderlich

Wahlweise

>--KENNWORT--+kennwort-+-><

| |

+*NONE----a

PGM: I

Parameter

FIRMA

eine unter ADS installierte Firma; die aufzurufende Aktivität muss in der Firma installiert sein; der aufrufende Benutzer muss sowohl für die Firma als auch für die Aktivität in dieser Firma berechtigt sein.

EXPCODE

der Expert-Code, über den die gewünschte Aktivität aufgerufen wird; der aufrufende Benutzer muss für die Aktivität berechtigt sein; die Aktivität muss als Batch-Aktivität definiert sein.

KENNWORT

das Kennwort, das den Benutzer in der Firma berechtigt; benötigt der Benutzer zur Auswahl der Firma kein Kennwort, so ist hier der Sonderwert *NONE einzutragen.

Funktion

Beim Aufruf des Befehls werden zunächst folgende Prüfungen durchgeführt:

· Ist die ausgewählte Firma installiert?

· Ist der Benutzer der Firma berechtigt (inkl. Kennwort)?

· Ist der Benutzer für die Aktivität berechtigt?

· Ist die Aktivität als Batch-Aktivität definiert?

· Kann die Aktivität 'submittet' werden (aktive Ausschlüsse)?

Wurden alle Prüfungen ohne Fehler durchlaufen, wird die Aktivität aufgerufen, als ob sie durch Eingabe des Expert-Codes auf einem Menü aufgerufen wurde. Es werden also alle Protokoll- und Abschlussverwaltungen wie bei einem 'normalen' Aktivitätsaufruf durchgeführt.

Wird bei einer dieser Prüfungen eine Fehlersituation erkannt, wird die Hinweisnachricht

(MSTYPE(*NOTIFY)) 'CPF0001 Fehler im Befehl ADSSBMJOB gefunden'

an das rufende Programm geschickt. Eine Hinweisnachricht führt nicht zum Abbruch des rufenden Programms. Sie wird jedoch durch den Befehl 'MONMSG' erkannt. Im rufenden Programm kann also eine Fehlermeldung von ADS ignoriert (kein MONMSG-Statement) oder erkannt werden (MONMSG-Statement nach dem Befehl ADSSBMJOB). Die tatsächlich aufgetretenen Fehlernachrichten sind über das Job-Protokoll verfügbar.