Administration Version 6.2.1
 —  Administration  —

SMH DRIVER Statement

The Entire Net-Work SMH line driver is used to access the System Management Hub. The SMH driver uses the TCP/IP protocol stack. In order to activate and define the System Management Hub, an SMH DRIVER statement and an SMH LINK statement must be defined.

This document covers the following topics:


SMH DRIVER Statement Format

The SMH DRIVER statement format is based on the TCPI and TCPX DRIVERS statements and uses the same parameter parser. However, only the parameters listed in the syntax in this section have any relevance or can be changed for the SMH driver.

The SMH DRIVER statement has the following format:

graphics/smhd1.png

For more information about syntax conventions and rules used in this section, read Conventions.

The access method for the SMH DRIVER statement is SMH, which instructs Entire Net-Work to load the line driver module NETSMH.

Other TCPX DRIVER parameters that are relevant to the SMH DRIVER statement have predefined settings that should not be changed:

Top of page

Modifying the Driver Statement Parameters

The SMH DRIVER statement parameters are read from a sequential file during system startup, and can be modified after startup using the ALTER operator command. Some parameters can be modified when the line driver is open or closed. Others can be modified only when the line driver is closed. Refer to the specific parameter description for information on possible restrictions about modifying the parameter using the ALTER command. The open or closed requirement for each parameter is included in the SMH DRIVER parameter descriptions.

Top of page

SMH DRIVER Statement Parameters

This section describes all of the parameters that can be used for the SMH DRIVER statement.

For more information about syntax conventions and rules used in this section, read Conventions.

API Parameter

graphics/smhdap1.png

This required parameter specifies the name of the TCP/IP application program interface being used. The API parameter can be modified only when the line driver is closed. Supported values are shown in the table below. There is no default.

Value Description Valid for Platforms
HPS Loads the IBM interface NWTCPHPS (High Performance Native Sockets) z/OS
IBM Loads the IBM interface NWTCPIBM z/VM GCS
OES Loads the IBM OpenEdition sockets interface NWTCPOES z/OS

Note:
When specified for the SMH line driver, the value of the API parameter must be the same as the value of the API parameter set for the TCPX DRIVER statement.

SERVERID Parameter

graphics/smhdserv.png

This optional parameter specifies a well known port number used by Entire Net-Work while awaiting connection requests from participating Entire Net-Work partners. Values may range from 1 to 65535. The SERVERID parameter can be modified only when the line driver is closed.

When specified in a DRIVER statement, the SERVERID parameter specifies the port number of the Entire Net-Work being initialized. If SERVERID is not specified for a link, the SERVERID specified for the driver is used as the default port for the link.

The default for this parameter is 8010. Only the DRIVER statement has a SERVERID parameter.

SUBSYS Parameter

graphics/smhdsubs.png

This parameter specifies the name of the subsystem to be accessed by the API routines that use subsystem control blocks in interaddress space communications. The default value is VMCF. The SUBSYS parameter can be modified only when the line driver is closed.

In a z/OS environment, the IBM API routines communicate to the system address space by locating the subsystem control table and retrieving the information required to perform cross-memory communication. If the subsystem is specified incorrectly, the driver is not able to perform its open processing and no connections are possible.

This parameter is not used in a z/VSE or BS2000 environment.

USERID Parameter

graphics/smhd2.png

This parameter's value can be modified only when the line driver is closed.

The USERID parameter specifies the name of the started task, job, or virtual machine in which the IBM TCP/IP protocol stack is running. The value is 1-8 characters. The default value is TCPIP.

Top of page