DEFINE_DLUR_DEFAULTS

DEFINE_DLUR_DEFAULTS defines a default Dependent LU server (DLUS) and a backup default DLUS; if a default DLUS or backup default DLUS is already defined, the verb overrides the existing definition. The default DLUS name is used by DLUR when it initiates SSCP-PU activation for PUs that do not have an explicitly specified associated DLUS. (To define a PU and its associated DLUS, use DEFINE_INTERNAL_PU .)

The verb can also be used to revoke a default DLUS or backup default DLUS, so that none is defined.

VCB Structure

typedef struct define_dlur_defaults
{
      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     description[32];       /* resource description       */
      unsigned char     reserv1[16];           /* reserved                   */
      unsigned char     dlus_name[17];         /* DLUS name                  */
      unsigned char     bkup_dlus_name[17];    /* Backup DLUS name           */
      unsigned char     reserv3;               /* reserved                   */
      unsigned char     dlus_retry_timeout;    /* retry timeout              */
      unsigned char     dlus_retry_limit;      /* retry limit                */
      unsigned char     reserv4[16];           /* reserved                   */
} DEFINE_DLUR_DEFAULTS;

Supplied Parameters

The application supplies the following parameters:

opcode

AP_DEFINE_DLUR_DEFAULTS

description

A null-terminated text string (0-31 characters followed by a null character) describing the DLUR defaults. This string is for information only; it is stored in the node's configuration file, but SNAplus2 does not make any other use of it.

dlus_name

Name of DLUS node which will serve as the default. The name is a 17-byte EBCDIC string, right-padded with EBCDIC spaces. It consists of a network ID of up to 8 A-string characters, an EBCDIC dot (period) character, and a network name of up to 8 A-string characters.

To revoke the current default DLUS, so that no default DLUS is defined, set this parameter to 17 binary zeros.

bkup_dlus_name

Name of DLUS node which will serve as the backup default. The name is a 17-byte EBCDIC string, right-padded with EBCDIC spaces. It consists of a network ID of up to 8 A-string characters, an EBCDIC dot (period) character, and a network name of up to 8 A-string characters.

To revoke the current backup default DLUS, so that no backup default DLUS is defined, set this parameter to 17 binary zeros.

dlus_retry_timeout

Reactivation timer for contacting a DLUS. If SNAplus2 fails to contact the DLUS, this parameter specifies the time in seconds between retries. Specify a value in the range 0x0001-0xFFFF.

dlus_retry_limit

Retry count for contacting a DLUS. This parameter is used to specify the number of times SNAplus2 should retry if it fails to contact the DLUS on the first attempt.

Specify a value in the range 0x0001-0xFFFE, or 0xFFFF to indicate that SNAplus2 should retry indefinitely until it contacts the DLUS.

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_DLUS_NAME: The supplied dlus_name parameter contained a character that was not valid or was not in the correct format.
AP_INVALID_BKUP_DLUS_NAME: The supplied dlus_name parameter contained a character that was not valid or was not in the correct format.

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

Returned Parameters: Function Not Supported

If the verb does not execute successfully because the local node's configuration does not support it, SNAplus2 returns the following parameters:

primary_rc

AP_FUNCTION_NOT_SUPPORTED: The local node does not support DLUR; this is defined by the dlur_supported parameter on the DEFINE_NODE verb.

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.