When an ACR job runs, it will write a SYSOUT log alongside any report outputs that are configured within the job. The SYSOUT will contain information regarding the ACR job's progress and results, including warning and error messages.
ACR SYSOUT location
Mainframe
If you are running jobs through JCL, the SYSOUT will appear within your job's output in your held queue.
If you are running jobs through the ACR panels, the SYSOUT will be appended to the end of the console messages after running a job.
Windows, Linux and Unix
By default, the SYSOUT will write to a file named SYSOUT.LOG within your main ACR installation directory. Note that this native SYSOUT.LOG is rewritten for each new execution.
This location may be overwritten if your scripts are piping the output of the UAC2000 or UDS2000 execution to a different location.
Reading the contents of ACR's SYSOUT
The structure and content of the SYSOUT is the same regardless of which platform ACR is installed on.
Sample ACR SYSOUT
The two samples below will be used throughout this section.
Sample SYSOUT with standard (non-error) messages:
#UDS001I: 15 RECONCILIATION KEYS FOR JOB SAMPLE /MESSAGES/
#UDS005I: 0 RECORDS WERE DELETED FROM HISTORY FILE FOR JOB SAMPLE /MESSAGES/
#UDS006I: 15 RECORDS WERE ADDED TO HISTORY FILE FOR JOB SAMPLE /MESSAGES/
#UDS007I: 0 RECORDS WERE CHANGED ON HISTORY FILE FOR JOB SAMPLE /MESSAGES/
#UDS002I: 20 RECORDS WERE SELECTED FROM 21 INPUT IN FILE FILEIN1
STEP COMPLETION CODE 0000
Sample SYSOUT with error messages:
#UDX015E: SAMPLE /MESSAGES/ FILE FILEIN1 NOT PROCESSED BECAUSE FILE CANNOT BE OPENED.
#UDS002I: 0 RECORDS WERE SELECTED FROM 0 INPUT IN FILE FILEIN1
#UDS002E: ERROR!! DETAIL RECONCILIATION TERMINATED DUE TO +001 ERRORS.
STEP COMPLETION CODE 4007
Structure of the ACR SYSOUT
Each record contains an ACR message, which begins with a #U
followed by up to six alphanumeric values. The last character denotes the message severity: an I
for an informational message, an W
for warning message or an E
for an error message. The message will also contain a brief summary of its meaning.
If the ACR job was run on Windows, Linux or Windows, the final record will contain a STEP COMPLETION CODE ####
, where the final four digits are the return code set by the ACR job. On mainframe environments, this return code is set as the job's return code instead.
Definitions of each message
The full message details, reasons for occurring and ways to resolve are contained within the ACR Messages and Codes document. ACR system return codes, return codes between 4000 and 4999, are also included in the Messages and Codes document.
Note that you may have custom return codes defined in your jobs, commonly in the 2000 through 3999 range, that will trigger based upon your ACR job's coded rules.
Comments
0 comments
Please sign in to leave a comment.