Media Redirection Profile SM CLP Command Mapping Specification

1

2

3

4

5

6

7

8

9

Document Number: DSP0843

Date: 2009-06-04

Version: 1.0.0

Media Redirection Profile SM CLP Command Mapping Specification

Document Type: Specification

Document Status: DMTF Standard

Document Language: E

Media Redirection Profile SM CLP Command Mapping Specification DSP0843

2 DMTF Standard Version 1.0.0

10

Copyright notice 11

Copyright © 2006, 2009 Distributed Management Task Force, Inc. (DMTF). All rights reserved. 12

13 14 15 16

17 18 19 20 21 22 23 24 25 26 27 28 29

30 31

DMTF is a not-for-profit association of industry members dedicated to promoting enterprise and systems management and interoperability. Members and non-members may reproduce DMTF specifications and documents, provided that correct attribution is given. As DMTF specifications may be revised from time to time, the particular version and release date should always be noted.

Implementation of certain elements of this standard or proposed standard may be subject to third party patent rights, including provisional patent rights (herein "patent rights"). DMTF makes no representations to users of the standard as to the existence of such rights, and is not responsible to recognize, disclose, or identify any or all such third party patent right, owners or claimants, nor for any incomplete or inaccurate identification or disclosure of such rights, owners or claimants. DMTF shall have no liability to any party, in any manner or circumstance, under any legal theory whatsoever, for failure to recognize, disclose, or identify any such third party patent rights, or for such party’s reliance on the standard or incorporation thereof in its product, protocols or testing procedures. DMTF shall have no liability to any party implementing such standard, whether such implementation is foreseeable or not, nor to any patent owner or claimant, and shall have no liability or responsibility for costs or losses incurred if a standard is withdrawn or modified after publication, and shall be indemnified and held harmless by any party implementing the standard from any and all claims of infringement by a patent owner for such implementations.

For information about patents held by third-parties which have notified the DMTF that, in their opinion, such patent may relate to or impact implementations of DMTF standards, visit http://www.dmtf.org/about/policies/disclosures.php. 32

http://www.dmtf.org/about/policies/disclosures.php

DSP0843 Media Redirection Profile SM CLP Command Mapping Specification

Version 1.0.0 DMTF Standard 3

CONTENTS 33

34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59

60

61 62 63 64 65 66 67 68 69 70 71 72 73 74 75

Foreword ....................................................................................................................................................... 5 Introduction ................................................................................................................................................... 6 1 Scope .................................................................................................................................................... 7 2 Normative References........................................................................................................................... 7

2.1 Approved References ................................................................................................................. 7 2.2 Other References........................................................................................................................ 7

3 Terms and Definitions............................................................................................................................ 7 4 Symbols and Abbreviated Terms........................................................................................................... 8 5 Recipes.................................................................................................................................................. 9 6 Mappings............................................................................................................................................... 9

6.1 CIM_ElementCapabilities ........................................................................................................... 9 6.2 CIM_HostedService.................................................................................................................. 12 6.3 CIM_HostedAccessPoint .......................................................................................................... 14 6.4 CIM_ServiceAffectsElement ..................................................................................................... 17 6.5 CIM_SAPAvailableForElement................................................................................................. 19 6.6 CIM_ServiceAccessBySAP ...................................................................................................... 22 6.7 CIM_RemoteAccessAvailableToElement ................................................................................. 24 6.8 CIM_BindsTo ............................................................................................................................ 27 6.9 CIM_MediaAccessDevice......................................................................................................... 29 6.10 CIM_RemoteServiceAccessPoint............................................................................................. 32 6.11 CIM_EnabledLogicalElementCapabilities................................................................................. 35 6.12 CIM_MediaRedirectionCapabilities........................................................................................... 37 6.13 CIM_MediaRedirectionSAP ...................................................................................................... 39 6.14 CIM_MediaRedirectionService ................................................................................................. 45

ANNEX A (informative) Change Log ......................................................................................................... 49

Tables

Table 1 – Command Verb Requirements for CIM_ElementCapabilities .................................................... 10 Table 2 – Command Verb Requirements for CIM_HostedService............................................................. 12 Table 3 – Command Verb Requirements for CIM_HostedAccessPoint ..................................................... 15 Table 4 – Command Verb Requirements for CIM_ServiceAffectsElement ................................................ 17 Table 5 – Command Verb Requirements for CIM_SAPAvailableForElement............................................ 20 Table 6 – Command Verb Requirements for CIM_ServiceAccessBySAP ................................................. 22 Table 7 – Command Verb Requirements for CIM_RemoteAccessAvailableToElement............................ 25 Table 8 – Command Verb Requirements for CIM_BindsTo ....................................................................... 27 Table 9 – Command Verb Requirements for CIM_MediaAccessDevice.................................................... 29 Table 10 – Command Verb Requirements for CIM_RemoteServiceAccessPoint...................................... 32 Table 11 – Command Verb Requirements for CIM_EnabledLogicalElementCapabilities.......................... 35 Table 12 – Command Verb Requirements for CIM_MediaRedirectionCapabilities.................................... 37 Table 13 – Command Verb Requirements for CIM_MediaRedirectionSAP............................................... 39 Table 14 – Command Verb Requirements for CIM_MediaRedirectionService .......................................... 45



76



Foreword 77

78 79

80

81

The Media Redirection Profile SM CLP Command Mapping Specification (DSP0843) was prepared by the Server Management Working Group.

Conventions

The pseudo-code conventions utilized in this document are the Recipe Conventions as defined in SNIA SMI-S 1.1.0, section 7.6. 82

83

84

85

86

87

88

89

90

Acknowledgements • John Leung – Intel

• Aaron Merkin – IBM

• Christina Shaw – HP

• Jon Hass – Dell

• Jeff Hilland – HP

• Khachatur Papanyan – Dell



Introduction 91

This document defines the SM CLP mapping for CIM elements described in the Media Redirection 92 Profile. The information in this specification, combined with the SM CLP-to-CIM Common Mapping Specification 1.0 (

93 DSP0216), is intended to be sufficient to implement SM CLP commands relevant to the

classes, properties, and methods described in the 94

Media Redirection Profile using CIM operations. 95

The target audience for this specification is implementers of the SM CLP support for the Media 96 Redirection Profile. 97



Media Redirection Profile SM CLP Command Mapping Specification

98

99

101

1 Scope 100

This specification contains the requirements for an implementation of the SM CLP to provide access to, and implement the behaviors of, the Media Redirection Profile. 102

104 105 106

108

2 Normative References 103

The following referenced documents are indispensable for the application of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies.

2.1 Approved References 107

DMTF DSP1077, Media Redirection Profile 1.0, http://www.dmtf.org/standards/published_documents/DSP1077_1.0.pdf 109

110 DMTF DSP0216, SM CLP-to-CIM Common Mapping Specification 1.0, http://www.dmtf.org/standards/published_documents/DSP0216_1.0.pdf 111

112 SNIA, Storage Management Initiative Specification (SMI-S) 1.1.0, http://www.snia.org/tech_activities/standards/curr_standards/smi 113

115

2.2 Other References 114

