UCOEX1 - UCOPY User Exit

#### Search Results

Search

# UCOEX1 - UCOPY User Exit

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:

- How to use UCOEX1

- UCOEX1 Conventions

## How to use UCOEX1

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.

## UCOEX1 Conventions

The following table summarizes the UCOEX1 linkage conventions.

Feature | Convention
--- | ---
Attributes | None required
Registers Entry |
Register 0 |
Register 1 | Address of the parameter list
Register 13 | Address of an 18-fullword savearea
Register 14 | Return address.
Register 15 | Entry address.
Registers at Return | All registers must remain unchanged
Return Codes |
0 | Allow access
4 | Disallow access

### On this page

- How to use UCOEX1
- UCOEX1 Conventions