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.
See Also:
- expl b lib .ident
- for an explanation of how to get a userid and banner on
the first page of your output.
Copyright © 1996, Thinkage Ltd.