define_defaults

The define_defaults command defines default parameters used by the node.

Supplied Parameters

Parameter name             Type           Length     Default
[define_defaults]
description                character      31         (null string)
mode_name                  character      8
implicit_plu_forbidden     constant                  (NO)
specific_security_codes    constant                  (NO)
limited_timeout            decimal                   (0)

Supplied parameters are:

description

A text string describing the default parameters. SNAplus2 uses this string for information only. It is stored in the node's configuration file and returned on the query_defaults command.

mode_name

Name of the default mode. If an application specifies an unrecognized mode name when attempting to start a session, the parameters from this mode are used as a default definition for the unrecognized mode.

This mode must be either an SNA-defined mode or a mode defined by a previous define_mode command. For more information about SNA-defined modes, refer to the HP-UX SNAplus2 Administration Guide. The name is a type-A character string starting with a letter.

implicit_plu_forbidden

Specifies whether SNAplus2 puts implicit definitions in place for unknown partner LUs. Possible values are:

YES: SNAplus2 puts implicit definitions in place for unknown partner LUs.
NO: SNAplus2 does not put implicit definitions in place for unknown partner LUs.

specific_security_codes

Specifies whether SNAplus2 uses specific sense codes on a security authentication or authorization failure. Specific sense codes are only returned to those partner LUs which have reported support for them on the session. Possible values are:

YES: SNAplus2 uses specific sense codes.
NO: SNAplus2 does not use specific sense codes.

limited_timeout

Specifies the timeout after which free limited-resource conwinner sessions are deactivated. Specify a value in the range 0-65,535 seconds.

Returned Parameters

No parameters are returned by SNAplus2 when this command executes successfully.

Error Return Codes

If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.

Parameter Check

If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

PARAMETER_CHECK

secondary_rc

INVALID_MODE_NAME: The mode_name parameter did not match any defined mode name.

State Check

No specific state errors, other than those listed in Appendix A “Common Return Codes from snapadmin Commands” occur for this command.

Other Conditions

Appendix A “Common Return Codes from snapadmin Commands” lists additional combinations of primary and secondary return codes that are common to all commands.