ImcSdk 0.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (395) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +12 -0
  3. data/.rspec +2 -0
  4. data/.travis.yml +5 -0
  5. data/.yardopts +7 -0
  6. data/CODE_OF_CONDUCT.md +74 -0
  7. data/Gemfile +4 -0
  8. data/ImcSdk.gemspec +43 -0
  9. data/LICENSE +201 -0
  10. data/Makefile +9 -0
  11. data/README.md +79 -0
  12. data/Rakefile +15 -0
  13. data/bin/console +14 -0
  14. data/bin/setup +8 -0
  15. data/docs/ImcHandle.html +2900 -0
  16. data/docs/_index.html +109 -0
  17. data/docs/class_list.html +51 -0
  18. data/docs/css/common.css +1 -0
  19. data/docs/css/full_list.css +58 -0
  20. data/docs/css/style.css +492 -0
  21. data/docs/file_list.html +56 -0
  22. data/docs/frames.html +17 -0
  23. data/docs/index.html +147 -0
  24. data/docs/js/app.js +248 -0
  25. data/docs/js/full_list.js +216 -0
  26. data/docs/js/jquery.js +4 -0
  27. data/docs/method_list.html +619 -0
  28. data/docs/top-level-namespace.html +10218 -0
  29. data/lib/ImcSdk.rb +395 -0
  30. data/lib/ImcSdk/apis/admin/ipmi.rb +99 -0
  31. data/lib/ImcSdk/apis/admin/ldap.rb +304 -0
  32. data/lib/ImcSdk/apis/admin/ntp.rb +202 -0
  33. data/lib/ImcSdk/apis/admin/user.rb +221 -0
  34. data/lib/ImcSdk/apis/server/bios.rb +311 -0
  35. data/lib/ImcSdk/apis/server/power.rb +219 -0
  36. data/lib/ImcSdk/apis/server/remotepresence.rb +170 -0
  37. data/lib/ImcSdk/apis/server/serveractions.rb +382 -0
  38. data/lib/ImcSdk/apis/server/storage.rb +438 -0
  39. data/lib/ImcSdk/apis/utils.rb +55 -0
  40. data/lib/ImcSdk/imcbasetype.rb +121 -0
  41. data/lib/ImcSdk/imcconstants.rb +1351 -0
  42. data/lib/ImcSdk/imccore.rb +220 -0
  43. data/lib/ImcSdk/imccoremeta.rb +271 -0
  44. data/lib/ImcSdk/imccoreutils.rb +441 -0
  45. data/lib/ImcSdk/imcdriver.rb +187 -0
  46. data/lib/ImcSdk/imcexception.rb +86 -0
  47. data/lib/ImcSdk/imcfiltertype.rb +228 -0
  48. data/lib/ImcSdk/imcgenutils.rb +29 -0
  49. data/lib/ImcSdk/imcmeta.rb +975 -0
  50. data/lib/ImcSdk/imcmethod.rb +182 -0
  51. data/lib/ImcSdk/imcmethodfactory.rb +190 -0
  52. data/lib/ImcSdk/imcmo.rb +669 -0
  53. data/lib/ImcSdk/imcsession.rb +549 -0
  54. data/lib/ImcSdk/imcxmlcodec.rb +94 -0
  55. data/lib/ImcSdk/methodmeta/AaaGetComputeAuthTokensMeta.rb +16 -0
  56. data/lib/ImcSdk/methodmeta/AaaKeepAliveMeta.rb +14 -0
  57. data/lib/ImcSdk/methodmeta/AaaLoginMeta.rb +36 -0
  58. data/lib/ImcSdk/methodmeta/AaaLogoutMeta.rb +18 -0
  59. data/lib/ImcSdk/methodmeta/AaaRefreshMeta.rb +36 -0
  60. data/lib/ImcSdk/methodmeta/ConfigConfMoMeta.rb +22 -0
  61. data/lib/ImcSdk/methodmeta/ConfigConfMosMeta.rb +20 -0
  62. data/lib/ImcSdk/methodmeta/ConfigResolveChildrenMeta.rb +24 -0
  63. data/lib/ImcSdk/methodmeta/ConfigResolveClassMeta.rb +20 -0
  64. data/lib/ImcSdk/methodmeta/ConfigResolveDnMeta.rb +20 -0
  65. data/lib/ImcSdk/methodmeta/ConfigResolveParentMeta.rb +20 -0
  66. data/lib/ImcSdk/methodmeta/EventSubscribeMeta.rb +14 -0
  67. data/lib/ImcSdk/methodmeta/EventUnsubscribeMeta.rb +14 -0
  68. data/lib/ImcSdk/mometa/aaa/AaaLdap.rb +269 -0
  69. data/lib/ImcSdk/mometa/aaa/AaaLdapRoleGroup.rb +122 -0
  70. data/lib/ImcSdk/mometa/aaa/AaaSession.rb +123 -0
  71. data/lib/ImcSdk/mometa/aaa/AaaUser.rb +130 -0
  72. data/lib/ImcSdk/mometa/aaa/AaaUserEp.rb +88 -0
  73. data/lib/ImcSdk/mometa/aaa/AaaUserPasswordExpiration.rb +118 -0
  74. data/lib/ImcSdk/mometa/aaa/AaaUserPolicy.rb +100 -0
  75. data/lib/ImcSdk/mometa/activate/ActivatePIDCatalog.rb +101 -0
  76. data/lib/ImcSdk/mometa/adaptor/AdaptorCfgBackup.rb +143 -0
  77. data/lib/ImcSdk/mometa/adaptor/AdaptorCfgImporter.rb +143 -0
  78. data/lib/ImcSdk/mometa/adaptor/AdaptorConnectorInfo.rb +97 -0
  79. data/lib/ImcSdk/mometa/adaptor/AdaptorEthCompQueueProfile.rb +100 -0
  80. data/lib/ImcSdk/mometa/adaptor/AdaptorEthGenProfile.rb +158 -0
  81. data/lib/ImcSdk/mometa/adaptor/AdaptorEthISCSIProfile.rb +261 -0
  82. data/lib/ImcSdk/mometa/adaptor/AdaptorEthInterruptProfile.rb +116 -0
  83. data/lib/ImcSdk/mometa/adaptor/AdaptorEthOffloadProfile.rb +112 -0
  84. data/lib/ImcSdk/mometa/adaptor/AdaptorEthRdmaProfile.rb +106 -0
  85. data/lib/ImcSdk/mometa/adaptor/AdaptorEthRecvQueueProfile.rb +100 -0
  86. data/lib/ImcSdk/mometa/adaptor/AdaptorEthUSNICProfile.rb +167 -0
  87. data/lib/ImcSdk/mometa/adaptor/AdaptorEthWorkQueueProfile.rb +100 -0
  88. data/lib/ImcSdk/mometa/adaptor/AdaptorExtEthIf.rb +154 -0
  89. data/lib/ImcSdk/mometa/adaptor/AdaptorExtIpV6RssHashProfile.rb +100 -0
  90. data/lib/ImcSdk/mometa/adaptor/AdaptorFcBootTable.rb +106 -0
  91. data/lib/ImcSdk/mometa/adaptor/AdaptorFcCdbWorkQueueProfile.rb +100 -0
  92. data/lib/ImcSdk/mometa/adaptor/AdaptorFcErrorRecoveryProfile.rb +130 -0
  93. data/lib/ImcSdk/mometa/adaptor/AdaptorFcGenProfile.rb +133 -0
  94. data/lib/ImcSdk/mometa/adaptor/AdaptorFcInterruptProfile.rb +96 -0
  95. data/lib/ImcSdk/mometa/adaptor/AdaptorFcPersistentBindings.rb +118 -0
  96. data/lib/ImcSdk/mometa/adaptor/AdaptorFcPortFLogiProfile.rb +100 -0
  97. data/lib/ImcSdk/mometa/adaptor/AdaptorFcPortPLogiProfile.rb +100 -0
  98. data/lib/ImcSdk/mometa/adaptor/AdaptorFcPortProfile.rb +106 -0
  99. data/lib/ImcSdk/mometa/adaptor/AdaptorFcRecvQueueProfile.rb +94 -0
  100. data/lib/ImcSdk/mometa/adaptor/AdaptorFcWorkQueueProfile.rb +94 -0
  101. data/lib/ImcSdk/mometa/adaptor/AdaptorGenProfile.rb +166 -0
  102. data/lib/ImcSdk/mometa/adaptor/AdaptorHostEthIf.rb +163 -0
  103. data/lib/ImcSdk/mometa/adaptor/AdaptorHostFcIf.rb +148 -0
  104. data/lib/ImcSdk/mometa/adaptor/AdaptorIpV4RssHashProfile.rb +100 -0
  105. data/lib/ImcSdk/mometa/adaptor/AdaptorIpV6RssHashProfile.rb +100 -0
  106. data/lib/ImcSdk/mometa/adaptor/AdaptorLinkTraining.rb +79 -0
  107. data/lib/ImcSdk/mometa/adaptor/AdaptorPortProfiles.rb +100 -0
  108. data/lib/ImcSdk/mometa/adaptor/AdaptorRssProfile.rb +94 -0
  109. data/lib/ImcSdk/mometa/adaptor/AdaptorUnit.rb +155 -0
  110. data/lib/ImcSdk/mometa/advanced/AdvancedPowerProfile.rb +140 -0
  111. data/lib/ImcSdk/mometa/auto/AutoPowerProfile.rb +117 -0
  112. data/lib/ImcSdk/mometa/bios/BiosBOT.rb +88 -0
  113. data/lib/ImcSdk/mometa/bios/BiosBootDev.rb +114 -0
  114. data/lib/ImcSdk/mometa/bios/BiosBootDevGrp.rb +112 -0
  115. data/lib/ImcSdk/mometa/bios/BiosBootDevPrecision.rb +152 -0
  116. data/lib/ImcSdk/mometa/bios/BiosBootMode.rb +96 -0
  117. data/lib/ImcSdk/mometa/bios/BiosPassword.rb +73 -0
  118. data/lib/ImcSdk/mometa/bios/BiosPlatformDefaults.rb +88 -0
  119. data/lib/ImcSdk/mometa/bios/BiosProfile.rb +139 -0
  120. data/lib/ImcSdk/mometa/bios/BiosProfileManagement.rb +106 -0
  121. data/lib/ImcSdk/mometa/bios/BiosProfileToken.rb +106 -0
  122. data/lib/ImcSdk/mometa/bios/BiosSettings.rb +88 -0
  123. data/lib/ImcSdk/mometa/bios/BiosUnit.rb +106 -0
  124. data/lib/ImcSdk/mometa/bios/BiosVfASPMSupport.rb +97 -0
  125. data/lib/ImcSdk/mometa/bios/BiosVfAdjacentCacheLinePrefetch.rb +98 -0
  126. data/lib/ImcSdk/mometa/bios/BiosVfAltitude.rb +99 -0
  127. data/lib/ImcSdk/mometa/bios/BiosVfAssertNMIOnPERR.rb +98 -0
  128. data/lib/ImcSdk/mometa/bios/BiosVfAssertNMIOnSERR.rb +98 -0
  129. data/lib/ImcSdk/mometa/bios/BiosVfAutonumousCstateEnable.rb +81 -0
  130. data/lib/ImcSdk/mometa/bios/BiosVfBootOptionRetry.rb +98 -0
  131. data/lib/ImcSdk/mometa/bios/BiosVfCDNEnable.rb +92 -0
  132. data/lib/ImcSdk/mometa/bios/BiosVfCDNSupport.rb +96 -0
  133. data/lib/ImcSdk/mometa/bios/BiosVfCPUEnergyPerformance.rb +98 -0
  134. data/lib/ImcSdk/mometa/bios/BiosVfCPUFrequencyFloor.rb +98 -0
  135. data/lib/ImcSdk/mometa/bios/BiosVfCPUPerformance.rb +98 -0
  136. data/lib/ImcSdk/mometa/bios/BiosVfCPUPowerManagement.rb +98 -0
  137. data/lib/ImcSdk/mometa/bios/BiosVfCkeLowPolicy.rb +98 -0
  138. data/lib/ImcSdk/mometa/bios/BiosVfCmciEnable.rb +98 -0
  139. data/lib/ImcSdk/mometa/bios/BiosVfConsoleRedirection.rb +162 -0
  140. data/lib/ImcSdk/mometa/bios/BiosVfCoreMultiProcessing.rb +118 -0
  141. data/lib/ImcSdk/mometa/bios/BiosVfDCUPrefetch.rb +109 -0
  142. data/lib/ImcSdk/mometa/bios/BiosVfDRAMClockThrottling.rb +98 -0
  143. data/lib/ImcSdk/mometa/bios/BiosVfDemandScrub.rb +98 -0
  144. data/lib/ImcSdk/mometa/bios/BiosVfDirectCacheAccess.rb +100 -0
  145. data/lib/ImcSdk/mometa/bios/BiosVfDramRefreshRate.rb +99 -0
  146. data/lib/ImcSdk/mometa/bios/BiosVfEnhancedIntelSpeedStepTech.rb +98 -0
  147. data/lib/ImcSdk/mometa/bios/BiosVfExecuteDisableBit.rb +98 -0
  148. data/lib/ImcSdk/mometa/bios/BiosVfExtendedAPIC.rb +92 -0
  149. data/lib/ImcSdk/mometa/bios/BiosVfFRB2Enable.rb +98 -0
  150. data/lib/ImcSdk/mometa/bios/BiosVfHWPMEnable.rb +80 -0
  151. data/lib/ImcSdk/mometa/bios/BiosVfHardwarePrefetch.rb +98 -0
  152. data/lib/ImcSdk/mometa/bios/BiosVfIOHResource.rb +99 -0
  153. data/lib/ImcSdk/mometa/bios/BiosVfIntelHyperThreadingTech.rb +98 -0
  154. data/lib/ImcSdk/mometa/bios/BiosVfIntelTurboBoostTech.rb +98 -0
  155. data/lib/ImcSdk/mometa/bios/BiosVfIntelVTForDirectedIO.rb +142 -0
  156. data/lib/ImcSdk/mometa/bios/BiosVfIntelVirtualizationTechnology.rb +98 -0
  157. data/lib/ImcSdk/mometa/bios/BiosVfLOMPortOptionROM.rb +150 -0
  158. data/lib/ImcSdk/mometa/bios/BiosVfLegacyUSBSupport.rb +100 -0
  159. data/lib/ImcSdk/mometa/bios/BiosVfLvDIMMSupport.rb +97 -0
  160. data/lib/ImcSdk/mometa/bios/BiosVfMMCFGBase.rb +99 -0
  161. data/lib/ImcSdk/mometa/bios/BiosVfMemoryInterleave.rb +126 -0
  162. data/lib/ImcSdk/mometa/bios/BiosVfMemoryMappedIOAbove4GB.rb +98 -0
  163. data/lib/ImcSdk/mometa/bios/BiosVfMirroringMode.rb +96 -0
  164. data/lib/ImcSdk/mometa/bios/BiosVfNUMAOptimized.rb +98 -0
  165. data/lib/ImcSdk/mometa/bios/BiosVfOSBootWatchdogTimer.rb +98 -0
  166. data/lib/ImcSdk/mometa/bios/BiosVfOSBootWatchdogTimerPolicy.rb +97 -0
  167. data/lib/ImcSdk/mometa/bios/BiosVfOSBootWatchdogTimerTimeout.rb +98 -0
  168. data/lib/ImcSdk/mometa/bios/BiosVfOnboardNIC.rb +109 -0
  169. data/lib/ImcSdk/mometa/bios/BiosVfOnboardStorage.rb +98 -0
  170. data/lib/ImcSdk/mometa/bios/BiosVfOnboardStorageSWStack.rb +90 -0
  171. data/lib/ImcSdk/mometa/bios/BiosVfOutOfBandMgmtPort.rb +92 -0
  172. data/lib/ImcSdk/mometa/bios/BiosVfPCIOptionROMs.rb +100 -0
  173. data/lib/ImcSdk/mometa/bios/BiosVfPCISlotOptionROMEnable.rb +726 -0
  174. data/lib/ImcSdk/mometa/bios/BiosVfPCIeSSDHotPlugSupport.rb +81 -0
  175. data/lib/ImcSdk/mometa/bios/BiosVfPOSTErrorPause.rb +98 -0
  176. data/lib/ImcSdk/mometa/bios/BiosVfPStateCoordType.rb +97 -0
  177. data/lib/ImcSdk/mometa/bios/BiosVfPackageCStateLimit.rb +105 -0
  178. data/lib/ImcSdk/mometa/bios/BiosVfPatrolScrub.rb +98 -0
  179. data/lib/ImcSdk/mometa/bios/BiosVfPatrolScrubDuration.rb +94 -0
  180. data/lib/ImcSdk/mometa/bios/BiosVfPchUsb30Mode.rb +98 -0
  181. data/lib/ImcSdk/mometa/bios/BiosVfPciRomClp.rb +92 -0
  182. data/lib/ImcSdk/mometa/bios/BiosVfPowerOnPasswordSupport.rb +98 -0
  183. data/lib/ImcSdk/mometa/bios/BiosVfProcessorC1E.rb +98 -0
  184. data/lib/ImcSdk/mometa/bios/BiosVfProcessorC3Report.rb +98 -0
  185. data/lib/ImcSdk/mometa/bios/BiosVfProcessorC6Report.rb +98 -0
  186. data/lib/ImcSdk/mometa/bios/BiosVfProcessorCState.rb +98 -0
  187. data/lib/ImcSdk/mometa/bios/BiosVfPwrPerfTuning.rb +90 -0
  188. data/lib/ImcSdk/mometa/bios/BiosVfQPIConfig.rb +99 -0
  189. data/lib/ImcSdk/mometa/bios/BiosVfQpiSnoopMode.rb +94 -0
  190. data/lib/ImcSdk/mometa/bios/BiosVfResumeOnACPowerLoss.rb +111 -0
  191. data/lib/ImcSdk/mometa/bios/BiosVfSataModeSelect.rb +97 -0
  192. data/lib/ImcSdk/mometa/bios/BiosVfSelectMemoryRASConfiguration.rb +98 -0
  193. data/lib/ImcSdk/mometa/bios/BiosVfSerialPortAEnable.rb +98 -0
  194. data/lib/ImcSdk/mometa/bios/BiosVfSparingMode.rb +96 -0
  195. data/lib/ImcSdk/mometa/bios/BiosVfSrIov.rb +98 -0
  196. data/lib/ImcSdk/mometa/bios/BiosVfTPMSupport.rb +98 -0
  197. data/lib/ImcSdk/mometa/bios/BiosVfUCSMBootOrderRuleControl.rb +96 -0
  198. data/lib/ImcSdk/mometa/bios/BiosVfUSBBootConfig.rb +98 -0
  199. data/lib/ImcSdk/mometa/bios/BiosVfUSBEmulation.rb +98 -0
  200. data/lib/ImcSdk/mometa/bios/BiosVfUSBPortsConfig.rb +164 -0
  201. data/lib/ImcSdk/mometa/bios/BiosVfVgaPriority.rb +97 -0
  202. data/lib/ImcSdk/mometa/bios/BiosVfWorkLoadConfig.rb +90 -0
  203. data/lib/ImcSdk/mometa/bmc/BmcResetReason.rb +77 -0
  204. data/lib/ImcSdk/mometa/certificate/CertificateManagement.rb +94 -0
  205. data/lib/ImcSdk/mometa/chassis/ChassisPIDCatalog.rb +77 -0
  206. data/lib/ImcSdk/mometa/chassis/ChassisPowerBudget.rb +110 -0
  207. data/lib/ImcSdk/mometa/chassis/ChassisPowerMonitor.rb +93 -0
  208. data/lib/ImcSdk/mometa/chassis/ChassisPowerUtilization.rb +77 -0
  209. data/lib/ImcSdk/mometa/comm/CommEpIpmiLan.rb +87 -0
  210. data/lib/ImcSdk/mometa/comm/CommHttp.rb +149 -0
  211. data/lib/ImcSdk/mometa/comm/CommHttps.rb +141 -0
  212. data/lib/ImcSdk/mometa/comm/CommIpmiLan.rb +108 -0
  213. data/lib/ImcSdk/mometa/comm/CommKvm.rb +124 -0
  214. data/lib/ImcSdk/mometa/comm/CommNtpProvider.rb +130 -0
  215. data/lib/ImcSdk/mometa/comm/CommRedfish.rb +86 -0
  216. data/lib/ImcSdk/mometa/comm/CommSavedVMediaMap.rb +148 -0
  217. data/lib/ImcSdk/mometa/comm/CommSnmp.rb +169 -0
  218. data/lib/ImcSdk/mometa/comm/CommSnmpTrap.rb +149 -0
  219. data/lib/ImcSdk/mometa/comm/CommSnmpUser.rb +147 -0
  220. data/lib/ImcSdk/mometa/comm/CommSsh.rb +141 -0
  221. data/lib/ImcSdk/mometa/comm/CommSvcEp.rb +88 -0
  222. data/lib/ImcSdk/mometa/comm/CommSvcRack.rb +73 -0
  223. data/lib/ImcSdk/mometa/comm/CommSyslog.rb +151 -0
  224. data/lib/ImcSdk/mometa/comm/CommSyslogClient.rb +123 -0
  225. data/lib/ImcSdk/mometa/comm/CommVMedia.rb +122 -0
  226. data/lib/ImcSdk/mometa/comm/CommVMediaMap.rb +153 -0
  227. data/lib/ImcSdk/mometa/compute/ComputeBoard.rb +178 -0
  228. data/lib/ImcSdk/mometa/compute/ComputeMbPowerStats.rb +112 -0
  229. data/lib/ImcSdk/mometa/compute/ComputeRackUnit.rb +206 -0
  230. data/lib/ImcSdk/mometa/compute/ComputeRackUnitMbTempStats.rb +101 -0
  231. data/lib/ImcSdk/mometa/compute/ComputeServerNode.rb +192 -0
  232. data/lib/ImcSdk/mometa/compute/ComputeServerNodeMbTempStats.rb +101 -0
  233. data/lib/ImcSdk/mometa/compute/ComputeServerRef.rb +81 -0
  234. data/lib/ImcSdk/mometa/compute/ComputeSharedIOMbPowerStats.rb +89 -0
  235. data/lib/ImcSdk/mometa/compute/ComputeSharedIOMbTempStats.rb +99 -0
  236. data/lib/ImcSdk/mometa/current/CurrentCertificate.rb +178 -0
  237. data/lib/ImcSdk/mometa/custom/CustomPowerProfile.rb +103 -0
  238. data/lib/ImcSdk/mometa/download/DownloadClientCertificate.rb +106 -0
  239. data/lib/ImcSdk/mometa/download/DownloadClientPrivateKey.rb +106 -0
  240. data/lib/ImcSdk/mometa/download/DownloadLdapCACertificate.rb +135 -0
  241. data/lib/ImcSdk/mometa/download/DownloadRootCACertificate.rb +106 -0
  242. data/lib/ImcSdk/mometa/equipment/EquipmentChassis.rb +93 -0
  243. data/lib/ImcSdk/mometa/equipment/EquipmentChassisLocatorLed.rb +106 -0
  244. data/lib/ImcSdk/mometa/equipment/EquipmentFan.rb +223 -0
  245. data/lib/ImcSdk/mometa/equipment/EquipmentFanModule.rb +217 -0
  246. data/lib/ImcSdk/mometa/equipment/EquipmentIndicatorLed.rb +122 -0
  247. data/lib/ImcSdk/mometa/equipment/EquipmentLocatorLed.rb +131 -0
  248. data/lib/ImcSdk/mometa/equipment/EquipmentPsu.rb +235 -0
  249. data/lib/ImcSdk/mometa/equipment/EquipmentPsuColdRedundancy.rb +77 -0
  250. data/lib/ImcSdk/mometa/equipment/EquipmentPsuFan.rb +186 -0
  251. data/lib/ImcSdk/mometa/equipment/EquipmentSharedIOModule.rb +125 -0
  252. data/lib/ImcSdk/mometa/equipment/EquipmentSystemIOController.rb +87 -0
  253. data/lib/ImcSdk/mometa/equipment/EquipmentTpm.rb +164 -0
  254. data/lib/ImcSdk/mometa/error/Error.rb +98 -0
  255. data/lib/ImcSdk/mometa/event/EventManagement.rb +100 -0
  256. data/lib/ImcSdk/mometa/export/ExportClientCertificate.rb +106 -0
  257. data/lib/ImcSdk/mometa/export/ExportClientPrivateKey.rb +106 -0
  258. data/lib/ImcSdk/mometa/export/ExportLdapCACertificate.rb +135 -0
  259. data/lib/ImcSdk/mometa/export/ExportRootCACertificate.rb +106 -0
  260. data/lib/ImcSdk/mometa/fan/FanPolicy.rb +89 -0
  261. data/lib/ImcSdk/mometa/fault/FaultInst.rb +238 -0
  262. data/lib/ImcSdk/mometa/firmware/FirmwareBootDefinition.rb +101 -0
  263. data/lib/ImcSdk/mometa/firmware/FirmwareBootUnit.rb +159 -0
  264. data/lib/ImcSdk/mometa/firmware/FirmwareRunning.rb +124 -0
  265. data/lib/ImcSdk/mometa/firmware/FirmwareUpdatable.rb +197 -0
  266. data/lib/ImcSdk/mometa/generate/GenerateCertificateSigningRequest.rb +435 -0
  267. data/lib/ImcSdk/mometa/generate/GenerateRandomPassword.rb +94 -0
  268. data/lib/ImcSdk/mometa/generated/GeneratedStorageControllerKeyId.rb +77 -0
  269. data/lib/ImcSdk/mometa/huu/HuuController.rb +94 -0
  270. data/lib/ImcSdk/mometa/huu/HuuFirmwareCatalog.rb +100 -0
  271. data/lib/ImcSdk/mometa/huu/HuuFirmwareCatalogComponent.rb +106 -0
  272. data/lib/ImcSdk/mometa/huu/HuuFirmwareComponent.rb +154 -0
  273. data/lib/ImcSdk/mometa/huu/HuuFirmwareRunning.rb +106 -0
  274. data/lib/ImcSdk/mometa/huu/HuuFirmwareUpdateCancel.rb +95 -0
  275. data/lib/ImcSdk/mometa/huu/HuuFirmwareUpdateStatus.rb +118 -0
  276. data/lib/ImcSdk/mometa/huu/HuuFirmwareUpdater.rb +179 -0
  277. data/lib/ImcSdk/mometa/huu/HuuUpdateComponentStatus.rb +178 -0
  278. data/lib/ImcSdk/mometa/io/IoExpander.rb +104 -0
  279. data/lib/ImcSdk/mometa/iod/IodController.rb +94 -0
  280. data/lib/ImcSdk/mometa/iod/IodSnapshotCancel.rb +101 -0
  281. data/lib/ImcSdk/mometa/iod/IodSnapshotStart.rb +192 -0
  282. data/lib/ImcSdk/mometa/iod/IodSnapshotStatus.rb +148 -0
  283. data/lib/ImcSdk/mometa/ip/IpBlocking.rb +118 -0
  284. data/lib/ImcSdk/mometa/ip/IpFiltering.rb +128 -0
  285. data/lib/ImcSdk/mometa/kmip/KmipManagement.rb +95 -0
  286. data/lib/ImcSdk/mometa/kmip/KmipServer.rb +98 -0
  287. data/lib/ImcSdk/mometa/kmip/KmipServerLogin.rb +89 -0
  288. data/lib/ImcSdk/mometa/ldap/LdapCACertificate.rb +107 -0
  289. data/lib/ImcSdk/mometa/ldap/LdapCACertificateManagement.rb +100 -0
  290. data/lib/ImcSdk/mometa/lsboot/LsbootBootSecurity.rb +99 -0
  291. data/lib/ImcSdk/mometa/lsboot/LsbootDef.rb +111 -0
  292. data/lib/ImcSdk/mometa/lsboot/LsbootDevPrecision.rb +139 -0
  293. data/lib/ImcSdk/mometa/lsboot/LsbootEfi.rb +107 -0
  294. data/lib/ImcSdk/mometa/lsboot/LsbootHdd.rb +127 -0
  295. data/lib/ImcSdk/mometa/lsboot/LsbootIscsi.rb +133 -0
  296. data/lib/ImcSdk/mometa/lsboot/LsbootLan.rb +116 -0
  297. data/lib/ImcSdk/mometa/lsboot/LsbootLocalStorage.rb +88 -0
  298. data/lib/ImcSdk/mometa/lsboot/LsbootNVMe.rb +114 -0
  299. data/lib/ImcSdk/mometa/lsboot/LsbootPchStorage.rb +120 -0
  300. data/lib/ImcSdk/mometa/lsboot/LsbootPxe.rb +133 -0
  301. data/lib/ImcSdk/mometa/lsboot/LsbootSan.rb +133 -0
  302. data/lib/ImcSdk/mometa/lsboot/LsbootSd.rb +127 -0
  303. data/lib/ImcSdk/mometa/lsboot/LsbootStorage.rb +107 -0
  304. data/lib/ImcSdk/mometa/lsboot/LsbootUefiShell.rb +114 -0
  305. data/lib/ImcSdk/mometa/lsboot/LsbootUsb.rb +124 -0
  306. data/lib/ImcSdk/mometa/lsboot/LsbootVMedia.rb +138 -0
  307. data/lib/ImcSdk/mometa/lsboot/LsbootVirtualMedia.rb +108 -0
  308. data/lib/ImcSdk/mometa/memory/MemoryArray.rb +200 -0
  309. data/lib/ImcSdk/mometa/memory/MemoryUnit.rb +299 -0
  310. data/lib/ImcSdk/mometa/memory/MemoryUnitEnvStats.rb +112 -0
  311. data/lib/ImcSdk/mometa/mgmt/MgmtBackup.rb +172 -0
  312. data/lib/ImcSdk/mometa/mgmt/MgmtBackupServer.rb +132 -0
  313. data/lib/ImcSdk/mometa/mgmt/MgmtController.rb +118 -0
  314. data/lib/ImcSdk/mometa/mgmt/MgmtIf.rb +388 -0
  315. data/lib/ImcSdk/mometa/mgmt/MgmtImporter.rb +172 -0
  316. data/lib/ImcSdk/mometa/mgmt/MgmtImporterServer.rb +132 -0
  317. data/lib/ImcSdk/mometa/mgmt/MgmtInventory.rb +143 -0
  318. data/lib/ImcSdk/mometa/network/NetworkAdapterEthIf.rb +100 -0
  319. data/lib/ImcSdk/mometa/network/NetworkAdapterUnit.rb +116 -0
  320. data/lib/ImcSdk/mometa/one/OneTimeBootDevice.rb +103 -0
  321. data/lib/ImcSdk/mometa/one/OneTimePrecisionBootDevice.rb +116 -0
  322. data/lib/ImcSdk/mometa/osi/OsiCancel.rb +101 -0
  323. data/lib/ImcSdk/mometa/osi/OsiController.rb +94 -0
  324. data/lib/ImcSdk/mometa/osi/OsiStart.rb +266 -0
  325. data/lib/ImcSdk/mometa/osi/OsiStatus.rb +148 -0
  326. data/lib/ImcSdk/mometa/pci/PciEquipSlot.rb +124 -0
  327. data/lib/ImcSdk/mometa/pid/PidCatalog.rb +100 -0
  328. data/lib/ImcSdk/mometa/pid/PidCatalogCpu.rb +136 -0
  329. data/lib/ImcSdk/mometa/pid/PidCatalogDimm.rb +154 -0
  330. data/lib/ImcSdk/mometa/pid/PidCatalogHdd.rb +130 -0
  331. data/lib/ImcSdk/mometa/pid/PidCatalogPCIAdapter.rb +130 -0
  332. data/lib/ImcSdk/mometa/platform/PlatformEventFilters.rb +109 -0
  333. data/lib/ImcSdk/mometa/power/PowerBudget.rb +146 -0
  334. data/lib/ImcSdk/mometa/power/PowerMonitor.rb +123 -0
  335. data/lib/ImcSdk/mometa/processor/ProcessorEnvStats.rb +112 -0
  336. data/lib/ImcSdk/mometa/processor/ProcessorUnit.rb +213 -0
  337. data/lib/ImcSdk/mometa/self/SelfEncryptStorageController.rb +98 -0
  338. data/lib/ImcSdk/mometa/server/ServerUtilization.rb +112 -0
  339. data/lib/ImcSdk/mometa/sioc/SiocResetReason.rb +77 -0
  340. data/lib/ImcSdk/mometa/sol/SolIf.rb +128 -0
  341. data/lib/ImcSdk/mometa/standard/StandardPowerProfile.rb +108 -0
  342. data/lib/ImcSdk/mometa/storage/StorageController.rb +165 -0
  343. data/lib/ImcSdk/mometa/storage/StorageControllerHealth.rb +100 -0
  344. data/lib/ImcSdk/mometa/storage/StorageControllerNVMe.rb +154 -0
  345. data/lib/ImcSdk/mometa/storage/StorageControllerProps.rb +406 -0
  346. data/lib/ImcSdk/mometa/storage/StorageControllerSettings.rb +220 -0
  347. data/lib/ImcSdk/mometa/storage/StorageEnclosure.rb +82 -0
  348. data/lib/ImcSdk/mometa/storage/StorageEnclosureDisk.rb +149 -0
  349. data/lib/ImcSdk/mometa/storage/StorageEnclosureDiskFwHelper.rb +108 -0
  350. data/lib/ImcSdk/mometa/storage/StorageEnclosureDiskSlotEp.rb +85 -0
  351. data/lib/ImcSdk/mometa/storage/StorageEnclosureDiskSlotZoneHelper.rb +97 -0
  352. data/lib/ImcSdk/mometa/storage/StorageFlexFlashController.rb +193 -0
  353. data/lib/ImcSdk/mometa/storage/StorageFlexFlashControllerProps.rb +202 -0
  354. data/lib/ImcSdk/mometa/storage/StorageFlexFlashOperationalProfile.rb +164 -0
  355. data/lib/ImcSdk/mometa/storage/StorageFlexFlashPhysicalDrive.rb +256 -0
  356. data/lib/ImcSdk/mometa/storage/StorageFlexFlashVirtualDrive.rb +152 -0
  357. data/lib/ImcSdk/mometa/storage/StorageFlexFlashVirtualDriveImageMap.rb +145 -0
  358. data/lib/ImcSdk/mometa/storage/StorageLocalDisk.rb +247 -0
  359. data/lib/ImcSdk/mometa/storage/StorageLocalDiskEp.rb +77 -0
  360. data/lib/ImcSdk/mometa/storage/StorageLocalDiskProps.rb +250 -0
  361. data/lib/ImcSdk/mometa/storage/StorageLocalDiskSlotEp.rb +146 -0
  362. data/lib/ImcSdk/mometa/storage/StorageLocalDiskUsage.rb +124 -0
  363. data/lib/ImcSdk/mometa/storage/StorageOperation.rb +112 -0
  364. data/lib/ImcSdk/mometa/storage/StorageRaidBattery.rb +252 -0
  365. data/lib/ImcSdk/mometa/storage/StorageSasExpander.rb +113 -0
  366. data/lib/ImcSdk/mometa/storage/StorageSasUplink.rb +121 -0
  367. data/lib/ImcSdk/mometa/storage/StorageUnusedLocalDisk.rb +124 -0
  368. data/lib/ImcSdk/mometa/storage/StorageVirtualDrive.rb +307 -0
  369. data/lib/ImcSdk/mometa/storage/StorageVirtualDriveCreatorUsingUnusedPhysicalDrive.rb +223 -0
  370. data/lib/ImcSdk/mometa/storage/StorageVirtualDriveCreatorUsingVirtualDriveGroup.rb +199 -0
  371. data/lib/ImcSdk/mometa/storage/StorageVirtualDriveWithDriveGroupSpace.rb +130 -0
  372. data/lib/ImcSdk/mometa/suggested/SuggestedStorageControllerSecurityKey.rb +77 -0
  373. data/lib/ImcSdk/mometa/sysdebug/SysdebugMEpLog.rb +122 -0
  374. data/lib/ImcSdk/mometa/sysdebug/SysdebugTechSupportExport.rb +149 -0
  375. data/lib/ImcSdk/mometa/system/SystemIOController.rb +81 -0
  376. data/lib/ImcSdk/mometa/thermal/ThermalPowerProfile.rb +89 -0
  377. data/lib/ImcSdk/mometa/top/TopRoot.rb +88 -0
  378. data/lib/ImcSdk/mometa/top/TopSystem.rb +561 -0
  379. data/lib/ImcSdk/mometa/upload/UploadBiosProfile.rb +129 -0
  380. data/lib/ImcSdk/mometa/upload/UploadCertificate.rb +136 -0
  381. data/lib/ImcSdk/mometa/upload/UploadPIDCatalog.rb +129 -0
  382. data/lib/ImcSdk/version.rb +3 -0
  383. data/spec/ImcSdk_spec.rb +11 -0
  384. data/spec/spec_helper.rb +11 -0
  385. data/test/ImcSdk_bios_test.rb +57 -0
  386. data/test/ImcSdk_ipmi_test.rb +65 -0
  387. data/test/ImcSdk_ldap_test.rb +79 -0
  388. data/test/ImcSdk_ntp_test.rb +88 -0
  389. data/test/ImcSdk_powerbudget_test.rb +64 -0
  390. data/test/ImcSdk_remotepresence_test.rb +60 -0
  391. data/test/ImcSdk_serveractions_test.rb +69 -0
  392. data/test/ImcSdk_storage_test.rb +60 -0
  393. data/test/ImcSdk_user_test.rb +98 -0
  394. data/test/test_helper.rb +21 -0
  395. metadata +492 -0