ISO/IEC Directives, Part 2, Rules for the structure and drafting of International Standards, http://isotc.iso.org/livelink/livelink.exe?func=ll&objId=4230456&objAction=browse&sort=subtype 116

118

120 121

123 124

126 127 128

3 Terms and Definitions 117

For the purposes of this document, the following terms and definitions apply.

3.1 119 can used for statements of possibility and capability, whether material, physical, or causal

3.2 122 cannot used for statements of possibility and capability, whether material, physical, or causal

3.3 125 conditional indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met

http://www.dmtf.org/standards/published_documents/DSP1077_1.0.pdf

http://www.dmtf.org/standards/published_documents/DSP0216_1.0.pdf

http://www.snia.org/tech_activities/standards/curr_standards/smi

http://isotc.iso.org/livelink/livelink.exe?func=ll&objId=4230456&objAction=browse&sort=subtype



3.4 129 mandatory 130

131 132

134 135

137 138

140 141

143 144 145

147 148 149

151 152 153

155 156

158

160 161

163 164

166 167

indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted

3.5 133 may indicates a course of action permissible within the limits of the document

3.6 136 need not indicates a course of action permissible within the limits of the document

3.7 139 optional indicates a course of action permissible within the limits of the document

3.8 142 shall indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted

3.9 146 shall not indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted

3.10 150 should indicates that among several possibilities, one is recommended as particularly suitable, without mentioning or excluding others, or that a certain course of action is preferred but not necessarily required

3.11 154 should not indicates that a certain possibility or course of action is deprecated but not prohibited

4 Symbols and Abbreviated Terms 157

The following symbols and abbreviations are used in this document.

4.1 159 CIM Common Information Model

4.2 162 CLP Command Line Protocol

4.3 165 DMTF Distributed Management Task Force



4.4 168 SM 169

170

172 173

175 176

178 179

181

Server Management

4.5 171 SMI-S Storage Management Initiative Specification

4.6 174 SNIA Storage Networking Industry Association

4.7 177 UFsT User Friendly selection Tag

5 Recipes 180

The following is a list of the common recipes used by the mappings in this specification. For a definition of each recipe, see the SM CLP-to-CIM Common Mapping Specification 1.0 (DSP0216). 182

183

184

185

186

187

188

189

190

191

193

• smShowInstance( )

• smShowInstances( )

• smSetInstance( )

• smShowAssocationInstance( )

• smShowAssociationInstances( )

• smRequestStateChange( )

• smStartRSC( )

• smStopRSC( )

This mapping does not define any recipes for local reuse.

6 Mappings 192

The following sections detail the mapping of CLP verbs to CIM Operations for each CIM class defined in the Media Redirection Profile. Requirements specified here related to support for a CLP verb for a particular class are solely within the context of this profile.

194 195

6.1 CIM_ElementCapabilities 196

The cd, exit, help, and version verbs shall be supported as described in DSP0216. 197

198 199 200 201 202

Table 1 lists each SM CLP verb, the required level of support for the verb in conjunction with instances of the target class, and, when appropriate, a cross-reference to the section detailing the mapping for the verb and target. Table 1 is for informational purposes only; in case of a conflict between Table 1 and requirements detailed in the following sections, the text detailed in the following sections supersedes the information in Table 1.



Table 1 – Command Verb Requirements for CIM_ElementCapabilities 203

Command Verb Requirement Comments

create Not supported

delete Not supported

dump Not supported

load Not supported

reset Not supported

set Not supported

show Shall See 6.1.2.

start Not supported

stop Not supported

No mapping is defined for the following verbs for the specified target: create, delete, dump, load, reset, set, start, and stop.

204 205

207 208

209

211 212 213

215

216 217 218 219

6.1.1 Ordering of Results 206

When results are returned for multiple instances of CIM_ElementCapabilities, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_ElementCapabilities are unordered; therefore, no algorithm is defined.

6.1.2 Show 210

This section describes how to implement the show verb when applied to an instance of CIM_ElementCapabilities. Implementations shall support the use of the show verb with CIM_ElementCapabilities.

6.1.2.1 Show Command Form for a Single Instance – CIM_MediaRedirectionService or 214 CIM_MediaRedirectionSAP Reference

This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against instances of CIM_ElementCapabilities where only one reference is specified and the reference is to the scoping instance of CIM_MediaRedirectionService or CIM_MediaRedirectionSAP.

6.1.2.1.1 Command Form 220

show <CIM_ElementCapabilities single instance> 221

6.1.2.1.2 CIM Requirements 222

See CIM_ElementCapabilities in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

223 224

227 228

229

6.1.2.1.3 Behavior Requirements 225

6.1.2.1.3.1 Preconditions 226

$instance represents the instance of a CIM_MediaRedirectionService or CIM_MediaRedirectionSAP, which is referenced by CIM_ElementCapabilities.

#all is true if the “-all” option was specified with the command; otherwise, #all is false.



6.1.2.1.3.2 Pseudo Code 230

&smShowAssociationInstances (“CIM_ElementCapabilities”, $instance.getObjectPath() ) ; 231 &smEnd; 232

234

235 236 237

6.1.2.2 Show Command Form for Multiple Instances – CIM_MediaRedirectionCapabilities 233 Reference

This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_ElementCapabilities where only one reference is specified and the reference is to the instance of CIM_MediaRedirectionCapabilities.


show <CIM_ElementCapabilities multiple instances> 239



241 242

245 246



$instance represents the instance of a CIM_MediaRedirectionCapabilities, which is referenced by CIM_ElementCapabilities.

6.1.2.2.3.2 Pseudo Code 247

&smShowAssociationInstances ( “CIM_ElementCapabilities”, $instance.getObjectPath(), 248 NULL ); 249 &smEnd; 250

252

253 254 255

6.1.2.3 Show Command Form for Multiple Instances – CIM_EnabledLogicalElementCapabilities 251 Reference

This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_ElementCapabilities where only one reference is specified and the reference is to an instance of CIM_EnabledLogicalElementCapabilities.


show <CIM_ElementCapabilities multiple instances> 257



259 260

263 264



$instance represents the instance of a CIM_EnabledLogicalElementCapabilities, which is referenced by CIM_ElementCapabilities.



6.1.2.3.3.2 Pseudo Code 265

&smShowAssociationInstances ( “CIM_ElementCapabilities”, $instance.getObjectPath(), 266 NULL ); 267 &smEnd; 268

270 271 272

6.1.2.4 Show a Single Instance Target – Both References 269

This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against instances of CIM_ElementCapabilities where both references are specified and therefore the desired instance is unambiguously identified.


show <CIM_ElementCapabilities single instance> 274



276 277

280 281

282 283



$instanceA represents the instance of a CIM_MediaRedirectionService or CIM_MediaRedirectionSAP which is referenced by the CIM_ElementCapabilities.

$instanceB represents the instance of a CIM_MediaRedirectionCapabilities or CIM_EnabledLogicalElementCapabilities which is referenced by the CIM_ElementCapabilities.

6.1.2.4.3.2 Pseudo Code 284

