| 1 | Entry identifier data | Input | Char(*) |
| 2 | Length of entry identifier | Input | Binary(4) |
| 3 | Entry identifier format name | Input | Char(8) |
| 4 | Authentication entry data | Input | Char(*) |
| 5 | Length of authentication entry | Input | Binary(4) |
| 6 | Entry data format name | Input | Char(8) |
| 7 | Error code | I/O | Char(*) |
The Change NetWare Authentication Entry (QfpzChgNtwAutE) API changes the authentication information in the specified authentication entry. The format that is specified for the authentication entry must correspond to the server type of the existing entry.
The authentication entry to be changed. The content and format of this structure are determined by the format name. See Format of Authentication Entry Identifier for a description of these formats.
The length of the entry identifier data structure.
The content and format of the authentication entry identifier data.
The possible format names follow:
| AUTE0100 | NetWare Version 3.x server authentication entry identifier |
| AUTE0200 | NetWare Directory Services tree authentication entry identifier |
See Format of Authentication Entry Identifier for a description of these formats.
The changed authentication entry data. The content and format of this structure are determined by the format name. See Format of Authentication Entry Data for a description of these formats.
The length of the authentication entry data structure.
The content and format of the authentication entry input data. Each format corresponds to a type of authentication entry.
The possible format names follow:
| AUTD0100 | NetWare Version 3.x server authentication entry data |
| AUTD0200 | NetWare Directory Services tree authentication entry data |
See Format of Authentication Entry Data for a description of these formats.
The structure in which to return error information. For the format of the structure, see Error Code Parameter.
For details about the format of the entry identifier data, see the following sections. For details about the fields in each format, see Field Descriptions.
This format is used to identify a NetWare Version 3.x server authentication entry.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Offset to server name |
| 4 | 4 | BINARY(4) | Length of server name |
| 8 | 8 | CHAR(10) | User profile name |
| 18 | 12 | CHAR(6) | Reserved |
| CHAR(*) | Server name | ||
This format is used to identify a NetWare Directory Services tree authentication entry.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Offset to NDS tree name |
| 4 | 4 | BINARY(4) | Length of NDS tree name |
| 8 | 8 | CHAR(10) | User profile name |
| 18 | 12 | CHAR(6) | Reserved |
| CHAR(*) | NDS tree name | ||
For details about the format of the authentication entries, see the following sections. For details about the fields in each format, see Field Descriptions.
This format is used to specify the authentication entry data for a NetWare Version 3.x server authentication entry. This format must be used when entry identifier format AUTE0100 is used.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Offset to NetWare user name |
| 4 | 4 | BINARY(4) | Length of NetWare user name |
| 8 | 8 | BINARY(4) | Offset to password |
| 12 | C | BINARY(4) | Length of password |
| 16 | 10 | BINARY(4) | Reserved |
| CHAR(*) | NetWare user name | ||
| CHAR(*) | Password | ||
This format is used to specify the authentication entry data for a NetWare Directory Services tree authentication entry. This format must be used when entry identifier format AUTE0200 is used.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Offset to NDS context |
| 4 | 4 | BINARY(4) | Length of NDS context |
| 8 | 8 | BINARY(4) | Offset to NetWare user name |
| 12 | C | BINARY(4) | Length of NetWare user name |
| 16 | 10 | BINARY(4) | Offset to password |
| 20 | 14 | BINARY(4) | Length of password |
| 24 | 18 | BINARY(4) | Reserved |
| CHAR(*) | NDS context | ||
| CHAR(*) | NetWare user name | ||
| CHAR(*) | Password | ||
Length of NDS context. The length, in bytes, of the NDS context.
Length of NDS tree name. The length, in bytes, of the NDS tree name.
Length of NetWare user name. The length, in bytes, of the NetWare user name.
Length of password. The length, in bytes, of the password.
Length of server name. The length, in bytes, of the server name.
NDS context. For NDS trees, the directory context in which the user is defined.
The following special value may be used:
| *SAME | The value remains the same. |
NDS tree name. For NDS trees, the name of the directory tree to which the authentication entry applies.
The selected NDS tree name must be the same as the NDS tree name of an existing NetWare Directory Services tree authentication entry.
NetWare user name. The NetWare user name that is used to authenticate the user to the server.
The following special values may be used:
| *USRPRF | The NetWare user name is the same as the user profile name. |
| *SAME | The value remains the same. |
Offset to NDS context. The offset, in bytes, from the start of the input data area to the NDS context.
Offset to NDS tree name. The offset, in bytes, from the start of the input data area to the NDS tree name.
Offset to NetWare user name. The offset, in bytes, from the start of the input data area to the NetWare user name
Offset to password. The offset, in bytes, from the start of the input data area to the password.
Offset to server name. The offset, in bytes, from the start of the input data area to the server name.
Password. The password that is used to authenticate the user to the server.
The following special values may be used:
| *NONE | The system does not need password information to authenticate the user. |
| *STRNTWCNN | The system does not store the password information in the authentication entry. Use Start NetWare Connection (STRNTWCNN) command, with the correct password, to start a connection to a server. |
| *SAME | The value remains the same. |
Reserved. Set this field to binary zeros.
Server name. The name of the server to which the authentication entry applies.
The selected server name must be the same as the server name of an existing NetWare Version 3.x server authentication entry.
User profile name. The name of the user profile that contains the authentication entry.
You can use the following special value for the user profile name:
| *CURRENT | Use the current user profile. |
| Message ID | Error Message Text |
|---|---|
| CPF2204 E | User profile &1 not found. |
| CPF2217 E | Not authorized to user profile &1. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C1D E | Length specified in parameter &1 not valid. |
| CPF3C21 E | Format name &1 is not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
| FPE0211 E | Parameter length &1 not valid for field &2. |
| FPE0212 E | Field offset and length not within data. |
| FPE0215 E | Could not find authentication entry for &1. |
| FPE021F E | Data format &1 not valid with identifier format &2. |
| FPE0255 E | PASSWORD(*STRNTWCNN) required when QRETSVRSEC is 0. |
| Top | Security APIs | APIs by category |