Installation von Natural Advanced Facilities unter CICS überprüfen

#### Search Results

Search

# 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

- NATSPOOL Reason Codes

- Konsolen-Meldungen bei der NATSPOOL-Initialisierung

- NATSPOOL-Print-Server-Meldungen

- NATSPOOL Abend Codes

## System prüfen

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

Um 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.

Falls 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

Um 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.

Um 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.

### On this page

- System prüfen
- NATSPOOL Reason Codes
- Konsolen-Meldungen bei der NATSPOOL-Initialisierung
- NATSPOOL-Print-Server-Meldungen
- NATSPOOL Abend Codes