&smShowAssociationInstance(“CIM_ElementCapabilities”, $instanceA.getObjectPath(), 285 $instanceB.getObjectPath() ); 286 &smEnd; 287

6.2 CIM_HostedService 288

The cd and help verbs shall be supported as described in DSP0216. 289

290 291 292 293 294

295


Table 2 – Command Verb Requirements for CIM_HostedService




dump Not supported

load Not supported

reset Not supported




set Not supported


start Not supported

stop Not supported

No mappings are defined for the following verbs for the specified target: create, delete, dump, load, reset, set, start, and stop.

296 297

299 300

301

303 304

306 307 308


When results are returned for multiple instances of CIM_HostedService, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_ControlledBy are unordered; therefore, no algorithm is defined.

6.2.2 Show 302

This section describes how to implement the show verb when applied to an instance of CIM_HostedService. Implementations shall support the use of the show verb with CIM_HostedService.

6.2.2.1 Show Command Form for Multiple Instances – CIM_ComputerSystem Reference 305

This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_HostedService where only one reference is specified and the reference is to an instance of CIM_ComputerSystem.


show <CIM_HostedService multiple objects> 310


See CIM_HostedService in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

312 313

316 317



$instance represents the instance of CIM_ComputerSystem, which is referenced by CIM_HostedService.

6.2.2.1.3.2 Pseudo Code 318

&smShowAssociationInstances ( “CIM_HostedService”, $instance.getObjectPath() ); 319 &smEnd; 320

322 323 324

6.2.2.2 Show Command Form for a Single Instance – CIM_MediaRedirectionService Reference 321

This command form is used when the show verb applies to a single instance. The command form corresponds to the show verb issued against instances of CIM_HostedService where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionService.




show <CIM_HostedService single object> 326



328 329

332 333



$instance represents the instance of CIM_MediaRedirectionService, which is referenced by CIM_HostedService.

6.2.2.2.3.2 Pseudo Code 334

&smShowAssociationInstances (“CIM_HostedService”, $instance.getObjectPath() ); 335 &smEnd; 336

338 339 340

6.2.2.3 Show Command Form for a Single Instance – Both References 337

This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against CIM_HostedService where both references are specified and therefore the desired instance is unambiguously identified.


show <CIM_HostedService single object> 342



344 345

348 349

350 351



$instanceA represents the referenced instance of CIM_ComputerSystem through CIM_HostedService association.

$instanceB represents the other instance of CIM_MediaRedirectionService which is referenced by CIM_HostedService.

6.2.2.3.3.2 Pseudo Code 352

&smShowAssociationInstance (“CIM_HostedService”, $instanceA.getObjectPath(), 353 $instanceB.getObjectPath() ); 354 &smEnd; 355

6.3 CIM_HostedAccessPoint 356


358 359 360

Table 3 lists each SM CLP verb, the required level of support for the verb in conjunction with instances of the target class, and, when appropriate, a cross-reference to the section detailing the mapping for the verb and target. Table 3 is for informational purposes only; in case of a conflict between Table 3 and



requirements detailed in the following sections, the text detailed in the following sections supersedes the information in

361 362

363

Table 3.

Table 3 – Command Verb Requirements for CIM_HostedAccessPoint




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported

No mappings are defined for the following verbs for the specified target: create, delete, dump, load, reset, set, start, and stop.

364 365

367 368

369

371 372 373

375 376 377


When results are returned for multiple instances of CIM_HostedAccessPoint, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_HostedAccessPoint are unordered; therefore, no algorithm is defined.

6.3.2 Show 370

This section describes how to implement the show verb when applied to an instance of CIM_HostedAccessPoint. Implementations shall support the use of the show verb with CIM_HostedAccessPoint.


This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_HostedAccessPoint where only one reference is specified and the reference is to an instance of CIM_ComputerSystem.


show <CIM_HostedAccessPoint multiple objects> 379


See CIM_HostedAccessPoint in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

381 382

385 386



$instance represents the instance of CIM_ComputerSystem, which is referenced by CIM_HostedAccessPoint.



6.3.2.1.3.2 Pseudo Code 387

&smShowAssociationInstances ( “CIM_HostedAccessPoint”, $instance.getObjectPath() ); 388 &smEnd; 389

391 392 393

6.3.2.2 Show Command Form for a Single Instance – CIM_MediaRedirectionSAP Reference 390

This command form is used when the show verb applies to a single instance. The command form corresponds to the show verb issued against instances of CIM_HostedAccessPoint where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionSAP.


show <CIM_HostedAccessPoint single object> 395



397 398

401 402



$instance represents the instance of CIM_MediaRedirectionSAP, which is referenced by CIM_HostedAccessPoint.

6.3.2.2.3.2 Pseudo Code 403

&smShowAssociationInstances (“CIM_HostedAccessPoint”, $instance.getObjectPath() ); 404 &smEnd; 405

407 408 409


This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against CIM_HostedAccessPoint where both references are specified and therefore the desired instance is unambiguously identified.


show <CIM_HostedAccessPoint single object> 411



413 414

417 418

419 420



$instanceA represents the referenced instance of CIM_ComputerSystem through CIM_HostedAccessPoint association.

$instanceB represents the other instance of CIM_MediaRedirectionSAP which is referenced by CIM_HostedAccessPoint.



6.3.2.3.3.2 Pseudo Code 421

&smShowAssociationInstance (“CIM_HostedAccessPoint”, $instanceA.getObjectPath(), 422 $instanceB.getObjectPath() ); 423 &smEnd; 424

6.4 CIM_ServiceAffectsElement 425


427 428 429 430 431

432


Table 4 – Command Verb Requirements for CIM_ServiceAffectsElement




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported


433 434

436 437

438

440 441 442

444 445 446


When results are returned for multiple instances of CIM_ServiceAffectsElement, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_ServiceAffectsElement are unordered; therefore, no algorithm is defined.

6.4.2 Show 439

This section describes how to implement the show verb when applied to an instance of CIM_ServiceAffectsElement. Implementations shall support the use of the show verb with CIM_ServiceAffectsElement.


This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_ServiceAffectsElement where only one reference is specified and the reference is to an instance of CIM_ComputerSystem.




show <CIM_ServiceAffectsElement multiple instances> 448


See CIM_ServiceAffectsElement in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

450 451

454 455



$instance represents the instance of CIM_ComputerSystem, which is referenced by CIM_ServiceAffectsElement.

6.4.2.1.3.2 Pseudo Code 456

&smShowAssociationInstances ( “CIM_ServiceAffectsElement”, 457 $instance.getObjectPath() ); 458 &smEnd; 459

461 462 463

6.4.2.2 Show Command Form for Multiple Instances – CIM_MediaAccessDevice Reference 460

This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_ServiceAffectsElement where only one reference is specified and the reference is to an instance of CIM_MediaAccessDevice.





467 468

471 472



$instance represents the instance of CIM_MediaAccessDevice, which is referenced by CIM_ServiceAffectsElement.

6.4.2.2.3.2 Pseudo Code 473


478 479 480

6.4.2.3 Show Command Form for Multiple Instances – CIM_MediaRedirectionService Reference 477

