CEEOPXI

C library interface: pthread_mutexattr_init(), pthread_rwlockattr_init()

CEEOPXI initializes the mutex attributes or read-write lock attributes object specified by attr_object. Upon successful completion of this function, the attributes object is set to this implementation's default. For attribute values, see CEEOPXS.

Syntax

void CEEOPXI (attr_object, lock_type, [fc])
CEE_LOCKATTR    *attr_object;
INT4            *lock_type;
FEED_BACK       *fc;
CEEOPXI
Call this CWI interface as follows:
L     R15,CEECAALEOV-CEECAA(,R12)     CAA address is in R12
L     R15,0324(,R15)
BALR  R14,R15
attr_object (input)
The caller-provided attributes object.
lock_type (input)
A full word integer with the following defined values:
  • X'00000000' = mutex
  • X'00000001' = read-write lock
fc (output/optional)
The feedback code returned by the service. It indicates the degree of success in initializing the new attributes object.

The following message identifiers and associated severities can be returned by the service in the feedback code fc.

Condition Description category Description value
CEE000 Severity 0
Msg_No 0000
Message The service completed successfully.
CEE4S9 Severity 3
Msg_No 5001
Message The service is unavailable unless POSIX(ON) runtime option specified and z/OS UNIX System Services are started.
CEE5I7 Severity 3
Msg_No 5703
Message Address exception accessing pthread_mutexattr_t object specified by attr_object.
CEE5I8 Severity 4
Msg_No 5704
Message Address exception while referencing storage allocated by mutex attribute initialization for pthread_mutexattr_t object specified by attr_object.
CEE5IG Severity 3
Msg_No 5712
Message The pthread_mutexattr_t object specified by attr_object was already initialized.
CEE5IH Severity 3
Msg_No 5713
Message Insufficient storage to initialize the pthread_mutexattr_t object specified by attr_object.
CEE5IL Severity 4
Msg_No 5717
Message Unable to free storage allocated by mutex attribute initialization for pthread_mutexattr_t object specified by attr_object.
CEE5K6 Severity 3
Msg_No 5766
Message An addressing exception occurred referencing a lock attribute object.
CEE5K7 Severity 4
Msg_No 5767
Message An addressing exception occurred referencing system storage allocated by lock attributes object initialization.
CEE5KF Severity 3
Msg_No 5775
Message The pthread_rwlockattr_t object specified by attr_object was already initialized.
CEE5KG Severity 3
Msg_No 5776
Message Insufficient storage to initialize the pthread_rwlockattr_t object specified by attr_object.
CEE5KK Severity 4
Msg_No 5780
Message Unable to free storage allocated by lock attribute initialization for attributes object specified by attr_object.