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

You can run the JnextPlan command from a command prompt shell on the master domain manager if you are one of the following users:
  • The TWS_user user for which you installed the product on that machine, if not disabled by the settings that are defined in the security file.
  • Root on UNIX operating systems or Administrator on Windows operating systems, if not disabled by the settings that are defined in the security file.

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.

Assuming that the value assigned to startOfDay is 00:00 a.m. and that the date format set in the localopts file is mm/dd/yyyy, if the values set are -from 07/05/2021 and -to 07/07/2021, then the plan is created to span the time frame from 07/05/2021 at 00:00 a.m. to 07/06/2021 at 11:59 p.m. and not to 07/07/2021 at 11:59 p.m.