DEFINE_DEFAULTS

DEFINE_DEFAULTS allows the user to define or redefine default actions of the node.

VCB Structure

typedef struct define_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   */
} DEFINE_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;
                                        /* generiuc security     */
                                        /* sense codes           */
        unsigned short  limited_timeout;/* timeout for limited   */
                                        /* sessions              */
        unsigned char   reserv[244];    /* reserved              */
} DEFAULT_CHARS;

Supplied Parameters

The application supplies the following parameters:

opcode: AP_DEFINE_DEFAULTS
format: Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
default_chars.description: Resource description (returned on QUERY_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 that will serve as the default. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
default_chars.implicit_plu_forbidden: Controls whether the Program puts implicit definitions in place for unknown Partner LUs (AP_YES or AP_NO).
default_chars.specific_security_codes: Controls whether the Program uses specific sense codes on a security authentication or authorization failure (AP_YES or AP_NO). Note, specific sense codes will only be returned to those partner LUs that have reported support for them on the session.
default_chars.limited_timeout: Specifies the timeout after which free limited-resource conwinner sessions will be deactivated. Range 0 to 65535 seconds.

Returned Parameters

If the verb executes successfully, the Program returns the following parameter:

primary_rc: AP_OK

If the verb specifies a default mode that is not valid (for example, not EBCDIC A), or is valid but has not been defined, the Program returns the following parameters:

primary_rc: AP_PARAMETER_CHECK
secondary_rc: AP_INVALID_MODE_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

The effect of redefinition of each field is as follows:

description: The redefinition takes effect immediately. The updated description is returned on subsequent QUERY_DEFAULT verbs.
mode_name: The effect of a redefinition applies to all subsequent implicit mode definitions, for example, the updated mode serves as the default mode. The effect of a redefinition on a previously unknown mode (for example, one that had inherited the previous default mode characteristics) is identical to a redefinition of the unknown mode. For example, if the default mode is #INTER, and the Program receives a bIND for (an unknown) MODE1, the effect on MODE1 of the default mode subsequently being redefined to #BATCH should be identical to the effect of a DEFINE_MODE(MODE1) specifying the mode characteristics of #BATCH.
implicit_plu_forbidden: The redefinition takes effect immediately. All subsequent implicit PLU definitions succeed or fail depending on the updated value of this field.
specific_security_codes: The redefinition takes effect immediately.
limited_timeout: The updated value is used for all new session established after the redefinition. The old value is used for existing sessions.