faction

CFTSEND, SEND

[FACTION = { NONE | DELETE | ERASE }]

Action on the file after a send transfer:

  • NONE: no action on this file on completion of the transfer
  • DELETE: delete the file after transfer
  • ERASE: erase the contents of the file after the transfer ("End Of File" mark at the beginning of the file)
Note For a directory or file group send, this parameter is ignored if set to DELETE. No directories or files are deleted after a generic transfer.

CFTRECV, RECV

[FACTION = { VERIFY | DELETE | ERASE | RENAME | RETRYRENAME }]

Note The RENAME option is only available on Unix platforms.

Action on a file before a receive transfer except when using RENAME, which is a post transfer action.

If a receiver file with the same name already exists, Transfer CFT performs one of the following actions:

  • VERIFY: checks that the file is empty before the transfer occurs
  • DELETE: deletes the file before the transfer occurs
  • ERASE: erases the contents of the file before the transfer occurs
  • RENAME: replaces the FNAME file after the transfer completes by renaming the WFNAME file ( Unix only)
  • RETRYRENAME: a replaces the FNAME file after the transfer completes (using a retry mechanism) by renaming the WFNAME file only if the FNAME does not exists

Requirements when using RENAME:

  • If the CFTRECV WFNAME is not defined, the transfer fails with DIAGI=138.
  • The user (userid) who performs the transfer must have adequate rights to rename the file WFNAME to file FNAME. If not, the transfer fails with DIAGI=156.

The following table shows the combined effect of the FDISP and FACTION parameters when used in a RECV command.

CFTRECV, FDISP CFTRECV, FACTION Comments
both delete If no file exists, the file is created. If file exists it is deleted and recreated (regardless of if it is empty or not).
both erase If no file exists, the file is created. If file exists it is overwritten (no matter if it is empty or not).
both verify If no file exists, the file is created. If file exists and it is not empty, the transfer is aborted. If file exists but it is empty, the file is overwritten.
new verify If no file exists, the file is created. If file exists the transfer is aborted (regardless of if it is empty or not).
old delete If no file exists, the transfer is aborted. If file exists the file is deleted and recreated (regardless of if it is empty or not).
old erase If no file exists, the transfer is aborted. If file exists the file is overwritten (regardless of if it is empty or not).
old verify If no file exists, the transfer is aborted. If file exists and it is not empty, the transfer is aborted. If file exists but it is empty, the file is overwritten.

 

OS Details

z/OS

For VSAM files, only FACTION = ERASE is accepted.

Return to Command index  

Related Links