Maintaining Access Definitions

#### Search Results

Search

# Maintaining Access Definitions

Kernel access definitions specify how other Kernels and clients can access this Kernel definition. Ordinarily, these are specified when the Kernel is defined, but you can add additional Kernel access definitions later, as needed.

Kernel access definitions are stored as access entries in the Kernel configuration file, along with its other access and connection definitions as well as all of its parameters. The Kernel configuration file is located in the directory wherever you installed Entire Net-Work Server and has a name in the format name.KERNEL, where name is the name you assigned the Kernel definition when you added it.

This document describes how to maintain Kernel access definitions. It covers the following topics:

- Listing Access Definitions

- Adding Access Definitions

- Modifying Access Definitions

- Deleting Access Definition

## Listing Access Definitions

To review and list the access definitions of a Kernel:

Make sure you have accessed the System Management Hub.

1. Select the name of the managed host on which Entire Net-Work Server is installed.

2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

3. Select "Entire Net-Work Server" in the tree-view under the managed host.

   The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

4. Expand Servers in tree-view, by clicking on the plus sign (+) to the left of its label.

   The list of installed servers appears.

5. Expand the name of the server in the server list in tree-view, by clicking on the plus sign (+) to the left of its label.

   A list of Kernels defined to the server appears.

6. In tree-view, expand the name of the Kernel for which you want to review access definitions by clicking on the plus sign (+) to the left of its label.

   The access and connection definition categories are listed beneath the Kernel name in tree-view.

   The Kernel access definitions are listed under the category names E-Business Access, E-Business Client Access and Classic Net-Work Access.

   Category | Description
   --- | ---
   E-Business Access | Lists the e-business (SSL and non-SSL) Kernel access definitions specified for the Kernel.
   E-Business Client Access | Lists the e-business (SSL and non-SSL) client access definitions specified for the Kernel.
   Classic Net-Work Access | Lists the classic access definitions specified for the Kernel. Classic access provides access with an Entire Net-Work 2 for Open Systems node, an Entire Net-Work 3 for OpenVMS node or with an Entire Net-Work 6 (mainframe) node that does not have the Simple Connection Line Driver installed.
   System Management Hub Access | Lists the System Management Hub (SMH) access definition, which uses a dynamic port number. Ordinarily, this should not be changed.

## Adding Access Definitions

To add access definitions to a Kernel:

Make sure you have accessed the System Management Hub.

1. Select the name of the managed host on which Entire Net-Work Server is installed.

2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

3. Select "Entire Net-Work Server" in the tree-view under the managed host.

   The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

4. Expand Servers in tree-view, by clicking on the plus sign (+) to the left of its label.

   The list of installed servers appears.

5. Expand the name of the server in the server list in tree-view, by clicking on the plus sign (+) to the left of its label.

   A list of Kernels defined to the server appears.

6. In tree-view, right-click on the name of the Kernel to which you want to add access definitions and select the Add Kernel Access command from the resulting drop-down menu.

   The Add Kernel Access panel appears in detail-view.

