How do I spin off JES output in MSGUSR?

From CICS Wiki

Jump to: navigation, search

Excessive growth in MSGUSR can be controlled by spinning the log off to JES . This can be done using the following methods:

Contents

Allocate multiple MSGUSR DD statements

//MSGUSR DD SYSOUT=*,FREE=CLOSE,SPIN=UNALLOC
//MSGUSR DD SYSOUT=*,FREE=CLOSE,SPIN=UNALLOC
//MSGUSR DD SYSOUT=*,FREE=CLOSE,SPIN=UNALLOC
//MSGUSR DD SYSOUT=*,FREE=CLOSE,SPIN=UNALLOC
//MSGUSR DD SYSOUT=*,FREE=CLOSE,SPIN=UNALLOC
//MSGUSR DD SYSOUT=*

You then need to close and reopen the [[TDQUEUE] that point to the MSGUSR (CSSL). Everytime you reopen it, the region will start to use the next DD [1].

Note the last entry. That will prevent you from ending up without an output DD [1] if you accidentally close and reopen the TDQ once too many.

Use the SEGMENT option

An alternative method is to use the SEGMENT option on the DD card [1]. This will automatically spin off the JES output after the requested number of pages has been produced.

//MSGUSR DD  SYSOUT=A,SEGMENT=1000

Allocate the DD dynamically using the TDQ definition

(Thanks to Darwin Nash for the last method)

The CSSL TDQUEUE can be dynamically allocated by removing the MSGUSR DD [1] statements from the CICS PROC. Then if you use the IBM supplied DFHDCTG RDO group the SYSOUT class will default to your CICS task default class. If you would like another class just change the SYSOUTCLASS parameter of the CSSL TDQUEUE definition. Each time you close and open the CSSL TDQUEUE the SYSOUT[1] will spin off and be ready for the processing of your choice. One disadvantage I’ve found is the limitation of coding only the SYSOUT class with no way to code other SYSOUT parameters such as destination. Of course this not limited to the CSSL TDQUEUE; other TDQs destined for SYSOUT can be set up the same way. Check the Resource Definition Guide [2] for more details.

Reference

  1. 1.0 1.1 1.2 1.3 1.4 http://publibz.boulder.ibm.com/cgi-bin/bookmgr_OS390/BOOKS/IEA2B661/CCONTENTS?SHELF=IEA2BK71&DN=SA22-7597-10&DT=20060125042105.
  2. http://publib.boulder.ibm.com/infocenter/cicsts/v3r2/topic/com.ibm.cics.ts.doc/dfha4/topics/dfha4_overview.html.



Admin 12:44, 20 November 2007 (CST)