This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_ServiceAffectsElement where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionService.







484 485

488 489



$instance represents the instance of CIM_MediaRedirectionService, which is referenced by CIM_ServiceAffectsElement.

6.4.2.3.3.2 Pseudo Code 490


495 496 497


This command form is used when the show verb applies to a single instance. This command form corresponds to the show verb issued against instances of CIM_ServiceAffectsElement where both references are specified and therefore the desired instance is unambiguously identified.


show <CIM_ServiceAffectsElement single instance> 499



501 502

505 506

507 508



$instanceA represents the instance of CIM_MediaRedirectionService, which is referenced by CIM_ServiceAffectsElement.

$instanceB represents the instance of CIM_ComputerSystem or CIM_MediaDevice which is referenced by CIM_ServiceAffectsElement.

6.4.2.4.3.2 Pseudo Code 509

&smShowAssociationInstance ( “CIM_ServiceAffectsElement”, $instanceA.getObjectPath(), 510 $instanceB.getObjectPath() ); 511 &smEnd; 512

6.5 CIM_SAPAvailableForElement 513


515 516 517 518 519




Table 5 – Command Verb Requirements for CIM_SAPAvailableForElement 520




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported


521 522

524 525

526

528 529 530

532 533 534


When results are returned for multiple instances of CIM_SAPAvailableForElement, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_SAPAvailableForElement are unordered; therefore, no algorithm is defined.

6.5.2 Show 527

This section describes how to implement the show verb when applied to an instance of CIM_SAPAvailableForElement. Implementations shall support the use of the show verb with CIM_SAPAvailableForElement.


This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_SAPAvailabileForElement where only one reference is specified and the reference is to an instance of CIM_ComputerSystem.


show <CIM_SAPAvailabileForElement multiple instances> 536


See CIM_SAPAvailableForElement in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

538 539

542 543



$instance represents the instance of CIM_ComputerSystem, which is referenced by CIM_SAPAvailabileForElement.



6.5.2.1.3.2 Pseudo Code 544

&smShowAssociationInstances ( “CIM_SAPAvailabileForElement”, 545 $instance.getObjectPath() ); 546 &smEnd; 547

549 550 551

6.5.2.2 Show Command Form for a Single Instance – CIM_MediaAccessDevice Reference 548

This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against instances of CIM_SAPAvailabileForElement where only one reference is specified and the reference is to an instance of CIM_MediaAccessDevice.


show <CIM_SAPAvailabileForElement single instance> 553



555 556

559 560



$instance represents the instance of CIM_MediaAccessDevice, which is referenced by CIM_SAPAvailabileForElement.

6.5.2.2.3.2 Pseudo Code 561


566 567 568

6.5.2.3 Show Command Form for Multiple Instances – CIM_MediaRedirectionSAP Reference 565

This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_SAPAvailabileForElement where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionSAP.


show <CIM_SAPAvailabileForElement multiple instances> 570



572 573

576 577



$instance represents the instance of CIM_MediaRedirectionSAP, which is referenced by CIM_SAPAvailabileForElement.



6.5.2.3.3.2 Pseudo Code 578


583 584 585


This command form is used when the show verb applies to a single instance. This command form corresponds to the show verb issued against instances of CIM_SAPAvailableForElement where both references are specified and therefore the desired instance is unambiguously identified.


show <CIM_SAPAvailableForElement single instance> 587



589 590

593 594

595 596



$instanceA represents the instance of CIM_MediaRedirectionSAP, which is referenced by CIM_SAPAvailableForElement.

$instanceB represents the instance CIM_ComputerSystem or CIM_MediaAccessDevice which is referenced by CIM_SAPAvailableForElement.

6.5.2.4.3.2 Pseudo Code 597

&smShowAssociationInstance ( “CIM_SAPAvailableForElement”, $instanceA.getObjectPath(), 598 $instanceB.getObjectPath() ); 599 &smEnd; 600

6.6 CIM_ServiceAccessBySAP 601


603 604 605 606 607

608


Table 6 – Command Verb Requirements for CIM_ServiceAccessBySAP




dump Not supported

load Not supported

reset Not supported




set Not supported


start Not supported

stop Not supported


609 610

612 613

614

616 617 618

620 621 622


When results are returned for multiple instances of CIM_ServiceAccessBySAP, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_ServiceAccessBySAP are unordered; therefore, no algorithm is defined.

6.6.2 Show 615

This section describes how to implement the show verb when applied to an instance of CIM_ServiceAccessBySAP. Implementations shall support the use of the show verb with CIM_ServiceAccessBySAP.


This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against instances of CIM_ServiceAccessBySAP where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionSAP.


show <CIM_ServiceAccessBySAP single instance> 624


See CIM_ServiceAccessBySAP in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

626 627

630 631



$instance represents the instance of CIM_MediaRedirectionSAP, which is referenced by CIM_ServiceAccessBySAP.

6.6.2.1.3.2 Pseudo Code 632

&smShowAssociationInstances ( “CIM_ServiceAccessBySAP”, $instance.getObjectPath() ); 633 &smEnd; 634

636 637 638

6.6.2.2 Show Command Form for Multiple Instances – CIM_MediaRedirectionService Reference 635

This command form is used when the show verb applies to multiple instances. The command form corresponds to the show verb issued against instances of CIM_ServiceAccessBySAP where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionService.




show <CIM_ServiceAccessBySAP multiple instances> 640



642 643

646 647



$instance represents the instance of CIM_MediaRedirectionService, which is referenced by CIM_ServiceAccessBySAP.

6.6.2.2.3.2 Pseudo Code 648

&smShowAssociationInstances (“CIM_ServiceAccessBySAP”, $instance.getObjectPath() ); 649 &smEnd; 650

652 653 654


This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against CIM_ServiceAccessBySAP where both references are specified and therefore the desired instance is unambiguously identified.


show <CIM_ServiceAccessBySAP single instance> 656



658 659

662 663

664 665



$instanceA represents the referenced instance of CIM_MediaRedirectionService through CIM_ServiceAccessBySAP association.

$instanceB represents the other instance of CIM_MediaRedirectionSAP which is referenced by CIM_ServiceAccessBySAP.

6.6.2.3.3.2 Pseudo Code 666

&smShowAssociationInstance (“CIM_ServiceAccessBySAP”, $instanceA.getObjectPath(), 667 $instanceB.getObjectPath() ); 668 &smEnd; 669

6.7 CIM_RemoteAccessAvailableToElement 670

The cd, exit, help, and version verbs shall be supported as described in DSP0216. 671

672 673 674

Table 7 lists each SM CLP verb, the required level of support for the verb in conjunction with instances of the target class, and, when appropriate, a cross-reference to the section detailing the mapping for the verb and target. Table 7 is for informational purposes only; in case of a conflict between Table 7 and



requirements detailed in the following sections, the text detailed in the following sections supersedes the information in

675 676

677

Table 7.

Table 7 – Command Verb Requirements for CIM_RemoteAccessAvailableToElement




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported


678 679

681 682

683 684

686 687 688

690

691 692 693 694


