MF_CLIENT_STATE_ALLOCATE
Allocates a client identifier.
Syntax:
call "MF_CLIENT_STATE_ALLOCATE" using client-id
client-length
server-status
Parameters:
|
Using call prototype (see Library Routines - 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:
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
...
See Also: