READS

Authorization

The primary authorization ID or one of the secondary authorization IDs of the process running the application program must have MONITOR1 or MONITOR2 privilege. If neither the primary authorization ID nor one of the secondary authorization IDs has authorization, the request is denied.

READS requests are checked for authorization once for each user (ownership token) of the thread. (Several users can use the same thread, but an authorization check is performed each time the user of the thread changes.)

If you use READS to obtain your own data (IFCID 0124, 0147, 0148, or 0150 not qualified), no authorization check is performed.

Syntax and options

READS calls to the instrumentation facility interface have the following syntax:

CALL DSNWLI,('READS   ',ifca,return-area,ifcid-area,qual-area),VL

ifca

Contains information about the status of the READS call.

return-area

Contains the varying-length records that are returned by the instrumentation facility. If the specified return area is too small to hold all of the records that are returned, it contains as many records as can fit. The monitor program obtains the return area for READS requests in its private address space.

ifcid-area

Contains the IFCIDs of the information that you want. The number of IFCIDs can be variable. If the length specification of the IFCID area is exceeded or a value of X'FFFF' is encountered, the list is terminated. Each IFCID value must be a two-byte hexadecimal value in the range X'0001' (decimal 1) to X'01FF' (decimal 511). If an invalid IFCID is specified, no data is retrieved.

qual-area

The address of the qualification area where the monitor program can specify constraints on the data that is to be returned. This parameter is optional, and is used only on READS requests.