The inquire_task_storage call – IBM SC33-1683-02 User Manual

Page 399

Advertising
background image

INQUIRE_SHORT_ON_STORAGE

DFHSMSRX [CALL,]

[CLEAR,]

[IN,

FUNCTION(INQUIRE_SHORT_ON_STORAGE),]

[OUT,

SOS_ABOVE_THE_LINE(NO|YES),

SOS_BELOW_THE_LINE(NO|YES),

RESPONSE (name1 | *),

REASON (name1 | *)]

SOS_ABOVE_THE_LINE(NO|YES),

returns YES if CICS is currently short-on-storage in any of the DSAs above the
16MB line, and NO if not.

SOS_BELOW_THE_LINE(NO|YES),

returns YES if CICS is currently short-on-storage in any of the DSAs below the
16MB line, and NO if not.

RESPONSE and REASON values for
INQUIRE_SHORT_ON_STORAGE:

RESPONSE

REASON

OK

None

DISASTER

None

KERNERROR

None

The INQUIRE_TASK_STORAGE call

INQUIRE_TASK_STORAGE enables you to request details of all elements of
task-lifetime storage belonging to a task. You can specify the transaction number of
the task explicitly on the call, or let it default to the current task.

INQUIRE_TASK_STORAGE

DFHSMMCX [CALL,]

[CLEAR,]

[IN,

FUNCTION (INQUIRE_TASK_STORAGE),

[TRANSACTION_NUMBER(name4 | (Rn) | *),]

ELEMENT_BUFFER(buffer-descriptor),

LENGTH_BUFFER(buffer-descriptor),]

[OUT,

NUMBER_OF_ELEMENTS(name4 | (Rn) | *),

RESPONSE (name1 | *),

REASON (name1 | *)]

ELEMENT_BUFFER(buffer-descriptor)

defines the address and length of a buffer into which CICS returns a list of start
addresses of all the elements of task-lifetime storage belonging to either the
specified task or, by default, the current task.

The start addresses returned do not include the leading check zone. For a
description of a buffer descriptor, see 299.

LENGTH_BUFFER(buffer-descriptor)

defines the address and length of a buffer into which CICS returns a list of the

storage control functions

Chapter 3. The user exit programming interface (XPI)

367

|
|

|
|
|
|

|
|

|
|

Advertising