The Primary Option Menu
This article describes the Primary Option Menu.
The XCOM Selection Menu is the entry point for the
XCOM Data TransportMenu 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: 184.108.40.206 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, JobsUsed for sending a file, report, or job to a remote system.
- 2 - Receive FilesUsed for receiving a file from a remote system.
- 3 - XCOM Operator ControlUsed to display information about, or to alter certain parameters pertaining to all pending, in-progress, or completed transfers on a particularXCOM Data Transportserver.XCOM Data TransportOperator 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 TransportXCOMPLEX 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 Transporttransfer. The terms in which the partner system can be identified are described in the following topics.
Specifies the name or address of the TCP/IP system or node with which a transfer is to take place.
- x1 . . .x63Specifies 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.
Specifies the number of the IP port where
XCOM Data Transportlistens 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 65535Identifies the IP port monitored (listened to) byXCOM Data Transportat the remote system.
If this field is left blank, the port value that is specified in the
XCOM Data TransportDefault Options Table is used.
Specifies whether to use an SSL/TLS socket or non-SSL/TLS socket for transfers.
- YESPerforms a secure transfer. The transfer uses an SSL/TLS socket and must connect to an SSL/TLS listener on the remote partner.
- NOPerforms a non-secure transfer. The transfer uses a non-SSL/TLS socket.
Specifies the ZFS SSL configuration file path and file name.
- 1 to 256 charactersSpecifies the ZFS path and file name of the SSL/TLS configuration file thatXCOM Data Transportuses for secure transfers.
Sample SSL/TLS configuration files are provided with the installation. The SYSconfigSSL.cnf file is provided for SYSTEM SSL transfers.
SNA LU Name
Specifies the logical unit name of the remote system with which a transfer is to take place.
- xxxxxxxxSpecifies 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 TransportDestination Table or to a single TCP/IP partner.
- xxxxxxxxSpecifies 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.
- xxxxxxxxEnter 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 Transporttransfer. The terms in which the local system can be identified are described in the following items.
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 Transportconfiguration 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.
Specifies the IP port of the STCIP of the
XCOM Data Transportserver 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.
- nnnnnSpecifies the IP port of theXCOM Data Transportserver 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.
If a value is not specified for this field, a value is taken from the STCPORT parameter of the
XCOM Data Transportconfiguration member that is in effect.
Specifies whether the Server field is the STCIP, APPLID, or PLEXQ group name of the
XCOM Data Transportserver 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.
- xxxValid 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 Transportconfiguration 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 Transportserver or through the XCOMPLEX Admin Server, or executed immediately.
- YThis request is queued for execution by theXCOM Data Transportserver 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.
- NThis 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.
XCOM Data TransportDefault Member Name
Specifies the name of an alternate
XCOM Data Transportdefault table or configuration member to use.
- xxxxxxxxSpecifies the name of an alternateXCOM Data Transportdefault options table or configuration member. This name can be one to eight alphanumeric characters.
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 Transportcontrol library that is used for this transfer.
- xxxx.xxx.xxxxxxxxSpecifies the name of an alternateXCOM Data Transportcontrol 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 Transportwrites the SYSIN01 parameters for the file transfer in addition to performing the file transfer.
- xxxx.xxx.xxxxxxxxSpecifies the name of a dataset whereXCOM Data Transportwrites 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 TransportBatch 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 Transportsaves the SYSIN01 parameters.
Only Save SYSIN01
XCOM Data Transportonly saves the SYSIN01 parameters, or both save the parameters and initiate the transfer.
- YXCOM Data Transportonly writes the SYSIN01 parameters to the data set specified in the Save SYSIN01 in the DS name field.XCOM Data Transportdoes not initiate a file transfer.
- NXCOM Data Transportsaves 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.