Storage manager domain’s generic formats

Table 98 shows the generic formats owned by the storage manager domain, and shows the functions performed on the calls.

Table 98. Generic formats owned by the storage manager domain
Format Calling module Function
SMNT
DFHSMSY
DFHSJSM
STORAGE_NOTIFY
MVS_STORAGE_NOTIFY

In the descriptions of the formats that follow, the "input" parameters are input not to the storage manager domain, but to the domain being called by the storage manager. Similarly, the "output" parameters are output by the domain that was called by the storage manager domain, in response to the call.

Format SMNT, STORAGE_NOTIFY function

The STORAGE_NOTIFY function of SMNT format is used to notify free storage above and below the 16MB line.

Input parameters

DSAS_CONSTRAINED YES|NO
indicates whether any DSA is currently constrained due to lack of free storage.
FREE_BYTES_CDSA
is the largest free area available (in bytes) in the CICS® DSA below the 16MB line (not including the cushion).
FREE_BYTES_UDSA
is the largest free area available (in bytes) in the user-key DSA below the 16MB line (not including the cushion).
FREE_BYTES_SDSA
is the largest free area available (in bytes) in the shared user-key DSA below the 16MB line (not including the cushion).
FREE_BYTES_RDSA
is the largest free area available (in bytes) in the read-only DSA below the 16MB line (not including the cushion).
FREE_BYTES_ECDSA
is the largest free area available (in bytes) in the CICS DSA above the 16MB line (not including the cushion).
FREE_BYTES_EUDSA
is the largest free area available (in bytes) in the user-key DSA above the 16MB line (not including the cushion).
FREE_BYTES_ESDSA
is the largest free area available (in bytes) in the shared user-key DSA above the 16MB line (not including the cushion).
FREE_BYTES_ERDSA
is the largest free area available (in bytes) in the read-only DSA above the 16MB line (not including the cushion).

Output parameters

RESPONSE
is the domain’s response to the call. It can have any of these values:
OK|EXCEPTION|DISASTER|INVALID|KERNERROR|PURGED
[REASON]
is returned when RESPONSE is DISASTER or INVALID. Possible values are:
RESPONSE Possible REASON values
DISASTER
LOOP
ABEND
INVALID INVALID_FUNCTION

Format SMNT, MVS_STORAGE_NOTIFY function

The MVS_STORAGE_NOTIFY function of SMNT format is used to notify a domain when MVS storage usage becomes excessive, so that the target domain can take action to release MVS storage or to limit its future MVS storage requirements. It is also used to notify the domain when MVS storage is no longer constrained, so the domain can return to normal operation. There are different notifications for a breach of the threshold value for MVS storage, and for a breach of the reserved MVS storage cushion, the latter being a more serious condition.

Input parameters

THRESHOLD
indicates the relationship between MVS storage requirements and the threshold value for MVS storage. It can have the values:
NEWLY_BREACHED|NEWLY_RESTORED|UNCHANGED
NEWLY_BREACHED indicates that MVS storage requirements have increased above the threshold value since the last time the SM domain issued a MVS_STORAGE_NOTIFY. NEWLY_RESTORED indicates that MVS storage requirements have decreased below the threshold value since the last time the SM domain issued a MVS_STORAGE_NOTIFY. UNCHANGED indicates that since the last time the SM domain issued a MVS_STORAGE_NOTIFY, no change has occurred in the MVS storage requirements relative to the threshold value. That is, if the MVS storage requirements were previously above the threshold, they are still above the threshold, and if they were previously below the threshold, they are still below the threshold.
CUSHION
indicates the status of the reserved MVS storage cushion. It can have the values:
NEWLY_BREACHED|NEWLY_RESTORED|UNCHANGED
NEWLY_BREACHED indicates that the cushion has been partially freed to satisfy requirements for MVS storage since the last time the SM domain issued a MVS_STORAGE_NOTIFY. NEWLY_RESTORED indicates that CICS has managed to reallocate the reserved storage cushion since the last time the SM domain issued a MVS_STORAGE_NOTIFY. UNCHANGED indicates that since the last time the SM domain issued a MVS_STORAGE_NOTIFY, no change has occurred in the state of the cushion: it is still partially freed, or still intact.

Output parameters

RESPONSE
is the domain’s response to the call. It can have any of these values:
OK|DISASTER|INVALID|KERNERROR|PURGED
[REASON]
is returned when RESPONSE is DISASTER or INVALID. Possible values are:
RESPONSE Possible REASON values
DISASTER
LOOP
ABEND
LOCK_FAILED
RESUME_FAILURE
INVALID INVALID_FUNCTION
[[ Contents Previous Page | Next Page Index ]]