MVS Send Functions Menu

MVS Send Functions screen example.
xdtz12
The MVS Send Functions screen is used to select one of the three types of outbound transmissions that are made with
XCOM Data Transport
. Data is transmitted to a remote system in the form of a file, report, or job. The other fields that are displayed on the screen reflect the entries that are made on the previous Primary Option Menu and can be overridden on this screen.
------------------------------------------------------------------------------- mm/dd/yy CA XCOM Release v12 USER01 MVS Send Functions 11:18 ------------------------------------------------------------------------------- OPTION ===> 1 - Send Files to Another System 2 - Send Reports to Another System 3 - Submit Jobs to Another System Remote System Identification IP Name or Address: Port: or SNA LU Name: or XCOM Group Name: or XCOM List Name: Queue for Execution (Y/N): Y (N = Execute immediately) Local System Identification Server: 321.321.321.321 Port: 5678 Protocol: TCP -------------------------------------------------------------------------------- PFK 1/Help 3/End COPYRIGHT (C) 2013 CA, 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
Send Functions Menu Options
The options for the MVS Send Functions screen are as follows:
1 - Send Files to Another System
This field is used to send data and store it as a file on a remote system.
2 - Send Reports to Another System
This field is used to send data to a remote system and have it printed as a report.
3 - Submit Jobs to Another System
This field is used to send data to a remote system and have it run as a job.
Send Functions Menu Parameters
The processing parameters for the Send Functions Menu are described in the following topics.
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.
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 specified in the
XCOM Data Transport
Default Options Table is used.
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.
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
Local System Identification
Identifies the local system 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 APPLID or 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.
  • xxxxxxxx
    Specifies the APPLID of the
    XCOM Data Transport
    server or XCOMPLEX Admin Server. The APPLID can contain up to eight alphanumeric characters.
  • x
    1 . . .
    x
    63
    Specifies the STCIP name or address of the
    XCOM Data Transport
    server or XCOMPLEX Admin Server. The STCIP name can contain 1 through 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 address is the same STCIP that you can specify in your XCOMJOB PARM.
  • Distributed processing provides the capability of displaying and controlling the queues and the history log of a different
    XCOM Data Transport
    mainframe system.
    To display a list of queues:
    1. Do
      one
      of the following items:
      • Enter the APPLID or STCIP of the
        XCOM Data Transport
        server whose queue you want to display or modify.
      • Enter the APPLID or STCIP of the XCOMPLEX Admin Server to display the queues for all the XCOMPLEX Worker Servers that are connected to the same XCOMPLEX Admin Server.
        You cannot modify queue information in this display.
    2. Select Option 3, XCOM Operator Control.
  • By specifying the remote systems
    XCOM Data Transport
    APPLID or STCIP, you can carry out third-party processing, which allows you, on the local system, to initiate
    XCOM Data Transport
    requests between two remote systems.
  • For more information about using this field for third-party-initiated file transfers, see the LUSER parameter.
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, 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, 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.