Span WFL

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

  • QUEUE—If, for example, you want Span 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 TASKVALUEs

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

When Span encounters any errors from DBEngine (DBMnnn), it returns the nnn number as a positive TASKVALUE. These DBMnnn values are listed in the DATABridge Error Guide, included with the product documentation.

When Span 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 Span.

TV_CONTROL_INUSE = -2

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

TV_CONTROL_CREATED = -3

This value is returned when you run Span 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. Span 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 Span is attempting to write output, but an I/O error occurred, resulting in Span 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 Span.

TV_DUP_ENTRY = -8

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

TV_AUDITFILE_LIMIT = -9

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

TV_RECORD_LIMIT = -10

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

TV_AUDITTIME_LIMIT = -11

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

TV_AUDITNAME_LIMIT = -12

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