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


Use of a connection token

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

A connection token is a required input for most connection requests and all requests that manipulate notes in a note pad. When your program issues one of these requests, it must be running in a context where use of the connection token is deemed valid by XCF. Valid contexts are a function of the execution environment, request type, and in some cases, connection attributes (usage classification, access scope, and connection scope). See What is a connection for more information about note pad connections and their attributes. In particular, the phrase "requester is the connector" is defined in Connection scope.

A connection token can only be used on the system that created the connection. XCF rejects an IXCNOTE request that uses a connection token from some other system.

When issuing a pause connection request or a resume connection request, the connection token is valid for use by any work unit that can satisfy at least one of the following conditions:
  • The requester is the connector
  • The home address space is the connector address space
  • The primary address space is the connector address space
  • The program is running authorized
When issuing a delete connection request, the connection token is valid for use by any work unit that can satisfy at least one of the following conditions:
  • The requester is the connector
  • The home address space is the connector address space and the requester has SAF authorization appropriate for the type of access specified when the connection was created
  • The program is running authorized
When issuing a single note request or a multi-note request, the connection token is valid for use by any work unit that can satisfy at least one of the following conditions:
  • The requester is the connector
  • The home address space is the connector address space and requester has SAF authorization appropriate for the type of request:
    • A request to read a note must have READ authority.
    • A request to create, write, replace, or delete a note must have UPDATE authority.
  • The work unit is running supervisor state or PKM allowing key 0 to 7, and either:
    • The connection was created with USAGE=CLIENT, or
    • The connection was created with USAGE=SERVER and the primary address space is the connector address space, or
    • The work unit is running as an address space resource manager.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014