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