| 1 | Share name | Input | Char(12) |
| 2 | Path name | Input | Char(*) |
| 3 | Length of path name | Input | Binary(4) |
| 4 | CCSID encoding of path name | Input | Binary(4) |
| 5 | Text description | Input | Char(50) |
| 6 | Permissions | Input | Binary(4) |
| 7 | Maximum users | Input | Binary(4) |
| 8 | Error code | I/O | Char(*) |
| 9 | CCSID used for text conversion | Input | Binary(4) |
| 10 | Enable text conversion | Input | Char(1) |
| 11 | File extension table | Input | Char(*) |
| 12 | Number of table entries | Input | Binary(4) |
The Change File Server Share (QZLSCHFS) API changes the information about a shared portion of the integrated file system.
To use this API, you must have *IOSYSCFG special authority or own the integrated file system directory.
The name of the share to be changed.
The path in the integrated file system to be shared with the network. A forward slash, '/', is required as the first character.
The length, in bytes, of the path name. The maximum length is 1024 bytes.
The coded character set ID (CCSID) of the path name and the file extension table entries. 0 will result in the current job CCSID being used.
The text description for this share.
The access available from the network for this share. Possible values follow.
| 1 | Read only |
| 2 | Read/Write |
The maximum number of users who can concurrently access this share.
This value must be greater than or equal to zero, or -1 (X'FFFFFFFF'), which means there is no limit to the number of users who can concurrently use this share.
The structure in which to return error information. For the format of the structure, see Error code parameter.
The client CCSID that is used for text file data conversion. Text file data conversion is performed using this CCSID and the current CCSID of the system file.
A value of 0 indicates that the user would like to use the currently configured CCSID for the server. See Get Related Default CCSID (CDRGRDC) API for additional information on related CCSIDs.
If the CCSID used for text conversion parameter is omitted, the API assumes that no change is requested and the current value remains unchanged.
Whether the server enables text conversion for this share. Possible values are:
| 0 | Text conversion not enabled |
| 1 | Text conversion enabled |
| 2 | Text conversion enabled and mixed data is allowed |
If the enable text conversion parameter is omitted, the API assumes that no change is requested and the current value remains unchanged.
An array of table entries. There is no limit to the number of values specified. For the layout of a table entry, see Format of File Extension Table Entry.
If the file extension table parameter is omitted, the API assumes that no change is requested and current values remain unchanged. If the file extension table parameter is specified, the number of table entries parameter must be specified also.
The number of table entries.
If the number of table entries parameter is left out, the API assumes that no change is requested and the current value remains unchanged. If the number of table entries parameter is specified, the file extension table parameter must be specified also.
The following table shows the format of a file extension table entry. For detailed descriptions of the fields in the table, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Length of file extension |
| 4 | 4 | CHAR(46) | File extension |
File extension. A file extension string that is null-terminated. Possible values include:
| * | The server will convert all files. |
| . | The server will convert all files without an extension. |
| TXT, .TXT | The server will convert anything ending in .TXT (that is, a.TXT, a.b.c.TXT). |
| ..TXT, ...TXT, ......TXT | Extensions with more than one leading period will have no effect on the server. No translation will be done. |
| T*T | The server will convert all files ending with an extension that substitutes any number of characters for the * wild card (that is, a.T123T, b.TXT, c.TEST). |
| T?T | The server will convert all files ending with an extension that substitutes any one character for the ? wild card (that is, a.T1T, b.TXT). |
Length of file extension. The size in bytes of the file extension. The length does not include the byte used for null-termination.
| Message ID | Error Message Text |
|---|---|
| CPF3C1E E | Required parameter &1 omitted. |
| CPF3C36 E | Number of parameters, &1, entered for this API was not valid. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3CF2 E | Error(s) occurred during running of &1 API. |
| CPFA0D4 E | File system error occurred. |
| CPFB682 E | API &1 failed with reason code &2. |
| CPFB683 E | Data conversion failed for API &1. |
| CPFB684 E | User does not have the correct authority for API &1. |
| CPFB68A E | Error occurred while working with shared resource &2. |
| CPFB68B E | Character is not valid for value &3. |
| CPFB68D E | Length specified in parameter &2 for API &1 not valid. |
| CPFB693 E | Data conversion failed for &5 API. |
| CPIB685 E | Error occurred on IBM i Support for Windows Network Neighborhood (IBM i NetServer) request. |