When results are returned for multiple instances of CIM_RemoteAccessAvailableToElement, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_RemoteAccessAvailableToElement are unordered; therefore, no algorithm is defined.

6.7.2 Show 685

This section describes how to implement the show verb when applied to an instance of CIM_RemoteAccessAvailableToElement. Implementations shall support the use of the show verb with CIM_RemoteAccessAvailableToElement.

6.7.2.1 Show Command Form for a Single Instance – CIM_RemoteServiceAccessPoint 689 Reference

This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against instances of CIM_RemoteAccessAvailableToElement where only one reference is specified and the reference is to an instance of CIM_RemoteServiceAccessPoint.


show <CIM_RemoteAccessAvailableToElement single instance> 696


See CIM_RemoteAccessAvailableToElement in the “CIM Elements” section of the Media Redirection 698 Profile for the list of mandatory properties. 699





$instance represents the instance of CIM_RemoteServiceAccessPoint, which is referenced by CIM_RemoteAccessAvailableToElement.

702 703

6.7.2.1.3.2 Pseudo Code 704

&smShowAssociationInstances ( “CIM_RemoteAccessAvailableToElement”, 705 $instance.getObjectPath() ); 706 &smEnd; 707

709 710 711


This command form is used when the show verb applies to a single instance. The command form corresponds to the show verb issued against instances of CIM_RemoteAccessAvailableToElement where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionSAP.





719 720



$instance represents the instance of CIM_MediaRedirectionSAP, which is referenced by CIM_RemoteAccessAvailableToElement.

6.7.2.2.3.2 Pseudo Code 721

&smShowAssociationInstances (“CIM_RemoteAccessAvailableToElement”, 722 $instance.getObjectPath() ); 723 &smEnd; 724

726 727 728


This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against CIM_RemoteAccessAvailableToElement where both references are specified and therefore the desired instance is unambiguously identified.









$instanceA represents the referenced instance of CIM_RemoteServiceAccessPoint through CIM_RemoteAccessAvailableToElement association.

736 737

738 739

$instanceB represents the other instance of CIM_MediaRedirectionSAP which is referenced by CIM_RemoteAccessAvailableToElement.

6.7.2.3.3.2 Pseudo Code 740

&smShowAssociationInstance (“CIM_RemoteAccessAvailableToElement”, 741 $instanceA.getObjectPath(), $instanceB.getObjectPath() ); 742 &smEnd; 743

6.8 CIM_BindsTo 744


746 747 748 749 750

751


Table 8 – Command Verb Requirements for CIM_BindsTo




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported


752 753

755 756

757


When results are returned for multiple instances of CIM_BindsTo, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_BindsTo are unordered; therefore, no algorithm is defined.



6.8.2 Show 758

This section describes how to implement the show verb when applied to an instance of CIM_BindsTo. Implementations shall support the use of the show verb with CIM_BindsTo.

759 760

762 763 764

6.8.2.1 Show Command Form for Multiple Instances – CIM_ProtocolEndpoint Reference 761

This command form is used when the show verb applies to multiple instances. This command form corresponds to the show command issued against instances of CIM_BindsTo where only one reference is specified and the reference is to an instance of CIM_ProtocolEndpoint.


show <CIM_BindsTo multiple instances> 766


See CIM_BindsTo in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

768 769

772



$instance represents the instance of CIM_ProtocolEndpoint, which is referenced by CIM_BindsTo.

6.8.2.1.3.2 Pseudo Code 773

&smShowAssociationInstances ( “CIM_BindsTo”, $instance.getObjectPath() ); 774 &smEnd; 775

777 778 779


This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against instances of CIM_BindsTo where only one reference is specified and the reference is to an instance of CIM_MediaRedirectionSAP.


show <CIM_BindsTo single instance> 781



783 784

787



$instance represents the instance of CIM_MediaRedirectionSAP, which is referenced by CIM_BindsTo.

6.8.2.2.3.2 Pseudo Code 788

&smShowAssociationInstances ( “CIM_BindsTo”, $instance.getObjectPath() ); 789 &smEnd; 790




This command form is used when the show verb applies to a single instance. This command form corresponds to the show command issued against CIM_BindsTo where both references are specified and therefore the desired instance is unambiguously identified.

792 793 794

6.8.2.3.1 Command Form 795 show <CIM_BindsTo single instance> 796



798 799

802 803

804 805



$instanceA represents the referenced instance of CIM_ProtocolEndpoint through CIM_BindsTo association.

$instanceB represents the other instance of CIM_MediaRedirectionSAP which is referenced by CIM_BindsTo.

6.8.2.3.3.2 Pseudo Code 806 &smShowAssociationInstance (“CIM_BindsTo”, $instanceA.getObjectPath(), 807 $instanceB.getObjectPath() ); 808 &smEnd; 809

6.9 CIM_MediaAccessDevice 810

The cd, and help verbs shall be supported as described in DSP0216. 811

812 813 814 815 816

817


Table 9 – Command Verb Requirements for CIM_MediaAccessDevice




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported


818 819




When results are returned for multiple instances of CIM_MediaAccessDevice, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

821 822

823

825 826 827

829 830

• Results for CIM_MediaAccessDevice are unordered; therefore, no algorithm is defined.

6.9.2 Show 824

This section describes how to implement the show verb when applied to an instance of CIM_MediaAccessDevice. Implementations shall support the use of the show verb with CIM_MediaAccessDevice.

6.9.2.1 Show a Single Instance 828

This command form is used to display the information about a single instance of CIM_MediaAccessDevice.


show <CIM_MediaAccessDevice single instance> 832


See CIM_MediaAccessDevice in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

834 835

838

839

840



$instance represents the instance of CIM_MediaAccessDevice.

#all is true, if the “-all” option was specified with the command; otherwise, #all is false.

#propertylist[ ] is an array of mandatory non-key property names.

6.9.2.1.3.2 Pseudo Code 841

