Running the ctmcreate utility

This procedure describes how to run the ctmcreate utility, which enables you to insert a specific purpose job, and/or SMART folder or Sub folder directly into the Active Jobs database.

To run the ctmcreate 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:

   ctmcreate

   -TASKTYPE <JOB|EXTERNAL|DETACHED|COMMAND|DUMMY|FOLDER|SUBFOLDER>

   [ -SUB_APPLICATION <sub_application name> ]

   [ -APPLICATION <applic name> ]

   [ -DEBUG <debug level 0-5> ]

   [ -QUIET ]

   [ -FOLDER_ORD <SMART folder or Sub folder orderno|ALONE|LAST> ]

   [ -ADJUST_COND Y|N ]

   [ -MULTIAGENT Y|N ]

   [ -HOSTGRP <name> ]

   [ -FILE_PATH <path> ]

   [ -FILE_NAME <filename> ]

   [ -CMDLINE <string> ]

   [ -EMBEDDED_SCRIPT <file name> ]

   [ -JOBNAME <name> ]

   [ -FOLDER <name> ]

   [ -RUN_AS <username> ]

   [ -CREATED_BY <username> ]

   [ -ODATE <date>|ODAT ]

   [ -ODATE_OPTION VALUE_DATE|RUN_DATE ]

   [ -MAXRERUN <value> ]

   [ -TIMEZONE <xxx> ]

   [ -TIMEFROM <earliest submission time> ]

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

   [ -PRIORITY <job priority> ]

   [ -CRITICAL Y|N ]

   [ -END_FOLDER Y_|N ]

   [ -CYCLIC Y|N ]

   [ -CYCLIC_TYPE INTERVAL|INTERVAL_SEQUENCE|SPECIFIC_TIMES ]

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

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

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

   [ -CONFIRM Y|N ]

   [ -TASKCLASS DISTRIBUTION_|DECOLLATION

   [ -APPLTYPE <agent_application> ]

   [ -APPLVER <application version> ]

   [ -CMVER <CM version> ]

   [ -APPLFORM <application form> ]

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

   [ -INTERVALFROM START | END | TARGET ]

   [ -OVERRIDE_PATH <alternative directory> ]

   [ -MAXWAIT <days> ]

   [ -DESCRIPTION <string> ]

   [ -DOCMEM <filename> ]

   [ -DOCLIB <directory name> ]

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

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

   [ -VARIABLE <variable name as %%local, %%\global, %%\\smart or %%\\pool\variable> <expression> ]

   [ -QUANTITATIVE <name> <quantity> ]

   [ -OUTPUT RELEASE|DELETE|COPY|MOVE [<parameter>]]

   [ -CONTROL <name> E|S ]

   [ -SHOUT OK|NOTOK|RERUN|LATESUB|LATETIME|EXECTIME <destination> <urgency R|U|V> <message> [<time>] ]

   [ -REMOVEATONCE Y:N ]

   [ -DAYSKEEPINNOTOK <days> ]

   [ -ON <statement> <code>

   [ -DOOK ]

   [ -DONOTOK ]

   [ -DORERUN ]

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

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

   [ -DOVARIABLE <variable name as %%local, %%\global, %%\\smart or %%\\pool\variable> <expression> ]

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

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

   [ -ORDERVARIABLE <variable name as %%local, %%\global, %%\\smart or %%\\pool\variable> <expression> ]

   [ -DOOUTPUT RELEASE|DELETE|COPY|MOVE [<parameter>] ] ]

   [ -DOSTOPCYCLIC ]

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

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

   [ -CAPTURE INTO <variable name as %%local, %%\global, %%\\smart or %%\\pool\variable>

   SEARCH <Search string>

   [SKIPROWS <Number rows>]

   [SKIPWORDS <Number words> [DELIMITER <Character delimiter> TAKE <Number words | 0 until end>] | SKIPCHARS <Number characters> [TAKE <Number chars | 0 until end>] ] ]

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