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.