Remove All Profile Tokens (QsyRemoveAllPrfTkns) API

Start of change


  Syntax for QsyRemoveAllPrfTkns:
 #include <qsyptkn.h>

 void QsyRemoveAllPrfTkns
        (void           *Error_code);

  Service Program: QSYPTKN

  Default Public Authority: *USE

  Threadsafe: Yes

End of change

The Remove All Profile Tokens (QsyRemoveAllPrfTkns) API provides an interface to remove all profiles on the system. This may be useful if the maximum number of profile tokens have been generated for the system (message CPF4AAA was sent or a PS-M security audit entry was sent). The most likely reason for this to happen is that someone is attempting to lock up parts of the system by generating multitudes of profile tokens. This API provides an alternative to restarting the system. After calling this API, the administrator may want to analyze the audit log to determine who is attempting to lock up the system.


Authorities and Locks

API Public Authority
*USE
Special authority required
*ALLOBJ and *SECADM

Required Parameter

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
CPF222E E &1 special authority is required.
CPF2225 E Not able to allocate internal system object.
CPF3CF1 E Error code parameter not valid.
CPF3C90 E Literal value cannot be changed.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V4R4
Top | Security APIs | APIs by category