Ansicht
Dokumentation

RSTS_OPEN_WL - Öffne TemSe-Objekt, um zeilenweise zu schreiben

CL_GUI_FRONTEND_SERVICES - Frontend Services   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Aufgabe des FB 'RSTS_OPEN_WL'

TemSe-Objekte speichern sequentielle Daten. Um sie bearbeiten zu können, müssen sie zunächst geöffnet und am Schluß auch wieder geschlossen werden.

Dieser FB öffnet ein TemSe-Objekt um danach mit 'RSTS_WRITE' zeilenweise hineinzuschreiben.

Zum Abschluß muß der FB 'RSTS_CLOSE' aufgerufen werden.

Parallelarbeit und Handle-Konzept

Diese Guppe von Funktionsbausteinen ist darauf vorbereitet, auch mehrere TemSe-Objekte gleichzeitig zu benutzen. Da dies aber der seltenere Anwendungsfalls ist, wurde die Anwendung mit nur einem TemSe-Objekt zur Zeit vereinfacht.

Arbeit mit nur ein Objekt zur Zeit

Wenn man nur ein Objekt zur Zeit bearbeitet, können folgende Parameter fortgelassen werden:

Funktionsbaustein	Parameter
RSTS_OPEN_WL	OWN_FBHANDLE
FBHANDLE
RSTS_WRITE	FBHANDLE
RSTS_CLOSE	FBHANDLE

Wenn man mit mehreren Objekten zur Zeit arbeiten will, ist 'OWN_FBHANDLE' auf 'X' zu setzen und für 'FBHANDLE' eine Variable zu benutzen, die für die zusammengehoerenden Aufrufe von 'RSTS_OPEN_WL', 'RSTS_WRITE' und 'RSTS_CLOSE' gemeinsam zu benutzen ist.

Parameter

NAME

Der Name des zu schreibenden TemSe-Objekts. Für Namen von TemSe-Objekten gibt es Konventionen, aus denen sich auch die Berechtigungen ableiten. Siehe auch Tabelle TST07.

Weitere optionale Parameter

ALLINE

Wenn 'ALLINE' auf 'X' gesetzt wird, dann werden alle Zeilen mit einer Vorspalte versehen. Die bei 'RSTS_WRITE' uebergebenen Daten müssen dann auch mit dieser Vorspalte beginnen. Mit dieser Vorspalte können eingesteute Spezialzeilen von normalen Datenzeilen unterschieden werden.

Andernfalls werden nur normale Zeilen geschrieben.

CHARCO

Der Zeichensatz in dem die Daten angeliefert werden. Normalerweise wird der Systemzeichensatz benutzt.

LIFEHOURS

Wann das TemSe-Objekt verfallen soll und von einer automatischen Aufräumaktion geloescht werden darf. (Gemessen in Stunden ab jetzt.)

Die Angabe eines Sterns ('*') bedeutet unbegrenzte Lebensdauer. Überlegen Sie dann aber, wer sicherstellt, daß das Objekt wieder gelöscht wird.

NO_ROLLBACK

Normalerweise unterliegt das Schreiben von TemSe-Objekten wie alle Schreib-Operationen in der Datenbank dem Transaktionskonzept: nach COMMIT sind die Daten wirklich geschrieben. Bei ROLLBACK wird alles ungeschehen gemacht, was seit dem letzten COMMIT passiert ist.

Wenn NO_ROLLBACK = 'X' angegeben wird, bleiben die geschriebenen TemSe-Daten auch im Falle eines ROLLBACKs erhalten.

Achtung: Die Eigenschaft NO_ROLLBACK verlangt derzeitig, dass das TemSe-Objekt in Datei(en) gespeichert ist; siehe 'PATH'.

PATH

Mit diesem Parameter kann beeinflusst werden, wo das TemSe-Objekt gespeichert werden soll. Es stehen vier Moeglichkeiten offen:
db : Die Daten sollen in der Datenbank gespeichert werden.
&G : Die Daten sollen in Dateien im globalen SAP-Directory gespeichert werden.
&L : Die Daten sollen in Dateien in einem lokalen SAP-Directory auf dem Applikationsserver gespeichert werden. Diese Bearbeitungsweise ist oft wesentlich schneller. Allerdings sind die Daten dann von anderen Applikationsservern aus nicht sichtbar. Dort einen Leseversuch zu starten wird dann mit einem Datei-Lesefehler abgelehnt werden.
sonst ist in PATH der Pfadname anzugeben, wo die Datei mit den Daten gespeichert werden soll. (Achtung: zur Zeit ist dieser Pfadname mit 12 Zeichen sehr kurz.)

PROM

Der Verarbeitungsmodus. Es stehen drei zur Wahl:

Modus	Bearbeitung in
'I'	diesem internen Modus
'E'	allen internen dieses externen Modus
'W'	diesem Workprozeß.

Dazu zwei Anmerkungen:
Die Anzahl der der TemSe-Objekte, die im Verarbeitungsmodus 'E' während einer Datenbanktransaktion geoeffnet werden koennen, ist begrenzt.
Den Modus 'W' sollte niemand benutzen, der sich nich ganz genau über die Folgen im klaren ist.

RECTYP

Die Satzart.

OBJTYPE

Der Datentyp des Objekts.

AUTHORITY

Name der Funktion oder Transaktion, die bereits die notwendigen Berechtigungen geprüft hat.

ENQLOCK

Der Sperrmodus des Objekts. Standardwert ist nicht per Equeue sperren.

Mögliche Werte sind 'N' falls nicht gesperrt werden soll (diese Angabe ist kompatibel zur bisherigen Implementierung).

Die Angabe 'E' setzt eine exklusive Enqueuesperre bis zum Aufruf des zugehörigen RSTS_CLOSE. Damit wird (falls alle Bearbeiter den Parameter benutzen) das mehrfache Öffnen zum Schreiben eines TemSe Objekts verhindert.

Parameter

ALLINE
AUTHORITY
CHARCO
ENQLOCK
FBHANDLE
LIFEHOURS
NAME
NO_ROLLBACK
OBJTYPE
OWN_FBHANDLE
PATH
PROM
REALNAME
RECTYP

Ausnahmen

ENQ_FOREIGN_LOCK
ENQ_OTHER
ENQ_SYS_FAIL
FB_CALL_HANDLE
FB_ERROR
FB_RSTS_NOCONV
FB_RSTS_OTHER
NO_OBJECT
NO_PERMISSION

Funktionsgruppe

STMS

BAL Application Log Documentation   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6597 Date: 20240523 Time: 090254     sap01-206 ( 99 ms )