NAM SET

Defines or updates user control and user variable records.

Type

CL/SuperSession operator command

Format

NAM SET majorkey [varname:text] [varname:text] ... [EXPIRE=nn] [PASSWORD=pswd]

majorkey: Specifies the 1–8 character user ID or terminal ID for user control records, or a variable name for variable control records.

varname:text: Specifies a variable name (minor key) for a record and the text associated with the variable name. The variable name and the maximum length of the text field must first be defined to the database with the NAM DECLARE command.

nn: Specifies the number of times the user control record can be accessed before a change of password is required. The default is 0. This parameter is in effect only when you are using the NAM database for entry validation.; For security reasons, all passwords set in the NAM database expire the first time a user logs on. The user must then set a new password. If you set EXPIRE=0, the password never expires after the initial logon.

pswd: Specifies a 1–8 character password associated with a user ID, and creates a user control record. You must specify the PASSWORD parameter to use the NAM database for entry validation.; The user control record maintains the last 8 passwords for each user. When a user changes passwords, the new password cannot match any of the 8 previous passwords.

Usage Notes

To erase the contents of a variable, enter:
```
   NAM  SET  majorkey  varname:
```
This sets the variable name to null.
Do not use NAM SET to define string variables. NAM SET only allows single tokens for set variables. To set a global variable, write a dialog using VPUT.
You must specify at least one of the optional arguments. If not, the following message is generated:
```
   KLKSC002 REQUIRED OPERAND OMITTED:  COMMAND(NAM) ''
```

Example

To create a user control record for user ID SYSP02:

   NAM SET SYSP02 PASSWORD=SYSP02

See Also