Restores a previously saved or allocated record which matches the client identifier.
call "MF_CLIENT_STATE_RESTORE " using client-id client-state client-length server-status
Using call prototype (see Library Routines - Key) | Picture (32-bit systems) | |
---|---|---|
client-id | pic x(n). | pic x(30). |
client-state | cblt-x4-compx | pic x(4) comp-x. |
client-length | See Comments. | |
server-status | cblt-x1-compx | pic x comp-x. |
client-id | The client identifier. |
client-state | The state information to be saved. See Comments. |
client-length | The length of the empty record for the state information. |
client-state | The state information to be saved. See Comments. |
server-status | The status of the operation. See State Maintenance Routines Status. |
On entry, client-length is the length of the buffer. On exit, client-length returns the length of the data recovered. The data is truncated to fit the client-length specified on entry.
You can define any format for client-state records. Define the length of the client-state record in the client-length field.
working-storage section. ... 01 client-id pic x(30). 01 client-length pic xxxx comp-x. 01 state-status pic x comp-x. 01 client-state. 03 user-preferences pic x(10). 03 user-selection-list pic x(80). ... procedure division. ... call "MF_CLIENT_STATE_RESTORE" using client-id client-state client-length state-status ...