if (false != #all) { #propertylist[] = NULL; } 842 &smShowInstance ( $instance.getObjectPath(), #propertylist[] ); 843 &smEnd; 844

846 847 848

6.9.2.2 Show Multiple Instances – CIM_ServiceAffectsElement 845

This command form is used to display the information about multiple instances of CIM_MediaAccessDevice. This command form corresponds to UFsT-based selection within a scoping system.


show <CIM_MediaAccessDevice multiple instances> 850



852 853





$containerInstance represents the instance of CIM_MediaRedirectionService for which the scoped instance of CIM_MediaAccessDevice is being displayed. The CIM_MediaRedirectionService is associated to targeted instances of CIM_MediaAccessDevice via a CIM_ServiceAffectsElement association.

856 857 858 859

860

861



6.9.2.2.3.2 Pseudo Code 862

if (false != #all) { #propertylist[] = NULL; } 863 &smShowInstances ( “CIM_MediaAccessDevice”, “CIM_ServiceAffectsElement”, 864 $containerInstance.getObjectPath(), #propertylist[] ); 865 &smEnd; 866

868 869 870

6.9.2.3 Show Multiple Instances – CIM_ServiceAvailableForElement 867

This command form is used to display the information about multiple instances of CIM_MediaAccessDevice. This command form corresponds to UFsT-based selection within a scoping system.


show <CIM_MediaAccessDevice multiple instances> 872



874 875

878 879 880

881

882



$containerInstance represents the instance of CIM_MediaRedirectionSAP for which the scoped instance of CIM_MediaAccessDevice is being displayed. The CIM_MediaRedirectionSAP is associated to targeted instances of CIM_MediaAccessDevice via a CIM_ServiceAvailableForElement association.



6.9.2.3.3.2 Pseudo Code 883

if (false != #all) { #propertylist[] = NULL; } 884 &smShowInstances ( “CIM_MediaAccessDevice”, “CIM_ServiceAvailableForElement”, 885 $containerInstance.getObjectPath(), #propertylist[] ); 886 &smEnd; 887



6.10 CIM_RemoteServiceAccessPoint 888


890 891 892 893 894

895


Table 10 – Command Verb Requirements for CIM_RemoteServiceAccessPoint




dump Not supported

load Not supported

reset Not supported

set May See 6.10.2.


start Not supported

stop Not supported

No mapping is defined for the following verbs for the specified target: create, delete, dump, load, reset, start, and stop.

896 897

899 900

901

904 905

906 907


When results are returned for multiple instances of CIM_RemoteServiceAccessPoint, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_RemoteServiceAccessPoint are unordered; therefore, no algorithm is defined.

6.10.2 Set 902

6.10.2.1 General Usage of Set for a Single Property 903

This command form corresponds to the general usage of the set verb to modify a single property of a target instance. The setting of a single property shall be deterministic.

The requirements for supporting modification of a property using this command form shall be equivalent to the requirement for supporting modification of the property using the ModifyInstance operation as defined in the Media Redirection Profile. 908


set <CIM_RemoteServiceAccessPoint single object> <propertyname>=<propertyvalue> 910


See CIM_RemoteServiceAccessPoint in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

912 913





$instance represents the instance of CIM_RemoteServiceAccessPoint. 916

$instance=<CIM_RemoteServiceAccessPoint single object>; 917

6.10.2.1.3.2 Pseudo Code 918

#propertyNames[] = <propertname>; 919 #propertyValues[] = <propertyvalue>; 920 &smSetInstance ( $instance, #propertyNames, #propertyValues ); 921 &smEnd; 922

924 925

926 927

6.10.2.2 General Usage of Set for Multiple Properties 923

This command form corresponds to the general usage of the set verb to modify multiple properties of a target instance. The setting of multiple properties may be deterministic.



set <CIM_RemoteServiceAccessPoint multiple objects> <propertyname1>=<propertyvalue1> 930 <propertynameN>=<propertyvalueN> 931



933 934

937



$instance represents the instance of CIM_RemoteServiceAccessPoint.

6.10.2.2.3.2 Pseudo Code 938

for #i < n 939 { 940 #propertyNames[#i] = <propertname#i> 941 #propertyValues[#i] = <propertyvalue#i> 942 } 943 &smSetInstance ( $instance, #propertyNames[], #propertyValues[] ); 944 &smEnd; 945

947 948

6.10.3 Show 946

The show verb is used to display information about instances of CIM_RemoteServiceAccessPoint. Implementations shall support the use of the show verb with CIM_RemoteServiceAccessPoint.




This command form is used to display the information about a single instance of CIM_RemoteServiceAccessPoint.

950 951


show <CIM_RemoteServiceAccessPoint single instance> 953



955 956

959

960

961



$instance represents the instance of CIM_RemoteServiceAccessPoint.


#propertylist[] is an array of mandatory non-key property names.

6.10.3.1.3.2 Pseudo Code 962


967 968 969

6.10.3.2 Show Multiple Instances – CIM_RemoteAccessAvailableToElement 966

This command form is used to display the information about multiple instances of CIM_RemoteServiceAccessPoint. This command form corresponds to UFsT-based selection within a scoping system.


show <CIM_RemoteServiceAccessPoint multiple instances> 971



973 974

977 978 979 980

981

982



$containerInstance represents the instance of CIM_MediaRedirectionSAP for which the scoped instance of CIM_RemoteServiceAccessPoint is being displayed. The CIM_MediaRedirectionSAP is associated to targeted instances of CIM_RemoteServiceAccessPoint via a CIM_RemoteAccessAvailableToElement association.





6.10.3.2.3.2 Pseudo Code 983

if (false != #all) { #propertylist[] = NULL; } 984 &smShowInstances ( “CIM_RemoteServiceAccessPoint”, 985 “CIM_RemoteAccessAvailableToElement", $containerInstance.getObjectPath(), 986 #propertylist[] ); 987 &smEnd; 988

6.11 CIM_EnabledLogicalElementCapabilities 989


991 992 993 994 995

996


Table 11 – Command Verb Requirements for CIM_EnabledLogicalElementCapabilities




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported


997 998

1000 1001

1002 1003

1005 1006 1007

1009 1010


When results are returned for multiple instances of CIM_EnabledLogicalElementCapabilities, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_EnabledLogicalElementCapabilities are unordered; therefore, no algorithm is defined.

6.11.2 Show 1004

The show verb is used to display information about instances of CIM_EnabledLogicalElementCapabilities. Implementations shall support the use of the show verb with CIM_EnabledLogicalElementCapabilities.


This command form is used to display the information about a single instance of CIM_EnabledLogicalElementCapabilities.



6.11.2.1.1 Command Form 1011

show <CIM_EnabledLogicalElementCapabilities single instance> 1012


See CIM_EnabledLogicalElementCapabilities in the “CIM Elements” section of the Media Redirection 1014 Profile for the list of mandatory properties. 1015

1018

1019

1020



$instance represents the instance of CIM_EnabledLogicalElementCapabilities.



6.11.2.1.3.2 Pseudo Code 1021


1026 1027 1028

6.11.2.2 Show Multiple Instances 1025

This command form is used to display the information about multiple instances of CIM_EnabledLogicalElementCapabilities. This command form corresponds to UFsT-based selection within a scoping system.

6.11.2.2.1 Command Form 1029

show <CIM_EnabledLogicalElementCapabilities multiple instances> 1030


See CIM_EnabledLogicalElementCapabilities in the “CIM Elements” section of the Media Redirection 1032 Profile for the list of mandatory properties. 1033

1036 1037 1038

1039

1040



$containerInstance represents the instance of CIM_ConcreteCollection with ElementName property that contains “Capabilities” and is associated to the targeted instances of CIM_EnabledLogicalElementCapabilities through the CIM_MemberOfCollection association.



6.11.2.2.3.2 Pseudo Code 1041

if (false != #all) { #propertylist[] = NULL; } 1042 &smShowInstances ( “CIM_EnabledLogicalElementCapabilities”, “CIM_ConcreteCollection”, 1043 $containerInstance.getObjectPath(), #propertylist[] ); 1044 &smEnd; 1045



6.12 CIM_MediaRedirectionCapabilities 1046


1048 1049 1050 1051 1052

1053


Table 12 – Command Verb Requirements for CIM_MediaRedirectionCapabilities




dump Not supported

load Not supported

reset Not supported

set Not supported


start Not supported

stop Not supported


1054 1055

1057 1058

1059

1061 1062 1063

1064 1065

1067 1068


When results are returned for multiple instances of CIM_MediaRedirectionCapabilities, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_MediaRedirectionCapabilities are unordered; therefore, no algorithm is defined.

6.12.2 Show 1060

This section describes how to implement the show verb when applied to an instance of CIM_MediaRedirectionCapabilities. Implementations shall support the use of the show verb with CIM_MediaRedirectionCapabilities.

The show verb is used to display information about an instance or instances of the CIM_MediaRedirectionCapabilities class.


This command form is for the show verb applied to a single instance of CIM_MediaRedirectionCapabilities.

6.12.2.1.1 Command Form 1069

show <CIM_MediaRedirectionCapabilities single instance> 1070


See CIM_MediaRedirectionCapabilities in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

1072 1073





$instance represents the instance of CIM_MediaRedirectionCapabilities. 1076

$instance=<CIM_MediaRedirectionCapabilities single instance>; 1077

1078 #all is true if the all option was specified with the command; otherwise, #all is false.

6.12.2.1.3.2 Pseudo Code 1079

#propertylist[] = null; 1080 if ( false == #all) 1081 { 1082 #propertylist[] = {//all mandatory non-key properties} 1083 } 1084 &smShowInstance ( $instance.getObjectPath(), #propertylist[] ); 1085 &smEnd; 1086

1088 1089 1090

6.12.2.2 Show Multiple Instances 1087

This command form is for the show verb applied to multiple instances of CIM_MediaRedirectionCapabilities. This command form corresponds to UFsT-based selection within a capabilities collection.

6.12.2.2.1 Command Form 1091

show <CIM_MediaRedirectionCapabilities multiple instances> 1092


See CIM_MediaRedirectionCapabilities in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

1094 1095

1098 1099 1100

1101



$containerInstance represents the instance of CIM_ConcreteCollection with ElementName property that contains “Capabilities” and is associated to the targeted instances of CIM_MediaRedirectionCapabilities through the CIM_MemberOfCollection association.

#all is true if the all option was specified with the command; otherwise, #all is false.

6.12.2.2.3.2 Pseudo Code 1102

#propertylist[] = NULL; 1103 if ( false == #all) 1104 { 1105 #propertylist[] = {//all mandatory non-key properties } 1106 } 1107 &smShowInstances ( “CIM_MediaRedirectionCapabilities”, “CIM_MemberOfCollection”, 1108 $containerInstance.getObjectPath(), #propertylist[] ); 1109 &smEnd; 1110



6.13 CIM_MediaRedirectionSAP 1111


1113 1114 1115 1116 1117

1118


Table 13 – Command Verb Requirements for CIM_MediaRedirectionSAP




dump Not supported

load Not supported

reset Not supported

set May See 6.13.2.


start May See 6.13.4.

stop May See 6.13.5.

No mapping is defined for the following verbs for the specified target: create, delete, dump, load, and reset.

1119 1120

1122 1123

1124

1126 1127

1129 1130

1131 1132


When results are returned for multiple instances of CIM_MediaRedirectionSAP, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_MediaRedirectionSAP are unordered; therefore, no algorithm is defined.

6.13.2 Set 1125

The set verb is used to set properties on an instance of CIM_MediaRedirectionSAP. Implementations may support the use of the set verb with CIM_MediaRedirectionSAP.




6.13.2.1.1 Command Form 1134

set <CIM_MediaRedirectionSAP single object> <propertyname>=<propertyvalue> 1135




See CIM_MediaRedirectionSAP in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

1137 1138

1141



$instance represents the targeted instance of CIM_MediaRedirectionSAP.

$instance=<CIM_MediaRedirectionSAP single object>; 1142

6.13.2.1.3.2 Pseudo Code 1143

#propertyNames[] = <propertname>; 1144 #propertyValues[] = <propertyvalue>; 1145 &smSetInstance ( $instance, #propertyNames, #propertyValues ); 1146 &smEnd; 1147

1149 1150

1151 1152




6.13.2.2.1 Command Form 1154

set <CIM_MediaRedirectionSAP multiple objects> <propertyname1>=<propertyvalue1> 1155 <propertynameN>=<propertyvalueN> 1156



1158 1159

1162



$instance represents the instance of CIM_MediaRedirectionSAP.

6.13.2.2.3.2 Pseudo Code 1163




6.13.3 Show 1171

The show verb is used to display information about instances of CIM_MediaRedirectionSAP. Implementations shall support the use of the show verb with CIM_MediaRedirectionSAP.

1172 1173

1175


This command form is used to display information about a single instance of CIM_MediaRedirectionSAP.

6.13.3.1.1 Command Form 1176

show <CIM_MediaRedirectionSAP single instance> 1177



1179 1180

1183

1184

1185



$instance represents the instance of CIM_MediaRedirectionSAP.



6.13.3.1.3.2 Pseudo Code 1186


1191 1192

6.13.3.2 Show Multiple Instances – CIM_HostedAccessPoint 1190

This command form is used to display information about multiple instances of CIM_MediaRedirectionSAP.

6.13.3.2.1 Command Form 1193

show <CIM_MediaRedirectionSAP multiple instances> 1194



1196 1197

1200 1201 1202

1203

1204



$containerInstance represents the instance of CIM_ComputerSystem for which the scoped instance of CIM_MediaRedirectionSAP is being displayed. The CIM_MediaRedirectionSAP is associated to CIM_ComputerSystem via a CIM_HostedAccessPoint association.





6.13.3.2.3.2 Pseudo Code 1205

if (false != #all) { #propertylist[] = NULL; } 1206 &smShowInstances ( “CIM_MediaRedirectionSAP”, “CIM_HostedAccessPoint”, 1207 $containerInstance.getObjectPath(), #propertylist[] ); 1208 &smEnd; 1209

1211 1212

6.13.3.3 Show Multiple Instances – CIM_SAPAvailableForElement 1210


6.13.3.3.1 Command Form 1213




1216 1217

1220 1221 1222

1223

1224



$containerInstance represents the instance of CIM_ComputerSystem for which the scoped instance of CIM_MediaRedirectionSAP is being displayed. The CIM_MediaRedirectionSAP is associated to CIM_ComputerSystem via a CIM_SAPAvailableForElement association.



6.13.3.3.3.2 Pseudo Code 1225

if (false != #all) { #propertylist[] = NULL; } 1226 &smShowInstances ( “CIM_MediaRedirectionSAP”, “CIM_SAPAvailableForElement”, 1227 $containerInstance.getObjectPath(), #propertylist[] ); 1228 &smEnd; 1229

1231 1232

6.13.3.4 Show Multiple Instances – CIM_ServiceAccessBySAP 1230


6.13.3.4.1 Command Form 1233




1236 1237





$containerInstance represents the instance of CIM_MediaRedirectionService for which the scoped instance of CIM_MediaRedirectionSAP is being displayed. The CIM_MediaRedirectionSAP is associated to CIM_MediaRedirectionService via a CIM_ServiceAccessBySAP association.

1240 1241 1242

1243

1244



6.13.3.4.3.2 Pseudo Code 1245

if (false != #all) { #propertylist[] = NULL; } 1246 &smShowInstances ( “CIM_MediaRedirectionSAP”, “CIM_ServiceAccessBySAP”, 1247 $containerInstance.getObjectPath(), #propertylist[] ); 1248 &smEnd; 1249

1251 1252 1253

1254

1256 1257

6.13.4 Start 1250

This section describes how to implement the start verb when applied to an instance of CIM_MediaRedirectionSAP. Implementations may support the use of the start verb with CIM_MediaRedirectionSAP.

The start verb is used to enable a Media Redirection Session.

6.13.4.1 Start a Single Instance 1255

This command form is for the start verb applied to a single instance of CIM_MediaRedirectionSAP, in which the CIM_MediaRedirectionSAP does not use CLP session for the Media Redirection session.

6.13.4.1.1 Command Form 1258

start <CIM_MediaRedirectionSAP single instance> 1259



1261 1262

1265




$instance=<CIM_MediaRedirectionSAP single instance>; 1266

6.13.4.1.3.2 Pseudo Code 1267

&smStartRSC ( $instance.getObjectPath() ); 1268 &smEnd; 1269

1271 1272 1273

6.13.5 Stop 1270

This section describes how to implement the stop verb when applied to an instance of CIM_MediaRedirectionSAP. Implementations may support the use of the stop verb with CIM_MediaRedirectionSAP.



The stop verb is used to place a Media Redirection session into a 6 (Enabled but Offline) state. 1274

1276

6.13.5.1 Stop a Single Instance 1275

This command form is for the stop verb applied to a single instance of CIM_MediaRedirectionSAP.

6.13.5.1.1 Command Form 1277

stop <CIM_MediaRedirectionSAP single instance> 1278



1280 1281

1284





6.13.5.1.3.2 Pseudo Code 1286

“Offline” is valuemap 6 1287 &smRequestStateChange ( $instance.getObjectPath(), “Offline” ); 1288 &smEnd; 1289

1291 1292

6.13.5.2 Set RequestedState to “Disabled” 1290

This section describes how to change the state of the Redirection Session represented by CIM_MediaRedirectionSAP to “Disabled”.

6.13.5.2.1 Command Form 1293

set <CIM_MediaRedirectionSAP single instance> RequestedState=“Disabled” 1294



1296 1297

1300





6.13.5.2.3.2 Pseudo Code 1302

&smStopRSC ( $instance.getObjectPath() ); 1303 &smEnd; 1304



6.14 CIM_MediaRedirectionService 1305


1307 1308 1309 1310 1311

1312


Table 14 – Command Verb Requirements for CIM_MediaRedirectionService




dump Not supported

load Not supported

reset Not supported

set May See 6.14.2.


start May See 6.14.5.

stop May See 6.14.5.

No mapping is defined for the following verbs for the specified target: create, delete, dump, load, and reset.

1313 1314

1316 1317

1318

1320 1321 1322

1323

1325 1326

1327 1328


When results are returned for multiple instances of CIM_MediaRedirectionService, implementations shall utilize the following algorithm to produce the natural (that is, default) ordering:

• Results for CIM_MediaRedirectionService are unordered; therefore, no algorithm is defined.

6.14.2 Set 1319

This section describes how to implement the set verb when it is applied to an instance of CIM_MediaRedirectionService. The set verb is used to set properties on an instance of CIM_MediaRedirectionService.

Implementations may support the use of the set verb with CIM_MediaRedirectionService.




6.14.2.1.1 Command Form 1330

set <CIM_MediaRedirectionService single object> <propertyname>=<propertyvalue> 1331




See CIM_MediaRedirectionService in the “CIM Elements” section of the Media Redirection Profile for the list of mandatory properties.

1333 1334

1337



$instance represents the instance of CIM_MediaRedirectionService.

$instance=<CIM_MediaRedirectionService single object>; 1338

6.14.2.1.3.2 Pseudo Code 1339

#propertyNames[] = <propertname>; 1340 #propertyValues[] = <propertyvalue>; 1341 &smSetInstance ( $instance, #propertyNames[], #propertyValues[] ); 1342 &smEnd; 1343

1345 1346

1347 1348




6.14.2.2.1 Command Form 1350

set <CIM_MediaRedirectionService multiple objects> <propertyname1>=<propertyvalue1> 1351 <propertynameN>=<propertyvalueN> 1352



1354 1355

1358




6.14.2.2.3.2 Pseudo Code 1359




6.14.3 Show 1367

The show verb is used to display information about instances of CIM_MediaRedirectionService. Implementations shall support the use of the show verb with CIM_MediaRedirectionService.

1368 1369

1371

6.14.3.1 Show Command Form for a Single Instance 1370

This command form is to show a single instance of CIM_MediaRedirectionService.

6.14.3.1.1 Command Form 1372

show <CIM_MediaRedirectionService single instance> 1373



1375 1376

1379

1380

1381






6.14.3.1.3.2 Pseudo Code 1382


1387 1388 1389

1390

1392 1393

1394

6.14.4 Start 1386

This section describes how to implement the start verb when applied to an instance of CIM_MediaRedirectionService. Implementations may support the use of the start verb with CIM_MediaRedirectionService.

Implementations may support the use of the start verb with CIM_MediaRedirectionService.

6.14.4.1 Start Command Form for a Single Instance 1391

This command form is for the start verb applied to a single instance of CIM_MediaRedirectionService. Implementations may support the use of the start verb with CIM_MediaRedirectionService.

The start verb is used to enable a Media Redirection Service.

6.14.4.1.1 Command Form 1395

start <CIM_MediaRedirectionService single instance> 1396



1398 1399





$instance represents the instance of CIM_MediaRedirectionService. 1402

$instance=<CIM_MediaRedirectionService single instance>; 1403

6.14.4.1.3.2 Pseudo Code 1404

&smStartRSC ( $instance.getObjectPath() ); 1405 &smEnd; 1406

1408 1409 1410

1411

1413

6.14.5 Stop 1407

This section describes how to implement the stop verb when applied to an instance of CIM_MediaRedirectionService. Implementations may support the use of the stop verb with CIM_MediaRedirectionService.

The stop verb is used to place a Media Redirection Service in a 3 (Disabled) state.

6.14.5.1 Stop Command Form for a Single Instance 1412

This command form is for the stop verb applied to a single instance of CIM_MediaRedirectionService.

6.14.5.1.1 Command Form 1414

stop <CIM_MediaRedirectionService single instance> 1415



1417 1418

1421




$instance=<CIM_MediaRedirectionService single instance>; 1422

6.14.5.1.3.2 Pseudo Code 1423

&smRequestStateChange ( $instance.getObjectPath(), “Disabled” ); 1424 &smEnd; 1425

1426



ANNEX A (

1427 1428 1429 1430 1431

informative)

Change Log

Version Date Author Description

1.0.0 2009-06-04 DMTF Standard Release

1432

Media Redirection Profile SM CLP Command Mapping Specification

Documents