Merging SWBTUs (SJFREQ macro with SWBTU_MERGE)

Applications sometimes need to update the output characteristics associated with a system output (SYSOUT) data set. The SJFREQ SWBTU_MERGE service allows an application to update these SYSOUT characteristics by merging two SWBTU lists. The application can request that a base SWBTU list be merged with a merge SWBTU list. A base SWBTU list contains the current data set characteristics; a merge SWBTU list contains additional data set characteristics or the base list with changes. The SJFREQ SWBTU_MERGE service also allows an application to remove SWBTUs from a base SWBTU list.

An application can request the SWBTU_MERGE service to allow certain errors during input processing by setting the SJSMWARN bit in the parameter list. Setting the SJSWARN bit allows errors for which the return code is 0, and the reason code is X'0CA' through X'243'. Use the SJSMWARN bit only when you know the keywords you are using are not compatible with your current system release. Also note that even though you may have more than one error in a SWBTU list, \JSMEKER and SJSMMKER contain information about only one error upon return from an invocation. You might need to repeat this process of fixing an error and invoking the service several times before eliminating all the errors. See z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO for information about filling in the parameter list.

Use caution when setting the SJSMWARN bit. When SJSMWARN is on, errors are allowed for any key or parameter, not just for the keys or parameters for which you set SJSMWARN on (keys that are not compatible with your current system release).