Chapter 11. Exits 269
/*        pDoc                                                        */
/*                                                                    */
/* OUTPUT:                                                            */
/*                                                                    */
/* RETURN_CODE:                                                       */
/*        0         -> Successful                                     */
/*        Otherwise -> Failed                                         */
/*                                                                    */
/**********************************************************************/
typedef struct _ArsCSXitPrepExit                                        
{                                                                       
   char               *pUserid;     /* Logged on userid */              
   char               *pInFileName; /* File name for document data */   
   char               OutFileName[ARCCSXIT_PATH_MAX + 1];               
                                    /* File name for modified data */   
   char               *pUserParms;  /* User defined parms from appl */  
   ArcCSXitApplGroup  *pApplGrp;    /* Appl Grp info */                 
   ArcCSXitAppl       *pAppl;       /* Application info */              
   ArcCSXitDoc        *pDoc;        /* Doc handle, field info */        
   char               *instance;    /* OD Instance name */         
} ArsCSXitPrepExit;                                                
                                                                   
ArcI32                                                             
ARSCSXIT_EXPORT                                                    
ARSCSXIT_API                                                       
PREPEXIT( ArsCSXitPrepExit *prep );                                
For example, you can arrange it so that when a user retrieves a document from a particular 
application group, you can check the name of the account number (the indexes from the Doc 
handle) and place a watermark for that document. When the document is retrieved by the 
user, the user sees the document with the watermark.
Activating the client retrieval preview exit
To activate the client retrieval preview exit, select the Use Preview Exit option on the 
Miscellaneous Options page of an application and place the exit in the bin/exits directory of 
the Content Manager OnDemand installation root. When the option is selected, the 
user-written program is called any time that a request is made to retrieve a document. 
Any information that is specified in the Parameters field is passed to the user-written program. 
Place the arsuprep program in the bin/exits directory.
The client retrieval preview user exit can be enabled for all data types, except for None.
For more information, see the IBM Content Manager OnDemand for Multiplatforms - 
Installation and Configuration Guide, SC18-9232.
11.5.3  Report specifications archive definition exit
Use the Content Manager OnDemand report specifications archive definition exit to change 
several of the parameters that are used by Content Manager OnDemand when document 
data is loaded by the ARSLOAD program. ARSUUPDT is a dynamic link library (DLL) module that is 
written in the C programming language.