Password File Maintenance

The password file contains details of user-IDs and passwords that the Fileshare Server uses when Fileshare Password Security is enabled. Most of the information in the password file is encrypted for security reasons, and so you can only add records to and remove records from the password file using the Password File Maintenance Utility. (User-IDs are not encrypted, allowing an administrator to view a list of valid users by browsing the file.

However, you can add extra security by storing this file in a Secrets vault (see Vault Facility for more information). To use this extra layer of security, use the /uv parameter when starting Fileshare, as detailed in Fileshare Server Configuration Options.

UNIX:

Note:

In this section, options are shown starting with a forward slash (/). This is how you specify the options on Windows. On UNIX, use the hyphen (-) character instead of the forward slash.
Filenames are shown using the Windows naming convention. On UNIX, use the UNIX filenaming conventions.

Use the /pf (password file) option to add or remove entries in the password file, for example:

fs /pf pass.dat [options]

This invokes password file maintenance and appends the specified options to the password file pass.dat. If this file does not exist, it is created.

The following options are available:

```
/u user-ID
```
```
/pw password
```
These add the specified user-ID and password to the password file. Both user-ID and password are case-sensitive and can be up to 100 characters in length.
Note: The username and password does not support the following characters "/\-". In addition, you should only use characters that are invariant when converted to EBCDIC.
```
[/e]
```
This erases the record from the password file and is the only way to remove a record once the password file has been created.
```
[/clp]
```
The /clp option is used to upgrade password files created using Visual COBOL prior to version 3.0. Upgraded password files can support long usernames and passwords up to 100 characters in length.

Note: Micro Focus recommend that you take a backup of your password file before you upgrade.

Examples

fs /pf pass.dat /u pkel /pw fishwife

This example invokes password file maintenance, creates or updates a password file called pass.dat and adds a user-ID of pkel and password of fishwife.

fs /pf pass.dat /clp

This example upgrades a password file that was created using Visual COBOL prior to version 3.0. The upgraded password file now supports long usernames and passwords.