Contents

What's New
TIBCO Managed File Transfer Components
Sample MFT Deployment
Detailed Explanation of TIBCO MFT Components
MFT Command Center
Supported Functionality in MFT Command Center
MFT Command Center Extends Capabilities of MFT Internet Server
MFT Command Center Extends the Capabilities of MFT Platform Servers
Other MFT Command Center Capabilities
MFT Internet Server
Supported Functionality in MFT Internet Server
Supported Protocols in MFT Internet Server
MFT Internet Server Security Capabilities
MFT Internet Server Post Processing Actions
Connection Manager
Components of Connection Manager
Connection Manager Installation
Installation - Simple Architecture
Installation - Complex Architecture
Installation - Two Tier DMZ Architecture
MFT Platform Server
MFT Platform Server Features
MFT Platform Server High Availability
MFT Platform Server Preprocessing and Postprocessing Actions
Event Driven Processing in MFT Platform Servers
pDNI
pDNI Features
Interface to Other TIBCO Products
Sample Transfer Flows
Installing TIBCO® Managed File Transfer Platform Server for z/OS
Copying Platform Server REXX Execs to an HFS Directory
Postinstallation Tasks
APF Authorizing the Load Library
Defining Platform Server to the z/OS Security System
The RACF Security Interface
Defining TIBCO MFT Platform Server for z/OS as a Multiple-User Address Space
Creating RACF Facility Classes
OMVS Definitions for Access to UNIX System Services (USS) Files under RACF
RACF Surrogate Checking
Extended Security Checking
The Top Secret Security Interface
Defining TIBCO MFT Platform Server for z/OS as a Multi-User Facility
Defining ACID for TIBCO MFT Platform Server for z/OS Started Task
Defining TIBCO MFT Platform Server for z/OS to STC Table
Giving Users Access to TIBCO MFT Platform Server for z/OS
Creating Top Secret Facility Classes
OMVS Definitions for Access to HFS Files under Top Secret
The CA-ACF2 Security Interface
Creating CA-ACF2 Facility Classes
LOGONID Definition
OMVS Definitions for Access to HFS Files under ACF2
Defining the VSAM Files
Defining the Audit VSAM Dataset
Defining the Work Queue VSAM dataset
Defining the User Profile Dataspace
Defining the DNI Active Queue Dataspace
Defining the MSGTEXT Cluster
Defining the Sequential Files
Creating a TSO Logon Procedure
Adding Platform Server ISPF Interface to TSO Logon Procedure
(Optional) Dynamically Adding Platform Server Libraries to ISPF
(Optional) Adding Configuration Parameters to OMVS User Profile
(Optional) Adding Platform Server to an ISPF Selection Panel
Defining VTAM Resources for Systems Using SNA
Defining an APPLID for the Platform Server
Defining APPLIDs for Platform Server Batch Interface and ISPF Panels
The Startup JCL
EXEC PARM Fields Used by Platform Server
STEPLIB
Performing an Upgrade
Updating the VSAM Datasets
The AUDIT Dataset
Running the CPYAUDIT Job
Updating the Audit VSAM Dataset
The WORKQ Dataset
The MSGTEXT Cluster
Platform Server Configuration
Defining Local Resources and Initialization Defaults
GLOBAL Startup Parameters
Defining and Configuring the FUSCFG File
FUSCFG Configuration File
Methods of Communicating
Parameter Syntax Rules
FUSCFG Configuration Parameters
Sample FUSCFG Configuration
Defining Remote Systems in Configuration Library
Configuration Member List - Member Name CONFIG
Enabling Members When GLOBAL AUTOENABLE=NO
Enabling Members When GLOBAL AUTOENABLE=YES
Node Definition Parameters
Sample Node Definitions
Distribution Lists
Class of Service (COS) Definitions
Data Throttling
Translation Table (XLATE) Definitions
Using the SEND Table for EBCDIC to ASCII Translation
Using the RECEIVE Table for ASCII to EBCDIC Translation
TCP Translation Table (TCPXLATE) Definitions
SSL Authorization File
SSL Authorization Parameters
Setting Up SSL Authorization File on z/OS
User Profiles
Using Initiator User Profile Facility
Using Responder User Profile Facility
User Profile Facility Security
Managing User Profiles
User Profile Sample JCL
User Profile Statement Parameters
Required and Optional User Profile Parameters
User Profile JCL Examples
SUBJCL (Submit JCL) Interface
SUBJCL Security
SUBJCL Configuration Parameters
SUBJCL Parameter Substitution
CFACCESS
CFACCESS Parameter Configuration
CFACCESS Parameters
CFACCESS Example
CFALIAS
CFALIAS Parameter Configuration
CFALIAS Parameters
CFALIAS Example
TRCLASS (Transfer Class)
TRCLASS Parameter Configuration
Transfer Class Parameters
TRCLASS Example
SSL Configuration
GLOBAL SSL Parameter Definitions
NODE SSL Parameter Definitions
User Interface TLS Parameter Definitions (Batch/REXX)
Defining the Password Associated with the SSL Key Database File
Key Database
Creating the Key Database
Using the Key Database
Storing a CA Certificate
Creating New Key Pair and Certificate Request
Receiving a Requested Certificate
Creating a Key Ring
Creating SSL Certificates Using a Certificate Authority
Creating SSL Certificates Using RACF as a Certificate Authority
Other Useful RACDCERT Commands
Checking Validity of Certificate
Listing Contents of Key Ring
Listing Contents of Certificate
Authorizing User to Key Ring
Operator Commands
Command Basics
System Operations
Node Operations
Activities
z/OS Console Display Commands
File Transfer Activities
Platform Server Console Operator Commands
Troubleshooting
Appendix A. Sample SNA Mode Definition
Appendix B. Running Traces
Appendix C. Automated Operations
Appendix D. File Name Tokens
File Name Tokens List
Examples of Using the File Name Tokens
Rules for Using the File Name Tokens
Appendix E. CA-7 Job Scheduler Interface
Appendix F. User Exits
Invoking Platform Server User Exits
Appendix G. WAIT Parameter for IF/THEN/ELSE/ENDIF
Appendix H. Overriding JCL SYSIN Parameters
Appendix I. XCOM Interface
Installing and Configuring Platform Server XCOM Interface
Appendix J. PDS and HFS File
PDS Support
HFS File Support
Introduction
Security Features
Authentication and Authorization
Password Management
File Transfer Modes
Hardware Compression and Encryption
Miscellaneous Security Features
Security Tasks
Preinstallation
Installation and Configuration
Execution of File Transfers
Data Encryption and Compression
Data Encryption
Data Encryption Algorithms
Defining Data Encryption
GLOBAL Definition
NODE Definition
Transfer Interface Definition
Data Compression
Rules of Using Data Compression
Data Compression Algorithms
Defining Data Compression
Email Notification
Email Notification Parameters
Data Transfer with SSL
SSL Authentication
Digital Certificates
Certificate Authority
Creating Key Ring Files
Data Encryption with SSL
Asymmetrical Encryption
Symmetrical Encryption
Compliance with HIPAA or FIPS Regulation
Batch Interface
JCL Statements
Defining the PARM Field of the EXEC PGM=JCL Card
Defining the Communication Method
Supported Communication Methods
Defining Process Parameters and Additional Parameters
Examples of Overriding SYSIN Parameters
Defining the CONFIG Parameter
Defining the Batch Interface Parameters
PROCESS Statement
SYSIN DD Statement
SYSIN DD Statement Syntax Rules
SYSIN Coding Parameters
ALLOC_DIR
ALLOC_PRI={primary_space}
ALLOC_SEC
ALLOC_TYPE={T | C | M | K | B}
AVAIL={IMMED | DEFER}
BLOCKSIZE={nnnnn | 0}
CALLJCL
CALLPROG={"program_parameters"}
CHKPT={Y | N | nnn}
COMPRESS={YES | NO | RLE | LZ | ZLIB1 - ZLIB9}
CONTINUE={YES | NO}
COSNAME={class_of_service_name}
CRCCHECK or CRC
CRLF={YES | NO | CRLF | LF | USSLF| KEEPCRLF}
DATACLASS={SMS_data_class}
DATASET_TYPE={LIBRARY | PDS | DSN | VSAM | LARGE}
DATE={yyyyddd | yyddd}
DCB=({RECFM=xx,LRECL=nnn,BLKSIZE=nnn,DSORG=zz | Model DCB DSN})
DCB_LIKE={Model_DCB_DSN}
DESCRIPTION={description}
DIRTEST={YES | NO}
DSN={data_set_name}
DSORG={PS | DA | PO | PDSE | PE | VS | USS}
EFFECT={C | R | A | CR | CA | CN}
EMAIL_FAIL={email_addresses}
EMAIL_GOOD={email_addresses}
ENCRYPT={NONE | DES | 3DES | BLOWFISH | BF | BLOWFISH_LONG | BFL | AES}
EVERY
EVERY_COUNT={every_execution_count}
EVERY_EXDAYS={number_of_expiration_days}
EVERY_EXTIME={hhmm}
EVERY_MISSED={SCHEDULE | BYPASS}
EXEC={remote_command_to_execute}
EXECPREPROC={PARENT | CHILD}
EXECPOSTPROC={PARENT | CHILD}
EXPDT={yyddd | yyyyddd}
EXPTM={HHMM | +HHMM}
FILEERRORINT={10 - 9999}
FILEERRORMAX={1 - 9999}
FILE_EXPDT={YYDDD | YYYYDDD}
FILE_RETPD={DDDD}
HOLD={YES | NO}
IPADDR={xxx.xxx.xxx.xxx}
IPNAME={domain_name}
IPORT={nnnnn | 0}
IUNIT={8_character_unit_name}
IVOLUME={volume_name}
LDISP={SHR | OLD | DNEW | MOD | NEW | NEWR | NEWA},{KEEP | CATLG | DELETE},{KEEP |CATLG | DELETE}
LENGTH={nnnnn | 0}
LIST={node_name}
LOCALLABEL=(nn,SL)
LOCALCTFILE={Translation_table_used_locally}
LOGON_DOMAIN={domain}
LPASS={local_password}
LRECL={nnnnn | 0}
LUSER={local_user_ID}
MAINTAINBDW={YES | NO | BLOCKVS}
MAINTAINRDW={YES | NO}
MEMBER={member_name_to_include}
MGTCLASS={SMS_Management_Class}
MQ_FAIL={$MQ:XXXX:mmmmmmmmmm}
MQ_GOOD={$MQ:XXXX:mmmmmmmmmm}
MQ_NOTIFY={INITIATOR | RESPONDER | BOTH | NONE}
MQ_WAIT_MSEC
NODE={node_name}
NODECLASS
NOTIFY={user_ID}
NOTIFY_TYPE={TSO}
OVOLUME={output_volume}
PERMIT_ACTNS={S | H | A | R | C | Z | E}
POST_ACTION={S | F | P},{L | R},{CALLJCL | CALLPGM | SUBMIT | COMMAND},{data_to_be_processed}
PRIORITY={3 | n}
PROCNAME={process_name}
PURGE={YES | NO}
RDISP={SHR | OLD | DNEW | MOD | NEW | NEWR | NEWA},{KEEP | CATL | DELETE},{KEEP | CATL | DELETE}
RECFM={F | FB | V | VB | U | VS | VBS}
REMOTECTFILE={remote_file_name}
REMOTELABEL=(nn,SL)
REMOTE_FILE={remote_file_name}
REMOTE_PASS
REMOTE_UNIT={unit_name}
REMOTE_USER={remote_user_ID}
REMOVETRAIL={YES | NO}
RESOLVE_GDG={IMMEDIATE | DEFERRED}
RETENTIONPRD={nnn}
RETRY={nn | 0}
RETRYINT={nnM | nnH | 0}
RSACCELERATE={YES | NO}
RSCOMPRESS={YES | NO | BEST | DEFAULT | FAST}
RSENCRYPT={YES | NO}
RSHOST={NO | host}
RSMAXSPEED
RSPORT={NO | port}
RSPROTOCOL={UDP | PDP | TCP}
SCRIPT={script_file_name}
SENDERCFMU={YES | NO | NOBDW}
SPACE=({CYL | TRK | KIL | MEG},({primary},{secondary},{directory}),{RLSE})
SPACERELEASE={YES | NO}
STORCLASS={SMS_storage_class}
SUBDIR={YES | NO | ALL | SEQAVSAM}
SUBMIT= {"jcl.ibrary(member),symbolic parameters" | "member,symbolic parameters"}
TAPE={YES | NO}
TCP_TIMEOUT, TCPTIMEOUT
TEMPLATE
TEXTEOFTERM={YES | NO}
TLS={YES | NO | TUNNEL}
TIME={hhmmss}
TIMEOUT={number_of_seconds}
TRANS_TYPE={FILE | JOB | PRINT | COMMAND}
TRANSFER={SEND | RECEIVE | SUBMIT | SCRIPT}
TRCLASSNAME={transfer_class_name}
TRUNCATE ={YES | NO | WRAP}
TYPE={TEXT | BINARY | DATA|ASCII}
UNIXPERM
UTF8BOM={ADD | REMOVE | BOTH |NONE}
VOLUME={volume1_name,volume2_name,….,volume5_name}
VSAM_KEYPOS={VSAM_relative_key_position}
VSAM_KEYLEN={VSAM_key_length}
VSAM_LIKE={VSAM_model_cluster_data_set_name}
VSAM_LRECL={VSAM_record_length}
VSAM_TYPE={VSAM_file_type}
VSAM_REUSE={YES | NO}
VSAM_RRSLOT={YES | NO}
WAIT={YES | NO | ASYNC | ASYNCWAIT}
XMEMBER={members_to_exclude}
Print Support/Remote Job Submission Parameters
Sample JCL Statements
Return Codes
REXX Interface
Executing REXX Requests
Using the ISPF Command Shell
Using the Batch TMP (IKJEFT01)
Using the REXX Batch Processor (IRXJCL)
Using Platform Server Address Space
Using the FUSQREXX Exec to Queue a REXX Exec
Using the Batch Interface to Queue a REXX Exec
Return Code Processing When REXX Execs Are Queued
Using the REXX_EXEC Parameter
REXX Execs
REXX Parameter Syntax Rules
Queuing Requests to Platform Server Started Task
FUSNODE
FUSQREXX
FUSQSUB
FUSRECV
FUSRECVT
FUSSCMD
FUSSCRPT
FUSSEND
FUSSENDT
FUSSMEM
FUSSMFIL
FUSFTP
Waiting for Transfer Requests to Complete
Waiting for a Single Transfer Request to Complete
Waiting for Multiple Requests to Complete
FUSWAIT
FUSWCLR
Inquiring on Transfer Requests
FUSINQ
Request Inquiry Security
Generic Filtering of Data
Inquiry Date Processing Rules
Examples of the FUSINQ Exec
Performing Operator Control or Detailed Inquiry
Operator Control Security
FUSDEL
FUSHOLD
FUSREL
FUSSUSP
FUSSEL
Inquiring on Platform Server Messages
FUSMSG
Dataset Name Initiation (DNI)
DNI Security
Preparing for Using DNI
Configuring DNI
Creating DNI Configuration Members
Rules for Creating DNI Configuration Members
Defining DNI Parameters
Supported Batch Interface Parameters
DNI Parameter Extensions to the Batch Interface
DNI Postprocessing Configuration Parameters
Defining Local File Wildcard Parameters
Local File Wildcard Parameters
Additional Parameters
Defining MQ Support
Defining Substitutable Parameters
Substitutable Parameters
Activating DNI Members Automatically
Defining DNI Operator Commands
Enabling a DNI Configuration Member
Disabling a DNI Configuration Member
Displaying DNI Requests
Purging a Request
Suggestions for DNI Dataset Names
Examples of Using DNI
ISPF Interface
Communication Methods
Initiating the ISPF Interface
Managing File Transfers
Defining Transaction Selection Criteria
Transaction Selection Criteria Parameters
Manipulating Transaction Selection Results
Viewing Transaction Details
Viewing a Summary of Transaction Attempts
Managing Remote Nodes
Defining Send Requests
Sending a File to a File
Sending a File to a Job
Sending a File to a Printer
Sending a Command
Send Request Parameters
Defining Receive Requests
Receiving a File to a File
Receiving a File to a Job
Receiving a File to a Printer
Additional Parameters for Receiving to Printer
Viewing Platform Server Messages
Scheduling Platform Server Scripts
Viewing Transaction History
Action Bar
Transfer
Utilities
Editing a Local Dataset File
Browsing a Local File
Manage
Node
Options
Changing the Date and Time Formats
Help
Script Interface
JCL Statements
The PARM Field of the EXEC PGM=JCL Card
Defining the Communication Method
Communication Methods
Defining the CONFIG Parameter
Defining Script Interface Parameters
Symbolic Parameters
Script Syntax Rules
COMMENT
:ROUTINE
CALL
CALLIDCAMS
CALLJCL
CALLPGM
CLEARIDCAMS
DEBUGOFF
DEBUGON
EXIT
GOTO
IF/THEN/ELSE/ENDIF
INCLUDE
NOOP
PROCESS
QUOTE
RETURN
SAY
SET
SETC
TRACEOFF
TRACEON
TRNWAIT
UNDEF
WAITSECS
WTO
WTOR
Examples of Holding Long File Names
Sample Script
Running Scripts within Platform Server Started Task
Script Execution in Platform Server Started Task
INDIRECT EXEC Statement
PPA Program: PPASCRPT
SAPI (SYSOUT API)
SAPI Security
Starting SAPI Interface
Defining SAPI Selection Criteria
SAPI Interval
Defining SAPI Remote File
SAPI File Transfer Parameters
Defining SAPI File Disposition
Example
FUSUTIL
FUSUTIL Security
FUSUTIL Programs
FUSUTIL DELETE
FUSUTIL EXIST
FUSUTIL RENAME
Using FUSUTIL in SEND Command
Using FUSUTIL in Post Processing Actions (PPA)
Troubleshooting
Appendix A. Sample SNA Mode Definition
Appendix B. Running Traces
Running Platform Server Internal Traces
Running VTAM Buffer Traces
Appendix C. Automated Operations
Start of Transfer
Completion of Transfer
Appendix D. File Name Tokens
File Name Tokens List
Examples of Using File Name Tokens
Rules for Using File Name Tokens
Appendix E. CA-7 Job Scheduler Interface
Appendix F. Using the Process WAIT Parameter with MVS JCL IF/THEN/ELSE/ENDIF Parameters
Appendix G. Overriding JCL SYSIN Parameters
Appendix H. PDS, HFS, VSAM, and MQ Support
PDS Support
Additional Batch Parameters for Library Support
Generic and Wildcard Characters for Members
Alias Support
Examples of Sending PDS Files
HFS File Support
MQ Support
MQ File Name Requirements
MQ Send and Receive Processing
VSAM File Support
Appendix I. Extended Attribute Support
Appendix J. Netview Support
Activating Platform Server REXX Execs under Netview
Appendix K. XCOM Interface
Installing and Configuring the XCOM Interface
Fields Ignored by the XCOM Interface
Example
Appendix L. Preprocessing Actions
Transfer Retry Considerations for Preprocessing
Preprocessing Return Codes
Overriding of Transfer Parameters Using Preprocessing
Appendix M. Post Processing Action (PPA) Substitutable Parameters
Appendix N. Directory Transfers
Directory Transfer Parameters
Supported Wildcard Characters
Sample Node Substitution
Appendix O. Assembler API
JCL Requirements
Register Settings
APIDSECT Fields
Sample Program
Appendix P. TIBCO Accelerator
Using TIBCO Accelerator within Platform Server for z/OS
Appendix Q. SMF Data Format
Message Overview
Error Messages
Warning Messages
Information Messages
TIBCO Documentation and Support Services
Legal and Third-Party Notices