Get_Type

Equivalent to:

LU 6.2 Get_Type
CPI Extract_Conv_Type (CMECT)

Returns the type of conversation to which the specified conversation ID is assigned.

Requirements

Authorization:

Supervisor state or problem state, any PSW key

Dispatchable unit mode:

Task or SRB mode

Cross memory mode:

Any PASN, any HASN, any SASN

AMODE:

31-bit

ASC mode:

Primary or access register (AR)

Interrupt status:

Enabled for I/O and external interrupts

Locks:

Unlocked

Control parameters:

All parameters must be addressable by the caller and in the primary address space.

Format

Figure 1. ATBGETT - LU 6.2 Get_Type

CALL ATBGETT(
        Conversation_id,
        Conversation_type,
        Return_code
       );

Parameters

Conversation_id

Supplied parameter

Type: Character string
Char Set: No restriction
Length: 8 bytes

Conversation_id, sometimes called the resource identifier, identifies a conversation to the system.

Conversation_type

Returned parameter

Type: Integer
Char Set: N/A
Length: 32 bits

Conversation_type specifies the type of conversation on which the call is issued.

Valid values for this parameter are:

Value: Meaning
0: Basic_conversation
1: Mapped_conversation

Return_code

Returned parameter

Type: Integer
Char Set: N/A
Length: 32 bits

Return_code specifies the return code that is returned to the local program. In cases where an error code is returned, the program should not examine any other returned variable associated with the call as nothing is placed in the variables.

See Return Codes for descriptions of return codes that can be returned to a caller of Get_Type.

Return Codes

Valid return code values for the Return_code parameter are:

Table 1. Return Codes for the Get_Type Service
Return Code	Value, Meaning, and Action
0	Value: OK Meaning: The call completed successfully. System Action: The system continues processing. Application Programmer Response: None required.
20	Value: Product_specific_error Meaning: The system found a product-specific error. System Action: The system might write symptom records, which describe the error, to the logrec data set. Application Programmer Response: See Diagnosing Problems with APPC/MVS TPs for methods to use to diagnose the return code. See Error_Extract for the Error_Extract calling format. If necessary, see Diagnosing Product-Specific Errors for more information about product-specific errors.
24	Value: Program_parameter_check Meaning: The system detected a program parameter check. System Action: The system returns this return code to the caller of the APPC service in error. Application Programmer Response: See Diagnosing Problems with APPC/MVS TPs for methods to use to diagnose the return code. See Error_Extract for the Error_Extract calling format.

Restrictions

Transaction programs that call the Get_Type service while in task mode should not have any enabled unlocked task (EUT) functional recovery routines (FRRs) established. For more information about EUT FRRs, see the section on providing recovery in z/OS MVS Programming: Authorized Assembler Services Guide.