3270 interface

A 3270 interface, defined by the Host Interface parameter, has a set of required parameters that you must provide so that the record is read correctly, and also a set of optional parameters. Except for the Host Interface parameter, which you must specify first because it is position dependent, you can specify the parameters in any order, but the keywords must be provided. You must specify all parameters for the 3270 interface.

The following are required parameters:

Delay for ATTNs: A time delay, in milliseconds, between commands sent from the TPF Operations Server to the TPF system.
Host Interface: The type of interface that you are using to communicate with the TPF system. For this, specify 3270. You must specify this parameter first when defining a record in the configuration file because it is position dependent.
MCS Identifier: A character used by the TPF system to identify Multiple Console Support (MCS) and to mark the prefix that contains the terminal address and the functional support console (FSC) indicators. The MCS identifier is represented by the grave accent (`) by default in the TPF system.
If you do not need MCS, do not specify any value for the parameter. This indicates that MCS is not used (it is not available for 3270 console support), and sessions that are defined as TA=00 will be able to enter commands in 1052 state. MCS support is only available with 3215 consoles. Therefore, this parameter is ignored unless you are running a TPF system with 3215 console support on VM using [#VM3215] mode. If #CP commands are entered, an MCS header is not sent by the TPF Operations Server. See 3270 host connection for more information.
Profile: A PCOMM profile file (a *.WS file) that is used to open a session with the Session Name parameter if a session with that name does not already exist. The value of the parameter can be just the name of the file or the fully qualified path for the file. The maximum length is 256 characters. If the name or path contains spaces, the parameter value must be enclosed with quotation marks ("C:\IBM\PCOMM\test system.ws"). If there are no spaces, the quotation marks are not needed. If the TPF Operations Server is to used as a Windows service, use the fully qualified path for the parameter value. If the TPF Operations Server started the PCOMM session, it will shut down the session when the host port is closed. Do not close PCOMM sessions while a host port is open.
Note: If the HIDE string is specified anywhere in the profile name, the PCOMM 3270 session window is hidden from the desktop.
Session Name: A one-character identifier of the PCOMM screen that the TPF Operations Server is going to communicate with for the host port. In PCOMM, the session name is referred to as the short session ID. If a PCOMM session is already running and has the session name specified in this parameter, the TPF Operations Server will interface with that session. If the session is not active, it will open a PCOMM session with this parameter and use the specified PCOMM profile parameter.
Note: When you run the TPF Operations Server as a Windows service, a PCOMM session must be started by the TPF Operations Server. Do not start the sessions used by the TPF Operations Server from the Windows desktop.

The following are optional parameters:

3270 Trace: This option turns off specific trace messages for a 3270 host port. The messages will be seen only if the TPF Operations Server is running as a normal application and not as a Windows service. To activate this option, include this parameter in a host interface configuration file with a value of ON. To deactivate this option, specify OFF. If an incorrect value is provided or the option is removed, the parameter defaults to OFF.
BSS Name List: Allows you to provide a list of basic subsystem (BSS) names that are used to compare the subsystem name from message CSMP0097I with the user list to determine if the message was from the BSS. This allows a list of names to be recognized as the BSS in addition to the names BSS and BASE, which are recognized names for the basic subsystem even if the BSS Name List parameter is not used.
Cmd Echo Routing FSC: This activates command echo routing and determines what functional support console (FSC) settings receive command echo routing. Any 4-digit hexadecimal value or OFF is accepted; the default value is X'0000'.
Command Pace Limit: Specifies a delay value in milliseconds when entering consecutive commands from the TPF Operations Server to the host system. Valid values are from 0 to 60000 (60 seconds), and the default is No Delay or 0 milliseconds. Though you can use this parameter with any of the host interface types, the parameter is intended for use with the 3270 over PCOMM interface. Specify this parameter only when you need to slow down consecutive commands that are sent to the host system.
Display Client ID: Specifies whether the first field of the authentication credentials for a client is used for display purposes, such as in the command echo and in the output from the QTOS command. Displaying the client ID is not valid if Require Authentication is set to OFF or is not specified. Valid values are ON and OFF, and the default is ON.
Default Parsing Mode: There are three parsing modes for a 3270 host port: TPF, VM3215, and VM. You can change the parsing mode dynamically once the host port is active by using this option. Valid values are: TPF, VM3215, and VM. If this option is not defined or an incorrect value is provided, the parameter defaults to TPF.
Fall Back Type: Specifies the value used for the TYPE parameter when the TPF Operations Server issues an automatic ZACRS fallback command. Valid values are CON for a 3215ESCON interface, CRT for a 3270 interface, HMC for an HMC interface, and OFF to turn off the fallback type.
Fall Back Type: Specifies the value used for the TYPE parameter when the TPF Operations Server issues an automatic ZACRS command with the FBK parameter specified. Valid values are CON for the 3215 interface, CRT for a 3270 interface, HMC for an HMC interface, and OFF to turn off the automatic fallback option. See TPF Operations for information about the ZACRS command.
Force Message Pace: Specifies whether messages will be paced if a command fails to go to the host. Valid values are ON or OFF. A Force Message Pace of ON specifies that messages always will be paced even if a command does not fail to go to the host. The default value for Force Message Pace is OFF.
Message Pace Limit: Specifies a value in the range 50 - 3000. When a message counter in the server reaches the Message Pace Limit and a command fails, messages start to be paced until no more messages are received from the host. The default value for Message Pace Limit is 1000.
Message Pace Limit = 0 turns off all message pacing. It is recommended that you use the default values unless you are experiencing problems entering commands into a system during periods of heavy host output.
Require Authentication: Specifies whether or not a client must be authenticated successfully before the TPF Operations Server connects and accepts commands from it. Valid values are ON and OFF, and the default is OFF. To restrict client connections and TPF and TPF Operations Server commands, specify ON; otherwise specify OFF.
TPF Msg Trace: If this option is specified, all TPF messages received by the TPF Operations Server are sent to STDERR (standard error). The messages will be seen only if the TPF Operations Server is running as a normal application and not as a Windows service. To activate TPF message tracing, include this parameter in a host interface configuration file with a value of ON. To deactivate TPF message tracing, specify OFF. If an incorrect value is provided, TPF message tracing defaults to OFF.
Trace: Turns on traces for a particular host port. Traces are available only if the TPF Operations Server is running as a normal application and not as a Windows service. To activate traces, include this parameter in a host interface configuration file with a value of ON. To deactivate tracing, specify OFF. If an incorrect value is provided, the parameter defaults to OFF.