Important considerations for using the TSO commands
Consider these points when
using the TSO commands:
- The parameters that you pass to the TSO commands are checked
only
for the correct format; that is, numeric fields must contain only
numbers within a valid range, date fields must contain valid dates,
and so on. The parameters are not checked
for their validity for a particular HCL Workload Automation for Z address
space. For example,
the workstation name that you specify for OPSTAT is not verified against
the actual workstations that exist in a particular current plan. In
addition, a single event record can be generated to be used in two
or more HCL Workload Automation for Z address
spaces. A particular parameter (for example,
the application description ID) might be valid for one address space
and not another.
As long as the minimum parameter requirements are met and the parameters are in the correct format, the TSO commands will execute successfully and generate an event record.
When the event is processed by the controller, it is checked for validity. If any errors are found, an error message is written to the controller message log (EQQMLOG).
- You can use the TSO commands even if HCL Workload Automation for Z (in particular, the event writer subtask) is not active. Event records are still generated and placed in the event writer queue. When the event writer starts, the event records are removed from the queue and written to the event data set.
For a description of the TSO commands and their usage, refer to the following sections. The commands are listed alphabetically.