RCMD call

Format

Parameters

aib

Specifies the application interface block (AIB) used for this call. This parameter is an input and output parameter.

The following fields must be initialized in the AIB:

AIBID

Eye catcher. This 8-byte field must contain DFSAIBbb.

AIBLEN

AIB lengths. This field must contain the actual length of the AIB that the application program obtained.

AIBOALEN

I/O area length. This field must contain the length of the I/O area that is specified in the call list. This field is not changed by IMS.

AIBOAUSE

Length of data returned in the I/O area. This parameter is an output parameter.

When partial data is returned because the I/O area is not large enough, AIBOAUSE contains the length required to receive all of the data and AIBOALEN contains the actual length of the data.

i/o area

Specifies the I/O area to use for this call. This parameter is an output parameter. The I/O area should be large enough to hold the largest command response segment passed from IMS to the AO application. If the I/O area is not large enough for all of the information, partial data is returned in the I/O area.

Usage

RCMD lets an AO application retrieve the second and subsequent command response segments resulting from an ICMD call.

Related reading: For more information on the AOI exits, see IMS Version 15 Exit Routines.

RCMD is also supported from a CPI-C driven application program.

RCMD retrieves only one response segment at a time. If you need additional response segments, you must issue RCMD once for each response segment issued by IMS.

Restrictions

An ICMD call must be issued before an RCMD call.