z/OS MVS Programming: Sysplex Services Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Note connection identifier

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

Every note in a note pad is associated with some particular connection. The association is first established when the note is created. The association is updated whenever the note is replaced (or written). The connection that issues the relevant create, replace, or write request is the one that becomes associated with the note. Reading or deleting a note does not change the association.

The associated connection is identified by the unique 12 byte connection identifier assigned to the connection by XCF when the connection is created. Note that the connection identifier is not the same as the connection token. The connection identifier can be obtained from the answer area (if any) returned by the IXCNOTE request that created the connection. The connection identifier of the connection associated with a note can be obtained from the answer area (if any) returned by an IXCNOTE request that processes the note.

As described below, you can provide selection criteria to identify the notes to be processed when calling the XCF Note Pad Services to read or delete a collection of notes. One of the possible selection criteria is connection identifier. Thus your program could issue a request to read (or delete) all of the notes in the note pad associated with a given connection identifier.

Associating a note with a connection can also be useful in the context of connection termination. When a connection is deleted, XCF can find and optionally delete the notes associated with that connection. Depending on the needs of the application, you might want XCF to delete some, none, or all the notes associated with a deleted connection. The persistence attribute of a note determines whether the note is to be deleted by XCF.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014