DEFINE_LU62_TIMEOUT

The DEFINE_LU62_TIMEOUT verb defines a timeout period for unused LU 6.2 sessions. Each timeout is for a specific resource type (global, mode, local LU, or partner LU) and resource name.

If a define is issued for a resource type/name pair that is already defined, it will overwrite the previous definition. New timeout periods will only take effect for sessions activated after the definition. If more than one relevant timeout period has been defined for a session, the shortest period will apply.

VCB Structure

typedef struct define_lu62_timeout
{
        NB_USHORT   opcode;             /*  verb operation code    */
        NB_BYTE     reserv2;            /*  reserved               */
        NB_BYTE     format;             /*  format                 */
        NB_USHORT   primary_rc;         /*  primary return  code   */
        NB_ULONG    secondary_rc;       /*  secondary return code  */
        NB_BYTE     resource_type;      /*  type of  resource      */
        NB_BYTE     resource_name[17];  /*  name of resource       */
        NB_USHORT   timeout;            /*  timeout period (s)     */
} DEFINE_LU62_TIMEOUT;

Supplied Parameters

The application supplies the following parameters:
opcode
NAP_DEFINE_LU62_TIMEOUT
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
resource_type
Specifies the type of the timeout being defined
NAP_GLOBAL_TIMEOUT
Timeout applies to all LU 6.2 sessions for the local node. The resource name should be set to all zeros.
NAP_LOCAL_LU_TIMEOUT
Timeout applies to all LU 6.2 sessions for the local LU specified in resource_name. Only the first 8 bytes of resource_name are valid and should be set to the name of the local LU. This is an 8-byte alphanumeric type EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
NAP_PARTNER_LU_TIMEOUT
Timeout applies to all LU 6.2 sessions to the partner LU specified in resource_name. All 17 bytes of resource_name are valid and should be set to the fully qualified name of the partner LU, which is padded to the right with EBCDIC spaces. It is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
NAP_MODE_TIMEOUT
Timeout applies to all LU 6.2 sessions on the mode specified in the resource_name. Only the first 8 bytes of resource_name are valid and should be set to the name of the mode. This is an 8-byte alphanumeric type EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
resource_name
Name of the resource that is being defined. See the description of the resource_type parameter for the format of this field.
timeout
Timeout period in seconds. If the value is set to zero, the session becomes free immediately.

Returned Parameters

If the verb executes successfully, SNAP APPN returns the following parameter:
primary_rc
NAP_OK
If the verb does not execute because of a parameter error, SNAP APPN returns the following parameters:
primary_rc
NAP_PARAMETER_CHECK
secondary_rc

NAP_INVALID_RESOURCE_TYPE
NAP_INVALID_LU_NAME
NAP_INVALID_PARTNER_LU
NAP_INVALID_MODE_NAME

If the verb does not execute because the node has not yet been started, SNAP APPN returns the following parameter:
primary_rc
AP_NODE_NOT_STARTED
If the verb does not execute because a STOP_NODE verb has been issued, SNAP APPN returns the following parameter:
primary_rc
NAP_NODE_STOPPING
If the verb does not execute because of a system error, SNAP APPN returns the following parameter:
primary_rc
NAP_UNEXPECTED_SYSTEM_ERROR