Command Reference

CATALOG APPN NODE

Writes information to the node directory about a remote workstation that uses APPN as its communication protocol. DB2 uses this information to establish the connection between an application and a remote database cataloged on this node.

This command is available on OS/2 only.

Authorization

sysadm

Required Connection

None

Command Syntax

>>-CATALOG APPN NODE--nodename---+-------------------+-REMOTE---> +-NETWORKID--netid--+ >-partner-lu---+------------------+--+-------------+------------> +-LOCAL--local-lu--+ +-MODE--mode--+ >--+-------------------------+--------------------------------->< +-WITH--"comment-string"--+

Command Parameters

NODE nodename

Specifies the name of the remote workstation to catalog. This is the same name that is entered for the node name parameter when a database residing on that workstation is cataloged (using CATALOG DATABASE). The name must conform to DB2 naming conventions (see Appendix B. "Naming Conventions").

NETWORKID netid

Specifies the ID of the SNA network where the remote LU resides. This network ID is a string of one to eight characters that follows naming conventions for SNA.

REMOTE partner-lu

Specifies the SNA partner logical unit used for the connection. Enter the LU name of the remote node. The name must be entered exactly as it appears (using mixed case characters) in the corresponding SNA definition (from the Communication Manager configuration). The name must follow SNA naming conventions.

LOCAL local-lu

Specifies the alias of the SNA local logical unit used for the connection. It must be a string containing 1 to 8 non-blank characters. The alias must be entered exactly as it appears (using mixed case characters) in the corresponding SNA definition (from the Communication Manager configuration).

MODE mode

Specifies the SNA transmission mode used for the connection. The name must conform to SNA naming conventions.

If a value is not entered, DB2 stores a character string of eight blanks as the mode type.

WITH "comment-string"

Describes the node entry in the node directory. Any comment that helps to describe the node can be entered. Maximum length is 30 characters. A carriage return or a line feed character is not permitted. The comment text must be enclosed by single or double quotation marks.

Example

The following example catalogs an APPN node:

   db2 catalog appn node remnode remote rlu with "Catalog APPN NODE"

Usage Notes

This command is identical to the Version 1 command. (It was removed in Version 2.)

ATTACH cannot be used with an APPN node to attach to a server that has TPNAME other than x'07F6C4C2'.

APPN nodes only support security PROGRAM (security SAME and NONE are not supported).

[ DB2 List of Books | Search the DB2 Books ]