7. Fill in the fields on this panel, as described in the following table:

   Field | Description | Required?
   --- | --- | ---
   E-Business Access parameters | Select e-business access if you want to add an e-business Kernel access definition. Click in the E-Business Access checkbox (a checkmark should appear) to add a definition for e-business Kernel access. Specify the port number that should be used for this e-business Kernel access definition. A value of zero (0) indicates that Entire Net-Work should search for an available port and dynamically assign it. For more information about port numbers, read Port Number Reference. Optionally, specify any Adabas Directory Server additional parameters needed for this e-business Kernel access definition. Additional parameters you specify are described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. Note that not all Directory Server parameters apply to all access types. | If e-business server access is required, the E-Business Access checkbox must be checked. No other parameters are required.
   E-Business SSL Access parameters | Select e-business SSL access if you to add an e-business Kernel access definition that uses Secure Sockets Layer (SSL). Click in the E-Business SSL Access checkbox (a checkmark should appear) to add a definition for e-business Kernel access via SSL. Specify the port number that should be used for this e-business Kernel SSL access definition. A value of zero (0) indicates that Entire Net-Work should search for an available port and dynamically assign it. For more information about port numbers, read Port Number Reference. Optionally, specify any Adabas Directory Server additional parameters needed for this e-business Kernel access definition. Additional parameters you specify are described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. Note that not all Directory Server parameters apply to all access types. For assistance in setting up SSL support in Entire Net-Work, read Using the SSL Toolkit in the Encryption for Entire Net-Work User Guide, available from your Software AG support representative. Note Due to export restrictions, the SSL Toolkit is not included on the installation CD. If you plan to use SSL in your enterprise and want to use the SSL Toolkit, please contact your Software AG support representative. | If e-business server SSL access is required, the E-Business SSL Access checkbox must be checked. No other parameters are required.
   E-Business Client Access parameters | Select e-business client access if you want to add an e-business client access definition. Click in the E-Business Client Access checkbox (a checkmark should appear) to add a definition for e-business client access. Specify the port number that should be used for this e-business client access definition. A value of zero (0) indicates that Entire Net-Work should search for an available port and dynamically assign it. For more information about port numbers, read Port Number Reference. Optionally, specify any Adabas Directory Server additional parameters needed for this e-business Kernel access definition. Additional parameters you specify are described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. Note that not all Directory Server parameters apply to all access types. | If e-business Entire Net-Work Client access is required, the E-Business Client Access checkbox must be checked. No other parameters are required.
   E-Business SSL Client Access parameters | Select e-business client SSL access if you want to set up an e-business client access definition that uses Secure Sockets Layer (SSL). Click in the E-Business SSL Client Access checkbox (a checkmark should appear) to add a definition for e-business client access via SSL. Specify the port number that should be used for this e-business client SSL access definition. A value of zero (0) indicates that Entire Net-Work should search for an available port and dynamically assign it. For more information about port numbers, read Port Number Reference. Optionally, specify any Adabas Directory Server additional parameters needed for this e-business Kernel access definition. Additional parameters you specify are described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. Note that not all Directory Server parameters apply to all access types. For assistance in setting up SSL support in Entire Net-Work, read Using the SSL Toolkit in the Encryption for Entire Net-Work User Guide, available from your Software AG support representative. Note Due to export restrictions, the SSL Toolkit is not included on the installation CD. If you plan to use SSL in your enterprise and want to use the SSL Toolkit, please contact your Software AG support representative. | If e-business Entire Net-Work Client SSL access is required, the E-Business SSL Client Access checkbox must be checked. No other parameters are required.
   Classic Access parameters | Select classic access if you want to add an access definition for classic Entire Net-Work nodes. Classic access provides access with an Entire Net-Work 2 for open systems node, an Entire Net-Work 3 for OpenVMS node or with an Entire Net-Work 6 (mainframe) node that does not have the Simple Connection Line Driver installed. The classic access parameters include parameters that indicate whether this Kernel supports communication with access to Entire Net-Work Version 2 (classic) systems and, if so, the port number, node ID, and additional parameters that should be used for classic Entire Net-Work access. Click in the Classic Access checkbox (a checkmark should appear) to add a definition for a classic Entire Net-Work node. Specify the port number that should be used for this classic Entire Net-Work access definition. The default port number for this type of access is 7869. For more information about port numbers, read Port Number Reference. Specify the ID of the classic Entire Net-Work node for this classic access definition. Optionally, specify any Adabas Directory Server additional parameters needed for this e-business Kernel access definition. Additional parameters you specify are described in Parameters, in the chapter entitled Directory Server Target Entries of the Software AG Directory Server Installation and Administration Guide. Separate parameters in this field with ampersand (&) symbols. Note that not all Directory Server parameters apply to all access types. | If classic Entire Net-Work access is required, the Classic Access checkbox must be checked and a port number and node ID must be specified. No additional parameters are required.

8. Click OK.

   The Kernel access definitions are added to the Kernel configuration file. These definitions only become available to the Kernel after it is restarted.

## Modifying Access Definitions

To modify access definitions of a Kernel:

Make sure you have accessed the System Management Hub.

1. Select the name of the managed host on which Entire Net-Work Server is installed.

2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

3. Select "Entire Net-Work Server" in the tree-view under the managed host.

   The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

4. Expand Servers in tree-view, by clicking on the plus sign (+) to the left of its label.

   The list of installed servers appears.

5. Expand the name of the server in the server list in tree-view, by clicking on the plus sign (+) to the left of its label.

   A list of Kernels defined to the server appears.

6. Expand the name of the Kernel containing the access definition you want to modify by clicking on the plus sign (+) to the left of its label.

   The access and connection definition categories are listed beneath the Kernel name in tree-view.

   The access definitions are listed under the category names E-Business Access, E-Business Client Access, and Classic Net-Work Access.

7. Expand the category name containing the access definition you want to modify.

   The access definitions in that category are listed in tree-view.

8. Right-click on the access definition you want to modify and select Modify Entry from the resulting drop-down menu.

   A modification panel appears in detail-view, allowing you to modify the entry. For complete information about access definition parameters, read Adding Access Definitions

9. When all updates have been made, click OK.

   The Kernel access definitions are modified to the Kernel configuration file. Updates to the definitions only become available to the Kernel after it is restarted.

## Deleting Access Definition

To delete an access definition of a Kernel:

Make sure you have accessed the System Management Hub.

1. Select the name of the managed host on which Entire Net-Work Server is installed.

2. Expand the tree-view frame for the managed host by clicking on the plus sign (+) to the left of its name.

3. Select "Entire Net-Work Server" in the tree-view under the managed host.

   The Entire Net-Work Server administration area of the System Management Hub becomes available to you.

4. Expand Servers in tree-view, by clicking on the plus sign (+) to the left of its label.

   The list of installed servers appears.

5. Expand the name of the server in the server list in tree-view, by clicking on the plus sign (+) to the left of its label.

   A list of Kernels defined to the server appears.

6. Expand the name of the Kernel containing the access definition you want to delete by clicking on the plus sign (+) to the left of its label.

   The access and connection definition categories are listed beneath the Kernel name in tree-view.

   The access definitions are listed under the category names E-Business Access, E-Business Client Access, and Classic Net-Work Access.

7. Expand the category name containing the access definition you want to delete.

   The access definitions in that category are listed in tree-view.

8. Right-click on the access definition you want to delete and select Delete Entry from the resulting drop-down menu.

   A panel appears in detail-view verifying that you want to delete the access definition (entry) from the Kernel definition.

9. Click OK to confirm the deletion.

   The Kernel access definition is deleted from the Kernel configuration file. Updates to the definitions only become available to the Kernel after it is restarted.

### On this page

- Listing Access Definitions
- Adding Access Definitions
- Modifying Access Definitions
- Deleting Access Definition