UCOEX1 is a user-written routine called by UCOPY, the Com-plete screen to hard-copy utility, before writing the screen-data to the printout spooling system. Possible uses of this exit are:
Rejection of the request;
Providing a default hardcopy destination..
This document covers the following topics:
Upon entry to UCOEX1, a set of parameters is received in the form of fullword addresses pointed to by register 1.
Word one of this parameter list contains the address of a full-word to be initialized by the exit; a value of 0 allows access, a value of 4 disallows access.
Word two of this parameter list contains the address of a eight byte field where the exit can supply a valid destination. This value must be in a format acceptable to a PSOPEN call (see the Com-plete Application Programming documentation). If this value is set to blanks, the standard default is taken.
Word three of this parameter list contains the address of the buffer containing the screen-data. The exit must only examine this data, any attempt to modify the contents will result in undefined errors.
The following table summarizes the UCOEX1 linkage conventions.
| Feature | Convention | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Attributes | None required | ||||||||||
| Registers Entry |
|
||||||||||
| Registers at Return | All registers must remain unchanged | ||||||||||
| Return Codes |
|