Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java[TM] System Identity Manager 7.1 Resources Reference 

Natural

The Natural resource adapter is defined in the com.waveset.adapter.NaturalResourceAdapter class.

Resource Configuration Notes

None

Identity Manager Installation Notes

The Natural resource adapter is a custom adapter. You must perform the following steps to complete the installation process:

  1. To add the Natural resource to the Identity Manager resources list, you must add the following value in the Custom Resources section of the Configure Managed Resources page.

    2. com.waveset.adapter.NaturalResourceAdapter

  2. Copy the appropriate JAR files to the WEB-INF/lib directory of your Identity Manager installation.

    3. Connection Manager

    JAR Files

    Host On Demand

    The IBM Host Access Class Library (HACL) manages connections to the mainframe. The recommended JAR file containing HACL is habeans.jar. It is installed with the HOD Toolkit (or Host Access Toolkit) that comes with HOD. The supported versions of HACL are in HOD V7.0, V8.0, and V9.0.

    However, if the toolkit installation is not available, the HOD installation contains the following JAR files that can be used in place of the habeans.jar:

    • habase.jar
    • hacp.jar
    • ha3270.jar
    • hassl.jar
    • hodbase.jar

    See http://www.ibm.com/software/webservers/hostondemand/ for more information.

    Attachmate WRQ

    • RWebSDK.jar
    • wrqtls12.jar
    • profile.jaw

  3. Add the following definitions to the Waveset.properties file to define which service manages the terminal session:

    4. serverSettings.serverId.mainframeSessionType=Value
    serverSettings.default.mainframeSessionType=Value

    Value can be set as follows:

    • 1 — IBM Host On--Demand (HOD)
    • 3 — Attachmate WRQ

      • If these properties are not explicitly set, then Identity Manager attempts to use WRQ, then HOD.

  4. Restart your application server so that the modifications to the Waveset.properties file can take effect.
  5. See Mainframe Connectivity for information about configuring SSL connections to the resource.

Usage Notes

This section describes dependencies and limitations related to using the Natural resource adapter.

Administrators

Host resource adapters do not enforce maximum connections for an affinity administrator across multiple host resources connecting to the same host. Instead, the adapter enforces maximum connections for affinity administrators within each host resource.

If you have multiple host resources managing the same system, and they are currently configured to use the same administrator accounts, you might have to update those resources to ensure that the same administrator is not trying to perform multiple actions on the resource simultaneously.

Resource Actions

The Natural adapter requires login and logoff resource actions. The login action negotiates an authenticated session with the mainframe. The logoff action disconnects when that session is no longer required.

See Mainframe Examples for more information about creating login and logoff resource actions.

Security Notes

This section provides information about supported connections and privilege requirements.

Supported Connections

Identity Manager uses Secure TN3270 connections to communicate with the resource.

See Mainframe Connectivity for information about setting up an SSL connection to a RACF LDAP resource.

Required Administrative Privileges

None

Provisioning Notes

The following table summarizes the provisioning capabilities of this adapter.

Feature

Supported?

Enable/disable account

Yes

Rename account

 

Pass-through authentication

 

Before/after actions

Yes

Data loading methods

Import from resource

Account Attributes

The following table provides information about Natural account attributes.

Resource User Attribute

Data Type

Description

PASSWORD

String

Account’s password

GROUPS

String

List of groups to which the user is assigned

USERID

String

The account name

NAME

String

The user’s name

COPYUSER

String

Name of the account to use as a template when you create an account. You must specify this attribute when creating an account.

COPYLINKS

Boolean

Indicates whether to copy the links specified in COPYUSER when creating the account.

Default is false.

DEFAULT_LIBRARY

String

Name of the account’s default library.

Resource Object Management

Not supported

Identity Template

$accountId$

Sample Forms

None

Troubleshooting

Use the Identity Manager debug pages to set trace options on the following class:

com.waveset.adapter.NaturalResourceAdapter



Previous      Contents      Index      Next     

.   Copyright 2007 Sun Microsystems, Inc. All rights reserved.