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/... *

* group_id - Specify the group ID to list files for. *

* group_name - Specify the group Name to list files for. *

* ccsid - The CCSID to use (1252) *

* debug - Turn on Debug (*NO, *YES) *

* debug_file - The debug file name. *

* (/tmp/g4ms_[id]_listFilesDebug.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.


  • group_id - Specify the group ID to list files for.

  • group_name - Specify the group name to list files for. This will be ignored if the group_id is specified.

  • 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.