__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.