Node:set-user-area, Next:, Previous:who-am-i, Up:Protocol Requests


set-user-area [57] (2) Recommended


        set-user-area [57] (( pers-no   :   Pers-No;
                              user-area :   Text-No ))
                -> ( );

This call sets the user-area field for the person pers-no in the database to the text user-area. The user area is used to store client data for a particular person. See The User Area, for more details.

Example: 

        1 49 7
        =1 25Hdavby@lage.lysator.liu.se 0000010000000000 00000000
           6 58 21 19 6 97 6 199 1 0 458 7 3 12 7 12 0 0 3 0 0 4
        1 57 7 11
        =1
        1 49 7
        =1 25Hdavby@lage.lysator.liu.se 0000010000000000 00000000
           6 58 21 19 6 97 6 199 1 11 458 7 71 2592 7 13 0 0 3 1 0 4

In this example the user area of person 7 is set to text number 11. The original user area was text numbers zero, which means that the person had no user area.

Error codes

login-first
Login required before issuing this call.
undefined-person
The person pers-no does not exist or is secret.
permission-denied
Not enough access to person pers-no to complete the call.