Summary of input parameter requirements

Table 1 shows the input parameters for an ECI call, and, for each call type, whether the parameters are required (R), optional (O), or not applicable (-). Where a parameter is shown as optional or not-applicable an initial field setting of nulls is recommended. An asterisk (*) immediately following an R means that further details regarding applicability are given under the description of the parameter.

The following abbreviations are used in the Parameter column:
AN
async_notify
WF
win_fields
SW
sync_wait
Also, all named parameters have an eci_ prefix. Thus AN.WF.hwnd represents the eci_async_notify.win_fields.hwnd parameter.
The following 3-character abbreviations are used for the call types in the column headings of the table:
ANM
ECI_ASYNC_NOTIFY_MSG
ANS
ECI_ASYNC_NOTIFY_SEM
SAM
ECI_STATE_ASYNC_MSG
SAS
ECI_STATE_ASYNC_SEM
SYN
ECI_SYNC
SSN
ECI_STATE_SYNC
Table 1. Input parameters for CICS_ExternalCall — environment-dependent extensions
Parameter, eci_ ANM ANS SAM SAS SYN SSN
call_type R R R R R R
program_name R* R* - - R* -
userid R R - - R -
password R R - - R -
transid O O - - O -
commarea O O R* R* O R*
commarea_length O O R* R* O R*
timeout O O O O O O
extend_mode R R R R R R
AN.window_handle R* - R* - - -
AN.sem_handle - R - R - -
AN.WF.hwnd R* - R* - - -
AN.WF.hinstance R* - R* - - -
SW.hwnd - - - - R* R*
message_id R - R - - -
message_qualifier O O O O O O
luw_token R R R* R* R R*
version O O O O O O
system_name O O O O O O