The STC or batch job can write a diagnostic report, which contains system-related environment information on the started task or batch job. The diagnostic report is written to DD BSADIAG, which is allocated dynamically as necessary. The writing of BSADIAG can be initiated using the following alternative methods:
You can use the BSA Service Manager online options to create a diagnostic report (DD BSADIAG):
The fields of the panels displayed under Service Manager options R.1 and R.2 correspond to the parameters of the DIAG parameter and MODIFY command described below. For more information, see BSA Service Manager Manual.
The following MODIFY command initiates the writing of a diagnostic report to DD BSADIAG:
F stcname,DIAG[=ocl[#FREE|HOLD[#dcl[#DUMP|FDMP|NDMP[#chd]]]]]
where:
stcname |
is the name of the started task. |
ocl |
is the output class to be used for DD BSADIAG. If * is coded, the message class of the batch job or STC is used. |
FREE|HOLD |
Specify FREE to control whether BSADIAG is to be released immediately, or HOLD to hold output until the batch job or STC terminates or until manual release. HOLD is the default. |
dcl |
is the output class to be used to the dump. If * is coded, the message class of the batch job or STC is used. |
DUMP|FDMP|NDMP |
Specify one of the following: DUMP causes the writing of a diagnostic dump; BSADIAGA/
FDMP causes the writing of a diagnostic dump; BSADIAGA/
NDMP no dump |
chd |
is the problem number (if available) for which you are providing information. This number will be included in the diagnostic report. |
# is used as separator between parameters. All parameters are optional, but if a parameter is coded, values for all preceding parameters must be coded as well.
Examples
F stcname,DIAG
F stcname,DIAG=*#HOLD
F stcname,DIAG=*#HOLD#*#NDMP#123-R123-1234
The LST parameter DIAG= can be coded in the LST member or in the EXEC parameter of the JCL (recommended). It is mainly intended for use with batch jobs, but it can also be used for STCs as an alternative to the console command or the corresponding Service Manager options. The syntax of the LST parameter DIAG corresponds to the syntax of the MODIFY command:
DIAG=ocl[#FREE|HOLD[#dcl[#DUMP|FDMP|NDMP[#chd]]]]
Example
Following is an example where the LST parameter DIAG has been coded in the EXEC parameter of the Beta 93 archive batch utility. The diagnostic report is written after all function groups have been loaded. DD BSADIAG is allocated dynamically using the message class of the batch job.
+----------------------------------------------------------------------+
|jobcard |
|//B93DEARC EXEC PGM=BST01RFF,REGION=0M,PARM=('S=93', |
|// 'PGM=B93ARC', |
|// 'B01LST=00', |
|// 'B93LST=00', |
|// 'DIAG=*#HOLD#*#NDMP#123-R123-1234', |
|// 'SIGNON=YES') |
|//... |
+----------------------------------------------------------------------+
The diagnostic report written to DD BSADIAG contains the following (amount of information varies depending on the object of the diagnostic report):