Status Messages

The following status messages may appear on the ODT and on the station that is running the accessory or component. Note that status messages are not processed by error handler routines.

Fatal error

The accessory encountered an error condition that won’t allow it to continue processing. The program will terminate. Possible errors include:

Syntax error in the parameter file

Software version mismatch

An error during initialization

Syntax error on line linenumber column columnnumber: 'token' unexpected

The accessory detected a syntax error in the parameter file at the indicated line number and column number. Instead of the expected keyword or value, the accessory found token. Correct the parameter file and rerun the accessory.

Syntax error on line linenumber column columnnumber: Missing end quote mark

The accessory detected a syntax error in the parameter file at the indicated line number and column number. It expected to find the closing quotation mark () for a string. Strings must start and close on the same line of the parameter file. Correct the parameter file and rerun the accessory.

Unexpected end of parameter file

The accessory encountered the end of the parameter file before finding required keywords or values. Add the necessary syntax to the parameter file and rerun the accessory.

Version version compiled compiletime

version indicates the release of the accessory and compiletime indicates when it was compiled. This is an informational message.

Workers can not exceed maxnumber (Engine)

This message indicates that the number of Workers specified in the DBEngine parameter file or in an AX WORKERS command exceeds the maximum allowable number.

Workers limit: nn (Engine)

This message indicates the Workers limit.

Workers unrecognized limit: text (Engine)

This message indicates that the Workers limit is incorrect. Additional text appears with this message, which explains the problem.

Snapshot: After modifying the parameter file, please rerun

When you run Snapshot for a database for the first time, it creates a parameter file. Use CANDE to edit this file so that the options have the proper values. After saving the file, rerun Snapshot.

Snapshot: Creating filename

You ran Snapshot without a parameter file so it is generating one called filename for future use. This run of Snapshot does not generate any data files.

Snapshot: nnn records extracted (nnn filtered out)

This is the response to an AX STATUS command for Snapshot. It shows how many records Snapshot has read so far and how many it has skipped because the filter procedure discarded them.

Unrecognized command: text

This message indicates that you entered an unrecognized AX command.

DBSpan: After reviewing the parameter file, please rerun

When you run DATABridge Span for a database for the first time, it creates a parameter file. Use CANDE to edit this file so that the options have the proper values. After saving the file, rerun DATABridge Span.

DBSpan: Audit location: AFN = afn ABSN = absn

This is the second line of the response to AX STATUS command. It indicates the audit file number and the audit block serial number currently being processed.

DBSpan: Audit time: timestamp

This is the third line of the response to an AX STATUS command. It indicates the original time of the transaction that DATABridge Span last processed.

DBSpan: DATABridge SPAN Initializing time on hostname

This is an informational message that tells you the time DATABridge Span is starting and the name of the host it is running on.

DBSpan: DATABridge SPAN Terminating time

This is an informational message that tells you the time DATABridge Span is stopping. DATABridge Span could be stopping because of an AX QUIT command or because the requirements have been met for the STOP option.

DBSpan: Existing output file has different attributes

DATABridge Span has found an existing output file to append to but it has different file attributes (for example, BLOCKSIZE, AREASIZE, etc.) than what it computed. The existing file will be renamed with the …/OLDATTS node. Process this file on the target system. Then change the target system to expect the output file with the new file attributes.

DBSpan: Final audit location: time, AFN=nnn, ABSN=nnn

This is an informational message that tells you the point in the audit file at which DATABridge Span stopped processing. This information is also located in the NOTE attribute of each DATABridge Span output file.

DBSpan: nnn records replicated (nnn skipped)

This is the first line of the response to an AX STATUS command. It indicates the number of records written to the output files and the number of records that were skipped because the filter procedure discarded them.

DBSpan: Reading parameter file filename

This is an informational message that gives you the name of the DATABridge Span parameter file.

DBSpan: Renaming to .../name

DATABridge Span has encountered a problem file and is renaming it as follows:

Appending /OLDATTS

Appending /BAD

/OLDATTS

DATABridge Span appends /OLDATTS to indicate that the existing file has different record sizes than the data that the accessory is attempting to write. This can occur after a reorganization. In this case, do the following:

Process the old files on the target system.

Remove them on the source system.

Prepare the target system to receive data files that have the new layout.

/BAD

DATABridge Span appends /BAD to indicate that the existing file ending audit location does not match the current starting location. If the files were created before changing the HEADER option to TRUE in the DATABridge Span parameter file, follow the same procedure as above, but in place of step 3, prepare the target system to receive data files containing the header.

DBSpan: Terminating at next quiet point

An operator has given DATABridge Span an AX QUIT. DATABridge Span will terminate at the next quiet point.

DBSpan: Thruput: nnn records/sec. CPU

This is an informational message that tells you the number of data records that DATABridge Span processed per second of CPU time.

DBSpan: Warning: datasetname block size nnn exceeds limit of mmm

The output file block you specified in the DATABridge Span parameter file for datasetname is larger than the system block size limit of mmm.

DBSpan: Warning: datasetname block size adjusted to nnn

Span Accessory revised the output file block size to nnn to make the block size within the mainframe limit.

DBSpan: Warning: previous limittype limit ignored

The parameter file contains duplicate settings for the STOP option. limittype can be either Time or Task name. Specify only one task name and one time limit. If you specify a second task name or a second time limit, DATABridge Span discards the first one and uses only the second one.

DBSpan: Unrecognized command: text

This message indicates that you entered an unrecognized AX command.