SendCommand

The SendCommand command action will send a command from one TIBCO MFT Platform Server to another TIBCO MFT Platform Server.

Parameter Description Default Required
CkPtInterval Specifies the checkpoint interval.

The Platform Server checkpoint uses a time interval to determine when to send a checkpoint.

Because checkpoint is time-based, checkpoint always occurs at a regular interval. The checkpoint interval is specified in minutes, and the valid range is 1 to 90 minutes.

None No
CompressionFlag Specifies the compression algorithm.
TIBCO MFT Platform Server provides two different compression algorithms:
  • Limpel-Zev (LZ)
  • Run Length Encoding (RLE)

The users can select the algorithm which best suits their network.

The valid values are as follows:
  • L: LZ
  • N: none
  • R: RLE
  • U: undefined
None No
DataConversionType Specifies the type of data conversion used to convert data between ASCII and EBCDIC.

This parameter is used when the communicating with systems has defined data structures. This parameter is not necessary if you are communicating from PC to z/OS.

If you are using TIBCO MFT Platform Server, when you change the combtlg.dat file, you have to stop and start the Platform Server service for the new conversion table to take effect.

The valid values are as follows:
  • B: binary
  • E: EBCDIC
  • A: ASCII
None No
Delimiter Specifies the carriage return line feed control for transferring files.
The valid values are as follows:
  • C or CRLF: records are delimited by carriage return line feed.
  • L or LF: records are delimited by line feed.

    This is typically used when transmitting text data to z/OS.

    Note: The line conversion is done on the z/OS platform.
  • N: no record delimiters exist in the file.

    This is typically done for a binary transfer.

None No
Department (dpt) Specifies the department associated with the Platform transfer. None No
Description (d) Specifies the 1 to 256 character description of this Platform transfer bank file definition.

The entire description must be enclosed in double quotation marks (“).

None No
EncryptionFlag Specifies the type of encryption to be used with this transfer.
The valid values are as follows:
  • 3D|3DES: 3DES encryption
  • BF: blowfish
  • BFL: blowfish long
  • D|DES: DES encryption
  • N: no encryption
  • R|RJ|AES: Rijndael
  • U: undefined
U No
ExpirationDays Specifies the number of days after which the transfer should no longer be attempted.

If this transfer is scheduled, that takes precedence over expiration.

If expiration and retention are used, whichever value occurs first will take precedence.

The valid value range is 0 to 999999.

0 No
FileWriteMode Specifies the create option for the side writing the file.
The valid values are as follows:
  • A: append
  • C: create
  • CA: create or append
  • CR: create or replace
  • CRN: create, replace, or new
  • R: replace
C No
InitiatorFileName Specifies the name of the file on the platform that is initiating the transfer.

On a send request, it is the file to be sent. On a receive request, it is where the file will be placed.

None Yes
LocalTransTable Specifies the location of the local translation table used with this transfer.

