ALERT: Some images may not load properly within the Knowledge Base Article. If you see a broken image, please right-click and select 'Open image in a new tab'. We apologize for this inconvenience.

Endevor email notification trace EN$TRNTF

book

Article ID: 236951

calendar_today

Updated On:

Products

Endevor Software Change Manager (SCM)

Issue/Introduction

This article documents the endevor email notification trace, which can be used to debug notification emails produced by endevor.

Environment

Release : 18.1

Component : Endevor Software Change Manager

Resolution

The endevor email notification facility produces trace data for each email it produces whenever ddname EN$TRNTF is allocated to the jobstep.

To allocate EN$TRNTF in a batch run, it is enough to add the following DD to the JCL:

//EN$TRNTF DD SYSOUT=* 

To allocate it in a foreground run, the following command may be used:

TSO ALLOC FI(EN$TRNTF) SYSOUT(X)

This command may be issued at any point before the email is generated

The trace prints to ddname BSTERR and consists of a small snap dump of each and every record that the notification interface sends to the SMTP processing started task which is selected to process the emails. For example:

07:18:22:14 DATA WRITTEN BY BC1PNTFY
3B62E0FC (+0000)   C8C5D3D6 40C8D6E2 E3D5C1D4 C5404040   40404040 40404040 40404040 40404040   *HELO HOSTNAME                   *
3B62E11C (+0020)   40404040 40404040 40404040 40404040   40404040 40404040 40404040 40404040   *                                *
3B62E13C (+0040)   40404040 40404040 40404040 40404040                                         *                *

Each record dumped by the trace is prefixed by a fixed title (DATA WRITTEN BY BC1PNTFY). The columns in each block are:

  • Storage address where the data resides
  • Hex offset from the start of the block
  • 32 bytes of data in hex format
  • Same data in character format

If the SMTP started task does not send the emails as expected, this trace may be used to examine the email addresses set by Endevor and also to ensure that the whole message adheres to the SMTP protocol.

Additionally, if the BC1PMLIF interface routine is used, this routine writes snap dumps of the parameter blocks passed to it by the caller, under headings:

  • PARMLIST - List of up to 6 pointers to the other parameter blocks.
  • PMSGAREA - Message area (output parameter)
  • USER ID
  • MAILFROM
  • SUBJECT
  • TEXT CT - Number of text lines passed
  • 1ST LINE
  • URL?