Mainframe/Workstation Installation Checklist

This appendix lists the parameters that must be coordinated between the mainframe and workstation configurations. We recommend that mainframe or workstation installers agree on these values before installation is started.

This Appendix includes information about the following two types of parameters:

TCP/IP Connection Parameters

The following table lists the TCP/IP parameters that configure TCP/IP connection between the mainframe and the workstation. On the workstation, these parameters are contained in the /etc/svopen_config_DOMAINNAME file you configure using a text editor. The related mainframe parameters are set using the TCP parameter card in the NSPPARM member. The following worksheet lists the TCP/IP configuration parameters.

TCP/IP Configuration Parameters Worksheet

TCP/IP host name or address of the mainframe:
Mainframe value:	______________________________
Workstation value: SVMF_AGENT_ADDR=	______________________________
Default:	None

Connection protocol:
Mainframe value:	TCP parameter card
Workstation value: SVMF_CONNECT=	TCP
Default:	None

Host connection interface port:
Mainframe value:	______________________________
Workstation value: SVMF_HCI_AGENT_PORT=	TCP HCS_port ______________
Default:	6104

Host command server port:
Mainframe value:
Workstation value: SVMF_CMDS_AGENT_PORT=	TCP ________________ HCS_port
Default:	6105

The TCP/IP address of mainframe is the host name or IP address of the mainframe on which the application is installed. Use the SVMF_AGENT_ADDR parameter in the workstation /etc/vopen_config_DOMAINNAME file.

The connection protocol is the communication protocol between the mainframe and the workstation. The SVMF_CONNECT parameter indicates whether the workstation will connect to the mainframe using TCP/IP. To connect via TCP/IP, specify SVMF_CONNECT = TCP in the workstation /etc/svopen_config_DOMAINNAME file and provide a TCP parameter card at the mainframe.

The host connection interface port is the port number used by the host connection interface. Use this port number in the SVMF_HCI_AGENT_PORT parameter in the workstation /etc/svopen_config_DOMAINNAME file and on the mainframe TCP parameter card.

The host command server port is the port number used by the host command server. Use this port number in the SVMF_CMD_AGENT_PORT parameter in the workstation /etc/svopen_config_DOMAINNAME file and on the mainframe TCP parameter card.

Coding the TCP Parameter Card

Use the TCP parameter card at the mainframe to identify the ports to be used for the host command server and the host connection interface. The TCP parameter card has the following format:

TCP hciport cmdport

Where:

hciport is the port for the host connection interface (usually 6104).

cmdport is the port for the host command server (usually 6105).

LU 6.2 Parameters

This section describes an additional set of parameters for connecting the workstation to the mainframe using LU 6.2. The following worksheet lists the LU 6.2 parameters.

Note Before you configure LU 6.2, you must have already configured the mainframe and workstation to support an LU 6.2 connection between them. The mainframe application configuration adds only the information necessary for the workstation application to communicate with the mainframe application. Items like the Remote Link address have been omitted, since this should be already configured.

Connection protocol:
Mainframe value:	LU62 parameter card
Workstation value: SVMF_CONNECT=	LU62
Default:	None
Secondary independent LU:
Mainframe value:	______________________________
Workstation value:	______________________________
Default:	None
Log mode:
Mainframe value:	PARALLEL
Workstation value:	PARALLEL
Default:	PARALLEL
Message transaction program:
Mainframe value:	NSPOPNMS
Workstation value:	NSPOPNMS
Default:	NSPOPNMS
Command transaction program:
Mainframe value:	NSPOPNCS
Workstation value:	NSPOPNCS
Default:	NSPOPNCS

The connection protocol is the communication protocol between the mainframe and the workstation. The SVMF_CONNECT parameter indicates whether the workstation will connect to the mainframe using LU 6.2. To connect via TCP/IP, specify SVMF_CONNECT=LU62 in the /etc/svopen_config_DOMAINNAME file and provide a TCP parameter card at the mainframe.

The logmode specifies the VTAM logmode entry. Use PARALLEL on the SERVER parameter card.

The message transaction program identifies the workstation message server transaction program (MESSAGE_TP). Code NSPOPNMS on the SERVER parameter card.

The command transaction program identifies the workstation command server transaction program (COMMAND_TP). Code NSPOPNCS on the SERVER parameter card.

Coding the SERVER Parameter Card

You specify the mainframe parameters on the SERVER card in the NSPPARM member in the mainframe samples data set:

SERVER plu slu PARALLEL NSPOPNMS NSPOPNCS

Where:

plu is the label of the VTAM APPL definition that you coded with APPC=YES, that is the primary LU for the mainframe.

slu is the label of a CDRSC for the independent secondary LU defined for the workstation and associated with the workstation application PU.

PARALLEL is the logmode.

NSPOPNMS is the name of the SNA LU 6.2 transaction program for the workstation message server (MESSAGE_TP). You must use NSPOPNMS.

NSPOPNCS is the name of the SNA LU 6.2 transaction program for the workstation command server (COMMAND_TP). You must use NSPOPNCS.

Defining the Workstation SNA Package

On the workstation, you configure LU 6.2 workstation parameters using the SNA package on the workstation (Communications Server for AIX or SNAplus2Link). Use the following values:

The independent secondary LU defined for the workstation must match the slu parameter on the mainframe SERVER card.
The workstation message server (MESSAGE_TP) is NSPOPNMS.
The workstation command server (COMMAND_TP) is NSPOPNCS.
The log mode is PARALLEL.

Table of Contents