NAME

       changeIobStatus - Automate WebGUI's InOut Board User status switching.

SYNOPSIS

        changeIobStatus --configFile config.conf
                        [--currentStatus status]
                        [--newStatus status]
                        [--userMessage text|--userMessageFile pathname]
                        [--whatsHappening text]
                        [--quiet]

        changeIobStatus --help

DESCRIPTION

       This WebGUI utility script helps you switch one or more user status in the InOut Board
       (IOB). For instance, you might want to run it from cron each night to automatically mark
       out all users that haven't already marked out.

       --configFile config.conf
           The WebGUI config file to use. Only the file name needs to be specified, since it will
           be looked up inside WebGUI's configuration directory.  This parameter is required.

       --currentStatus status
           Check users in the IOB having status status. If left unspecified, it will default to
           "In".

       --newStatus status
           Change users status in the IOB to status status. If left unspecified, it will default
           to "Out".

       --userMessage msg
           Text of the message to be sent to the user after changing the status.  If left
           unspecified it will default to

               You were logged out of the In/Out Board automatically.

       --userMessageFile pathname
           Pathname to a file whose contents will be sent to the user after changing the status.
           Using this option overrides whatever messages is set with --userMessage (see above).

       --whatsHappening text
           The message attached to the InOut Board when changing status. If left unspecified it
           defaults to

               Automatically signed out.

       --quiet
           Disable all output unless there's an error.

       --help
           Shows this documentation, then exits.

AUTHOR

       Copyright 2001-2009 Plain Black Corporation.