The Primary Option Menu

This article describes the Primary Option Menu.
xdtz12
The XCOM Selection Menu is the entry point for the
XCOM Data Transport
Menu Interface screens. Four options are provided. In addition to selecting a menu option, certain primary processing parameters can be specified on this screen. The values that are entered are retained on all subsequent screens for this transfer, but can be overridden by typing in new values.
-------------------------------------------------------------------------------- mm/dd/yy CA XCOM Release v12 USER01 08.099 Primary Option Menu 11:00 -------------------------------------------------------------------------------- OPTION ===> 1 - 1.1 - Send Files 1.2 - Send Reports 1.3 - Send Jobs 2 - Receive Files 3 - XCOM Operator Control Remote System Identification IP Dest: 123.123.123.123 Port: 4567 SSL: YES CONFIG SSL: or SNA LU Name: or XCOM Group Name: or XCOM List Name: Local System Identification Server: 321.321.321.321 Port: 5678 Protocol: TCP Queue for Execution (Y/N): Y (N = Execute immediately) CA XCOM Configuration Member: (or Default Table member) XCOMCNTL Data Set Name: Save SYSIN01 in DS Name: Only Save SYSIN01 (Y/N): N -------------------------------------------------------------------------------- PFK 1/Help 3/End COPYRIGHT (C) yyyy CA TECHNOLOGIES, INC. F1=Help F2=SPLIT F3=End F4=RETURN F5=RFIND F6=RCHANGE F7=UP F8=DOWN F9=SWAP F10=Fileinfo F11=Hold F12=Alloc
Selection Menu Options
The options for the Primary Option Menu are as follows:
  • 1 - Send Files, Reports, Jobs
    Used for sending a file, report, or job to a remote system.
  • 2 - Receive Files
    Used for receiving a file from a remote system.
  • 3 - XCOM Operator Control
    Used to display information about, or to alter certain parameters pertaining to all pending, in-progress, or completed transfers on a particular
    XCOM Data Transport
    server.
    XCOM Data Transport
    Operator Control can also be used to change a transfer's status.
In a Coupling Facility environment, this panel can be used to display information about pending, active, and completed transfers for
XCOM Data Transport
XCOMPLEX Worker Servers that are connected to an XCOMPLEX Admin Server. Changes cannot be made to this list of transfers; changes can only be made when looking at a list of transfers for an individual XCOMPLEX Worker Server. This option also applies to a Sysplex environment utilizing PLEXQ.
Primary Processing Parameters
The primary processing parameters for the Primary Option Menu are described in the following topic.
Remote System Identification
Identifies the partner system involved in a
XCOM Data Transport
transfer. The terms in which the partner system can be identified are described in the following topics.
IP Dest
Specifies the name or address of the TCP/IP system or node with which a transfer is to take place.
  • x
    1 . . .
    x
    63
    Specifies the name or address of the remote TCP/IP system that is involved in a transfer. The name can contain up to 63 alphanumeric characters and it must be one that has been defined to the domain name server. The address can be in IPv4 or IPv6 notation.
This parameter is mutually exclusive with SNA LU Name, XCOM Group Name, and XCOM List Name; one of the five is specified for each file transfer request.
Port
Specifies the number of the IP port where
XCOM Data Transport
listens at the remote system.
This field is displayed on subsequent screens only if an IP name or address is specified in the Remote System Identification field.
  • 1 to 65535
    Identifies the IP port monitored (listened to) by
    XCOM Data Transport
    at the remote system.
If this field is left blank, the port value that is specified in the
XCOM Data Transport
Default Options Table is used.
SSL
Specifies whether to use an SSL/TLS socket or non-SSL/TLS socket for transfers.
  • YES
    Performs a secure transfer. The transfer uses an SSL/TLS socket and must connect to an SSL/TLS listener on the remote partner.
  • NO
    Performs a non-secure transfer. The transfer uses a non-SSL/TLS socket.
Default:
NO
CONFIG SSL
Specifies the ZFS SSL configuration file path and file name.
  • 1 to 256 characters
    Specifies the ZFS path and file name of the SSL/TLS configuration file that
    XCOM Data Transport
    uses for secure transfers.
Sample SSL/TLS configuration files are provided with the installation. The SYSconfigSSL.cnf file is provided for SYSTEM SSL transfers.
Default:
None
SNA LU Name
Specifies the logical unit name of the remote system with which a transfer is to take place.
  • xxxxxxxx
    Specifies up to eight alphanumeric or national characters representing the logical unit name of the remote system with which a transfer is to take place. The first character cannot be numeric.
This parameter is mutually exclusive with the IP Name and XCOM Group Name.
XCOM Group Name
Sends this file transfer to the first available LU of a group of logical units that has been previously defined in the
XCOM Data Transport
Destination Table or to a single TCP/IP partner.
  • xxxxxxxx
    Specifies up to eight alphanumeric or national characters representing a group of previously defined logical units where the first available LU receives this file transfer. The initial character must be national or alphabetic.
    The XCOM group name can also be used to provide an alias for a single LU, IP name, or IP address.
This parameter is mutually exclusive with SNA LU Name, IP Name, and XCOM List Name; one of the five is specified for each file transfer request.
XCOM List Name
Used when this file transfer is broadcast to all the remote destinations designated on a predefined distribution list.
  • xxxxxxxx
    Enter up to eight alphanumeric characters representing the name of a list to which this transfer is to broadcast.
