Remove Server Authentication Entry (QsyRemoveServerEntry) API

Syntax for QsyRemoveServerEntry:

 #include <qsysvrfn.h>

 void QsyRemoveServerEntry(
                char      User_profile[10],       
                char     *Server_name,          
                int       Length_of_server_name,             
                void     *Error_code);

  Service Program: QSYSVRFN

  Default Public Authority: *USE

  Threadsafe: No

The Remove Server Authentication Entry (QsyRemoveServerEntry) API removes server authentication information for use by application requesters in connecting to application servers.

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.

Parameters

User profile: INPUT; CHAR(10)
The user profile for which the server authentication entry will be removed. The special value *CURRENT may be specified to remove an entry for the user profile that calls this API.
Server name: INPUT; CHAR(*)
The name of the application server. The special value *ALL may be specified to indicate that all server authentication entries for the user profile that is specified in the user profile parameter are to be removed.
Length of server name: INPUT; BINARY(4)
The length of the server name that is specified in the server name parameter. The length of the server name 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.
CPF225E E	Server authentication entry does not exist.
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.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V4R2

[ Back to top | Security APIs | APIs by category ]