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:

Table 1. Data area format
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	Switch to start special subroutine trace if set to A, I, or U (see notes 1 and 2).
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 server programs are traced.

Table 2. File list from WRKJOB user-profile/QPRTJOB command
File	Device or queue	User data
QPJOBLOG	QEZJOBLOG	QRWTSRVR
QPDSPJOB	PRT01
QPSRVTRC	PRT01