This parameter is mutually exclusive with XCOM Group Name, SNA LU Name, and IP Name; one of the five is specified for each file transfer request.
This parameter is valid only for queued transfers. As a result, some of the file transfers start at different times. The Menu Interface Transfer Request Display screen can be used to check the current completion status of the file transfers that a broadcast distribution initiates.
Local System Identification
Identifies the local system that is involved in a
XCOM Data Transport
transfer. The terms in which the local system can be identified are described in the following items.
Server
Specifies the server that starts the transfer. For a TCP, SSL/TLS, or XCOMPLEX Admin request, it is the TCP/IP name or address of the server. For an SNA request, it is the APPL name for the server. For a PLEXQ request, it is the name of the PLEXQ to submit to. This parameter is required.
If a value is not specified for this field, a value is taken from the
XCOM Data Transport
configuration member that is in effect. The configuration parameter that is used is based on the protocol that is in effect. For TCP and SSL/TLS, STCIP is selected. For SNA, STCAPPL is selected. For PLEXQ, STCPLEXQ is selected.
Port
Specifies the IP port of the STCIP of the
XCOM Data Transport
server on the mainframe that is to start the transfer. Or the XCOMPLEX Admin Server that is to schedule the transfer to an XCOMPLEX Worker Server. Required for TCP or the SSL/TLS transfers.
  • nnnnn
    Specifies the IP port of the
    XCOM Data Transport
    server or XCOMPLEX Admin Server. The IP port can contain valid numeric values 1 through 65535. This value is the same as the STCPORT that you can specify in your XCOMJOB PARM.
Default:
None
If a value is not specified for this field, a value is taken from the STCPORT parameter of the
XCOM Data Transport
configuration member that is in effect.
Protocol
Specifies whether the Server field is the STCIP, APPLID, or PLEXQ group name of the
XCOM Data Transport
server on the mainframe that is to start the transfer. Or the XCOMPLEX Admin Server that is to schedule the transfer to an XCOMPLEX Worker Server.
  • xxx
    Valid values are SNA, TCP, SSL/TLS, and PLQ.
    If you specify SNA, then the Server field must be a one- to eight-character entry conforming to the rules for VTAM APPLIDs.
    If you specify TCP or SSL/TLS, the Server field must be a 1- to 64-character entry conforming to the rules for a TCP/IP name or address. If the server listens to a port other than 8044, specify the port address.
    If you specify PLQ, then the Server field must be a 1-8 character entry specifying the name of the PLEXQ group to join for processing the request.
If a value is not specified for this field, a value is taken from the STCPROTOCOL parameter of
XCOM Data Transport
configuration member that is in effect. If a configuration member is not in effect or the STCPROTOCOL parameter is not specified in the member, the protocol defaults to SNA.
Queue for Execution
Specifies whether this transfer request is queued for execution by the
XCOM Data Transport
server or through the XCOMPLEX Admin Server, or executed immediately.
  • Y
    This request is queued for execution by the
    XCOM Data Transport
    server or the XCOMPLEX Admin Server.
    If the remote system is unavailable and the file transfer request is queued, the transfer executes. When the remote system becomes available. Queued functions permit a higher degree of processing control. For example, queued transfers can be prioritized or held from execution until they are manually released.
  • N
    This request is executed immediately.
    Non-queued transfers must execute within a specified default timeout duration (defined in the Default Options Table) or they are aborted.
Default:
Y
XCOM Data Transport
Default Member Name
Specifies the name of an alternate
XCOM Data Transport
default table or configuration member to use.
  • xxxxxxxx
    Specifies the name of an alternate
    XCOM Data Transport
    default options table or configuration member. This name can be one to eight alphanumeric characters.
Default:
XCOMDFLT
The default table from prior releases 11.5 and 11.6 can be used by copying the member to the STEPLIB dataset specified in your CLIST.
XCOMCNTL Data Set Name
Specifies an alternate
XCOM Data Transport
control library that is used for this transfer.
  • xxxx.xxx.xxxxxxxx
    Specifies the name of an alternate
    XCOM Data Transport
    control library that is used for this transfer. The control library name is a data set name. This library is where a configuration member must reside.
This parameter is only used for non-queued transfers (Queue for Execution=N).
Save SYSIN01 in DS Name
Specifies a data set name where
XCOM Data Transport
writes the SYSIN01 parameters for the file transfer in addition to performing the file transfer.
  • xxxx.xxx.xxxxxxxx
    Specifies the name of a dataset where
    XCOM Data Transport
    writes the SYSIN01 parameters that are used for a transfer.
Specifying this field allows a user to save the SYSIN01 parameters for an ISPF-initiated file transfer. You can execute a batch job to perform the same file transfer at a later date.
The PASSWORD parameter is saved as encrypted when an unencrypted SYSIN01 is saved. The
XCOM Data Transport
Batch accepts the PASSWORD in encrypted and non-encrypted format.
The data set named in this field must be an existing physical sequential file or a member of a PDS.
If this field contains a value,
XCOM Data Transport
saves the SYSIN01 parameters.
Only Save SYSIN01
Specifies whether
XCOM Data Transport
only saves the SYSIN01 parameters, or both save the parameters and initiate the transfer.
  • Y
    XCOM Data Transport
    only writes the SYSIN01 parameters to the data set specified in the Save SYSIN01 in the DS name field.
    XCOM Data Transport
    does not initiate a file transfer.
  • N
    XCOM Data Transport
    saves the SYSIN01 parameters and initiates the file transfer.
This field, which is used in conjunction with the Save SYSIN01 in the DS Name field, allows you to create a SYSIN01 file for later use with the Batch Interface.
Default:
N