Annotation of cci/usr/src/usr.bin/bsc/doc/bscpr.1, revision 1.1.1.1

1.1       root        1: '\" t
                      2: .TH BSCPR 1C DLBA 1.1
                      3: .SH NAME 
                      4: bscpr \- BISYNC Batch File Print Utility
                      5: .SH SYNOPSIS 
                      6: bscpr [-ascii] [-page=pp] [chan=lineno ...] [file]
                      7: .SH DESCRIPTION 
                      8: .P
                      9: The 
                     10: .I bscpr 
                     11: utility is used to paginate a file which
                     12: contains IBM 2780 or 3780 terminal control characters and escape sequences.
                     13: These terminals have line printers which utilize a paper tape loop
                     14: and holes punched in certain locations to control paper motion. The
                     15: loop of paper tape contains twelve channels; an escape code is used
                     16: to tell the printer to skip to a position on the page corresponding
                     17: to a hole in a certain "channel". Usually, channel 1 corresponds
                     18: to the top of the form, channel 12 to the bottom, and the remainder
                     19: correspond to the vertical equivalent of horizontal tab stops in
                     20: that they represent a physical line number on a page.
                     21: .P
                     22: The 
                     23: .I -ascii 
                     24: parameter specifies that the escape
                     25: sequences used for printer positioning were of the ASCII style; the
                     26: default is the EBCDIC style (differences are slight, see the table below).
                     27: The 
                     28: .I -page=pp 
                     29: parameter is used to specify the page length to be used.
                     30: The 
                     31: .I chan=lineno 
                     32: parameters give the correspondence of channel numbers to line numbers on a page.
                     33: The page length defaults to 66 lines, and channel 1 always corresponds to
                     34: line 1; skipping to unspecified channels results in no action.
                     35: .P
                     36: The following table shows the escape sequences which may appear at
                     37: the beginning of a line to control paper positioning. If there is
                     38: not an escape sequence at the beginning of a line, single spacing
                     39: is automatically selected for that line.
                     40: .P
                     41: .TS
                     42: center;
                     43: c c c
                     44: c c c
                     45: l l l.
                     46: Carriage Operation     EBCDIC Code     ASCII Code
                     47: After Printing Sequence        Sequence  
                     48: _
                     49: Single Space   ESC /   ESC Q
                     50: Double Space   ESC S   ESC R
                     51: Triple Space   ESC T   ESC S
                     52: Space Suppress*        ESC M   ESC M
                     53: 
                     54: Skip to Channel 1      ESC A   ESC A
                     55: Skip to Channel 2      ESC B   ESC B
                     56: Skip to Channel 3      ESC C   ESC C
                     57: Skip to Channel 4      ESC D   ESC D
                     58: Skip to Channel 5      ESC E   ESC E
                     59: Skip to Channel 6      ESC F   ESC F
                     60: Skip to Channel 7      ESC G   ESC G
                     61: Skip to Channel 8      ESC H   ESC H
                     62: Skip to Channel 9*     ESC I   ESC I
                     63: Skip to Channel 10*    ESC J   ESC J
                     64: Skip to Channel 11*    ESC K   ESC K
                     65: Skip to Channel 12*    ESC L   ESC L
                     66: .TE
                     67: .P
                     68: * These operations do not apply to the IBM 2780
                     69: Data Transmission Terminal.
                     70: .P
                     71: .I Bscpr 
                     72: keeps track of the current line number as
                     73: it displays the lines of the received file.
                     74: Normally, each line is terminated with the necessary number of newlines
                     75: (one for single spacing, two for double, three for triple,
                     76: and the difference between
                     77: the current line and line corresponding to a specific channel in
                     78: a skip to channel operation).
                     79: Space suppress results in a line terminated via a carriage return,
                     80: and the current line number is not incremented.
                     81: Any attempt to move past the bottom of the page via spacing or skipping
                     82: will result in a carriage return and form feed (ASCII FF).
                     83: An attempt via skipping
                     84: to a channel to position to a line number less than the current line
                     85: number will result in a form feed, then line feeds to get to the
                     86: proper line on the new page.
                     87: .P
                     88: .SH "SEE ALSO"
                     89: .nf
                     90: bscbatch(1c) \- batch file submission / queue query
                     91: .I
                     92: Component Description: IBM 2780 Data Transmission Terminal,
                     93: IBM document GA27-3005 
                     94: .I
                     95: Component Information for the IBM 3780 Data Communication Terminal, 
                     96: IBM document GA27-3063
                     97: .fi
                     98: .SH DIAGNOSTICS
                     99: .P
                    100: bscpr: unrecognized option (<flag>)
                    101: .IP
                    102: The option <flag> is not a valid parameter as shown in the synopsis.
                    103: .P
                    104: bscpr: not a numeric (<parameter>)
                    105: .IP
                    106: The number of lines for the 
                    107: .I -page 
                    108: parameter or the channel or line number for the 
                    109: .I chan=lineno 
                    110: parameter is not a numeric.
                    111: .P
                    112: bscpr: channel number not 2 to 12 (<parameter>)
                    113: .IP
                    114: The channel number given is not in the range 2 to 12, inclusive.
                    115: There are only escape sequences for channels in this range, not counting
                    116: the channel 1 specification, which is always set to line 1.
                    117: .P
                    118: bscpr: line assignment for channel <chan> is greater than page length
                    119: .IP
                    120: Channel assignments for line numbers must be between line 1 and the
                    121: last line on the page (given by 
                    122: .I -page 
                    123: or defaults to 66).
                    124: .P
                    125: bscpr: <file> not found
                    126: .IP
                    127: The file name parameter <file> could not be opened for reading.
                    128: Either it does not exist, or the mode does not permit reading.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.