On APPL

name is required. It specifies a minor node name for this application program, as does the ACBNAME operand. This name, when used with the network identifier (NETID as specified on the VTAM® START command) is the network-qualified name of the application program, in the form of netid.name. This name is sometimes called the real name to distinguish it from an alias or USERVAR name. This name must be unique in the following situations:
  • Within the domain in which the application resides
  • Throughout the network if the application program participates in cross-domain sessions
  • Throughout all networks if the application program participates in cross-network sessions, unless network-qualified names, LUALIAS, or the alias translation function is used.
name must follow the rules for naming application programs as described in the z/OS Communications Server: SNA Network Implementation Guide and can include the following wildcard characters:
Asterisk (*)
Represents 0 or more unspecified characters. An asterisk can be used as the second to eighth character.
Question mark (?)
Represents a single unspecified character. A question mark can be used as the first to eighth character.
A logical unit can request a session with an application by using one of the following names associated with the application:
  • An application program network name, the name operand (from any domain in the network)
  • The ACB name associated with the application (from within the same domain).
A logical unit using the application program’s network name (the name operand on the APPL definition statement) can establish a session with the application program from any domain in the network. A logical unit using the ACB name to establish a session with an application program must be in the same domain.

If you do not code ACBNAME, this name must be the same as the name in the APPLID operand of the ACB macroinstruction for this application program. z/OS Communications Server: SNA Programming describes the ACB macroinstruction.

See z/OS Communications Server: SNA Network Implementation Guide for considerations when coding the name to define terminal control address space (TCAS) or a time sharing option (TSO) user.

Note: If you duplicate names for application program minor nodes, it is not advisable to register more than one of the duplicate names at a time. If there are duplicate application program major node names and more than one is registered, you will receive messages about the duplication.