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: QSYPTKN

  Default 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.

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.