DEFINE_LU62_TIMEOUT

The DEFINE_LU62_TIMEOUT verb defines a timeout period for unused LU 6.2 sessions. Each timeout is for a specified resource type and resource name. If a DEFINE_* verb is issued for a resource type and name pair already defined, the command overwrites the previous definitions. New timeout periods are only used for sessions activated after the definition is changed.

If more than one relevant timeout period is defined for a session, the shortest period applies.

VCB Structure

typedef struct define_lu62_timeout
{
  AP_UINT16         opcode;                         /* verb operation code   */
  unsigned char     reserv2;                        /* reserved              */
  unsigned char     format;                         /* reserved              */
  AP_UINT16         primary_rc;                     /* primary return code   */
  AP_UINT32         secondary_rc;                   /* secondary return code */
  unsigned char     resource_type;                  /* resource type         */
  unsigned char     resource_name[17];              /* resource name         */
  AP_UINT16         timeout;                        /* timeout               */
} DEFINE_LU62_TIMEOUT;

Supplied Parameters

The application supplies the following parameters:

opcode

AP_DEFINE_LU62_TIMEOUT

resource_type

Specifies the type of timeout to be defined. Possible values are:

AP_GLOBAL_TIMEOUT: Timeout applies to all LU 6.2 sessions for the local node. The resource_name parameter should be set to all zeros.
AP_LOCAL_LU_TIMEOUT: Timeout applies to all LU 6.2 sessions for the local LU specified in the resource_name parameter.
AP_PARTNER_LU_TIMEOUT: Timeout applies to all LU 6.2 sessions to the partner LU specified in the resource_name parameter.
AP_MODE_TIMEOUT: Timeout applies to all LU 6.2 sessions on the mode specified in the resource_name parameter.

resource_name

Name of the resource being queried. This value can be one of the following:

If resource_type is set to AP_GLOBAL_TIMEOUT, do not specify this parameter.
If resource_type is set to AP_LOCAL_LU_TIMEOUT, specify 1-8 locally displayable type-A characters as a local LU name.
If resource_type is set to AP_PARTNER_LU_TIMEOUT, specify the fully qualified name of the partner LU as follows: 17 locally displayable type-A characters consisting of a 1-8 character network name, followed by a period, followed by a 1-8 character partner LU name.
If resource_type is set to AP_MODE_TIMEOUT, specify 1-8 locally displayable type-A characters as a mode name.

timeout

Timeout period in seconds. A value of 0 (zero) indicates that the session immediately becomes free.

Returned Parameters: Successful Execution

If the verb executes successfully, SNAplus2 returns the following parameters:

primary_rc: AP_OK

Returned Parameters: Parameter Check

If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

AP_PARAMETER_CHECK

secondary_rc

Possible values are:

AP_INVALID_RESOURCE_TYPE: The type of timeout defined was not valid.
AP_INVALID_LU_NAME: The resource_type parameter specified an LU name that was not valid.
AP_INVALID_PARTNER_LU: The resource_type parameter specified a partner LU name that was not valid.
AP_INVALID_MODE_NAME: The resource_type parameter specified a mode name that was not valid.

Appendix A “Common Return Codes” lists further secondary return codes associated with AP_PARAMETER_CHECK, which are common to all NOF verbs.

Returned Parameters: Other Conditions

Appendix A “Common Return Codes” lists further combinations of primary and secondary return codes that are common to all NOF verbs.

DEFINE_LU62_TIMEOUT

Technical documentation

» Table of Contents

» Index

VCB Structure

Supplied Parameters

Returned Parameters: Successful Execution

Returned Parameters: Parameter Check

Returned Parameters: Other Conditions