SNA NRJE User/Programmer Reference Manual (30292-90006)

216 AppendixA
Parsing Algoithms and User Exit Procedures
Parsing Algorithms
Parsing Algorithms
To route output properly, SNA NRJE must parse both “Job Received”
messages (such as the $HASP100 message from JES2) and host system
output banner pages of the received data sets. This capability is
necessary for NRJE to be able to interpret the host system job number.
This chapter describes the algorithms used to perform the parsing. The
algorithms work for all host messages and banners which have not been
modified by host system programmers. If nonstandard “Job Received”
messages or host banners are sent to your workstation, an exit
procedure might be needed to parse for the necessary information. The
user exits and exit procedure specifications are described in this
chapter.
NOTE If you are connected to a JES3 host system, NRJE does not use an
internal banner decode routine. For both print and punch output, the
job number is returned from the host in the spin number field of the
PDIR.
VSE/POWER does not send “Job Received” messages.
If a user-written banner decode exit procedure is not in use, these rules
apply for host banner translation:
• Print Output
If the configured Language ID is 0 to 255, NRJE translates the
banner by using the EBCDIC-to-ASCII translation table for the
indicated language. If set to BINARY (-1 translation code), NRJE
assumes it is an EBCDIC banner and will attempt to parse the
banner accordingly. Printer banners are always written to the
output file, translated according to the configuration for the writer.
(If “no translation,” the banner is written without translating.)
• Punch Output
NRJE attempts to parse only those records which are preceded by a
Job Separator PDIR (PDIR byte 3 = 1). For additional information,
see “Peripheral Device Information Record” in Chapter 4 , “Job
Output.” The records are assumed to be in Hollerith regardless of
the language ID configuration field for the logical writer. You can
configure NRJE to assume either Hollerith or EBCDIC banners on
the NMMGR Workstation Data Page 2 screen. If NRJE fails to
obtain a host job number from the banner, it translates the banner
card according to the language ID configuration for the writer.
Punch banners are always written to the output file, unless the
output was received on reserved form CMD. NRJE will not print the
punch banner for output directed to the
formid CMD, even if the
output was redirected by the user with the SUBMIT command.