An opening command opens a database. The database remains open until the matching closing command is sent. All changes made within a single command block are applied simultaneously when the database is closed. Any errors within the block cause the enclosed changes to be discarded.
An example of an opening command and its matching closing command are as follows:
<USER_INFO> </USER_INFO>
In all examples, the opening and closing commands are displayed.
XML header
The XML header ensures the connection is an XML connection, not an HTTP connection. The XML header is built into the cpqlocfg utility and has the following format:
<?xml version=”1.0”?>
Data types
The three data types that are allowed in the parameter are:
•String
•Specific string
•Boolean string
String
A string is any text enclosed in quotes. It can include spaces, numbers, or any printable character. A string may start with either a double or single quote and it must end with the same type of quote. The string may contain a quote if it is different from the string delimiter quotes.
For example, if a string is started with a double quote, a single quote can be used within the string and the string must be closed with a double quote.
Specific string
A specific string is one that is required to contain certain characters. In general, you have a choice of words that are accepted as correct syntax and all other words produce an error.
Boolean string
A Boolean string is a specific string that specifies a "yes" or "no" condition. Acceptable Boolean strings are "yes," "y," "no," "n," "true," "t," "false," and "f." These strings are not case sensitive.
Response definitions
Every command that is sent to the RILOE II generates a response. The response indicates whether the command succeeded or failed. Some commands generate additional information. The additional information is displayed in execution sequence, provided no errors occurred.
Example:
<RESPONSE
STATUS=“0x0001”
MSG=“There has been a severe error.”
/>
•RESPONSE
Scripting, command line, and utility options 139