If the path contains embedded spaces, the entire path must be enclosed in double quotation marks (").

None No
LoginPWD Specifies the initiating user password.

The password can be up to 64 characters in length and is case sensitive.

None No
LoginUID Specifies the Initiator user ID used to login to TIBCO MFT Platform Server defined by the Platform Server pull-down box.

If this parameter is defined, TIBCO MFT Command Center will use the user ID and password when connecting to TIBCO MFT Platform Server. If this parameter is not defined, TIBCO MFT Command Center will search for a server credential that matches the user ID and server definition.

None No
PermittedActions Specifies the Windows-specific file attributes.

These attributes are only valid when sending files to a Windows machine.

The valid values are as follows:
  • A: archive
  • C: NTFS compress
  • E: EOF
  • H: hidden file
  • R: read-only
  • S: system file
  • Z: control Z EOF
None No
PortNum Specifies the IP port on which the remote Platform Server system listens on.

The valid value range is 1025 to 65535.

None No
PPA1 - PPA4 Specifies the post processing action.

The post processing action allows you to perform up to four actions to be completed by the server when a file transfer request is completed.

The format of the command indicates whether a post processing action should be performed upon success or failure.

The valid values are as follows:
  • S|F: success or failure.
  • L|R: local or remote.
  • CALLPGM: calls a z/OS program with program to program parameter linkage.

    This parameter allows the user to call a user program defined on the remote z/OS system.

  • CALLJCL: calls a z/OS program with JCL to program parameter linkage.

    This parameter allows the user to call a user program defined on the remote z/OS system.

  • COMMAND: issues a command at the node specified in the NodeName parameter.

    This is the command that you want to execute on the remote system.

  • SUBMIT: submits a job at the node specified in the NodeName parameter.

    This parameter allows the user to submit a job on the remote system. This differs from file to job transfer requests because the JCL to run actually sits on the remote system.

  • ActionData: specifies the data passed to the post action type when the conditions specified are met.
None No
ProcessName Specifies the 8 character field to describe the application which is initiating the transfer. None No
PServerName Specifies the server name that identifies the initiating TIBCO MFT Platform Server. None Yes
RemoteTransTable Specifies the location of the remote translation table used with this transfer.

If the path contains embedded spaces, the entire path must be enclosed in double quotation marks (").

None No
RemoveTrail (rmtrail) Specifies whether to remove trailing spaces from the file.
The valid values are as follows:
  • Y
  • N
N No
ResponderFileName Specifies the name of the file on the platform that is responding to the transfer.

On a send request, it is where the file is placed. On a receive request, it is the file that to be transferred.

None Yes
ResponderPWD Specifies the remote password.

The password might be up to 64 characters in length and is case sensitive.

None No
ResponderUID Specifies the user ID that the initiator sends to the responder to gain access to the system.

If this parameter is defined, the Platform Server initiator uses the user ID and password when connecting to the Platform Server responder. If this parameter is not defined, the Platform Server initiator searches for a user profile that matches the user ID and responder node definition. If no user profile is found, the Platform Server initiator sends a trusted user that the Platform Server responder can be configured to accept or reject.

None No
RIPName Specifies the responder IP or host name. Mutually exclusive with RListName. None Yes
RListName Specifies the responder list name. Mutually exclusive with RIPName. None Yes
RNodeName Specifies the remote node name.

You can define this parameter in place of defining the RIPName parameter if the remote server is defined in TIBCO MFT Command Center and you know the server name being used for it.

None Yes

Or the RIPName parameter can be used.

SecurityAttribute Specifies the file name that the receiving partner uses as a template for its access control list (ACL).

The ACL is a list that specifies users and groups, and their access permissions on a file.

The ACL of this file is copied to the ACL of the destination file. For this feature to function properly on Windows, the file specified must be readable by the partner which is receiving the file to file transfer and the file being created must reside on an NTFS drive.

None No
SSLFlag Specifies whether to use secure sockets layer (SSL).
The valid values are as follows:
  • Y
  • N
None No
ToEmailAddrF Specifies the email address for failed transactions. None No
ToEmailAddrS Specifies the email address for successful transactions. None No
TransferDirection Specifies the transfer direction.

The valid values are as follows:

  • S: sends a file.
  • R: receives a file.
  • C: sends a command.
None Yes
TrScheduleDate Specifies the transfer schedule date.

The valid values are as follows:

  • YYYY-MM-DD
  • YYYY-MM-DD HH:MM
  • YYYY/MM/DD HH:MM
None No
TryMaxCount Specifies the maximum number of transfer retries allowed. None No
UnixPermissions Specifies the UNIX permissions.

When a file is created on a UNIX system, TIBCO MFT Platform Server has the ability to set the UNIX permissions on the file.

The UNIX permissions are defined by a three digit number, such as 777, which is the same as for the chmod command.

None No

Sample SendCommand Command

This command sends a command from one Platform Server remote platform to be executed on another.

java cfcc.CFPlatform a:SendCommand PServerName:Win17 LoginUID:user2 RNodeName:unix201 PortNum:46464 Command:RCMD=ls