SCTRAP operation (XRC)

This operation is a serviceability function provided by the XRC support. The SCTRAP operation enables a storage control to dump its internal control queues when requested to do so by an XRC function. This information is useful for diagnosing the storage control errors for the storage controls that support this capability.

This operation applies to the primary storage controls associated with an XRC logical session. XRC only requests one storage control dump each 24-hour period. To obtain additional dumps within this time period, use the MVS MODIFY STATESAVE RESET option to change the last time when a dump was taken to zero.

Note: This operation does not apply to non-disruptive state saves.

Example: The following example is the SCTRAP operation:

F ANTAS003,SCTRAP ON

Specifying the ON operand enables XRC to request a storage control to dump its internal control queues when it encounters certain LIC-related errors. Specifying the OFF operand tells XRC, for certain error types, not to request a storage control to dump its internal control queues.

If you do not specify an operand, MVS displays the current status of the SCTRAP operation.

Note: Turning SCTRAP on does not cause the storage control to dump its queues. In the following situations, turning SCTRAP on only enables XRC to make the request:

The storage control encounters one of the predefined error conditions.
A STATESAVE operation with device address and session number option is executed.

There can be an application performance impact when the system dumps the storage control queues.