Return code
Description
0
The command succeeded.
1
The argument is invalid.
255
The command stopped due to an error other than the ones listed in this table.
The server ID is case insensitive and can consist of any ASCII printable character code (0x20-7E)
If you specify the server ID that has already been registered through the
hcmds64trust
command, the
connection destination information is not registered, and an error message is output specifying the same
server ID as the registered connection destination information.
Example: Changing the server ID
>hcmds64chgtsid -name example.com
KAPM15956-I The trusted server ID was changed successfully. (trusted server ID = example.com)
Example: Displaying the server ID
>hcmds64chgtsid -print
KAPM15955-I The trusted server ID will be displayed. (trusted server ID = example.com)
Example: An invalid option error
>hcmds64chgtsid -id example.com
KAPM15954-E An option is invalid.
usage: hcmds64chgtsid {-name trustedServerID | -print}
Example: Processing failure
>hcmds64chgtsid -name <256 characters or more>
KAPM15968-E The length of the trusted server ID exceeds 255 characters.
KAPM15953-E The hcmds64chgtsid command failed.
hcmds64trust command
Functions
The
hcmds64trust
command performs the following functions:
• Registers, deletes, and displays the destination information for performing authentication functions
with XP7 Command View Advanced Edition authentication zone. This is useful for registering
destination with the XP7 Command View Advanced Edition authentication zone with the proper
permissions.
• Shows the current server ID.
The server ID is case-insensitive and can consist of any ASCII printable character code (0x20-7E).
The registration is accomplished only if the connection and authentication is successful. Therefore, in
addition to the destination information, you must also supply the proper user name and password. The
specified user name must be someone who has the privileges to log onto the system. If you do not
specify user name and password as an option, you can have the user input by the information when
making the connection. For the string that is entered when the input request for user name and password,
do not check the character type and length of the string. In this case, the user name and password are
used only when the connection is confirmed, they are not registered as the destination information.
hcmds64trust command
91
