Generate Profile Token From Profile Token (QSYGENFT, QsyGenPrfTknFromPrfTkn) API
Required Parameter Group for QSYGENFT:
| 1 | New profile token | Output | Char(32) |
| 2 | From profile token | Input | Char(32) |
| 3 | Time out interval | Input | Bin(4) |
| 4 | New profile token type | Input | Char(1) |
| 5 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: Yes
Syntax for QsyGenPrfTknFromPrfTkn:
#include <qsyptkn.h>
void QsyGenPrfTknFromPrfTkn
(unsigned char *New_profile_token,
unsigned char *From_profile_token,
int *Time_out_interval,
char *New_profile_token_type,
void *Error_code);
Service Program: QSYPTKNDefault Public Authority: *USE
Threadsafe: Yes
The Generate Profile Token From Profile Token (OPM, QSYGENFT; ILE, QsyGenPrfTknFromPrfTkn) API generates a profile token using an existing profile token. The existing profile token must be a valid, multiple-use, regenerable profile token. The new profile token will represent the same user and group information as the original profile token.
Authorities and Locks
- API Public Authority
- *USE
Required Parameter Group
- Profile token
- OUTPUT; CHAR(32)
The profile token that is generated.
- From profile token
- INPUT; CHAR(32)
The multiple-use, regenerable profile token used to generate the new profile token.
- Time out interval
- INPUT; BINARY(4)
The time in seconds before the new profile token times out.
You can specify one of the following values:
-1 Use system default value (3600 seconds) 1-3600 Time out value in second.
- New profile token type
- INPUT; CHAR(1)
You can specify one of the following values:
1 Single-use profile token. A single-use profile token can be used only on the Set To Profile Token (QSYSETPT; QsySetToProfileToken) API once and cannot be used to generate new profile tokens. 2 Multiple-use profile token. A multiple-use profile token can be used on the Set To Profile Token (QSYSETPT; QsySetToPrfTkn) API an unlimited number of times, but cannot be used to generate new profile tokens. 3 Multiple-use, regenerable profile token. A multiple-use, regenerable profile token can be used on the Set To Profile Token (QSYSETPT; QsySetToPrfTkn) API an unlimited number of times and can be used to generate a new single-use, multiple-use, or multiple-use, regenerable profile token.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Error Messages
| Message ID | Error Message Text |
|---|---|
| CPF2225 E | Not able to allocate internal system object. |
| CPF2274 E | Profile token not valid. |
| CPF229F E | Profile token not valid type. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF3C36 E | Number of parameters, &1, entered for this API was not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF4AAA E | Maximum number of profile tokens have been generated. |
| CPF4AAB E | Time out value not valid. |
| CPF4AAD E | Profile token type not valid. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
API introduced: V4R5
[ Back to top | Security APIs | APIs by category ]