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

Appendix A 223
Parsing Algoithms and User Exit Procedures
Banner Decode Exit Procedure Specification
If neither Filenum nor Jobnum is returned, NRJE passes the entire data
set to the procedure and logs a warning message. NRJE assumes that
the exit procedure is handling all output routing and writing
operations.
If an exit procedure opens an output file by using the COMMAND intrinsic
to execute a file equation, and then uses an FOPEN that back-references
the file equation, it should also issue a RESET (using the COMMAND
intrinsic) to remove the file equation before returning to NRJE. This is
required to minimize the possibility of NRJE misrouting output on
other writers.
For “End of Data Set” calls to the exit procedure (line length of -1), the
returned values for
Filenum and Jobnum are ignored.
This hierarchy is used to resolve any routing specification conflicts:
Banner Decode
Filenum return
overrides
Job Log routing information (SUBMIT command parms)
overrides
Lookup Table form-to-file mapping (user’s JCL “FORM”
specification)
overrides
Defaults.
The procedure will be called by the SNA NRJE Logical Unit, which will
be running with traps on, in user mode. The NRJELU is “prepped”
with PM, PH, DS, MR, IA, and BA capabilities.
An SPL example of a banner decode exit procedure for use with JES2
banners is shown below. This example is also in the SAMPEXIT sample
file in NRJE.SYS.