1 kumpf 1.5 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1.Z/wbemexec.1,v 1.4 2005/05/02 05:35:42 joyce.j 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 kumpf     1.5 .I password .

106 kumpf     1.2 This option is ignored if neither
107               .I hostname 
108               nor 
109               .I portnumber 
110               is specified.

111 kumpf     1.5 WARNING: A password should not be specified on the command line on a
112               multi-user system, since command-line options are typically world-readable
113               for a short window of time.  If the remote host requests authentication and
114               this option is not specified,
115               .B wbemexec
116               will prompt for the password.

117 kumpf     1.2 (See

118 alagaraja 1.3 .B "cimconfig (1)"

119 kumpf     1.2 for information on configuring the CIM Server.)
120               .PD
121               .RE
122               

123 alagaraja 1.3 .SH "EXIT STATUS"
124               .PP 

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

128 alagaraja 1.3 .TP 

129 kumpf     1.2 .B 0
130               Success
131               .PD 0

132 alagaraja 1.3 .TP 

133 kumpf     1.2 .B 1
134               Error
135               .PD
136               .RE

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

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

146 alagaraja 1.3 .IP 

147 kumpf     1.2 .B wbemexec cimrequest.xml

148 alagaraja 1.3 .PP 

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

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

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