Option 2.7

Use option 2.7 to dynamically activate or deactivate available BSA traces. You can also optionally allocate a dataset or a SYSOUT class for the trace output, to be used instead of the JES job log. You can change the output medium regardless of trace changes. Instead of the JES joblog, a dataset under the DD name BSATRACE can be used. When the started task is activated, this dataset will be used for the trace output.

Note

Please note that the changes are only temporary. After restarting the product started task (STC) with the subsystem ID, the trace changes will no longer be active. To activate a permanent trace change, insert the relevant keyword in the LST member of the Beta product STC.

Define the trace beforehand

The trace must be defined beforehand in one of the following Beta parameter library members:

• in the PARM field in the EXEC statement of the started task or
• in the B01LST parmlib member (SFF parameter) or
• in the BnnLST parmlib member (product parameter), where nn stands for a product number

The Keyword column of the "Dynamic Trace Activation/Deactivation" panel then lists all the traces that are available for dynamic activation. A value in the CurrValue column indicates that the trace has already been activated with this value.

Activating traces

The "Dynamic Trace Activation/Deactivation" panel enables you to activate or deactivate traces or to allocate a dataset or a SYSOUT class for trace output.

• The upper portion of the panel enables you to activate or deactivate a trace.
• The lower part enables you to optionally allocate a file for trace output.

Procedure

1. Select option 2.7 from the "Service Manager Selection Menu" to display the "Dynamic Trace Activation/Deactivation" panel.

   PEB4TR01 ---------------------------------------------------------------------
   Command ===> _________________________________________________________________
   
   Dynamic Trace Activation/Deactivation Subsys-ID - Q93V
   Sysname - BETA
   
   Keyword CurrValue NewValue
   
   BQL : BQL_TRACE NO ===> ___ (Y)es,(N)o
   TCP/IP: BSA_TCPIP_TRACE YES ===> ___ (Y)es,(N)o,(S)ho,(E)rr
   BSA_TCPIP_TRACE_INTERN NO ===> ___ (Y)es,(N)o
   BSA_TCPIP_TRACE_SNDRCV ===> ___ (Y)es,(N)o
   BSA_TCPIP_TRACE_BUF ===> ___ (Y)es,(N)o
   
   Trace Output Information
   Disposition ===> ___ (S)HR, (O)LD, (M)OD, (N)EW
   Data Set Name ===> ____________________________________________
   or use
   SYSOUT ===> ___ (Y)es
   FREE Data Set ===> ___ (Y)es
   
   Press the ENTER key to verify the entered values.
   Press the END key to return to the previous panel.
   

2. If required, allocate a file for trace output. There is an example of how to allocate a dataset.
3. Activate or deactivate the trace(s). You will be prompted to confirm each trace keyword change.

Freeing traces

To free a dynamically activated trace, enter YES in the FREE Data Set field. You will receive notification that the trace is now inactive. You can only free datasets which have been dynamically assigned to a DD name. Datasets that have a BSATRACE JCL statement when the STC is started cannot be dynamically freed.

Fields

Field	Description
Keyword	Heads a list of the traces available for activation
CurrValue	A value here shows that the trace concerned has already been activated. YES shows that it is still active.
NewValue	Enables you to activate or deactivate a trace. More than one new value can be specified in this column.
Disposition/ Data Set Name	If you want to use a dataset instead of Sysout (SYSOUT field must be blank): Disposition and name of the dataset allocated for a trace. Specify OLD, SHR or MOD to use an existing dataset. If you specify NEW, an additional panel will be displayed, where you can specify the required allocation parameters for the new dataset.
SYSOUT	If you want to use Sysout instead of a dataset (Disposition and Data Set Name must be blank): Specify YES to use SYSOUT for trace output. An additional panel will be displayed, where you can specify the Sysout class, form and extension.
FREE Data Set	FREE dynamically frees the allocated dataset or SYSOUT. The activated trace function remains active and trace data is written to the job log or SYSLOG. To deactivate the trace, set the keyword value to NO.