# z/OS Specific Transfer Parameters

You must supply z/OS specific transfer parameters when you perform transfers with a z/OS system.

Note: To use any z/OS specific transfer parameters, set the parameter zOS to Y on the command line, otherwise all z/OS specific transfer parameters are ignored.

Parameter (Alternate Specification) | Description
--- | ---
ALLOC_PRI (ap) | Defines the quantity of the remote file primary allocation. The valid values are from 0 to 32000. TIBCO MFT Platform Server supports automatic assignment for ALLOC_PRI when ALLOC_TYPE is set to M or K. If you set this value to zero, then the appropriate number of megabytes or kilobytes are assigned respectively.
ALLOC_SEC (as) | Defines the quantity of the remote file secondary allocation. The valid values are from 0 to 32000. TIBCO MFT Platform Server supports automatic assignment for ALLOC_SEC when ALLOC_TYPE is set to M or K. If you set this value to zero, then the appropriate number of megabytes or kilobytes are assigned respectively.
ALLOC_TYPE (at) | Defines the type of remote file allocation. The valid values are: T: data set size is allocated in tracks. C: data set size is allocated in cylinders. M: data set size is allocated in megabytes. K: data set size is allocated in kilobytes.
ASCII_to_EBCDIC (eb) | Defines the type of data translation that is required for the remote system. The valid values are: Binary | N | 0: the file is binary and does not require any translation. ASCII | A | 1: the file is ASCII and does not require translation, but can require CR/LF (carriage return, line feed) insertion. Text | Y | 2: the file is ASCII and the remote system requires EBCDIC, the data is translated by TIBCO MFT Platform Server for UNIX. This value is typically used for transfers to a z/OS system. Note: This parameter is used when sending files from UNIX to z/OS.
AVAIL (da) | Defines the remote file volume availability. The valid values are I | Immediate or D | Deferred.
BLKSIZE | blocksize (obs) | Defines the remote file block size. The valid values are from 0 to 32760.
CALLJCL (cj) | Defines whether to call any z/OS program with JCL linkage. The valid values are N or z/OS program.
CALLPROG (cp) | Defines whether to call any z/OS program. The valid values are N or z/OS program.
DATACLASS (dc) | Defines the z/OS data class as specified in the Data Facility/System Managed Storage. You can use the Data Facility/System Managed Storage to indicate the media type of the host file, the backup, restore, and archive policies of the installation. The maximum length of the defined value is 8 characters, it can contain numeric, alphabetic, or national characters ($, #, @). Note: The first character must be an alphabetic or national character. In addition, you can use this parameter to indirectly select file attributes such as record format and logical record length.
DELIM (cr) | Defines the file delimiter. Note: This parameter is only valid when the remote system is a z/OS system. If you perform transfers to a Windows system, use the CR_LF parameter. The valid values are: Y | CRLF: CR (carriage return) is deleted when you receive a file on UNIX. CR is added before the LF (line feed) when you send a file on UNIX. L | LF: records are delimited by LF. This is typically used when you transfer text data to z/OS. Note that the line conversion is performed on z/OS. No processing is performed by TIBCO MFT Platform Server for UNIX. CRLFY: CR is not added to LF when you send a file on UNIX. Likewise, CR is not removed when you receive a file on UNIX. This applies in rare cases when a UNIX file contains CRLF, or if the application requires CRLF instead of LF. N: no record delimiter is applied in the file. This typically applies for transfers of binary files.
EXEC | REXXEXEC (re) | Defines the z/OS command that you want to use.
LENGTH (orl | lrecl) | Defines the remote file record length. The valid values are from 1 to 32760.
MaintainBDW (mbdw) | Defines whether to maintain the Block Descriptor Word (BDW) when sending or receiving variable block binary files to z/OS. If the data being sent or received is not in the proper BDW format, the transfer will fail.
MaintainRDW (mrdw) | Defines whether to maintain the Record Descriptor Word (RDW) when sending or receiving variable block binary files to z/OS. If the data being sent or received is not in the proper RDW format, the transfer will fail.
MGMTCLASS (mc) | Defines the z/OS management class as specified in the Data Facility/System Managed Storage. You can use the Data Facility/System Managed Storage to indicate the media type of the host file, the backup, restore, and archive policies of the installation. The maximum length of the defined value is 8 characters, it can contain numeric, alphabetic, or national characters ($, #, @). The first character must be an alphabetic or national character.
RECFM (orf) | Defines the remote file record format. The valid values are: F: Fixed FA: Fixed ASA FB: Fixed Blocked FBA: Fixed Blocked ASA FBM: Fixed Blocked Machine FM: Fixed Machine V: Variable VA: Variable ASA VB: Variable Blocked VBA: Variable Blocked ASA VBM: Variable Blocked Machine VM: Variable Machine U: Undefined The A extension indicates the use of ASA control characters on z/OS, and the M extension indicates the use of machine control characters on z/OS.
RetenPeriod_ExpDate (rp_ed) | Defines the retention period or expiration date of the file in the remote system. The format of the entered value determines whether the parameter is used as a retention period or as an expiration date. The retention period is the number of days, after which the file expires. Expiration date is the date, in Julian format, when the file expires. This parameter is typically used on the z/OS platforms for tape processing to prevent a tape from being overwritten. This parameter must be carefully defined with a disk file. The default is no expiration date on the file. The valid values are: N, a number of days up to 9999, or yyyy/ddd. Note: This parameter is only supported for send transfers to a z/OS system.
REMOVETRAIL (rmtrail) | Defines whether to remove all trailing spaces and nulls before you transfer the file. The valid values are Y or N. Note: This parameter is only valid when you receive a file using the cfrecv command.
STORCLASS (sc) | Defines the z/OS storage class as specified in the Data Facility/System Managed Storage. You can use the Data Facility/System Managed Storage to indicate the media type of the host file, the backup, restore, and archive policies of the installation. The maximum length of the defined value is 8 characters, it can contain numeric, alphabetic, or national characters ($, #, @). Note: The first character must be an alphabetic or national character.
SUBMIT (sj) | Defines the z/OS JCL you want to submit. The valid values are N or a file that contains the z/OS JCL.
SysOutClass (sl) | Defines the class to which the JES output is routed. On z/OS systems, the printer queues are organized around a printer class instead of a specific printer. This class has a one-character name that is either alphabetic or numeric.
SysOutCopies (sp) | Defines the number of copies to print of a particular report on a remote computer. Note: This parameter is only valid when the remote platform is z/OS.
SysOutDestination (sd) | Defines the destination for the job that you submit to the z/OS internal reader. Note: This parameter is only valid when the remote platform is z/OS.
SysOutFcb (sb) | Defines the name of the form control buffer as specified in JES. Note: This parameter is only valid when the remote platform is z/OS.
SysOutUserName (si) | Defines the user name assigned to a job that you submit to the z/OS internal reader. Note: This parameter is only valid when the remote platform is z/OS.
SysOutWriter (sw) | Defines the external writer name that you use to process this printer file on z/OS. This is the name of a service program on z/OS, which controls the time to process this file from the printer queue. You can write the service program to decide how to process the print file. Note: Do not specify a value for this parameter unless you are instructed by the system analyst of the z/OS system.
UNIT (du) | Defines the remote file z/OS unit name. The maximum length of the defined value is 8 characters.
VOLUME (dv | vol | volser) | Defines the remote file z/OS volume name. The maximum length of the defined value is 6 characters, and it must be alpha-numeric.
zOS | Defines whether you can perform transfers to or from z/OS. The valid values are: Y: you can perform transfers to or from z/OS. N: you cannot perform transfers to or from z/OS, and all z/OS specific transfer parameters are ignored.

Copyright © 2022. TIBCO Software Inc. All Rights Reserved.