ACSUUEX2 - ACCESS Read-Intercept Exit

#### Search Results

Search

# ACSUUEX2 - ACCESS Read-Intercept Exit

ACSUUEX2 is a user-written routine that normally passes the data on to the target system; it can, however, also bypass the target system and invoke ACSUUEX1, the write-intercept exit, in order to produce a response to the user's input. The routine ACSUUEX2 can also be used to initiate commands to the host operating system, for example, CMS/CP commands.

This document covers the following topics:

- How to Create ACSUUEX2

- How to Use ACSUUEX2

- ACSUUEX2 Conventions

## How to Create ACSUUEX2

To create a ACSUUEX2 routine, the following steps are required:

> Step 1

>   Code the ACSUUEX2 routine entry of ACSEXITS (A.ACSEXITS for z/VSE, or ACSEXITS ASSEMBLE for CMS).

> Step 2

>   Assemble and link ACSEXITS (A.ACSEXITS for z/VSE) into the ACCESS load library (relo library for z/VSE). For z/OS and z/VSE, have the ACCESS source library referred to during assemblies. Or for CMS only, assemble ACSEXITS with the ACCESS macro library referenced.

> Step 3

>   Link edit ACSEXITS (A.ACSEXITS for z/VSE) to the ACCESS driver for the host Adabas TPF, CICS, or TSO system. Member JCLLINKA (A.JCLLINKA for z/VSE) in the ACCESS source library contains the link edit JCL for all TP monitors supported. Or for CMS only, execute the EXEC GENACS.

## How to Use ACSUUEX2

Members CCACSWK and CCACSPFX in the distributed source library are DSECTS referred to in the main ACCESS routine. These areas are addressable in the ACSUUEX2 exit. A skeleton entry is provided in member ACSEXITS (A.ACSEXITS for z/VSE) of the ACCESS source library.

## ACSUUEX2 Conventions

The following table summarizes the ACSUUEX2 linkage conventions.

Feature | Convention
--- | ---
Attributes | None required.
Size | Restricted to the ACS driver region.
Registers at Entry |
Register 0 | Input length.
Register 1 | Address of the input area
Register 6 | Address of the ACCESS prefix
Register 9 | Address of the ACCESS work area
Register 10 | Main ACCESS driver base address
Register 13 | Address of an 18-fullword save area
Register 15 | Entry address within ACSUUEX2
Registers at return | All registers must be restored.
Return Codes |
0 | Continue with read.
4 | Tell target node to rewrite the screen.
Considerations | Must be assembled and link edited with the ACS driver.

### On this page

- How to Create ACSUUEX2
- How to Use ACSUUEX2
- ACSUUEX2 Conventions