1 joyce.j 1.4 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1.Z/wbemexec.1,v 1.3 2004/11/23 11:36:42 alagaraja Exp $

  2 alagaraja 1.3 .\" .TA w \" lowercase initial letter of .TH name
  3               .TH "wbemexec" "1" "" "" ""
  4               .SH "NAME"

  5 kumpf     1.2 wbemexec \- submit a CIM operation request to a CIM Server 

  6 alagaraja 1.3 .SH "SYNOPSIS"
  7               \fBwbemexec\fP [ \fB\-h\fP hostname ] [ \fB\-p\fP portnumber ] [ \fB\-v\fP httpversion ]
  8                        [ \fB\-m\fP httpmethod ] [ \fB\-t\fP timeout ] [ \fB\-u\fP username ]
  9                        [ \fB\-w\fP password ] [ \fB\-s\fP ] [ \fB\-\-help\fP ] [ \fB\-\-version\fP ]

 10 joyce.j   1.4          [ inputfilepath ]

 11 alagaraja 1.3 .SH "DESCRIPTION"

 12 kumpf     1.2 The 
 13               .B wbemexec 
 14               command provides a command line interface to a CIM Server.
 15               The input to the command consists of a CIM request encoded in XML.
 16               The request is submitted to the CIM Server for execution.  
 17               If the HTTP response from the CIM Server contains a status code of 200 (OK), 
 18               the result returned to stdout is the CIM response encoded in XML.
 19               Otherwise, the result returned to stdout is the HTTP response.
 20               Some types of invalid XML requests (e.g. missing PROTOCOLVERSION attribute or
 21               missing NAME attribute) are detected by 
 22               .B wbemexec,
 23               and result in an error message from 
 24               .B wbemexec.
 25               Other invalid XML requests (e.g. invalid CIMVERSION attribute value
 26               or missing XML version), are detected by the CIM Server, 

 27 alagaraja 1.3 and result in an HTTP response, containing a non\-Success status code,

 28 kumpf     1.2 such as 501 (Not Implemented) or 400 (Bad Request).

 29 alagaraja 1.3 .PP 

 30 kumpf     1.2 By default, the request is sent as an HTTP/1.1 request,

 31 alagaraja 1.3 using the HTTP M\-POST method, and 

 32 kumpf     1.2 .B wbemexec 
 33               waits 20000 milliseconds (20 seconds),
 34               then times out if a response hasn't been received.  
 35               Input is read from stdin, if no input file is specified.

 36 alagaraja 1.3 .PP 

 37 kumpf     1.2 By default,
 38               the operation is executed on the local host.
 39               .B wbemexec
 40               first attempts to connect to the CIM Server on the default port for the

 41 alagaraja 1.3 wbem\-http service, 

 42 kumpf     1.2 and if that fails, another attempt is made on the default port for the

 43 alagaraja 1.3 wbem\-https service.

 44 kumpf     1.2 .SS Options
 45               .B wbemexec
 46               recognizes the following options:
 47               .RS
 48               .TP 15

 49 alagaraja 1.3 \fB\-h\fP hostname

 50 kumpf     1.2 Connect to the CIM Server on the specified host.
 51               If this option is not specified, 
 52               .B wbemexec 
 53               connects to the local host.

 54 alagaraja 1.3 .TP 
 55               .B \-\-help
 56               Display command usage information.
 57               .TP 
 58               \fB\-m\fP httpmethod
 59               Use the specified HTTP method 
 60               for the request.  The method must be "POST" or "M\-POST".  
 61               .TP 
 62               \fB\-p\fP portnumber

 63 kumpf     1.2 Connect to the CIM Server on the specified port number.  
 64               If this option is not specified, 
 65               .B wbemexec

 66 alagaraja 1.3 connects to the default port for the wbem\-http service, or if the 
 67               .B \-s
 68               option is specified, to the default port for the wbem\-https service.
 69               .TP 
 70               .B \-s
 71               Enable the use of the SSL protocol between 
 72               .C wbemexec 
 73               and the CIM server.
 74               The 
 75               .B \-s
 76               option should be specified if the CIM Server 
 77               on the specified hostname/portnumber expects clients to connect using HTTPS.
 78               .TP 
 79               \fB\-t\fP timeout

 80 kumpf     1.2 Wait the specified number of milliseconds on sending a request, before timing out if no response has been received.  The 
 81               .I timeout 
 82               value must be an integer value greater than 0.

 83 alagaraja 1.3 .TP 
 84               \fB\-u\fP username

 85 kumpf     1.2 Connect as the specified 

 86 alagaraja 1.3 .I R username . 

 87 kumpf     1.2 If 
 88               .I username 
 89               is not specified, the current logged in user is used for authentication.
 90               This option is ignored if neither
 91               .I hostname 
 92               nor 
 93               .I portnumber 
 94               is specified.

 95 alagaraja 1.3 .TP 
 96               \fB\-v\fP httpversion
 97               Use the specified HTTP version 
 98               for the request.  The version must be "1.0" or "1.1".  The 1.0 version may not be specified if the M\-POST method is specified.
 99               .TP 
100               \fB\-\-version\fP 
101               Display CIM Server version.
102               .TP 
103               \fB\-w\fP password

104 kumpf     1.2 Authenticate the connection using the specified 

105 alagaraja 1.3 .I R password .

106 kumpf     1.2 If the 
107               .I password 
108               is not specified and the remote host requests authentication, the user is
109               prompted for a password.
110               This option is ignored if neither
111               .I hostname 
112               nor 
113               .I portnumber 
114               is specified.
115               (See

116 alagaraja 1.3 .B "cimconfig (1)"

117 kumpf     1.2 for information on configuring the CIM Server.)
118               This option is ignored if neither
119               .I hostname 
120               nor 
121               .I portnumber 
122               is specified.
123               .PD
124               .RE
125               

126 alagaraja 1.3 .SH "EXIT STATUS"
127               .PP 

128 kumpf     1.2 When an error occurs, an explanatory error message is written to stderr and an
129               appropriate value is returned.  The following exit values are returned:
130               .RS

131 alagaraja 1.3 .TP 

132 kumpf     1.2 .B 0
133               Success
134               .PD 0

135 alagaraja 1.3 .TP 

136 kumpf     1.2 .B 1
137               Error
138               .PD
139               .RE

140 alagaraja 1.3 .SH "USAGE NOTE"
141               .PP 
142               The 
143               .B wbemexec 
144               command requires that the CIM Server is running.
145               .SH "EXAMPLES"
146               .PP 

147 kumpf     1.2 Submit an XML request contained in the file cimrequest.xml to the CIM Server 
148               running on the local host on the default port:

149 alagaraja 1.3 .IP 

150 kumpf     1.2 .B wbemexec cimrequest.xml

151 alagaraja 1.3 .PP 

152 kumpf     1.2 Submit an XML request contained in the file cimrequest.xml to the CIM Server 
153               running on the host hpserver on port 49152, using the 
154               .I username 
155               guest and 
156               .I password 
157               guest for authentication:

158 alagaraja 1.3 .IP 
159               .B wbemexec \-h hpserver \-p 49152 \-u guest \-w guest cimrequest.xml
160               .PP 
161               .SH "SEE ALSO"
162               .PP 
163               cimserver(1), cimconfig(1).
164               .SH "STANDARDS CONFORMANCE"
165               .PP 

166 kumpf     1.2 \fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0