Overview

Issue the IXCNOTE macro with REQUEST=NOTE to process one particular note in the note pad. Sometimes a single note request is simply called a note request. The note of interest is identified by its name. A note can be created in the note pad by issuing a create note request or a write note request. The content of a note can be updated by issuing a replace note request or a write note request. Both replace and write can be used to either delete the content of a note (causing it to become a null note) or to create content where the note previously had none. A note is deleted from the note pad by issuing a delete note request. A read request can be used to test for the existence of a note, or to read the metadata of a note, or to read the content of a note, or to read both the metadata and content of a note.

Use the REQTYPE keyword to indicate the type of operation to be performed for the note. Refer to the following material for specific information on each request type:

For REQTYPE=CREATE, which is used to create a new note, see Create note
For REQTYPE=WRITE, which is used to create or replace a note depending on whether it already exists or not, see Write note
For REQTYPE=REPLACE, which is used to replace an existing note, see Replace note
For REQTYPE=READ, which is used to read an existing note, see Read note
For REQTYPE=DELETE, which is used to delete an existing note, see Delete note

In general, a single note request sends one operation to the coupling facility that contains the note pad. XCF asks XES to perform the operation as a synchronous coupling facility request. If the note pad is not accessible from the local system, the request is rejected and the note pad is said to be quiesced. See Quiescing conditions.