Command Reference Guide

Administration Commands
define_downstream_lu
2.18 define_domain_config_file
The define_domain_config_file command specifies an optional comment string to be included in the
header of a domain configuration file. If you are creating a domain configuration file using a text editor, this
comment string must be the first record in the file.
2.18.1 Supplied Parameters
Parameter name Type Length Default
[define_domain_config_file]
comment character 100 (null string)
The supplied parameter is:
comment
An optional comment string containing information about the file. SNAplus2 uses the string for information
only. It is stored in the node’s configuration file and returned on the query_domain_config_file
command.
2.18.2 Returned Parameters
No parameters are returned by SNAplus2 when this command executes successfully.
2.18.3 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.
Parameter Check
No parameter errors occur for this command.
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands,
occur for this command.
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary
return codes that are common to all commands.
2.19 define_downstream_lu
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.
This command can also be used to activate a downstream LU that is already defined (for example, because the
downstream workstation has just been activated). To do this, reissue the define_downstream_lu command
for that LU. Note that all parameters must be the same as in the original definition, because you cannot modify the
definition.
79