#g4gcon_listContacts

  *//////////////////////////////////////////////////////////////*    
  * #g4gcon_listContacts - List Contacts                         *    
  *                                                              *    
  * Output:                                                      *    
  *   out_errMsg - The error message (if error exists).          *    
  *                                                              *    
  * Returns:                                                     *    
  *   -1 for error, number of contacts                           *    
  *                                                              *    
  * Settable Variables ([r]=required)                            *    
  *   id - Google ID [r]                                         *    
  *   group - Group Name (Contacts)                              *    
  *   max_results - Maximum Results to Return (999999)           *    
  *   reset - Reset Values when Done (*YES)                      *    
  *   ccsid - The CCSID to use (1208)                            *    
  *   debug - Turn on Debug (*NO, *YES)                          *    
  *   debug_file - The debug file name.                          *    
  *                 (/tmp/g4g_[id]_listGroupsDebug.txt)          *    
  *                                                              *    
  *//////////////////////////////////////////////////////////////*    
 D #g4gcon_listContacts...                                            
 D                 PR            10i 0                                
 D  out_errMsg                  256    Options(*NOPASS)               


#g4gcon_listContacts will list the available contacts for a certain ID, and optionally a contact Group.  The contacts are placed in 3 files, all joined by the ID and Contact ID:
  • G4GCONHPF - The Contact Header File
  • G4GCONEPF - The Contact Email Address File (1 or more addresses per contact)
  • G4GCONPPF - The Contact Phone Number File (1 or more phone numbers per contact).

Returns: n for the number of contacts retrieved, -1 for error.

Optional Parameters:
  • Error Message (output) - Error message  
Settable Variables (use #g4gcal_setValue):
  • id (required) - Your Google ID
  • group - Specify the group to retrieve contacts for.  This needs to either be a group name from the SYSGROUP or MYGROUP field in the G4GCONGPF file.
  • max_results - Specify the maximum number of results to retrieve.  The default is 999999.  
  • reset - Specify if the values should be reset after the call (default is *YES).
  • 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/g4g_[id]_[group]_listContactsDebug.txt
Comments