OPEN-MSG-FILE - Meldungsdatei eröffnen

Funktion

Mit der Anweisung //OPEN-MSG-FILE wird eine Meldungsdatei zur Bearbeitung eröffnet.

Die Meldungsdatei bleibt solange eröffnet, bis eine andere Datei eröffnet oder MSGMAKER beendet wird.

Die Anweisung //OPEN-MSG-FILE muss nicht vor jeder Dateibearbeitung angegeben werden. In den Anweisungen //COPY, //MOVE und //SHOW kann über den Operanden FROM-FILE, bei //MERGE-MSG-FILES über die Operanden FILE-NAMES und TO-FILE direkt auf eine Meldungsdatei zugegriffen werden.

Unterschiede zum Menümodus

Die Eingabe dieser Anweisung ist im Menümodus nicht möglich, da nur eine Meldungsdatei zur gleichen Zeit geöffnet sein kann.

Format

OPEN-MSG-FILE

FILE-NAME = <filename 1..54>
,MODE = *UPDATE(...) / *CREATE(...) / *READ
	UPDATE(...)
		|	TYPE = *UNCHANGED / *CUSTOMER / *STANDARD
		|	,PRODUCT = *UNCHANGED (...) / <structured-name 1..15>(...) / *NONE
		|		*UNCHANGED(...)
		|			|	VERSION = *UNCHANGED / <composed-name 3..8> / <c-string 1..8> / *NONE
		|		<structured-name 1..15>(...)
		|			|	VERSION = *UNCHANGED / <composed-name 3..8> / <c-string 1..8> / *NONE
	CREATE(...)
		|	TYPE = *CUSTOMER / *STANDARD
		|	,PRODUCT = *NONE / <structured-name 1..15>(...)
		|		<structured-name 1..15>(...)
		|			|	VERSION = *NONE / <composed-name 3..8> / <c-string 1..8>

Operanden

FILE-NAME = <filename 1..54>
Gibt den Namen der Meldungsdatei an, die zur Bearbeitung eröffnet werden soll. Diese Datei ist solange aktuelle Datei, bis eine andere Datei geöffnet wird.

MODE = *UPDATE(...) / *CREATE(...) / *READ
Gibt den Modus an, in dem die Meldungsdatei eröffnet werden soll.

 

MODE = *UPDATE(...)
Die Meldungsdatei ist bereits katalogisiert und soll aktualisiert werden.

TYPE = *UNCHANGED / *CUSTOMER / *STANDARD
Gibt die Art einer bereits bestehenden Meldungsdatei an.

TYPE = *UNCHANGED
Die Art der Meldungsdatei wird nicht verändert.

Die Umwandlung einer Standard-Meldungsdatei in eine kundeneigene Meldungsdatei durch Angabe von MODE=UPDATE(TYPE=CUSTOMER) ist nicht möglich. Die Umwandlung einer kundeneigenen Meldungsdatei in eine Standard-Meldungsdatei ist ohne weiteres möglich.

TYPE = *CUSTOMER
Die Meldungsdatei wird einem Kundenprodukt zugeordnet.

TYPE = *STANDARD
Die Meldungsdatei bezieht sich auf ein Software-Produkt, das beim Hersteller entwickelt wurde.

PRODUCT = *UNCHANGED(...) / <structured-name 1..15>(...) / *NONE
Name und Version des Software-Produkts, auf das sich die aktuelle Meldungsdatei bezieht. Die eingegebenen Buchstaben werden immer in Großbuchstaben umgewandelt.

PRODUCT = *UNCHANGED(...)
Der Name des Software-Produkts wird nicht verändert.

VERSION = *UNCHANGED / <composed-name 3..8> / <c-string 1..8> / *NONE
Version des Produkts. Die Angabe wird immer in Großbuchstaben umgewandelt.

PRODUCT = <structured-name 1..15>(...)
Neuer Name des Produkts, auf das sich die aktuelle Meldungsdatei bezieht.

VERSION = *UNCHANGED / <composed-name 3..8> / <c-string 1..8> / *NONE
Version des Produkts. Die Angabe wird immer in Großbuchstaben umgewandelt.

PRODUCT = *NONE
Dem Produkt wird weder ein Name, noch eine Version zugewiesen.

MODE = *CREATE(...)
Eine neue Meldungsdatei wird katalogisiert und zur aktuellen Arbeitsdatei.

TYPE = *CUSTOMER / *STANDARD
Legt fest, ob die Meldungsdatei zu einem kundeneigenen Produkt oder zu einem BS2000-Produkt gehört.

TYPE = *CUSTOMER
Die Meldungsdatei bezieht sich auf ein kundeneigenes Produkt.

TYPE = *STANDARD
Die Meldungsdatei bezieht sich auf ein Software-Produkt, das beim Hersteller entwickelt wurde.

 

PRODUCT = *NONE / <structured-name 1..15>(...)
Bezeichnet Name und Version des Produkts, auf welches die aktuelle Meldungsdatei Bezug nimmt.

PRODUCT = *NONE
Dem Produkt wird weder ein Name, noch eine Version zugewiesen.

PRODUCT = <structured-name 1..15>(...)
Name des Produkts, auf das sich die Meldungsdatei bezieht.

VERSION = *NONE / <composed-name 3..8> / <c-string 1..8>
Version des Produkts. Die eingegebenen Buchstaben werden immer in
Großbuchstaben umgewandelt.

MODE = *READ
Die Meldungsdatei ist nur zum Lesen geöffnet; es können keine Änderungen vorgenommen werden.

Beispiel

Meldungsdatei erzeugen:

//OPEN-MSG-FILE FILE-NAME=SYSMES.TSTFILE,MODE=CREATE(TYPE=STANDARD,-
   PRODUCT=TSTPROD(VERSION=V01.0A10))

Meldungsdatei aktualisieren:

//OPEN-MSG-FILE SYSMES.TSTFILE,(PRODUCT=*UNCHANGED('V1.0A10'))