HP StorageWorks XP Command View Advanced Edition software Device Manager server installation and configuration guide (web version) (T1780-96078, March 2008)

XP Command View AE Suite Common Component
143
pass: Specifies the password for the user ID used to register or delete the user-defined
application link.
nolog: Suppresses outputting messages to the command line. However, even when this option
is specified, messages for option errors are displayed.
User-defined application file (the following shows coding examples in the user-defined application
file):
CAUTION: To code the user-defined application file, use ASCII code only. Also note that you
cannot use a control code other than the CR and LF control code.
@TOOL-LINK
@NAME SampleApp
@URL http://SampleApp/index.html
@DISPLAYNAME SampleApplication
@DISPLAYORDER 1
@ICONURL http://SampleApp/graphic/icon.gif
@TOOL-END
The items to be specified in the user-defined application file are as follows:
@TOOL-LINK: The start key. The information between the start key and the end key is the
setting information. This item is required.
@NAME: Information used as the key for registration. Specify a unique name. This item is
required. The maximum length of the name is 256 bytes. Use alphanumeric characters only.
@URL: The URL of the target of the link from web client. The maximum length of the URL is
256 bytes. You cannot use an IPv6 address. You must use a host name to specify the URL in
an IPv6 environment.
@DISPLAYNAME: The name displayed in the link dialog box that appears when you choose
Go and then Links in the global tasks bar area of web client. If no information is specified, the
name specified in @NAME is displayed. You can specify a Unicode code point in the range
from U+10000 to U+10FFFF. The maximum length of the name is 80 characters.
@DISPLAYORDER: The order of the application displayed in the link dialog box that appears
when you choose Go and then Links in the global tasks bar area of web client. The
applications are displayed in ascending order of this value. You can specify a value in the
range from -2147483648 to 2147483647.
@ICONURL: The URL of the icon displayed beside the link. The maximum length of the URL is
256 bytes. You cannot use an IPv6 address. You must use a host name to specify the URL in
an IPv6 environment.
@TOOL-END: The end key. This item is required.
Return values:
0: Normal termination
255: Failure
If you do not specify the nolog option, you can judge whether or not the command was successful
from the output message. If you specify the nolog option, no message is output. Therefore, you
need to use the return value of the command to judge whether or not the command was successful.
For details about errors, see the contents of the following log files.
• In Windows:
<common component installation folder>\log\hcmdslinkn.log
• In Linux:
/var/<common component installation directory>/log/hcmdslinkn.log
Command execution examples (in Windows)