Use the SBSENDEOL statement to tell the FTP client or server what end-of-line (EOL) sequence to use for outbound data when ENcoding is SBCS, Mode is stream, and Type is ASCII. You can also use the SIte and LOCSIte subcommands to set this keyword.
- Server
- Tell the server what EOL sequence to append to each line of text when ENcoding is SBCS, Type is ASCII, and files are sent from the server to the client.
- Client
- Tell the client what EOL sequence to append to each line of text when ENcoding is SBCS, Type is ASCII, and files are sent from the client to the server.
Syntax
.-SBSENDEOL CRLF------. >>-+---------------------+------------------------------------->< '-SBSENDEOL--+-CRLF-+-' +-CR---+ +-LF---+ '-NONE-'
Parameters
- CRLF
- When translating outbound single-byte data to ASCII, append a carriage return (x'0D') and line feed (x'0A') to each line of text. This is the default and the standard line terminator defined by RFC 959. The z/OS® server and client can receive ASCII data in this format only. It is the only setting permitted when using the SRestart subcommand in the client.
- CR
- When translating outbound single-byte data to ASCII, append only a carriage return (x'0D') to each line of text.
- LF
- When translating outbound single-byte data to ASCII, append only a line feed (x'0A') to each line of text.
- NONE
- When translating outbound single-byte data to ASCII, append no EOL sequence.
Examples
When translating outbound single-byte
data to ASCII, to append LF only to each line use the following code:
SBSENDEOL LF To
translate files sent from the FTP client to ASCII, without appending
an EOL sequence to each line, code the following statements in the
client's FTP.DATA. At login, the data type is ASCII and the mode is
Stream unless you change the values using subcommands.
ENCODING SBCS
SBSENDEOL NONERestrictions:
- This statement applies only to the end-of-line sequence used on the data connection. The control connection end-of-line sequence is not affected.
- Double-byte, UCS-2, and multi-byte file transfers are not affected by this setting.
- This statement applies only when ENCODING is SBCS, Type is ASCII, and Mode is Stream.
Rule: The SBSENDEOL setting CRLF is the default
and the standard EOL sequence defined by RFC 959. It is appropriate
for most file transfers. Do not use an alternate SBSENDEOL setting
unless you have verified that the recipient FTP can handle the alternate
value.
- Client
- Do not code an alternate SBSENDEOL value if your server is a z/OS FTP server. The z/OS FTP server does not support alternate SBSENDEOL values for inbound file transfer.
- Server
- Do not code an alternate SBSENDEOL value if your client is a z/OS FTP client. The z/OS FTP client does not support alternate SBSENDEOL values for inbound file transfer.
Result for FTP client: If you put a file while TYPE is ASCII, MODE is STREAM, ENCODING is SBCS, and SBSENDEOL is not CRLF, the srestart put subcommand is disabled.
Results
for FTP server:
- If you code a SBSENDEOL value other than CRLF, the SIZE command is disabled.
- If you transfer a file from the server while TYPE is ASCII, MODE is STREAM, ENCODING is SBCS, and SBSENDEOL is not CRLF, the SIZE command is disabled for the remainder of the session, and the command sequence REST - RETR is disabled for MODE STREAM, TYPE ASCII, ENCODING SBCS file transfers. This precludes stream-mode restart of file transfer to and from the server.
- The REST command in Mode B (Block mode) is not affected by this setting.