IPC PSS occupancy warning message

Products

• IPC
• Ideal

Issue/Introduction

In CICS , IPCV SET OUPUT SITE OPTION panel shows towards the bottom : 

    Percent full occupancy warning:      nn         (1-99)

What is the warning message that is returned when this threshold is reached?

Resolution

Message IDADERRP51E - INTERR: OUTPUT LIB is full  is returned to the application when the ADROUT file has reached the value set for Percent full occupancy warning in the PSS site options.  This message is actually an error and not just a warning as it stops writing to the ADROUT file. 

The term Warning may appear a bit misleading, as a new output can't be opened once the percentage full is reached. However, the application that is writing the output that takes it beyond the threshold is not affected, and that output is allowed to complete. So in that sense, the percentage is not a hard limit, and "warning" is as good a term as any.

The percentage should be set so that all outputs will be able to complete, if that boundary is crossed. The worst case scenario is not if a very large report is begun when the library is one block short of the limit, because that will bring down the barrier to new outputs almost immediately. Multiple reports being written simultaneously is more of a concern, as you want all of them to complete before the library really does run out of space. So available free space needs to be report size times number of simultaneously open outputs. 

Applications fail when they try to open a new output, and of course, a PRINT command will do nothing. At that point, there's nothing to back out, and it's just a case of "try again later". Typically, unwanted outputs will be deleted to free up space, and normal service is resumed. The administrator can temporarily set the threshold higher, to allow a small print to be created, but that's not recommended as a general practice. 

The only way to change the occupancy percent number is via the SET SITE command. For documentation, see PSS Site Options Fill-in Panel.

Monitor the available free space in the  PSS Spool File ADROUT by running Ideal command @I$UTIL OUT STATUS or D LIB STA  which can be run online or in batch via IDBATCH.

For documentation, see Display the Current Status of the Output Library . 

Additional Information

On CICS ADRLOG , following message is written

1-ICSCERRP51E - INTERR: OUTPUT LIB is full