WRITE
Monitor programs can call the WRITE function to write data to the instrumentation facility interface.
Authorization
WRITE requests are not checked
for authorization, but a Db2 trace
must be active for the IFCID being written. If the IFCID is not active,
the request is denied. For a WRITE request, no other authorization
checks apply. Syntax and options
WRITE calls to the instrumentation facility interface have the following syntax:
CALL DSNWLI,('WRITE ',ifca,output-area,ifcid-area),VLThe
write function must specify an IFCID area. The data that is written
is defined and interpreted by your site.
- ifca
- Contains information regarding the success of the call.
- output-area
- Contains the varying-length of the monitor program's data record to be written.
- ifcid-area
- Contains the IFCID of the record to be written. Only the IFCIDs that are shown in the following table are supported by the WRITE function. If an invalid IFCID is specified or the IFCID is not active (not started by a TRACE command), no data is written.
| IFCID (decimal) | IFCID (hex) | Trace type | Class | Comment |
|---|---|---|---|---|
| 0146 | 0092 | Auditing | 9 | Write to IFCID 146 |
| 0151 | 0097 | Accounting | 4 | Write to IFCID 151 |
| 0152 | 0098 | Statistics | 2 | Write to IFCID 152 |
| 0153 | 0099 | Performance | 1 | Background events and write to IFCID 153 |
| 0154 | 009A | Performance | 15 | Write to IFCID 154 |
| 0155 | 009B | Monitoring | 4 | Write to IFCID 155 |
| 0156 | 009C | Global (Serviceability) | 6 | Reserved for user-defined serviceability trace |
| 0392 | 0188 | Auditing | 9 | Write to IFCID 392 |
