Creating SMART Folders with definitions using the ctmdeffolder utility

This procedure describes how to run the ctmdeffolder utility, which enables you to create a definition for a new SMART Folder.

To create SMART Folders using the ctmdeffolder utility:

1. Do one of the following:
   • UNIX: Log on to a Control-M/Server account.
   • Windows: Open a command prompt window where Control-M/Server is installed.

   NOTE: You can also run this utility in Control-M Agent by navigating to where Control-M/Agent is installed.

2. Type the following command to invoke the ctmdeffolder utility:

   ctmdeffolder

   -FOLDER <name>

   [ -SUBAPPLICATION <subapplication name> ]

   [ -APPLICATION <application name> ]

   [ -MAXRERUN <value> ]

   [ -CYCLIC Y|N ]

   [ -CYCLIC_TYPE INTERVAL|INTERVAL_SEQUENCE|SPECIFIC_TIMES ]

   [ -INTERVAL <45d(days) | 1080h(hours) | 64800m (minutes)> ]

   [ -SPECIFIC_TIMES <specific times string (HHMM,HHMM)> ]

   [ -INTERVAL_SEQUENCE <interval sequence string e.g(+1H,+2M)> ]

   [ -TOLERANCE <maximum delay allowed (minutes)> ]

   [ -INTERVALFROM START | END | TARGET ]

   [ -MAXWAIT <days> ]

   [ -ADJUST_COND Y|N ]

   [ -RUN_AS <username> ]

   [ -CREATED BY <username> ]

   [ -DEBUG <debug level 0-5> ]

   [ -QUIET ]

   [ -TIMEZONE <xxx> ]

   [ -TIMEFROM <earliest submission time> ]

   [ -TIMEUNTIL <latest submission time> | '>' ]

   [ -PRIORITY <job priority> ]

   [ -CONFIRM Y|N ]

   [ -APPLTYPE <agent_application> ]

   [ -APPLVER <application version> ]

   [ -CMVER <CM version> ]

   [ -APPLFORM <application form> ]

   [ -DESCRIPTION <string> ]

   [ -DOCMEM <filename> ]

   [ -DOCLIB <directory name> ]

   [ -INCOND <condition> <dateref>|ODAT AND|OR ]

   [ -OUTCOND <condition> <dateref>|ODAT ADD|DEL ]

   [ -VARIABLE <varname> <expression> ]

   [ -SHOUT OK|NOTOK|LATESUB|LATETIME|EXECTIME

   <destination> <urgency R|U|V> <message> [<time>] ]

   [ -USERDAILY <user daily name>

[ -REMOVEATONCE Y:N ]

[ -DAYSKEEPINNOTOK <days> ]

[ -ON <OK|NOTOK>

[ -DOOK ]

[ -DONOTOK ]

[ -DOSTOPCYCLIC]

[ -DOSHOUT <destination> <urgency R|U|V> <message> ]

[ -DOCOND <condname> <dateref>|ODAT ADD|DEL ]

[ -DOVARIABLE <varname> <expression> ]

[ -DOFORCEJOB <foldername> <jobname> <odate>|ODAT ]

[ -DOREMOTEFORCEJOB <foldername> <jobname> <odate>|ODAT ]

[ -DOMAIL <destination> <cc> <urgency R|U|V> <subject> <message> ]

[ -DOREMEDY <summary> <description> <urgency L|M|H|U|C> ]

-RBC <rbcname>

[ -MAXWAIT <maxwait> ]

[ -DAYS <daystr> ]

[ -WEEKDAYS <weekdaystr> ]

[ -MONTH ALL|JAN|FEB|MAR|APR|MAY|JUN|JUL|AUG|SEP|OCT|NOV|DEC Y|N ]

[ -DATE <MMDD> ]

[ -DATEFROM <YYYYMMDD> ]

[ -DATEUNTIL <YYYYMMDD> ]

[ -DAYSCAL <days calendar> ]

[ -WEEKCAL <week calendar> ]

[ -CONFCAL <conf calendar> ]

[ -CAL_ANDOR AND|OR ]

[ -SHIFT [</>/@][+/-]nn ]

NOTE: The parameters related to Cyclic Folder appear if Control-M/Server is not running in Compatibility mode.

You can use the following -input_file parameter to run the utility:

ctmdeffolder -input_file <fullPathFileName>

For the Control-M parameter name, see Parameter name cross references. For more details on the ctmdeffolder parameters , see the following:

• ctmdeffolder parameters
• ctmdeffolder example