MF_CLIENT_STATE_ALLOCATE

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
 ...