Initiate the workstation connection

If you select "Workstation connection" and your Workstation Agent code matches the latest level available, the Initiate Workstation Connection panel appears, as shown in Figure 1.

Figure 1. Initiate Workstation Connection panel (ISPISMGI)

  ┌──────────────────────────── ISPF Settings ────────────────────────────┐
─ │                   Initiate Workstation Connection                     │ ──
  │                                                                       │
  │ /  Save values in system profile?  (/=Yes)                            │  +
O │                                                                       │
  │ Workstation Connection                    GUI Network Protocol        │
  │ 1  1. With GUI display                    1  1. TCP/IP                │
  │    2. Without GUI display                    2. APPC                  │
  │                                              3. Use ISPDTPRF file     │
  │                                                                       │
  │ GUI Title                                                             │
  │                                                                       │
  │ TCP/IP Address                                                        │
  │                                                                       │
  │ APPC Address                                                          │
  │                                                                       │
  │                                                                       │
  │                                                                       │
T │ Host Codepage  . . .          Host Character Set . . .                │
  │                                                                       │
  │ GUI Window Frame              Default Window Background Color         │
  │ 1  1. Standard (STD)          1  1. Dialog (DLG)                      │
  │    2. Fixed (FIX)                2. Standard (STD)                    │
  │    3. Dialog (DLG)                                                    │
  │                                                                       │
T │ Press ENTER to initiate a session. Press EXIT or CANCEL to return     │
  │ without initiating a session.                                         │
  │ Command ===>                                                          │
C │  F1=Help       F2=Split      F3=Exit       F7=Backward   F8=Forward   │
  │  F9=Swap      F12=Cancel                                              │
F └───────────────────────────────────────────────────────────────────────┘

Note: If your WSA is not running, this panel will appear but you will not be able to establish a connection.

The Initiate Workstation Session panel allows you to specify that you want to start a GUI session. Starting a GUI session from this panel if you are in split screen mode or 3290 partition mode is not supported. If you select Workstation connection, you must specify the information in these fields, as appropriate:

Save values in system profile?

The default for this setting is YES. Any changes to this field are saved in the user's system profile.

Workstation connection

Allows you to specify one of these types of connections for your workstation session:

With GUI display: A GUI interface is provided for this session.
Without GUI display: A standard ISPF type of interface is provided for this session.

GUI Network Protocol

The type of network you use to connect the workstation to the host: TCP/IP or APPC.

You can also select the third option "Use ISPDTPRF file", to specify that ISPF get your network address from the file allocated to DD ISPDTPRF. The file can be sequential or a member of a PDS, and it can be fixed blocked (FB) or variable blocked (VB). Each line of the file should be formatted as follows: userid WORKSTAT protocol_id:network_address, where:

userid: user's TSO userid
protocol_id: network protocol identifier, either ip for TCP/IP or lu for APPC.
network_address: workstation address

For example, KEENE WORKSTAT ip:9.45.202.69.

GUI Title

The title you want displayed in the window frame of your GUI session. This value will be used if dialog variable ZWINTTL or ZAPPTTL is not found.

TCP/IP Address

The workstation's IP address. Required if you specified TCP/IP in the GUI Network Protocol field. The TCP/IP Address prompt is point-and-shoot text. If selected, a pop-up window is displayed containing the last five addresses saved in the system profile.

A TCP/IP address can be in dotted decimal format or in domain name format. Dotted decimal format is a sequence of decimal numbers separated by periods, for example, 9.87.654.321.

A TCP/IP address in domain name format consists of one or more domain qualifiers separated by periods. The minimum specification for addresses within the same domain is a TCP/IP host name, for example, jsmith. The fully-qualified domain name for jsmith is formed by appending the appropriate subdomain name and root domain name to jsmith, such as jsmith.raleigh.ibm.com. To use domain naming, a domain name server must be active and providing domain name resolution for domain names within your TCP/IP network. The domain name server address is determined by the value of the NSINTERADDR statement in the TCP/IP configuration data set. ISPF must be able to locate the TCP/IP configuration data set as described in the section on configuring TCP/IP connections in the z/OS ISPF User's Guide Vol I.

If an asterisk (*) is specified, the TCP/IP address is obtained automatically from the value of the system variable ZIPADDR.

APPC Address

The workstation's APPC network name. Required if you specified APPC in the GUI Network Protocol field. The APPC Address prompt is point-and-shoot text. If selected, a pop-up window is displayed containing the last five addresses saved in the system profile.

An APPC address can be in fully-qualified LU name format or in symbolic destination name format. A fully-qualified LU name format consists of a network identifier and an LU name, separated by a period. For example, USIBMNR.NRI98X00 is a fully-qualified LU name.

An APPC address in symbolic destination name format consists of a 1- to 8-character name such as JSMITH. The symbolic destination name must be defined as a DESTNAME and the corresponding fully-qualified LU name must be defined as the associated PARTNER_LU in the APPC/MVS side information.

Host Codepage

The host code page value used in translating data from the host to the workstation. This value must be specified with a Host Character Set value if it is to be used. If only one, or neither, of these values is specified, the values from the terminal query are used. If your terminal or emulator does not support code pages, the CODEPAGE and CHARSET parameter values on the ISPSTART command are used. If the ISPSTART values are not specified, the default code page and character set is ENGLISH.

Host Character Set

The host character set value used in translating data from the host to the workstation. This value must be specified with a Host Codepage value if it is to be used. If only one, or neither, of these values is specified, the values from the terminal query are used. If your terminal or emulator does not support code pages, the CODEPAGE and CHARSET parameter values on the ISPSTART command are used. If the ISPSTART values are not specified, the default code page and character set is ENGLISH.

GUI Window Frame

Allows you to specify one of these types of window frames for your GUI session:

1: Standard (STD). A GUI window frame that can be resized and that has max/min buttons.
2: Fixed (FIX). A GUI window frame that has a min button but cannot be resized.
3: Dialog (DLG). A GUI window frame that cannot be resized and that does not have max/min buttons.

Note: Pop-up panels will always be displayed in dialog window frames.

Default window background color

Select the background color:

Dialog (DLG)
Standard (STD)

When you complete the fields shown in Figure 1 and press Enter, the WSA connection panel is displayed in a separate window (unless your system has been set up to bypass it - see the topic about the System Register panel in "Installing the Client/Server component", in the z/OS ISPF User's Guide Vol I for details).

Figure 2. WSA connection panel

This panel indicates the requestor and the type of connection requested. Click on Yes to accept the connection as described, or No to reject the connection.

If you accept the connection, the ISPF Settings panel is displayed. This will be in standard or GUI mode, depending on the option selected in the With GUI display field.