Previous Page Contents Page Next Page

2.18 define_defaults

The define_defaults command defines default parameters used by the node.

2.18.1 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. SNAP-IX 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 SNAP-IX Administration Guide. The name is a type-A character string starting with a letter.

implicit_plu_forbidden

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

YES

SNAP-IX puts implicit definitions in place for unknown partner LUs.

NO

SNAP-IX does not put implicit definitions in place for unknown partner LUs.

specific_security_codes

Specifies whether SNAP-IX 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

SNAP-IX uses specific sense codes.

NO

SNAP-IX 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.

2.18.2 Returned Parameters

No parameters are returned by SNAP-IX when this command executes successfully.

2.18.3 Error Return Codes

If the command cannot be executed, SNAP-IX 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, SNAP-IX 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 Common Return Codes from snaadmin Commands, occur for this command.

Other Conditions

Common Return Codes from snaadmin Commands, lists additional combinations of primary and secondary return codes that are common to all commands.

Previous Page Contents Page Top of Page Next page