DEFINE_DOWNSTREAM_LU_RANGE defines a new range of downstream
LUs, and maps them to an upstream host LU or LU pool (defined using
DEFINE_LU_0_TO_3 or DEFINE_LU_POOL). This allows the downstream
LUs to access the host computer using the PU concentration feature
of SNAplus2. This verb cannot be used to modify existing downstream
LUs.
The supplied parameters to this verb include a base name for
the new LUs and the range of NAU addresses. The new LU names are
generated by combining the base name with the NAU addresses. For
example, a base name of LUNME combined with a NAU range of 11 to
14 would define the LUs LUNME011, LUNME012, LUNME013 and LUNME014.
VCB
Structure |
 |
typedef struct define_downstream_lu_range
{
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 */
unsigned char dslu_base_name[5]; /* Downstream LU base name */
unsigned char description[32]; /* resource description */
unsigned char reserv1[16]; /* reserved */
unsigned char min_nau; /* Minimum NAU address in range */
unsigned char max_nau; /* Maximum NAU address in range */
unsigned char dspu_name[8]; /* Downstream PU name */
unsigned char host_lu_name[8]; /* Host LU or Pool name */
unsigned char allow_timeout; /* Allow timeout of host LU? */
unsigned char delayed_logon; /* Allow delayed logon to host LU */
unsigned char reserv4[6]; /* reserved */
} DEFINE_DOWNSTREAM_LU_RANGE;
|
Supplied
Parameters |
|
The application supplies the following parameters:
- opcode
AP_DEFINE_DOWNSTREAM_LU_RANGE
- dslu_base_name
Base name for the names of the new LUs. This is
a 5-byte type-A EBCDIC string (starting with a letter), padded on
the right with EBCDIC spaces if the base name is less than 5 characters.
SNAplus2 generates the LU name for each LU by appending the 3-digit decimal
value of the NAU address to this name.
- description
A null-terminated text string (0-31 characters followed by
a null character) describing the downstream LUs (the same string
is used for each LU in the range). This string is for information
only; it is stored in the node's configuration file and returned
on the QUERY_DOWNSTREAM_LU verb, but SNAplus2 does not make any
other use of it.
- min_nau
NAU address of the first LU, in the range 1-255.
- max_nau
NAU address of the last LU, in the range 1-255.
- dspu_name
Name of the downstream PU (as specified on the DEFINE_LS
verb) which the downstream LUs in this range will use. This is an
8-byte type-A EBCDIC string (starting with a letter), padded on
the right with EBCDIC spaces if necessary.
- host_lu_name
Name of host LU or host LU pool that the downstream LUs
in the given range will be mapped to. This is an 8-byte EBCDIC string,
padded on the right with EBCDIC spaces if necessary.
- allow_timeout
Specifies whether to allow the sessions this range
of downstream LUs have with the upstream LU to timeout if the session
is left inactive for the timeout period specified on the upstream
LU definition. Possible values are:
- AP_YES
Allow the sessions this range of downstream LUs
have with the upstream LU to timeout.
- AP_NO
Do not allow the session this range of downstream
LUs have with the upstream LU to timeout.
- delayed_logon
Specifies whether to use delayed logon with this
range of downstream LUs (the upstream LU is not activated until
the user requests it). Possible values are:
- AP_YES
Use delayed logon with this range of downstream
LUs; the upstream LU is not activated until the user requests it.
- AP_NO
Do not use delayed logon with this range of downstream
LUs.
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
Possible values are:
- AP_INVALID_DNST_LU_NAME
The supplied dslu_base_name parameter contained a character that was not valid.
- AP_INVALID_NAU_ADDRESS
One or more of the supplied NAU addresses was not
in the valid range.
- AP_INVALID_ALLOW_TIMEOUT
The supplied allow_timeout parameter value was not valid.
- AP_INVALID_DELAYED_LOGON
The supplied delayed_logon parameter value was not valid.
Appendix A “Common
Return Codes” lists further
secondary return codes associated with AP_PARAMETER_CHECK,
which are common to all NOF verbs.
Returned
Parameters: State Check |
|
If the verb does not execute because of a state error, SNAplus2
returns the following parameters.
- primary_rc
AP_STATE_CHECK
- secondary_rc
Possible values are:
- AP_INVALID_PU_NAME
The specified dspu_name parameter was not valid.
- AP_PU_NOT_DEFINED
The specified dspu_name parameter did not match any defined PU name.
- AP_INVALID_PU_TYPE
The PU specified by the dspu_name parameter is not a downstream PU that supports PU concentration.
- AP_LU_ALREADY_DEFINED
An LU has already been defined with a name that
matches one of the names in the range. The existing LU cannot be
modified using this verb.
- AP_LU_NAU_ADDR_ALREADY_DEFD
An LU has already been defined with an NAU address
that matches one of the addresses in the range.
- AP_INVALID_HOST_LU_NAME
The specified host LU name was not valid.
- AP_LU_NAME_POOL_NAME_CLASH
One of the LU names in the range clashes with the
name of an existing LU pool.
Appendix A “Common
Return Codes” lists further
secondary return codes associated with AP_STATE_CHECK,
which are common to all NOF verbs.
Returned
Parameters: Function Not Supported |
|
If the verb does not execute successfully because the local
node's configuration does not support it, SNAplus2 returns the following parameters:
- primary_rc
- AP_FUNCTION_NOT_SUPPORTED
The local node does not support PU concentration;
this is defined by the pu_conc_supported parameter on the DEFINE_NODE verb.
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
