1MP_AssignLogicalUnCiotmTmooTnPGM(u3lMtPiApPaIt)h Management LMiPb_rAasrsyigFnuLnocgtiicoanlsUnitToTPG(3MPAPI)
2
3
4

NAME

6       MP_AssignLogicalUnitToTPG - assign a multipath logical unit to a target
7       port group
8

SYNOPSIS

10       cc [ flag... ] file... -lMPAPI [ library... ]
11       #include <mpapi.h>
12
13       MP_STATUS MP_AssignLogicalUnitToTPG(MP_OID tpgOid, MP_OID luOid);
14
15

PARAMETERS

17       tpgOid    An object ID that has type MP_TARGET_PORT_GROUP.  The  target
18                 port group currently in active access state that the adminis‐
19                 trator would like the LU assigned to.
20
21
22       luOid     An object ID that has type MP_MULTIPATH_LOGICAL_UNIT.
23
24

DESCRIPTION

26       The MP_AssignLogicalUnitToTPG() function assigns  a  multipath  logical
27       unit to a target port group.
28
29
30       Calling  this  function is valid only if the field supportsLuAssignment
31       in the data structure TARGET_PORT_GROUP_PROPERTIES is true. This  capa‐
32       bility is not defined in SCSI standards. In some cases, devices support
33       this capability through non-SCSI interfaces (such as  SMI-S  or  SNMP).
34       This  method  is only used when devices support this capability through
35       vendor-specific means.
36
37
38       At any given time, each LU will typically be associated with two target
39       port  groups,  one in active state and one in standby state. The result
40       of this API will be that the LU associations change to a different pair
41       of  target  port groups. The caller should specify the object ID of the
42       desired target port group in active access state.
43

RETURN VALUES

45       MP_STATUS_INVALID_OBJECT_TYPE
46
47           The tpgOid or luOid parameter does not  specify  any  valid  object
48           type.  This  is most likely to happen if an uninitialized object ID
49           is passed to the API.
50
51
52       MP_STATUS_INVALID_PARAMETER
53
54           The   tpgOid   parameter   has   a   type   subfield   other   than
55           MP_OBJECT_TYPE_TARGET_PORT_GROUP or luOid has a type subfield other
56           than MP_OBJECT_TYPE_MULTIPATH_LU.
57
58
59       MP_STATUS_OBJECT_NOT_FOUND
60
61           The tpgOid or luOid owner ID or object sequence number is invalid.
62
63
64       MP_STATUS_UNSUPPORTED
65
66           The API is not supported.
67
68
69       MP_STATUS_SUCCESS
70
71           The operation is successful.
72
73

ATTRIBUTES

75       See attributes(5) for descriptions of the following attributes:
76
77
78
79
80       ┌─────────────────────────────┬─────────────────────────────┐
81       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
82       ├─────────────────────────────┼─────────────────────────────┤
83       │Interface Stability          │Standard: ANSI  INCITS  412  │
84       │                             │Multipath Management API     │
85       ├─────────────────────────────┼─────────────────────────────┤
86       │MT-Level                     │Safe                         │
87       └─────────────────────────────┴─────────────────────────────┘
88

SEE ALSO

90       libMPAPI(3LIB),  MP_GetAssociatedTPGOidList(3MPAPI), MP_GetMPLuOidList‐
91       FromTPG(3MPAPI), attributes(5)
92
93
94
95SunOS 5.11                        15 Feb 2006MP_AssignLogicalUnitToTPG(3MPAPI)
Impressum