BACK.D - submit a file to the SYSOUT backdoor queue.

Usage:

B:
   status = back.d(unit, snumb|function[, dest|flags]);

/* Cannot be used from C programs */

Where:

unit

is the unit number of an open I/O unit.

snumb|function

is a word containing six BCD characters. The first five characters contain "snumb" and the last character is "function" (see below):

snumb

is up to five BCD characters, left-justified and padded on the right with BCD blanks.

function

specifies the I/O device to which the output file should be routed. The possible function codes are

1 - punch BCD/binary
2 - print BCD
3 - print ASCII
4 - punch ASCII

Thus, for example, the word `123 3` specifies a "snumb" of "123" and a "function" of "3" (ASCII print).

dest|flags

is a word indicating the destination device or site, and flags for the operation.

Bits 0-17

3 BCD characters naming the destination device/site.

`ddd` - Use printer/punch named "ddd".
`0rr` - Send to remote site id "rr".
`000` - Use any suitable printer/punch.

Bit 18

If on, the job needs a wide printer.

Bit 19

If on, the operator cannot reprocess the job.

Bit 20

If on, indicates that bits 0-17 specify a remote site, not a device.

Bits 21-36

Must be zero.

status

is a number indicating whether or not the backdoor request was successful. The possible values returned for "status" are

0: Backdoor request was successful.
-1: Backdoor queue was full.
-2: Invalid destination code.
-3: No such file or filecode.
-4: File not temporary.
-5: SYSOUT backdoor not configured.

Description:

BACK.D closes the specified "unit" and submits the associated temp file to the backdoor queue with the specified "snumb".

If the backdoor request is successful, a "status" of zero is returned. Otherwise, the negative of the system status is returned.

In TSS, when a backdoor request is unsuccessful, the file is left in the AFT. In batch, it is left attached to a filecode. The possible statuses for unsuccessful requests are listed above.

The "dest|flag" argument may only be used in GCOS8. If not supplied, the file will be output on any suitable device.

Notes:

At some sites, you may require privileges (e.g. Cardin) to execute this function.

BACK.D - submit a file to the SYSOUT backdoor queue.

Usage:

Where:

Description:

Notes:

See Also: