CMALLC — Allocate


CMALLC (conversation_ID, return_code ) [LOGGING log_byte]

Where

conversation_ID (character input) is the conversation identifier of a conversation that has been initialized with a CMINIT statement.

return_code (numeric output) specifies the result of the statement execution.

log_byte is a 1-byte string constant or a string expression that specifies a byte of user data to be associated with this CPI-C statement during logging. log_byte is also associated with the FMH-5 data transmitted when a CMALLC successfully completes. The log_byte remains active until another CPI-C statement is issued. This byte gives users of the Response Time Utility a way to identify transactions from transmitted or received data when gathering statistics by the various user-defined "log_byte" categories. Only the first character or first two hexadecimal digits of the string expression are used. The default log_byte is X'00'.

Function

A program uses the CMALLC statement to simulate the CPI-C CMALLC call, which is used to start a conversation with its partner program.

Before issuing the CMALLC statement, a program has the option of issuing one or more of the following statements to set allocation parameters:

CMSCT — Set_Conversation_Type
CMSMN — Set_Mode_Name
CMSPLN — Set_Partner_LU_Name
CMSRC — Set_Return_Code
CMSSL — Set_Sync_Level
CMSTPN — Set_TP_Name

For more information on CMALLC and its parameters, refer to the Allocate (CMALLC) call description in the “Call Reference” chapter of Systems Application Architecture Common Programming Interface Communications Reference.