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) Note:
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. Note:
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–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.