CMSF — Set_Fill


CMSF (conversation_ID, fill, return_code) [LOGGING log_byte]

Where

conversation_ID (character input) specifies the conversation identifier of the desired conversation.

fill (numeric input) specifies whether the program is to receive data in terms of the logical-record format of the data or independent of the logical-record format. The fill variable can have one of the following values:

CM_FILL_LL
CM_FILL_BUFFER

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. The log_byte remains active until another CPI-C statement is issued. 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 CMSF statement to simulate the CPI-C CMSF call, which is used to set the fill characteristic for a given conversation. The CMSF statement overrides the value that was assigned when the CMINIT or CMACCP statement was issued.

Note: This statement applies only to basic conversations. The fill characteristic is ignored for mapped conversations.

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