Set_TimeOut

Sets the time limit in minutes and seconds that each subsequent APPC/MVS conversation call will wait for VTAM APPCCMD requests to complete. For more information, see Setting a Timeout Value for Potential Network Delays.

The Set_Timeout_Value service can also be invoked to alter the previously set timeout_value.

For outbound transaction programs, the Set_TimeOut_Value service can be invoked at any time after the conversation is successfully established by the Allocate or CMINIT service.

For inbound transaction programs, the Set_TimeOut_Value service can be invoked at any time after successful completion of the Get_Conversation, Receive_Allocate, or CMACCP service.

Requirements

Authorization:

Supervisor state or problem state, any PSW key

Dispatchable unit mode:

Task or SRB

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. ATBSTO6 - Set_TimeOut_Value

CALL ATBSTO6(
        Conversation_id,
        Timeout_Value_Minutes,
        Timeout_Value_Seconds,
        Return_code
       );

Parameters

Conversation_ID

Supplied parameter

Type: Character string
Char Set: N/A
Length: 8 bytes

Conversation_ID specifies the conversation ID of the conversation for which you want to time VTAM APPCCMD requests issued during APPC/MVS conversation callable services. Specify the conversation_id that was returned from the Allocate, CMINIT, CMACCP, Get_Conversation. or Receive_Allocate call.

Timeout_Value_Minutes

Supplied parameter

Type: Integer
Char Set: N/A
Length: 32 bits
Value range: 0-1440 (decimal)

Specifies the time in minutes that all subsequent APPC/MVS conversation callable services will wait for VTAM APPCCMD requests to complete.

The maximum supported Timeout_Value_Minutes is 1440 minutes (24 hours). The total APPC timeout value is obtained from this parameter and the Timeout_Value_Seconds parameter. The two values are combined together to give the complete amount of time APPC should wait before timing out the conversation. If both Timeout_Value_Minutes and Timeout_Value_Seconds are zero, VTAM APPCCMD requests issued by subsequent APPC/MVS conversation callable services will not be timed.

Any error in the specification of this parameter will result in a Program_Parameter_Check return code.

Timeout_Value_Seconds

Supplied parameter

Type: Integer
Char Set: N/A
Length: 32 bits
Value range: 0-59 (decimal)

Specifies the time in seconds that all subsequent APPC/MVS conversation callable services will wait for VTAM APPCCMD requests to complete.

The maximum value supported for Timeout_Value_Seconds is 59 seconds. The total APPC timeout value is obtained from this parameter and the Timeout_Value_Minutes parameter. The two values are combined together to give the complete amount of time APPC should wait before timing out the conversation. If both Timeout_Value_Minutes and Timeout_Value_Seconds are zero, VTAM APPCCMD requests issued by subsequent APPC/MVS conversation callable services will not be timed.

Any error in the specification of this parameter will result in a Program_Parameter_Check return code.

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. Possible values of Return_code are:

Return Code

Value, Meaning and Action

Value: OK

Meaning: The call completed successfully.

System Action: The system continues processing.

Application Programmer Response: None required.

Value: Product_Specific_Error

Meaning: The system found a product-specific error.

System Action: The system might write the symptom records which describe the error to the logrec data set.

Application Programmer Response: See Diagnosing Problems with APPC/MVS TPs for methods 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.

Value: Program_Parameter_Check

Meaning: The system detected a program parameter check.

System Action: The system returns this return code to 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 Set_Timeout_Value 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.