Program link calls

For all program link calls, fill in the required fields in the ECI parameter block (CTG_ECI_PARMS structure). All unused fields should be set to zero.

The eci_call_type field must be set to ECI_SYNC or ECI_ASYNC and the eci_version field must be set to ECI_VERSION_2A. The constant ECI_VERSION_2 is provided for compatibility with existing applications only and should not be used for new applications.

To specify a user ID and password or password phrase for the program link call, set the eci_userid_ptr and eci_password_ptr fields.

Program links calls with a COMMAREA

When calling a COMMAREA-based CICS program, provide a pointer to the COMMAREA data in the eci_commarea field and the COMMAREA length in the eci_commarea_length field.

The commarea_outbound_length and commarea_inbound_length fields can be used to limit the amount of data sent between the application and the CICS Transaction Gateway. For example, if there is a large difference between the size of the data that the CICS program reads from the COMMAREA and the size of the data that the CICS program writes to the COMMAREA.

To perform the program link call, call the CTG_ECI_Execute function, passing a Gateway token and a pointer to the CTG_ECI_PARMS structure:

int Response;
Response = CTG_ECI_Execute(gatewayToken, &EciBlock); 

Program link calls with a channel

When calling a channel-based CICS program, create the channel and any required containers and then set the channel field of the ECI parameter block. For more information see Using channels and containers in ECI V2 applications.

To perform the program link call, call the CTG_ECI_Execute_Channel function, passing a Gateway token and a pointer to the CTG_ECI_PARMS structure:

int Response;
Response = CTG_ECI_Execute_Channel(gatewayToken, &EciBlock); 

All unused fields must be set to zero.


Information Information

Feedback


Timestamp icon Last updated: Tuesday, 19 November 2013


https://ut-ilnx-r4.hursley.ibm.com/tgzos_latest/help/topic/com.ibm.cics.tg.zos.doc//progdezos/pgmlnkz2.html