TWS conman command syntax
- One of the many features introduced with TWS 8.3 is support for duplicate job stream and jobs within the same plan. Prior to TWS 8.3, duplicate names were not permitted and any jobs carried forward were renamed with a CFxxxxxxxx name to prevent any possible clash. From TWS 8.3 onwards, duplicate names are now supported making it much simpler to identify job streams and jobs within the plan.
To support duplicates names TWS now uses the workstation, job stream name, job name and scheduled time to uniquely identify the individual jobs when displaying details about different job instances. Although these values are used for display purposes, the schedule identifier (SCHEDID) is the actual unique identifier (within the workstation) used internally by TWS.
The output below shows the use of conman with the SHOWID option – the SCHEDID is highlighted in red.
Note that the output has been reformatted for this article to show only the relevant fields.
The above output shows two job streams of the same name ORB_SCHED02 and the highlighted red fields show the schedule-id (SCHEDID) assigned to each of the two instances. The SCHEDID uniquely identifies each job stream within the plan.
To manipulate a specific job stream or job, use the showid option to locate the specific SCHEDID and then use this with the SCHEDID option in the conman command. For example, to display only the specific job stream instance use the command as shown below.
Anywhere you would normally specify “workstation_name#job_stream_name[.jobname]” can be replaced with “schedule_id[.jobname];schedid” instead as shown below