Create/modify MIP parameter file, add/remove message files
Component: | MIP |
Functional area: | Message processing |
Domain: | MESSAGE-PROCESSING |
Privileges: | TSOS |
Function
The MODIFY-MIP-PARAMETERS command is used to modify the message file allocation table and the MIP parameter file and to create a new MIP parameter file. It can also add message files to the system and remove them from it. Any changes that are made apply throughout the system.
The SHOW-MIP-PARAMETERS command supplies information on the current settings of the MIP parameter file.
Note
The command will be processed even if a message file specified for removal is not in the message file allocation table.
Format
MODIFY-MIP-PARAMETERS | ||||||||||||||||||||
| ||||||||||||||||||||
Operands
SCOPE = *TEMPORARY / *PERMANENT / *NEXT-SESSION(...)
Defines how long the modification will remain in effect.
SCOPE = *TEMPORARY
Only the message file allocation table which applies in the current system session is modified. That means that any changes that are made apply system-wide to the current system session only and have no effect on future sessions.
SCOPE = *PERMANENT
Both the message file allocation table and the default MIP parameter file are modified. That means that the changes apply system-wide both to the current session and to future sessions.
If it is not possible to modify the MIP parameter file owing to an error (e.g. MIP parameter file locked, not enough space on the disk, DMS error), only the message file allocation table will be modified. In this case, the cause of the error must be eliminated, and then the command must be issued again.
SCOPE = *NEXT-SESSION(...)
The specified MIP parameter file is modified. The name of the message file is stored in the MIP parameter file. No check is made to ensure that the message file actually exists and is in the correct format.
If it is not possible to modify the MIP parameter file owing to an error (e.g. MIP parameter file locked, not enough space on the disk, DMS error), the cause of the error must be eliminated, and then the command must be issued again.
PARAMETER-FILE = *CURRENT / <filename 1..54 without-gen>
Identifies the MIP parameter file that is to be modified.
PARAMETER-FILE = *CURRENT
The default MIP parameter file SYSPAR.MIP.vvv (vvv = current version) is to be modified.
PARAMETER-FILE = <filename 1..54 without-gen>
Name of the MIP parameter file that is to be modified. If there is no MIP parameter file by this name, a new file will be created.
ADD-MSG-FILE = *NONE / <filename 1..54 without-gen>
Specifies the name of the message file which is to be activated or added to a parameter file. If the command is issued for a message file which is already active or included in a MIP parameter file, the message file is activated again or assigned top priority in the MIP parameter file (first position in the message file allocation table or MIP parameter file).
ADD-MSG-FILE = <filename 1..54 without-gen>
A file name alias defined using ACS is expanded to the full file name (including catalog and user ID) and stored in that form in the message file allocation table or MIP parameter file. If the name is not an alias, the specified file name is stored in the MIP parameter file “as is” (i.e. without the catalog and user IDs if these have not been specified).
REMOVE-MSG-FILE = *NONE / <filename 1..54 without-gen>
Specifies the name of the message file which is to be deactivated.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
2 | 0 | NMH1129 | Warning |
32 | NMH1121 | Internal error | |
32 | NMH1125 | System error | |
32 | NMH1181 | System error | |
64 | CMD0216 | Semantic error | |
64 | NMH1133 | Semantic error |