MODIFY-MSG-FILE-ASSIGNMENT

Define message files for task

Component:	MIP
Functional area:	Message processing
Domain:	MESSAGE-PROCESSING
Privileges:	STD-PROCESSING OPERATING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION TSOS
Routing code:	E

Function

The MODIFY-MSG-FILE-ASSIGNMENT command enables the user to activate and deactivate additional message files (task message files) for his task.
The SHOW-MSG-FILE-ASSIGNMENT command displays the activated message files. The user can set the language for message output task-specifically by means of the MODIFY-MSG-ATTRIBUTES command.

Privileged functions

Systems support (TSOS or OPERATING privilege) can use SCOPE=*SYSTEM to activate and deactivate message files on a system-global basis. Changes apply only to the current session (equivalent to the MODIFY-MIP-PARAMETERS command with SCOPE= *TEMPORARY). Systems support can use the MODIFY-MIP-PARAMETERS command to make permanent changes.

Format

MODIFY-MSG-FILE-ASSIGNMENT                                                                                                          

ADD-FILE = *NO / list-poss(8): <filename 1..54 without-gen>

,REMOVE-FILE = *NO / list-poss(8): <filename 1..54 without-gen>

,SCOPE = *STD / *SYSTEM / *TASK

Operands

ADD-FILE = *NO / list-poss(8): <filename 1..54 without-gen>
Names of the message files to be activated. Up to 8 files may be specified. The message files activated in this way can be displayed via the SHOW-MSG-FILE-ASSIGNMENT command.
Message files are created by using the MSGMAKER utility routine (see the “Utility Routines” manual [9]).

REMOVE-FILE = *NO / list-poss(8): <filename 1..54 without-gen>
Names of the message files to be deactivated. Up to 8 files may be specified. Only files that are activated as message files can be deactivated.

SCOPE = *STD / *SYSTEM / *TASK
Applicability of the command.

SCOPE = *STD
The applicability of the command is *TASK for nonprivileged users and *SYSTEM for privileged users.

SCOPE = *TASK
The changes apply only to the calling task.

SCOPE = *SYSTEM
This value can only be specified by privileged users.
Specifies that the modifications made in the range assignment list are to have a global system effect and are not restricted to the calling task. The changes apply only to the current session. Systems support can use the MODIFY-MIP-PARAMETERS command to make permanent changes.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	No error Guaranteed messages: NMH1102, NMH1109, NMH1180, NMH1183
	1	NMH1174	Syntax error
	32	NMH1121	Internal error
	32	NMH1181	Error in file processing Guaranteed messages: NMH1103, NMH1104, NMH1105, NMH1106, NMH1108, NMH1181
	64	CMD0216	Semantic error
	64	NMH1150	No authorization for command