server task jmt

The server task jmt command clears or loads the junction mapping table data.

Requires authentication (administrator ID and password) to use this command.

Syntax

server task instance_name-webseald-host_name jmt load

server task instance_name-webseald-host_name jmt clear

Options

instance_name-webseald-host_name

Specifies the full server name of the installed WebSEAL instance. You must specify this full server name in the exact format as displayed in the output of the server list command.

The instance_name specifies the configured name of the WebSEAL instance. The webseald designation indicates that the WebSEAL service performs the command task. The host_name is the name of the physical machine where the WebSEAL server is installed.

For example, if the configured name of a single WebSEAL instance is default, and host machine name where the WebSEAL server is installed is abc.ibm.com, the full WebSEAL server name is default-webseald-abc.ibm.com.

If an additional WebSEAL instance is configured and named web2, the full WebSEAL server name is web2-webseald-abc.ibm.com.

jmt clear

Clears the junction mapping table data.

jmt load

Loads the junction mapping table data, which is located in the jmt.conf file. This file does not exist by default, so you must create the file and add data.

Authorization

Users and groups that require access to this command must be given the s (server administration) permission in the ACL that governs the /WebSEAL/host_name-instance_name/ object. For example, the sec_master administrative user is given this permission by default.

Note: This command is available only when WebSEAL is installed.

Return codes

0: The command completed successfully.
Note: For WebSEAL server task commands, the return code will be 0 when the command is sent to the WebSEAL server without errors. Even if the command was successfully sent, the WebSEAL server might not be able to successfully complete the command and can return an error message.
1: The command failed. When a command fails, the pdadmin command provides a description of the error and an error status code in hexadecimal format (for example, 0x14c012f2).
See "Error messages" in the IBM Knowledge Center which provides a list of the Verify Identity Access error messages by decimal or hexadecimal codes.

Note: For more information about the WebSEAL junction mapping table, see the IBM Verify Identity Access for Web: WebSEAL Administration Guide.

Examples

The following example loads the junction mapping table data from the jmt.conf file so that WebSEAL has knowledge of the new information:

pdadmin> server task default-webseald-abc.ibm.com jmt load

Output is similar to: