MF_CLIENT_STATE_ALLOCATE

Allocates a client identifier.

Note: This routine is supported for native COBOL only.

Syntax:

call "MF_CLIENT_STATE_ALLOCATE" using  client-id
                                       client-length
                                       server-status

Parameters:

	Using call prototype (see Key)	Picture (32-bit systems)
`client-id`	pic x(30).	pic x(30).
`client-length`	cblt-x4-compx	pic x(4) comp-x.
`server-status`	cblt-x1-compx	pic x comp-x.

On Entry:

`client-id`	The client identifier. See `Comments` below.
`client-length`	The length of the empty record for the state information.

On Exit:

`client-id`	The client identifier. See `Comments` below.
`server-status`	The status of the operation. See State Maintenance Routines Status.

Comments:

This routine:

Allocates a new empty record for the state information, with the length given in client-length.
Returns a new client-id, and allocates an empty record, if the value passed in client-id is set to spaces. Otherwise, if client-id is set to a valid client identifier, this routine allocates an empty record with that client identifier.

Example:

 working-storage section. 
 ...
 01 client-id                pic x(30).
 01 client-length            pic xxxx comp-x.
 01 state-status             pic x comp-x.
 ...
 procedure division. 
 ...
     call "MF_CLIENT_STATE_ALLOCATE"
          using client-id client-length state-status
 ...