1 kumpf 1.2 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man1.Z/Attic/wbemexec.1,v 1.1.2.1 2002/12/19 00:56:51 kumpf Exp $
  2           .TA w \" lowercase initial letter of .TH name
  3           .TH wbemexec 1
  4           .ds )H Hewlett-Packard Company
  5           .SH NAME
  6           wbemexec \- submit a CIM operation request to a CIM Server 
  7           .SH SYNOPSIS
  8           
  9           \fBwbemexec\fP [ \fB-h\fP hostname ] [ \fB-p\fP portnumber ] [ \fB-v\fP httpversion ] [ \fB-m\fP httpmethod ] [ \fB-t\fP timeout ] [ \fB-u\fP username ] [ \fB-w\fP password ] [ \fB-s\fP ] [ inputfilepath ]
 10           
 11           .SH DESCRIPTION
 12           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 kumpf 1.2 .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           and result in an HTTP response, containing a non-Success status code,
 28           such as 501 (Not Implemented) or 400 (Bad Request).
 29           .PP
 30           By default, the request is sent as an HTTP/1.1 request,
 31           using the HTTP M-POST method, and 
 32           .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           .PP
 37           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           wbem-http service, 
 42           and if that fails, another attempt is made on the default port for the
 43 kumpf 1.2 wbem-https service.
 44           .SS Options
 45           .B wbemexec
 46           recognizes the following options:
 47           .RS
 48           .TP 15
 49           \fB-h\fP hostname
 50           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           .TP
 55           \fB-p\fP portnumber
 56           Connect to the CIM Server on the specified port number.  
 57           If this option is not specified, 
 58           .B wbemexec
 59           connects to the default port for the wbem-http service, or if the 
 60           .B -s
 61           option is specified, to the default port for the wbem-https service.
 62           .TP
 63           \fB-v\fP httpversion
 64 kumpf 1.2 Use the specified HTTP version 
 65           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.
 66           .TP
 67           \fB-m\fP httpmethod
 68           Use the specified HTTP method 
 69           for the request.  The method must be "POST" or "M-POST".  
 70           .TP
 71           \fB-t\fP timeout
 72           Wait the specified number of milliseconds on sending a request, before timing out if no response has been received.  The 
 73           .I timeout 
 74           value must be an integer value greater than 0.
 75           .TP
 76           \fB-u\fP username
 77           Connect as the specified 
 78           .IR username . 
 79           If 
 80           .I username 
 81           is not specified, the current logged in user is used for authentication.
 82           This option is ignored if neither
 83           .I hostname 
 84           nor 
 85 kumpf 1.2 .I portnumber 
 86           is specified.
 87           .TP
 88           \fB-w\fP password
 89           Authenticate the connection using the specified 
 90           .IR password .
 91           If the 
 92           .I password 
 93           is not specified and the remote host requests authentication, the user is
 94           prompted for a password.
 95           This option is ignored if neither
 96           .I hostname 
 97           nor 
 98           .I portnumber 
 99           is specified.
100           .TP
101           .B -s
102           Enable the use of the SSL protocol between 
103           .C wbemexec 
104           and the CIM server.
105           The 
106 kumpf 1.2 .B -s
107           option should be specified if the CIM Server 
108           on the specified hostname/portnumber expects clients to connect using HTTPS.
109           (See
110           .B "cimconfig (1M)"
111           for information on configuring the CIM Server.)
112           This option is ignored if neither
113           .I hostname 
114           nor 
115           .I portnumber 
116           is specified.
117           .PD
118           .RE
119           
120           .SH EXIT STATUS
121           .PP
122           When an error occurs, an explanatory error message is written to stderr and an
123           appropriate value is returned.  The following exit values are returned:
124           .RS
125           .TP
126           .B 0
127 kumpf 1.2 Success
128           .PD 0
129           .TP
130           .B 1
131           Error
132           .PD
133           .RE
134           .SH EXAMPLES
135           .PP
136           Submit an XML request contained in the file cimrequest.xml to the CIM Server 
137           running on the local host on the default port:
138           .IP
139           .B wbemexec cimrequest.xml
140           .PP
141           Submit an XML request contained in the file cimrequest.xml to the CIM Server 
142           running on the host hpserver on port 49152, using the 
143           .I username 
144           guest and 
145           .I password 
146           guest for authentication:
147           .IP
148 kumpf 1.2 .B wbemexec -h hpserver -p 49152 -u guest -w guest cimrequest.xml
149           .PP
150           .SH SEE ALSO
151           .PP
152           cimserver(1M), cimconfig(1M).
153           .SH STANDARDS CONFORMANCE
154           .PP
155           \fBwbemexec\fP: CIM Operations over HTTP 1.0, Representation of CIM in XML 2.0