Installation von Natural Advanced Facilities unter CICS überprüfen

Sie können die erfolgreiche Installation von Natural Advanced Facilities überprüfen, indem Sie die Anleitung in diesem Abschnitt befolgen.


System prüfen

Um festzustellen, ob Natural Advanced Facilities korrekt funktioniert, können Sie die folgenden Schritte durchführen,

Beginn der AnweisungslisteUm einen Prüfbericht zu drucken:

  • Setzen Sie zum Prüfen im entsprechenden logischen Drucker die Disposition auf K.

    Melden Sie sich in der Natural-Systembibliothek SYSPOOL an und führen Sie die Programme NTEST und SPPTEST aus. Diese Programme enthalten WRITE (1)-Statements.

    Oder:
    Erstellen Sie Prüfberichte mit der Funktion 42, die in der Natural Advanced Facilities-Dokumentation beschrieben ist.

Beginn der AnweisungslisteFalls ein Prüfbericht nicht gedruckt werden kann:

  1. Prüfen Sie, ob der CICS-Druckerstatus IN SERVICE ist.

  2. Verwenden Sie die CICS CMSG (CICS Message Switching Transaction), um eine Nachricht an den angegebenen Drucker weiterzuleiten:

    CMSG 'message',ROUTE=term-id,SEND

    wobei term-id die Terminalkennung des CICS-Druckers ist, wie in der TCT angegeben.

  3. Falls Natural Security installiert ist, prüfen Sie, ob Anmeldefehlersätze (des NATSPOOL-Spool-Servers NATP) in die Natural Security-Systemdatei geschrieben wurden. Das Verwaltungssystem für diese Fehlersätze kann durch Eingabe von ERROR in der Kommandozeile von Natural Security aufgerufen werden.

  4. Überprüfen Sie, dass das standardmäßige Natural-LOGON-Objekt nicht ersetzt wurde. Der NATSPOOL-Spool-Server NATP muss in der Lage sein, das Modul SVPCIC01 in der SYSPRINT-Bibliothek auszuführen.

    Prüfen Sie auch, ob der LOGON-User-Exit zum Abbruch des LOGON des Spool-Servers zu SYSPRINT führt.

  5. Prüfen Sie, ob die Katalogdaten der Objekte in SYSPRINT und SYSPOOL übereinstimmen.

  6. Prüfen Sie, ob die Parameter für den Spool-Server mit der Natural Advanced Facilities-Umgebung übereinstimmen. Rufen Sie dazu MENU in der SYSPOOL-Bibliothek auf und überprüfen Sie die mit Funktion 30.5 definierten CICS-Optionen (siehe Natural Advanced Facilities-Dokumentation).

  7. Vergewissern Sie sich, dass weder die externe Security (Operand EXTSEC von CICS PCT) noch die Security Levels (Operand TRANSEC von CICS PCT) für den Spool-Server NATP definiert sind. Dadurch wird sichergestellt, dass NATP ohne Sicherheitsverletzungen eingeleitet werden kann.

  8. Überprüfen Sie die TCT- und VTAM-Definitionen (siehe Installationschritte Natural Advanced Facilities in Natural Security definieren, Natural Advanced Facilities unter CICS installieren und Natural Advanced Facilities für VTAM/non-SNA definieren im Abschnitt Natural Advanced Facilities unter CICS installieren).

  9. Weisen Sie der Destination/Form-Kombination des ersten logischen Druckers ein Bildschirmgerät anstelle eines Druckergeräts zu, führen Sie NTEST in der SYSPOOL-Bibliothek aus und prüfen Sie auf Fehlermeldungen auf dem Bildschirm.

    Bei manchen Geräten kann der CICS-Abbruch ATNI auftreten.

    Da die Natural Security-Anmeldeverarbeitung prüft, ob das Gerät ein Drucker ist, ist dieser Test nur möglich, wenn Natural Security nicht installiert ist.

  10. Starten Sie die Transaktion CEDF für Ihr Endgerät und prüfen Sie, ob das Kommando EXEC CICS START (zum Starten des Spool-Servers) ausgeführt wird.

  11. Starten Sie die Transaktion CEDF für Ihr Druckergerät (CEDF-Terminalkennung des Druckers), und prüfen Sie, welche Kommandos ausgeführt werden.

  12. Überprüfen Sie die Natural Advanced Facilities-Meldungen auf der Systembedienerkonsole und/oder in der Protokolldatei (das Ziel (Destination) der Meldungen wird mit Funktion 30.5 definiert (siehe Natural Advanced Facilities-Dokumentation).

    Konsolenmeldungen, die vom Spool-Server gesendet werden, beginnen mit:

    NAF SP-SERV:

    Konsolenmeldungen, die von der Terminal-Task gesendet werden, beginnen mit:

    NAF-
  13. Erstellen Sie einen NATSPOOL-Trace und prüfen Sie, welche Module der Natural Advanced Facilities aufgerufen, welche Adabas-Kommandos ausgeführt und welche Rückgabewerte aufgetreten sind.

NATSPOOL- Trace unter Verwendung von SYSRDC

Beginn der AnweisungslisteUm einen Online-NATSPOOL-Trace mit Hilfe des Natural-Dienstprogramms SYSRDC zu erstellen:

  1. Starten Sie eine Natural-Sitzung mit den folgenden dynamischen Parametern:

    RDCSIZE=100, TRACE=(NATAM08), ITRACE=ON
  2. Melden Sie sich in der SYSRDC-Bibliothek an.

  3. Führen Sie das folgende Kommando aus, um den internen Trace-Typ auszuwählen:

    RDCSET N
  4. Führen Sie das folgende Kommando aus, um den Trace zu starten:

    RDCSTART
  5. Führen Sie ein Programm aus, das einen Bericht erstellt, z.B. NTEST in der Bibliothek SYSPOOL.

  6. Melden Sie sich in der SYSRDC-Bibliothek an.

  7. Führen Sie das folgende Kommando aus, um die Trace-Einträge anzuzeigen:

    RDCDISP

    Sie sehen nun, wann ein NATSPOOL-Modul beginnt (markiert als BEG) und endet (markiert als END) sowie seinen Rückgabewert in Dezimaldarstellung.

    Nach der Ausführung eines Adabas-Aufrufs (markiert als ADA) sehen Sie den Kommandocode, das erste Byte der Kommandokennung und den Returncode in Dezimaldarstellung.

Ausführliche Informationen über das Dienstprogramm SYSRDC finden Sie in der Debugger und Dienstprogramme (Utilities)-Dokumentation.

NATSPOOL Reason Codes

Fehler, die bei der Prüfung der Druckerverfügbarkeit auftreten können:

Fehlerbeschreibung Beschreibung
INV REQU Ungültige Anfrage
INV ID Ungültige Kennung
INV ADDR Ungültige Adresse
INV DEVC Ungültiger logischer Gerätecode für den Seitenstatus
ATI REQU ATI auf NON-ATI-Terminal erforderlich
RESO PRO Ressourcenproblem für Inter-Partition-Sitzung
INV PROG Unzulässiger Programmname
UNAB PER Anforderung kann nicht ausgeführt werden
INV TYPE Typ ist nicht LUC
RESO QUI Ressource wurde von TMP stillgelegt
LOCATERR Fehler, die nicht in der obigen Liste aufgeführt sind

Fehler, die während des Starts des Spool-Servers auftreten können:

Fehlereschreibung Beschreibung
TERMIDER Terminalkennungsfehler
TRANIDER Transaktionskennungsfehler
SYSIDERR SYSID-Fehler
INVREQ Ungültige Anfrage
IOERR E/A-Fehler
LENGERR Längenfehler
ISCINVRE ISC ungültige Anforderung
NOTAUTH Nicht autorisiert
STARTERR Fehler, die nicht in der obigen Liste aufgeführt sind

Konsolen-Meldungen bei der NATSPOOL-Initialisierung

Meldungen, die während der Initialisierung von NATSPOOL auftreten können:

Meldung Text
NAF-01C ADABAS RCxxx, DBIDxxx, FNRxxx, AT OPEN
NAF-02C Not used
NAF-03C ADABAS RCxxx, DBIDxxx, FNRxxx, AT READ REPORT
NAF-04C ADABAS RCxxx, DBIDxxx, FNRxxx, AT READ PRINTER
NAF-05C ADABAS RCxxx, DBIDxxx, FNRxxx, AT CLOSE
NAF-06C ADABAS RCxxx, DBIDxxx, FNRxxx, AT UPDATE REPORT
NAF-07C ADABAS RCxxx, DBIDxxx, FNRxxx, AT UPDATE PRINTER
NAF-08I REPORT xxxxxxxxx, JOBxx.xxx, SET -TO BE PRINTED-
NAF-09I PRINTER xxxx SET -FREE-
NAF-10I PRINTER xxxx RESTARTS IN 20 SECONDS, DEST=xxxxxxxx, FORM=x
NAF-11C RESTART ERROR NAT xxxx ON PRINTER xxxx

NATSPOOL-Print-Server-Meldungen

Beschreibungen der NATSPOOL-Print-Server-Meldungen finden Sie in der Online-Hilfe.

Beginn der AnweisungslisteUm die Online-Hilfe für Print-Server-Meldungen aufzurufen:

  1. Drücken Sie PF1 im Natural Spool Administration Menu.

  2. Geben Sie den Funktionscode 99 (Verschiedene Informationen) ein.

  3. Geben Sie den Funktionscode 4 ein (Natural Advanced Facilities SP-SERV-Nachrichten vom Spool-Server).

NATSPOOL Abend Codes

Abend Code Ursache Maßnahme
NAF1 - INVALID LENGTH Die Länge der zu druckenden Daten ist nicht positiv. Erstellen Sie den Dump und wenden Sie sich an den Support.
NAF2 - INVALID LENGTH Die Länge der zu druckenden Daten ist größer als die maximale Länge des Terminal-E/A-Puffers (TIOBM). Erstellen Sie den Dump und wenden Sie sich an den Support.
NAF3 - INVALID RETURN CODE Der Rückgabewert der Task-End-Routine CMTSKND ist ungleich Null. Erstellen Sie den Dump und wenden Sie sich an den Support.
NAF4 - INVALID RETURN CODE Der Rückgabewert der Druckroutine CMWTERM ist ungleich Null. Erstellen Sie den Dump und wenden Sie sich an den Support.