Appender Reference

ZOSWtoAppender

ZOSWtoAppender is a logging facility appender that supports event logging on z/OS operating systems. ZOSWtoAppender enables you to direct SAS application messages, such as automation messages in the Admin message category, to the operating system consoles. ZOSWtoAppender uses the z/OS write-to-operator (WTO) service macro to direct the messages to the consoles. The appender also enables SAS servers to send messages about the status of applications to z/OS for automation purposes.

ZOSWtoAppender Syntax

</layout>

</appender>

ZOSWtoAppender Syntax Description

name="routecode" value="value": specifies the routing code that is used for ZOSWtoAppender messages.
name="desccode" value="value": specifies the descriptor code that is used for ZOSWtoAppender messages.
name="mcsflag" value="value": specifies the mcs flag that is used for ZOSWtoAppender messages. Valid values for the mcs flag parameter are HRDCPY, BRDCST, NOTIME, and BUSYEXIT.

For more information about the WTO service macro and the parameters listed here, see IBM's z/OS V1R9.0 MVS Assembler Services Reference.

For information about the generic elements of the appender syntax, see General Appender Syntax.

ZOSWtoAppender Example

The following example initiates ZOSWtoAppender; specifies a conversion pattern; specifies the name of the logger; and specifies values for the "routecode", "descode", and "mcsflag" parameters.

<appender name="WTO" class="ZOSWtoAppender">
   <layout>
      <param name=ConversionPattern"
             value="%d %-5p [%t] %c (%F:%L) -- %m"/>
   </layout>

   <param name="routecode" value="11"/>
   <param name="descode"   value="7"/>
   <param name="mcsflag"   value="HRDCPY"/>
</appender>

<logger name ="ADMIN.OPERATIONS">
   <level value="trace"/>
   <appender-ref ref="WTO"/>
</logger>

ZOSWtoAppender Usage and Best Practices

The "routecode", "descode", and "mcsflag" parameters can be included multiple times in your XML file. For example, you can have multiple "routecode" parameters if you want to specify more than one routing code.

Top of Page