WTO capture services

When the integrated auxiliary utilities run in one of the address spaces, there are times when z/OS® or the integrated auxiliary utilities themselves issue an SVC 35 (WTO) to write a message to the console or the job log.

The RAUX is aware of and manages the collection of WTO messages and SYSOUT reports on behalf of the integrated auxiliary utilities.

WTO messages are managed as if they were a separate integrated auxiliary utility SYSOUT report, even though the integrated auxiliary utilities do not themselves create a separate WTO messages report.

In order to capture the WTO messages, the RAUX has a facility known as WTO capture services. This routine receives control when an SVC 35 is issued by any task in the address space.

If the message applies to one of the integrated auxiliary utility tasks, it is quickly copied to a RAUX memory structure, and separated by DBD Name and DD/Area Name. Then the RAUX allows the normal SVC 35 process to continue.

During address space termination of the subordinate address spaces, the captured SVC 35 messages are written from the memory structures to data sets allocated specifically for this purpose. In this way, WTO messages are associated with a specific DBD Name and DD/Area Name.

These names of these data sets are stored in the RAUX main control block and left to be managed by the RAUX control task in the MAS during its termination. Note that when RPTTYPE=SAS is specified, the WTO messages are simply left on the job log in the SAS.