Coding the Signon exit routine for associated printing
To use associated printing, code the Signon exit routine (DFSSGNX0).
Code the Signon exit routine to do each of the following steps:
- Identify the printer LU name and user name for each screen user.
- Determine printer node names from the input user data.
- Name user-related LTERM structures to service the selected printers.
- Enable application programs to determine (using the user ID) the queues associated with a particular user so that the programs can insert to the correct message queue (alternate PCB).
- Pass the printer node names to IMS as associated print parameters.
- Determine the user name that is allocated to each printer when
users supply printer node names. You can use either an algorithm or
a table to make this determination. The exit routine should pass these
user names to IMS, which then
creates the necessary user control blocks.
A unique name should exist for the user ID that is signed on and for each printer-related user that is required.
Example: To indicate the name of a user's printer identification, add a
P
to the end of the user ID. If the user ID is AAA, the name of this user's printer identification is AAAP. - Specify one value for each of up to four printers (the number of simple checkpoints before the user structure is deleted).
The application program can use the same method as the Signon exit routine in order to determine the printer LTERM name from the input terminal user ID and queue output data as required through an alternate PCB. When output data is queued, IMS allocates the user structure to the correct printer and delivers the output.
After associated printer LTERMs are allocated and then emptied, the queues are deallocated from the terminal.