purge()

Die Systemfunktion 'sysLib.purge()' löscht eine temporäre CICS-Speicherwarteschlange.

Wenn Sie 'sysLib.purge()' aufrufen, führt das Programm den CICS-Befehl ENQ mit der Option 'NOSUSPEND' aus, um Daten in die Warteschlange mit dem Ressourcennamen 'EZETEMP-Warteschlangenname' zu stellen. Nach dem Löschen der temporären Speicherwarteschlange führt das Programm den CICS-Befehl DEQ aus, um Daten aus der Warteschlange zu entfernen.

Syntax

  sysLib.purge(Warteschlangenname CHAR(8) in)
Warteschlangenname
Entweder ein Literal oder eine Variable vom Typ CHAR (1 bis 8 Byte). Warteschlangenname ist erforderlich und gibt den Namen einer einzelnen temporären Speicherwarteschlange an.

Beispiel

Mit dem folgenden Code wird die temporäre CICS-Speicherwarteschlange gelöscht, die dem aktuellen Wert von 'resourceAssociation' für den Datensatz 'myCustomer' zugeordnet ist:

  myQueue CHAR(8);
  myQueue = myCustomer.resourceAssociation;
  sysLib.purge(myQueue);

Hinweise zu Fehlern

Wenn ein Fehler auftritt und Sie die Programmeigenschaft 'v60ExceptionCompatibility' auf YES gesetzt haben, wird das erste Byte von 'EIBFN' in die ersten 2 Zeichen von 'sysVar.errorCode' gestellt, und Byte 0 bis 2 von 'EIBRCODE' werden in die letzten 6 Zeichen von 'sysVar.errorCode' gestellt.

Kompatibilität

Tabelle 1. Hinweise zur Kompatibilität für 'purge()'
Plattform Problem
Java™-Generierung Die Funktion 'sysLib.purge()' wird nicht unterstützt.
JavaScript-Generierung Die Funktion 'sysLib.purge()' wird nicht unterstützt.

Feedback