IAZXCTKN — Client token compare service

Description

Use the IAZXCTKN macro to compare two client tokens. This service should be used anytime client tokens have to be compared.

Environment

Environmental factor Requirement
Minimum authorization: Problem state, any PSW key
Dispatchable unit mode: Task or SRB
Cross memory mode: Any PASN, any HASN, any SASN
AMODE: 24- or 31-bit
ASC mode: Primary

Secondary
Access register (AR)
Interrupt status: Enabled for I/O and external interrupts
Locks: The caller may hold locks, but is not required to hold any.
Control parameters: None

Programming requirements

Include the IAZXCTKN mapping macro.

Restrictions

None.

Input register information

Before issuing the IAZXCTKN macro, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register.

Output register information

When control returns to the caller, the general purpose registers (GPRs) contain:
Register
Contents
0-1
Destroyed
2-13
Unchanged
14
Destroyed
15
Return code

Performance implications

None.

Syntax

The IAZXCTKN macro is written as follows:

Syntax Description
   
CTOKENA=ctoken addr ctoken addr: RX-type address or address in register (2) - (13).
   
CTOKENB=ctoken addr ctoken addr: RX-type address or address in register (2) - (13).
   

Parameters

The IAZXCTKN parameters are explained as follows:

,CTOKENA=ctoken addr
Specifies the address of an 80-byte area containing one CTOKEN to be compared.
,CTOKENB=ctoken addr
Specifies the address of an 80-byte area containing one CTOKEN to which CTOKENA is to be compared.

ABEND codes

None.

Return codes

When IAZXCTKN macro returns control to your program. GPR 15 contains a return code.

Table 1. Return Codes for the IAZXCTKN Macro
Hexadecimal Return Code Meaning
00 Meaning: CTOKENA and CTOKENB contain the same significant information.
04 Meaning: CTOKENA and CTOKENB contain different significant information and CTOKENA's sort information is less than CTOKENB's sort information.
08 Meaning: CTOKENA and CTOKENB contain different significant information and CTOKENB's sort information is less than CTOKENA's sort information.
12 Meaning: CTOKENA and CTOKENB contain different significant information and at least one of these ctokens contains no sort information.
16 Meaning: CTOKENA and CTOKENB contain different significant information but the sort information in the two ctokens is equal. This indicates a "collision" of the two ctokens.

Example

IAZXCTKN CTOKENA=BILL,CTOKENB=SAM