@@ -0,0 +1,15 @@
1
+ require "bundler/gem_tasks"
2
+ require "rake/testtask"
3
+ #require "rspec/core/rake_task"
4
+
5
+ #RSpec::Core::RakeTask.new(:spec)
6
+
7
+ #task :default => :spec
8
+
9
+ Rake::TestTask.new do |t|
10
+ t.libs << "test"
11
+ t.test_files = FileList["test/**/*_test.rb"]
12
+ t.verbose = false
13
+ end
14
+
15
+ task default: :test
@@ -0,0 +1,14 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require "bundler/setup"
4
+ require "ImcSdk"
5
+
6
+ # You can add fixtures and/or initialization code here to make experimenting
7
+ # with your gem easier. You can also use a different console, if you like.
8
+
9
+ # (If you use this, don't forget to add pry to your Gemfile!)
10
+ # require "pry"
11
+ # Pry.start
12
+
13
+ require "irb"
14
+ IRB.start(__FILE__)
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ IFS=$'\n\t'
4
+ set -vx
5
+
6
+ bundle install
7
+
8
+ # Do any other automated setup that you need to do here
@@ -0,0 +1,2900 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>
7
+ Class: ImcHandle
8
+
9
+ &mdash; Cisco IMC Ruby SDK
10
+
11
+ </title>
12
+
13
+ <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
14
+
15
+ <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
16
+
17
+ <script type="text/javascript" charset="utf-8">
18
+ pathId = "ImcHandle";
19
+ relpath = '';
20
+ </script>
21
+
22
+
23
+ <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
24
+
25
+ <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
26
+
27
+
28
+ </head>
29
+ <body>
30
+ <div class="nav_wrap">
31
+ <iframe id="nav" src="class_list.html?1"></iframe>
32
+ <div id="resizer"></div>
33
+ </div>
34
+
35
+ <div id="main" tabindex="-1">
36
+ <div id="header">
37
+ <div id="menu">
38
+
39
+ <a href="_index.html">Index (I)</a> &raquo;
40
+
41
+
42
+ <span class="title">ImcHandle</span>
43
+
44
+ </div>
45
+
46
+ <div id="search">
47
+
48
+ <a class="full_list_link" id="class_list_link"
49
+ href="class_list.html">
50
+
51
+ <svg width="24" height="24">
52
+ <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
53
+ <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
54
+ <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
55
+ </svg>
56
+ </a>
57
+
58
+ </div>
59
+ <div class="clear"></div>
60
+ </div>
61
+
62
+ <div id="content"><h1>Class: ImcHandle
63
+
64
+
65
+
66
+ </h1>
67
+ <div class="box_info">
68
+
69
+ <dl>
70
+ <dt>Inherits:</dt>
71
+ <dd>
72
+ <span class="inheritName">ImcSession</span>
73
+
74
+ <ul class="fullTree">
75
+ <li>Object</li>
76
+
77
+ <li class="next">ImcSession</li>
78
+
79
+ <li class="next">ImcHandle</li>
80
+
81
+ </ul>
82
+ <a href="#" class="inheritanceTree">show all</a>
83
+
84
+ </dd>
85
+ </dl>
86
+
87
+
88
+
89
+
90
+
91
+
92
+
93
+
94
+
95
+
96
+
97
+ <dl>
98
+ <dt>Defined in:</dt>
99
+ <dd>lib/ImcSdk.rb</dd>
100
+ </dl>
101
+
102
+ </div>
103
+
104
+ <h2>Overview</h2><div class="docstring">
105
+ <div class="discussion">
106
+
107
+ <p>ImcHandle class is the user interface point for any Imc communication.</p>
108
+
109
+
110
+ </div>
111
+ </div>
112
+ <div class="tags">
113
+
114
+ <p class="tag_title">Author:</p>
115
+ <ul class="author">
116
+
117
+ <li>
118
+
119
+
120
+
121
+
122
+
123
+ <div class='inline'>
124
+ <p>Amit Mandal(amimanda@cisco.com)</p>
125
+ </div>
126
+
127
+ </li>
128
+
129
+ </ul>
130
+
131
+ </div>
132
+
133
+
134
+
135
+ <h2>Instance Attribute Summary <small><a href="#" class="summary_toggle">collapse</a></small></h2>
136
+ <ul class="summary">
137
+
138
+ <li class="public ">
139
+ <span class="summary_signature">
140
+
141
+ <a href="#to_commit-instance_method" title="#to_commit (instance method)">#<strong>to_commit</strong> &#x21d2; Object </a>
142
+
143
+
144
+
145
+ </span>
146
+
147
+
148
+
149
+
150
+
151
+
152
+
153
+
154
+
155
+
156
+
157
+
158
+ <span class="summary_desc"><div class='inline'>
159
+ <p>ImcHandle class is the user interface point for any Imc communication.</p>
160
+ </div></span>
161
+
162
+ </li>
163
+
164
+
165
+ </ul>
166
+
167
+
168
+
169
+
170
+
171
+ <h2>
172
+ Instance Method Summary
173
+ <small><a href="#" class="summary_toggle">collapse</a></small>
174
+ </h2>
175
+
176
+ <ul class="summary">
177
+
178
+ <li class="public ">
179
+ <span class="summary_signature">
180
+
181
+ <a href="#add_mo-instance_method" title="#add_mo (instance method)">#<strong>add_mo</strong>(mo:, modify_present: true, timeout: &quot;60&quot;) &#x21d2; nil </a>
182
+
183
+
184
+
185
+ </span>
186
+
187
+
188
+
189
+
190
+
191
+
192
+
193
+
194
+
195
+ <span class="summary_desc"><div class='inline'>
196
+ <p>Add a Managed Object to the IMC Server.</p>
197
+ </div></span>
198
+
199
+ </li>
200
+
201
+
202
+ <li class="public ">
203
+ <span class="summary_signature">
204
+
205
+ <a href="#get_auth_token-instance_method" title="#get_auth_token (instance method)">#<strong>get_auth_token</strong>(timeout: &quot;60&quot;) &#x21d2; String </a>
206
+
207
+
208
+
209
+ </span>
210
+
211
+
212
+
213
+
214
+
215
+
216
+
217
+
218
+
219
+ <span class="summary_desc"><div class='inline'>
220
+ <p>Returns a token that is used for IMC authentication.</p>
221
+ </div></span>
222
+
223
+ </li>
224
+
225
+
226
+ <li class="public ">
227
+ <span class="summary_signature">
228
+
229
+ <a href="#initialize-instance_method" title="#initialize (instance method)">#<strong>initialize</strong>(ip:, username:, password:, port: &quot;80&quot;, secure: nil, proxy: nil) &#x21d2; ImcHandle </a>
230
+
231
+
232
+
233
+ </span>
234
+
235
+
236
+ <span class="note title constructor">constructor</span>
237
+
238
+
239
+
240
+
241
+
242
+
243
+
244
+
245
+ <span class="summary_desc"><div class='inline'>
246
+ <p>Create an object of ImcHandle class.</p>
247
+ </div></span>
248
+
249
+ </li>
250
+
251
+
252
+ <li class="public ">
253
+ <span class="summary_signature">
254
+
255
+ <a href="#login-instance_method" title="#login (instance method)">#<strong>login</strong>(auto_refresh: false, force: false, timeout: &quot;60&quot;) &#x21d2; TrueClass, FalseClass </a>
256
+
257
+
258
+
259
+ </span>
260
+
261
+
262
+
263
+
264
+
265
+
266
+
267
+
268
+
269
+ <span class="summary_desc"><div class='inline'>
270
+ <p>Initiated a connection to the server referenced by the ImcHandle.</p>
271
+ </div></span>
272
+
273
+ </li>
274
+
275
+
276
+ <li class="public ">
277
+ <span class="summary_signature">
278
+
279
+ <a href="#logout-instance_method" title="#logout (instance method)">#<strong>logout</strong>(timeout: &quot;60&quot;) &#x21d2; TrueClass, FalseClass </a>
280
+
281
+
282
+
283
+ </span>
284
+
285
+
286
+
287
+
288
+
289
+
290
+
291
+
292
+
293
+ <span class="summary_desc"><div class='inline'>
294
+ <p>Disconnects from the server referenced by the ImcHandle.</p>
295
+ </div></span>
296
+
297
+ </li>
298
+
299
+
300
+ <li class="public ">
301
+ <span class="summary_signature">
302
+
303
+ <a href="#process_xml_elem-instance_method" title="#process_xml_elem (instance method)">#<strong>process_xml_elem</strong>(elem, timeout: &quot;60&quot;) &#x21d2; External Method Object, MO List </a>
304
+
305
+
306
+
307
+ </span>
308
+
309
+
310
+
311
+
312
+
313
+
314
+
315
+
316
+
317
+ <span class="summary_desc"><div class='inline'>
318
+ <p>process_xml_elem is a helper method which posts xml elements to the server
319
+ and returns parsed response.</p>
320
+ </div></span>
321
+
322
+ </li>
323
+
324
+
325
+ <li class="public ">
326
+ <span class="summary_signature">
327
+
328
+ <a href="#query_children-instance_method" title="#query_children (instance method)">#<strong>query_children</strong>(in_mo: nil, in_dn: nil, class_id: nil, hierarchy: false, timeout: &quot;60&quot;) &#x21d2; Array&lt;ManagedObject&gt;<sup>?</sup> </a>
329
+
330
+
331
+
332
+ </span>
333
+
334
+
335
+
336
+
337
+
338
+
339
+
340
+
341
+
342
+ <span class="summary_desc"><div class='inline'>
343
+ <p>Finds children of a given managed object or distinguished name.</p>
344
+ </div></span>
345
+
346
+ </li>
347
+
348
+
349
+ <li class="public ">
350
+ <span class="summary_signature">
351
+
352
+ <a href="#query_classid-instance_method" title="#query_classid (instance method)">#<strong>query_classid</strong>(class_id:, hierarchy: false, need_response: false, timeout: &quot;60&quot;) &#x21d2; Array&lt;ManagedObject&gt;, ... </a>
353
+
354
+
355
+
356
+ </span>
357
+
358
+
359
+
360
+
361
+
362
+
363
+
364
+
365
+
366
+ <span class="summary_desc"><div class='inline'>
367
+ <p>Finds an object using it&#39;s class id.</p>
368
+ </div></span>
369
+
370
+ </li>
371
+
372
+
373
+ <li class="public ">
374
+ <span class="summary_signature">
375
+
376
+ <a href="#query_dn-instance_method" title="#query_dn (instance method)">#<strong>query_dn</strong>(dn:, hierarchy: false, need_response: false, timeout: &quot;60&quot;) &#x21d2; ManagedObject, ... </a>
377
+
378
+
379
+
380
+ </span>
381
+
382
+
383
+
384
+
385
+
386
+
387
+
388
+
389
+
390
+ <span class="summary_desc"><div class='inline'>
391
+ <p>Finds an object using it&#39;s distinguished name.</p>
392
+ </div></span>
393
+
394
+ </li>
395
+
396
+
397
+ <li class="public ">
398
+ <span class="summary_signature">
399
+
400
+ <a href="#remove_mo-instance_method" title="#remove_mo (instance method)">#<strong>remove_mo</strong>(mo:, timeout: &quot;60&quot;) &#x21d2; nil </a>
401
+
402
+
403
+
404
+ </span>
405
+
406
+
407
+
408
+
409
+
410
+
411
+
412
+
413
+
414
+ <span class="summary_desc"><div class='inline'>
415
+ <p>Remove a Managed Object from the IMC Server.</p>
416
+ </div></span>
417
+
418
+ </li>
419
+
420
+
421
+ <li class="public ">
422
+ <span class="summary_signature">
423
+
424
+ <a href="#set_mo-instance_method" title="#set_mo (instance method)">#<strong>set_mo</strong>(mo:, timeout: &quot;60&quot;) &#x21d2; nil </a>
425
+
426
+
427
+
428
+ </span>
429
+
430
+
431
+
432
+
433
+
434
+
435
+
436
+
437
+
438
+ <span class="summary_desc"><div class='inline'>
439
+ <p>Modifies a managed object and adds it to the ImcHandle commit buffer (if
440
+ not already in it).</p>
441
+ </div></span>
442
+
443
+ </li>
444
+
445
+
446
+ </ul>
447
+
448
+
449
+
450
+ <div id="constructor_details" class="method_details_list">
451
+ <h2>Constructor Details</h2>
452
+
453
+ <div class="method_details first">
454
+ <h3 class="signature first" id="initialize-instance_method">
455
+
456
+ #<strong>initialize</strong>(ip:, username:, password:, port: &quot;80&quot;, secure: nil, proxy: nil) &#x21d2; <tt><span class='object_link'><a href="" title="ImcHandle (class)">ImcHandle</a></span></tt>
457
+
458
+
459
+
460
+
461
+
462
+ </h3><div class="docstring">
463
+ <div class="discussion">
464
+
465
+ <p>Create an object of ImcHandle class</p>
466
+
467
+
468
+ </div>
469
+ </div>
470
+ <div class="tags">
471
+
472
+ <div class="examples">
473
+ <p class="tag_title">Examples:</p>
474
+
475
+
476
+ <pre class="example code"><code>handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;)</code></pre>
477
+
478
+
479
+ <pre class="example code"><code>handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, secure: true)</code></pre>
480
+
481
+
482
+ <pre class="example code"><code>handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, secure: false)</code></pre>
483
+
484
+
485
+ <pre class="example code"><code>handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, port: 80)</code></pre>
486
+
487
+
488
+ <pre class="example code"><code>handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, port: 443)</code></pre>
489
+
490
+
491
+ <pre class="example code"><code>handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, port: 100, secure: true)</code></pre>
492
+
493
+
494
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="" title="ImcHandle (class)">ImcHandle</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='label'>ip:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>192.168.1.1</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span><span class='label'>username:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>admin</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span><span class='label'>password:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>password</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>port:</span> <span class='int'>100</span><span class='comma'>,</span> <span class='label'>secure:</span> <span class='kw'>false</span><span class='rparen'>)</span></code></pre>
495
+
496
+ </div>
497
+ <p class="tag_title">Parameters:</p>
498
+ <ul class="param">
499
+
500
+ <li>
501
+
502
+ <span class='name'>ip</span>
503
+
504
+
505
+ <span class='type'>(<tt>String</tt>)</span>
506
+
507
+
508
+
509
+ &mdash;
510
+ <div class='inline'>
511
+ <p>The IP or Hostname of the IMC Server</p>
512
+ </div>
513
+
514
+ </li>
515
+
516
+ <li>
517
+
518
+ <span class='name'>username</span>
519
+
520
+
521
+ <span class='type'>(<tt>String</tt>)</span>
522
+
523
+
524
+
525
+ &mdash;
526
+ <div class='inline'>
527
+ <p>The username as configured on the Imc Server</p>
528
+ </div>
529
+
530
+ </li>
531
+
532
+ <li>
533
+
534
+ <span class='name'>password</span>
535
+
536
+
537
+ <span class='type'>(<tt>String</tt>)</span>
538
+
539
+
540
+
541
+ &mdash;
542
+ <div class='inline'>
543
+ <p>The password as configured on the Imc Server</p>
544
+ </div>
545
+
546
+ </li>
547
+
548
+ <li>
549
+
550
+ <span class='name'>port</span>
551
+
552
+
553
+ <span class='type'>(<tt>Integer</tt>, <tt>nil</tt>)</span>
554
+
555
+
556
+
557
+ &mdash;
558
+ <div class='inline'>
559
+ <p>The port number to be used during connection</p>
560
+ </div>
561
+
562
+ </li>
563
+
564
+ <li>
565
+
566
+ <span class='name'>secure</span>
567
+
568
+
569
+ <span class='type'>(<tt>bool</tt>, <tt>nil</tt>)</span>
570
+
571
+
572
+
573
+ &mdash;
574
+ <div class='inline'>
575
+ <p>true for secure connection, otherwise false</p>
576
+ </div>
577
+
578
+ </li>
579
+
580
+ <li>
581
+
582
+ <span class='name'>proxy</span>
583
+
584
+
585
+ <span class='type'>(<tt>String</tt>, <tt>nil</tt>)</span>
586
+
587
+
588
+
589
+ &mdash;
590
+ <div class='inline'>
591
+ <p>The proxy object to be used to connect</p>
592
+ </div>
593
+
594
+ </li>
595
+
596
+ </ul>
597
+
598
+
599
+ </div><table class="source_code">
600
+ <tr>
601
+ <td>
602
+ <pre class="lines">
603
+
604
+
605
+ 40
606
+ 41
607
+ 42
608
+ 43</pre>
609
+ </td>
610
+ <td>
611
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 40</span>
612
+
613
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>ip:</span><span class='comma'>,</span> <span class='label'>username:</span><span class='comma'>,</span> <span class='label'>password:</span><span class='comma'>,</span> <span class='label'>port:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>80</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>secure:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>proxy:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
614
+ <span class='kw'>super</span><span class='lparen'>(</span><span class='label'>ip:</span> <span class='id identifier rubyid_ip'>ip</span><span class='comma'>,</span> <span class='label'>username:</span> <span class='id identifier rubyid_username'>username</span><span class='comma'>,</span> <span class='label'>password:</span> <span class='id identifier rubyid_password'>password</span><span class='comma'>,</span> <span class='label'>port:</span> <span class='id identifier rubyid_port'>port</span><span class='comma'>,</span> <span class='label'>secure:</span> <span class='id identifier rubyid_secure'>secure</span><span class='comma'>,</span> <span class='label'>proxy:</span> <span class='id identifier rubyid_proxy'>proxy</span><span class='rparen'>)</span>
615
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
616
+ <span class='kw'>end</span></pre>
617
+ </td>
618
+ </tr>
619
+ </table>
620
+ </div>
621
+
622
+ </div>
623
+
624
+ <div id="instance_attr_details" class="attr_details">
625
+ <h2>Instance Attribute Details</h2>
626
+
627
+
628
+ <span id="to_commit=-instance_method"></span>
629
+ <div class="method_details first">
630
+ <h3 class="signature first" id="to_commit-instance_method">
631
+
632
+ #<strong>to_commit</strong> &#x21d2; <tt>Object</tt>
633
+
634
+
635
+
636
+
637
+
638
+ </h3><div class="docstring">
639
+ <div class="discussion">
640
+
641
+ <p>ImcHandle class is the user interface point for any Imc communication.</p>
642
+
643
+
644
+ </div>
645
+ </div>
646
+ <div class="tags">
647
+
648
+ <p class="tag_title">Author:</p>
649
+ <ul class="author">
650
+
651
+ <li>
652
+
653
+
654
+
655
+
656
+
657
+ <div class='inline'>
658
+ <p>Amit Mandal(amimanda@cisco.com)</p>
659
+ </div>
660
+
661
+ </li>
662
+
663
+ </ul>
664
+
665
+ </div><table class="source_code">
666
+ <tr>
667
+ <td>
668
+ <pre class="lines">
669
+
670
+
671
+ 13
672
+ 14
673
+ 15
674
+ 16
675
+ 17
676
+ 18
677
+ 19
678
+ 20
679
+ 21
680
+ 22
681
+ 23
682
+ 24
683
+ 25
684
+ 26
685
+ 27
686
+ 28
687
+ 29
688
+ 30
689
+ 31
690
+ 32
691
+ 33
692
+ 34
693
+ 35
694
+ 36
695
+ 37
696
+ 38
697
+ 39
698
+ 40
699
+ 41
700
+ 42
701
+ 43
702
+ 44
703
+ 45
704
+ 46
705
+ 47
706
+ 48
707
+ 49
708
+ 50
709
+ 51
710
+ 52
711
+ 53
712
+ 54
713
+ 55
714
+ 56
715
+ 57
716
+ 58
717
+ 59
718
+ 60
719
+ 61
720
+ 62
721
+ 63
722
+ 64
723
+ 65
724
+ 66
725
+ 67
726
+ 68
727
+ 69
728
+ 70
729
+ 71
730
+ 72
731
+ 73
732
+ 74
733
+ 75
734
+ 76
735
+ 77
736
+ 78
737
+ 79
738
+ 80
739
+ 81
740
+ 82
741
+ 83
742
+ 84
743
+ 85
744
+ 86
745
+ 87
746
+ 88
747
+ 89
748
+ 90
749
+ 91
750
+ 92
751
+ 93
752
+ 94
753
+ 95
754
+ 96
755
+ 97
756
+ 98
757
+ 99
758
+ 100
759
+ 101
760
+ 102
761
+ 103
762
+ 104
763
+ 105
764
+ 106
765
+ 107
766
+ 108
767
+ 109
768
+ 110
769
+ 111
770
+ 112
771
+ 113
772
+ 114
773
+ 115
774
+ 116
775
+ 117
776
+ 118
777
+ 119
778
+ 120
779
+ 121
780
+ 122
781
+ 123
782
+ 124
783
+ 125
784
+ 126
785
+ 127
786
+ 128
787
+ 129
788
+ 130
789
+ 131
790
+ 132
791
+ 133
792
+ 134
793
+ 135
794
+ 136
795
+ 137
796
+ 138
797
+ 139
798
+ 140
799
+ 141
800
+ 142
801
+ 143
802
+ 144
803
+ 145
804
+ 146
805
+ 147
806
+ 148
807
+ 149
808
+ 150
809
+ 151
810
+ 152
811
+ 153
812
+ 154
813
+ 155
814
+ 156
815
+ 157
816
+ 158
817
+ 159
818
+ 160
819
+ 161
820
+ 162
821
+ 163
822
+ 164
823
+ 165
824
+ 166
825
+ 167
826
+ 168
827
+ 169
828
+ 170
829
+ 171
830
+ 172
831
+ 173
832
+ 174
833
+ 175
834
+ 176
835
+ 177
836
+ 178
837
+ 179
838
+ 180
839
+ 181
840
+ 182
841
+ 183
842
+ 184
843
+ 185
844
+ 186
845
+ 187
846
+ 188
847
+ 189
848
+ 190
849
+ 191
850
+ 192
851
+ 193
852
+ 194
853
+ 195
854
+ 196
855
+ 197
856
+ 198
857
+ 199
858
+ 200
859
+ 201
860
+ 202
861
+ 203
862
+ 204
863
+ 205
864
+ 206
865
+ 207
866
+ 208
867
+ 209
868
+ 210
869
+ 211
870
+ 212
871
+ 213
872
+ 214
873
+ 215
874
+ 216
875
+ 217
876
+ 218
877
+ 219
878
+ 220
879
+ 221
880
+ 222
881
+ 223
882
+ 224
883
+ 225
884
+ 226
885
+ 227
886
+ 228
887
+ 229
888
+ 230
889
+ 231
890
+ 232
891
+ 233
892
+ 234
893
+ 235
894
+ 236
895
+ 237
896
+ 238
897
+ 239
898
+ 240
899
+ 241
900
+ 242
901
+ 243
902
+ 244
903
+ 245
904
+ 246
905
+ 247
906
+ 248
907
+ 249
908
+ 250
909
+ 251
910
+ 252
911
+ 253
912
+ 254
913
+ 255
914
+ 256
915
+ 257
916
+ 258
917
+ 259
918
+ 260
919
+ 261
920
+ 262
921
+ 263
922
+ 264
923
+ 265
924
+ 266
925
+ 267
926
+ 268
927
+ 269
928
+ 270
929
+ 271
930
+ 272
931
+ 273
932
+ 274
933
+ 275
934
+ 276
935
+ 277
936
+ 278
937
+ 279
938
+ 280
939
+ 281
940
+ 282
941
+ 283
942
+ 284
943
+ 285
944
+ 286
945
+ 287
946
+ 288
947
+ 289
948
+ 290
949
+ 291
950
+ 292
951
+ 293
952
+ 294
953
+ 295
954
+ 296
955
+ 297
956
+ 298
957
+ 299
958
+ 300
959
+ 301
960
+ 302
961
+ 303
962
+ 304
963
+ 305
964
+ 306
965
+ 307
966
+ 308
967
+ 309
968
+ 310
969
+ 311
970
+ 312
971
+ 313
972
+ 314
973
+ 315
974
+ 316
975
+ 317
976
+ 318
977
+ 319
978
+ 320
979
+ 321
980
+ 322
981
+ 323
982
+ 324
983
+ 325
984
+ 326
985
+ 327
986
+ 328
987
+ 329
988
+ 330
989
+ 331
990
+ 332
991
+ 333
992
+ 334
993
+ 335
994
+ 336
995
+ 337
996
+ 338
997
+ 339
998
+ 340
999
+ 341
1000
+ 342
1001
+ 343
1002
+ 344
1003
+ 345
1004
+ 346
1005
+ 347
1006
+ 348
1007
+ 349
1008
+ 350
1009
+ 351
1010
+ 352
1011
+ 353
1012
+ 354
1013
+ 355
1014
+ 356
1015
+ 357
1016
+ 358
1017
+ 359
1018
+ 360
1019
+ 361
1020
+ 362
1021
+ 363
1022
+ 364
1023
+ 365
1024
+ 366
1025
+ 367
1026
+ 368
1027
+ 369
1028
+ 370
1029
+ 371
1030
+ 372
1031
+ 373
1032
+ 374
1033
+ 375
1034
+ 376
1035
+ 377
1036
+ 378
1037
+ 379
1038
+ 380
1039
+ 381
1040
+ 382
1041
+ 383
1042
+ 384
1043
+ 385
1044
+ 386
1045
+ 387
1046
+ 388
1047
+ 389
1048
+ 390
1049
+ 391
1050
+ 392
1051
+ 393
1052
+ 394
1053
+ 395</pre>
1054
+ </td>
1055
+ <td>
1056
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 13</span>
1057
+
1058
+ <span class='kw'>class</span> <span class='const'><span class='object_link'><a href="" title="ImcHandle (class)">ImcHandle</a></span></span> <span class='op'>&lt;</span> <span class='const'>ImcSession</span>
1059
+
1060
+ <span class='id identifier rubyid_attr_accessor'>attr_accessor</span> <span class='symbol'>:to_commit</span>
1061
+
1062
+ <span class='comment'># Create an object of ImcHandle class
1063
+ </span> <span class='comment'>#
1064
+ </span> <span class='comment'># @param ip [String] The IP or Hostname of the IMC Server
1065
+ </span> <span class='comment'># @param username [String] The username as configured on the Imc Server
1066
+ </span> <span class='comment'># @param password [String] The password as configured on the Imc Server
1067
+ </span> <span class='comment'># @param port [Integer, nil] The port number to be used during connection
1068
+ </span> <span class='comment'># @param secure [bool, nil] true for secure connection, otherwise false
1069
+ </span> <span class='comment'># @param proxy [String, nil] The proxy object to be used to connect
1070
+ </span> <span class='comment'># @example
1071
+ </span> <span class='comment'># handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;)
1072
+ </span> <span class='comment'># @example
1073
+ </span> <span class='comment'># handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, secure: true)
1074
+ </span> <span class='comment'># @example
1075
+ </span> <span class='comment'># handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, secure: false)
1076
+ </span> <span class='comment'># @example
1077
+ </span> <span class='comment'># handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, port: 80)
1078
+ </span> <span class='comment'># @example
1079
+ </span> <span class='comment'># handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, port: 443)
1080
+ </span> <span class='comment'># @example
1081
+ </span> <span class='comment'># handle = ImcHandle.new (ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, port: 100, secure: true)
1082
+ </span> <span class='comment'># @example
1083
+ </span> <span class='comment'># handle = ImcHandle.new(ip: &quot;192.168.1.1&quot;,username: &quot;admin&quot;,password: &quot;password&quot;, port: 100, secure: false)
1084
+ </span>
1085
+ <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='label'>ip:</span><span class='comma'>,</span> <span class='label'>username:</span><span class='comma'>,</span> <span class='label'>password:</span><span class='comma'>,</span> <span class='label'>port:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>80</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>secure:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>proxy:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
1086
+ <span class='kw'>super</span><span class='lparen'>(</span><span class='label'>ip:</span> <span class='id identifier rubyid_ip'>ip</span><span class='comma'>,</span> <span class='label'>username:</span> <span class='id identifier rubyid_username'>username</span><span class='comma'>,</span> <span class='label'>password:</span> <span class='id identifier rubyid_password'>password</span><span class='comma'>,</span> <span class='label'>port:</span> <span class='id identifier rubyid_port'>port</span><span class='comma'>,</span> <span class='label'>secure:</span> <span class='id identifier rubyid_secure'>secure</span><span class='comma'>,</span> <span class='label'>proxy:</span> <span class='id identifier rubyid_proxy'>proxy</span><span class='rparen'>)</span>
1087
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
1088
+ <span class='kw'>end</span>
1089
+
1090
+ <span class='comment'>#def set_dump_xml()
1091
+ </span> <span class='comment'># #Enables the logging of xml requests and responses
1092
+ </span> <span class='comment'># super
1093
+ </span> <span class='comment'>#end
1094
+ </span>
1095
+ <span class='comment'>#def unset_dump_xml()
1096
+ </span> <span class='comment'>#Disables the logging of xml request and responses
1097
+ </span> <span class='comment'># super
1098
+ </span> <span class='comment'>#end
1099
+ </span>
1100
+ <span class='comment'># Initiated a connection to the server referenced by the ImcHandle. A cookie is populated in the ImcHandle, if the login is successful.
1101
+ </span> <span class='comment'>#
1102
+ </span> <span class='comment'># @param auto_refresh [TrueClass, FalseCalss] If set to true, it refresh the cookie continuously
1103
+ </span> <span class='comment'># @param force [TrueClass, FalseClass] If set to true it reconnects even if cookie exists and is valid for respective connection.
1104
+ </span> <span class='comment'># @param timeout [Integer] Timeout value in seconds
1105
+ </span> <span class='comment'># @return [TrueClass, FalseClass] true on successful connect
1106
+ </span> <span class='comment'># @example
1107
+ </span> <span class='comment'># handle.login()
1108
+ </span> <span class='comment'># @example
1109
+ </span> <span class='comment'># handle.login(auto_refresh: true)
1110
+ </span> <span class='comment'># @example
1111
+ </span> <span class='comment'># handle.login(force: true)
1112
+ </span> <span class='comment'># @example
1113
+ </span> <span class='comment'># handle.login(auto_refresh: true, force: true)
1114
+ </span> <span class='comment'># @note Where handle is an object of ImcHandle class.
1115
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_login'>login</span><span class='lparen'>(</span><span class='label'>auto_refresh:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>force:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1116
+ <span class='kw'>return</span> <span class='id identifier rubyid__login'>_login</span><span class='lparen'>(</span><span class='label'>auto_refresh:</span> <span class='id identifier rubyid_auto_refresh'>auto_refresh</span><span class='comma'>,</span> <span class='label'>force:</span> <span class='id identifier rubyid_force'>force</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1117
+ <span class='kw'>end</span>
1118
+
1119
+ <span class='comment'># Disconnects from the server referenced by the ImcHandle.
1120
+ </span> <span class='comment'>#
1121
+ </span> <span class='comment'># @param timeout [Integer] timeout value in seconds.
1122
+ </span> <span class='comment'># @return [TrueClass, FalseClass] true on successful disconnect
1123
+ </span> <span class='comment'>#
1124
+ </span> <span class='comment'># @example
1125
+ </span> <span class='comment'># handle.logout()
1126
+ </span> <span class='comment'># @example
1127
+ </span> <span class='comment'># handle.logout(timout: 60)
1128
+ </span> <span class='comment'># @note Where handle is an object of ImcHandle class.
1129
+ </span>
1130
+ <span class='kw'>def</span> <span class='id identifier rubyid_logout'>logout</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1131
+ <span class='kw'>return</span> <span class='id identifier rubyid__logout'>_logout</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1132
+ <span class='kw'>end</span>
1133
+
1134
+ <span class='comment'>#
1135
+ </span> <span class='comment'># process_xml_elem is a helper method which posts xml elements to the
1136
+ </span> <span class='comment'># server and returns parsed response. It&#39;s role is to operate on the
1137
+ </span> <span class='comment'># output of methods from Imcmethodfactory, which return xml element
1138
+ </span> <span class='comment'># node(s).
1139
+ </span> <span class='comment'>#
1140
+ </span> <span class='comment'># @param elem [] XML Element Object
1141
+ </span> <span class='comment'># @return [External Method Object, MO List] MO List or External Method Object
1142
+ </span> <span class='comment'>#
1143
+ </span> <span class='comment'># @example
1144
+ </span> <span class='comment'># elem = imcmethodfactory.config_resolve_class(cookie: handle.cookie, class_id: &quot;computeRackUnit&quot;)
1145
+ </span> <span class='comment'># objs = handle.process_xml_elem(elem)
1146
+ </span> <span class='comment'>#
1147
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_process_xml_elem'>process_xml_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1148
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1149
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
1150
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
1151
+ <span class='kw'>end</span>
1152
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_is_outconfig_available'>is_outconfig_available</span><span class='lparen'>(</span><span class='rparen'>)</span>
1153
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_get_outconfig_child'>get_outconfig_child</span><span class='lparen'>(</span><span class='rparen'>)</span>
1154
+ <span class='kw'>else</span>
1155
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span>
1156
+ <span class='kw'>end</span>
1157
+ <span class='kw'>end</span>
1158
+
1159
+ <span class='comment'># Returns a token that is used for IMC authentication.
1160
+ </span> <span class='comment'>#
1161
+ </span> <span class='comment'># @param timeout [Integer] timeout value(in seconds)
1162
+ </span> <span class='comment'># @return [String] Token used for IMC Authentication
1163
+ </span> <span class='comment'>#
1164
+ </span> <span class='comment'># @example
1165
+ </span> <span class='comment'># handle.get_auth_token()
1166
+ </span> <span class='comment'>#
1167
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_get_auth_token'>get_auth_token</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1168
+
1169
+ <span class='id identifier rubyid_auth_token'>auth_token</span> <span class='op'>=</span> <span class='kw'>nil</span>
1170
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span> <span class='const'>NamingId</span><span class='op'>::</span><span class='const'>COMPUTE_BOARD</span><span class='rparen'>)</span>
1171
+ <span class='kw'>if</span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1172
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span> <span class='const'>NamingId</span><span class='op'>::</span><span class='const'>COMPUTE_RACK_UNIT</span><span class='rparen'>)</span>
1173
+ <span class='kw'>end</span>
1174
+
1175
+ <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1176
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_aaa_get_compute_auth_tokens'>aaa_get_compute_auth_tokens</span><span class='lparen'>(</span><span class='label'>cookie:</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='rparen'>)</span>
1177
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1178
+
1179
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
1180
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
1181
+ <span class='kw'>end</span>
1182
+
1183
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_defined?'>instance_variable_defined?</span><span class='lparen'>(</span><span class='symbol'>:@out_tokens</span><span class='rparen'>)</span>
1184
+ <span class='id identifier rubyid_auth_token'>auth_token</span> <span class='op'>=</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_get'>instance_variable_get</span><span class='lparen'>(</span><span class='symbol'>:@out_tokens</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span>
1185
+ <span class='kw'>end</span>
1186
+ <span class='kw'>end</span>
1187
+ <span class='kw'>return</span> <span class='id identifier rubyid_auth_token'>auth_token</span>
1188
+ <span class='kw'>end</span>
1189
+
1190
+ <span class='comment'>#
1191
+ </span> <span class='comment'># Finds an object using it&#39;s distinguished name.
1192
+ </span> <span class='comment'>#
1193
+ </span> <span class='comment'># @param dn [String] distinguished name of the object to be queried for.
1194
+ </span> <span class='comment'># @param hierarchy [TrueClass, FalseClass] Gets all objects in hierarchy if true
1195
+ </span> <span class='comment'># @param need_response [TrueClass, FalseClass] returns the response xml node, instead of parsed objects.
1196
+ </span> <span class='comment'># @param timeout [Integer] timeout value(in seconds)
1197
+ </span> <span class='comment'># @return [ManagedObject, Array&lt;ManagedObject&gt;, ExternalMethod] Return Managed Object by default, returns Array&lt;ManagedObject&gt; if hierarchy is set to true,
1198
+ </span> <span class='comment'># returns ExternalMethod if need_response is set to true.
1199
+ </span> <span class='comment'>#
1200
+ </span> <span class='comment'># @example
1201
+ </span> <span class='comment'># obj = handle.query_dn(dn: &quot;sys/rack-unit-1&quot;)
1202
+ </span> <span class='comment'># @example
1203
+ </span> <span class='comment'># obj = handle.query_dn(dn: &quot;sys/rack-unit-1&quot;, hierarchy: true)
1204
+ </span> <span class='comment'># @example
1205
+ </span> <span class='comment'># obj = handle.query_dn(dn: &quot;sys/rack-unit-1&quot;, need_response: true
1206
+ </span> <span class='comment'># @example
1207
+ </span> <span class='comment'># obj = handle.query_dn(dn: &quot;sys/rack-unit-1&quot;, hierarchy: true, need_response: true)
1208
+ </span>
1209
+ <span class='kw'>def</span> <span class='id identifier rubyid_query_dn'>query_dn</span><span class='lparen'>(</span><span class='label'>dn:</span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>need_response:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1210
+
1211
+ <span class='kw'>if</span> <span class='id identifier rubyid_dn'>dn</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1212
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ValueError</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span> <span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Provide dn.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1213
+ <span class='kw'>end</span>
1214
+
1215
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_config_resolve_dn'>config_resolve_dn</span><span class='lparen'>(</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='id identifier rubyid_dn'>dn</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
1216
+
1217
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1218
+
1219
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
1220
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
1221
+ <span class='kw'>end</span>
1222
+
1223
+ <span class='kw'>if</span> <span class='id identifier rubyid_need_response'>need_response</span>
1224
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span>
1225
+ <span class='kw'>end</span>
1226
+
1227
+ <span class='kw'>if</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span>
1228
+ <span class='id identifier rubyid_out_mo_list'>out_mo_list</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_extract_molist_from_method_response'>extract_molist_from_method_response</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
1229
+ <span class='kw'>return</span> <span class='id identifier rubyid_out_mo_list'>out_mo_list</span>
1230
+ <span class='kw'>end</span>
1231
+
1232
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='kw'>nil</span>
1233
+ <span class='id identifier rubyid_child'>child</span> <span class='op'>=</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_get_outconfig_child'>get_outconfig_child</span><span class='lparen'>(</span><span class='rparen'>)</span>
1234
+ <span class='kw'>if</span> <span class='id identifier rubyid_child'>child</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
1235
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='id identifier rubyid_child'>child</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
1236
+ <span class='kw'>end</span>
1237
+ <span class='kw'>return</span> <span class='id identifier rubyid_mo'>mo</span>
1238
+ <span class='kw'>end</span>
1239
+
1240
+ <span class='comment'>#
1241
+ </span> <span class='comment'># Finds an object using it&#39;s class id.
1242
+ </span> <span class='comment'>#
1243
+ </span> <span class='comment'># @param class_id [String] class id of the object to be queried for.
1244
+ </span> <span class='comment'># @param hierarchy [TrueClass, FalseClass] if set to true will return all the child hierarchical objects.
1245
+ </span> <span class='comment'># @param need_response [TrueClass, FalseClass] if set to true will return only response object.
1246
+ </span> <span class='comment'># @param timeout [Integer] timeout value(in seconds)
1247
+ </span> <span class='comment'># @return [Array&lt;ManagedObject&gt;, Method_Response, nil] returns Method_Response if need_response is set to true
1248
+ </span> <span class='comment'>#
1249
+ </span> <span class='comment'># @example
1250
+ </span> <span class='comment'># obj = handle.query_classid(class_id: &quot;computeRackUnit&quot;)
1251
+ </span> <span class='comment'># @example
1252
+ </span> <span class='comment'># obj = handle.query_classid(class_id: &quot;computeRackUnit&quot;, hierarchy: true)
1253
+ </span> <span class='comment'># @example
1254
+ </span> <span class='comment'># obj = handle.query_classid(class_id: &quot;computeRackUnit&quot;, need_response: true)
1255
+ </span> <span class='comment'>#
1256
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>need_response:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
1257
+
1258
+ <span class='kw'>if</span> <span class='id identifier rubyid_class_id'>class_id</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1259
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ValueError</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Provide Parameter class_id</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1260
+ <span class='kw'>end</span>
1261
+
1262
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_find_class_id_in_mo_meta_ignore_case'>find_class_id_in_mo_meta_ignore_case</span><span class='lparen'>(</span><span class='id identifier rubyid_class_id'>class_id</span><span class='rparen'>)</span>
1263
+
1264
+ <span class='kw'>if</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1265
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_class_id'>class_id</span>
1266
+ <span class='kw'>end</span>
1267
+
1268
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_config_resolve_class'>config_resolve_class</span><span class='lparen'>(</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='id identifier rubyid_class_id'>class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
1269
+
1270
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1271
+
1272
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
1273
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
1274
+ <span class='kw'>end</span>
1275
+
1276
+ <span class='kw'>if</span> <span class='id identifier rubyid_need_response'>need_response</span>
1277
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span>
1278
+ <span class='kw'>end</span>
1279
+
1280
+ <span class='id identifier rubyid_out_mo_list'>out_mo_list</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_extract_molist_from_method_response'>extract_molist_from_method_response</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
1281
+ <span class='kw'>return</span> <span class='id identifier rubyid_out_mo_list'>out_mo_list</span>
1282
+
1283
+ <span class='kw'>end</span>
1284
+
1285
+ <span class='comment'>#
1286
+ </span> <span class='comment'># Finds children of a given managed object or distinguished name.
1287
+ </span> <span class='comment'># Arguments can be specified to query only a specific type(class_id) of children.
1288
+ </span> <span class='comment'># Arguments can also be specified to query only direct children or the entire hierarchy of children.
1289
+ </span> <span class='comment'>#
1290
+ </span> <span class='comment'># @param in_mo [ManagedObject] query children managed object under this object.
1291
+ </span> <span class='comment'># @param in_dn [String] query children managed object for a given managed object of the respective dn.
1292
+ </span> <span class='comment'># @param class_id [String] by default nil, if given finds only specific childred object for a given class_id.
1293
+ </span> <span class='comment'># @param hierarchy [TrueClass, FalseClass] if set to true will return all the child hierarchical objects.
1294
+ </span> <span class='comment'># @param timeout [Integer] timeout value in seconds
1295
+ </span> <span class='comment'># @return [Array&lt;ManagedObject&gt;, nil]
1296
+ </span> <span class='comment'>#
1297
+ </span> <span class='comment'># @example
1298
+ </span> <span class='comment'># mo_list = handle.query_children(in_mo: mo)
1299
+ </span> <span class='comment'># @example
1300
+ </span> <span class='comment'># mo_list = handle.query_children(in_mo: mo, class_id: &quot;classid&quot;)
1301
+ </span> <span class='comment'># @example
1302
+ </span> <span class='comment'># mo_list = handle.query_children(in_dn: dn)
1303
+ </span> <span class='comment'># @example
1304
+ </span> <span class='comment'># mo_list = handle.query_children(in_dn: dn, class_id: &quot;classid&quot;)
1305
+ </span> <span class='comment'>#
1306
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_query_children'>query_children</span><span class='lparen'>(</span><span class='label'>in_mo:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>in_dn:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>class_id:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1307
+ <span class='kw'>if</span> <span class='id identifier rubyid_in_mo'>in_mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='kw'>and</span> <span class='id identifier rubyid_in_dn'>in_dn</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1308
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ValueError</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[Error]: GetChild: Provide in_mo or in_dn</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1309
+ <span class='kw'>end</span>
1310
+
1311
+ <span class='kw'>if</span> <span class='id identifier rubyid_in_mo'>in_mo</span>
1312
+ <span class='id identifier rubyid_parent_dn'>parent_dn</span> <span class='op'>=</span> <span class='id identifier rubyid_in_mo'>in_mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span>
1313
+ <span class='kw'>elsif</span>
1314
+ <span class='id identifier rubyid_parent_dn'>parent_dn</span> <span class='op'>=</span> <span class='id identifier rubyid_in_dn'>in_dn</span>
1315
+ <span class='kw'>end</span>
1316
+
1317
+ <span class='kw'>if</span> <span class='id identifier rubyid_class_id'>class_id</span>
1318
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_find_class_id_in_mo_meta_ignore_case'>find_class_id_in_mo_meta_ignore_case</span><span class='lparen'>(</span><span class='id identifier rubyid_class_id'>class_id</span><span class='rparen'>)</span>
1319
+ <span class='kw'>if</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1320
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_class_id'>class_id</span>
1321
+ <span class='kw'>end</span>
1322
+ <span class='kw'>else</span>
1323
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_class_id'>class_id</span>
1324
+ <span class='kw'>end</span>
1325
+
1326
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_config_resolve_children'>config_resolve_children</span><span class='lparen'>(</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='id identifier rubyid_class_id'>class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='comma'>,</span> <span class='id identifier rubyid_in_dn'>in_dn</span> <span class='op'>=</span> <span class='id identifier rubyid_parent_dn'>parent_dn</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
1327
+
1328
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1329
+
1330
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
1331
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
1332
+ <span class='kw'>end</span>
1333
+
1334
+ <span class='id identifier rubyid_out_mo_list'>out_mo_list</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_extract_molist_from_method_response'>extract_molist_from_method_response</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
1335
+
1336
+ <span class='kw'>return</span> <span class='id identifier rubyid_out_mo_list'>out_mo_list</span>
1337
+ <span class='kw'>end</span>
1338
+ <span class='comment'>#
1339
+ </span> <span class='comment'># Add a Managed Object to the IMC Server
1340
+ </span> <span class='comment'>#
1341
+ </span> <span class='comment'># @param mo [ManagedObject] Managed Object to the added to the IMC Server
1342
+ </span> <span class='comment'># @param modify_present [TrueClass, FalseClass] Over-write an existing object if true
1343
+ </span> <span class='comment'># @param timeout [Integer] timoeout value(in seconds)
1344
+ </span> <span class='comment'># @return [nil]
1345
+ </span> <span class='comment'># @example
1346
+ </span> <span class='comment'># handle.add_mo(mo: mo)
1347
+ </span> <span class='comment'>#
1348
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_add_mo'>add_mo</span><span class='lparen'>(</span><span class='label'>mo:</span><span class='comma'>,</span> <span class='label'>modify_present:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1349
+ <span class='kw'>if</span> <span class='const'>ImcGenUtils</span><span class='op'>::</span><span class='const'>AFFIRMATIVE_LIST</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='id identifier rubyid_modify_present'>modify_present</span>
1350
+ <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_query_dn'>query_dn</span><span class='lparen'>(</span><span class='label'>dn:</span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1351
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>created</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1352
+ <span class='kw'>else</span>
1353
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>modified</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1354
+ <span class='kw'>end</span>
1355
+ <span class='kw'>else</span>
1356
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>created</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1357
+ <span class='kw'>end</span>
1358
+
1359
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span><span class='lbracket'>[</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_mo'>mo</span>
1360
+ <span class='id identifier rubyid__commit'>_commit</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1361
+ <span class='kw'>end</span>
1362
+
1363
+ <span class='comment'>#
1364
+ </span> <span class='comment'># Modifies a managed object and adds it to the ImcHandle commit buffer (if not already in it)
1365
+ </span> <span class='comment'>#
1366
+ </span> <span class='comment'># @param mo [ManagedObject] Managed Object with modified properties
1367
+ </span> <span class='comment'># @param timeout [Integer, nil] timeout value in seconds
1368
+ </span> <span class='comment'># @return [nil]
1369
+ </span> <span class='comment'>#
1370
+ </span> <span class='comment'># @example
1371
+ </span> <span class='comment'># handle.set_mo(mo: mo)
1372
+ </span> <span class='comment'>#
1373
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_set_mo'>set_mo</span><span class='lparen'>(</span><span class='label'>mo:</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1374
+ <span class='comment'>#mo.instance_variable_set(:@status, &quot;modified&quot;)
1375
+ </span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>modified</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1376
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span><span class='lbracket'>[</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_get'>instance_variable_get</span><span class='lparen'>(</span><span class='symbol'>:@dn</span><span class='rparen'>)</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_mo'>mo</span>
1377
+ <span class='id identifier rubyid__commit'>_commit</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1378
+ <span class='kw'>end</span>
1379
+
1380
+ <span class='comment'>#
1381
+ </span> <span class='comment'># Remove a Managed Object from the IMC Server
1382
+ </span> <span class='comment'>#
1383
+ </span> <span class='comment'># @param mo [ManagedObject] Managed Object to be removed.
1384
+ </span> <span class='comment'># @param timeout [Integer] timeout value(in seconds).
1385
+ </span> <span class='comment'># @return [nil] Nothing is returned.
1386
+ </span> <span class='comment'>#
1387
+ </span> <span class='comment'># @example
1388
+ </span> <span class='comment'># handle.remove_mo(mo: mo)
1389
+ </span> <span class='comment'>#
1390
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid_remove_mo'>remove_mo</span><span class='lparen'>(</span><span class='label'>mo:</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1391
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>deleted</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1392
+ <span class='kw'>if</span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_defined?'>instance_variable_defined?</span><span class='lparen'>(</span><span class='symbol'>:@parent_mo</span><span class='rparen'>)</span> <span class='kw'>and</span> <span class='op'>!</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_parent_mo'>parent_mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1393
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_parent_mo'>parent_mo</span><span class='period'>.</span><span class='id identifier rubyid_child_remove'>child_remove</span><span class='lparen'>(</span><span class='id identifier rubyid_mo'>mo</span><span class='rparen'>)</span>
1394
+ <span class='kw'>end</span>
1395
+
1396
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span><span class='lbracket'>[</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_mo'>mo</span>
1397
+ <span class='id identifier rubyid__commit'>_commit</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1398
+ <span class='kw'>end</span>
1399
+
1400
+ <span class='comment'>#private methods
1401
+ </span><span class='id identifier rubyid_private'>private</span>
1402
+ <span class='comment'>#
1403
+ </span> <span class='comment'># Commit the buffer to the server. Pushes all the configuration changes so far to the server.
1404
+ </span> <span class='comment'># Configuration could be added to the commit buffer using add_mo(), set_mo(), and remove_mo().
1405
+ </span> <span class='comment'>#
1406
+ </span> <span class='comment'># @param timeout [Integer] timeout value in seconds.
1407
+ </span> <span class='comment'># @return [nil]
1408
+ </span> <span class='comment'># @example
1409
+ </span> <span class='comment'># self._commit()
1410
+ </span> <span class='comment'>#
1411
+ </span> <span class='kw'>def</span> <span class='id identifier rubyid__commit'>_commit</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1412
+
1413
+ <span class='id identifier rubyid_mo_dict'>mo_dict</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span>
1414
+ <span class='kw'>if</span> <span class='id identifier rubyid_mo_dict'>mo_dict</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='kw'>or</span> <span class='id identifier rubyid_mo_dict'>mo_dict</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
1415
+ <span class='kw'>return</span> <span class='kw'>nil</span>
1416
+ <span class='kw'>end</span>
1417
+
1418
+ <span class='id identifier rubyid_config_map'>config_map</span> <span class='op'>=</span> <span class='const'>ConfigMap</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='rparen'>)</span>
1419
+
1420
+ <span class='id identifier rubyid_mo_dict'>mo_dict</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_mo_dn'>mo_dn</span><span class='comma'>,</span> <span class='id identifier rubyid_mo'>mo</span><span class='op'>|</span>
1421
+ <span class='id identifier rubyid_config_map'>config_map</span><span class='period'>.</span><span class='id identifier rubyid_child_add'>child_add</span><span class='lparen'>(</span><span class='id identifier rubyid_mo'>mo</span><span class='rparen'>)</span>
1422
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_config_conf_mo'>config_conf_mo</span><span class='lparen'>(</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='id identifier rubyid_mo_dn'>mo_dn</span><span class='comma'>,</span> <span class='id identifier rubyid_config_map'>config_map</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rparen'>)</span>
1423
+
1424
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1425
+
1426
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
1427
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
1428
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
1429
+ <span class='kw'>end</span>
1430
+
1431
+ <span class='id identifier rubyid_child'>child</span> <span class='op'>=</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_get_outconfig_child'>get_outconfig_child</span><span class='lparen'>(</span><span class='rparen'>)</span>
1432
+ <span class='kw'>for</span> <span class='id identifier rubyid_pair_'>pair_</span> <span class='kw'>in</span> <span class='id identifier rubyid_child'>child</span> <span class='kw'>do</span>
1433
+ <span class='kw'>for</span> <span class='id identifier rubyid_out_mo'>out_mo</span> <span class='kw'>in</span> <span class='id identifier rubyid_pair_'>pair_</span><span class='period'>.</span><span class='id identifier rubyid_child'>child</span> <span class='kw'>do</span>
1434
+ <span class='id identifier rubyid_out_mo'>out_mo</span><span class='period'>.</span><span class='id identifier rubyid_sync_mo'>sync_mo</span><span class='lparen'>(</span><span class='id identifier rubyid_mo_dict'>mo_dict</span><span class='lbracket'>[</span><span class='id identifier rubyid_out_mo'>out_mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span><span class='rbracket'>]</span><span class='rparen'>)</span>
1435
+ <span class='kw'>end</span>
1436
+ <span class='kw'>end</span>
1437
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
1438
+ <span class='kw'>end</span>
1439
+ <span class='kw'>end</span>
1440
+ <span class='kw'>end</span></pre>
1441
+ </td>
1442
+ </tr>
1443
+ </table>
1444
+ </div>
1445
+
1446
+ </div>
1447
+
1448
+
1449
+ <div id="instance_method_details" class="method_details_list">
1450
+ <h2>Instance Method Details</h2>
1451
+
1452
+
1453
+ <div class="method_details first">
1454
+ <h3 class="signature first" id="add_mo-instance_method">
1455
+
1456
+ #<strong>add_mo</strong>(mo:, modify_present: true, timeout: &quot;60&quot;) &#x21d2; <tt>nil</tt>
1457
+
1458
+
1459
+
1460
+
1461
+
1462
+ </h3><div class="docstring">
1463
+ <div class="discussion">
1464
+
1465
+ <p>Add a Managed Object to the IMC Server</p>
1466
+
1467
+
1468
+ </div>
1469
+ </div>
1470
+ <div class="tags">
1471
+
1472
+ <div class="examples">
1473
+ <p class="tag_title">Examples:</p>
1474
+
1475
+
1476
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_add_mo'>add_mo</span><span class='lparen'>(</span><span class='label'>mo:</span> <span class='id identifier rubyid_mo'>mo</span><span class='rparen'>)</span></code></pre>
1477
+
1478
+ </div>
1479
+ <p class="tag_title">Parameters:</p>
1480
+ <ul class="param">
1481
+
1482
+ <li>
1483
+
1484
+ <span class='name'>mo</span>
1485
+
1486
+
1487
+ <span class='type'>(<tt>ManagedObject</tt>)</span>
1488
+
1489
+
1490
+
1491
+ &mdash;
1492
+ <div class='inline'>
1493
+ <p>Managed Object to the added to the IMC Server</p>
1494
+ </div>
1495
+
1496
+ </li>
1497
+
1498
+ <li>
1499
+
1500
+ <span class='name'>modify_present</span>
1501
+
1502
+
1503
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
1504
+
1505
+
1506
+
1507
+ &mdash;
1508
+ <div class='inline'>
1509
+ <p>Over-write an existing object if true</p>
1510
+ </div>
1511
+
1512
+ </li>
1513
+
1514
+ <li>
1515
+
1516
+ <span class='name'>timeout</span>
1517
+
1518
+
1519
+ <span class='type'>(<tt>Integer</tt>)</span>
1520
+
1521
+
1522
+
1523
+ &mdash;
1524
+ <div class='inline'>
1525
+ <p>timoeout value(in seconds)</p>
1526
+ </div>
1527
+
1528
+ </li>
1529
+
1530
+ </ul>
1531
+
1532
+ <p class="tag_title">Returns:</p>
1533
+ <ul class="return">
1534
+
1535
+ <li>
1536
+
1537
+
1538
+ <span class='type'>(<tt>nil</tt>)</span>
1539
+
1540
+
1541
+
1542
+ </li>
1543
+
1544
+ </ul>
1545
+
1546
+ </div><table class="source_code">
1547
+ <tr>
1548
+ <td>
1549
+ <pre class="lines">
1550
+
1551
+
1552
+ 303
1553
+ 304
1554
+ 305
1555
+ 306
1556
+ 307
1557
+ 308
1558
+ 309
1559
+ 310
1560
+ 311
1561
+ 312
1562
+ 313
1563
+ 314
1564
+ 315
1565
+ 316</pre>
1566
+ </td>
1567
+ <td>
1568
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 303</span>
1569
+
1570
+ <span class='kw'>def</span> <span class='id identifier rubyid_add_mo'>add_mo</span><span class='lparen'>(</span><span class='label'>mo:</span><span class='comma'>,</span> <span class='label'>modify_present:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1571
+ <span class='kw'>if</span> <span class='const'>ImcGenUtils</span><span class='op'>::</span><span class='const'>AFFIRMATIVE_LIST</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='id identifier rubyid_modify_present'>modify_present</span>
1572
+ <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_query_dn'>query_dn</span><span class='lparen'>(</span><span class='label'>dn:</span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1573
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>created</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1574
+ <span class='kw'>else</span>
1575
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>modified</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1576
+ <span class='kw'>end</span>
1577
+ <span class='kw'>else</span>
1578
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>created</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1579
+ <span class='kw'>end</span>
1580
+
1581
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span><span class='lbracket'>[</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_mo'>mo</span>
1582
+ <span class='id identifier rubyid__commit'>_commit</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1583
+ <span class='kw'>end</span></pre>
1584
+ </td>
1585
+ </tr>
1586
+ </table>
1587
+ </div>
1588
+
1589
+ <div class="method_details ">
1590
+ <h3 class="signature " id="get_auth_token-instance_method">
1591
+
1592
+ #<strong>get_auth_token</strong>(timeout: &quot;60&quot;) &#x21d2; <tt>String</tt>
1593
+
1594
+
1595
+
1596
+
1597
+
1598
+ </h3><div class="docstring">
1599
+ <div class="discussion">
1600
+
1601
+ <p>Returns a token that is used for IMC authentication.</p>
1602
+
1603
+
1604
+ </div>
1605
+ </div>
1606
+ <div class="tags">
1607
+
1608
+ <div class="examples">
1609
+ <p class="tag_title">Examples:</p>
1610
+
1611
+
1612
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_get_auth_token'>get_auth_token</span><span class='lparen'>(</span><span class='rparen'>)</span></code></pre>
1613
+
1614
+ </div>
1615
+ <p class="tag_title">Parameters:</p>
1616
+ <ul class="param">
1617
+
1618
+ <li>
1619
+
1620
+ <span class='name'>timeout</span>
1621
+
1622
+
1623
+ <span class='type'>(<tt>Integer</tt>)</span>
1624
+
1625
+
1626
+
1627
+ &mdash;
1628
+ <div class='inline'>
1629
+ <p>timeout value(in seconds)</p>
1630
+ </div>
1631
+
1632
+ </li>
1633
+
1634
+ </ul>
1635
+
1636
+ <p class="tag_title">Returns:</p>
1637
+ <ul class="return">
1638
+
1639
+ <li>
1640
+
1641
+
1642
+ <span class='type'>(<tt>String</tt>)</span>
1643
+
1644
+
1645
+
1646
+ &mdash;
1647
+ <div class='inline'>
1648
+ <p>Token used for IMC Authentication</p>
1649
+ </div>
1650
+
1651
+ </li>
1652
+
1653
+ </ul>
1654
+
1655
+ </div><table class="source_code">
1656
+ <tr>
1657
+ <td>
1658
+ <pre class="lines">
1659
+
1660
+
1661
+ 122
1662
+ 123
1663
+ 124
1664
+ 125
1665
+ 126
1666
+ 127
1667
+ 128
1668
+ 129
1669
+ 130
1670
+ 131
1671
+ 132
1672
+ 133
1673
+ 134
1674
+ 135
1675
+ 136
1676
+ 137
1677
+ 138
1678
+ 139
1679
+ 140
1680
+ 141
1681
+ 142
1682
+ 143</pre>
1683
+ </td>
1684
+ <td>
1685
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 122</span>
1686
+
1687
+ <span class='kw'>def</span> <span class='id identifier rubyid_get_auth_token'>get_auth_token</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1688
+
1689
+ <span class='id identifier rubyid_auth_token'>auth_token</span> <span class='op'>=</span> <span class='kw'>nil</span>
1690
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span> <span class='const'>NamingId</span><span class='op'>::</span><span class='const'>COMPUTE_BOARD</span><span class='rparen'>)</span>
1691
+ <span class='kw'>if</span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1692
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span> <span class='const'>NamingId</span><span class='op'>::</span><span class='const'>COMPUTE_RACK_UNIT</span><span class='rparen'>)</span>
1693
+ <span class='kw'>end</span>
1694
+
1695
+ <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
1696
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_aaa_get_compute_auth_tokens'>aaa_get_compute_auth_tokens</span><span class='lparen'>(</span><span class='label'>cookie:</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='rparen'>)</span>
1697
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1698
+
1699
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
1700
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
1701
+ <span class='kw'>end</span>
1702
+
1703
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_defined?'>instance_variable_defined?</span><span class='lparen'>(</span><span class='symbol'>:@out_tokens</span><span class='rparen'>)</span>
1704
+ <span class='id identifier rubyid_auth_token'>auth_token</span> <span class='op'>=</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_get'>instance_variable_get</span><span class='lparen'>(</span><span class='symbol'>:@out_tokens</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span>
1705
+ <span class='kw'>end</span>
1706
+ <span class='kw'>end</span>
1707
+ <span class='kw'>return</span> <span class='id identifier rubyid_auth_token'>auth_token</span>
1708
+ <span class='kw'>end</span></pre>
1709
+ </td>
1710
+ </tr>
1711
+ </table>
1712
+ </div>
1713
+
1714
+ <div class="method_details ">
1715
+ <h3 class="signature " id="login-instance_method">
1716
+
1717
+ #<strong>login</strong>(auto_refresh: false, force: false, timeout: &quot;60&quot;) &#x21d2; <tt>TrueClass</tt>, <tt>FalseClass</tt>
1718
+
1719
+
1720
+
1721
+
1722
+
1723
+ </h3><div class="docstring">
1724
+ <div class="discussion">
1725
+
1726
+ <div class="note notetag">
1727
+ <strong>Note:</strong>
1728
+ <div class='inline'>
1729
+ <p>Where handle is an object of ImcHandle class.</p>
1730
+ </div>
1731
+ </div>
1732
+
1733
+
1734
+ <p>Initiated a connection to the server referenced by the ImcHandle. A cookie
1735
+ is populated in the ImcHandle, if the login is successful.</p>
1736
+
1737
+
1738
+ </div>
1739
+ </div>
1740
+ <div class="tags">
1741
+
1742
+ <div class="examples">
1743
+ <p class="tag_title">Examples:</p>
1744
+
1745
+
1746
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_login'>login</span><span class='lparen'>(</span><span class='rparen'>)</span></code></pre>
1747
+
1748
+
1749
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_login'>login</span><span class='lparen'>(</span><span class='label'>auto_refresh:</span> <span class='kw'>true</span><span class='rparen'>)</span></code></pre>
1750
+
1751
+
1752
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_login'>login</span><span class='lparen'>(</span><span class='label'>force:</span> <span class='kw'>true</span><span class='rparen'>)</span></code></pre>
1753
+
1754
+
1755
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_login'>login</span><span class='lparen'>(</span><span class='label'>auto_refresh:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>force:</span> <span class='kw'>true</span><span class='rparen'>)</span></code></pre>
1756
+
1757
+ </div>
1758
+ <p class="tag_title">Parameters:</p>
1759
+ <ul class="param">
1760
+
1761
+ <li>
1762
+
1763
+ <span class='name'>auto_refresh</span>
1764
+
1765
+
1766
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseCalss</tt>)</span>
1767
+
1768
+
1769
+
1770
+ &mdash;
1771
+ <div class='inline'>
1772
+ <p>If set to true, it refresh the cookie continuously</p>
1773
+ </div>
1774
+
1775
+ </li>
1776
+
1777
+ <li>
1778
+
1779
+ <span class='name'>force</span>
1780
+
1781
+
1782
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
1783
+
1784
+
1785
+
1786
+ &mdash;
1787
+ <div class='inline'>
1788
+ <p>If set to true it reconnects even if cookie exists and is valid for
1789
+ respective connection.</p>
1790
+ </div>
1791
+
1792
+ </li>
1793
+
1794
+ <li>
1795
+
1796
+ <span class='name'>timeout</span>
1797
+
1798
+
1799
+ <span class='type'>(<tt>Integer</tt>)</span>
1800
+
1801
+
1802
+
1803
+ &mdash;
1804
+ <div class='inline'>
1805
+ <p>Timeout value in seconds</p>
1806
+ </div>
1807
+
1808
+ </li>
1809
+
1810
+ </ul>
1811
+
1812
+ <p class="tag_title">Returns:</p>
1813
+ <ul class="return">
1814
+
1815
+ <li>
1816
+
1817
+
1818
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
1819
+
1820
+
1821
+
1822
+ &mdash;
1823
+ <div class='inline'>
1824
+ <p>true on successful connect</p>
1825
+ </div>
1826
+
1827
+ </li>
1828
+
1829
+ </ul>
1830
+
1831
+ </div><table class="source_code">
1832
+ <tr>
1833
+ <td>
1834
+ <pre class="lines">
1835
+
1836
+
1837
+ 70
1838
+ 71
1839
+ 72</pre>
1840
+ </td>
1841
+ <td>
1842
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 70</span>
1843
+
1844
+ <span class='kw'>def</span> <span class='id identifier rubyid_login'>login</span><span class='lparen'>(</span><span class='label'>auto_refresh:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>force:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1845
+ <span class='kw'>return</span> <span class='id identifier rubyid__login'>_login</span><span class='lparen'>(</span><span class='label'>auto_refresh:</span> <span class='id identifier rubyid_auto_refresh'>auto_refresh</span><span class='comma'>,</span> <span class='label'>force:</span> <span class='id identifier rubyid_force'>force</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1846
+ <span class='kw'>end</span></pre>
1847
+ </td>
1848
+ </tr>
1849
+ </table>
1850
+ </div>
1851
+
1852
+ <div class="method_details ">
1853
+ <h3 class="signature " id="logout-instance_method">
1854
+
1855
+ #<strong>logout</strong>(timeout: &quot;60&quot;) &#x21d2; <tt>TrueClass</tt>, <tt>FalseClass</tt>
1856
+
1857
+
1858
+
1859
+
1860
+
1861
+ </h3><div class="docstring">
1862
+ <div class="discussion">
1863
+
1864
+ <div class="note notetag">
1865
+ <strong>Note:</strong>
1866
+ <div class='inline'>
1867
+ <p>Where handle is an object of ImcHandle class.</p>
1868
+ </div>
1869
+ </div>
1870
+
1871
+
1872
+ <p>Disconnects from the server referenced by the ImcHandle.</p>
1873
+
1874
+
1875
+ </div>
1876
+ </div>
1877
+ <div class="tags">
1878
+
1879
+ <div class="examples">
1880
+ <p class="tag_title">Examples:</p>
1881
+
1882
+
1883
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_logout'>logout</span><span class='lparen'>(</span><span class='rparen'>)</span></code></pre>
1884
+
1885
+
1886
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_logout'>logout</span><span class='lparen'>(</span><span class='label'>timout:</span> <span class='int'>60</span><span class='rparen'>)</span></code></pre>
1887
+
1888
+ </div>
1889
+ <p class="tag_title">Parameters:</p>
1890
+ <ul class="param">
1891
+
1892
+ <li>
1893
+
1894
+ <span class='name'>timeout</span>
1895
+
1896
+
1897
+ <span class='type'>(<tt>Integer</tt>)</span>
1898
+
1899
+
1900
+
1901
+ &mdash;
1902
+ <div class='inline'>
1903
+ <p>timeout value in seconds.</p>
1904
+ </div>
1905
+
1906
+ </li>
1907
+
1908
+ </ul>
1909
+
1910
+ <p class="tag_title">Returns:</p>
1911
+ <ul class="return">
1912
+
1913
+ <li>
1914
+
1915
+
1916
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
1917
+
1918
+
1919
+
1920
+ &mdash;
1921
+ <div class='inline'>
1922
+ <p>true on successful disconnect</p>
1923
+ </div>
1924
+
1925
+ </li>
1926
+
1927
+ </ul>
1928
+
1929
+ </div><table class="source_code">
1930
+ <tr>
1931
+ <td>
1932
+ <pre class="lines">
1933
+
1934
+
1935
+ 85
1936
+ 86
1937
+ 87</pre>
1938
+ </td>
1939
+ <td>
1940
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 85</span>
1941
+
1942
+ <span class='kw'>def</span> <span class='id identifier rubyid_logout'>logout</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1943
+ <span class='kw'>return</span> <span class='id identifier rubyid__logout'>_logout</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
1944
+ <span class='kw'>end</span></pre>
1945
+ </td>
1946
+ </tr>
1947
+ </table>
1948
+ </div>
1949
+
1950
+ <div class="method_details ">
1951
+ <h3 class="signature " id="process_xml_elem-instance_method">
1952
+
1953
+ #<strong>process_xml_elem</strong>(elem, timeout: &quot;60&quot;) &#x21d2; <tt>External Method Object</tt>, <tt>MO List</tt>
1954
+
1955
+
1956
+
1957
+
1958
+
1959
+ </h3><div class="docstring">
1960
+ <div class="discussion">
1961
+
1962
+ <p>process_xml_elem is a helper method which posts xml elements to the server
1963
+ and returns parsed response. It&#39;s role is to operate on the output of
1964
+ methods from Imcmethodfactory, which return xml element node(s).</p>
1965
+
1966
+
1967
+ </div>
1968
+ </div>
1969
+ <div class="tags">
1970
+
1971
+ <div class="examples">
1972
+ <p class="tag_title">Examples:</p>
1973
+
1974
+
1975
+ <pre class="example code"><code><span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_imcmethodfactory'>imcmethodfactory</span><span class='period'>.</span><span class='id identifier rubyid_config_resolve_class'>config_resolve_class</span><span class='lparen'>(</span><span class='label'>cookie:</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='label'>class_id:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>computeRackUnit</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1976
+ <span class='id identifier rubyid_objs'>objs</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_process_xml_elem'>process_xml_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='rparen'>)</span></code></pre>
1977
+
1978
+ </div>
1979
+ <p class="tag_title">Parameters:</p>
1980
+ <ul class="param">
1981
+
1982
+ <li>
1983
+
1984
+ <span class='name'>elem</span>
1985
+
1986
+
1987
+ <span class='type'></span>
1988
+
1989
+
1990
+
1991
+ &mdash;
1992
+ <div class='inline'><dl class="rdoc-list label-list"><dt>
1993
+ <dd>
1994
+ <p>XML Element Object</p>
1995
+ </dd></dl>
1996
+ </div>
1997
+
1998
+ </li>
1999
+
2000
+ </ul>
2001
+
2002
+ <p class="tag_title">Returns:</p>
2003
+ <ul class="return">
2004
+
2005
+ <li>
2006
+
2007
+
2008
+ <span class='type'>(<tt>External Method Object</tt>, <tt>MO List</tt>)</span>
2009
+
2010
+
2011
+
2012
+ &mdash;
2013
+ <div class='inline'>
2014
+ <p>MO List or External Method Object</p>
2015
+ </div>
2016
+
2017
+ </li>
2018
+
2019
+ </ul>
2020
+
2021
+ </div><table class="source_code">
2022
+ <tr>
2023
+ <td>
2024
+ <pre class="lines">
2025
+
2026
+
2027
+ 102
2028
+ 103
2029
+ 104
2030
+ 105
2031
+ 106
2032
+ 107
2033
+ 108
2034
+ 109
2035
+ 110
2036
+ 111
2037
+ 112</pre>
2038
+ </td>
2039
+ <td>
2040
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 102</span>
2041
+
2042
+ <span class='kw'>def</span> <span class='id identifier rubyid_process_xml_elem'>process_xml_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2043
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
2044
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
2045
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
2046
+ <span class='kw'>end</span>
2047
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_is_outconfig_available'>is_outconfig_available</span><span class='lparen'>(</span><span class='rparen'>)</span>
2048
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_get_outconfig_child'>get_outconfig_child</span><span class='lparen'>(</span><span class='rparen'>)</span>
2049
+ <span class='kw'>else</span>
2050
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span>
2051
+ <span class='kw'>end</span>
2052
+ <span class='kw'>end</span></pre>
2053
+ </td>
2054
+ </tr>
2055
+ </table>
2056
+ </div>
2057
+
2058
+ <div class="method_details ">
2059
+ <h3 class="signature " id="query_children-instance_method">
2060
+
2061
+ #<strong>query_children</strong>(in_mo: nil, in_dn: nil, class_id: nil, hierarchy: false, timeout: &quot;60&quot;) &#x21d2; <tt>Array&lt;ManagedObject&gt;</tt><sup>?</sup>
2062
+
2063
+
2064
+
2065
+
2066
+
2067
+ </h3><div class="docstring">
2068
+ <div class="discussion">
2069
+
2070
+ <p>Finds children of a given managed object or distinguished name. Arguments
2071
+ can be specified to query only a specific type(class_id) of children.
2072
+ Arguments can also be specified to query only direct children or the entire
2073
+ hierarchy of children.</p>
2074
+
2075
+
2076
+ </div>
2077
+ </div>
2078
+ <div class="tags">
2079
+
2080
+ <div class="examples">
2081
+ <p class="tag_title">Examples:</p>
2082
+
2083
+
2084
+ <pre class="example code"><code><span class='id identifier rubyid_mo_list'>mo_list</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_children'>query_children</span><span class='lparen'>(</span><span class='label'>in_mo:</span> <span class='id identifier rubyid_mo'>mo</span><span class='rparen'>)</span></code></pre>
2085
+
2086
+
2087
+ <pre class="example code"><code><span class='id identifier rubyid_mo_list'>mo_list</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_children'>query_children</span><span class='lparen'>(</span><span class='label'>in_mo:</span> <span class='id identifier rubyid_mo'>mo</span><span class='comma'>,</span> <span class='label'>class_id:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>classid</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span></code></pre>
2088
+
2089
+
2090
+ <pre class="example code"><code><span class='id identifier rubyid_mo_list'>mo_list</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_children'>query_children</span><span class='lparen'>(</span><span class='label'>in_dn:</span> <span class='id identifier rubyid_dn'>dn</span><span class='rparen'>)</span></code></pre>
2091
+
2092
+
2093
+ <pre class="example code"><code><span class='id identifier rubyid_mo_list'>mo_list</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_children'>query_children</span><span class='lparen'>(</span><span class='label'>in_dn:</span> <span class='id identifier rubyid_dn'>dn</span><span class='comma'>,</span> <span class='label'>class_id:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>classid</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span></code></pre>
2094
+
2095
+ </div>
2096
+ <p class="tag_title">Parameters:</p>
2097
+ <ul class="param">
2098
+
2099
+ <li>
2100
+
2101
+ <span class='name'>in_mo</span>
2102
+
2103
+
2104
+ <span class='type'>(<tt>ManagedObject</tt>)</span>
2105
+
2106
+
2107
+
2108
+ &mdash;
2109
+ <div class='inline'>
2110
+ <p>query children managed object under this object.</p>
2111
+ </div>
2112
+
2113
+ </li>
2114
+
2115
+ <li>
2116
+
2117
+ <span class='name'>in_dn</span>
2118
+
2119
+
2120
+ <span class='type'>(<tt>String</tt>)</span>
2121
+
2122
+
2123
+
2124
+ &mdash;
2125
+ <div class='inline'>
2126
+ <p>query children managed object for a given managed object of the respective
2127
+ dn.</p>
2128
+ </div>
2129
+
2130
+ </li>
2131
+
2132
+ <li>
2133
+
2134
+ <span class='name'>class_id</span>
2135
+
2136
+
2137
+ <span class='type'>(<tt>String</tt>)</span>
2138
+
2139
+
2140
+
2141
+ &mdash;
2142
+ <div class='inline'>
2143
+ <p>by default nil, if given finds only specific childred object for a given
2144
+ class_id.</p>
2145
+ </div>
2146
+
2147
+ </li>
2148
+
2149
+ <li>
2150
+
2151
+ <span class='name'>hierarchy</span>
2152
+
2153
+
2154
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
2155
+
2156
+
2157
+
2158
+ &mdash;
2159
+ <div class='inline'>
2160
+ <p>if set to true will return all the child hierarchical objects.</p>
2161
+ </div>
2162
+
2163
+ </li>
2164
+
2165
+ <li>
2166
+
2167
+ <span class='name'>timeout</span>
2168
+
2169
+
2170
+ <span class='type'>(<tt>Integer</tt>)</span>
2171
+
2172
+
2173
+
2174
+ &mdash;
2175
+ <div class='inline'>
2176
+ <p>timeout value in seconds</p>
2177
+ </div>
2178
+
2179
+ </li>
2180
+
2181
+ </ul>
2182
+
2183
+ <p class="tag_title">Returns:</p>
2184
+ <ul class="return">
2185
+
2186
+ <li>
2187
+
2188
+
2189
+ <span class='type'>(<tt>Array&lt;ManagedObject&gt;</tt>, <tt>nil</tt>)</span>
2190
+
2191
+
2192
+
2193
+ </li>
2194
+
2195
+ </ul>
2196
+
2197
+ </div><table class="source_code">
2198
+ <tr>
2199
+ <td>
2200
+ <pre class="lines">
2201
+
2202
+
2203
+ 261
2204
+ 262
2205
+ 263
2206
+ 264
2207
+ 265
2208
+ 266
2209
+ 267
2210
+ 268
2211
+ 269
2212
+ 270
2213
+ 271
2214
+ 272
2215
+ 273
2216
+ 274
2217
+ 275
2218
+ 276
2219
+ 277
2220
+ 278
2221
+ 279
2222
+ 280
2223
+ 281
2224
+ 282
2225
+ 283
2226
+ 284
2227
+ 285
2228
+ 286
2229
+ 287
2230
+ 288
2231
+ 289
2232
+ 290
2233
+ 291
2234
+ 292</pre>
2235
+ </td>
2236
+ <td>
2237
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 261</span>
2238
+
2239
+ <span class='kw'>def</span> <span class='id identifier rubyid_query_children'>query_children</span><span class='lparen'>(</span><span class='label'>in_mo:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>in_dn:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>class_id:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2240
+ <span class='kw'>if</span> <span class='id identifier rubyid_in_mo'>in_mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span> <span class='kw'>and</span> <span class='id identifier rubyid_in_dn'>in_dn</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
2241
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ValueError</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[Error]: GetChild: Provide in_mo or in_dn</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2242
+ <span class='kw'>end</span>
2243
+
2244
+ <span class='kw'>if</span> <span class='id identifier rubyid_in_mo'>in_mo</span>
2245
+ <span class='id identifier rubyid_parent_dn'>parent_dn</span> <span class='op'>=</span> <span class='id identifier rubyid_in_mo'>in_mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span>
2246
+ <span class='kw'>elsif</span>
2247
+ <span class='id identifier rubyid_parent_dn'>parent_dn</span> <span class='op'>=</span> <span class='id identifier rubyid_in_dn'>in_dn</span>
2248
+ <span class='kw'>end</span>
2249
+
2250
+ <span class='kw'>if</span> <span class='id identifier rubyid_class_id'>class_id</span>
2251
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_find_class_id_in_mo_meta_ignore_case'>find_class_id_in_mo_meta_ignore_case</span><span class='lparen'>(</span><span class='id identifier rubyid_class_id'>class_id</span><span class='rparen'>)</span>
2252
+ <span class='kw'>if</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
2253
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_class_id'>class_id</span>
2254
+ <span class='kw'>end</span>
2255
+ <span class='kw'>else</span>
2256
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_class_id'>class_id</span>
2257
+ <span class='kw'>end</span>
2258
+
2259
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_config_resolve_children'>config_resolve_children</span><span class='lparen'>(</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='id identifier rubyid_class_id'>class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='comma'>,</span> <span class='id identifier rubyid_in_dn'>in_dn</span> <span class='op'>=</span> <span class='id identifier rubyid_parent_dn'>parent_dn</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
2260
+
2261
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
2262
+
2263
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
2264
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
2265
+ <span class='kw'>end</span>
2266
+
2267
+ <span class='id identifier rubyid_out_mo_list'>out_mo_list</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_extract_molist_from_method_response'>extract_molist_from_method_response</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
2268
+
2269
+ <span class='kw'>return</span> <span class='id identifier rubyid_out_mo_list'>out_mo_list</span>
2270
+ <span class='kw'>end</span></pre>
2271
+ </td>
2272
+ </tr>
2273
+ </table>
2274
+ </div>
2275
+
2276
+ <div class="method_details ">
2277
+ <h3 class="signature " id="query_classid-instance_method">
2278
+
2279
+ #<strong>query_classid</strong>(class_id:, hierarchy: false, need_response: false, timeout: &quot;60&quot;) &#x21d2; <tt>Array&lt;ManagedObject&gt;</tt>, ...
2280
+
2281
+
2282
+
2283
+
2284
+
2285
+ </h3><div class="docstring">
2286
+ <div class="discussion">
2287
+
2288
+ <p>Finds an object using it&#39;s class id.</p>
2289
+
2290
+
2291
+ </div>
2292
+ </div>
2293
+ <div class="tags">
2294
+
2295
+ <div class="examples">
2296
+ <p class="tag_title">Examples:</p>
2297
+
2298
+
2299
+ <pre class="example code"><code><span class='id identifier rubyid_obj'>obj</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>computeRackUnit</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span></code></pre>
2300
+
2301
+
2302
+ <pre class="example code"><code><span class='id identifier rubyid_obj'>obj</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>computeRackUnit</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>true</span><span class='rparen'>)</span></code></pre>
2303
+
2304
+
2305
+ <pre class="example code"><code><span class='id identifier rubyid_obj'>obj</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>computeRackUnit</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>need_response:</span> <span class='kw'>true</span><span class='rparen'>)</span></code></pre>
2306
+
2307
+ </div>
2308
+ <p class="tag_title">Parameters:</p>
2309
+ <ul class="param">
2310
+
2311
+ <li>
2312
+
2313
+ <span class='name'>class_id</span>
2314
+
2315
+
2316
+ <span class='type'>(<tt>String</tt>)</span>
2317
+
2318
+
2319
+
2320
+ &mdash;
2321
+ <div class='inline'>
2322
+ <p>class id of the object to be queried for.</p>
2323
+ </div>
2324
+
2325
+ </li>
2326
+
2327
+ <li>
2328
+
2329
+ <span class='name'>hierarchy</span>
2330
+
2331
+
2332
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
2333
+
2334
+
2335
+
2336
+ &mdash;
2337
+ <div class='inline'>
2338
+ <p>if set to true will return all the child hierarchical objects.</p>
2339
+ </div>
2340
+
2341
+ </li>
2342
+
2343
+ <li>
2344
+
2345
+ <span class='name'>need_response</span>
2346
+
2347
+
2348
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
2349
+
2350
+
2351
+
2352
+ &mdash;
2353
+ <div class='inline'>
2354
+ <p>if set to true will return only response object.</p>
2355
+ </div>
2356
+
2357
+ </li>
2358
+
2359
+ <li>
2360
+
2361
+ <span class='name'>timeout</span>
2362
+
2363
+
2364
+ <span class='type'>(<tt>Integer</tt>)</span>
2365
+
2366
+
2367
+
2368
+ &mdash;
2369
+ <div class='inline'>
2370
+ <p>timeout value(in seconds)</p>
2371
+ </div>
2372
+
2373
+ </li>
2374
+
2375
+ </ul>
2376
+
2377
+ <p class="tag_title">Returns:</p>
2378
+ <ul class="return">
2379
+
2380
+ <li>
2381
+
2382
+
2383
+ <span class='type'>(<tt>Array&lt;ManagedObject&gt;</tt>, <tt>Method_Response</tt>, <tt>nil</tt>)</span>
2384
+
2385
+
2386
+
2387
+ &mdash;
2388
+ <div class='inline'>
2389
+ <p>returns Method_Response if need_response is set to true</p>
2390
+ </div>
2391
+
2392
+ </li>
2393
+
2394
+ </ul>
2395
+
2396
+ </div><table class="source_code">
2397
+ <tr>
2398
+ <td>
2399
+ <pre class="lines">
2400
+
2401
+
2402
+ 211
2403
+ 212
2404
+ 213
2405
+ 214
2406
+ 215
2407
+ 216
2408
+ 217
2409
+ 218
2410
+ 219
2411
+ 220
2412
+ 221
2413
+ 222
2414
+ 223
2415
+ 224
2416
+ 225
2417
+ 226
2418
+ 227
2419
+ 228
2420
+ 229
2421
+ 230
2422
+ 231
2423
+ 232
2424
+ 233
2425
+ 234
2426
+ 235
2427
+ 236
2428
+ 237
2429
+ 238</pre>
2430
+ </td>
2431
+ <td>
2432
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 211</span>
2433
+
2434
+ <span class='kw'>def</span> <span class='id identifier rubyid_query_classid'>query_classid</span><span class='lparen'>(</span><span class='label'>class_id:</span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>need_response:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span> <span class='rparen'>)</span>
2435
+
2436
+ <span class='kw'>if</span> <span class='id identifier rubyid_class_id'>class_id</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
2437
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ValueError</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Provide Parameter class_id</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2438
+ <span class='kw'>end</span>
2439
+
2440
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_find_class_id_in_mo_meta_ignore_case'>find_class_id_in_mo_meta_ignore_case</span><span class='lparen'>(</span><span class='id identifier rubyid_class_id'>class_id</span><span class='rparen'>)</span>
2441
+
2442
+ <span class='kw'>if</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
2443
+ <span class='id identifier rubyid_meta_class_id'>meta_class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_class_id'>class_id</span>
2444
+ <span class='kw'>end</span>
2445
+
2446
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_config_resolve_class'>config_resolve_class</span><span class='lparen'>(</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='id identifier rubyid_class_id'>class_id</span> <span class='op'>=</span> <span class='id identifier rubyid_meta_class_id'>meta_class_id</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
2447
+
2448
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
2449
+
2450
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
2451
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
2452
+ <span class='kw'>end</span>
2453
+
2454
+ <span class='kw'>if</span> <span class='id identifier rubyid_need_response'>need_response</span>
2455
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span>
2456
+ <span class='kw'>end</span>
2457
+
2458
+ <span class='id identifier rubyid_out_mo_list'>out_mo_list</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_extract_molist_from_method_response'>extract_molist_from_method_response</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
2459
+ <span class='kw'>return</span> <span class='id identifier rubyid_out_mo_list'>out_mo_list</span>
2460
+
2461
+ <span class='kw'>end</span></pre>
2462
+ </td>
2463
+ </tr>
2464
+ </table>
2465
+ </div>
2466
+
2467
+ <div class="method_details ">
2468
+ <h3 class="signature " id="query_dn-instance_method">
2469
+
2470
+ #<strong>query_dn</strong>(dn:, hierarchy: false, need_response: false, timeout: &quot;60&quot;) &#x21d2; <tt>ManagedObject</tt>, ...
2471
+
2472
+
2473
+
2474
+
2475
+
2476
+ </h3><div class="docstring">
2477
+ <div class="discussion">
2478
+
2479
+ <p>Finds an object using it&#39;s distinguished name.</p>
2480
+
2481
+ <p>returns ExternalMethod if need_response is set to true.</p>
2482
+
2483
+
2484
+ </div>
2485
+ </div>
2486
+ <div class="tags">
2487
+
2488
+ <div class="examples">
2489
+ <p class="tag_title">Examples:</p>
2490
+
2491
+
2492
+ <pre class="example code"><code><span class='id identifier rubyid_obj'>obj</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_dn'>query_dn</span><span class='lparen'>(</span><span class='label'>dn:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>sys/rack-unit-1</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span></code></pre>
2493
+
2494
+
2495
+ <pre class="example code"><code><span class='id identifier rubyid_obj'>obj</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_dn'>query_dn</span><span class='lparen'>(</span><span class='label'>dn:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>sys/rack-unit-1</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>true</span><span class='rparen'>)</span></code></pre>
2496
+
2497
+
2498
+ <pre class="example code"><code>obj = handle.query_dn(dn: &quot;sys/rack-unit-1&quot;, need_response: true</code></pre>
2499
+
2500
+
2501
+ <pre class="example code"><code><span class='id identifier rubyid_obj'>obj</span> <span class='op'>=</span> <span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_query_dn'>query_dn</span><span class='lparen'>(</span><span class='label'>dn:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>sys/rack-unit-1</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='label'>need_response:</span> <span class='kw'>true</span><span class='rparen'>)</span></code></pre>
2502
+
2503
+ </div>
2504
+ <p class="tag_title">Parameters:</p>
2505
+ <ul class="param">
2506
+
2507
+ <li>
2508
+
2509
+ <span class='name'>dn</span>
2510
+
2511
+
2512
+ <span class='type'>(<tt>String</tt>)</span>
2513
+
2514
+
2515
+
2516
+ &mdash;
2517
+ <div class='inline'>
2518
+ <p>distinguished name of the object to be queried for.</p>
2519
+ </div>
2520
+
2521
+ </li>
2522
+
2523
+ <li>
2524
+
2525
+ <span class='name'>hierarchy</span>
2526
+
2527
+
2528
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
2529
+
2530
+
2531
+
2532
+ &mdash;
2533
+ <div class='inline'>
2534
+ <p>Gets all objects in hierarchy if true</p>
2535
+ </div>
2536
+
2537
+ </li>
2538
+
2539
+ <li>
2540
+
2541
+ <span class='name'>need_response</span>
2542
+
2543
+
2544
+ <span class='type'>(<tt>TrueClass</tt>, <tt>FalseClass</tt>)</span>
2545
+
2546
+
2547
+
2548
+ &mdash;
2549
+ <div class='inline'>
2550
+ <p>returns the response xml node, instead of parsed objects.</p>
2551
+ </div>
2552
+
2553
+ </li>
2554
+
2555
+ <li>
2556
+
2557
+ <span class='name'>timeout</span>
2558
+
2559
+
2560
+ <span class='type'>(<tt>Integer</tt>)</span>
2561
+
2562
+
2563
+
2564
+ &mdash;
2565
+ <div class='inline'>
2566
+ <p>timeout value(in seconds)</p>
2567
+ </div>
2568
+
2569
+ </li>
2570
+
2571
+ </ul>
2572
+
2573
+ <p class="tag_title">Returns:</p>
2574
+ <ul class="return">
2575
+
2576
+ <li>
2577
+
2578
+
2579
+ <span class='type'>(<tt>ManagedObject</tt>, <tt>Array&lt;ManagedObject&gt;</tt>, <tt>ExternalMethod</tt>)</span>
2580
+
2581
+
2582
+
2583
+ &mdash;
2584
+ <div class='inline'>
2585
+ <p>Return Managed Object by default, returns Array&lt;ManagedObject&gt; if
2586
+ hierarchy is set to true,</p>
2587
+ </div>
2588
+
2589
+ </li>
2590
+
2591
+ </ul>
2592
+
2593
+ </div><table class="source_code">
2594
+ <tr>
2595
+ <td>
2596
+ <pre class="lines">
2597
+
2598
+
2599
+ 164
2600
+ 165
2601
+ 166
2602
+ 167
2603
+ 168
2604
+ 169
2605
+ 170
2606
+ 171
2607
+ 172
2608
+ 173
2609
+ 174
2610
+ 175
2611
+ 176
2612
+ 177
2613
+ 178
2614
+ 179
2615
+ 180
2616
+ 181
2617
+ 182
2618
+ 183
2619
+ 184
2620
+ 185
2621
+ 186
2622
+ 187
2623
+ 188
2624
+ 189
2625
+ 190
2626
+ 191
2627
+ 192
2628
+ 193</pre>
2629
+ </td>
2630
+ <td>
2631
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 164</span>
2632
+
2633
+ <span class='kw'>def</span> <span class='id identifier rubyid_query_dn'>query_dn</span><span class='lparen'>(</span><span class='label'>dn:</span><span class='comma'>,</span> <span class='label'>hierarchy:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>need_response:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2634
+
2635
+ <span class='kw'>if</span> <span class='id identifier rubyid_dn'>dn</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
2636
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ValueError</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span> <span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Provide dn.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2637
+ <span class='kw'>end</span>
2638
+
2639
+ <span class='id identifier rubyid_elem'>elem</span> <span class='op'>=</span> <span class='id identifier rubyid_config_resolve_dn'>config_resolve_dn</span><span class='lparen'>(</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_cookie'>cookie</span><span class='comma'>,</span> <span class='id identifier rubyid_dn'>dn</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
2640
+
2641
+ <span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_post_elem'>post_elem</span><span class='lparen'>(</span><span class='id identifier rubyid_elem'>elem</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
2642
+
2643
+ <span class='kw'>if</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span> <span class='op'>!=</span> <span class='int'>0</span>
2644
+ <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ImcException</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_code'>error_code</span><span class='comma'>,</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_error_descr'>error_descr</span><span class='rparen'>)</span>
2645
+ <span class='kw'>end</span>
2646
+
2647
+ <span class='kw'>if</span> <span class='id identifier rubyid_need_response'>need_response</span>
2648
+ <span class='kw'>return</span> <span class='id identifier rubyid_response'>response</span>
2649
+ <span class='kw'>end</span>
2650
+
2651
+ <span class='kw'>if</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span>
2652
+ <span class='id identifier rubyid_out_mo_list'>out_mo_list</span> <span class='op'>=</span> <span class='const'>ImcCoreUtils</span><span class='period'>.</span><span class='id identifier rubyid_extract_molist_from_method_response'>extract_molist_from_method_response</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='comma'>,</span> <span class='id identifier rubyid_hierarchy'>hierarchy</span><span class='rparen'>)</span>
2653
+ <span class='kw'>return</span> <span class='id identifier rubyid_out_mo_list'>out_mo_list</span>
2654
+ <span class='kw'>end</span>
2655
+
2656
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='kw'>nil</span>
2657
+ <span class='id identifier rubyid_child'>child</span> <span class='op'>=</span> <span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_get_outconfig_child'>get_outconfig_child</span><span class='lparen'>(</span><span class='rparen'>)</span>
2658
+ <span class='kw'>if</span> <span class='id identifier rubyid_child'>child</span><span class='period'>.</span><span class='id identifier rubyid_size'>size</span> <span class='op'>&gt;</span> <span class='int'>0</span>
2659
+ <span class='id identifier rubyid_mo'>mo</span> <span class='op'>=</span> <span class='id identifier rubyid_child'>child</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
2660
+ <span class='kw'>end</span>
2661
+ <span class='kw'>return</span> <span class='id identifier rubyid_mo'>mo</span>
2662
+ <span class='kw'>end</span></pre>
2663
+ </td>
2664
+ </tr>
2665
+ </table>
2666
+ </div>
2667
+
2668
+ <div class="method_details ">
2669
+ <h3 class="signature " id="remove_mo-instance_method">
2670
+
2671
+ #<strong>remove_mo</strong>(mo:, timeout: &quot;60&quot;) &#x21d2; <tt>nil</tt>
2672
+
2673
+
2674
+
2675
+
2676
+
2677
+ </h3><div class="docstring">
2678
+ <div class="discussion">
2679
+
2680
+ <p>Remove a Managed Object from the IMC Server</p>
2681
+
2682
+
2683
+ </div>
2684
+ </div>
2685
+ <div class="tags">
2686
+
2687
+ <div class="examples">
2688
+ <p class="tag_title">Examples:</p>
2689
+
2690
+
2691
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_remove_mo'>remove_mo</span><span class='lparen'>(</span><span class='label'>mo:</span> <span class='id identifier rubyid_mo'>mo</span><span class='rparen'>)</span></code></pre>
2692
+
2693
+ </div>
2694
+ <p class="tag_title">Parameters:</p>
2695
+ <ul class="param">
2696
+
2697
+ <li>
2698
+
2699
+ <span class='name'>mo</span>
2700
+
2701
+
2702
+ <span class='type'>(<tt>ManagedObject</tt>)</span>
2703
+
2704
+
2705
+
2706
+ &mdash;
2707
+ <div class='inline'>
2708
+ <p>Managed Object to be removed.</p>
2709
+ </div>
2710
+
2711
+ </li>
2712
+
2713
+ <li>
2714
+
2715
+ <span class='name'>timeout</span>
2716
+
2717
+
2718
+ <span class='type'>(<tt>Integer</tt>)</span>
2719
+
2720
+
2721
+
2722
+ &mdash;
2723
+ <div class='inline'>
2724
+ <p>timeout value(in seconds).</p>
2725
+ </div>
2726
+
2727
+ </li>
2728
+
2729
+ </ul>
2730
+
2731
+ <p class="tag_title">Returns:</p>
2732
+ <ul class="return">
2733
+
2734
+ <li>
2735
+
2736
+
2737
+ <span class='type'>(<tt>nil</tt>)</span>
2738
+
2739
+
2740
+
2741
+ &mdash;
2742
+ <div class='inline'>
2743
+ <p>Nothing is returned.</p>
2744
+ </div>
2745
+
2746
+ </li>
2747
+
2748
+ </ul>
2749
+
2750
+ </div><table class="source_code">
2751
+ <tr>
2752
+ <td>
2753
+ <pre class="lines">
2754
+
2755
+
2756
+ 345
2757
+ 346
2758
+ 347
2759
+ 348
2760
+ 349
2761
+ 350
2762
+ 351
2763
+ 352
2764
+ 353</pre>
2765
+ </td>
2766
+ <td>
2767
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 345</span>
2768
+
2769
+ <span class='kw'>def</span> <span class='id identifier rubyid_remove_mo'>remove_mo</span><span class='lparen'>(</span><span class='label'>mo:</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2770
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>deleted</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2771
+ <span class='kw'>if</span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_defined?'>instance_variable_defined?</span><span class='lparen'>(</span><span class='symbol'>:@parent_mo</span><span class='rparen'>)</span> <span class='kw'>and</span> <span class='op'>!</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_parent_mo'>parent_mo</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
2772
+ <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_parent_mo'>parent_mo</span><span class='period'>.</span><span class='id identifier rubyid_child_remove'>child_remove</span><span class='lparen'>(</span><span class='id identifier rubyid_mo'>mo</span><span class='rparen'>)</span>
2773
+ <span class='kw'>end</span>
2774
+
2775
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span><span class='lbracket'>[</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_dn'>dn</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_mo'>mo</span>
2776
+ <span class='id identifier rubyid__commit'>_commit</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
2777
+ <span class='kw'>end</span></pre>
2778
+ </td>
2779
+ </tr>
2780
+ </table>
2781
+ </div>
2782
+
2783
+ <div class="method_details ">
2784
+ <h3 class="signature " id="set_mo-instance_method">
2785
+
2786
+ #<strong>set_mo</strong>(mo:, timeout: &quot;60&quot;) &#x21d2; <tt>nil</tt>
2787
+
2788
+
2789
+
2790
+
2791
+
2792
+ </h3><div class="docstring">
2793
+ <div class="discussion">
2794
+
2795
+ <p>Modifies a managed object and adds it to the ImcHandle commit buffer (if
2796
+ not already in it)</p>
2797
+
2798
+
2799
+ </div>
2800
+ </div>
2801
+ <div class="tags">
2802
+
2803
+ <div class="examples">
2804
+ <p class="tag_title">Examples:</p>
2805
+
2806
+
2807
+ <pre class="example code"><code><span class='id identifier rubyid_handle'>handle</span><span class='period'>.</span><span class='id identifier rubyid_set_mo'>set_mo</span><span class='lparen'>(</span><span class='label'>mo:</span> <span class='id identifier rubyid_mo'>mo</span><span class='rparen'>)</span></code></pre>
2808
+
2809
+ </div>
2810
+ <p class="tag_title">Parameters:</p>
2811
+ <ul class="param">
2812
+
2813
+ <li>
2814
+
2815
+ <span class='name'>mo</span>
2816
+
2817
+
2818
+ <span class='type'>(<tt>ManagedObject</tt>)</span>
2819
+
2820
+
2821
+
2822
+ &mdash;
2823
+ <div class='inline'>
2824
+ <p>Managed Object with modified properties</p>
2825
+ </div>
2826
+
2827
+ </li>
2828
+
2829
+ <li>
2830
+
2831
+ <span class='name'>timeout</span>
2832
+
2833
+
2834
+ <span class='type'>(<tt>Integer</tt>, <tt>nil</tt>)</span>
2835
+
2836
+
2837
+
2838
+ &mdash;
2839
+ <div class='inline'>
2840
+ <p>timeout value in seconds</p>
2841
+ </div>
2842
+
2843
+ </li>
2844
+
2845
+ </ul>
2846
+
2847
+ <p class="tag_title">Returns:</p>
2848
+ <ul class="return">
2849
+
2850
+ <li>
2851
+
2852
+
2853
+ <span class='type'>(<tt>nil</tt>)</span>
2854
+
2855
+
2856
+
2857
+ </li>
2858
+
2859
+ </ul>
2860
+
2861
+ </div><table class="source_code">
2862
+ <tr>
2863
+ <td>
2864
+ <pre class="lines">
2865
+
2866
+
2867
+ 328
2868
+ 329
2869
+ 330
2870
+ 331
2871
+ 332
2872
+ 333</pre>
2873
+ </td>
2874
+ <td>
2875
+ <pre class="code"><span class="info file"># File 'lib/ImcSdk.rb', line 328</span>
2876
+
2877
+ <span class='kw'>def</span> <span class='id identifier rubyid_set_mo'>set_mo</span><span class='lparen'>(</span><span class='label'>mo:</span><span class='comma'>,</span> <span class='label'>timeout:</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>60</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2878
+ <span class='comment'>#mo.instance_variable_set(:@status, &quot;modified&quot;)
2879
+ </span> <span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_set_prop'>set_prop</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>status</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>modified</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2880
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_to_commit'>to_commit</span><span class='lbracket'>[</span><span class='id identifier rubyid_mo'>mo</span><span class='period'>.</span><span class='id identifier rubyid_instance_variable_get'>instance_variable_get</span><span class='lparen'>(</span><span class='symbol'>:@dn</span><span class='rparen'>)</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_mo'>mo</span>
2881
+ <span class='id identifier rubyid__commit'>_commit</span><span class='lparen'>(</span><span class='label'>timeout:</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span>
2882
+ <span class='kw'>end</span></pre>
2883
+ </td>
2884
+ </tr>
2885
+ </table>
2886
+ </div>
2887
+
2888
+ </div>
2889
+
2890
+ </div>
2891
+
2892
+ <div id="footer">
2893
+ Generated on Wed Jun 7 14:23:17 2017 by
2894
+ <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
2895
+ 0.9.9 (ruby-2.3.1).
2896
+ </div>
2897
+
2898
+ </div>
2899
+ </body>
2900
+ </html>