JnextPlan

The JnextPlan script is used to manage the entire process of moving from an old to a new production plan (Symphony), including its activation across the HCL Workload Automation network. Every time you run JnextPlan all workstations are stopped and restarted.

When you run JnextPlan command a joblog file is created in the directory <TWS_INST_DIR>\TWS\stdlist\<DATE>, where <TWS_INST_DIR> is the HCL Workload Automation installation directory and <DATE> is the date when the script run.

Authorization

Syntax

JnextPlan
      [-V | -U ] |  
      [-from mm/dd/[yy]yy[hh[:]mm[tz | timezone tzname]]]
      {-to mm/dd/[yy]yy[hh[:]mm[tz | timezone tzname]] |
       -for [h]hh[:]mm  [-days n] | -days n}
      [-noremove]

Arguments

-V

Displays the command version and exits.

-U

Displays command usage information and exits.

-from

Sets the start time of the production plan. The format of the date is specified in the localopts file; where hhmm identifies the hours and the minutes and tz is the time zone. This flag is used only if a production plan does not exist. If the -from argument is not specified, the default value is "today +startOfDay".

If the time zone is not specified, time zone GMT is used by default.

-to

Is the production plan end time. The format for the date is the same as that used for the -from argument. The -to argument is mutually exclusive with the -for and -days arguments.

If the time zone is not specified, time zone GMT is used by default.

-for

Is the plan extension expressed in time. The format is hhhmm, where hhh are the hours and mm are the minutes. The -for argument is mutually exclusive with -to.

-days n

Is the number of days you want to create or extend the production plan for. The -days parameter is mutually exclusive with the -to parameter.

-noremove

Ensures that the completed job stream instances are not removed from the new production plan.

If no -to, -for, or -days arguments are specified, then the default production plan length is one day.

JnextPlan -for 0000

The JnextPlan -for 0000 command extends by 0 hours and 0 minutes the production plan and adds into the production plan (Symphony) the newly-created workstation, user, and calendar definitions in the database. It also removes all the successfully completed job stream instances.

If you use the JnextPlan -for 0000 -noremove command, all the successfully completed job stream instances in the Symphony are not removed.

The enCarryForward global option setting specifies if job streams that did not complete are carried forward from the old to the new production plan. Ensure that the enCarryForward option is set to ALL before running the command to have all incompleted job stream instances in the new production plan or use the -noremove option.