DEFINE_DEFAULTS specifies default parameters used by the node.
VCB
Structure |
 |
typedef struct define_defaults
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
DEFAULT_CHARS default_chars; /* default parameters */
} DEFINE_DEFAULTS;
|
typedef struct default_chars
{
unsigned char description[32]; /* resource description */
unsigned char reserv2[16]; /* reserved */
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? */
AP_UINT16 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
- default_chars.description
A null-terminated text string (0-31 characters followed by
a null character) describing the default parameters. This string
is for information only; it is stored in the node's configuration
file and returned on the QUERY_DEFAULTS verb, but SNAplus2 does
not make any other use of it.
- default_chars.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 will be used as a default definition for
the unrecognized mode.
This must be either a mode defined by a previous DEFINE_MODE
verb or one of the SNA-defined modes listed in “Purpose
of the NOF API”. The name is an 8-byte type-A EBCDIC string
(starting with a letter), padded on the right with EBCDIC spaces
if necessary.
- default_chars.implicit_plu_forbidden
Specifies whether SNAplus2 puts implicit definitions
in place for unknown partner LUs. Possible values are:
- AP_YES
SNAplus2 puts implicit definitions in place for
unknown partner LUs.
- AP_NO
SNAplus2 does not put implicit definitions in place
for unknown partner LUs.
- default_chars.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:
- AP_YES
SNAplus2 uses specific sense codes.
- AP_NO
SNAplus2 does not use specific sense codes.
- default_chars.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: Successful Execution |
|
If the verb executes successfully, SNAplus2 returns the following parameters:
Returned
Parameters: Parameter Check |
|
If the verb does not execute because of a parameter error,
SNAplus2 returns the following parameters:
- primary_rc
AP_PARAMETER_CHECK
- secondary_rc
- AP_INVALID_MODE_NAME
The mode_name parameter did not match any defined mode name.
Appendix A “Common
Return Codes” lists further
secondary return codes associated with AP_PARAMETER_CHECK,
which are common to all NOF verbs.
Returned
Parameters: Other Conditions |
|
Appendix A “Common
Return Codes” lists further
combinations of primary and secondary return codes that are common
to all NOF verbs.
Printable version
