z/OS HCD User's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


Defining PCIe functions

z/OS HCD User's Guide
SC34-2669-00

Defining PCIe functions

  1. On the Primary Task Selection panel, select Define, modify, or view configuration data and on the resulting panel, select Processors. HCD displays the Processor List of defined processors.
  2. On the Processor List panel, select an eligible processor and action Work with PCIe functions from the context menu (or action code  f ).

    HCD displays the PCIe Function List showing all PCIe functions defined for the selected processor.

       Goto  Filter  Backup  Query  Help
     ------------------------------------------------------------------------------
                                   PCIe Function List     Row 1 of 18 More:       >
     Command ===> _______________________________________________ Scroll ===> PAGE
    
     Select one or more PCIe functions, then press Enter. To add, use F11.
    
     Processor ID . . . . : P35          zEC12 HE Bl19 for all zHelix
    
    
    
     / FID    PCHID  VF+  Type+           Description
     _ 010    314    __   ROCE            LP47,     24,36,51
     _ 011    318    __   ROCE            LP51,     24,36,47
     _ 012    308    __   ROCE            LP24,     36,47,51
     _ 013    30C    1    ZEDC-EXPRESS    LP36,     24,47,51
     _ 014    320    __   ROCE            LP10,     19,25,37,38,46,48
     _ 015    324    __   ROCE            LP25,     10,19,37,38,46,48
     _ 016    330    2    ZEDC-EXPRESS    LP19,     10,25,37,38,46,48
     _ 017    334    __   ROCE            LP37,     10,29,25,38,46,48
     _ 018    338    __   ROCE            LP10,     19,25,37,38,46,48
     _ 019    33C    3_   ZEDC-EXPRESS    LP25,     10,19,37,38,46,48
     _ 01A    340    __   ROCE            LP19,     10,25,37,38,46,48
     _ 01B    344    __   ROCE            LP37,     10,19,25,38,46,48
      F1=Help      F2=Split     F3=Exit      F4=Prompt    F5=Reset     F7=Backward
      F8=Forward   F9=Swap     F10=Actions  F11=Add      F12=Cancel   F13=Instruct
     F20=Right    F22=Command

    A PCIe function is defined by a unique identifier, the function ID (FID). Each function specifies a function type (ROCE or ZEDC-EXPRESS) and a physical channel identifier PCHID. Multiple functions may be specified to the same PCHID value provided that each of these functions defines a unique virtual function VF number. When defining a PCIe function, you may specify a description which is shown in this list.

    Use PF20=Right to scroll to the partition assignments for the displayed PCIe functions, one panel for each defined channel subsystem.

       Goto  Filter  Backup  Query  Help
     ------------------------------------------------------------------------------
                                   PCIe Function List     Row 1 of 18 More: 
     Command ===> _______________________________________________ Scroll ===> PAGE
    
     Select one or more PCIe functions, then press Enter. To add, use F11.
     Processor ID . . . . : P35          zEC12 HE Bl19 for all zHelix
     1=OS R35LP01   2=OS R35LP02   3=OS R35LP03   4=OS R35LP04   5=OS R35LP05
     6=OS R35LP06   7=OS R35LP07   8=OS R35LP08   9=OS R35LP09   A=OS R35LP10
     B=OS R35LP11   C=OS IRD7      D=OS R35LP13   E=OS R35LP14   F=OS R35LP15
                           ------- Partitions 0x -------
     / FID    PCHID  VF    1 2 3 4 5 6 7 8 9 A B C D E F
     _ 010    314    __    _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
     _ 011    318    __    _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
     _ 012    308    __    _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
     _ 013    30C    __    _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
     _ 014    320    __    _ _ _ _ _ _ _ _ _ a _ _ _ _ _
     _ 015    324    __    _ _ _ _ _ a c c _ c _ _ _ _ _
     _ 016    330    __    _ _ _ _ _ _ _ _ _ c _ _ _ _ _
     _ 017    334    __    _ a _ _ c _ _ c _ c _ _ _ _ _
     _ 018    338    __    _ _ _ _ _ _ _ _ _ a _ _ _ _ _
     _ 019    33C    __    _ _ _ _ _ _ _ _ _ c _ _ _ _ _
     _ 01A    340    __    a _ _ _ _ _ _ _ _ c _ _ _ _ _
     _ 01B    344    __    _ _ _ _ _ _ _ _ _ c _ _ _ _ _
      F1=Help      F2=Split     F3=Exit      F4=Prompt    F5=Reset     F7=Backward
      F8=Forward   F9=Swap     F10=Actions  F11=Add      F12=Cancel   F13=Instruct
     F20=Right    F22=Command
  3. Use F11=Add to define a new PCIe function. The data-entry fields are shown in the following figure, with sample data:
    *---------------------------- Add PCIe Function ----------------------------*
    |                                                                           |
    |                                                                           |
    | Specify or revise the following values.                                   |
    |                                                                           |
    | Processor ID  . . . . : P35          zEC12 HE Bl19 for all zHelix         |
    |                                                                           |
    | Function ID . . . . . . 01C                                               |
    | Type  . . . . . . . . . ZEDC-EXPRESS  +                                   |
    |                                                                           |
    | PCHID . . . . . . . . . 358                                               |
    | Virtual Function ID . . 1   +                                             |
    |                                                                           |
    | Description . . . . . . PCIe Function of type zEDC                        |
    |                                                                           |
    |  F1=Help     F2=Split    F3=Exit     F4=Prompt   F5=Reset    F9=Swap      |
    | F12=Cancel                                                                |
    *---------------------------------------------------------------------------*

    You define a new PCIe function specified by its required function ID, function type and PCHID value, the virtual function number (if possible for the specified function type), and a description. After pressing the Enter key, the LPARs can be selected that should be entitled to access the function. If you specified an Add-like action, the data entry fields, except the function ID, and the LPAR connections are preset with the values of the selected source function.

    Each PCIe function is identified by a three-digit hexadecimal function ID that is unique within a processor configuration. You must specify a function type (ROCE or ZEDC-EXPRESS), and a PCHID value which describes the related PCIe adapter card in the assigned slot of the I/O drawer. Depending on the function type, multiple PCIe functions may be defined for the same PCHID by assigning a unique virtual function number to each of these functions.

    HCD also supports overgenned PCIe functions. You define overgenned PCIe functions by providing an asterisk (*) for the PCHID value. Overgenned functions are validated like other PCIe functions but they are excluded from the IOCP input statements and from dynamic activation.

