Examples of administration commands

This section provides some examples of snaadmin commands as you would issue them on the command line. Many of the parameters in these commands are not specified, so snaadmin uses the default values; see the description of each command in Administration commands for details of the default parameter values.

The following commands define connectivity to a remote system over Ethernet. Note the use of angle brackets to specify the mac_address parameter as a hexadecimal array. Each angle bracket needs to be preceded by a backslash character \ to prevent interpretation by the Linux shell.

snaadmin define_ethernet_dlc, dlc_name = DLCNAME, initially_active = YES
snaadmin define_ethernet_port, port_name = PORTNAME, dlc_name = DLCNAME, 
initially_active = YES
snaadmin define_ethernet_ls, ls_name = LSNAME1, port_name = PORTNAME, 
mac_address = \<000000000000\>

The following command defines access for a TN3270 client. Note the use of brace characters to specify the TN3270 session data. Each brace character needs to be preceded by a backslash character \ to prevent interpretation by the Linux shell.

snaadmin define_tn3270_access, default_record=YES, description="Test client", 
\{tn3270_session_data\}, port_number=8001

The following commands define a local LU used for LU6.2, and the partner LU that it communicates with.

snaadmin define_local_lu, lu_name=LUNAME1, lu_alias=LUNAME1
snaadmin define_partner_lu, fqplu_name=APPN.PTNRLU, plu_alias=PTNR01

The following command activates a session between the local LU and partner LU, using the standard SNA mode named #CONNECT. Note the use of a backslash character \ before the # character in this name, to prevent interpretation by the Linux shell.

snaadmin activate_session, lu_alias=LUNAME1, plu_alias=PTNR01, mode_name=\#INTER

The following commands request information about the definition of the partner LU, its current status, and the sessions between the local and partner LUs. In all cases, the -d or DETAIL value is used to request detailed information, overriding the default which is to provide summary information only.

snaadmin -d query_partner_lu_definition, plu_alias=PTNR01
snaadmin -d query_partner_lu, lu_name=LUNAME1, plu_alias=PTNR01
snaadmin query_session, num_entries=0, list_options=DETAIL+FIRST_IN_LIST, lu_name=LUNAME1, 
plu_alias=PTNR01