Selecting programs, segments, and products

Describes how to select programs, segments, and products in the xcli command.

In many of the parameters of the xcli command, you are required to select a program or a segment, and optionally a product. To avoid repeating the same information, details of how to do this are supplied here:
Program
Select a program for a specific action by identifying the global section ([ _GLOBAL_ ]) or any of the configuration file sections containing IBM Workload Scheduler programs ([<program>] ).
Segment
Select one of the segment numbers that were defined in the configuration file when the shared memory was initialized. If you need to use extra segments or redistribute the programs within the segments, you must edit and save the configuration file and then stop and restart the IBM Workload Scheduler engine.
Product
The tracing facility is multi-product. However, if you run the xcli command from the same directory as a configuration file, you automatically run it on the product defined in that configuration file, without having to define the product in the command.

But if you are using In-Flight Trace to trace more than one product, and you want to use the command supplied with product A to modify the tracing of product B, you must supply the product code for product B as a parameter to the command, by adding the -P <product> parameter to the command string. This parameter in only applicable to the -snap, -query, -active, -level, and -filter subcommands.