Show information on past live migrations
Component: | AIDSYSA |
Functional area: | System control and optimization |
Domain: | SYSTEM-MANAGEMENT |
Privileges: | STD-PROCESSING |
Routing code: | @ |
Function
The SHOW-LIVE-MIGRATION-HISTORY command provides information on previous live migrations and on associated live migration variable data.
The information supplied is live migration-atomic, i.e. if command processing takes place in parallel to a live migration, this live migration is either contained in full or not at all in the information supplied.
Format
SHOW-LIVE-MIGRATION-HISTORY | ||||||||||||||||||||||||
| ||||||||||||||||||||||||
Operands
SERVER-UNIT = *ALL / *CURRENT / *PREVIOUS / *INITIAL / *INTERVAL(...) / list-poss(10): <x-text 1..7>
Defines the set of systems which are run through during live migrations and on which the information is to be provided.
SERVER-UNIT = *ALL
Information for all live migrations is requested.
Within the system, only live migrations up to a maximum number are logged in the live migration history. If this number is exceeded, the data of the oldest live migration is lost and is no longer displayed.
SERVER-UNIT = *CURRENT
Information for the current system is requested.
SERVER-UNIT = *PREVIOUS
Information for the previous system is requested.
SERVER-UNIT = *INITIAL
Information for the initial system is requested, the system in which system initialization was performed (IPL host system).
SERVER-UNIT = *INTERVAL(...)
Information for a range of live migrations is requested.
FROM = *INITIAL / *PREVIOUS / <x-text 1..7>
Defines the range limit.
FROM = *INITIAL
Information starting with the initial system is requested.
FROM = *PREVIOUS
Information starting with the previous system is requested.
FROM = <x-text 1..7>
Information starting with the specified count value is requested.
The value 0 (output for LM-COUNT) corresponds to the initial system.
TO = *CURRENT / *PREVIOUS / *SAME / <x-text 1..7>
Defines the upper limit of the range.
TO = *CURRENT
Information up to and including the current system is requested.
TO = *PREVIOUS
Information up to and including the previous system is requested.
TO = *SAME
Information solely on the lower limit of the range is requested.
TO = <x-text 1..7>
Information up to the specified count value is requested.
The value 0 (output for LM-COUNT) corresponds to the initial system.
SERVER-UNIT = <x-text 1..7>
Information for the live migration with this count value is requested.
The value 0 corresponds to the initial system, the system in which system initialization was performed (IPL host system).
INFORMATION = *SUMMARY / *ALL / list-poss(4): *CONFIGURATION / *CPU-ID-LIST /
*VM2000-IDENTIFICATION / *IOCONF-IDENTIFICATION
Defines the output volume.
INFORMATION = *SUMMARY
Only summary information is displayed.
INFORMATION = *ALL
All available information is displayed.
INFORMATION =* CONFIGURATION
The system configuration name is displayed.
INFORMATION =*CPU-ID-LIST
A list of all CPUs is displayed.
INFORMATION = *VM2000-IDENTIFICATION
If available, VM2000 information is displayed.
INFORMATION = *IOCONF-IDENTIFICATION
If available, IORSF information is displayed.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed successfully | |
1 | IDA0300 | Syntax error | |
32 | CMD0221 | system error | |
64 | IDA0301 | Semantic error |
Output formats
Display of the summary
/show-live-mig-hist serv-unit=*all,inf=*summ
LM-COUNT DATE TIME CONFIGURATION VM 00000000 yyyy-mm-dd hh:mm:ss cccccccccccccccc dd 00000001 yyyy-mm-dd hh:mm:ss cccccccccccccccc dd 00000002 yyyy-mm-dd hh:mm:ss cccccccccccccccc dd :
One line is displayed in the summary for each logged live migration.
Display of all available information
/show-live-mig-hist serv-unit=*all,inf=*all
LM-COUNT DATE TIME 00000000 yyyy-mm-dd hh:mm:ss --------------------- CONFIGURATION ------- CONFIGURATION = cccccccccccccccc --------------------- CPU-ID-LIST --------- CPU xx = xxxxxxxx xxxxxxxx : CPU xx = xxxxxxxx xxxxxxxx --------------------- VM2000-IDENTIFICATION VM-INDEX = dd VM2000-VERSION = cccccc VM2000-MONITOR-NAME = cccccccc VM2000-MONITOR-OSD = cccccccccc --------------------- IOCONF-IDENTIFICATION NAME = cccccccc VERSION = ccccccccc CREATED = yyyy-mm-dd,hh:mm:ss FORMAT = ccccccc =========================================== LM-COUNT DATE TIME 00000001 yyyy-mm-dd hh:mm:ss --------------------- CONFIGURATION ------- : =====================================
There is a separate section for each system selected with the SERVER-UNIT operand. The section begins with an abbreviated summary format entry. This is followed by the display of further information as specified in the INFORMATION operand. The section ends with a line of double bars. This is followed by the section for the next system, if available.
Info column | Meaning |
|---|---|
Summary output | |
| Live migration counter (hexadecimal); The value 0 means the initial system. |
| Date of live migration (or system initialization) |
| Time of live migration (or system initialization) |
| System configuration name (16 characters); The last 5 bytes of the system configuration name are cut |
| VM index; The value 0 means native operation (without VM2000). |
Short Summary output | |
| see “summary output” |
CONFIGURATION output | |
| System configuration name (16 characters); The last 5 bytes (model properties) of the complete name are cut |
CPU-ID-LIST output | |
| Internal presentation (8 bytes) as provided by the hardware, in printable format (16 characters). The identifications are output as they exist in the system. |
VM2000-IDENTIFICATION output | |
| VM index; The value 0 means native operation (without VM2000). |
| Version in DOD format, e.g. 'V11.5A' |
| BCAM name of the monitor system, e.g. 'D027ZE01' |
| Version of the monitor system in DOD format, e.g. 'V11.5A0000' |
IOCONF-IDENTIFICATION output | |
| Program name of the current IOCF (8 bytes, left-aligned), e.g. 'BS2V190' |
| Version from the current IOCF, e.g. 'V20.0A00 |
| Generation date and time of IO configuration in ISO4 format |
| IOCF format (7 bytes) |