![](/images/new-backgrounds/1308428/308428221x1.webp)
Administration Commands
define_ip_port
State Check
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:
DUPLICATE_CP_NAME
The CP name specified in the adj_cp_name parameter has already been defined.
DUPLICATE_DEST_ADDR
The destination address specified in the address parameter has already been defined.
INVALID_LINK_NAME
The link station value specified in the ls_name parameter was not valid.
INVALID_NUM_LS_SPECIFIED
The number of link stations specified was not valid.
LOCAL_CP_NAME
The value specified in the adj_cp_name parameter was the same as the local CP name.
LS_ACTIVE
The link station specified in the ls_name parameter is currently active.
DUPLICATE_TG_NUMBER
The TG number specified in the tg_number parameter has already been defined.
TG_NUMBER_IN_USE
The TG number specified in the tg_number parameter is in use by another link station.
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.33 define_ip_port
The define_ip_port command is used to define a new port for use with Enterprise Extender (HPR/IP), or to modify an existing port. Before issuing this command, you must define the DLC that this port uses.
You can modify an existing port only if it is not started. You cannot change the DLC used by an existing port; the dlc_name specified when modifying an existing port must match the DLC that was specified on the initial definition of the port.
For information about defining a port that will accept incoming calls, see Section 2.33.4, Incoming Calls.
2.33.1 Supplied Parameters
Parameter name | Type | Length | Default |
[define_ip_port] |
|
|
|
port_name | character | 8 |
|
111