Finding Batch Errors


When batch files run, log files are created which record all actions executed by the system.  And, they show any errors encountered.  If you suspect that a batch file did not perform correctly, read the log file to determine if there were errors.

To find the log file in your directory, you can use any of the following commands.  Log files usually carry the same filename as the batch.

$dir *.log/since=today (displays all .log files created today)
$dir *.log/since=yesterday
$dir *.log/before=today 
$dir *eom*.log  (displays any .log file with the letters "eom" in the filename)

To view the log file, use the command:

$type/page=save filename.log

Errors are easy to locate.  Sometimes they are preceded by "?" or "%" symbols.  As you read through the log file, it is evident where errors exist that the system responds with an error or warning message.

Errors that you cannot fix should be reported to the system manager or data base administrator.  Using "copy/paste" to include the error messages in an email to technical support is always a good idea.  Also, be sure to indicate the name of the batch and your username.

Here's an example of a log file with no errors:

$ !****************************************************************
$       !
$       ! @Select the records from the JOURNALS file
$       ! @for this period that have not been posted.
$       !
$RUN DMS:SORT
SORT V6.8-01 - DMS-Plus File Sorting Program                01:28 PM
Copyright (c) 2000, Campus America, Inc.
Data File Name? JOURNALS

Fields to Sort (15 Maximum)
Level 1...Field?
No Sorting requested

Select out special records <NO>? YES

Criterion  A
Field? .POSTDETAIL
Low ?  /ONLY

Criterion  B
Field? .FISDATE
Low ? 020300
High? 020301

Criterion  C
Field?

Selection statement? A AND B
Field extraction/Pointer build started            01:28 PM
Pointers to 3 records constructed.                01:28 PM

Finished    01:28 PM
$       ! 
$ !****************************************************************
$       ! 
$       ! @Print the End-of-Month JOURNALS error
$       ! @report.  EOM_JOURNALS report.
$       ! 
$RUN DMS:PRINT
PRINT V6.8-01 - DMS-Plus Report Generator                   01:28 PM
Copyright (c) 2000, Campus America, Inc.
Data File Name <JOURNALS>? JOURNALS/NH

Number of blank lines between records <0>? 0
Number of spaces between columns <1>? 1

Enter column commands
Column 1 (Line 1, Pos 1)...Field? .BATCH
Column 2 (Line 1, Pos 11)...Field? .BATCHOWNER
Column 3 (Line 1, Pos 24)...Field? .TRANNUMBER

Line length: 108

Number of lines per page <55>? 55
Number of Level Breaks <0>? 0
Report Date <27-May-2003>?
Heading 1? St. Gregory's University
Heading 2? JOURNALS entries
Heading 5?
Number of copies <1>? 1
Report Name? EOM_JOURNALS
Paper type <LA_NORMAL>? YES
%Bad paper type - YES
Paper type <LA_NORMAL>? la12

Report Generation Started                         01:28 PM

Report Generation Completed                       01:28 PM
1 page written to EOM_JOURNALS.LIS;
Print queue <LTA5>? LTA5:
Job EOM_JOURNALS (queue LTA5, entry 32) started on LTA5

Finished    01:28 PM

 

Here's an example of a log file with errors:

$ !
$ ! ******************************************
$ ! * P R F A D D R E S S . B C F *
$ ! * *
$ ! * Create preferred addresses *
$ ! ******************************************
$ !
$ !
$ ! This batch is designed to run daily to populate preferred address fields in
$ ! the COMMON_FILE, based on student's .prfaddress code in STUDENT. It may be
$ ! included in any batch which depends on the accuracy of these fields.
$ !
$ !
$ !*********************************************************
$ ! O U T L I N E
$ !
$ ! Run Program Remarks
$ !O
$ ! <1> DMS:COMPARE -Find records which already exist in Common_File
$ ! <2> DMS:TRANSFER -Populate preferred address fields
$ ! <3> DMS:POINTER -Get remaining records
$ ! <4> DMS:TRANSFER -Create new records with preferred addresses
$ !OO
$ !
$ !
$ !RN:1
$ !*********************************************************
$ !
$ ! Find records which already exist in Common_File
$ !
$ RUN DMS:COMPARE
COMPARE V6.8-01 - Data File Comparison Program 02:54 PM
Copyright (c) 2000, Campus America, Inc.
Data File Name? REGSYS_FILES:[REG.FILES]STUDENT/ALL
Data File to Compare Against? REGSYS_FILES:[REG.FILES.SITE]COMMON_FILE
?Can't find file or account - Data file USERS1:[REG.FILES.SITE]COMMON_FI
LE.DTA;
Data File to Compare Against? 1
?Can't find file or account - Data file SYS$SYSDEVICE:[REG_FLOY]1.DTA;
Data File to Compare Against?

Finished 02:54 PM
%DCL-W-SKPDAT, image data (records not beginning with "$") ignored
$ !
$ !RN:2
$ !*********************************************************
$ !
$ ! Populate preferred address fields
$ !
$ RUN DMS:TRANSFER
TRANSFER V6.8-02 - Information Transfer Program 02:54 PM
Copyright (c) 2000, Campus America, Inc.
Left-side Data File Name <REGSYS_FILES:[REG.FILES]STUDENT>? REGSYS_FILES
:[REG.FILES]STUDENT
Right-side Data File Name? REGSYS_FILES:[REG.FILES.SITE]COMMON_FILE
?Can't find file or account - Data file USERS1:[REG.FILES.SITE]COMMON_FI
LE.DTA;
Right-side Data File Name? YES
?Can't find file or account - Data file SYS$SYSDEVICE:[REG_FLOY]YES.DTA;
Right-side Data File Name? YES
?Can't find file or account - Data file SYS$SYSDEVICE:[REG_FLOY]YES.DTA;
 


 

 


To POISE Home Page