Span Accessory WFL

This WFL starts the Span Accessory. You can modify it for the:

  • QUEUE—If, for example, you want the Span Accessory to enter the system through job queue 10, you must modify the WFL job that compiles DATABridge software to include the QUEUE (or CLASS) = 10 declaration.
  • STARTTIME
  • BDNAME—This is the default file naming convention for the printer file. The name of the printer file that is generated by default is DBBD/RUN/SPAN/dbname.

Span Accessory TASKVALUEs

WFL/DATABRIDGE/SPAN also includes support for reporting the success or failure of the Span Accessory. To do so, the Span Accessory sets its TASKVALUE (same as VALUE) to either a positive or negative number.

When the Span Accessory encounters any errors from DBEngine (DBMnnn), it returns the nnn number as a positive TASKVALUE. These DBMnnn values are listed in Appendix A, Error and Status Messages.

When the Span Accessory detects an error specific to itself (for example, no such parameter file), it returns a negative number, as listed in the following table.

In WFL/DATABRIDGE/SPAN, the TASK is defined as SPAN and the value is returned as SPAN (VALUE). The following sample WFL code displays the SPAN (VALUE).

Example:

IF SPAN(TASKVALUE) < Ø THEN

DISPLAY "SPAN TASKVALUE = -" & STRING(SPAN(TASKVALUE), *);

ELSE

DISPLAY "SPAN TASKVALUE = +" & STRING(SPAN(TASKVALUE), *);

TASKVALUE

Description

TV_USER_TERMINATED = -1

An operator entered the AX QUIT command to terminate the Span Accessory.

TV_CONTROL_INUSE = -2

The Span parameter file is in use by another version of the Span Accessory. Wait until that version is finished and try again.

TV_CONTROL_CREATED = -3

This value is returned when you run the Span Accessory for the first time. It indicates that the Span parameter file was successfully created.

TV_HEADER_MISMATCH = -4

This value indicates that the HEADER option is set to TRUE. The Span Accessory is set to output to a consolidated file, but one of the following occurred:

  • The file is missing the header.
  • The header is corrupted.
  • The new starting location does not match the old ending location.

TV_WRITE_ERROR = -5

This value indicates that the Span Accessory is attempting to write output, but an I/O error occurred, resulting in the Span Accessory terminating.

TV_CF_SYNTAX = -6

This value indicates a syntax error in the Span parameter file. Make the correction in the parameter file and try again.

TV_RECOMPILE_FORMAT = -7

This value indicates that the formatting entry point in the Support Library does not match the database layout. This is usually the result of a data set reorganization. Recompile the Support Library and then rerun the Span Accessory.

TV_DUP_ENTRY = -8

This values indicates duplicate entries in the Span parameter file. When there are two entries for the same data set, the Span Accessory terminates with TASKVALUE = -8.

TV_AUDITFILE_LIMIT = -9

This value indicates that the Span Accessory has processed the number of audit files specified by the STOP AFTER parameter.

TV_RECORD_LIMIT = -10

This value indicates that the Span Accessory has reached the output file size limit specified by the STOP AFTER parameter.

TV_AUDITTIME_LIMIT = -11

This value indicates that the Span Accessory has stopped processing because of the time specified by the STOP AFTER parameter.

TV_AUDITTIME_LIMIT = -12

This value indicates that the Span Accessory has stopped processing because of the task name specified by the STOP parameter.