The Parameter Library (PARMLIB) › VTP2POPT Parmlib Member › Peer To Peer Options Section

Peer To Peer Options Section

This section contains an alphabetic list of the Peer To Peer Options attributes. The list includes a description of each attribute, its valid values, and the CA Vtape features it supports.

Observe the following:

• Values in the Valid Values section enclosed in quotes must be entered with quotes. For example: DsnameLocalVCAT='CAVTAPE.SYS1.VCAT'
• Values in the Valid Values section enclosed in parentheses must be entered with parentheses. For example: RoutingCodeCritical=(1,7,9)
• All of the attributes in this list are optional. If commented out or not coded, the documented default will be used.
• Attributes in this section are only loaded when CA Vtape is started. A change to any of these attributes will not take effect until CA Vtape is stopped and started.

DsnameSYSTCPD=

Defines the name of the profile data set associated TCP/IP subsystem. The profile data set is used to resolve a host name to a TCP/IP address. This profile data set must be assigned to the SYSTCPD DD.

If JCL is specified then CA Vtape uses the data set assigned to the SYSTCPD DD specified in the JCL used to start the subsystem.

If a data set name is specified then the program will dynamically allocate the data set to the SYSTCPD DD.

Valid Values: JCL or a valid data set name

Default: JCL

Section: <PeertoPeerOptions>

Feature: PeerToPeer

EMCSTerminalPrefix=

Defines the prefix for the EMCS console terminal name. The P2P Listener allocates an Extended Management Console (EMCS) to route SVTS commands remotely. EMCS requires an eight character console terminal name which must be unique within the sysplex (that is, the same name cannot be used on different LPARs).

The eight character console name created by CA Vtape consists of:

xxxnyyyy

Where:

xxx

Is the EMCSTerminalPrefix.

n

Is the SVTS subsystem number (that is, 1..8).

yyyy

Is the first four characters of the SYSNAME.

Assign a unique three character string value to EMCSTerminalPrefix, if the default value 'SVT' conflicts with the console naming convention used within your environment.

Valid Values: SVT or any 3 character string

Default: SVT

Section: <PeertoPeerOptions>

Feature: PeerToPeer

IdleTaskTimeOut=

Defines how many minutes one of these subtasks may remain idle before terminating. The P2P Listener uses this attribute to release resources as workload demands change. The P2P Listener is a server which runs in the SVTxUT address space. It consists of multiple subtasks which handle remote commands, connection requests, files transfers, and console operations. The P2P Listener dynamically attaches subtasks to handle these functions based on demand. Normally, as activity subsides these subtasks return to an idle wait state.

Valid Values: 1 to 1440

Default: 30

Section: <PeertoPeerOptions>

Feature: PeerToPeer

ListenOnIPaddress=

Defines a TCP/IP address if you want to control the IP address used for receiving or establishing remote connections. This may be useful if you are using VIPA to provide a fall back for connection errors. Omitting this parameter or specifying $NULL will allow the CA Vtape P2P Listener program to accept connections over any network interfaces of the local host.

Valid Values: A valid TCP/IP address

Default: $NULL

Section: <PeertoPeerOptions>

Feature: PeerToPeer

ListenOnPort=

Defines a valid TCP/IP port number over which the CA Vtape P2P Listener program will accept remote connections.

We recommend using an IP port range that uses the SVTS subsystem as the last digit. This will allow you to easily enable multiple CA Vtape subsystems on the same LPAR.

The following example assigns port 11001 for SVT1, 11002 for SVT2, and so on:

ListenOnPort = 1100&SVTS(-1:1)

Valid Values: 0 to 65535

Default: 0

Section: <PeertoPeerOptions>

Feature: PeerToPeer

MaxClients=

Defines the number of Client Drive subtasks to attach. These Client Drives act as servers to process I/O from a remote systems.

Client Drive subtasks are primarily idle until assigned. When a virtual tape drive on a remote system issues a mount directed to this system a Client Drive is dynamically assigned. When the Virtual Volume on that remote system is dismounted the Client Drive returns to an idle state waiting to be reassigned.

Valid Values: 0 to 512

Default: 0

Section: <PeertoPeerOptions>

Feature: PeerToPeer

ProtocolFamily=

Defines the internet protocol family to use when creating sockets for remote connections. The protocol format of an internet address is defined by its addressing family.

Valid Values:

• IPV4

  Indicates to use the IPv4 protocol.

• IPV6

  Indicates to use the IPv6 protocol.

Default: IPV4

Section: <PeertoPeerOptions>

Feature: PeerToPeer

TCPName=

Defines the 1 to 8 character name of the TCP/IP address space that the CA Vtape P2P Listener program will connect to. If not specified the system derives the value from the TCP/IP configuration file as described in IBM's z/OS Communications Server: IP Configuration Guide.

Valid Value: A valid TCP/IP address space name

Default: $NULL

Section: <PeertoPeerOptions>

Feature: PeerToPeer