The Member Token

When you define a member to XCF through either IXCCREAT or IXCJOIN, XCF assigns a unique (within the sysplex) member token to the member. If a member issues IXCJOIN multiple times, XCF returns a member token for each invocation. In this case, multiple member tokens are associated with the same member.

The member token that XCF returns on IXCCREAT or IXCJOIN can change. XCF assigns a new member token when:

A created member issues IXCJOIN to become active.
A quiesced or failed member issues IXCJOIN to become active once again.
A member ends (becomes failed or not-defined) because its associated task, job step task, address space, or system ends; and the member is then restarted.

Aside from these circumstances, a member token remains the same throughout the duration of the sysplex.

Authorized routines use the member token when requesting XCF services on behalf of a member. For the following macros, a member specifies a member token associated with itself:

IXCLEAVE MEMTOKEN=...
IXCQUIES MEMTOKEN=...
IXCMOD TARGET=...
IXCQUERY MEMTOKEN=
IXCSYSCL MEMTOKEN=
IXCMSGC MEMTOKEN=

For the following macros, a member uses two member tokens. The two member tokens can be the same, or can represent two different members of the same group.

IXCSETUS MEMTOKEN=the caller's member token,TARGET=the target member's member token
IXCTERM MEMTOKEN=the caller's member token,TARGET=the target member's member token
IXCMSGOX MEMTOKEN=the sender's member token,TARGET=the receiver's member token
IXCMSGOX MEMTOKEN=the caller's member token,TARGETS=a table of the member tokens for each receiver
IXCMSGC MEMTOKEN=the caller's member token,SOURCE=token,SOURCE=the member token for which incoming messages are to be collected

Any authorized routine can issue IXCDELET TARGET=the target member's member token.