Programming notes for section 1

Notes in this section pertain to the following fields, which are in section 1 of the ADSR data area.
ADSRID     Record header                           (RC)
ADSRGMT    Local Time Conversion Factor
ADSRTIME   Time stamp                              (RS)
ADSRTOD    Time stamp (HHMMSSTH)
ADSRDATE   Date (YYMMDD)
ADSRSID    Customer Assigned System/Node Name      (RS)
ADSRSYS    Product ID of Base System (BCP)         (RS)
ADSRCML    Feature and level of Symrec Service     (RS)
ADSRTRNC   Truncated flag                          (RS)
ADSRPMOD   Section 3 modified flag                 (RA)
ADSRSGEN   Surrogate record flag                   (RA)
ADSRSMOD   Section 4 modified flag
ADSRNOTD   ADSRTOD & ADSRDATE not computed flag    (RS)
ADSRASYN   Asynchronous event flag                 (RA)
ADSRDTP    Name of dump
Note:
  1. SYMREC stores the TOD clock value into ADSRTIME when the incident occurs. However, it does not compute ADSRTOD and ADSRDATE when the incident occurs, but afterwards, when it formats the output. When the incident occurs, SYMREC also sets ADSRNOTD to 1 as an indication that ADSRTOD and ADSRDATE have not been computed.
  2. SYMREC stores the customer-assigned system node name into ADSRSID.
  3. SYMREC stores the first four digits of the base control program component id into ADSRSYS. The digits are 5752, 5759 and 5745 respectively for MVS™, VM and DOS/VSE.
  4. The ADSRDTP field is not currently used by the system.
  5. If some application creates the record asynchronously, that application should set ADSRASYN to 1. 1 means that the data is derived from sources outside the normal execution environment, such as human analysis or some type of machine post-processing.
  6. If SYMREC truncates the symptom record, it sets ADSRTRNC to 1. This can happen when the size of the symptom record provided by the invoking application exceeds SYMREC's limit.
  7. ADSRSGEN indicates that the symptom record was not provided as ‘first time data capture’ by the invoking application. Another program created the symptom record. For instance, the system might have abended the program, and created a symptom record for it because the failing program never regained control. Setting the field to 1 means that another program surrogate created the record. The identification of the surrogate might be included with other optional information, for example, in section 5.
  8. The application invoking SYMREC must provide the space for the entire symptom record, and initialize that space to hex zeroes. The application must also store the value SR into ADSRID.
  9. The fields ADSRCPM through ADSRFL2, which appear in the record that is written to the logrec data set, are also written back into the input symptom record as part of the execution of SYMREC.