The LOG service can only be used in batch and API runs. The syntax of a request for the LOG service is
LOG request_type [parm1] [parm2] |
where
Table 63 LOG Service Request Types
Request Type |
Description |
---|---|
DATE |
Only records between the two dates specified are to be selected. If DATE is not specified, records of any date can be selected. The syntax of the request is DATE BETWEEN yymmdd AND yymmdd |
TIME |
Only records between the two times specified are to be selected. If DATE is not specified, the TIME parameter is ignored. If DATE is specified but TIME is not specified, all times can be selected. The syntax of the request is TIME BETWEEN hhmm AND hhmm where hh follows the 24-hour clock format. |
CODE |
Provides a list of message codes. Depending on the syntax of the request, this request code may (using CODE IN) specify the message codes to be included in the list, or (using CODE NOT IN) those to be excluded from the list. The syntax of the request is CODE IN code1 code2 code3 ... or CODE NOT IN code4 code5 code6 ... When many CODE requests are specified, the program joins them into one list containing a maximum of 100 codes. However, all CODE requests must be of the same type, that is, they must all be either IN or NOT IN. If CODE is not specified, all codes can be selected. |
FILE |
All selected log records are written to a file. The user must supply a JCL DD statement specifying the file. The syntax of the request is FILE ddname The default value of ddname is DAAPIOUT. |
Notes: The DAAPIOUT default should not be used when the selected log records have to be written to a file. The file should be allocated with LRECL=200 and RECFM=FB. |
|
RECORD |
The records selected are passed to the calling API. This request type is ignored where there is no API. |
Note: FILE and RECORD are mutually exclusive. If neither is specified in an API environment, the default is RECORD. |
|
FIND |
Perform the selection of log records as specified by the other parameters (that is, DATE, TIME, CODE, FILE, and RECORD). If FILE was specified, all records are written to file. If RECORD was specified, the first record is pointed by the register R1. The following records are passed by the NEXT request. |
NEXT |
Passes one log record to the calling program. This request type is valid only in an API environment. On return to the API, if the record was passed OK, the value in register R15 is zero, and R1 points to the next record. When the end of the LOG is reached, the value in register R15 is 4. |
Parent Topic |