Use the MODIFY WLM,GPMP command to start, stop and
modify options of the guest platform management provider (GPMP).
The complete syntax for the MODIFY WLM,GPMP command is:
F WLM,GPMP,{START|STOP|TRACE=LOW|MEDIUM|HIGH[,DEST=FILE|MEMORY]}
|
- WLM
- The name of the job.
- GPMP
- Indicates that you can start, stop and modify options of the
guest platform management provider manually.
- START
- Indicates that WLM starts the guest platform management
provider.
- If the GPMP is already active, message IWM077E is issued.
- If ARM is disabled, message IWM078E is issued.
For details about messages IWM077E and IWM078E, see z/OS MVS System Messages, Vol 9 (IGF-IWM).
- STOP
- Indicates that WLM stops the currently active guest platform
management provider instance.
WLM does not automatically restart
the guest platform management provider even if the WLM policy contains
a valid guest platform management provider configuration. The guest
platform management provider is restarted only if the MODIFY WLM,GPMP,START
command is issued from the MVS console. Even in the case of an activation
of a new policy that contains a valid guest platform management provider
configuration, it is not restarted. The DISPLAY WLM,SYSTEMS operator
command indicates that situation with a status of “STOPPED”.
When the instance of the guest platform management provider terminates
unexpectedly or when too many errors occur, the state in the DISPLAY
WLM,SYSTEMS command is set to “FAILED”.
- TRACE=LOW|MEDIUM|HIGH
- Enables the operator to dynamically change the level of trace
data being collected for the guest platform management provider. By
default, the guest platform management provider runs with a low trace
level. Change this trace setting only under the direction of IBM Support.
- DEST=FILE|MEMORY
- Enables the operator to dynamically change the destination of
trace data being collected. By default, the guest platform management
provider writes trace data to memory. Change this trace setting only
under the direction of IBM Support.
Example:
Only when IBM Support personnel request you to collect
the guest platform management provider trace data that is required
to diagnose a problem, issue the MODIFY WLM command to alter the trace
level and destination for trace data:
MODIFY WLM,GPMP,TRACE=HIGH,DEST=FILE
The system responds with messages FEW0614I and FEW0612I:
FEW0614I TRACE LEVEL CHANGED FROM LOW TO HIGH.
FEW0612I TRACE DESTINATION CHANGED FROM MEMORY TO FILE.
Once
these trace settings are changed, the values persist even if you restart
the guest platform management provider or if you re-IPL, so you must
reset them to prevent the file system from filling up with unnecessary
trace data.
After collecting the trace data as instructed by
IBM Support, reset the trace level and destination for trace data:
MODIFY WLM,GPMP,TRACE=LOW,DEST=MEMORY