QsyRemoveValidationLstEntry()--Remove Validation List Entry API

 #include <qsyvldl.h>

 int QsyRemoveValidationLstEntry
        (Qsy_Qual_Name_T        *Validation_Lst,
         Qsy_Entry_ID_Info_T    *Entry_ID);

The QsyRemoveValidationLstEntry() function removes an entry from a validation list object. To identify an entry to be removed, there must be an exact match in the entry for the value that is specified in the Entry_ID parameter and the length of the entry ID. For example, an entry ID value of "SMITH" with a length of 5 would not remove an entry where the entry ID is "SMITH " and the length is 7.

Authorities

Validation List Object

*USE and *DLT

Validation List Object Library

*EXECUTE

Parameters

dt>Validation_Lst

(Input)

A pointer to the qualified object name of the validation list that contains the entry to remove. The first 10 characters specify the validation list name, and the second 10 characters specify the library. You can use these special values for the library name:

*CURLIB	The current library is used to locate the validation list. If there is no current library, QGPL (general purpose library) is used.
*LIBL	The library list is used to locate the validation list.

Entry_ID

(Input)

A pointer to the entry ID information. Qsy_Entry_ID_Info_T structure is as follows:

int	Entry_ID_Len	The number of bytes of data that is provided as the entry ID. Possible values are from 1 through 100.
unsigned int	Entry_ID_CCSID	An integer that represents the CCSID for the entry ID. Valid CCSID values are in the range 0 through 65535. This value is not used to remove the entry.
unsigned char	Entry_ID[100]	The data that is used to identify this entry in the validation list.

Return Value

Error Conditions

If QsyRemoveValidationLstEntry() is not successful, errno indicates one of the following errors:

Example

See Code disclaimer information for information pertaining to code examples.

The following example removes an entry for a user named FRED in the validation list object WEBUSRS.

#include <qsyvldl.h>

main()
{
  #define VLD_LST  "WEBUSRS   WEBLIB    "
  Qsy_Entry_ID_Info_T    entry_info;

  entry_info.Entry_ID_Len = 4;
  strncpy(entry_info.Entry_ID,"FRED",entry_info.Entry_ID_Len);

  if (0 != QsyRemoveValidationLstEntry(
                       (Qsy_Qual_Name_T *)&VLD_LST,
                       &entry_info))
     perror("QsyRemoveValidationLstEntry()");

}