__server_classify_create() — Create a classify area

Standards

Standards / Extensions	C or C++	Dependencies
z/OS® UNIX	both

Format

#include <sys/server.h>

server_classify_t __server_classify_create(void);

General description

The __server_classify_create() function creates a classify data area to be used on a subsequent __server_pwu() or CreateWorkUnit() call. The resulting classify data area can be filled in by calls to the __server_classify() function. The information in the classify area is used to establish the Transaction class, Transaction Name, user ID, and subsystem parameters for the __server_pwu() call or to establish the classification rules for the CreateWorkUnit() call.

The resulting classify area is specific to the calling thread. Use of the classify area by another thread can lead to unpredictable results.

Returned value

If successful, __server_classify_create() returns a classify_t which is a handle to the classify area.

If unsuccessful, __server_classify_create() returns -1 and sets errno to one of the following values:

Error Code: Description
ENOMEM: Not enough storage is available.

Related information

The classify data area created by this function can be used without serialization only by the creating thread. In addition, storage for this structure is automatically freed at thread termination.