Use this command to do the following:
- Define a new MPIF device
- Change an existing MPIF device definition
- Display information about the MPIF devices that are defined for the next
initial program load (IPL).
Requirements and Restrictions
- New and changed device definitions do not take effect until the next
IPL.
- You can define or change device definitions only after MPIF restart is
completed. Before and during MPIF restart, you can use this command
only to display information about the definitions.
- Enter the ZMPIF SET CLASS command before you define any MPIF devices for
that class.
- If your loosely coupled complex includes processors that are using a TPF
image with 32-way loosely coupled processor support and other processors that
are using images that do not include 32-way loosely coupled processor support,
be aware of the following:
- If the command is entered on a processor that does not include 32-way
loosely coupled processor support, any definitions that are entered must be
reentered when 32-way loosely coupled processor support is installed on the
processor.
- If the command is entered on a processor that includes 32-way loosely
coupled processor support, any definitions that are entered will be lost and
must be reentered if you fall back to a previous level of support on that
processor. If you restore 32-way loosely coupled processor support
after falling back to the previous level, the new definitions are also
restored.
Format
Notes:
- Separate each set of 8 class codes with the / character.
- Name-$device
- is a 1- to 7-character alphanumeric generic device name that begins with
the $ character.
- Note:
- You must specify this parameter when you define a new device or change an
existing device definition. The device name that you specify cannot
already be defined as a path name.
- SDA-links/address
- is the addressing range for the device, where links is an even
number of physical links (NL) and address is a 4-digit hexadecimal
starting symbolic device address (SDA).
A 3088 device can have from 2-64 physical links. An
Enterprise Systems Connection (ESCON) channel in CTC mode can have from
2-512 physical links.
- Note:
- You must specify this parameter when you define a new device.
- Model-number
- is a 1- to 2-character model number for the device.
The valid model numbers for 3088 devices are 1, 1A, and 2. The valid
model number for an ESCON channel in CTC mode is C.
- Class-code
- is a 1-character alphanumeric code that identifies the path class for the
device. You can specify as many as 36 different class codes.
- STatus
- specifies the IPL status for the device, where:
- ONline
- starts the device when you perform an IPL.
- OFFline
- does not start the device when you perform an IPL. (You must enter
the ZMPIF START command to start an offline device.)
Additional Information
- Online help information is available for this command. To display
the help information, enter ZMPIF DEFINE HELP.
- You can specify the parameters for this command in any order.
- To define a new device, you must specify both the NAME and SDA
parameters.
- To change an existing device definition, you must specify the NAME
parameter and any other parameters that you want to change.
- Enter ZMPIF DEFINE DEVICE (with no parameters) to display the
devices that are defined for the next IPL.
- To display the device definition for a specific device, specify only the
NAME parameter.
- To change the name of a device, enter the ZMPIF DELETE command to delete
the device and then enter the ZMPIF DEFINE DEVICE command to redefine the
device.
- To display information about the devices that are currently defined, enter
ZMPIF DISPLAY DEVICE.
Examples
The following information is displayed in the examples:
- DEV-NAME
- is the name of the device.
- MOD
- is the model number of the device.
- NL
- is the number of physical links defined for the device.
- SDA
- is the symbolic device address range for the device.
- STATUS
- is the status of the device, which can be:
- ONLINE
- Device is started when an IPL is performed.
- OFFLINE
- Device is not started when an IPL is performed.
- CLASS
- is the path classes assigned to the device.
Information about the devices that are defined for the next IPL is
displayed in the following example.
+--------------------------------------------------------------------------------+
|User: ZMPIF DEF DEV |
| |
|System: MPIF0018I 06.56.47 DEVICE PARAMETERS DEFINED |
| DEV-NAME MOD NL SDA STATUS CLASS |
| $CTOC01 C 16 0900/090F ONLINE ABC |
| $CTOC02 C 16 0A00/0A0F ONLINE ABC |
| $CTOC03 2 4 0388/038B ONLINE ABC |
| $CTOC04 2 4 03A8/03AB ONLINE ABC |
| $CTOC05 2 8 1388/138F ONLINE ABC |
| $CTOC06 2 20 13A8/13BB ONLINE ABC |
| $CTOC07 2 4 238C/238F ONLINE ABC |
| $CTOC08 2 4 23B8/23BB ONLINE ABC |
| $CTOC09 2 20 33A4/33B7 ONLINE ABC |
| $CTOC10 2 20 43A0/43B3 ONLINE ABC |
| $CTOC11 2 16 53A0/53AF ONLINE ABC |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
A new device is defined in the following example.
+--------------------------------------------------------------------------------+
|User: ZMPIF DEF DEV,N-$3088G00,M-2,SDA-32/0230,CL-B |
| |
|System: MPIF0018I 06.56.47 DEVICE PARAMETERS DEFINED |
| DEV-NAME MOD NL SDA STATUS CLASS |
| $3088G00 2 32 0230/024F ONLINE B |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
The path class of the device that was defined in the previous example is
changed to B and C in the following example.
+--------------------------------------------------------------------------------+
|User: ZMPIF DEF DEV,N-$3088G00,CL-BC |
| |
|System: MPIF0018I 06.56.47 DEVICE PARAMETERS DEFINED |
| DEV-NAME MOD NL SDA STATUS CLASS |
| $3088G00 2 32 0230/024F ONLINE BC |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
Related Information
See TPF Multi-Processor Interconnect Facility
Reference for more information about MPIF.