IMSCALL command (X'C803')

Use the distributed data management (DDM) architecture IMSCALL command to issue DL/I calls for IMS DB system services.

Format

Read syntax diagramSkip visual syntax diagramDSSHDRLLCPCALLNAMEIOAREA

Parameters

DSSHDR
The 6-byte header that contains information about the data stream structure (DSS).
LL
The length specified as a 2-byte binary integer. This length includes LL and CP.
CP
X'C803', the 2-byte codepoint of the IMSCALL command.
CALLNAME
A required character string (codepoint is X'C90C') that represents the type of the DL/I call that is made.
IOAREA
An optional parameter in byte array (codepoint is X'C90B') that specifies the input and output area.

Usage

The IMSCALL command issues DL/I calls for IMS DB system services in the following format:
Read syntax diagramSkip visual syntax diagramcall_nameINAIBIOAREA

Chained command objects

INAIB (X'CC01')
The AIB data to send from the source to the target server.

Positive reply messages

In response to the IMSCALL command, the IMS target DDM server returns to the source server the following reply message:

IMSCALLRM (X'CA04')
Contains the results of the IMSCALL command. The results can indicate the success or failure of the DL/I call for IMS DB system services.

Error reply messages

In response to the OPNQRY command, the IMS target DDM server can return to the source DDM server the following error reply messages:

Table 1. Possible reply messages for the OPNQRY command
Codepoint of reply message Name of reply message Meaning of reply message
X'1232' AGNPRMRM Permanent agent error
X'124C' SYNTAXRM Data stream syntax error
X'1251' PRMNSPRM Parameter not supported
X'1252' VALNSPRM Parameter value not supported