DEFINE_DLUR_DEFAULTS

DEFINE_DLUR_DEFAULTS allows the user to define, redefine, or revoke a default dependent LU server (DLUS) and a backup default DLUS. 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. If a DLUS name is not specified explicitly on the DEFINE_DLUR_DEFAULTS verb then the current default (or backup DLUS) is revoked.

VCB Structure

typedef struct define_dlur_defaults
{
        unsigned short  opcode;             /* verb operation code   */
        unsigned char   reserv2;            /* reserved              */
        unsigned char   format;             /* format                */
        unsigned short  primary_rc;         /* primary return code   */
        unsigned long   secondary_rc;       /* secondary return code */
        unsigned char   description[RD_LEN];
                                            /* resource description  */
        unsigned char   dlus_name[17];      /* DLUS name             */
        unsigned char   bkup_dlus_name[17]; /* Backup DLUS name      */
        unsigned char   reserv3;            /* reserved              */
        unsigned short  dlus_retry_timeout; /* DLUS Retry Timeout    */
        unsigned short  dlus_retry_limit;   /* DLUS Retry Limit      */
        unsigned char   reserv4[16];        /* reserved              */
} DEFINE_DLUR_DEFAULTS;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DEFINE_DLUR_DEFAULTS
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
description
Resource description. This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.
dlus_name
Name of the DLUS node that will serve as the default. This should be set to all zeros or a 17-byte string composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, which is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.) If this field is set to all zeros, the current default DLUS is revoked.
bkup_dlus_name
Name of the DLUS node that will serve as the backup default. This should be set to all zeros or a 17-byte string composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, which is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.) If this field is set to all zeros, the current backup default DLUS is revoked.
dlus_retry_timeout
Interval in seconds between second and subsequent attempts to contact a DLUS. The interval between the initial attempt and the first retry is always one second. If zero is specified, the default value of 5 seconds is used.
dlus_retry_limit
Maximum number of retries after an initial failure to contact a DLUS. If zero is specified, the default value of 3 is used. If X'FFFF' is specified, Personal Communications or Communications Server will retry indefinitely.

Returned Parameters

If the verb executes successfully, the Program returns the following parameter:
primary_rc
AP_OK
If the verb does not execute because of a parameter error, the Program returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_DLUS_NAME

AP_INVALID_BKUP_DLUS_NAME

If the verb does not execute because the node has not yet been started, the Program returns the following parameter:
primary_rc
AP_NODE_NOT_STARTED
If the verb does not execute because the node is stopping, the Program returns the following parameter:
primary_rc
AP_NODE_STOPPING
If the verb does not execute because of a system error, the Program returns the following parameter:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR