Remove User Application Information (QsyRemoveUserApplicationInfo) API

Start of change


  Syntax for QsyRemoveUserApplicationInfo:
 #include <qsyusrin.h>

 void QsyRemoveUserApplicationInfo
        (char           *User_profile,
         char           *Application_information_ID,
         int            *Length_of_application_information_ID,
         void           *Error_code);

  Service Program: QSYUSRIN

  Default Public Authority: *USE

  Threadsafe: No

End of change

The Remove User Application Information (QsyRemoveUserApplicationInfo) API removes the specified application information from the specified user profile.

The Change User Profile exit programs are not called from this API.


Authorities and Locks

If the user profile parameter is not *CURRENT or the user profile currently running, then the user profile that calls this API must have *SECADM special authority and *OBJMGT and *USE authorities to the user profile.


Required Parameter Group

User profile
INPUT; CHAR(10)

The user profile for which the application information will be removed. The special value *CURRENT may be specified to remove application information for the user profile that calls this API.

Application information ID
INPUT; CHAR(*)

The ID for the application information to be removed. The following can be specified for the application information ID:

generic*
All application information IDs that have IDs beginning with the generic string will be removed.
application information ID
Specific application information ID will be removed.

Length of application information ID
INPUT; BINARY(4)

The length of the application information ID that is specified in the application information ID parameter. The length of the application information ID must be a value from 1 to 200.

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
CPF2204 E User profile &1 not found.
CPF2213 E Not able to allocate user profile &1.
CPF226C E Not authorized to perform function.
CPF3CF1 E Error code parameter not valid.
CPF3CF2 E Error(s) occurred during running of &1 API.
CPF3C1D E Length specified in parameter &1 not valid.
CPF3C90 E Literal value cannot be changed.
CPF4AA2 E Application information ID &1 does not exist.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


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