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


Identifying the Lock Owner

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

When your program issues the IXLCONN macro to connect to the list structure, it becomes a list structure connector and acquires several types of identification:
Connection token (CONTOKEN)
A system-assigned token to be used on all subsequent list structure operations. You receive a new one each time you connect or reconnect.
Connection ID (CONID)
A system-assigned ID to identify your connection to other list structure connectors. You receive a connection ID each time you connect but you receive the same connection ID as you had last time if you reconnect.
Connection name (CONNAME)
A connection name to describe your connection. You can choose the name yourself using the IXLCONN macro, or have the system assign your connection a name.

While you receive a new connection token and a new connection ID every time you connect to the list structure, you can use the same connection name each time. Your connection name allows you to be recognized by other connectors as the same entity with a different connection token and connection ID.

If multiple programs in the same address space issue IXLLIST requests, they share the same connect token, connection ID, and connection name. In this case, you will need to use additional, non-connection-related identifiers to indicate the lock-owning program.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014