Listsucc

Lists the successors of a job.

You must have rerun access to the job. You also need to enable plan data replication in the database. For more information, see Replicating plan data in the database.

Syntax

listsucc jobselect

Arguments

jobselect
See Selecting jobs in commands.

Comments

If the user running the command is not authorized to see and rerun all the successors of the failed job, the list being displayed contains only the successors he is allowed to see. An error message is displayed, stating there are some additional successors he is not authorized to see or run.

The maximum number of successor jobs that can be returned is 1.000. To change this value, edit the com.hcl.tws.conn.plan.rerun.successors.maxjobs property in the TWSConfig.properties file, located in TWA_DATA_DIR/usr/servers/engineServer/resources/properties/TWSConfig.properties. To make this change effective, restart the master domain manager. When you run the command, the parent job is returned in the list of successors, but it does not count towards the total number of successor jobs listed. For example, if you set the com.hcl.tws.conn.plan.rerun.successors.maxjobs property to ten, and the total number of successors of your parent job is ten, a total of eleven jobs will be returned. This happens because the parent job is also listed, because it is scheduled to be rerun with its successors.

The action is always performed on the last rerun instance of the specified job. Also if you specify the job number of an intermediate job in the rerun sequence, the action is performed on the last job in the rerun sequence.

The Sched Time column in the command output is expressed in the timezone of the workstation where the job ran.

Examples

When you launch the listsucc WXA_VMDM#FINAL.STARTAPPSERVER command, the following output is displayed:
Successors in the same job stream 
Workstation  Job stream        Job                Status  Sched Time  Sched Id          Messages
------------ ---------------  ------------------- -----  ----------  ----------------  ----------------
WXA_VMDM     FINAL             STARTAPPSERVER     HOLD    2359 03/17  0AAAAAAAAAAAAADY  Invalid status
WXA_VMDM     FINAL             MAKEPLAN           HOLD    2359 03/17  0AAAAAAAAAAAAADY  Invalid status
WXA_VMDM     FINAL             SWITCHPLAN         HOLD    2359 03/17  0AAAAAAAAAAAAADY  Invalid status


Successors in other job streams 
Workstation  Job stream        Job                Status  Sched Time  Sched Id          Messages
------------ ----------------  ------------------ ------  ----------  ----------------  ----------------
WXA_VMDM     FINALPOSTREPORTS  CREATEPOSTREPORTS  HOLD    2359 03/17  0AAAAAAAAAAAAAEH  Invalid status
WXA_VMDM     FINALPOSTREPORTS  CHECKSYNC          HOLD    2359 03/17  0AAAAAAAAAAAAAEH  Invalid status
WXA_VMDM     FINALPOSTREPORTS  UPDATESTATS        HOLD    2359 03/17  0AAAAAAAAAAAAAEH  Invalid status
The Messages column shows the value Invalid status when for a job it is not possible to rerun all the successor jobs.

See also

From the Dynamic Workload Console you can perform the same task as follows:
  1. In the Welcome page, select Monitor your workload, or in the navigation bar at the top of the page, click Monitoring & Reporting > Orchestration Monitoring > Monitor Workload.
  2. Select an engine.
  3. In Object Type, select Workstation/Job/Jobstream.
  4. From the Query drop-down list, select All Jobs in plan or another task to monitor jobs.
  5. Click Run to run the monitoring task.
  6. From the table containing the list of jobs, select a job and click Rerun with successors....