Set_Partner_LU_Name

The Set_Partner_LU_Name call (function name cmspln) is issued by the invoking program to specify the partner LU name. This call overrides the partner LU name derived from the side information when the Initialize_Conversation call was issued. This call cannot be issued after Allocate has been issued. Issuing this call has no effect on the side information itself.

CM_ENTRY Set_Partner_LU_Name(
  unsigned char FAR *conversation_ID,  
  unsigned char FAR *partner_LU_name,  
  CM_INT32 FAR *partner_LU_name_length,  
  CM_INT32 FAR *return_code            
);
 

Parameters

conversation_ID

Supplied parameter. Specifies the identifier for the conversation. The value of this parameter was returned by Initialize_Conversation.

partner_LU_name

Supplied parameter. Specifies the starting address of the partner LU name. The mode name can contain up to 17 ASCII characters. The allowed characters are:

• Uppercase letters.
• Numerals 0 through 9.

The partner LU name can be either:

• An alias consisting of one through eight characters.
• A fully qualified network name consisting of from 2 through 17 characters. A period separates the network identifier (which can be from zero through eight characters) from the network LU name (which can be from one through eight characters). If the network identifier is zero characters long, the period is still required.

The partner LU name must match the name of a partner LU established during configuration.

partner_LU_name_length

Supplied parameter. Specifies the length of the partner LU name. The range is from 1 through 17.

return_code

The code returned from this call. The valid return codes are listed below.

Return Codes

cm_ok

Primary return code; the call executed successfully.

cm_program_state_check

Primary return code; the conversation is not in INITIALIZE state.

cm_program_parameter_check

Primary return code; one of the following occurred:

• The value specified by conversation_ID is invalid.
• The value specified by partner_LU_name_length is out of range (greater than 17 or less than 1).

cm_product_specific_error

Primary return code; a product-specific error occurred and has been logged in the product's error log.

State Changes

The conversation must be in INITIALIZE state.

There is no state change.

Remarks

Specifying an invalid value for partner_LU_name is not detected until Allocate is issued.