SYSIMG Control Statement

The SYSIMG control statement directs EREP to process records by system image rather than CPU address.

Use SYSIMG control statements as follows:

To request a report with records from a central processor complex (CPC) with more than one internal processor(CP).
To define the CPs in a physically partitioned CPC as system images.
To define the physical CPs associated with a logical partition as system images. See PR/SM Feature for information on logical partitioning.
When message IFC201I in the EREP messages (TOURIST) indicates that records are being ignored due to an excessive number of CPUs.

An n-way CPC produces up to n different CPU identification numbers. Use the SYSIMG control statement to group the CPU identification numbers into system images. Without a SYSIMG statement, EREP can process records from only 16 CPUs, with the following exceptions:

PRINT=PT can process records from an unlimited number of CPUs
EVENT can process records from 256 CPUs
SYSEXN can process records from 255 CPUs
SYSUM and TRENDS can group all CPUs after the first 15 under serial number X'FFFFFF'

System image processing involves replacing the CP address with a control digit (either E or F) during record processing. The CP addresses are changed as follows:

To F for a single-image CPC
To either F or E depending on the order of the SYSIMG control statements for a physically partitioned CPC

The CPU table at the end of system or subsystem reports reflects these changes. The changes occur in the internal EREP tables and output, no external records are changed.

Indicates

That records are processed by specific system images rather than CPU identification number.

Syntax


>>-SYSIMG BASESN=----------------------------------------------->

>--+-ALL---------------------------------------------------+---><
   '-sssss--+-------------------+--+---------------------+-'   
            '-,--CPCTYPE=--tttt-'  |               .-.-. |     
                                   |               V   | |     
                                   '-,--CP=--n--.----n-+-'

ALL: Indicates that all processor complexes are single images (no physical or logical partitions) or all I/O devices have unique identifiers in their sense (unique addresses or device numbers).
sssss: Is the 5-digit serial number of a specific CPC. When the processor resource/system manager (PR/SM) feature is used to create logical partitions the high-order digit must be the same as the PR/SM partition identifier. See PR/SM Feature for information on logical partitioning.
tttt: Is the 4-digit processor type.
n: A single hexadecimal digit identifying the CPs in this system image.

Defaults

None.

If you omit this control statement EREP processes all records by the CPU identification number and machine type (CPUID).

Coding

One control statement is sufficient for all system images, when BASESN=ALL is specified.
Important: By coding BASESN=ALL when devices do not have unique physical identifiers or unique addresses, you may cause incorrect or invalid results.
There are no more than two system images per CPC unless logical partitioning is available.
Code CPCTYPE= if there are records from processors with different machine types, but the same CPU identification numbers.
SYSIMG controls apply to all report parameters except PRINT= as follows:
- SYSIMG controls does not affect the PRINT=PT parameter.
- SYSIMG controls apply for all other PRINT= selections when records are read from a history file.
- SYSIMG controls do not apply when PRINT= is specified and records are read from the error recording data set.
  Important: No message is issued in this case.

Notes

BASESN=ALL is particularly useful when producing reports on I/O devices with unique addresses or device numbers.
Important: Do not use BASESN=ALL when reports include software or MIH records from partitioned CPCs.
If the normal mode of operation is to physically partition the CPC during a reporting interval and the I/O devices do not have unique identifiers, then define each partition as a separate image system.
The DASDID and SHARE control statements do not require changes when you use SYSIMG. EREP changes the high-order digit of the CPU serial number in the internal tables created by the DASDID and SHARE control statements.
EREP issues message IFC262I to the EREP messages (TOURIST) informing the user that the CPU serial numbers in the CPU table have been modified as a result of the SYSIMG control statement.

Examples

The following example shows you how to code SYSIMG control statements:

Code as follows if all I/O units in the complex can be identified by unique identifiers within their sense data:

SYSIMG BASESN=ALL

This defines all CPCs as single images and changes the first two digits of the serial numbers in the CPU table to FF.