Batch Line Printer Exit

Use the Batch Line Printer Exit if you want to control output yourself instead of allowing CA Dataquery Batch to write to SYSPRINT or SYSLST.

Operation

The module that does the output to SYSPRINT calls BATCHLP instead of writing to SYSPRINT.

On return, the contents of all registers except 15 are restored to what they contained before BATCHLP was called. Register 15 contains a return code on return. A zero return code indicates successful completion. A nonzero return code causes CA Dataquery to abend because no output can be done.

Procedure

Call the Batch Line Printer Exit by linking a module named BATCHLP (or having an entry point named BATCHLP) with the CA Dataquery module DQSYSTBL. The DQSYSTBL is assembled and linked with a WXTRN for BATCHLP. The WXTRN is resolved if BATCHLP is linked with DQSYSTBL.

Alternately, the exit may be linked as a separate load module. Specify the 1- to 8-character name of the module in the BTCHLPX= parameter of DQOPTLST. Then reassemble the module DQSYSTBL.

Your printer exit must do all the output for the entire execution.

When the exit is called, registers are used as follows:

Register 1

Address of the parmeter list as follows:

Word1=: 00000014 (20) if this is an output line
00000020 (32) if this is close (EOJ)
Word2=: AL1(length of line)
AL3(address of line)
Word3=: Address of a 1-byte top of page indicator.
If Bit 2 (X'20) is on, top of page is requested.

Register 13

Contains the address of a register SAVE area which the exit must use to save and restore the CA Dataquery registers according to standard linkage conventions.

Register 14

Contains the return address within CA Dataquery.

Register 15

Contains the address of the exit's entry point.