SMNT gate, MVS_STORAGE_NOTIFY function

The MVS_STORAGE_NOTIFY function of SMNT format is used to notify a domain when use of MVS storage becomes excessive, or MVS storage is no longer constrained.

If use of MVS storage becomes excessive, the target domain can take action to release MVS storage or to limit its future MVS storage requirements. There is a notification for a breach of the threshold value for MVS storage, and a different notification for a breach of the reserved MVS storage cushion, which is a more serious condition.

If MVS storage is no longer constrained, the domain can return to normal operation.

Input Parameters

CUSHION
The status of the reserved MVS storage cushion since the last time the SM domain issued an MVS_STORAGE_NOTIFY call.
Values for the parameter are as follows:
  • NEWLY_BREACHED. The storage cushion has been partially released to satisfy requirements for MVS storage.
  • NEWLY_RESTORED. CICS has reallocated the reserved storage cushion.
  • UNCHANGED. The state of the storage cushion has not changed. The storage cushion is still partially released, or still intact.
THRESHOLD
The MVS storage requirements in relation to the threshold value for MVS storage since the last time the SM domain issued an MVS_STORAGE_NOTIFY call.
Values for the parameter are as follows:
  • NEWLY_BREACHED. MVS storage requirements have increased above the threshold value.
  • NEWLY_RESTORED. MVS storage requirements have decreased below the threshold value.
  • UNCHANGED. MVS storage requirements have not changed in relations to the threshold value. The MVS storage requirements are still above the threshold or still below the threshold.

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOCK_FAILED
  • LOOP
  • RESUME_FAILURE
The following values are returned when RESPONSE is INVALID:
  • INVALID_FUNCTION
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_SMNTmvs_storage_notify.html | Timestamp icon Last updated: Monday, 5 June 2017