SEQNUMSUPPORT (FTP client) statement

Use the SEQNUMSUPPORT statement to ignore sequence numbers in files designated by the ddname INPUT.

Syntax


   .-SEQNUMSUPPORT FALSE------.   
>>-+--------------------------+--------------------------------><
   '-SEQNUMSUPPORT -+-TRUE--+-'   
                    '-FALSE-'

Parameters

TRUE: When reading FTP subcommands to be processed from the ddname INPUT, FTP removes any sequence numbers before processing the command.
FALSE: When reading FTP subcommands, any sequence numbers in the input designated by the ddname INPUT are considered to be part of the input. This is the default.

Examples

The following example shows how data sets with different sequence number schemes can be concatenated if SEQNUMSUPPORT TRUE is coded in the FTP.DATA file:

Suppose dataset:  FTP.SUBCMDS(LOGIN) contains no sequence numbers
                                                                                                                         
  mvs056.tcp.raleigh.ibm.com           
  user1                                
  us3rpswd
              
Suppose dataset:  FTP.SUBCMDS(FTPINFO) contains TRAILING sequence numbers

  ; This comment prevents 00000100 and subsequent sequence numbers         00000100
  ; from being interpreted as an ftp subcommand.                           00000110
  locstat                                                                  00000120
  stat                                                                     00000130
  pwd                                                                      00000140
  
  Suppose dataset:  FTP.SUBCMDS(FTPCMDS1) contains no sequence numbers
 
  ; This comment indicates no sequence numbers present
  get remote.file.name local.name.  
   
  Suppose dataset:  FTP.SUBCMDS(FTPCMDS2) contains LEADING sequence numbers

  00000100; The file indicates leading sequence numbers present
  00000110put local.file +
  00000120 remote.file

To specify the datasets listed previously as input to the FTP client, the following sample JCL is used:

 //FTP  EXEC PGM=FTP
  //SYSPRINT DD SYSOUT=*
  //SYSFTPD DD DSN=SYS1.TCPPARMS(FTPCDATA),DISP=SHR
  //* Insure that SEQNUMSUPPORT TRUE is coded
  //* in the above clients FTP.DATA file
  //INPUT DD DSN=FTP.SUBCMDS(LOGIN),DISP=SHR     
  //      DD DSN=FTP.SUBCMDS(FTPINFO),DISP=SHR   
  //      DD DSN=FTP.SUBCMDS(FTPCMDS1),DISP=SHR  
  //      DD DSN=FTP.SUBCMDS(FTPCMDS2),DISP=SHR

Results:

When SEQNUMSUPPORT TRUE is coded in the FTP.DATA file and the FTP client reads the first record of the file specified by the ddname INPUT, the record determines the type of sequence numbers that are to be processed.
If the last eight columns are numeric and contain trailing sequence numbers, this data is replaced with blanks before running this and subsequent records. Otherwise, if the first eight columns are numeric and contain leading sequence numbers, the data that begins in column 9 is shifted to column 1 before the record is processed.
If FTP detects no sequence numbers, the data is not modified.
Each time a semicolon (;) is detected in the first data column, FTP determines the sequencing mode to use to process sequence numbers that follow statement.

Requirements:

If you concatenate files with the INPUT DD statement, the first statement in each concatenated file must have a semicolon (;) in column 1; the semicolon to enables the FTP client to correctly determine the sequence numbering scheme that is being used.
If no semicolon (;) is present in the concatenated files, sequence number processing does not change.