#g4msod_listFiles

      *//////////////////////////////////////////////////////////////*
      * #g4msod_listFiles - List Files                               *
      *                                                              *
      * Output:                                                      *
      *   out_errMsg - The error message (if error exists).          *
      *                                                              *
      * Returns:                                                     *
      *   -1 for error, number of files                              *
      *   -2 token is expired                                        *  
      *                                                              *
      * Settable Variables ([r]=required)                            *
      *   id - MS ID [r]                                             *
      *   path - The path to list files for.  (/root)                *
      *           Specify the path in the format /dir1/dir2/...      *
      *   ccsid - The CCSID to use (1252)                            *
      *   debug - Turn on Debug (*NO, *YES)                          *
      *   debug_file - The debug file name.                          *
      *                 (/tmp/g4ms_[id]_listGroupsDebug.txt)         *
      *                                                              *
      *//////////////////////////////////////////////////////////////*
     D #g4msod_listFiles...
     D                 PR            10i 0
     D  out_errMsg                  256    Options(*NOPASS)

#g4msod_listFiles will return a list of files for the Microsoft ID specified. This list will populate the G4MSDRVPF file.

Returns: The number of files returned, or -1 for an error, -2 for expired token.

Optional Parameters:

  • Error Message (output) - Error message

Settable Variables (use #g4msod_setValue):

  • id (required) - Your Microsoft ID
  • path - The path to list files for. If left blank the root will be used. When specifying a path, specify it fully qualified.

ie: /my Documents/Files

This parameter IS case sensitive.


  • ccsid - The CCSID to use. The default is 1208.
  • debug - Specify *YES to turn on debug, or *NO to turn off debug. The default is *NO.
  • debug_file - Specify the fully qualified file name for the main debug file. The default is /tmp/g4ms_[id]_listFilesDebug.txt.[n] where [id] is the Microsoft ID and [n] is the request index.