Setting parameters for Exception Logging Facility and Automatic Screen Facility operation

Both XLF and ASF parameters are set with the XACB command using the XLF Parameters field.

The XACB statement is included in the panels on the Exception Settings path (fastpaths P.A.A through P.A.K). The XACB command enables you to activate the XLF and ASF features for all occurrences of any given exception or only if the exception persists for a specified number of cycles. You can also set a limit on the number of times a given exception invokes the XLF or ASF feature.

The following figure shows the format of the XACB statement. The variable cccc is the exception name. To dynamically set parameters for an exception, type over the current value displayed with the XACB command.
XACB LIST=cccc
:cccc
+ DISPLAY Parameters: 		THRESHOLD Parameters: 		XLF Parameters:
:   State= 			           Threshold=                Auto=
:   Group= 			           Display=                  Log=
:   Bell=                  Attribute=                Limit=nn
+ BOX Parameters: 		    CYCLE Parameters:          Repeat=
:   Boxchar=’ ‘            ExNcyc=n                  Persist=nn
:   Boxclr=                Stop=n (m)                Sc=
:   Boxattr=               Cumulative=n
These are the XLF and ASF parameters:
Table 1. The XLF and ASF parameters
Parameter Description
Auto Controls the status of ASF for this exception (ON/OFF).
Log Controls the status of XLF for this exception (ON/OFF). It does not affect logging for ASF.
Limit Limits the number of times (nn) XLF and/or ASF is invoked if the exception occurs. If you specify Limit=00, no events are logged. If you specify Limit=NONE, XLF and/or ASF are invoked each time the exception occurs. The number in parenthesis to the right of this parameter indicates the remaining number of times the exception is logged. You can reset the Limit parameter to continue logging the exception.
Repeat Used with the Persist threshold, Repeat=YES specifies that XLF logging or ASF action occurs each time the Persist threshold is reached. For example, if Persist=15, the exception condition persists for 15 cycles, and logging is in effect, then the message would be logged three times. If Repeat=NO, the message is logged only once as specified with the Persist parameter.
Persist Logs the exception message and/or invokes the ASF screen spaces when the condition persists for nn consecutive OMEGAMON for CICS (3270) cycles. After it has reached the threshold, the message is logged only once (or ASF is invoked only once) unless the condition stops for at least one cycle and then trips again. If you specify Persist=00, no events are logged. The default setting is 0 cycles.
Sc Sc, where c can be either an S or L. You must specify this parameter for ASF to work.
  • SL - Specifies the screen space to invoke if ASF is in effect (Auto=ON), and specifies that the output of the ASF screen spaces is to be logged. REPORT file logging automatically turns on when the exception trips and screen space logging starts.
  • SS - Specifies the screen space to invoke if ASF is in effect. It does not turn on the log.