How To
Summary
In order to collect diagnostic information in a zWS environment it is sometimes necessary to set up and run a DIAGNOSE trace. Having the task set up correctly makes this easier to do.
Objective
Be able to run a diagnose trace and get the results to the support team
Steps
A diagnose trace for example:
//CEEMSG DD SYSOUT=*
Once the trace has been started you can turn it off by issuing command:
DIAGNOSE HTTPFLAGS(X'FFFFFFFF')
or the equivalent MODIFY command: xxxx,SDIAHTT,FLAG(FFFFFFFF)
or the equivalent MODIFY command: xxxx,SDIAHTT,FLAG(FFFFFFFF)
often has one part written to the EQQMLOG and the other part written to the DD statement which matches the
CEEOPTS MSGFILE parameter, which defaults to value SYSOUT. The EQQMLOG is always allocated in a
zWS task but the "SYSOUT" DD may be missing. If only one part of the trace is provided the trace cannot be
used. It is important therefore to have this MSGFILE related DD in your zWS tasks such as the controller.
If your MSGFILE value is SYSOUT you would need to have:
//SYSOUT DD SYSOUT=*
If you are not sure of your MSGFILE value see the "Additional Information" section below. If you determine
for example that your MSGFILE value is CEEMSG you would need to add:
//CEEMSG DD SYSOUT=*
Once the trace has been started you can turn it off by issuing command:
F xxxx,EDIAxxx
For example if you are using the HTTP trace you would use: F xxx,EDIAHTT
If you used the DIAGNOSE statement in the task EQQPARM member to start the trace you may need to remove this after stopping the trace (unless you want to have the trace running again when the task is restarted).
Additional Information
You can override the default MSGFILE value for a task by including a CEEOPTS DD in the JCL. By doing this you can be
sure of the MSGFILE value without even knowing what your default value is set to.
In proc (example- server or controller proc) add:
In proc (example- server or controller proc) add:
//CEEOPTS DD DISP=SHR,DSN=your,eqqparm.library(CEEOPT)
where the contents of this CEEOPT member are:
MSGFILE(SYSOUT),RPTOPTS(ON)
where the contents of this CEEOPT member are:
MSGFILE(SYSOUT),RPTOPTS(ON)
This will set MSGFILE to SYSOUT or any other value that you specify. The parameter RPTOPTS(ON) will add a display
of all the CEEOPTS parameters in effect when the task is shut down, in case there are any other values that you want to check.
Document Location
Worldwide
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSRULV","label":"IBM Workload Scheduler for z\/OS"},"ARM Category":[],"Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Was this topic helpful?
Document Information
Modified date:
28 November 2023
UID
ibm16195353