QUERY_DEFAULTS

QUERY_DEFAULTS allows the user to query the defaults defined using the DEFINE_DEFAULTS verb.

VCB Structure

typedef struct query_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 */
        DEFAULT_CHARS   default_chars;  /* default information   */
} QUERY_DEFAULTS;
typedef struct default_chars
{
        unsigned char   description[RD_LEN];
                                        /* resource description  */
        unsigned char   mode_name[8];   /* default mode name     */
        unsigned char   implicit_plu_forbidden;
                                        /* disallow implicit     */
                                        /* PLUs ?                */
        unsigned char   specific_security_codes;
                                        /* generic security      */
                                        /* sense codes           */
        unsigned char   limited_timeout;/* timeout for limited   */
                                        /* sessions              */
        unsigned char   reserv[244];    /* reserved              */
} DEFAULT_CHARS;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_QUERY_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
default_chars.description
Resource description (as specified on DEFINE_DEFAULTS). This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.
default_chars.mode_name
Name of the mode specified on the most recent DEFINE_DEFAULTS verb. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces. If no DEFINE_DEFAULTS verb has been issued then this field will be set to all zeros.
default_chars.implicit_plu_forbidden
Controls whether the Program will put implicit definitions in place for unknown Partner LUs (AP_YES or AP_NO).
default_chars.specific_secuity_codes
Controls whether the Program will use specific sense codes on a security authentication or authorization failure (AP_YES or AP_NO). Note that the specific sense codes will only be returned to those partner LUs which have reported support for them on the session.
default_chars.limited_timeout
Specifies the timeout after which free limited-resource conwinnner sessions will be deactivated. Range 0 to 65535 seconds.
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 of a system error, the Program returns the following parameter:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR