CHKCONFIDENCE statement (FTP client and server) statement

Use the CHKCONFIDENCE statement to tell the FTP client or server whether to check and report on the confidence level in the successful completion of file transfers. Checks include reporting a missing EOF marker in an inbound data set being transferred using record structure (STRUCTURE RECORD), or block mode (MODE B), or compress mode (MODE C) and verifying that the sender is still responding after the transfer.

Server
The server reports the confidence level after each transfer with FTP log message EZYFS86I and with a parameter passed to the FTPOSTPR user exit.
Client
The client reports the confidence level after each file transfer by issuing message EZA2108I.
Tips:
  • If the MBREQUIRELASTEOL statement is set to FALSE, the confidence level reported when a multibyte file is received from the network without an EOL sequence in the last record is High.
  • If the MBREQUIRELASTEOL statement is set to TRUE, the confidence level reported when a multibyte file is received from the network without an EOL sequence in the last record is Low.

Syntax

Read syntax diagramSkip visual syntax diagram
   .-CHKCONFIDENCE FALSE------.   
>>-+--------------------------+--------------------------------><
   '-CHKCONFIDENCE--+-TRUE--+-'   
                    '-FALSE-'     

Parameters

TRUE

Perform the following checks and report any detected conditions that cast doubt on the successful completion of a transfer.

Use the following to make the determination:
  • Whether a missing EOF marker condition is detected in an inbound STRUCTURE RECORD, or MODE B, or MODE C file
  • Whether the sender fails to respond following any type of transfer
  • Whether some other condition causes the transfer to fail or establish doubt about its completion
FALSE
Do not perform the checks or report on the confidence level in the successful completion of a transfer. This does not suppress reporting of error conditions.
Tips: Consider the following information when using the CHKCONFIDENCE statement:
  • A missing EOF marker might or might not signal an error in the transmission, and it is reported only if no other problem is detected. A confidence level of NoEOF reflects a missing EOF marker. Any other problem changes the confidence level to Low.
  • FTP client
  • FTP server
    • Either code FTPLOGGING TRUE in FTP.DATA or install the FTPOSTPR exit routine, to determine what confidence level the server assigns to each file transfer.
    • Message EZYFS86I is logged only when FTPLOGGING TRUE is coded in FTP.DATA. For additional information about EZYFS86I, see z/OS Communications Server: IP Messages Volume 3 (EZY).
    • The confidence level is passed to the FTPOSTPR exit. See The FTPOSTPR user exit for information about the FTPOSTPR exit routine.

Related topics