QRWOPTIONS data area
When DDM or DRDA TCP/IP server jobs are initiated, they look for a data area in which the user can specify diagnostic and other options. The name is QRWOPTIONS, and it must reside in the QGPL library to take effect. It consists of a string of 48 characters.
Note: The information in the data area must be entered in uppercase
in CCSID 37 or 500.
The format of the data area is as follows:
| Columns | Contents |
|---|---|
| 1-15 | Client IP address in dotted decimal format for use when I is specified as a switch value (ignored otherwise). |
| 16 | Reserved area ignored by server (can contain a character for human usability). |
| 17–26 | User profile name for comparison when U is specified as a switch value (ignored otherwise). |
| 27 | Switch to cause job log to be kept if set to A, I or U (see notes 1 and 2). |
| 28 | Switch to cause DSPJOB output to be printed if set to A, I or U (see notes 1 and 2). |
| 29 | Switch to cause job to be traced if set to A, I or U (see notes 1 and 2). |
| 30 | Switch to cause debug to be started for job if set to A, I or U (see note 1). |
| 31 | Switch to invoke the Change Query Attributes (CHGQRYA)
command with a QRYOPTLIB value if set to A, I or U. The QRYOPTLIB value is extracted from columns
39-48 which must contain the name of the library containing the proper QAQQINI file (see Note 1). If an I or A is specified in this column, QUSER must have *JOBCTL special authority for it to take effect. |
| 32 | Switch to shadow client debug options if set to A, I or U (see note 1). |
| 33 | Switch to use old TRCJOB instead of new STRTRC for job trace if set to T and
column 29 requests tracing. If this column is set to T, TRCJOB will be used for the job trace. Set it to blank or S to use STRTRC. |
| 34 | Set this to N to suppress CPI3E34 messages in the history log (This is available in OS/400® V5R1 only with PTF SI02613). |
 35 |
Switch to invoke the Start Database Monitor (STRDBMON) command for job if set to A, I, or U (see notes 1 and 2). The output file is written to library QGPL with the following naming convention: QRWMxxxxxx, where xxxxxx is the job number. |
| 36–38 |
Reserved |
| 39–48 | General data area (contains library name if the Change Query Attributes (CHGQRYA) command is triggered by the appropriate value in column 31). |
Notes:
- These are the switch values that activate the function corresponding
to the column in which they appear:
- A activates the function for all uses of the server job.
- I activates the function if the client IP address specified in columns 1-15 matches that used on the connect attempt.
- U activates the function if the user ID specified in columns 17-26 matches that used on the connect attempt.
- To find the spooled files resulting from this function, use Work
with Job command (WRKJOB user-profile/QPRTJOB), where user-profile
is the user ID used on the connect request. Take option 4 and you
should see one or more of these files.
Table 2. File list from WRKJOB user-profile/QPRTJOB command File Device or queue User data QPJOBLOG QEZJOBLOG QRWTSRVR QPDSPJOB PRT01 QPSRVTRC PRT01 - The file containing the special DRDA subroutine trace will be created in library QGPL, with a name in this format: QRWDBmmddy, where mm represents the month, dd the day, and y the last digit of the year in which the trace was recorded. Not all system programs are traced.