OPEN-MSG-FILE - Open message file

Function

The //OPEN-MSG-FILE statement opens a message file for processing.

The message file remains open until another file is opened or until MSGMAKER is terminated.

The //OPEN-MSG-FILE statement does not always have to be issued before a file can be processed. In the COPY, MOVE and SHOW functions, a message file can be accessed directly by means of the FROM-FILE operand and in MERGE-MSG-FILES functions by means of the FILE-NAMES and TO-FILE operands.

Differences to menu mode

This statement cannot be entered in menu mode since only one message file can be open at any one time.

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>

Operands

FILE-NAME = <filename 1..54>
Specifies the name of the message file that is to be opened for processing. This file remains the current file until another file is opened.

MODE = *UPDATE(...) / *CREATE(...) / *READ
Specifies the mode in which the message file is to be opened.

 

MODE = *UPDATE(...)
The message file is already cataloged and is to be updated.

TYPE = *UNCHANGED / *CUSTOMER / *STANDARD
Specifies the type of an existing message file.

TYPE = *UNCHANGED
The message file type remains unchanged.

It is not possible to convert a standard message file into a customer message file by specifying MODE=*UPDATE(TYPE=*CUSTOMER).A customer message file, however, can be converted into a standard message file without restrictions.

TYPE = *CUSTOMER
The message file is assigned to a customer product.

TYPE = *STANDARD
The message file is associated with a software product developed by the manufacturer.

PRODUCT = *UNCHANGED(...) / <structured-name 1..15>(...) / *NONE
Name and version of the software product with which the current message file is associated. The letters entered are always converted to uppercase.

PRODUCT = *UNCHANGED(...)
The name of the software product remains unchanged.

VERSION = *UNCHANGED / <composed-name 3..8> / <c-string 1..8> / *NONESpecifies the product version. Letters entered are always converted to uppercase.

PRODUCT = <structured-name 1..15>(...)
New name of the product with which the current message file is associated.

VERSION = *UNCHANGED / <composed-name 3..8> / <c-string 1..8> / *NONE
Specifies the product version. Letters entered are always converted to uppercase.

PRODUCT = *NONE
No name or version is assigned to the product.

MODE = *CREATE(...)
A new message file is cataloged and becomes the current work file.

TYPE = *CUSTOMER / *STANDARD
Specifies whether the message file is associated with a customer product or a BS2000 product.

TYPE = *CUSTOMER
The message file is associated with a customer product.

TYPE = *STANDARD
The message file is associated with a software product developed by the manufacturer.

 

PRODUCT = *NONE / <structured-name 1..15>(...)
Specifies the name and version of the product with which the current message file is associated.

PRODUCT = *NONE
No name or version is assigned to the product.

PRODUCT = <structured-name 1..15>(...)
Name of the product with which the message file is associated.

VERSION = *NONE / <composed-name 3..8> / <c-string 1..8>
Specifies the product version. The letters entered are always converted to uppercase.

MODE = *READ
The message file is opened for read access only and must not be modified.

Example

Generate message file:

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

Update message file:

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