Q-Cloud File Parser Output, Exit Codes, and Failure Behavior

Final Summary Log Event

Each run ends with one summary event on stdout. The summary tells you which files were processed, which files failed or were skipped, how many requests were sent, and what exit code the parser returned.

File Status Values

  • success: the file was processed successfully.

  • error: the file or the integration failed during execution.

  • invalid_input: the file did not pass parser validation.

  • skipped: the file was intentionally ignored.

Post-Processing Behavior

PROCESSED_FILE_ACTION applies only to successful files:

  • none: keep the file in place.

  • archive: move the file to ARCHIVE_DIR.

  • delete: remove the file after a successful run.

If post-processing fails, the parser returns a non-zero exit code and records the failure in the summary.

Exit Codes

  • 0: all executable files succeeded.

  • 1: at least one processing error or invalid file was encountered.

  • 2: startup or configuration failed.

Failure Behavior (FAIL_FAST)

When FAIL_FAST=true:

  • the parser stops at the first failed or invalid executable file

  • the summary only includes files handled before the stop point

When FAIL_FAST=false:

  • the parser keeps going and records all file results before exit