The define_downstream_lu_range command defines a range of new downstream LUs and maps
them to an upstream host LU or LU pool. This command cannot be used
to modify existing downstream LUs.
The supplied parameters include a base name for the new LUs
and the range of NAU addresses. The LU base name and NAU addresses
are combined to generate the new LU names. For example, a base name
of LUNME combined with a NAU address in the range 11-14 results
in the following LU names: LUNME011, LUNME012, LUNME013 and LUNME014.
Supplied Parameters |
 |
Parameter name Type Length Default
[define_downstream_lu_range]
dslu_base_name character 5
description character 31 (null string)
min_nau decimal 1
max_nau decimal 1
dspu_name character 8
host_lu_name character 8
allow_timeout constant NO
delayed_logon constant NO
|
Supplied parameters are:
- dslu_base_name
Base name for the names of the new LUs. This name
is a type-A character string of 1-5 characters starting with a letter.
SNAplus2 generates an LU name for each LU by appending the 3-digit
decimal value of the NAU address to the base name.
- description
A text string describing the downstream LUs; the
same string is used for each LU in the range. SNAplus2 uses this
string for information only. It is stored in the node's configuration
file and returned on the query_downstream_lu command.
- 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 define_*_ls, where * is replaced by the LS type) that the downstream LUs
in this range use. The name is a type-A character string starting
with a letter.
- host_lu_name
Name of the host LU or host LU pool to which the downstream
LUs in the given range are mapped. The name is an 8-byte character
string.
- 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:
- YES
Allow the sessions this range of downstream LUs
have with the upstream LU to timeout.
- 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:
- YES
Use delayed logon with this range of downstream
LUs; the upstream LU is not activated until the user requests it.
- NO
Do not use delayed logon with this range of downstream
LUs.
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.
If the command does not execute because of a parameter error,
SNAplus2 returns the following parameters:
- primary_rc
PARAMETER_CHECK
- secondary_rc
Possible values are:
- INVALID_DNST_LU_NAME
The supplied dslu_base_name parameter contained a character that was not valid.
- INVALID_NAU_ADDRESS
The min_nau parameter value, max_nau parameter value, or both parameter values were not
in the valid range.
- INVALID_ALLOW_TIMEOUT
The supplied allow_timeout parameter value was not valid.
- INVALID_DELAYED_LOGON
The supplied delayed_logon parameter value was not valid.
If the command does not execute because of a state error,
SNAplus2 returns the following parameters:
- primary_rc
STATE_CHECK
- secondary_rc
Possible values are:
- INVALID_PU_NAME
The specified dspu_name parameter value was not valid.
- PU_NOT_DEFINED
The specified dspu_name parameter did not match any defined PU name.
- INVALID_PU_TYPE
The PU specified by the dspu_name parameter is not a downstream PU that supports PU concentration.
- 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 command.
- LU_NAU_ADDR_ALREADY_DEFD
An LU has already been defined with an NAU address that
matches one of the addresses in the range.
- INVALID_HOST_LU_NAME
The specified host_lu_name parameter value was not valid.
- LU_NAME_POOL_NAME_CLASH
One of the LU names in the range matches the name
of an existing LU pool.
If the command does not execute because the node's configuration
does not support it, SNAplus2 returns the following parameters:
- primary_rc
- FUNCTION_NOT_SUPPORTED
The local node does not support PU concentration;
this support is defined by the pu_conc_support parameter on the define_node command.
- secondary_rc
(This parameter is not used.)
Printable version
