Snacfg APPCLLU

Purpose

Allows you add, delete, modify, or view a local APPC LU. Also allows you to view the command that would create a specified local APPC LU.

Note   Configuration settings specified with snacfg appcllu correspond to local APPC LU settings configured with SNA Server Manager. Syntax snacfg [#configpath] appcllu /list Recommended Syntax snacfg [#configpath] appcllu servername:LUalias
snacfg [#configpath] appcllu LUalias /add /server:servername [options]
snacfg [#configpath] appcllu servername:LUalias [options]
snacfg [#configpath] appcllu servername:LUalias /delete
snacfg [#configpath] appcllu servername:LUalias /print Other Available Syntax snacfg [#configpath] appcllu /list
snacfg [#configpath] appcllu LUalias
snacfg [#configpath] appcllu LUalias [options]
snacfg [#configpath] appcllu LUalias /delete
snacfg [#configpath] appcllu LUalias /print

where
 

#configpath
Specifies the path of the configuration file to view or change. If the configuration path is omitted, SNA Server will attempt to access the configuration file on the local system, using the path \SNAServerRoot\SYSTEM\CONFIG\COM.CFG, where SNAServerRoot is the SNA Server root directory.
/list
Generates a list of configured local APPC LUs.
servername:LUalias
Specifies the server name and LU alias of the local APPC LU on which to carry out actions. The server name should be in the format machine_name or \\machine_name\snaservr (for specifying the primary node on the machine) and \\machine_name\snasrv02 (or snasrv03, snasrv04, etc.) for specifying the secondary nodes on the machine.

It is recommended that servername: be included in snacfg appcllu commands (other than /add commands) that include LUalias. Without servername:, if there is more than one local LU called LUalias in the subdomain, it is difficult to predict which of these LUs will be affected by the command. The snacfg appcllu command does not necessarily default to the local server if servername is omitted.

See the following paragraphs for details about characters permitted in the LU alias.

If no options are specified after LUalias, the configuration settings, partner LUs, and modes are displayed for the specified LU.

LUalias
Specifies the LU alias of the local APPC LU on which to carry out actions. See the previous paragraphs and the syntax lists for recommendations about using the server name with the LU alias.

The LU alias can be from one through eight characters long, and can contain alphanumeric characters and the special characters %, $, #, and @. Lowercase letters are converted to uppercase. For a local APPC LU, the LU alias must be unique on the server.

Note that LUalias is used as the default LU name if /luname:text is not specified.

If no options are specified after LUalias, the configuration settings, partner LUs, and modes are displayed for the specified LU.

/add
Adds a local APPC LU called LUalias. To configure the LU, either specify other options after /add, or specify configuration options in additional snacfg appcllu commands (using the same LUalias).
/connection:conn-name
When adding or modifying a dependent local APPC LU, this option is used to specify the LU’s connection assignment.
/delete
Deletes the LU called LUalias.
/print
Causes the display of the snacfg command that would create the specified local APPC LU. The displayed command does not contain the word snacfg, so that it can be redirected to a command file.
options
Are as shown in the following list.
Options for Local APPC LUs
 
/server:servername
Specifies the server to which to assign or move the APPC LU. When /add is used, this option is required. The server name should be in the format machine_name or \\machine_name\snaservr (for specifying the primary node on the machine) and \\machine_name\snasrv02 (or snasrv03, snasrv04, etc.) for specifying the secondary nodes on the machine.
/lunumber:value
Specifies the LU number. If an LU number of 0 is specified, the LU is configured as an independent local APPC LU.
/netname:"text"
Specifies a name for the network of this LU. The name can be from one through eight characters long, and can contain alphanumeric characters and the special characters $, #, and @.

If /netname:text is not specified, the network name of the SNA Server on which the LU is located is used as the default. Note that /luname:text also has a default (the LU alias). Therefore, the fully qualified LU name (network name plus LU name) can potentially be created by default, if the LU alias and local network name are configured appropriately. A fully qualified LU name is required for an APPC LU.

/luname:"text"
Specifies the LU name. The name can be from one through eight characters long, and can contain alphanumeric characters and the special characters $, #, and @. Lowercase letters are converted to uppercase. For a local APPC LU, the fully qualified LU Name (Network Name plus LU Name) must be unique on the server.

If /luname:text is not specified, LUalias is used as the default LU name. Note that /netname:text also has a default (the network name of the server on which the LU is located). Therefore, the fully qualified LU name (network name plus LU name) can potentially be created by default, if the LU alias and local network name are configured appropriately. A fully qualified LU name is required for an APPC LU.

/comment:"text"
Adds an optional comment for the LU. The comment can contain as many as 25 characters; enclose the comment in quotes.
/autopartner: { yes | no }
Specifies whether this LU will automatically be partnered with other APPC LUs.

If automatic partnering is left unspecified, the default is yes.

/defaultpool: { yes | no }
Specifies whether this LU will be in the default outgoing local APPC LU pool. This pool makes LUs available for invoking TPs that do not specify a local LU.
/impremotelu:remoteLUname
Specifies an existing remote LU to be used as an implicit incoming remote LU for the local LU.
/tptimeout:value
Specifies the number of seconds that SNA Server should wait for the invokable TP to respond to a start request from the invoking TP.
/addpartner:LUalias,mode[,connection]
Partners the local LU with the specified LU and the specified mode. Both LUalias and mode must exist before they can be specified as partners. If LUalias specifies a remote LU that is not unique on the server, the connection used by the remote LU must also be specified; otherwise, SNA Server will randomly choose one of the remote LUs called LUalias to act on.

Only one /addpartner option can be used in each command.

/delpartner:LUalias,mode[,connection]
Deletes the pair listing that includes this local LU, the specified partner LU, and the specified mode. (Does not delete any LUs or modes themselves.) If LUalias specifies a remote LU that is not unique on the server, the connection used by the remote LU must also be specified; otherwise, SNA Server will randomly choose one of the remote LUs called LUalias to act on.

Only one /delpartner option can be used in each command.