PM19545: USING THE FTP DIR SUBCOMMAND, NOT ENOUGH INFORMATION IS RETURNEDTO DETERMINE IF A DATASET IS A PDS OR A PDSE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A typical DIR command in FTP returns a list of datasets,
  including additional attributes describing each dataset.
  However, the dataset organization (DSORG) field is not
  displayed, even though FTP has access to this information.  As a
  result, there is no direct way by which a user can use the DIR
  output to determine if a dataset is a basic PDS or an extended
  PDS (PDSE).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release(s) 10, 11, and    *
  *                 12 IP: FTP                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using FTP DIR subcommand to list   *
  *                      data sets of a directory on the FTP     *
  *                      server, PDS, PDSE and HFS data sets     *
  *                      are not distinguished in the LIST       *
  *                      reply. The DSORG attributes of PDS,     *
  *                      PDSE and HFS data sets are all "PO"     *
  *                      in the list.                            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  PDSE and PDS datasets in the LIST reply of DIR subcommand are
  not distinguished. The DSORG attributes of PDSE and PDS are
  the same value "PO".
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

• The problem has been corrected. A new server FTP.DATA statement,
  LISTLEVEL with possible values of 0 and 1 has been added.
  
  The following documentation updates will be made.
  
  ****************************************************************
  * FUNCTION AFFECTED: Communications Server TCP/IP (PM19545)    *
  *                     FTP                                      *
  ****************************************************************
  * DESCRIPTION      : Documentation updates                     *
  ****************************************************************
  * TIMING           : None                                      *
  ****************************************************************
  
  IBM Communications Server:
  IP Configuration Reference
  SC318776
  
  Add the following under FTP.DATA data set statements
  
  LISTLEVEL (FTP server) statement
  
  Use the LISTLEVEL statement to specify the format of the LIST
  reply for the DIR command.
  
  Syntax
  
        _LISTLEVEL___0_
   >>__|_______________|______________<<
       |_LISTLEVEL___0_|
                   |_1_|
  
  Parameters
  0
  Specifies that PDS, PDSE and HFS data sets are displayed with a
  DSORG value of PO.
  
  1
  Specifies that PDS data sets are displayed with a DSORG value of
  PO, PDSE data sets are displayed with a DSORG value of PO-E, and
  HFS data sets are displayed with a DSORG value of HFS.
  
  Examples
  Set LISTLEVEL to 1 when you want to distinguish PDS, PDSE and
  HFS data sets in the LIST reply:
  
  LISTLEVEL 1
  
  ==========================================================
  IBM Communications Server:
  IP User's Guide and Commands
  SC318780
  
  Add the following to the SITE Subcommands
  
  Add the following 2 lines into the format chart:
  |_LISTLEVel__=__ __0_____________________|
  |               |__1__|                  |
  
  And add the following descriptions:
  
  LISTLEVEL
    Specifies the format of the LIST reply.
  
    0
      Specifies that PDS, PDSE and HFS data sets are displayed
      with a DSORG value of PO.
    1
      Specifies that PDS data sets are displayed with a DSORG
      value of PO, PDSE data sets are displayed with a DSORG value
      of PO-E, and HFS data sets are displayed with a DSORG value
      of HFS.
  
  ==========================================================
  IBM Communications Server:
  Quick Reference
  SX750124
  
  Chapter 2. TSO commands
  
  SITE subcommand
  Send site specific information to a host:
  Add LISTLEVEL alphabetically to the syntax diagram for the site
  subcommand.
  
  |_LISTLEVel__=__ __0_____________________|
  |               |__1__|                  |
  
  STATUS subcommand:
  Retrieve status information from a remote host:
  Add LISTLEVEL alphabetically to the syntax diagram for the
  locstat subcommand as one option.
  
        |_LISTLEVel_____________|
  
  
  * Cross Reference between External and Internal Names
  EZAFTPSM (FTPDMSG )  EZAFTPSM (FTPDMSG )  EZAFTPSM (FTPDMSG )
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK61321 UK61322 UK61323

Modules/Macros

• EZAFTPAS EZAFTPCY EZAFTPDM EZAFTPEH EZAFTPEJ
  EZAFTPEP EZAFTPGL EZAFTPGM EZAFTPMK EZAFTPMR EZAFTPM9 EZAFTPRM
  EZAFTPRT EZAFTPRX EZAFTPSD EZAFTPSM EZAFTPSR
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1A0 PSY UK61321

     UP10/11/17 P F011

• R1B0 PSY UK61322

     UP10/11/17 P F011

• R1C0 PSY UK61323

     UP10/11/17 P F011

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.