UDMPX1 is a user-written routine called by the UDUMP utility program after syntax checking the terminal user's request but before calling the utility itself. This routine allows the user to define security restrictions on the access of dumps in the online dump library.
Because the UDMPX1 module is only loaded once per invocation of UDUMP, internal switches can be set and referenced.
A sample UDMPX1 module is distributed with the Com-plete system as a member of the distribution source library and the distribution load library.
Note:
No security exists for UDUMP functions, unless it is established by
you.
This document covers the following topics:
Upon entry to UDMPX1, a set of parameters is received in the form of fullword addresses pointed to by register 1. Word 1 contains the address of the program name for the dump being accessed. Word 2 of the parameter list contains the address of a return code area in which the status of the request is to be indicated.
To define security, check the program name being passed, establish the desired level of authorization, and set the return code to indicate acceptance or rejection.
Upon return from UDMPX1, the return code area is examined by UDUMP. If the return code is not zero, the operation is aborted and a security violation message is issued.
The following table summarizes the UDMPX1 linkage conventions.
| Feature | Convention | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Attributes | None required. | ||||||||
| Type | Thread. | ||||||||
| Size | Restricted to UDUMP region size. | ||||||||
| Registers at Entry |
|
||||||||
| Registers at Return | All registers must be unchanged. | ||||||||
| Parameters |
|
||||||||
| Return Codes |
|
||||||||
| Considerations |
|