Using IBM Z OMEGAMON AI for z/OS commands
Using the prefix M5:, you can issue a set of product-provided commands to terminate or alter the execution attributes of an address space.
Use the M5: prefix to issue any of the following commands as a Take Action command.
Note: The colon (:) following the prefix is mandatory.
| Command name | Description | Required parameters |
|---|---|---|
| CANCEL | Cancel address space | ASNAME, ASID/ASIDX, ASTYPE |
| CANCELDUMP | Cancel address space with dump | ASNAME, ASID/ASIDX, ASTYPE |
| CANCELRESTART | Cancel address space with restart | ASNAME, ASID/ASIDX, ASTYPE |
| CANCELDUMPRESTART | Cancel address space with dump and restart | ASNAME, ASID/ASIDX, ASTYPE |
| CHANGETIMELIMIT | Change step CPU time limit | ASID or ASIDX, Time |
| KILL | Kill a job or user with a system A22 abend. | Address space name, address space ID (ASID), or hexadecimal address space ID (ASIDX) |
| MARKSWAPPABLE | Mark swappable | ASID, ASIDX |
| MARKNONSWAPPABLE | Mark nonswappable | ASID, ASIDX |
| RESETSC | Reset address space | ASNAME, ASID/ASIDX, SRVCLASS |
| RESUME | Resume address space | ASNAME, ASID/ASIDX |
| QUIESCE | Quisce address space | ASNAME, ASID/ASIDX |
| SWAPIN | Swap in | ASID, ASIDX |
The syntax for the commands is:
M5:command_name,keyword1=value1,keyword2=value2,...- ASName
- Value is an address name of up to 8 characters.
- ASID
- Valid value is a decimal ASID number.
- ASIDX
- Valid value is a hexadecimal ASID number.
- ASType
- Address Space Type
- 1=BATCH
- 2=TSO
- 3=STC
- 4=APPC
- 5=OMVS
- SRVCLASS
- Service Class Name
- Time
- The value is expressed in the following format:
{+|-}nnnnS|M|H, where:- + adds time
- - subtracts time
- Absence of + and - sets the CPU time limit to the value specified
- nnnnS is the time in seconds
- nnnnM is the time in minutes
- nnnnH is the time in hours
Note: The command names and the keywords are NOT
case-sensitive.
For more information on using Take Action commands, see the IBM Tivoli® Monitoring: Tivoli Enterprise Portal User’s Guide or the Tivoli Enterprise Portal online help.
Command examples
To kills job JFTESTXX, ASID 64, use:
M5:Kill ASName=JFTESTXX,ASID=64
To make ASID 64 nonswappable, use:
M5:MarkNonSwappable ASID=64
To add 60 minutes to the step CPU time limit,
use:
M5:ChangeTimeLimit ASID=64,Time=+60M
To set the step CPU time limit to 45 seconds,
use:
M5:ChangeTimeLimit ASID=64,Time=45