Depending on the function type, you can assign up to four physical network IDs to a PCIe function. Each physical port of the PCIe adapter can be assigned to a (possibly different) physical network. If you press the Enter key, for example, for a function of type ROCE, HCD displays the Add/Modify Physical Network IDs window where you can enter a physical network ID (PNET ID) for each physical port of the adapter. The sequence of the PNET IDs corresponds to the sequence of the port numbers on the adapter card.

                          Add/Modify Physical Network IDs


     If the PCHID is associated to one or more physical networks, specify
     each physical network ID corresponding to each applicable physical port.

     Physical network ID 1  . . PNET01__________
     Physical network ID 2  . . PNET02__________
     Physical network ID 3  . . ________________
     Physical network ID 4  . . ________________


      F1=Help     F2=Split    F3=Exit     F5=Reset    F9=Swap    F12=Cancel

If you press the Enter key either on the Add/Modify Physical Network IDs window for PCIe functions of type ROCE, or directly on the Add PCIe Function window for PCIe functions of type ZEDC-EXPRESS, HCD displays the Define Access List window, where you can specify one partition to be connected to the defined PCIe function.

                             Define Access List
                                                                    Row 1 of 8
     Command ===> _________________________________________ Scroll ===> PAGE

     Select one or more partitions for inclusion in the access list.

     Function ID  . . . . : 028

     / CSS ID Partition Name   Number Usage Description
     _ 0      LP01             1      CF/OS
     _ 0      LP02             2      CF/OS
     _ 1      LP11             1      CF/OS
     / 1      LP12             2      CF/OS
     _ 2      LP21             1      CF/OS
     _ 2      LP22             2      CF/OS
     _ 3      LP31             1      CF/OS
     _ 3      LP32             2      CF/OS
     **************************** Bottom of data *****************************



      F1=Help       F2=Split      F3=Exit       F5=Reset      F6=Previous
      F7=Backward   F8=Forward    F9=Swap      F12=Cancel    F22=Command
   

Pressing Enter again leads you to the Define Candidate List window. Here you can modify the candidate list of partitions assigned to the PCIe function. You can define partitions from any channel subsystem.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014