Use the Host ROUTEP (VSE) command to initiate from a VSE host BIMUTIL job stream or from a VSE host application using the BIM-EDIT application interface a transfer of a POWER job from the host to a workstation.
Note: This command requires BIM-EDIT release 5.2B or greater.
Required Operands
PRM1-4 select the POWER job entry to be retrieved. The four operands allow you to specify the queue (RDR,LST,PUN,XMT), the job name, the job number, and the segment number. They can be specified in any order, except that segment, if specified, must follow job number. The following indicates which entry will be selected based on the operands specified:
queue, job name, job number, segment
The specified queue will be searched for the entry for the
specified name, number, and segment.
queue, job name
The specified queue will be searched for the first entry
for the specified name.
queue, job number
The specified queue will be searched for the first entry
for the specified number, without regard to the job name.
job number
job name
The LST queue will be searched for the first entry for the
specified number or name.
queue
The specified queue will be searched for the first entry
for the job name and number of the "last referenced
POWER job entry".
USER is the destination user. The SRC file will be copied to the workstation where the USER user is logged on.
DEST is the full path of the file to be created at the destination workstation.
Optional Operands
CTL Must be specified as "YES" or "ON", "NO" or "OFF", or "SKIP". Specify "YES" or "ON" to retrieve the carriage control character as the first character of the line. Data characters are shifted one character to the right. If CTL is not specified or is specified as "NO", carriage control is not retrieved. All carriage control that results in carriage movement and no data will produce a blank line in the member. Specify "SKIP" to retrieve all printable lines skipping the carriage control lines that result in carriage movement only.
Normally, System 370 printer channel commands are retrieved:
Hexadecimal 01 = Write without spacing
Hexadecimal 09 = Space 1 line immediate
Hexadecimal 0B = Write and Space 1 line
Hexadecimal 11 = Write and Space 2 lines
Hexadecimal 19 = Write and Space 3 lines
Hexadecimal 73 = Block Data Check (causes no print action)
Hexadecimal 8B = Skip to top of page immediate
See IBM documentation for additional values.
Under certain circumstances, job entries are stored and will be retrieved with ASA carriage control. If this is the case, the following controls will be retrieved:
Plus (+) = Write without spacing
Space ( ) = Space 1 line before writing
Zero (0) = Space 2 lines before writing
Dash (-) = Space 3 lines before writing
One (1) = Skip to top of page before writing
ASA carraige control is known to occur for job entries which are transferred from JES and for job entries generated by IBM's Document Management Facility and BIM-EDIT PRINT.
Host ROUTEP (VSE) command assumes the BIM-EDIT file contains EBCDIC text and translates it to ASCII text.
Host ROUTEP (VSE) command writes a carriage return byte sequence after each record.
The following VSE JCL transfers the POWER job "LST,BIJUTILX,2536" to the workstation where user USR1 is logged on as file C:\RXI\BIJUTILX.LST. The file is presumed to contain EBCDIC text and will be converted to ASCII text. A carriage return byte sequence will be written after each record.
// EXEC BIMUTIL
LOGON $SYS,$SYS
ROUTEP LST,BIJEDITX,2536,,USR1,C:\RXI\BIJUTILX.LST
/*