The define_downstream_lu command defines a new downstream LU and maps it to an
upstream host LU or LU pool. This enables the downstream LU to access
the host computer using the PU concentration feature of SNAplus2.
This command cannot be used to modify an existing downstream LU.
If you need to activate a downstream LU that is already defined
(for example, because the downstream workstation has just been activated), issue
the define_downstream_lu command for that LU.
Supplied Parameters |
 |
Parameter name Type Length Default
[define_downstream_lu]
dslu_name character 8
description character 31 (null string)
nau_address character 8
host_lu_name character 8
allow_timeout constant NO
delayed_logon constant NO
|
Supplied parameters are:
- dslu_name
Name of the downstream LU to be defined. This name is
a type-A character string starting with a letter.
- description
A text string describing the downstream LU. SNAplus2 uses
this string for information only. It is stored in the node's configuration
file and returned on the query_downstream_lu command.
- nau_address
Network accessible unit (NAU) address of the downstream
LU. This must be in the range 1-255.
- dspu_name
Name of the downstream PU associated with this LU, as
specified on define_*_ls. This name is a type-A character string starting with
a letter.
- host_lu_name
Name of the host LU or host LU pool that the downstream
LU uses. This name is an 8-byte character string.
For PU concentration, the host LU cannot be a dependent LU
type 6.2. However, if the downstream LU is LU type 6.2, you can
configure the host LU as an LU type 0-3 and specify that the model
type for the host LU is unknown.
- allow_timeout
Specifies whether to allow the session between the downstream
LU and 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 session this downstream LU has with the upstream
LU to timeout.
- NO
Do not allow the session this downstream LU has
with the upstream LU to timeout.
- delayed_logon
Specifies whether to use delayed logon with this downstream
LU (the upstream LU is not activated until the user requests it).
Possible values are:
- YES
Use delayed logon with this downstream LU; the upstream
LU is not activated until the user requests it.
- NO
Do not use delayed logon with this downstream LU.
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_name parameter contained a character that was not valid.
- INVALID_NAU_ADDRESS
The supplied NAU address was 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 with the name specified by the dslu_name parameter has already been defined, and cannot be modified
using this command.
- LU_NAU_ADDR_ALREADY_DEFD
An LU with the NAU address specified by the nau_address parameter has already been defined.
- INVALID_HOST_LU_NAME
The specified host_lu_name parameter value was not valid.
- LU_NAME_POOL_NAME_CLASH
The specified LU name matches the name of an existing
LU pool.
- PU_NOT_ACTIVE
The PU specified by the dspu_name parameter is not currently active.
- LU_ALREADY_ACTIVATING
An LU with the name specified by the dslu_name parameter is currently activating.
- LU_DEACTIVATING
An LU with the name specified by the dslu_name parameter is currently deactivating.
- LU_ALREADY_ACTIVE
An LU with the name specified by the dslu_name parameter is already active.
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
