QUERY_DLUR_DEFAULTS

QUERY_DLUR_DEFAULTS allows the user to query the defaults defined using the DEFINE_DLUR_DEFAULTS verb.

VCB Structure

typedef struct query_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       */
        DESCRIPTION     description;       /* 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                    */
} QUERY_DLUR_LU;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_QUERY_DLUR_DEFAULTS
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.

Returned Parameters

If the verb executes successfully, the Program returns the following parameters:
primary_rc
AP_OK
description
Resource description. The length of this field should be a multiple of four bytes and nonzero.
dlus_name
Name of the DLUS node that will serve as the default. This is set to all zeros or a 17-byte string composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, and is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
bkup_dlus_name
Name of the DLUS node that will serve as the backup default. This is set to all zeros or a 17-byte string composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, and is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
dlus_retry_timeout
Interval in seconds between the second and subsequent attempts to contact a DLUS. The interval between the initial attempt and the first retry is always one second.
dlus_retry_limit
Maximum number of retries after an initial failure to contact a DLUS. If X'FFFF' is specified, the Program retries indefinitely.
If the verb does not execute because one or more of the relevant START_NODE parameters were not set, the Program returns the following parameters:
primary_rc
AP_FUNCTION_NOT_SUPPORTED
If the verb does not execute because the system has not been built with DLUR support, the Program returns the following parameter:
primary_rc
AP_INVALID_VERB
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 a STOP_NODE verb has been issued, the Program returns the following parameter:
primary_rc
AP_NODE_STOPPING
If the verb does not execute because a system error, the Program returns the following parameter:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR