All addresses are 31-bit.
The register contents on entry to EOXVX02 are:
Register Contents
- 0
- Not applicable
- 1
- Address of the parameter list
- 2-12
- Not applicable
- 13
- Register save area
- 14
- Return address
- 15
- Entry point address of EOXVX02
Register 1 on entry points to the following parameter list:
- Word 1
- The address of a fullword containing the version level for this
exit. This word is currently 1.
- Word 2
- The address of a fullword containing an installation-wide exit
communication value. This communication value is passed to all
the installation-wide exits. This field is initialized to
binary zeros when BookManager READ begins execution.
- Word 3
- The address of a fullword containing an EOXVX02 exit
communication value. This communication value is passed to
EOXVX02 every time it is invoked. This field is initialized to
binary zeros when BookManager READ begins execution. Note that
this communication value is unique to this exit, while the value
pointed to by word 2 is common to all the installation exits.
- Word 4
- The address of a fullword containing the reason this exit was
called. This exit is called for the following reasons:
Value Reason
- 0
- Book being opened
- 1
- Book being closed
- 2
- BookManager READ is initializing
- 3
- BookManager READ is terminating
- Word 5
- The address of 8192 bytes of storage that can be used by this
exit for temporary storage. This area is located below 16
megabytes of virtual storage (that is, it can be addressed if
executing in 24-bit mode).
- Word 6
- The address of a character string containing the data set name
of the book being opened or closed. The character string is
terminated by a X'00'. The content is meaningful only for entry
reason 0 (book being opened) and 1 (book being closed).
- Word 7
- The address of a character string containing the document number
of the book. The character string is terminated by a X'00'.
The string is empty (that is, the first character is a X'00') if
the book does not have a document number. The content is
meaningful only for entry reasons 0 (book being opened) and 1
(book being closed).
- Word 8
- The address of a fullword that is set by BookManager READ to
binary zero before calling the exit for reason 0 (book being
opened). The value placed in this word by the exit is returned
to the exit when it is called for reason 1 (book being closed).
The content is meaningful only for entry reasons 0 (book being
opened) and 1 (book being closed).
On return from EOXVX02, the register contents must be:
Register Contents
- 0-14
- Restored to contents on entry
- 15
- A value of 0
|