g4gmail_modifyLabel

*//////////////////////////////////////////////////////////////*

* g4gmail_modifyLabel - Modify the message label *

* This will also update the G4GMHLPF *

* file with the updated labels for th *

* message. *

* *

* Output: *

* out_errMsg - The error message (if error exists). *

* *

* Returns: *

* -1 for error, 0 for success *

* *

* Settable Variables ([r]=required) *

* id - Google ID [r] *

* message_id - Message ID [r] *

* label_to_modify - Label ID To Mofify [r] *

* label_action - Label Action (*ADD, *REMOVE) [r] *

* ccsid - The CCSID to use (1208) *

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

* debug_file - The debug file name. *

* (/tmp/g4g_[msgid]_modifyLabel.txt) *

* *

*//////////////////////////////////////////////////////////////*

D g4gmail_modifyLabel...

D PR 10i 0

D out_errMsg 256 Options(*NOPASS)

g4gmail_modifyLabel will modify (add or remove) a label for the specified message. This will also update the G4GMHLPF file with the updated labels list for this message.

Returns: 0 for success or -1 for error.

Optional Parameters:

  • Error Message (output) - Error message

Settable Variables (use g4gmail_setValue):

  • id (required) - Your Google ID

  • message_id (required) - The message ID of the message to mark as read.

  • label_to_modify - The label ID to modify

  • label_action - The action to perform on the label. Use *ADD to add a label or *REMOVE to remove a label (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/g4g_[msgid]_markAsRead.txt.