User's Manual

30 Remote Services Operations
b The DetachISOImage() method on the
DCIM_OSDeploymentService class detaches and removes the
network share based ISO image that had been previously attached by
an invocation of the
BootToNetworkISO() method.
• Several methods described in this document return job identifiers as
output parameters. The jobs provide a means of keeping track of a
requested action that cannot be performed immediately and, because of
underlying technology constraints, will take longer than standard web
service request response timeouts. The returned job identifier can
subsequently be used in WS-MAN Enumerate or Get requests to retrieve
job object instances. Job object instances contain a job status property that
can be checked to see what state the job is in and whether it completed
successfully or encountered a problem and failed. If a job failure occurs,
the job instance also contains an error message property that provides
detailed information on the nature of the failure. Other properties contain
other error identification information that can be used to localize the error
message to the supported languages and get more detailed error
descriptions and recommended response action descriptions.
•The
GetHostMACInfo() method on the DCIM_OSDeploymentService
class returns an array of physical network port MAC addresses representing
all the LAN on Motherboard (LOM) ports in the system. The method
requires no input parameters.
• All the
DCIM_OSDeploymentService methods described in this
document return error codes indicating whether the method successfully
executed, an error occurred, or a job was created. Job creation occurs if the
action being performed in the method cannot be completed immediately.
Additionally, if an error occurs, the methods will also return output
parameters that include an error message (in English) and other error
identifiers that can be used to localize the error to the supported
languages. The error identifiers can be used to index into and process Dell
Message Registry XML files. The Dell Message Registry files are available
in the six supported languages, one file per language. In addition to
translated error messages, the Message Registry files contain additional
detailed error descriptions and recommended response actions for each
error returned by the Lifecycle Controller Remote Services web service
interface. To download the Dell Message Registry XML files, see
delltechcenter.com/page/Lifecycle+Controller .
RemoteServices1_4.book Page 30 Thursday, October 21, 2010 5:05 PM