Write-request exit MARENEX2

The write-request exit is called before an catalog entry is modified. It permits the following activities, for example:

• Check what change is to be performed and the action initiating the change.

• Also change particular catalog entry fields.

• Reject modification according to special criteria.

The following catalog entry fields must not be changed by the write-request exit:

LAFUNKFL		Flag for the action to be performed by the program
LAFUNKNM		Name of the calling MAREN components or abbreviated name of the MAREN or MARENADM statement entered
ARCHIVNR		Tape VSN
FSEQ		File sequence number
VSEQ		File section number
NUMMANF		Internal field for passing ISAM keys
ACCOUNT		Access counter
RESCOUNT		Reservation counter
PRUEFZ		Check digit
DEVICE		Device type
STATUS		Tape status
DOMAIN		Domain
If one of these catalog entry fields is changed by the request exit, the loaded program, e.g. MARENCP, is terminated with message MARCP27.
If any of the following catalog entry fields is filled with dollar ($) characters, the field is restored to its original value or filled with blanks (LATSN only):
PASSWORD		Password
LAUSERID		User ID of the last access
LAACC		Account number of the last access
LATSN		TSN of the last access

 

Return codes

The write-request exit returns the following information via register 15:

Register contents	Meaning/reaction from MARENUCP
0	The request should be granted. The catalog entry is modified using any preset values from the exit.
4	The request is to be rejected. The catalog entry is not modified.The caller receives message MARCP24 and the action (e.g. an ADD-FILE-LINK command) or statement involved (e.g. MODIFY-VOLUME-ATTRIBUTES) is aborted.
other	The system responds in the same way as when return code “4” is passed.