Manual Pages for UNIX Operating System command usage for man MP_AssignLogicalUnitToTPG

Common Multipath Management Library Functions
                                MP_AssignLogicalUnitToTPG(3MPAPI)



NAME
     MP_AssignLogicalUnitToTPG - assign a multipath logical  unit
     to a target port group

SYNOPSIS
     cc [ flag... ] file... -lMPAPI [ library... ]
     #include 

     MP_STATUS MP_AssignLogicalUnitToTPG(MP_OID tpgOid, MP_OID luOid);


PARAMETERS
     tpgOid    An object ID that has  type  MP_TARGET_PORT_GROUP.
               The  target  port group currently in active access
               state that the administrator  would  like  the  LU
               assigned to.


     luOid     An     object      ID      that      has      type
               MP_MULTIPATH_LOGICAL_UNIT.


DESCRIPTION
     The MP_AssignLogicalUnitToTPG() function assigns a multipath
     logical unit to a target port group.


     Calling this function  is  valid  only  if  the  field  sup-
     portsLuAssignment       in      the      data      structure
     TARGET_PORT_GROUP_PROPERTIES is true. This capability is not
     defined  in  SCSI  standards. In some cases, devices support
     this capability through non-SCSI interfaces (such  as  SMI-S
     or SNMP). This method is only used when devices support this
     capability through vendor-specific means.


     At any given time, each LU will typically be associated with
     two  target  port  groups,  one  in  active state and one in
     standby state. The result of this API will be  that  the  LU
     associations  change  to  a  different  pair  of target port
     groups. The caller should  specify  the  object  ID  of  the
     desired target port group in active access state.

RETURN VALUES
     MP_STATUS_INVALID_OBJECT_TYPE

         The tpgOid or luOid parameter does not specify any valid
         object  type. This is most likely to happen if an unini-
         tialized object ID is passed to the API.





SunOS 5.11          Last change: 15 Feb 2006                    1






Common Multipath Management Library Functions
                                MP_AssignLogicalUnitToTPG(3MPAPI)



     MP_STATUS_INVALID_PARAMETER

         The tpgOid parameter has  a  type  subfield  other  than
         MP_OBJECT_TYPE_TARGET_PORT_GROUP  or  luOid  has  a type
         subfield other than MP_OBJECT_TYPE_MULTIPATH_LU.


     MP_STATUS_OBJECT_NOT_FOUND

         The tpgOid or luOid owner ID or object  sequence  number
         is invalid.


     MP_STATUS_UNSUPPORTED

         The API is not supported.


     MP_STATUS_SUCCESS

         The operation is successful.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ________________________________________________________________________
    |       ATTRIBUTE TYPE        |             ATTRIBUTE VALUE             |
    |_____________________________|_________________________________________|
    | Interface Stability         | Committed                               |
    |_____________________________|_________________________________________|
    | MT-Level                    | Safe                                    |
    |_____________________________|_________________________________________|
    | Standard                    | ANSI INCITS 412 Multipath Management API|
    |_____________________________|_________________________________________|


SEE ALSO
     libMPAPI(3LIB),          MP_GetAssociatedTPGOidList(3MPAPI),
     MP_GetMPLuOidListFromTPG(3MPAPI), attributes(5)











SunOS 5.11          Last change: 15 Feb 2006                    2






Common Multipath Management Library Functions
                                MP_AssignLogicalUnitToTPG(3MPAPI)






















































SunOS 5.11          Last change: 15 Feb 2006                    3