gtpo1m9jOperations

ZMPIF DEFINE DEVICE-Define a MPIF Device

Use this command to do the following:

Requirements and Restrictions

Format




Notes:

  1. 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

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.