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