//Warning: This code has been marked up for HTML

/**************************************************************************
*  Novell Software Developer Kit
*
*  Copyright (C) 2002-2003 Novell, Inc. All Rights Reserved.
*
*  THIS WORK IS SUBJECT TO U.S. AND INTERNATIONAL COPYRIGHT LAWS AND TREATIES.
*  USE AND REDISTRIBUTION OF THIS WORK IS SUBJECT TO THE LICENSE AGREEMENT
*  ACCOMPANYING THE SOFTWARE DEVELOPER KIT (SDK) THAT CONTAINS THIS WORK.
*  PURSUANT TO THE SDK LICENSE AGREEMENT, NOVELL HEREBY GRANTS TO DEVELOPER A
*  ROYALTY-FREE, NON-EXCLUSIVE LICENSE TO INCLUDE NOVELL'S SAMPLE CODE IN ITS
*  PRODUCT. NOVELL GRANTS DEVELOPER WORLDWIDE DISTRIBUTION RIGHTS TO MARKET,
*  DISTRIBUTE, OR SELL NOVELL'S SAMPLE CODE AS A COMPONENT OF DEVELOPER'S
*  PRODUCTS. NOVELL SHALL HAVE NO OBLIGATIONS TO DEVELOPER OR DEVELOPER'S
*  CUSTOMERS WITH RESPECT TO THIS CODE.
*
* $name:         TriggerBackgroundProcess.java
* $description:  TriggerBackgroundProcess.java demonstrates the way to trigger
*                one of the NDS background processes.
******************************************************************************/
import java.util.Hashtable;
import javax.naming.Context;
import javax.naming.NamingException;
import javax.naming.ldap.InitialLdapContext;
import javax.naming.ldap.LdapContext;
import com.novell.service.ndssdk.jndi.ldap.ext.TriggerBackgroundProcessRequest;

public class TriggerBackgroundProcess {
    public static void main(String[] args) {
        if( args.length != 4 ) {
            usage();
        }

        String hostURL   = args[0];
        String loginDN   = args[1];
        String passWord  = args[2];
        int    processID = Integer.parseInt(args[3]);

        try {
            String backgroundProcess;

           // create a Hashtable object.

            Hashtable env = new Hashtable(5, 0.75f);

            env.put(Context.INITIAL_CONTEXT_FACTORY,
                            "com.sun.jndi.ldap.LdapCtxFactory");
            env.put(Context.PROVIDER_URL, hostURL);
            env.put(Context.SECURITY_AUTHENTICATION, "simple" );
            env.put(Context.SECURITY_PRINCIPAL, loginDN );
            env.put(Context.SECURITY_CREDENTIALS, passWord );

           // Construct a LdapContext object.

            LdapContext ctx = new InitialLdapContext(env, null);

            /* create extended operation request object to trigger
             * one of the following NDS background processes.
             *     The process IDs used are:
             *     BACKGROUND_PROCESS_BKLINKER     = 1;
             *     BACKGROUND_PROCESS_JANITOR      = 2;
             *     BACKGROUND_PROCESS_LIMBER       = 3;
             *     BACKGROUND_PROCESS_PART_PURGE   = 4;
             *     BACKGROUND_PROCESS_SCHEMA_SYNC  = 5;
             *     BACKGROUND_PROCESS_SKULKER      = 6;
             */
            TriggerBackgroundProcessRequest  reqs =
                new TriggerBackgroundProcessRequest( processID );


           // call extended operation to trigger background process

            ctx.extendedOperation(reqs);

            System.out.println("\n\tBackground process" +
                reqs.getBackgroundProcessName() + "is scheduled.");
        }
        catch(NamingException e) {
            System.err.println("\n\tBackground process could not"
                               +" be scheduled.");
            e.printStackTrace();
        }
        finally{
            System.exit(0);
        }
    }

    public static void usage() {
        System.out.println("\n Usage  : java TriggerBackgroundProcess "
            + " <host URL> <login dn> <password>"
            + "\n          <background trigger type>");
        System.out.println("\n Example: java TriggerBackgroundProcess"
            + " ldap://Acme.com:389 cn=admin,o=Acme "
            + "\n          secret 1\n"
            + "\n          <background trigger type>: 1 - back linker"
            + "\n                                     2 - janitor"
            + "\n                                     3 - limber"
            + "\n                                     4 - skulker" 
            + "\n                                     5 - schema sync"
            + "\n                                     6 - partition purge");
        System.exit(1);
    }
}