HP-UX SNAplus2 R7 Administration Command Reference HP-UX 11i v1, 11i v2 and 11i v3 Edition: 4 Manufacturing Part Number: 5991–2742 April 2007 © 2007 Hewlett-Packard Development Company, L.P. All rights reserved.
Contents Legal Notices.............................................................................................................................................24 Warranty............................................................................................................................................24 U.S. Government License.. .............................................................................................................. 24 Copyright Notices.. ...................................
2.4 aping........................................................................................................................................44 2.4.1 Supplied Parameters.. .................................................................................................44 2.4.2 Returned Parameters.. ................................................................................................ 46 2.4.3 Error Return Codes...................................................................................
2.14.3 iv Error Return Codes...................................................................................................73 2.15 define_defaults......................................................................................................................73 2.15.1 Supplied Parameters.................................................................................................73 2.15.2 Returned Parameters.. ..................................................................................
2.29.2 2.29.3 Returned Parameters.. .............................................................................................. 95 Error Return Codes...................................................................................................95 2.30 define_internal_pu.................................................................................................................96 2.30.1 Supplied Parameters..........................................................................................
vi 2.40 define_lu62_timeout............................................................................................................133 2.40.1 Supplied Parameters...............................................................................................133 2.40.2 Returned Parameters.. ............................................................................................ 134 2.40.3 Error Return Codes...............................................................................................
2.50.2 2.50.3 Returned Parameters.. ............................................................................................ 180 Error Return Codes.................................................................................................180 2.51 define_sdlc_ls......................................................................................................................181 2.51.1 Supplied Parameters..........................................................................................
2.60.2 2.60.3 2.60.4 viii Returned Parameters.. ............................................................................................ 237 Error Return Codes.................................................................................................237 Bit Ordering in MAC Addresses..............................................................................239 2.61 define_tr_port, define_ethernet_port, define_fddi_port.. .................................................... 240 2.61.
2.70.3 Error Return Codes.................................................................................................257 2.71 delete_downstream_lu_range.............................................................................................258 2.71.1 Supplied Parameters...............................................................................................258 2.71.2 Returned Parameters.. ............................................................................................ 259 2.
2.81.1 2.81.2 2.81.3 x Supplied Parameters...............................................................................................272 Returned Parameters.. ............................................................................................ 272 Error Return Codes.................................................................................................273 2.82 delete_lu_pool..............................................................................................................
2.92 delete_tp..............................................................................................................................285 2.92.1 Supplied Parameters...............................................................................................285 2.92.2 Returned Parameters.. ............................................................................................ 285 2.92.3 Error Return Codes...........................................................................................
2.102.1 2.102.2 2.102.3 Supplied Parameters.............................................................................................305 Returned Parameters.. .......................................................................................... 305 Error Return Codes...............................................................................................306 2.103 query_available_tp............................................................................................................
2.113 query_cos_tg_row.. ........................................................................................................... 326 2.113.1 Supplied Parameters.............................................................................................326 2.113.2 Returned Parameters.. .......................................................................................... 327 2.113.3 Error Return Codes...............................................................................................
2.123 query_dlur_defaults...........................................................................................................356 2.123.1 Supplied Parameters.............................................................................................356 2.123.2 Returned Parameters.. .......................................................................................... 356 2.123.3 Error Return Codes...............................................................................................357 2.
2.132.3 Error Return Codes...............................................................................................390 2.133 query_global_log_type.. ....................................................................................................390 2.133.1 Supplied Parameters.............................................................................................391 2.133.2 Returned Parameters.. .......................................................................................... 391 2.
2.142.2 2.142.3 2.142.4 Returned Parameters: Summary Information.......................................................434 Returned Parameters: Detailed Information......................................................... 435 Error Return Codes...............................................................................................443 2.143 query_lu_lu_password...................................................................................................... 443 2.143.1 Supplied Parameters.......
2.152.1 2.152.2 2.152.3 2.152.4 Supplied Parameters.............................................................................................466 Returned Parameters: Summary Information.......................................................468 Returned Parameters: Detailed Information......................................................... 468 Error Return Codes...............................................................................................470 2.153 query_nn_topology_stats..............
2.161.3 Error Return Codes...............................................................................................514 2.162 query_rcf_access..............................................................................................................515 2.162.1 Supplied Parameters.............................................................................................515 2.162.2 Returned Parameters.. ..........................................................................................
2.170.6 2.170.7 2.170.8 2.170.9 Returned Parameters: Token Ring / Ethernet / FDDI LS Statistics......................548 Returned Parameters: Token Ring, Ethernet, or FDDI Port Statistics.. ............... 548 Returned Parameters: Enterprise Extender..........................................................550 Error Return Codes...............................................................................................550 2.171 query_tn3270_access_def....................................................
2.180.1 2.180.2 2.180.3 Supplied Parameters.............................................................................................570 Returned Parameters.. .......................................................................................... 571 Error Return Codes...............................................................................................571 2.181 remove_dlc_trace..............................................................................................................
2.191 set_tn_server_trace...........................................................................................................593 2.191.1 Supplied Parameters.............................................................................................593 2.191.2 Returned Parameters.. .......................................................................................... 593 2.191.3 Error Return Codes...............................................................................................593 2.
2.201.3 Error Return Codes...............................................................................................613 2.202 status_lu62........................................................................................................................614 2.202.1 Supplied Parameters.............................................................................................614 2.202.2 Returned Information............................................................................................
B.2 Configuration File Format.....................................................................................................628 B.2.1 Record Ordering in a Configuration File.. ......................................................................... 629 B.2.2 Record Format...................................................................................................................629 B.2.3 Subrecord Format............................................................................................
Legal Notices Trademark Notices Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Publishing History New and Changed Information in This Edition Publishing History The manual publishing date and part number indicate its current edition. The publishing date will change when a new edition is printed. Minor changes may be made without changing the publishing date. The manual part number will change when extensive changes are made. Manual updates may be issued between editions to correct errors or document product changes.
Before You Begin About This Book Before You Begin HP-UX SNAplus2 Administration Command Reference contains information about starting and managing the SNAplus2 software. SNAplus2 is a software product that enables a server running HP-UX to exchange information with other nodes on an SNA network. This book applies to Release 7 of SNAplus2. Token Ring and FDDI adapters are not supported on HP-UX 11i v3. Prerequisite Knowledge Before reading this manual, you should have a knowledge of SNA and APPN concepts.
Before You Begin SNAplus2 Publications Special Element Sample of Typography Program or application snapadmin Command or utility define_node; snaphelp General reference to all commands of a particular type For example, query_* indicates all the administration records that query details of a SNAplus2 resource (query_cn, query_cos, query_dlc, and so on).
Before You Begin SNAplus2 Publications • Sending NetView user alerts • Viewing response times HP-UX SNAplus2 RJE User’s Guide Explains how to start and stop the RJE workstation, queue a job for submission to the host, list the queued jobs, cancel a queued job, and send commands to the host’s job entry subsystem (JES). HP-UX SNAplus2 APPC Application Suite User’s Guide Explains how to use the set of six utility applications supplied with SNAplus2 that can be run over an SNA network using SNAplus2.
Before You Begin Related Publications Contains the information you need to write application programs using High-Level Language Application Program Interface (HLLAPI). HP-UX SNAplus2 LUA Programmer’s Guide Contains the information you need to write applications using the Conventional LU Application Programming Interface (LUA). HP-UX SNAplus2 CSV Programmer’s Guide Contains the information you need to write application programs using the Common Service Verbs (CSV) API.
Introduction to SNAplus2 Administration Commands 1 Introduction to SNAplus2 Administration Commands SNAplus2 administration commands are accessible through the snapadmin program. The snapadmin program is a command-line administration program that can be used to configure and manage the SNAplus2 node. The HPUX SNAplus2 Administration Guide describes how to configure and manage the SNAplus2 node using specific administration commands.
Introduction to SNAplus2 Administration Commands Using snapadmin 1.1 Using snapadmin Before you can use the snapadmin program, SNAplus2 must be started. If SNAplus2 has not been started, enter the following command on the HP-UX command line: sna start You can use snapadmin to configure and manage SNAplus2. administration program when any of the following is true: Use snapadmin as an alternative to the Motif • You want to configure resource parameters that are not frequently used.
Introduction to SNAplus2 Administration Commands Using snapadmin You do not need to specify -a to list all resources of a particular type. The -a option is implied by default if no particular resource is named. -h Display help. For more information, see Section 1.1.1, Command Line Options. -c Change a particular parameter (available on a select number of define_ commands only). For more information, see Section 1.1.1, Command Line Options. -i infile Use commands from the named file.
Introduction to SNAplus2 Administration Commands Using snapadmin • define_tr_ls • define_tr_port • define_userid_password Using Command Line Help Help is available using the -h and -d options on snapadmin as follows: Displays general information about administration commands and instructions for specifying commands and parameters on the command line. snapadmin -h snapadmin -h -d Lists all administration commands. snapadmin -h command Displays a description of the specified command.
Introduction to SNAplus2 Administration Commands Using snapadmin Decimal A numeric value (for example 128). The individual parameter descriptions give details of the maximum and minimum values. Specify numeric values in decimal, not in hexadecimal, unless the values are explicitly defined as hex numbers. Hex number A numeric value given in hexadecimal, specified as an even number of hexadecimal digits preceded by 0x (for example 0xF0).
Introduction to SNAplus2 Administration Commands Using snapadmin Subrecords in Administration Commands Some administration commands include data whose format can vary between instances of the command. For example, define_emulator_user, which defines a 3270 or 5250 emulation program user, includes a variable number of sessions for the user. To allow for this, the variable data is specified in optional subrecords.
Introduction to SNAplus2 Administration Commands Using snapadmin • By name length (shortest name first) • By ASCII lexicographical ordering for names of the same length Individual command descriptions note when the list ordering differs from the preceding order (for example, when the list is ordered by a numeric value). You can obtain information about multiple resources by requesting the complete list or a specified part of it.
Introduction to SNAplus2 Administration Commands Using snapadmin To request detailed information, you can use the -d option on the snapadmin command line instead of specifying a value of DETAIL for the list_options parameter. The -d option returns detailed information unless you explicitly specify a value of SUMMARY for the list_options parameter which returns summary information only. 1.1.
Administration Commands activate_session 2 Administration Commands This chapter provides reference information about administration commands used for configuring, defining, deleting, querying, checking status, starting, and stopping the following resources: local nodes, connectivity components, directory entries, network topology (query only), type 0–3 LUs and pools, 3270 and 5250 users, 3270 domain resources, and RJE workstations. The commands are listed in alphabetical order. 2.
Administration Commands activate_session polarity The polarity for the session. Possible values are: POL_EITHER POL_FIRST_SPEAKER POL_BIDDER If POL_EITHER is set, activate_session activates a first speaker session if available, otherwise a bidder session is activated. If POL_FIRST_SPEAKER or POL_BIDDER is set, activate_session only succeeds if a session of the requested polarity is available. cnos_permitted Indicates that CNOS processing is permitted. Possible values are: YES CNOS processing is permitted.
Administration Commands add_backup Possible values are: EXCEEDS_MAX_ALLOWED The session cannot be activated because this would exceed the current session limit for this LU-LUmode combination. INVALID_LU_ALIAS The lu_alias parameter did not match any defined local LU alias. INVALID_LU_NAME The lu_name parameter did not match any defined local LU name. INVALID_PLU_NAME The fqplu_name parameter did not match any defined partner LU name, or the plu_alias parameter did not match any defined partner LU name.
Administration Commands add_dlc_trace backup_name character 128 Supplied parameter is: backup_name The name of the server to be added to the list of backup servers. If the server name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise it performs a DNS lookup to determine the server name. 2.2.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.2.
Administration Commands add_dlc_trace • If you issue a command to trace XID messages on all resources and then issue a second command to trace SC and DFC messages on a particular LS, all three message types will be traced for this LS. If you are tracing an SDLC line and would like more detailed trace information, you can get this by using internal tracing on SDLC as well as line tracing.
Administration Commands add_dlc_trace sidh Session ID high byte sidl Session ID low byte odai Origin Destination Assignor Indicator. Possible values are: YES The BIND sender is the node containing the secondary link station. NO The BIND sender is the node containing the primary link station. message_type The type of messages to trace for the specified resource or session. To trace all messages, set this parameter to TRACE_ALL.
Administration Commands aping Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_RESOURCE_TYPE The value specified in the resource_type parameter was not valid. INVALID_MESSAGE_TYPE The value specified in the message_type parameter was not valid. INVALID_RTP_CONNECTION The resource_name parameter does not match any RTP connection.
Administration Commands aping security pwd user_id dlen consec fqplu_name echo iterations partner_ver_len constant character character decimal decimal character constant decimal decimal 10 10 17 NONE (null string) (null string) 0 1 (null string) NO 0 0 Supplied parameters are: lu_name LU name of the local LU. This name is a type-A character string. To indicate that the LU is identified by its LU alias instead of its LU name, do not specify this parameter. lu_alias LU alias of the local LU.
Administration Commands aping User ID required to access the partner TP. This parameter is required only if the security parameter is set to SAME, PGM or PGM_STRONG. This ID is a type-AE character string. dlen Length of the data string to be sent to the partner LU. (You do not need to provide a data string; the APING TP simply sends a string of zeros of the specified length.) Specify a value in the range 0–65,535.
Administration Commands aping The minimum time in milliseconds required for a data-sending iteration—the shortest measured time for a single iteration of sending data and receiving either data or confirmation. If iterations was set to 0 (zero), this parameter is not used. avg_time The average time in milliseconds required for a data-sending iteration—the average time for a single iteration of sending data and receiving either data or confirmation.
Administration Commands aping Possible values are: ALLOCATION_FAILURE_NO_RETRY The conversation could not be allocated because of a permanent condition, such as a configuration error or session protocol error. Check the sense_data parameter and the error log file for more information. Do not attempt to retry the aping command until the error has been corrected. ALLOCATION_FAILURE_RETRY The conversation could not be allocated because of a temporary condition, such as a link failure.
Administration Commands change_session_limit 2.5 change_session_limit The change_session_limit command requests SNAplus2 to change the session limits for a particular LULU-mode combination. Sessions can be activated or deactivated as a result of processing this command. This command must be issued to a running node. 2.5.
Administration Commands change_session_limit NO Leave the maximum negotiable session limit as the value specified for the mode. plu_mode_session_limit Requested total session limit for this LU-LU-mode combination—the maximum number of parallel sessions allowed between these two LUs using this mode. This value can be negotiated with the partner LU. Specify a value in the range 1–32,767 (which must not exceed the session limit specified for the local LU on the define_local_lu command).
Administration Commands change_session_limit 2.5.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands deactivate_conv_group ALLOCATION_FAILURE_NO_RETRY A session could not be allocated because of a condition that requires action. Check the sense_data parameter and logged messages to determine the reason for the failure, and take any action required. Do not attempt to retry the command until the condition has been corrected. sense_data If the secondary_rc parameter is ALLOCATION_FAILURE_NO_RETRY, this parameter contains the SNA sense data associated with the error.
Administration Commands deactivate_conv_group lu_alias LU alias of the local LU. This alias is a character string using any locally displayable characters. This parameter is used only if lu_name is not specified. If lu_name and lu_alias are not specified, the command is forwarded to the LU associated with the CP (the default LU). conv_group_id Conversation group identifier for the session to be deactivated. type Type of deactivation.
Administration Commands deactivate_lu_0_to_3 State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands deactivate_session 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.8 deactivate_session The deactivate_session command requests SNAplus2 to deactivate one or more sessions using a particular local LU/mode/partner LU combination.
Administration Commands deactivate_session plu_alias LU alias of the partner LU. This alias is a character string using any locally displayable characters. To indicate that the partner LU is defined by its fully qualified LU name instead of its LU alias, do not specify this parameter. mode_name Name of the mode to be used by the LUs. This name is a type-A character string starting with a letter. type Type of deactivation.
Administration Commands define_3270_diag INVALID_MODE_NAME The mode_name parameter did not match any defined mode name. INVALID_PLU_NAME The fqplu_name parameter did not match any defined partner LU name. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands define_3270_diag Send RTM data to the host every time a counter overflows. NO Do not send RTM data to the host at counter overflow. SNAplus2 discards the RTM data. rtm_unbind Specifies whether to send RTM data to the host every time a 3270 session is unbound (ends). Possible values are: YES Send RTM data to the host every time a session ends. NO Do not send RTM data to the host at session end. SNAplus2 discards the RTM data.
Administration Commands define_adjacent_len_node parameter1 through parameter3 Text strings describing any parameters that the user should enter for the alert. Each one is a string of 1–33 characters. Consult the NetView administrator for the host to determine the parameters required for each alert. An alert may not require all three parameters; do not specify any parameters that are not required. The user will only be prompted for a parameter if you specify a description for it. 2.9.
Administration Commands define_adjacent_len_node 2.10.1 Supplied Parameters Parameter name [define_adjacent_len_node] cp_name description lu_name wildcard_lus Type Length Default character character character constant 17 31 8 (null string) NO (Up to 10 lu_name entries may be included.) Supplied parameters are: cp_name The fully qualified name of the CP in the adjacent LEN end node.
Administration Commands define_cn Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_CP_NAME The cp_name parameter contained a character that was not valid. INVALID_LU_NAME One or more of the specified LU names contained a character that was not valid.
Administration Commands define_cn fqcn_name description effect_cap connect_cost byte_cost security prop_delay user_def_parm_1 user_def_parm_2 user_def_parm_3 port_name character character decimal decimal decimal constant constant decimal decimal decimal character 17 32 8 (null string) 3686400 0 0 SEC_NONSECURE PROP_DELAY_LAN 0 0 0 (null string) (1–239 port_name entries can be included) Supplied parameters are: fqcn_name Fully qualified name of the connection network.
Administration Commands define_cn Data is transmitted over a line that is protected against physical and radiation tapping. prop_delay Propagation delay. The time that a signal takes to travel the length of the link. Specify one of the following values, according to the type of link: PROP_DELAY_MINIMUM Minimum propagation delay. PROP_DELAY_LAN Delay is less than .5 microseconds (typical for a LAN). PROP_DELAY_TELEPHONE Delay is in the range .5–50 microseconds (typical for a telephone network).
Administration Commands define_cos The security parameter was not set to one of the valid values. EXCEEDS_MAX_ALLOWED Adding the specified ports would exceed the maximum total number of ports on a CN. INVALID_CN_NAME The fqcn_name parameter contained a character that was not valid or was not in the correct format. INVALID_PORT_NAME One or more of the port names specified did not match the name of a defined port.
Administration Commands define_cos description transmission_priority character constant {cos_tg_row} min_effect_cap min_connect_cost min_byte_cost min_security min_prop_delay min_user_def_parm_1 min_user_def_parm_2 min_user_def_parm_3 max_effect_cap max_connect_cost max_byte_cost max_security max_prop_delay max_user_def_parm_1 max_user_def_parm_2 max_user_def_parm_3 weight decimal decimal decimal constant constant decimal decimal decimal hex decimal decimal constant constant decimal decimal decimal deci
Administration Commands define_cos maximum characteristics defined for each TG row. The TG is then assigned the weight of the first TG row which bounds all the TG’s characteristics within the limits specified. If the TG characteristics do not satisfy any of the listed TG rows, the TG is considered unsuitable for this COS, and is assigned an infinite weight. The TG rows must be listed in ascending order of weight.
Administration Commands define_cos PROP_DELAY_PKT_SWITCHED_NET Delay is in the range 50–250 microseconds (typical for a packet-switched network). PROP_DELAY_SATELLITE Delay is greater than 250 microseconds (typical for a satellite link). PROP_DELAY_MAXIMUM Maximum propagation delay. min_user_def_parm_1 through min_user_def_parm_3 Minimum limits for user-defined parameters, which you can use to include TG characteristics not covered by previously defined parameters.
Administration Commands define_cos PROP_DELAY_MINIMUM Minimum propagation delay. PROP_DELAY_LAN Delay is less than .5 microseconds (typical for a LAN). PROP_DELAY_TELEPHONE Delay is in the range .5–50 microseconds (typical for a telephone network). PROP_DELAY_PKT_SWITCHED_NET Delay is in the range 50–250 microseconds (typical for a packet-switched network). PROP_DELAY_SATELLITE Delay is greater than 250 microseconds (typical for a satellite link). PROP_DELAY_MAXIMUM Maximum propagation delay.
Administration Commands define_cos UNCONGESTED The number of ISR sessions is less than the isr_sessions_upper_threshold value in the node’s configuration. CONGESTED The number of ISR sessions exceeds the isr_sessions_upper_threshold value. weight Weight associated with this node row. 2.12.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.12.
Administration Commands define_cpic_side_info 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.13 define_cpic_side_info The define_cpic_side_info command adds a side information entry to the configuration file or replaces an existing entry. A CPI-C side information entry associates a set of conversation characteristics with a symbolic destination name.
Administration Commands define_cpic_side_info digits) must be a hexadecimal value in the range 0x0–0x3F, excluding 0x0E and 0x0F; the remaining characters (each represented by two hexadecimal digits) must be valid EBCDIC characters. tp_name TP name of the target TP. mode_name Name of the mode used to access the target TP. conversation_security_type Specifies whether the target TP uses conversation security. Allowed values: NONE The target TP does not use conversation security.
Administration Commands define_default_pu primary_rc PARAMETER_CHECK secondary_rc INVALID_SYM_DEST_NAME The sym_dest_name parameter contained a character that was not valid. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands define_defaults 2.14.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands define_directory_entry SNAplus2 puts implicit definitions in place for unknown partner LUs. specific_security_codes Specifies whether SNAplus2 uses specific sense codes on a security authentication or authorization failure. Specific sense codes are only returned to those partner LUs which have reported support for them on the session. Possible values are: YES SNAplus2 uses specific sense codes. NO SNAplus2 does not use specific sense codes.
Administration Commands define_directory_entry When defining an adjacent node and its LUs, use define_adjacent_len_node instead of define_directory_entry. This enables you to define the node and its LUs with a single command. The define_directory_entry command defines only a single entry, so you need to use multiple commands to define entries for the adjacent node and for its LUs. You can specify a “wildcard” LU name to match multiple LU names by specifying only the initial characters of the name.
Administration Commands define_directory_entry parent_type Specifies the parent type of the resource to be defined. Possible values are: ENCP_RESOURCE End node (for an LU resource owned by an end node) NNCP_RESOURCE Network node (for an LU resource owned by a network node, or for an EN or LEN resource) Do not specify this parameter when no parent name is supplied. 2.16.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.16.
Administration Commands define_dlur_defaults 2.17 define_dlur_defaults The define_dlur_defaults command defines a default Dependent LU Server (DLUS) and a backup default DLUS. If a default DLUS or backup default DLUS is already defined, the command overrides the existing definition. DLUR uses the default DLUS name when it initiates SSCP-PU activation for PUs that do not have an explicitly specified associated DLUS.
Administration Commands define_dlur_defaults If either the default primary DLUS or default backup DLUS is active, SNAplus2 will attempt to activate or reactivate the PU by using the active DLUS only. NO SNAplus2 will attempt to activate or reactivate the PU by using the standard retry logic. 2.17.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.17.
Administration Commands define_downstream_lu 2.18 define_domain_config_file The define_domain_config_file command specifies an optional comment string to be included in the header of a domain configuration file. If you are creating a domain configuration file using a text editor, this comment string must be the first record in the file. 2.18.
Administration Commands define_downstream_lu define_downstream_lu can also be used to define the downstream LU used by an application that communicates with a SNAplus2 Primary RUI application. For more information about Primary RUI, see HPUX SNAplus2 LUA Programmer’s Guide. 2.19.
Administration Commands define_downstream_lu Specifies whether to use delayed logon with this downstream LU (the upstream LU is not activated until the user requests it). Possible values are: YES Use delayed logon with this downstream LU; the upstream LU is not activated until the user requests it. NO Do not use delayed logon with this downstream LU. This field is ignored if the downstream LU is used to communicate with a SNAplus2 Primary RUI application instead of a host. 2.19.
Administration Commands define_downstream_lu_range The specified dspu_name parameter did not match any defined PU name. INVALID_PU_TYPE The PU specified by the dspu_name parameter is not a downstream PU that supports PU concentration. LU_ALREADY_DEFINED An LU with the name specified by the dslu_name parameter has already been defined, and cannot be modified using this command. DSLU_ACTIVE The LU is already active.
Administration Commands define_downstream_lu_range The supplied parameters include a base name for the new LUs and the range of NAU addresses. The LU base name and NAU addresses are combined to generate the new LU names. For example, a base name of LUNME combined with a NAU address in the range 11–14 results in the following LU names: LUNME011, LUNME012, LUNME013 and LUNME014.
Administration Commands define_downstream_lu_range NO Do not allow the session this range of downstream LUs have with the upstream LU to timeout. This field is ignored if the downstream LUs are used to communicate with a SNAplus2 Primary RUI application instead of a host. delayed_logon Specifies whether to use delayed logon with this range of downstream LUs (the upstream LU is not activated until the user requests it).
Administration Commands define_dspu_template STATE_CHECK secondary_rc Possible values are: INVALID_PU_NAME The specified dspu_name parameter value was not valid. PU_NOT_DEFINED The specified dspu_name parameter did not match any defined PU name. INVALID_PU_TYPE The PU specified by the dspu_name parameter is not a downstream PU that supports PU concentration. LU_ALREADY_DEFINED An LU has already been defined with a name that matches one of the names in the range.
Administration Commands define_dspu_template define_dspu_template can also be used to define downstream LUs that support applications communicating with a Primary RUI application on the SNAplus2 node. For more information about Primary RUI, see HP-UX SNAplus2 LUA Programmer’s Guide. 2.21.
Administration Commands define_dspu_template allow_timeout Specifies whether to timeout host LUs used by the downstream LU if the session is left inactive for the timeout period specified on the host LU definition. Possible values are: YES SNAplus2 is allowed to timeout host LUs used by this downstream LU. NO SNAplus2 is not allowed to timeout host LUs used by this downstream LU. This field is ignored if the downstream LUs are used to communicate with a SNAplus2 Primary RUI application instead of a host.
Administration Commands define_emulator_user 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: INVALID_HOST_LU_NAME The specified host_lu_name parameter value was not valid. 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.
Administration Commands define_emulator_user plu_alias fqplu_name mode_name session_type character character character constant 8 17 8 (null string) (null string) QPCSUPP 5250_DISPLAY (One or more 5250_session_data subrecords may be included.) Supplied parameters are: user_name The name of the emulation program user. This name is character string of 1–32 locally displayable characters.
Administration Commands define_emulator_user YES The user has permission to view RTM data. The LTTI is displayed. NO The user does not have permission to view RTM data. The LTTI is not displayed. alert_permission Specifies whether the user has permission to send 3270 user alerts. (For a 5250-only user, this parameter is ignored.) Possible values are: YES The user can send 3270 user alerts. NO The user cannot send 3270 user alerts.
Administration Commands define_emulator_user YES The user_name parameter identifies a group name. Any user in this group will use this emulator user record unless there is an explicit record for the user’s user name. NO The user_name parameter identifies a user name. One or more 3270_session_data subrecords may follow. Each subrecord contains the following additional parameters: session_name A name identifying the session. This name is an 8-byte string consisting of locally displayable characters.
Administration Commands define_emulator_user Specifies whether the user has permission to change the session to use a different screen model from the one specified. Possible values are: YES The user can change the screen model. NO The user cannot change the screen model. One or more 5250_session_data subrecords may follow. Each subrecord contains the following additional parameters: session_name A name identifying the session. This name is an 8-byte string consisting of locally displayable characters.
Administration Commands define_fddi_ls 2.22.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands define_focal_point 2.28 define_fddi_port For more information, see Section 2.61, define_tr_port, define_ethernet_port, define_fddi_port. 2.29 define_focal_point The define_focal_point command defines a focal point for a particular Management Services category. When a new focal point is defined, SNAplus2 attempts to establish an implicit primary focal point relationship with the defined focal point by sending an MS_CAPABILITIES request. 2.29.
Administration Commands define_focal_point The application is the main focal point. 2.29.2 Returned Parameters If the command executes successfully, SNAplus2 returns the following parameter: primary_rc OK The focal point was defined as requested. 2.29.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands define_internal_pu secondary_rc NO_SECONDARY_RC primary_rc UNSUCCESSFUL secondary_rc Possible values are: IMPLICIT_REQUEST_REJECTED The specified focal point rejected the request. IMPLICIT_REQUEST_FAILED The node could not send the request to the specified focal point; this may be because the specified control point or application was not found.
Administration Commands define_internal_pu Name of the DLUS node that DLUR will use when it initiates SSCP-PU activation. Specify 3–17 type-A characters that consist of a 1–8 character network name, followed by a period, followed by a 1–8 character DLUS node name. To indicate that DLUR should use the global default DLUS, do not specify this parameter. In this case, you must also use define_dlur_defaults to define a global default DLUS.
Administration Commands define_internal_pu 2.30.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.30.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands define_ip_dlc 2.31 define_ip_dlc The define_ip_dlc command defines a new DLC for use with Enterprise Extender (HPR/IP). The command can also be used to modify an existing DLC, if the DLC is not currently active. 2.31.
Administration Commands define_ip_dlc udp_port_low UDP port number used for low priority traffic. ip_precedence_llc IP precedence value used for LLC commands, in the range 0 (minimum)—7 (maximum). ip_precedence_network IP precedence value used for network priority traffic, in the range 0 (minimum)—7 (maximum). ip_precedence_high IP precedence value used for high priority traffic, in the range 0 (minimum)—7 (maximum).
Administration Commands define_ip_ls State Check If the command does not execute because of a state error, SNAplus2 returns the following parameters: primary_rc STATE_CHECK secondary_rc DLC_ACTIVE A parameter cannot be modified because the DLC is currently active. 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.
Administration Commands define_ip_ls max_send_btu_size initially_active react_timer react_timer_retry restart_on_normal_deact max_ifrm_rcvd branch_link_type decimal constant decimal decimal constant decimal constant adj_brnn_cp_support constant ip_ack_timeout ip_max_retry liveness_timeout short_hold_mode remote_ip_host decimal decimal decimal constant character 1461 NO 30 0 NO 0 UPLINK (used only if this node is BrNN) ALLOWED (used only if this node is BrNN) 2000 10 10000 NO 100 Supplied parameters
Administration Commands define_ip_ls The adjacent node is a Network Node, or a Branch Network Node acting as a Network Node from the local node’s perspective. lsap_address Link Service Access Point address used by the local link station. This must match the address used by the remote station. auto_act_supp Specifies whether the link can be automatically activated when required by a session. Possible values are: YES The link can be automatically activated. The reactivation timer parameters are ignored.
Administration Commands define_ip_ls • If an SSCP-PU session is active but no traffic has flowed for the specified time period, the node sends REQDISCONT(normal) to the host. The host is then responsible for deactivating all LUs and the PU, at which time the local node will deactivate the link. However, the host may not deactivate LUs with active PLU-SLU sessions; in this case, the link remains active until all these sessions are deactivated (for example by the user logging out).
Administration Commands define_ip_ls FNA Fujitsu Network Architecture (VTAM-F) host HNA Hitachi Network Architecture host SUPPRESS_CP_NAME Suppress the CP name associated with the remote node. Use a + character to combine this value with SNA, FNA, or HNA.
Administration Commands define_ip_ls Cost per connect time. Valid values are integer values in the range 0–255, where 0 is the lowest cost per connect time and 255 is the highest cost per connect time. byte_cost Cost per byte. Valid values are integer values in the range 0–255, where 0 is the lowest cost per byte and 255 is the highest cost per byte. security Security level of the network. Possible values are: SEC_NONSECURE No security.
Administration Commands define_ip_ls User-defined parameters, that you can use to include other TG characteristics not covered by the previous parameters. Each of these parameters must be set to a value in the range 0–255. target_pacing_count Indicates the desired pacing window size. Specify a value in the range 1–32,767. max_send_btu_size Maximum BTU size that can be sent from this link station.
Administration Commands define_ip_ls If the remote system deactivates the LS normally, SNAplus2 does not attempt to reactivate it. If the LS is a host link (specified by the adj_cp_type parameter), or is automatically started when the node is started (the initially_active parameter is set to YES), this parameter is ignored; SNAplus2 always attempts to reactivate the LS if it is deactivated normally by the remote system (unless react_timer_retry is zero).
Administration Commands define_ip_ls The maximum number of times that the local station will retry sending a command frame. If this retry count is exceeded without receiving a response, the link is considered to have failed. A lower value for this parameter means that link failures will be detected quickly, but may cause unnecessary reporting of link failures if a few packets are lost. Specify a value in the range 0–255. A typical value is 10 retries.
Administration Commands define_ip_ls The auto_act_supp parameter was not set to a valid value or was set to YES when cp_cp_sess_support was also set to YES. INVALID_CP_NAME The adj_cp_name parameter contained a character that was either not valid, not in the correct format, or not specified when required. INVALID_LIMITED_RESOURCE The limited_resource parameter was not set to a valid value. INVALID_LINK_NAME The ls_name parameter contained a character that was not valid.
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.
Administration Commands define_ip_port description dlc_name max_rcv_btu_size tot_link_act_lim inb_link_act_lim out_link_act_lim nonact_xid_exchange_limit max_ifrm_rcvd target_pacing_count max_send_btu_size remote_hostname implicit_cp_cp_sess_support implicit_limited_resource implicit_deact_timer implicit_uplink_to_en effect_cap byte_cost security prop_delay user_def_parm_1 user_def_parm_2 user_def_parm_3 initially_active implicit_ls_limit ip_ack_timeout ip_max_retry liveness_timeout short_hold_mode local_i
Administration Commands define_ip_port Outbound link activation limit (the number of links reserved for outbound activation). The sum of inb_link_act_lim and out_link_act_lim must not exceed tot_link_act_lim; the difference between out_link_act_lim and tot_link_act_lim defines the maximum number of links that can be activated inbound at any time. act_xid_exchange_limit Activation XID exchange limit. Specify a value in the range 1–65,535. nonact_xid_exchange_limit Nonactivation XID exchange limit.
Administration Commands define_ip_port • If an SSCP-PU session is active but no traffic has flowed for the specified time period, the node sends REQDISCONT(normal) to the host. The host is then responsible for deactivating all LUs and the PU, at which time the local node will deactivate the link. However, the host may not deactivate LUs with active PLU-SLU sessions; in this case, the link remains active until all these sessions are deactivated (for example by the user logging out).
Administration Commands define_ip_port For more information about these parameters, see Section 2.32, define_ip_ls. When the LS name is not initially known, the values specified on define_ip_port are used as defaults for processing incoming calls. local_ip_interface Identifier for the local network adapter card to be used for the IP link. To determine this identifier: • Run the command netstat ---i on the server where the card is installed.
Administration Commands define_local_lu secondary_rc Possible values are: PORT_ACTIVE The specified port cannot be modified because it is currently active. 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.
Administration Commands define_local_lu Name of the local LU. This name is a type-A character string starting with a letter. To modify the default LU associated with the local node’s control point, do not specify this parameter. description A text string describing the local LU. SNAplus2 uses this string for information only. It is stored in the node’s configuration file and returned on the query_local_lu command.
Administration Commands define_local_lu lu_attributes Identifies additional information about the LU. Possible values are: NONE No additional information identified. DISABLE_PASSWORD_SUBSTITUTION Disable password substitution support for the local LU. Password substitution means that passwords are encrypted before transmission between the local and remote LUs, rather than being sent as clear text. SNAplus2 normally uses password substitution if the remote system supports it.
Administration Commands define_local_lu If the node that owns this LU is running the newer version of SNAplus2 but the target system is running the older version, then the target computer is a back-level computer. When you upgrade the target system later, change this parameter back to NO. NO If both the node that owns this LU and the target system are running the same version of SNAplus2 then the target computer is not a back-level computer. 2.34.
Administration Commands define_ls_routing PU_NOT_DEFINED The pu_name parameter did not match any defined PU name. SECURITY_LIST_NOT_DEFINED The security_list_name parameter did not match any defined security access list name. LU_ALIAS_ALREADY_USED An LU with this alias has already been defined. You cannot use this command to modify any parameters of an existing LU except for the Attach routing data.
Administration Commands define_ls_routing To specify a full wildcard entry, so that all partner LUs will be accessed using the same link, set wildcard_fqplu to YES and do not specifyfq_partner_lu. wildcard_fqplu Wildcard partner LU flag indicating whether the fq_partner_lu parameter contains a full or partial wildcard. Possible values are: YES The fq_partner_lu parameter contains a wildcard entry. NO The fq_partner_lu parameter does not contain a wildcard entry.
Administration Commands define_lu_0_to_3 The local LU identified by the lu_name parameter does not exist. 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.36 define_lu_0_to_3 The define_lu_0_to_3 command defines an LU for use with 3270 emulation, RJE or LUA (an LU of type 0, 1, 2, or 3), and optionally assigns the LU to an LU pool.
Administration Commands define_lu_0_to_3 Network accessible unit address of the LU. This address is a number in the range 1–255. pool_name Name of the pool to which this LU belongs. This name is an 8-byte type-A character string. If a pool with the specified name is not already defined, SNAplus2 adds a new pool with this name and assigns the LU to it. If the LU does not belong to a pool, do not specify this parameter. pu_name Name of the PU (defined using define_*_ls) that this LU will use.
Administration Commands define_lu_0_to_3 If you are not using the LU for 3270 emulation or RJE, it is not necessary to specify an explicit LU type; set this parameter to UNKNOWN. If the host system supports Dynamic Definition of Dependent LUs (DDDLUs) and this parameter is set to any value other than UNKNOWN, SNAplus2 will define the LU dynamically on the host when the communications link to the host is established.
Administration Commands define_lu_0_to_3_range Possible values are: INVALID_LU_NAME The lu_name parameter contained a character that was not valid. INVALID_POOL_NAME The pool_name parameter contained a character that was not valid. INVALID_NAU_ADDRESS The nau_address parameter was not in the valid range. INVALID_PRIORITY The priority parameter was not set to a valid value. INVALID_TERM_METHOD The term_method parameter was not set to a valid value.
Administration Commands define_lu_0_to_3_range The supplied parameters include a base name for the new LUs and the range of NAU addresses. The new LU names are generated by combining the base name with the NAU addresses (or with a defined base number). For example, a base name of LUNME combined with a NAU range of 11 to 14 would define the LUs as LUNME011, LUNME012, LUNME013, and LUNME014. 2.37.
Administration Commands define_lu_0_to_3_range priority LU priority when sending to the host. Possible values are: NETWORK The LU has priority on the network. HIGH High priority is given to the LU. MEDIUM Medium priority is given to the LU. LOW Low priority is given to the LU. lu_model Type of the LU. Possible values are: 3270_DISPLAY_MODEL_2 LU type is a 3270 display model 2. 3270_DISPLAY_MODEL_3 LU type is a 3270 display model 3. 3270_DISPLAY_MODEL_4 LU type is a 3270 display model 4.
Administration Commands define_lu_0_to_3_range Timeout for the LU specified in seconds. If the timeout is set to a nonzero value and the user of the LU supports session inactivity timeouts, then the LU is deactivated after the PLU-SLU session is left inactive for the specified period and one of the following conditions exist: • The session passes over a limited resource link. • Another application requests to use the LU before the session is used again.
Administration Commands define_lu_0_to_3_range Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_LU_NAME The base_name parameter contained a character that was not valid. INVALID_POOL_NAME The pool_name parameter contained a character that was not valid. INVALID_NAU_ADDRESS One or more of the NAU addresses were not in the valid range.
Administration Commands define_lu_lu_password 2.38 define_lu_lu_password The define_lu_lu_password command provides a password for session-level security verification between a local LU and a partner LU. 2.38.
Administration Commands define_lu_pool Either basic or enhanced verification is accepted. 2.38.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.38.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands define_lu_pool description lu_name character character 31 8 (null string) (null string) (0–10 lu_name parameters can be specified.) Supplied parameters are: pool_name Name of the LU pool. This name is an 8-byte type-A character string. SNAplus2 creates a pool with this name if one is not already defined. description A text string describing the pool. SNAplus2 uses this string for information only.
Administration Commands define_lu62_timeout LU_NAME_POOL_NAME_CLASH The specified pool name matches the name of an LU. 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.40 define_lu62_timeout The define_lu62_timeout command defines a timeout period for unused LU 6.2 sessions. Each timeout is for a specified resource type and resource name.
Administration Commands define_mode This parameter is ignored if list_options is set to FIRST_IN_LIST. timeout Timeout period in seconds. A value of 0 (zero) indicates that the session immediately becomes free. 2.40.2 Returned Parameters If the command executes successfully, SNAplus2 returns the following parameter: OK The command executed successfully. 2.40.
Administration Commands define_mode If you use this command to modify an existing mode, the changes will apply to any new combination of local LU and partner LU that start to use the mode after you have made the change. However, any combination of LUs already using the mode will not pick up the changes until after the next locally or remotely initiated CNOS command. This command can also be used to specify the default COS to which any unrecognized modes will be mapped.
Administration Commands define_mode YES SNAplus2 ignores the max_ru_size_upp and max_ru_size_low parameters, and sets the upper bound for the maximum RU size to the largest value that can be accommodated in the link BTU size. NO SNAplus2 uses the max_ru_size_upp and max_ru_size_low parameters to define the maximum RU size. max_neg_sess_lim Maximum number of sessions allowed on this mode between any local LU and partner LU.
Administration Commands define_mode Lower bound for the maximum size of RUs sent and received on sessions that use this mode. This parameter is ignored if the value of the default_ru_size parameter is YES. Specify a value in the range 256–61,440 or the value 0 (zero), which means that there is no lower bound. max_receive_pacing_win Maximum session pacing window for sessions in this mode. For adaptive pacing, this value is used to limit the receive pacing window that the session will grant.
Administration Commands define_node INVALID_MIN_CONWINNERS The min_conwin_src parameter was not in the valid range, or was greater than plu_mode_session_limit. INVALID_MIN_CONTENTION_SUM The sum of the min_conloser_src and min_conwin_src parameters exceeded the value of plu_mode_session_limit. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands define_node isr_sessions_lower_threshold isr_max_ru_size isr_rcv_pac_window store_endpt_rscvs store_isr_rscvs store_dlur_rscvs cos_table_version send_term_self disable_branch_awareness cplu_syncpt_support cplu_attributes dlur_support pu_conc_support nn_rar max_ls_exception_events max_compress_level ptf_flags decimal decimal decimal constant constant constant constant constant constant constant constant constant constant decimal decimal constant constant 800 16384 8 NO NO NO VERSIO
Administration Commands define_node Specifies whether the node provides mode-to-COS mapping. This parameter is ignored for a network node; mode-to-COS mapping is always supported. For a LEN node, mode-to-COS mapping is not supported. Possible values are: YES The node provides mode-to-COS mapping. A mode defined for this node must include its associated COS name, which specifies either an SNA-defined COS or a COS defined using define_cos. NO The node does not provide mode-to-COS mapping.
Administration Commands define_node Network node: Specifies whether local or domain resources can be optionally registered with central directory server (CDS). Possible values are: YES Register resources with the CDS. NO Do not register resources with the CDS. mds_send_alert_q_size Size of the MDS send alert queue. If the number of queued alerts reaches this limit, SNAplus2 deletes the oldest alert on the queue. The minimum number of queued alerts is 2.
Administration Commands define_node store_endpt_rscvs Specifies whether RSCVs for endpoint sessions are stored for diagnostic purposes. If this parameter is set to YES, an RSCV is returned on the query_session command. (Setting this parameter to YES means an RSCV is stored for each endpoint session. This extra storage can be up to 256 bytes per session.) Possible values are: YES RSCVs are stored for diagnostic purposes. NO RSCVs are not stored for diagnostic purposes.
Administration Commands define_node Send an UNBIND on receipt of a CLOSE_PLU_SLU_SEC_RQ. disable_branch_awareness This parameter applies only if node_type is NETWORK_NODE; it is reserved for other node types. Specify whether the local node supports branch awareness, APPN Option Set 1120, using one of the following values: YES The local node does not support branch awareness.
Administration Commands define_node End Node: DLUR is supported, but will not be used to connect to a DLUS in another subnet. If multi-subnet operation is not required, you should use this value instead of YES, to reduce network traffic and congestion at the network node. This value is not supported for a Network Node. NO DLUR is not supported. pu_conc_support Specifies whether PU concentration is supported. Possible values are: YES PU concentration is supported. NO PU concentration is not supported.
Administration Commands define_node If OVERRIDE_REQDISCONT is specified, it must be combined with one or both of the values IMMEDIATE_DISCONTACT and IMMEDIATE_RECONTACTto alter the type of the REQDISCONT message. IMMEDIATE_DISCONTACT Use type “immediate” on REQDISCONT; if this value is not specified, SNAplus2 uses type “normal.” IMMEDIATE_RECONTACT Use type “immediate recontact” on REQDISCONT; if this value is not specified, SNAplus2 uses type “no immediate recontact.
Administration Commands define_node 2.42.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands define_partner_lu The target node is active, so you cannot use this command to modify its configuration. define_node command can be issued only to an inactive node. The Other Conditions Appendix A, Common Return Codes from snapadmin Commands, lists additional combinations of primary and secondary return codes that are common to all commands. 2.
Administration Commands define_partner_lu plu_un_name Uninterpreted name of the partner LU (the name of the LU as defined to the remote SSCP). The name is a type-A character string. To use the default uninterpreted name (the same as the network name taken from the fqplu_name parameter), do not specify this parameter. This parameter is only relevant if the partner LU is on a host and dependent LU 6.2 is used to access it.
Administration Commands define_qllc_dlc The plu_un_name parameter contained a character that was not valid. 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: PLU_ALIAS_CANT_BE_CHANGED The plu_alias parameter of an existing partner LU cannot be changed. PLU_ALIAS_ALREADY_USED The plu_alias parameter is already used for an existing partner LU or local LU with a different LU name.
Administration Commands define_qllc_ls The DLC is automatically started when the node is started. NO The DLC is automatically started only if a port or LS that uses it is defined as initially active; otherwise, it must be manually started. 2.44.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.44.
Administration Commands define_qllc_ls You cannot use this command to modify the port used by an existing LS; the port_name specified on the command must match the previous definition of the LS. The LS can be modified only if it is not started. 2.45.
Administration Commands define_qllc_ls fac retry_limit retry_timeout idle_timeout pvc_id sn_id cud dddlu_offline_supported hex array decimal decimal decimal decimal character hex array constant 32 3 16 (null string) 5 3 30 1 0 C3 NO Supplied parameters are: ls_name Name of the link station to be defined. description A text string describing the LS. SNAplus2 uses this string for information only.
Administration Commands define_qllc_ls If the adjacent node is not an APPN node, possible values are: BACK_LEVEL_LEN_NODE The adjacent node is one that does not include the Network Name control vector in its XID3. HOST_XID3 The adjacent node is a host node; SNAplus2 responds to a polling XID from the node with a format 3 XID. HOST_XID0 The adjacent node is a host node; SNAplus2 responds to a polling XID from the node with a format 0 XID.
Administration Commands define_qllc_ls This TG number is used to represent the link when the link is activated. The node does not accept any other number from the adjacent node during activation of this link; if the adjacent node is using preassigned TG numbers, the same TG number must be defined by the adjacent node on the adjacent link station. If the local node is a LEN node, or if the adjacent node is a LEN node and the link is defined to automatically activate, set the TG number to 1.
Administration Commands define_qllc_ls You cannot change the PU name on an LS that is already defined. If the PU name is required and you do not specify it, the default is the same as the LS name. To ensure that this name is a valid type-A character string, SNAplus2 converts it to uppercase; if the string begins with a numeric character, this character is either removed or preceded by the characters “PU.” disable_remote_act Specifies whether to prevent activation of the LS by the remote node.
Administration Commands define_qllc_ls bkup_dlus_name Name of the backup DLUS node from which DLUR solicits SSCP services if the node specified by dlus_name is not active. This parameter is reserved if dspu_services is not set to DLUR. Specify 3–17 type-A characters that consist of a 1–8 character network name, followed by a period, followed by a 1–8 character backup LU name. To specify the global backup default DLUS, defined using define_dlur_defaults, do not specify this parameter.
Administration Commands define_qllc_ls SNA Standard SNA host. FNA Fujitsu Network Architecture (VTAM-F) host HNA Hitachi Network Architecture host SUPPRESS_CP_NAME Suppress the CP name associated with the remote node. Use a + character to combine this value with SNA, FNA, or HNA.
Administration Commands define_qllc_ls A decimal value representing the line speed in bits per second. connect_cost Cost per connect time. Valid values are integer values in the range 0–255, where 0 is the lowest cost per connect time and 255 is the highest cost per connect time. byte_cost Cost per byte. Valid values are integer values in the range 0–255, where 0 is the lowest cost per byte and 255 is the highest cost per byte. security Security level of the network.
Administration Commands define_qllc_ls Maximum propagation delay. user_def_parm_1 through user_def_parm_3 User-defined parameters that you can use to include TG characteristics not covered by the previously described parameters. Each of these parameters must be set to a value in the range 0–255. target_pacing_count Indicates the desired pacing window size. Specify a value in the range 1–32,767.
Administration Commands define_qllc_ls The adjacent node must be a Branch Network Node. PROHIBITED The adjacent node must not be a Branch Network Node. If adj_cp_type is set to NETWORK_NODE and auto_act_supp is set to YES, this parameter must be set to REQUIRED or PROHIBITED. max_send_btu_size Maximum BTU size that can be sent from this link station. This value is used to negotiate the maximum BTU size that a pair of link stations can use to communicate with each other.
Administration Commands define_qllc_ls If the auto_act_supp parameter is set to YES, the react_timer and react_timer_retry parameters are ignored; if the link fails, SNAplus2 does not attempt to reactivate it until the user application that was using the session attempts to restart the session. If the LS is a PVC link, you are recommended to set this parameter to a non-zero value to ensure that the link is always available.
Administration Commands define_qllc_ls Packet size used for receiving data on switched virtual circuits from the remote station. This parameter is used only if the vc_type parameter is set to SVC. The packet size you specify is sent as an optional facility on the outgoing call. When you specify DEFAULT, SNAplus2 uses the default value for the network. Possible values are: 64 128 256 512 1024 2048 4096 DEFAULT Consult the Systems Administrator for your X.25 network to determine the correct value to use.
Administration Commands define_qllc_ls Specify a value on the range 1–255. If vc_type is set to PVC, this parameter is ignored for QXID messages; XID sending is retried indefinitely (an initially active LS can wait indefinitely for the remote station to become active). retry_timeout Timeout in seconds for QXID, QSM, or QDISC messages. A message will be retried (up to the number of times specified by retry_limit) if no response is received within this time. Specify a value in the range 1–255.
Administration Commands define_qllc_ls If the host supports DDDLU but does not support the NMVT (power off) message, this parameter must be set to NO. 2.45.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.45.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands define_qllc_ls INVALID_DSPU_SERVICES The dspu_services parameter was not set to a valid value or was set when not expected. INVALID_SOLICIT_SSCP_SESS The solicit_sscp_sess parameter was not set to a valid value. INVALID_TARGET_PACING_CNT The target_pacing_count parameter was not set to a valid value. INVALID_DLUS_NAME The dlus_name parameter contained a character that was not valid or was not in the correct format.
Administration Commands define_qllc_ls INVALID_UPLINK The branch_link_type parameter was set to UPLINK, but the definition of an existing LS between the local and adjacent nodes specifies that it is a downlink. The branch link type must be the same for all LSs between the same two nodes. INVALID_DOWNLINK The branch_link_type parameter was set to DOWNLINK, but the definition of an existing LS between the local and adjacent nodes specifies that it is an uplink.
Administration Commands define_qllc_port 2.46 define_qllc_port The define_qllc_port command is used to define a new QLLC port or modify an existing QLLC 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.
Administration Commands define_qllc_port retry_limit retry_timeout idle_timeout decimal decimal decimal 5 3 30 Supplied parameters are: port_name Name of the port to be defined. This name is a character string using any locally displayable characters. description A text string describing the port. SNAplus2 uses this string for information only. It is stored in the node’s configuration file and returned on the query_port command. dlc_name Name of the associated DLC.
Administration Commands define_qllc_port If the implicit_dspu_services parameter is not set to PU_CONCENTRATION, the implicit_dspu_template parameter is reserved. implicit_ls_limit Specifies the maximum number of implicit link stations which can be active on this port simultaneously, including dynamic links and links activated for Discovery. Specify a value in the range 1–65,534 or specify 0 (zero) to indicate no limit. A value of NO_IMPLICIT_LINKS indicates that no implicit links are allowed.
Administration Commands define_qllc_port Specifies the link station transmit/receive capability. Possible values are: LS_TWS Two-way simultaneous LS_TWA Two-way alternating max_ifrm_rcvd Maximum number of I-frames that can be received by the local link stations before an acknowledgment is sent. Specify a value in the range 1–127. target_pacing_count Indicates the desired pacing window size. Specify a value in the range 1–32,767. max_send_btu_size Maximum BTU size that can be sent from this port.
Administration Commands define_qllc_port • If an SSCP-PU session is active but no traffic has flowed for the specified time period, the node sends REQDISCONT(normal) to the host. The host is then responsible for deactivating all LUs and the PU, at which time the local node will deactivate the link. However, the host may not deactivate LUs with active PLU-SLU sessions; in this case, the link remains active until all these sessions are deactivated (for example by the user logging out).
Administration Commands define_qllc_port DONTCARE The address on incoming calls is not checked. IDENTITY The received address must match the string specified in the address parameter. STARTSWITH The initial bytes (the number of bytes is specified in the add_len parameter) of the received address must match the string specified in the address parameter; any bytes greater than the number specified in add_len are not checked. If the address parameter is not specified, this parameter must be set to DONTCARE.
Administration Commands define_qllc_port INVALID_MAX_IFRM_RCVD The max_ifrm_rcvd parameter was not set to a valid value. HPR_NOT_SUPPORTED A reserved parameter was set to a nonzero value. INVALID_LS_ROLE The ls_role parameter was not set to a valid value. INVALID_DSPU_SERVICES The implicit_dspu_services parameter was not set to a valid value. INVALID_TEMPLATE_NAME The DSPU template specified on the implicit_dspu_template parameter was not valid.
Administration Commands define_rcf_access If the address does not match, an LS is dynamically defined. To ensure that the explicit LS definition (including the required PU name) is used, be sure that the address defined for this LS matches the address that is supplied by the host or the downstream computer on the incoming call. 2.47 define_rcf_access The define_rcf_access command defines access to the SNAplus2 Remote Command Facility (RCF).
Administration Commands define_rje_wkstn The query_* commands are allowed to be directed at any node in the domain. ALLOW_DEFINE_REMOTE The define_*, set_*, delete_*, add_*, remove_* , and init_node commands are allowed to be directed at any node in the domain. ALLOW_ACTION_REMOTE The start_*, stop_*, activate_*, deactivate_*, aping, initialize_session_limit, change_session_limit, and reset_session_limit commands are allowed to be directed at any node in the domain. 2.47.
Administration Commands define_rje_wkstn 2.48.1 Supplied Parameters Parameter name [define_rje_wkstn] workstation_name description primary_user group_name system_name lu_name Type Length character character character character character character 4 31 32 32 128 8 Default (null string) (null string) (Up to five lu_name parameters can be included.) Supplied parameters are: workstation_name The name of the workstation. This name is a string of up to four characters; it is not case-sensitive.
Administration Commands define_rtp_tuning • Jobs can be submitted to the workstation on any computer where the workstation can be run, but jobs will not be sent to the host until the workstation is started on the computer where the jobs are spooled.
Administration Commands define_rtp_tuning path_switch_attempts short_req_retry_limit path_switch_time_low path_switch_time_medium path_switch_time_high path_switch_time_network decimal decimal decimal decimal decimal decimal 6 6 480 240 120 60 Supplied parameters are: path_switch_attempts Number of path switch attempts to set on new RTP connections. Specify a value in the range 1–255.
Administration Commands define_sdlc_dlc State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.50 define_sdlc_dlc The define_sdlc_dlc command defines a new SDLC DLC.
Administration Commands define_sdlc_dlc Type of adapter card used by the DLC. Possible values are: HP_PSI Single-port PSI card HP_ACC 8-port ACC card HP_EICON_PCI_SDLC Eicon PCI SDLC card adapter_number Adapter number used by the DLC. If the server contains more than one SDLC adapter card, specify 0 (zero) for the first card, 1 for the second card, and so on. Otherwise, set this parameter to 0 (zero). initially_active Specifies whether this DLC is automatically started when the node is started.
Administration Commands define_sdlc_ls PARAMETER_CHECK secondary_rc INVALID_DLC_NAME The supplied dlc_name parameter contained a character that was not valid. 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: DLC_ACTIVE A parameter cannot be modified because the DLC is currently active. INVALID_DLC_TYPE You cannot change the negotiable link support for an existing DLC.
Administration Commands define_sdlc_ls dspu_name dlus_name bkup_dlus_name hpr_supported link_deact_timer default_nn_server ls_attributes adj_node_id local_node_id cp_cp_sess_support use_default_tg_chars effect_cap connect_cost byte_cost security prop_delay user_def_parm_1 user_def_parm_2 user_def_parm_3 target_pacing_count max_send_btu_size ls_role initially_active react_timer react_timer_retry restart_on_normal_deact contact_timer contact_timer_retry contact_timer2 contact_timer_retry2 disc_timer disc_tim
Administration Commands define_sdlc_ls description A text string describing the LS. SNAplus2 uses this string for information only. It is stored in the node’s configuration file and returned on the query_ls, query_pu, and query_downstream_pu commands. port_name Name of the port associated with this link station. This name must match the name of a defined port. adj_cp_name Fully qualified name of the adjacent CP for this LS.
Administration Commands define_sdlc_ls DSPU_XID The adjacent node is a downstream PU; SNAplus2 includes XID exchange in link activation. The dspu_name and dspu_services parameters must also be set. DSPU_NOXID The adjacent node is a downstream PU; SNAplus2 does not include XID exchange in link activation. The dspu_name and dspu_services parameters must also be set. If you want to run independent LU 6.
Administration Commands define_sdlc_ls If a preassigned TG number is defined, the adj_cp_name parameter must also be defined, and the adj_cp_type parameter must be set to either END_NODE or NETWORK_NODE. limited_resource Specifies whether this link station is a limited resource and is automatically deactivated when there are no sessions using the link. Link stations on a nonswitched port cannot be configured as limited resource.
Administration Commands define_sdlc_ls YES The LS can be activated only by the local node; if the remote node attempts to activate it, SNAplus2 will reject the attempt. NO The LS can be activated by the remote node. dspu_services Specifies the services that the local node provides to the downstream PU across this link. This parameter is used only if the adjacent node is a downstream PU, or an APPN node with solicit_sscp_sessions set to NO; it is reserved otherwise.
Administration Commands define_sdlc_ls To specify the global backup default DLUS defined using define_dlur_defaults, do not specify this parameter. hpr_supported Specifies whether HPR is supported on this link. This parameter must be set to NO unless the adj_cp_type parameter indicates that the link connects to an APPN node. Possible values are: YES HPR is supported on this link. NO HPR is not supported on this link. link_deact_timer Limited resource link deactivation timer, in seconds.
Administration Commands define_sdlc_ls HNA Hitachi Network Architecture host SUPPRESS_CP_NAME Suppress the CP name associated with the remote node. Use a + character to combine this value with SNA, FNA, or HNA. If adj_cp_type is set to BACK_LEVEL_LEN_NODE, and the remote LEN node associated with this LS cannot accept the Network Name CV in the format 3 XID it receives, use a + character to combine the value SNA, FNA, or HNA with SUPPRESS_CP_NAME (for example, SNA+SUPPRESS_CP_NAME).
Administration Commands define_sdlc_ls byte_cost Cost per byte. Valid values are integer values in the range 0–255, where 0 is the lowest cost per byte and 255 is the highest cost per byte. security Security level of the network. Possible values are: SEC_NONSECURE No security. SEC_PUBLIC_SWITCHED_NETWORK Data is transmitted over a public switched network. SEC_UNDERGROUND_CABLE Data is transmitted over secure underground cable.
Administration Commands define_sdlc_ls target_pacing_count Indicates the desired pacing window size. Specify a value in the range 1–32,767. max_send_btu_size Maximum BTU size that can be sent from this link station. This value is used to negotiate the maximum BTU size that a pair of link stations can use to communicate with each other. The value includes the length of the TH and RH (total 9 bytes) as well as the RU. Specify a value in the range 265–4105. ls_role Link station role.
Administration Commands define_sdlc_ls If the LS is a leased SDLC link, you are recommended to set this parameter to a non-zero value to ensure that the link is always available. restart_on_normal_deact Specifies whether SNAplus2 should attempt to reactivate the LS if it is deactivated normally by the remote system.
Administration Commands define_sdlc_ls nve_poll_timer Timeout required before an adjacent secondary station (which has previously been removed from the polling list because it has no data to send) is reinserted into the polling list. The timer is specified in milliseconds.
Administration Commands define_sdlc_ls The frame to use for preactivation polling. This frame is usually XID, indicating that polling is in the control of the DLC user. However, when SNAplus2 is primary talking to an old secondary implementation, it may be necessary to poll using some other frame. Possible values are: XID DISC SNRM SNRME TESTT poll_on_iframe Specifies whether this link station is allowed to send the poll bit on an I-frame.
Administration Commands define_sdlc_ls Dial data for outgoing calls. This parameter applies only to switched links; it is reserved if the port associated with this LS is defined as nonswitched. This parameter specifies the dial string to be passed to the modem to initiate the call. Support for dial data depends on the SDLC driver, adapter, and modem that you are using; if the driver, adapter, or modem do not support dial data, do not specify this parameter.
Administration Commands define_sdlc_ls The adjacent node must be a Branch Network Node. PROHIBITED The adjacent node must not be a Branch Network Node. If adj_cp_type is set to NETWORK_NODE and auto_act_supp is set to YES, this parameter must be set to REQUIRED or PROHIBITED. dddlu_offline_supported Specifies whether the local PU should send NMVT (power off) messages to the host.
Administration Commands define_sdlc_ls INVALID_CP_NAME The adj_cp_name parameter contained a character that was either not valid, not in the correct format, or not specified when required. INVALID_LIMITED_RESOURCE The limited_resource parameter was not set to a valid value. INVALID_LINK_NAME The ls_name parameter contained a character that was not valid. INVALID_LS_ROLE The ls_role parameter was not set to a valid value. INVALID_NODE_TYPE The adj_cp_type parameter was not set to a valid value.
Administration Commands define_sdlc_ls INVALID_BRNN_SUPPORT The adj_brnn_cp_support parameter was not set to a valid value. BRNN_SUPPORT_MISSING The adj_brnn_cp_support parameter was set to ALLOWED; this value is not valid because the adjacent node is a Network Node and auto_act_supp is set to YES. INVALID_UPLINK The branch_link_type parameter was set to UPLINK, but the definition of an existing LS between the local and adjacent nodes specifies that it is a downlink.
Administration Commands define_sdlc_ls 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.51.
Administration Commands define_sdlc_port Escape Sequence Decimal Value Hexadecimal Value NAK 21 0x15 SYN 22 0x16 ETB 23 0x17 CAN 24 0x18 EM 25 0x19 SUB 26 0x1A ESC 27 0x1B FS 28 0x1C GS 29 0x1D RS 30 0x1E US 31 0x1F SP 32 0x20 DEL 127 0x7F 2.52 define_sdlc_port The define_sdlc_port command is used to define a new SDLC port or to modify an existing port. Before issuing this command, you must define the DLC that this port uses.
Administration Commands define_sdlc_port max_send_btu_size address implicit_cp_cp_sess_support implicit_limited_resource implicit_hpr_support implicit_deact_timer implicit_uplink_to_en effect_cap connect_cost byte_cost security prop_delay user_def_parm_1 user_def_parm_2 user_def_parm_3 initially_active idle_timer idle_timer_retry np_rcv_timer np_rcv_timer_retry write_timer write_timer_retry link_conn_timer link_conn_timer_retry pri_fdplx sec_fdplx use_rej spec_port_type max_xid_size max_retry_count opt1 op
Administration Commands define_sdlc_port Name of the port to be defined. This name is a character string using any locally displayable characters. description A text string describing the port. SNAplus2 uses this string for information only. It is stored in the node’s configuration file and returned on the query_port command. dlc_name Name of the associated DLC. This name is a character string using any locally displayable characters. The specified DLC must have already been defined.
Administration Commands define_sdlc_port Primary LS_SEC Secondary LS_NEG Negotiable act_xid_exchange_limit Activation XID exchange limit. Specify a value in the range 1–65,535. nonact_xid_exchange_limit Nonactivation XID exchange limit. Specify a value in the range 1–65,535. ls_xmit_rcv_cap Specifies the link station transmit/receive capability.
Administration Commands define_sdlc_port implicit_limited_resource Specifies whether implicit link stations off this port are defined as limited resources. Possible values are: NO Implicit links are not limited resources and are not automatically deactivated. NO_SESSIONS Implicit links are limited resources and are automatically deactivated when no active sessions are using them.
Administration Commands define_sdlc_port Implicit links to an End Node are downlinks. effect_cap through user_def_parm_3 Default TG characteristics used for implicit link stations using this port and as the default TG characteristics for defined link stations that do not have explicitly defined TG characteristics. The TG characteristics parameters are ignored if the LS is to a downstream PU. For more information about these parameters, see Section 2.60, define_tr_ls, define_ethernet_ls, define_fddi_ls.
Administration Commands define_sdlc_port link_conn_timer The link connection timer. This parameter is used in conjunction with the value of the link_conn_timer_retry parameter to provide the time interval after which SNAplus2 fails an attempt to activate an LS because it has not detected that DSR has been raised. The timer is specified in milliseconds.
Administration Commands define_sdlc_port LEASED Port is used by a leased line.
Administration Commands define_sdlc_port INT_CLOCK Specify this value if the adapter supplies data clocking signals to the modem (internal clocking). Do not specify this value if data the modem supplies data clocking (external clocking) or if the underlying SDLC hardware supports only external clocking. DMA Specify this value to use DMA to transfer data to and from the communications card. Do not specify this value if you do not want to use DMA to transfer data to and from the communications card.
Administration Commands define_sdlc_port rcv_pool_size The initial number of buffers reserved for receiving data on this port. Set this to the value 4. poll_wait The number of seconds the port waits between successive polls of the line for errors or for raising DSR. A suitable value is 1 second. Increase this value for better throughput if there is only a small likelihood of line errors and the line is leased. hmod_data Dial data for incoming calls.
Administration Commands define_sdlc_port 2.52.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands define_security_access_list 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.52.
Administration Commands define_tn3270_access Supplied parameters are: list_name The name of the security access list. This name is a character string of 1–14 locally displayable characters. If this name matches an existing security access list, the users defined by this command are added to the list; otherwise a new list is created. description An optional string of 0–31 characters. SNAplus2 uses this string for information only.
Administration Commands define_tn3270_access This command can be used to define a new client, to define new sessions for use by an existing client, or to modify the session parameters for an existing client. (To delete sessions from an existing client, use delete_tn3270_access.) 2.54.
Administration Commands define_tn3270_access An optional string of 0–31 characters. You can use it to store additional information to help distinguish between clients. SNAplus2 uses this string for information only. It is stored in the configuration file and returned on the query_tn3270_access_def command. address_format Specifies the format of the client_address parameter.
Administration Commands define_tn3270_access port_number The number of the server TCP/IP port that the TN3270 emulator uses to access TN server. If the port number matches an existing port number defined for one of this TN3270 sessions, the information for that session is replaced; otherwise, a new session is added.
Administration Commands define_tn3270_association 2.54.4 Using the Telnet Daemon’s TCP/IP Port If you are setting up TN server to TCP/IP port number 23, you need to set up the HP-UX computer running TN server to share this port between TN server and the Telnet daemon program. To do this, take the following steps: Sharing TCP/IP Port Number 23 1. Ensure that the SNAplus2 software has stopped on the HP-UX computer. 2. Log on to the HP-UX computer as root. 3. Edit the file /etc/inetd.
Administration Commands define_tn3270_defaults display_lu_name description printer_lu_name character character character 8 31 8 (null string) Supplied parameters are: display_lu_name Specifies the name of the display LU to be associated with the printer specified by the printer_lu_name parameter. This name consists of 1–8 type-A characters. The specified display LU should be a display LU defined on the local node. description An optional text string describing the association.
Administration Commands define_tn3270_defaults 2.56.1 Supplied Parameters Parameter [define_tn3270_defaults] force_responses keepalive_method keepalive_interval Type Length constant constant decimal Default NO NONE 600 Supplied parameters are: force_responses Controls client responses on printer sessions. Possible values are: YES Always request definite responses from the client printer sessions. Some 3270 emulators are unable to print large jobs if definite responses are not requested.
Administration Commands define_tp 2.56.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands define_tp Name of the security access list used by this TP (defined using the define_security_access_list command). This parameter restricts the TP so that only the users named in the specified list can allocate conversations with it. If you specify a security access list, the security_rqd parameter must be set to YES. To specify that the TP is available for use by any user, do not specify this parameter. conv_type Specifies the type or types of conversation supported by this TP.
Administration Commands define_tp Specifies whether the TP can receive program initialization parameters (PIP). Possible values are: YES TP can receive PIP. NO TP cannot receive PIP. tp_instance_limit Limit on the number of instances of this TP that can be active at any one time. Specify a value in the range 1–65,535, or 0 (zero) for no limit. 2.57.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.57.
Administration Commands define_tp_load_info SECURITY_LIST_NOT_DEFINED The security_list_name parameter did not match any defined security list name. 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.58 define_tp_load_info The define_tp_load_info command is used to define or change a TP load information entry.. 2.58.
Administration Commands define_tp_load_info The full path name of the TP executable. arguments Command-line arguments required by the TP. These arguments are separated with spaces. type Specifies the TP type. Possible values are: QUEUED The TP is a queued TP. QUEUED-BROADCAST The TP is a broadcast queued TP. NON-QUEUED The TP is a nonqueued TP. timeout Timeout in seconds after the TP is loaded. Specify a value in the range 0–65,535. The value −1 indicates an infinite timeout.
Administration Commands define_tr_dlc, define_ethernet_dlc, define_fddi_dlc primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_TP_TYPE The type parameter was not set to a valid value. INVALID_TP_NAME The tp_name parameter specified did not match the name of a defined TP. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands define_tr_dlc, define_ethernet_dlc, define_fddi_dlc A text string describing the DLC. SNAplus2 uses this string for information only. It is stored in the node’s configuration file and returned on the query_dlc command. neg_ls_supp Specifies whether the DLC supports negotiable link stations. You cannot change the negotiable link support for an existing DLC; this parameter can be specified only when creating a new DLC.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc INVALID_DLC_NAME The supplied dlc_name parameter contained a character that was not valid.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls port_name adj_cp_name adj_cp_type character character constant 8 17 mac_address lsap_address auto_act_supp tg_number limited_resource solicit_sscp_sessions pu_name disable_remote_act dspu_services dspu_name dlus_name bkup_dlus_name hpr_supported hpr_link_lvl_error link_deact_timer default_nn_server ls_attributes adj_node_id local_node_id cp_cp_sess_support use_default_tg_chars effect_cap hex array hex number constant decimal const
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls Supplied parameters are: ls_name Name of the link station to be defined. description A text string describing the LS. SNAplus2 uses this string for information only. It is stored in the node’s configuration file and returned on the query_ls, query_pu, and query_downstream_pu commands. port_name Name of the port associated with this link station. This name must match the name of a defined port.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls HOST_XID0 The adjacent node is a host node; SNAplus2 responds to a polling XID from the node with a format 0 XID. DSPU_XID The adjacent node is a downstream PU; SNAplus2 includes XID exchange in link activation. The dspu_name and dspu_services parameters must also be set. DSPU_NOXID The adjacent node is a downstream PU; SNAplus2 does not include XID exchange in link activation.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls If the local node is a LEN node, or if the adjacent node is a LEN node and the link is automatically activated, set the TG number to 1. Otherwise, specify a number in the range 1–20, or 0 (zero) to indicate that the TG number is not preassigned and is negotiated when the link is activated.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls If the PU name is required and you do not specify it, the default is the same as the LS name. To ensure that this name is a valid type-A character string, SNAplus2 converts it to uppercase; if the string begins with a numeric character, this character is either removed or preceded by the characters “PU.” disable_remote_act Specifies whether to prevent activation of the LS by the remote node.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls bkup_dlus_name Name of the backup DLUS node from which DLUR solicits SSCP services if the node specified by dlus_name is not active. This parameter is reserved if dspu_services is not set to DLUR. The name is a type-A character string, consisting of a 1–8 character network name, followed by a period, followed by a 1–8 character backup DLUS name.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls NO This link does not support CP-CP sessions to a network node that can act as the local node’s NN server; the local node cannot automatically activate this link if it needs to contact an NN server. If the local node is not an end node, this parameter is ignored. ls_attributes Attributes of the remote system with which SNAplus2 is communicating. Specify SNA unless you are communicating with a host of one of the other following types.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls APPN node; this parameter, and effect_cap through user_def_parm_3 parameters are ignored otherwise. Possible values are: YES Use the default TG characteristics; ignore effect_cap through user_def_parm_3 parameters on this command. NO Use effect_cap through user_def_parm_3 parameters on this command. effect_cap A decimal value representing the line speed in bits per second. connect_cost Cost per connect time.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls PROP_DELAY_TELEPHONE Delay is in the range .5–50 microseconds (typical for a telephone network). PROP_DELAY_PKT_SWITCHED_NET Delay is in the range 50–250 microseconds (typical for a packet-switched network). PROP_DELAY_SATELLITE Delay is greater than 250 microseconds (typical for a satellite link). PROP_DELAY_MAXIMUM Maximum propagation delay.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls Specify a value in the range 1–65,534, or specify 65,535 to indicate that SNAplus2 should retry indefinitely until it contacts the DLUS. branch_link_type This parameter applies only if the local node is a Branch Network Node; it is not used if the local node is any other type.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls Retry count for reactivating a failed LS. This parameter is used to specify whether SNAplus2 attempts to reactivate the LS if it fails while in use (or if an attempt to start the LS fails). Specify 0 (zero) to indicate that SNAplus2 should not attempt to reactivate the LS, or specify the number of retries to be made. A value of 65,535 indicates that SNAplus2 should retry indefinitely until the LS is activated.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls Some systems may provide alternative methods of configuring the LLC2 stack, in which case this parameter can be ignored. For more information, contact your SNAplus2 supplier. dddlu_offline_supported Specifies whether the local PU should send NMVT (power off) messages to the host.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls INVALID_LIMITED_RESOURCE The limited_resource parameter was not set to a valid value. INVALID_LINK_NAME The ls_name parameter contained a character that was not valid. INVALID_NODE_TYPE The adj_cp_type parameter was not set to a valid value. INVALID_PORT_NAME The port_name parameter did not match the name of any defined port.
Administration Commands define_tr_ls, define_ethernet_ls, define_fddi_ls INVALID_UPLINK The branch_link_type parameter was set to UPLINK, but the definition of an existing LS between the local and adjacent nodes specifies that it is a downlink. The branch link type must be the same for all LSs between the same two nodes. INVALID_DOWNLINK The branch_link_type parameter was set to DOWNLINK, but the definition of an existing LS between the local and adjacent nodes specifies that it is an uplink.
Administration Commands define_tr_port, define_ethernet_port, define_fddi_port If the two nodes are on LANs of different types (one Ethernet, the other Token Ring or FDDI) connected by a bridge, you will usually need to reverse the bit order of each byte of the address when specifying a remote MAC address. To reverse the bit order, take the following steps: Reversing the Bit Order in a MAC Address 1. List the MAC address as six bytes, with each byte represented by two hexadecimal digits. 2.
Administration Commands define_tr_port, define_ethernet_port, define_fddi_port 2.61.
Administration Commands define_tr_port, define_ethernet_port, define_fddi_port Name of the associated DLC. This name is a character string using any locally displayable characters. The specified DLC must have already been defined. port_number The number of the port. max_rcv_btu_size Maximum BTU size that can be received. This value includes the length of the TH and RH (total 9 bytes) as well as the RU. Specify a value in the range 265–65535.
Administration Commands define_tr_port, define_ethernet_port, define_fddi_port act_xid_exchange_limit Activation XID exchange limit. Specify a value in the range 0–65,535. nonact_xid_exchange_limit Nonactivation XID exchange limit. Specify a value in the range 0–65,535. ls_xmit_rcv_cap Specifies the link station transmit/receive capability.
Administration Commands define_tr_port, define_ethernet_port, define_fddi_port • If no SSCP-PU session is active across the link, the node deactivates the link immediately. • If an SSCP-PU session is active but no traffic has flowed for the specified time period, the node sends REQDISCONT(normal) to the host. The host is then responsible for deactivating all LUs and the PU, at which time the local node will deactivate the link.
Administration Commands define_tr_port, define_ethernet_port, define_fddi_port Default TG characteristics used for implicit link stations using this port and as the default TG characteristics for defined link stations that do not have explicitly defined TG characteristics. The TG characteristics parameters are ignored if the LS is to a downstream PU. For more information about these parameters, see Section 2.60, define_tr_ls, define_ethernet_ls, define_fddi_ls.
Administration Commands define_tr_port, define_ethernet_port, define_fddi_port One of the activation limit parameters, inb_link_act_lim, out_link_act_lim, or tot_link_act_lim, was not set to a valid value. INVALID_MAX_IFRM_RCVD The max_ifrm_rcvd parameter was not set to a valid value. HPR_NOT_SUPPORTED A reserved parameter was set to a nonzero value. DLUR_NOT_SUPPORTED The implicit_dspu_services parameter was used to request a service that is not supported.
Administration Commands define_userid_password 2.62 define_userid_password The define_userid_password command defines a user ID / password pair for use with APPC and CPI-C conversation security, or adds profiles for a defined user ID and password. 2.62.
Administration Commands delete_adjacent_len_node used, specify the profile name as one of the profile parameters on this command. In most cases, profile names are not used, therefore you do not need to specify them on this command. 2.62.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.62.
Administration Commands delete_adjacent_len_node 2.63.1 Supplied Parameters Parameter name Type [delete_adjacent_len_node] cp_name character lu_name character wildcard_lus constant Length Default 17 8 NO (Up to ten lu_name parameters can be specified.) Supplied parameters are: cp_name The fully qualified name of the CP in the adjacent node. Specify 3–17 type-A characters consisting of a 1–8 character network name, followed by a period, followed by a 1–8 character CP name.
Administration Commands delete_backup One or more of the specified LU names contained a character that was not valid. 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: INVALID_CP_NAME The specified CP name does not match the name of a defined directory entry. INVALID_LU_NAME One or more of the specified LU names does not match any defined LU name.
Administration Commands delete_cn 2.64.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command.
Administration Commands delete_cos If you are deleting ports without deleting the connection network, specify the names of the ports to be deleted. Each port name is a string of up to eight characters. To delete the connection network, do not specify any port names. 2.65.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.65.
Administration Commands delete_cpic_side_info SNAplus2 will remap these modes to the default COS (specified by a define_mode command with no mode name) or to the SNA-defined COS #CONNECT if no default COS is specified. 2.66.1 Supplied Parameters Parameter name [delete_cos] cos_name Type Length character 8 Supplied parameter is: cos_name Specifies the class of service name to be deleted. This name is type-A character string starting with a letter. 2.66.
Administration Commands delete_directory_entry Because CPI-C side information entries are defined as domain resources, this command is not associated with a particular node. 2.67.1 Supplied Parameters Parameter name [delete_cpic_side_info] sym_dest_name Type Length character 8 Supplied parameter is: sym_dest_name Symbolic destination name that identifies the side information entry. Specify any locally displayable character. 2.67.
Administration Commands delete_directory_entry 2.68.1 Supplied Parameters Parameter name Type [delete_directory_entry] resource_name character resource_type constant Length Default 17 LU_RESOURCE Supplied parameters are: resource_name Fully qualified name of the resource to be deleted. Specify 3–17 type-A characters consisting of a 1–8 character network name, followed by a period, followed by a 1–8 character resource name. resource_type Specifies the type of the resource to be deleted.
Administration Commands delete_dlc primary_rc STATE_CHECK secondary_rc CANT_DELETE_ADJ_ENDNODE The specified entry is for an end node, and the node to which this command was issued is its network node server. You cannot delete this end node entry. 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.69 delete_dlc The delete_dlc command deletes a DLC.
Administration Commands delete_downstream_lu State Check If the command does not execute because of a state error, SNAplus2 returns the following parameters: primary_rc STATE_CHECK secondary_rc DLC_ACTIVE The DLC cannot be deleted because it is currently active. Use stop_dlc to stop the DLC before attempting to delete it. 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.
Administration Commands delete_downstream_lu_range 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: INVALID_LU_NAME The dslu_name parameter did not match any defined downstream LU name. DSLU_ACTIVE The LU cannot be deleted because it is currently active.
Administration Commands delete_dspu_template 2.71.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.71.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands delete_dspu_template template_name character 8 {dslu_template} min_nau max_nau host_lu allow_timeout delayed_logon decimal decimal character constant constant 8 NO NO Supplied parameters are: template_name Name of the DSPU template to be deleted, or the DSPU template containing the DSLU templates to be deleted. Specify 1–8 locally displayable characters. To delete the entire DSPU template, do not specify any dslu_template subrecords.
Administration Commands delete_emulator_user primary_rc OK secondary_rc (This parameter is not used.) 2.72.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands delete_emulator_user Supplied parameters are: user_name The name of the 3270 or 5250 user. This name is a string of 1–32 locally displayable characters which must match a previously defined 3270 or 5250 user name. delete_options To delete one or more sessions but leave other sessions configured, do not specify this parameter, and specify the session names to be deleted as session_name parameters.
Administration Commands delete_focal_point 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.74 delete_focal_point The delete_focal_point command deletes the definition of a focal point for a specified MS category (either the main focal point for that category or a backup focal point).
Administration Commands delete_internal_pu primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_CATEGORY_NAME The ms_category parameter contained a character that was not valid. INVALID_TYPE The type parameter was not set to a valid value. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands delete_local_lu 2.75.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands delete_ls 2.76.1 Supplied Parameters Parameter name [delete_local_lu] lu_name Type Length character 8 Supplied parameter is: lu_name Name of the local LU to be deleted. This name is a type-A character string starting with a letter. 2.76.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.76.
Administration Commands delete_ls_routing ls_name character 8 Supplied parameter is: ls_name Name of the link station to be deleted. 2.77.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.77.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands delete_ls_routing 2.78.1 Supplied Parameters Parameter name [delete_ls_routing] lu_name fq_partner_lu wildcard_fqplu Type Length character character constant 8 17 Default NO Supplied parameters are: lu_name Name of the local LU that communicated with the partner LU (specified by the fq_partner_lu parameter). Specify 1–8 locally displayable characters. fq_partner_lu Fully qualified name of the partner LU to be removed from the local LU’s LS routing data.
Administration Commands delete_lu_0_to_3 INVALID_LOCAL_LU The lu_name parameter contained a character that was not valid. INVALID_PARTNER_LU The fq_partner_lu parameter contained a character that was not valid. INVALID_WILDCARD_NAME The wildcard_fqplu parameter was set to YES, but the fq_partner_lu parameter was not a valid wildcard name.
Administration Commands delete_lu_0_to_3_range 2.79.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands delete_lu_0_to_3_range base_name Base name for the names of the LUs. This name is a type-A character string of 1–5 characters starting with a letter. (However, if you specified USE_HEX_IN_NAME for the name_attributes parameter on the define_lu_0_to_3_range command, the base name can be 6 characters long.) SNAplus2 determines the names of the LUs to be deleted by appending the 3-digit decimal value of each NAU address to this name.
Administration Commands delete_lu_lu_password The base_name parameter contained a character that was not valid. State Check If the command does not execute because of a state error, SNAplus2 returns the following parameters: primary_rc STATE_CHECK secondary_rc INVALID_LU_NAME There were no LUs defined with names in the specified range. 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.
Administration Commands delete_lu_pool 2.81.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands delete_lu62_timeout Name of the LU pool to be deleted or name of the LU pool from which LUs are to be removed. This name is an 8–byte type-A character string. lu_name To remove one or more LUs from the pool without deleting the pool, specify the names of the LUs to be removed. Each name is a type-A character string starting with a letter. To remove all LUs from the pool and delete the pool, do not specify any LU names. 2.82.
Administration Commands delete_lu62_timeout resource_type resource_name constant character 17 GLOBAL_TIMEOUT (null string) Supplied parameters are: resource_type Specifies the type of timeout being deleted. Possible values are: GLOBAL_TIMEOUT Delete timeouts that apply to all LU 6.2 sessions for the local node. LOCAL_LU_TIMEOUT Delete timeouts that apply to all LU 6.2 sessions for the local LU specified in the resource_name parameter. PARTNER_LU_TIMEOUT Delete timeouts that apply to all LU 6.
Administration Commands delete_mode Possible values are: INVALID_RESOURCE_TYPE The value specified in the resource_type parameter was not valid. INVALID_LU_NAME The LU name specified in the resource_name parameter was not valid. INVALID_PARTNER_LU The partner LU name specified in the resource_name parameter was not valid. INVALID_MODE_NAME The mode name specified in the resource_name parameter was not valid.
Administration Commands delete_partner_lu Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: CP_OR_SNA_SVCMG_UNDELETABLE The specified mode name is one of the SNA-defined mode names and cannot be deleted. MODE_NAME_NOT_DEFD The specified mode name is not the name of a mode defined on the SNAplus2 system.
Administration Commands delete_port 2.85.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands delete_rcf_access Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc INVALID_PORT_NAME The specified port name was not the name of a port defined on the SNAplus2 system.
Administration Commands delete_rje_wkstn Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.88 delete_rje_wkstn The delete_rje_wkstn command deletes an RJE workstation.
Administration Commands delete_security_access_list The specified workstation_name parameter did not match any RJE workstation name. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands delete_tn3270_access Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_LIST_NAME The specified security access list name was not defined as a security access list name. INVALID_USER_NAME One or more of the specified user names did not match the name of a user defined for this security access list.
Administration Commands delete_tn3270_access This command refers to the default TN3270 access record. The client_address parameter is not used. NO This command refers to a specific TN3270 access record specified in the client_address parameter. client_address The TCP/IP address of the client to be deleted. This can be specified as a dotted-decimal IP address (such as 193.1.11.100), as a fully qualified name (such as newbox.this.co.
Administration Commands delete_tn3270_association 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.91 delete_tn3270_association The delete_tn3270_association command deletes an association between a display LU and a printer LU, given the display LU name. 2.91.
Administration Commands delete_tp 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.92 delete_tp The delete_tp command deletes a TP definition. 2.92.1 Supplied Parameters Parameter name [delete_tp] tp_name Type Length character 64 Supplied parameter is: tp_name Name of the TP to be deleted. 2.92.
Administration Commands delete_tp_load_info 2.93 delete_tp_load_info The delete_tp_load_info command is used to delete a TP load information entry. Both the tp_name and lualias parameters are mandatory. To delete all the entries for a particular TP, an application must first call the query_tp_load_infocommand for that TP and then delete the entries for the different LU aliases one at a time.. 2.93.
Administration Commands delete_userid_password 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.94 delete_userid_password The delete_userid_password command deletes a password associated with a user ID, or deletes profiles for a user ID and password. 2.94.
Administration Commands init_node PARAMETER_CHECK secondary_rc Possible values are: NO_PROFILES The delete_type parameter was set to REMOVE_PROFILES, but no profiles were specified. UNKNOWN_USER The user_id parameter did not match a defined user ID. INVALID_UPDATE_TYPE The delete_type parameter was set to a value that was not valid. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands initialize_session_limit INVALID_NODE_NAME The node name specified in the configuration file does not match the name of the SNAplus2 computer to which the command was issued. NOT_SERVER The node name specified in the configuration file matches the name of the SNAplus2 computer, but the specified computer is a client (not a server) and cannot run the node. DLUR_NOT_SUPPORTED The configuration of the node specifies that DLUR is supported, but the node is defined as a LEN node.
Administration Commands initialize_session_limit set_negotiable plu_mode_session_limit min_conwinners_source min_conwinners_target auto_act constant decimal decimal decimal decimal NO 0 0 0 Supplied parameters are: lu_name LU name of the local LU. This name is a type-A character string. To indicate that the LU is defined by its LU alias instead of its LU name, do not specify this parameter. lu_alias LU alias of the local LU. This alias is a character string using any locally displayable characters.
Administration Commands initialize_session_limit Minimum number of sessions using this mode for which the partner LU is the contention winner. The sum of the min_conwinners_source and min_conwinners_target parameters must not exceed the plu_mode_session_limit parameter. Specify a value in the range 0–32,767. auto_act Number of contention winner sessions to be automatically activated after the session limits for the LU-LUmode combination have been negotiated.
Administration Commands initialize_session_limit The mode_name parameter did not match any defined mode name. INVALID_PLU_NAME The fqplu_name parameter did not match any defined partner LU name. INVALID_SET_NEGOTIABLE The set_negotiable parameter was not set to a valid value.
Administration Commands path_switch 2.97 path_switch The path_switch command requests that SNAplus2 switch a currently active Rapid Transport Protocol (RTP) connection to another path. If SNAplus2 cannot find a better path, it leaves the connection unchanged. 2.97.1 Supplied Parameters Parameter name [path_switch] rtp_connection_name Type Length character 8 Supplied parameter is: rtp_connection_name The RTP connection for which a change in path is requested. 2.97.
Administration Commands query_3270_diag PATH_SWITCH_DISABLED secondary_rc (No secondary return code is returned.) Path Switch Failure If the command does not execute because the path switch attempt fails, SNAplus2 returns the following parameter: primary_rc UNSUCCESSFUL secondary_rc (No secondary return code is returned.
Administration Commands query_3270_diag Maximum number of 3270 user alerts for which data should be returned. You can specify 1 to return data for a specific 3270 user alert, a number greater than 1 to return data for multiple 3270 user alerts, or 0 (zero) to return data for all 3270 user alerts. The default for this command indicates “return all entries,” unlike other query_* commands for which the default is to return a specific entry.
Administration Commands query_3270_user Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_ALERT_NUMBER The list_options parameter was set to LIST_INCLUSIVE or LIST_FROM_NEXT, but one of the following events has occurred: • The alert_number parameter was not in the valid range. • The alert with the specified number has not been defined.
Administration Commands query_3270_user list_options The level of information required for each entry and the position in the list of users from which SNAplus2 begins to return data.
Administration Commands query_3270_user If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise it performs a DNS lookup to determine the computer name. If all SNAplus2 components are running on one computer, there is no need to specify the computer name.
Administration Commands query_3270_user_sessions The computer name on which the 3270 emulation program is running. user_pid The process ID of the 3270 emulation program. user_uid The user ID with which the 3270 emulation program is running. user_gid The group ID with which the 3270 emulation program is running. user_gname The group name with which the 3270 emulation program is running. user_session_count The number of sessions currently active for this copy of the 3270 emulation program.
Administration Commands query_3270_user_sessions depending on the options used. You can use query_emulator_user_def to obtain information about the configuration file definition of a 3270 user (such as session limits and access to 3270 functions), and query_3270_user to obtain general information about the user’s 3270 emulation program usage. This command must be issued to a running node. 2.100.
Administration Commands query_3270_user_sessions If all SNAplus2 components are running on one computer, there is no need to specify the computer name. Otherwise, if no computer name is specified, SNAplus2 returns the first entry it finds for the specified user name; you do not need to specify the computer name unless the specified user is using the 3270 emulation program on more than one computer. user_pid The process ID of the 3270 emulation program for which information is required.
Administration Commands query_active_transaction primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_3270_USER The user_name, system_name, or user_pid parameter was not set to a valid value. INVALID_3270_SESSION The lu_name parameter was not set to a valid value. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_active_transaction Start at the first entry in the list LIST_INCLUSIVE Start at the entry specified by the fq_req_loc_cp_name, req_agent_appl_name, and seq_num_dt parameters LIST_FROM_NEXT Start at the entry immediately following the entry specified by the fq_req_loc_cp_name, req_agent_appl_name, and seq_num_dt parameters fq_req_loc_cp_name Fully qualified control point name of the transaction requester. This parameter is ignored if list_options is set to FIRST_IN_LIST.
Administration Commands query_active_transaction fq_req_loc_cp_name Fully qualified control point name of the transaction requestor. req_agent_appl_name Application name of the transaction requester. This name is usually a type-1134 character string; alternatively, it can be one of the MS Discipline-Specific Application Programs specified in Systems Network Architecture: Management Services.
Administration Commands query_adjacent_nn 2.102 query_adjacent_nn The query_adjacent_nn command returns information about adjacent network nodes (the network nodes to which CP-CP sessions are active or have been active at some time). The command can be used only if the SNAplus2 node is a network node (NN); it is not valid if the node is an end node (EN) or low-entry networking (LEN) node.
Administration Commands query_adjacent_nn adj_nncp_name Fully qualified name of the adjacent NN. cp_cp_sess_status Status of the CP-CP session to the adjacent NN. Possible values are: ACTIVE The session is active. CONWINNER_ACTIVE The session (a contention winner session) is active. CONLOSER_ACTIVE The session (a contention loser session) is active. INACTIVE The session is inactive. out_of_seq_tdus Number of out-of-sequence TDUs received from this node.
Administration Commands query_available_tp The local node is an end node or LEN node. This command is valid only for a network node. secondary_rc (This parameter is not used.) 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.103 query_available_tp The query_available_tp command returns information about active invokable transaction programs (TPs).
Administration Commands query_available_tp system_name The computer name for which TP information is required. The system name is a string of 1–64 locally displayable characters. This value is ignored if list_options is set to FIRST_IN_LIST. If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise it performs a DNS lookup to determine the computer name. It is not necessary to specify the system_name parameter if SNAplus2 is standalone.
Administration Commands query_bck_cs_trace 2.104 query_bck_cs_trace The query_bck_cs_trace command returns information about the current options for back-level client-server tracing. Client-server tracing is the tracing of data sent between a current-level SNAplus2 server and a back-level server or client.
Administration Commands query_buffer_availability State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands query_buffer_availability throttle_status buf_use_status max_buf_total_count max_buf_total_bytes max_buf_rsrv_count max_buf_rsrv_bytes max_buf_res_use_count max_buf_res_use_bytes max_peak_usage max_throttle_status max_buf_use_status debug_param decimal constant decimal decimal decimal decimal decimal decimal decimal decimal constant character 32 If the command executes successfully, SNAplus2 returns the following parameters: buf_avail The maximum amount of STREAMS buffer space av
Administration Commands query_central_logger max_buf_rsrv_count The maximum number of buffers that can be reserved. max_buf_rsrv_bytes The maximum amount of buffer storage that can be reserved, in bytes. max_buf_res_use_count The maximum number of reserved buffers that can be in use. max_buf_res_use_bytes The maximum number of bytes of reserved buffers that can be in use at any time. max_peak_usage Maximum peak buffer usage—smoothed percentage of buffers actually used.
Administration Commands query_central_logging 2.106.1 Supplied Parameters [query_central_logger] No parameters are supplied for this command. 2.106.2 Returned Parameters Parameter name node_name Type character Length 128 If the command executes successfully, SNAplus2 returns the following parameter: node_name The name of the node defined as the central logger. You can issue query_central_logging to this node to determine whether central logging is currently enabled. 2.106.
Administration Commands query_cn No parameters are supplied for this command. 2.107.2 Returned Parameters Parameter name enabled Type constant If the command executes successfully, SNAplus2 returns the following parameter: enabled Specifies whether central logging is enabled or disabled. Possible values are: YES Central logging is enabled. All log messages are sent to a single central file on the node that is currently the central logger. NO Central logging is disabled.
Administration Commands query_cn 2.108.1 Supplied Parameters Parameter name [query_cn] num_entries list_options fqcn_name Type decimal constant character Length Default 17 1 LIST_INCLUSIVE (null string) Supplied parameters are: num_entries Maximum number of CNs for which data should be returned. You can specify 1 to return data for a specific CN, a number greater than 1 to return data for multiple CNs, or 0 (zero) to return data for all CNs.
Administration Commands query_cn A text string describing the CN, as specified in the definition of the CN. num_ports The total number of ports on the connection network. effect_cap A decimal value representing the line speed in bits per second. connect_cost Cost per connect time. byte_cost Cost per byte. security Security level of the network. Possible values are: SEC_NONSECURE No security. SEC_PUBLIC_SWITCHED_NETWORK Data is transmitted over a public switched network.
Administration Commands query_cn_port user_def_parm_1 through user_def_parm_3 User-defined parameters that you can use to include other characteristics not covered by the above parameters. Each of these parameters has a value in the range 0–255. 2.108.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands query_cn_port 2.109.1 Supplied Parameters Parameter name [query_cn_port] num_entries list_options fqcn_name port_name Type decimal constant character character Length Default 1 LIST_INCLUSIVE 17 8 (null string) Supplied parameters are: num_entries Maximum number of ports for which data should be returned. You can specify 1 to return data for a specific port, a number greater than 1 to return data for multiple ports, or 0 (zero) to return data for all ports.
Administration Commands query_conversation 2.109.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands query_conversation num_entries list_options conv_id lu_name lu_alias session_id decimal constant hex number character character hex array 4 8 8 8 1 SUMMARY + LIST_INCLUSIVE 0x00 (null string) (null string) (null array) Supplied parameters are: num_entries Maximum number of sessions for which data should be returned.
Administration Commands query_conversation bytes_received conv_state decimal constant If the command executes successfully, SNAplus2 returns the following parameters: conv_id Conversation identifier. The conversation ID was returned by the ALLOCATE verb in the invoking TP, or by the RECEIVE_ALLOCATE verb in the invoked TP. local_tp_name The name of the local TP in the conversation. partner_tp_name The name of the partner TP in the conversation.
Administration Commands query_cos Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: BAD_CONV_ID The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied conversation ID, but the conv_id parameter value was not valid. INVALID_LU_ALIAS The lu_alias parameter value was not valid.
Administration Commands query_cos Possible values are: FIRST_IN_LIST Start at the first entry in the list LIST_INCLUSIVE Start at the entry specified by the cos_name parameter LIST_FROM_NEXT Start at the entry immediately following the entry specified by the cos_name parameter cos_name COS name for which data is required, or the name to be used as an index into the list. This value is ignored if list_options is set to FIRST_IN_LIST. The name is a type-A character string starting with a letter. 2.111.
Administration Commands query_cos_node_row trees Number of route tree caches built for this COS since the last initialization. calcs Number of session activation requests (and therefore route calculations) specifying this COS. rejs Number of session activation requests that failed because there was no acceptable route through the network from this node to the named destination. A route is only acceptable if it is made up entirely of active TGs and nodes that can provide the specified class of service. 2.
Administration Commands query_cos_node_row node_row_index decimal 0 Supplied parameters are: num_entries Maximum number of COS node rows for which data should be returned. You can specify 1 to return data for a specific COS node row, a number greater than 1 to return data for multiple COS node rows, or 0 (zero) to return data for all COS node rows. list_options The position in the list of COS node rows from which SNAplus2 begins to return data.
Administration Commands query_cos_tg_row For more information about these parameters, see Section 2.12, define_cos. 2.112.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands query_cos_tg_row Supplied parameters are: num_entries Maximum number of COS TG rows for which data should be returned. You can specify 1 to return data for a specific COS TG row, a number greater than 1 to return data for multiple COS TG rows, or 0 (zero) to return data for all COS TG rows. list_options The position in the list of COS TG rows from which SNAplus2 begins to return data. The list is ordered by cos_name, and then by tg_row_index, for each COS.
Administration Commands query_cos_tg_row cos_name Specifies the class of service (COS) name. tg_row_index Specifies the TG row index (the first row has an index of zero). min_effect_cap Minimum limit for line speed, in bits per second. min_connect_cost Minimum limit for cost per connect time. min_byte_cost Minimum limit for cost per byte. min_security Minimum level of security. Possible values are: SEC_NONSECURE Data is transmitted over an unsecured network.
Administration Commands query_cos_tg_row min_user_def_parm_1 through min_user_def_parm_3 Minimum limits for user-defined parameters, which you can use to include TG characteristics not covered by previously defined parameters. Each of these parameters has a range of 0–255. max_effect_cap Maximum limit for line speed, in bits per second. max_connect_cost Maximum limit for cost per connect time. max_byte_cost Maximum limit for cost per byte. max_security Maximum level of security.
Administration Commands query_cpic_side_info Delay is greater than 250 microseconds (typical delay for a satellite link), or maximum propagation delay. This value is returned if the define_cos specified either PROP_DELAY_SATELLITE or PROP_DELAY_MAXIMUM for max_prop_delay. max_user_def_parm_1 through max_user_def_parm_3 Maximum limits for user-defined parameters, which you can use to include TG characteristics not covered by previously defined parameters. Each of these parameters has a range of 0–255.
Administration Commands query_cpic_side_info sym_dest_name character 8 (null string) Supplied parameters are: num_entries Maximum number of symbolic destination names for which data should be returned. You can specify 1 to return data for a specific symbolic destination name, a number greater than 1 to return data for multiple symbolic destination names, or 0 (zero) to return data for all symbolic destination names.
Administration Commands query_cs_trace 2.114.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command.
Administration Commands query_cs_trace To query the default tracing options (set by a set_cs_trace command with no system name), do not specify this parameter. 2.115.2 Returned Parameters Parameter name trace_flags trace_direction Type constant constant If the command executes successfully, SNAplus2 returns the following parameters: trace_flags The types of tracing currently active. For more information about these trace types, see Section 2.186, set_cs_trace.
Administration Commands query_default_pu PARAMETER_CHECK secondary_rc Possible values are: NAME_NOT_FOUND The server specified by the dest_sys parameter was not valid or was not started. LOCAL_SYSTEM The server specified by the dest_sys parameter is the same as the target node to which this command was issued. INVALID_TARGET The command was issued on a standalone server. This command can only be issued on a client-server system.
Administration Commands query_defaults Name of the PU associated with the currently active default PU session. This parameter usually contains the same value as the def_pu_name parameter. However, if a new default PU has been defined but the session associated with it is not active, SNAplus2 continues to use the session associated with the previous default PU until the session associated with the defined default PU becomes active.
Administration Commands query_directory_entry Name of the default mode. If an application specifies an unrecognized mode name when attempting to start a session, the parameters from this mode are used as a default definition for the unrecognized mode. If no default mode name has been specified using the define_defaults command, this parameter is blank. implicit_plu_forbidden Indicates whether SNAplus2 puts implicit definitions in place for unknown partner LUs.
Administration Commands query_directory_entry When the command is issued to a running node, it returns information about the resources that have been explicitly defined (using define_directory_entry or define_adjacent_len_node) and the resources that have been located dynamically in the directory database. If the node is not running, only explicitly defined entries are returned.
Administration Commands query_directory_entry LIST_FROM_NEXT Start at the entry immediately following the entry specified by the combination of the parent_name, resource_name, and resource_type parameters resource_name Fully qualified name of the resource for which information is required, or the name to be used as an index into the list of resources. This value is ignored if list_options is set to FIRST_IN_LIST.
Administration Commands query_directory_entry 2.118.2 Returned Parameters: Summary Information Parameter name resource_name resource_type description real_owning_cp_type real_owning_cp_name Type character constant character constant character Length 17 31 17 If the command executes successfully and you specified SUMMARY as the list_options parameter value, the following parameters are returned: resource_name Fully qualified name of the resource. resource_type Type of the resource.
Administration Commands query_directory_entry resource_type description parent_name parent_type entry_type location real_owning_cp_type real_owning_cp_name supplier_cp_type supplier_cp_name constant character character constant constant constant constant character constant character 31 17 17 17 If the command executes successfully and you specified DETAIL as the list_options parameter value, the following parameters are returned: resource_name Fully qualified name of the resource resource_type Type of
Administration Commands query_directory_entry Cached entry REGISTER Registered resource (NN only) location Specifies the location of the resource. Possible values are: LOCAL The resource is at the local node. DOMAIN The resource belongs to an attached end node. CROSS_DOMAIN The resource is not within the domain of the local node. real_owning_cp_type This parameter applies only if the local node is a Network Node or a Branch Network Node; it is not used otherwise.
Administration Commands query_directory_lu This parameter applies only if the local node is a Network Node or a Branch Network Node; it is reserved otherwise. If the supplier_cp_type parameter indicates that the directory entry was registered by a node that is not the owning resource, this parameter specifies the fully qualified name of the CP that supplied the registration; otherwise it is not used.
Administration Commands query_directory_lu lu_name character 17 (null string) Supplied parameters are: num_entries Maximum number of LUs for which data should be returned. You can specify 1 to return data for a specific LU, a number greater than 1 to return data for multiple LUs, or 0 (zero) to return data for all LUs. list_options The level of information required for each entry and the position in the list of LUs from which SNAplus2 begins to return data.
Administration Commands query_directory_lu description server_name lu_owner_name location entry_type wild_card apparent_lu_owner_name character character character constant constant constant character 31 17 17 17 If the command executes successfully and you specified DETAIL as the list_options parameter value, the following parameters are returned: lu_name Fully qualified name of the LU. description A text string describing the directory entry, as specified in the definition of the directory entry.
Administration Commands query_directory_stats OTHER The entry is an unknown type. apparent_lu_owner_name This parameter applies only if the local node is a Network Node or a Branch Network Node; it is not used otherwise. If the apparent owning CP of this LU is not the real owning CP, this parameter specifies the fully qualified name of the apparent owning CP; otherwise it is not used.
Administration Commands query_directory_stats No parameters are supplied for this command. 2.120.
Administration Commands query_dlc in_bcast_locates For a network node, the number of broadcast locates received. out_locates Number of directed locates sent. out_bcast_locates For a network node, the number of broadcast locates sent. not_found_locates Number of directed locates returned “not found.” not_found_bcast_locates For a network node, the number of broadcast locates returned “not found.” locates_outstanding Current number of outstanding locates, both directed and broadcast. 2.120.
Administration Commands query_dlc Maximum number of DLCs for which data should be returned. You can specify 1 to return data for a specific DLC, a number greater than 1 to return data for multiple DLCs, or 0 (zero) to return data for all DLCs. list_options The level of information required for each entry and the position in the list of DLCs from which SNAplus2 begins to return data.
Administration Commands query_dlc The stop_dlc command is in progress. dlc_type Type of the DLC. Possible values are: SDLC Synchronous data link control QLLC Qualified logical link control TR Token Ring ETHERNET Ethernet FDDI Fiber distributed data interface HPRIP Enterprise Extender (HPR/IP) 2.121.
Administration Commands query_dlc udp_port_llc udp_port_network udp_port_high udp_port_medium udp_port_low ip_precedence_llc ip_precedence_network ip_precedence_high ip_precedence_medium ip_precedence_low no_dns_lookup decimal decimal decimal decimal decimal decimal decimal decimal decimal decimal constant If the command executes successfully and you specified DETAIL as the list_options parameter value, SNAplus2 returns the following parameters: dlc_name DLC name.
Administration Commands query_dlc_trace NO The DLC is not automatically started; it must be manually started. 2.121.4 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands query_dlc_trace Maximum number of entries for which data should be returned. You can specify 1 to return data for a specific entry, a number greater than 1 to return data for multiple entries, or 0 (zero) to return data for all entries. list_options The position in the list of entries from which SNAplus2 begins to return data. The list is ordered by resource_type and then by resource_name.
Administration Commands query_dlc_trace The required entry specifies the options used for tracing all DLCs, ports, link stations, and RTP connections. DLC The required entry specifies tracing options for the DLC named in resource_name and for all ports and link stations that use this DLC. PORT The required entry specifies tracing options for the port named in resource_name and for all link stations that use this port. LS The required entry specifies tracing options for the LS named in resource_name.
Administration Commands query_dlc_trace resource_name sidh sidl odai message_type character hex byte hex byte constant constant 8 If the command executes successfully, SNAplus2 returns the following parameters: resource_type The type of resource to be traced. Possible values are: ALL_RESOURCES The entry specifies tracing options for all resources. DLC The entry specifies tracing options for the DLC named in resource_name and for all ports and link stations that use this DLC.
Administration Commands query_dlc_trace message_type The type of messages to be traced for the specified resource or session. If all messages are being traced, this parameter is set to TRACE_ALL.
Administration Commands query_dlur_defaults State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.123 query_dlur_defaults The query_dlur_defaults command allows the user to query the defaults that were defined using the define_dlur_defaults command.
Administration Commands query_dlur_lu 2.123.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_dlur_lu list_options The level of information required for each entry and the position in the list of DLUR LUs from which SNAplus2 begins to return data. The list is ordered by pu_name and then by lu_name.
Administration Commands query_dlur_lu lu_name Name of the LU. 2.124.3 Returned Parameters: Detailed Information Parameter name lu_name pu_name dlus_name lu_location nau_address plu_name rscv_len Type character character character constant decimal character hex array Length 8 8 17 17 256 If the command executes successfully and you specified DETAIL as the list_options parameter value, SNAplus2 returns the following parameters: lu_name Name of the LU. pu_name Name of the PU associated with the LU.
Administration Commands query_dlur_pu Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_LU_NAME The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the lu_name parameter value was not valid. INVALID_FILTER_OPTION The filter parameter was not set to a valid value.
Administration Commands query_dlur_pu num_entries list_options pu_name dlus_name filter decimal constant character character constant 8 17 1 SUMMARY + LIST_INCLUSIVE (null string) (null string) NONE Supplied parameters are: num_entries Maximum number of DLUR PUs for which data should be returned. You can specify 1 to return data for a specific DLUR PU, a number greater than 1 to return data for multiple DLUR PUs, or 0 (zero) to return data for all DLUR PUs.
Administration Commands query_dlur_pu NONE Return information about all PUs regardless of location. For end node, this parameter is reserved (downstream DLUR PUs are not supported). 2.125.2 Returned Parameters: Summary Information Parameter name pu_name description Type character character Length 8 31 If the command executes successfully and you specified SUMMARY as the list_options parameter value, SNAplus2 returns the following parameters: pu_name Name of the PU.
Administration Commands query_dlur_pu Name of the backup DLUS node, defined by either the define_internal_pu or define_*_ls command (with dspu_services set to DLUR). pu_id PU identifier, either defined on define_internal_pu or obtained in an XID from a downstream PU. This ID is a 4-byte hexadecimal string, consisting of a block number (three hexadecimal digits) and a node number (five hexadecimal digits). pu_location Location of the PU. Possible values are: INTERNAL The PU is on the local node.
Administration Commands query_dlur_pu PENDING_ACTIVE The pipe is being activated. ACTIVE The pipe is active. PENDING_INACTIVE The pipe is being deactivated. INACTIVE The pipe is not active. pcid Procedure correlator ID (PCID) used on the DLUS pipe. If the SSCP-PU session is not active, this parameter is not used. fqcp_name Fully qualified control point name used on the DLUS pipe. If the SSCP-PU session is not active, this parameter is not used.
Administration Commands query_dlus The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the pu_name parameter value was not valid. INVALID_FILTER_OPTION The filter parameter was not set to a valid value. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_dlus Maximum number of DLUSs for which data should be returned. You can specify 1 to return data for a specific DLUS, a number greater than 1 to return data for multiple DLUSs, or 0 (zero) to return data for all DLUSs. list_options The position in the list of DLUSs from which SNAplus2 begins to return data. The list is ordered by dlus_name.
Administration Commands query_dlus YES DLUS node has been designated as the default. NO DLUS node has not been designated as the default. is_backup_default Specifies whether the DLUS node has been designated as the backup default by a define_dlur_defaults command. Possible values are: YES DLUS node has been designated as the backup default. NO DLUS node has not been designated as the backup default. pipe_state State of the pipe to the DLUS.
Administration Commands query_dlus actlu_received Number of ACTLUs received from DLUS over the pipe to activate an LU. actlu_rsp_sent Number of RSP(ACTLU)s sent to DLUS over the pipe. dactlu_received Number of DACTLUs received from DLUS over the pipe to deactivate an LU. dactlu_rsp_sent Number of RSP(DACTLU)s sent to DLUS over the pipe. sscp_pu_mus_rcvd Number of SSCP-PU message units (MUs) received from DLUS over the pipe. sscp_pu_mus_sent Number of SSCP-PU message units (MUs) sent to DLUS over the pipe.
Administration Commands query_domain_config_file secondary_rc (This parameter is not used.) 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.127 query_domain_config_file The query_domain_config_file command returns the header information included in the domain configuration file (the SNAplus2 version number, the revision level of the file, and an optional comment string).
Administration Commands query_downstream_lu 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.128 query_downstream_lu The query_downstream_lu command returns information about downstream LUs that use PU concentration and DLUR.
Administration Commands query_downstream_lu Start at the entry immediately following the entry specified by the combination of the dspu_name and dslu_name parameters dslu_name Name of the LU for which information is required, or the name to be used as an index into the list of LUs. This value is ignored if list_options is set to FIRST_IN_LIST. The name is a type-A character string. dspu_name PU name for which LU information is required, as specified in the definition of an LS.
Administration Commands query_downstream_lu Possible values are: PU_CONCENTRATION Downstream LU is served by PU concentration. DLUR Downstream LU is served by DLUR. nau_address Network accessible unit (NAU) address of the downstream LU. This address is in the range 1–255. lu_sscp_sess_active Specifies whether the LU-SSCP session is active. Possible values are: YES The session is active. NO The session is not active. plu_sess_active Specifies whether the PLU-SLU session is active.
Administration Commands query_downstream_lu ds_plu_max_rcv_btu_size ds_plu_max_send_pac_win ds_plu_cur_send_pac_win ds_plu_max_rcv_pac_win ds_plu_cur_rcv_pac_win ds_plu_send_data_frames ds_plu_send_fmd_data_frames ds_plu_send_data_bytes ds_plu_rcv_data_frames ds_plu_rcv_fmd_data_frames ds_plu_rcv_data_bytes ds_plu_sidh ds_plu_sidl ds_plu_odai ds_plu_ls_name ds_plu_pacing_type us_plu_rcv_ru_size us_plu_send_ru_size us_plu_max_send_btu_size us_plu_max_rcv_btu_size us_plu_max_send_pac_win us_plu_cur_send_pac_
Administration Commands query_downstream_lu YES The session is active. NO The session is not active. dspu_services When the query_downstream_lu command is issued to a running node, this parameter specifies the services provided by the local node to the downstream LU. Possible values are: PU_CONCENTRATION Downstream LU is served by PU concentration. DLUR Downstream LU is served by DLUR.
Administration Commands query_downstream_lu Number of normal flow data bytes sent. rcv_data_frames Number of normal flow data frames received. rcv_fmd_data_frames Number of normal flow FMD data frames received. rcv_data_bytes Number of normal flow data bytes received. The following three parameters identify the Local Form Session Identifier (LFSID) for a session. The LFSID consists of the following parameters: sidh Session ID high byte.
Administration Commands query_downstream_lu If the downstream LU is used to communicate with a SNAplus2 Primary RUI application instead of a host, this field is set to the string #PRIRUI#. This parameter is reserved for DLUR-served downstream LUs. allow_timeout Specifies whether this downstream LU allows its session with the upstream LU to timeout. Possible values are: YES This downstream LU allows its session with the upstream LU to timeout.
Administration Commands query_downstream_pu primary_rc FUNCTION_NOT_SUPPORTED The local node does not support PU concentration or DLUR; support is defined by the pu_conc_support and dlur_support parameters in the node definition. secondary_rc (This parameter is not used.) 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.
Administration Commands query_downstream_pu Name of the PU for which information is required, as specified on define_*_ls, or the name to be used as an index into the list of PUs. This value is ignored if list_options is set to FIRST_IN_LIST. The name is a type-A character string. dspu_services DSPU services filter. Specifies whether to filter the returned information by the type of services provided to the PUs.
Administration Commands query_downstream_pu NO The session is not active. dspu_services Specifies the type of services provided to the PU. Possible values are: PU_CONCENTRATION Downstream PU is served by PU concentration. DLUR Downstream PU is served by DLUR. rcv_ru_size Maximum receive RU size; this parameter is reserved (set to 0) if the downstream PU is served by PU concentration.
Administration Commands query_downstream_pu The BIND sender is the node containing the secondary link station. NO The BIND sender is the node containing the primary link station. pacing_type The type of receive pacing in use on the PU-SSCP. This parameter will always be set to NONE. 2.129.
Administration Commands query_dspu_template 2.130 query_dspu_template The query_dspu_template command returns information about defined downstream PU templates used for PU concentration over implicit links. 2.130.1 Supplied Parameters Parameter name [query_dspu_template] num_entries list_options template_name Type decimal constant character Length Default 8 1 LIST_INCLUSIVE (null string) Supplied parameters are: num_entries Maximum number of entries for which data should be returned.
Administration Commands query_dspu_template If the command executes successfully, the following parameters are returned: template_name Name of the DSPU template. description Resource description, as defined on the define_dspu_template command. max_instance The maximum number of instances of the template which can be active simultaneously. active_instance The number of instances of the template which are currently active.
Administration Commands query_emulator_user_def 2.130.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands query_emulator_user_def The level of information required for each entry and the position in the list of users from which SNAplus2 begins to return data.
Administration Commands query_emulator_user_def description style_file num_sessions max_act_sessions view_rtm alert_permission change_lu change_style user_is_group character character decimal decimal constant constant constant constant constant 31 8 {3270_session_data} session_name description lu_name session_type model_override character character character constant constant 8 31 8 {5250_session_data} session_name description local_lu_alias plu_alias fqplu_name mode_name session_type character char
Administration Commands query_emulator_user_def Specifies whether the user has permission to view response time monitor (RTM) data. This parameter also determines whether the last transaction time indicator (LTTI) is displayed on the 3270 status line. Possible values are: YES The user can view RTM data. The LTTI is displayed. NO The user cannot view RTM data. The LTTI is not displayed. alert_permission Specifies whether the user has permission to send 3270 user alerts.
Administration Commands query_focal_point YES The user_name parameter identifies a group name. Any user in this group will use this emulator user record unless there is an explicit record for the user’s user name. NO The user_name parameter identifies a user name. If the command requested information about user sessions, a 3270_session_data or 5250_session_data subrecord is returned for each session. For more information about these subrecords, see Section 2.22, define_emulator_user. 2.131.
Administration Commands query_focal_point num_entries Maximum number of focal point entries for which data should be returned. You can specify 1 to return data for a specific focal point, a number greater than 1 to return data for multiple focal points, or 0 (zero) to return data for all focal points. list_options The position in the list of focal points from which SNAplus2 begins to return data.
Administration Commands query_focal_point description A text string describing the focal point, as specified in the definition of the focal point. bkup_appl_name Backup focal point application name. This name is one of the MS Discipline-Specific Application Programs specified in Systems Network Architecture: Management Services, or a user-defined category name. bkup_fp_fqcp_name Fully qualified control point name of the backup focal point.
Administration Commands query_global_log_type Name of the application registered for focal point category. This name is either one of the MS DisciplineSpecific Application Programs specified in the Systems Network Architecture: Management Services, or a user-defined category name. 2.132.
Administration Commands query_global_log_type This command must be issued without specifying a node name. 2.133.1 Supplied Parameters [query_global_log_type] No parameters are supplied for this command. 2.133.2 Returned Parameters Parameter name audit exception succinct_audits succinct_errors Type constant constant constant constant If the command executes successfully, SNAplus2 returns the following parameters: audit This parameter indicates whether audit messages are recorded.
Administration Commands query_isr_session Succinct logging is used in the error log file. Each message in the log file contains a summary of the message header information (such as the message number, log type, and system name) and the message text string and parameters. To obtain more details about the cause of the log and any action required, you can use the snaphelp utility. NO Full logging is used in the error log file.
Administration Commands query_isr_session session_type pcid fqcp_name constant hex array character 8 17 ISR_SESSIONS (null array) (null string) Supplied parameters are: num_entries Maximum number of sessions for which data should be returned. You can specify 1 to return data for a specific session, a number greater than 1 to return data for multiple sessions, or 0 (zero) to return data for all sessions.
Administration Commands query_isr_session fqcp_name character 17 If the command executes successfully and you specified SUMMARY as the list_options parameter value, SNAplus2 returns the following parameters: pcid Procedure Correlator ID. This ID is an 8-byte hexadecimal string. fqcp_name Fully qualified CP name. 2.134.
Administration Commands query_isr_session For more information about these parameters, see Section 2.168, query_session. rscv Route Selection control vector (RSCV) as defined in Systems Network Architecture: Formats. This control vector defines the session route through the network and is carried on the BIND. This RSCV is included only if the node’s configuration indicates that RSCVs should be stored for ISR sessions.
Administration Commands query_isr_session rcv_data_bytes Number of normal flow data bytes received. rcv_fmd_data_bytes Number of normal flow FMD data bytes received. sidh Session ID high byte. sidl Session ID low byte. odai Origin Destination Assignor Indicator. When bringing up a session, the sender of the BIND sets this field to zero if the local node contains the primary link station, and sets it to one if the BIND sender is the node containing the secondary link station.
Administration Commands query_kernel_memory_limit 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.135 query_kernel_memory_limit The query_kernel_memory_limit command returns information about the amount of kernel memory that SNAplus2 is currently using, the maximum amount it has used, and the configured limit.
Administration Commands query_local_lu actual The amount of kernel memory, in bytes, currently allocated to SNAplus2 components. max_used The maximum amount of kernel memory, in bytes, that has been allocated to SNAplus2 components at any time since the max_used parameter was last reset (as described for reset_max_used), or since the SNAplus2 software was started.
Administration Commands query_local_lu lu_alias pu_name character character 8 8 (null string) (null string) Supplied parameters are: num_entries Maximum number of LUs for which data should be returned. You can specify 1 to return data for a specific LU, a number greater than 1 to return data for multiple LUs, or 0 (zero) to return data for all LUs. list_options The level of information required for each entry and the position in the list of LUs from which SNAplus2 begins to return data.
Administration Commands query_local_lu 2.136.2 Returned Parameters: Summary Information Parameter name lu_name lu_alias description Type character character character Length 8 8 31 If the command executes successfully and you specified SUMMARY as the list_options parameter value, the following parameters are returned: lu_name LU name. lu_alias LU alias. description A text string describing the local LU, as specified in the definition of the LU. 2.136.
Administration Commands query_local_lu lu_name LU name. description A text string describing the local LU, as specified in the definition of the LU. list_name Name of the security access list used fine_security_access_list command). for use by any user. by this local LU (defined using the deIf this parameter is not set, the LU is available lu_alias LU alias. nau_address Network accessible unit (NAU) address of the LU.
Administration Commands query_local_lu Current size of the send pacing window on this session. max_rcv_pac_win Maximum size of the receive pacing window on this session. cur_rcv_pac_win Current size of the receive pacing window on this session. send_data_frames Number of normal flow data frames sent. send_fmd_data_frames Number of normal flow FMD data frames sent. send_data_bytes Number of normal flow data bytes sent. rcv_data_frames Number of normal flow data frames received.
Administration Commands query_local_topology Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_LU_ALIAS The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the lu_alias parameter value was not valid.
Administration Commands query_local_topology The level of information required for each entry and the position in the list of TGs from which SNAplus2 begins to return data. The list is ordered by dest, then by dest_type (in the order of NETWORK_NODE, END_NODE, VRN), and finally in numerical order of tg_num.
Administration Commands query_local_topology If the command executes successfully and you specified SUMMARY as the list_options parameter value, the following parameters are returned: dest Fully qualified destination node name of the TG. dest_type Node type of the destination node for this TG. Possible values are: NETWORK_NODE Network node (NN) VRN Virtual routing node (VRN) END_NODE End node (EN) or low-entry networking (LEN) node tg_num Number associated with the TG. 2.137.
Administration Commands query_local_topology End node (EN) or low-entry networking (LEN) node tg_num Number associated with the TG. dlc_data If dest_type is VRN, this parameter specifies the DLC address of the connection to the VRN. The number of bytes in the address depends on the DLC type. This parameter is not used otherwise. For Token Ring, Ethernet, or FDDI, the address is in two parts: a 6-byte MAC address and a 1-byte local SAP address.
Administration Commands query_local_topology The TG is a downlink to an End Node. DOWNLINK_TO_BRNN The TG is a downlink to a Branch Network Node that appears as an End Node from the perspective of the local node. OTHER The TG type is a link to a VRN. NOT_SUPPORTED This parameter does not apply because the local node is not a Branch Network Node. branch_tg This parameter applies only if the node is a Network Node; it is reserved otherwise. Specifies whether the TG is a branch TG.
Administration Commands query_log_file 2.138 query_log_file The query_log_file command enables you to determine the name of the file that SNAplus2 uses to record audit, error, or usage log messages, the name of the backup log file, and the file size at which log information is copied to the backup file. 2.138.1 Supplied Parameters Parameter name [query_log_file] log_file_type Type Length constant Default ERROR Supplied parameters are: log_file_type The type of log file to be queried.
Administration Commands query_log_type The maximum size of the log file specified by log_file_type. When a message written to the file causes the file size to exceed this limit, SNAplus2 clears the backup log file, copies the current contents of the log file to the backup log file, and then clears the log file. The maximum amount of disk space taken up by log files is approximately twice the value of file_size. 2.138.
Administration Commands query_log_type YES The audit, exception, and succinct_* parameters returned are local settings overriding the global settings. NO The audit, exception, and succinct_* parameters returned are the global settings, which are not being overridden. audit This parameter indicates whether audit messages are recorded. Possible values are: YES Audit messages are recorded. NO Audit messages are not recorded. exception This parameter indicates whether exception messages are recorded.
Administration Commands query_ls Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands query_ls Start at the first entry in the list LIST_INCLUSIVE Start at the entry specified by the ls_name parameter LIST_FROM_NEXT Start at the entry immediately following the entry specified by the ls_name parameter ls_name Link station name. This value is ignored if list_options is set to FIRST_IN_LIST. port_name Port name filter. To return information only on link stations associated with a specific port, specify the name of the port.
Administration Commands query_ls Enterprise Extender (HPR/IP) state State of this link station. Possible values are: ACTIVE The LS is active. NOT_ACTIVE The LS is not active. PENDING_ACTIVE The LS is being activated. PENDING_INACTIVE The LS is being deactivated. PENDING_ACTIVE_BY_LR The LS has failed (or an attempt to activate it has failed) and SNAplus2 is attempting to reactivate it. act_sess_count The total number of active sessions (both endpoint and intermediate) using the link.
Administration Commands query_ls Node type is unknown or LS is inactive. END_NODE An End Node, a Branch Network Node acting as an End Node from the local node’s perspective, or a LEN node that includes the Network Name CV in its XID3. NETWORK_NODE A Network Node, or a Branch Network Node acting as a Network Node from the local node’s perspective. BACK_LEVEL_LEN_NODE Back-level LEN node (one that does not include the Network Name CV in its XID3).
Administration Commands query_ls up_time decimal current_state_time decimal deact_cause constant determined_hpr_support constant anr_label hex array determined_hpr_link_lvl_error contant auto_act constant ls_type constant det_branch_link_type constant adj_cp_is_brnn constant node_id hex array active_isr_count decimal active_lu_sess_count decimal active_sscp_sess_count decimal reverse_anr_label hex array local_address hex array actual_max_send_btu_size decimal description character port_name character adj_c
Administration Commands query_ls For SDLC, the following parameters are included. For more information about these parameters, see Section 2.51, define_sdlc_ls.
Administration Commands query_ls remote_ip_host ack_timeout max_retry liveness_timeout short_hold_mode character decimal decimal decimal constant 100 If the command executes successfully and you specified DETAIL as the list_options parameter value, SNAplus2 returns the following parameters: ls_name Link station name. dlc_type Type of the DLC. Possible values are: SDLC Synchronous data link control X25 X.
Administration Commands query_ls Initial contact has been established (for example, TEST exchange on a LAN device) and the XID negotiation is in progress. SENT_ACTIVATE_AS Creating internal processes to handle the link. SENT_SET_MODE Waiting for a response to SNRM/SABME from the remote node. ACTIVE The link is fully active. SENT_DEACTIVATE_AS_ORDERLY Destroying internal processes. SENT_DISCONNECT The local node has sent a DISC frame to the remote node. WAITING_STATS The link has been disconnected.
Administration Commands query_ls The link was dynamically defined (in response to a connection request from the adjacent node or to dynamically connect to another node across a connection network). NO The link was explicitly defined as part of the SNAplus2 configuration. migration Specifies whether the adjacent node is a migration level node (such as a LEN node) or a full APPN network node or end node. Possible values are: YES The adjacent node is a migration-level node.
Administration Commands query_ls bad_xids Total number of unsuccessful XID exchanges that have occurred on this link station since it was started. start_time The time, in hundredths of a second, since system startup, that the link station was last activated (when the mode setting commands completed). stop_time The time, in hundredths of a second, since system startup, that the link station was last deactivated.
Administration Commands query_ls Specifies whether the link currently allows remote activation or activation on demand. This parameter is set to NONE if neither is allowed, or to one or both of the following values (combined with a + character): AUTO_ACT The link can be activated on demand by the local node when a session requires it. REMOTE_ACT The link can be activated by the remote node. ls_type Specifies how this link was defined or discovered.
Administration Commands query_ls The adjacent node type is unknown. node_id Node ID received from the adjacent node during XID exchange. active_isr_count Number of active intermediate sessions using this link. active_lu_sess_count Number of active LU-LU sessions using this link. active_sscp_sess_count Number of active PU-SSCP sessions using this link. reverse_anr_label The Reverse Automatic Network Routing (ANR) label for this link station. local_address The local address of this link station.
Administration Commands query_ls DSPU_XID Downstream PU. SNAplus2 includes XID exchange in link activation. DSPU_NOXID Downstream PU. SNAplus2 does not include XID exchange in link activation. auto_act_supp Specifies whether the link can be automatically activated when required by a session. Possible values are: YES The link can be automatically activated. NO The link cannot be automatically activated. tg_number Preassigned TG number, used to represent the link when the link is activated.
Administration Commands query_ls YES The LS can be activated only by the local node; if the remote node attempts to activate it, SNAplus2 will reject the attempt. NO The LS can be activated by the remote node. default_nn_server For an end node, this parameter specifies whether this is a link supporting CP-CP sessions to a network node that can act as the local node’s network node server.
Administration Commands query_ls NO Use effect_cap through user_def_parm_3 parameters returned on this command. ls_attributes Attributes of the remote system with which SNAplus2 is communicating. This parameter is usually set to SNA, unless you are communicating with a host of one of the other types listed below. Possible values are: SNA Standard SNA host. FNA Fujitsu Network Architecture (VTAM-F) host. HNA Hitachi Network Architecture host.
Administration Commands query_ls Data is transmitted over a public switched network. SEC_UNDERGROUND_CABLE Data is transmitted over secure underground cable. SEC_SECURE_CONDUIT Data is transmitted over a line in a secure conduit that is not guarded. SEC_GUARDED_CONDUIT Data is transmitted over a line in a conduit that is protected against physical tapping. SEC_ENCRYPTED Data is encrypted before transmission over the line.
Administration Commands query_ls Primary LS_SEC Secondary LS_NEG Negotiable max_ifrm_rcvd Maximum number of I-frames that can be received by the local link stations before an acknowledgment is sent. dlus_retry_timeout Time interval in seconds between attempts to contact the DLUS and backup DLUS. dlus_retry_limit Number of attempts to recontact a DLUS after an initial failure.
Administration Commands query_ls Possible values are: YES The local PU sends NMVT (power off) messages to the host. NO The local PU does not send NMVT (power off) messages to the host. If the host supports DDDLU but does not support the NMVT (power off) message, this parameter must be set to NO. initially_active Specifies whether this LS is automatically started when the node is started. Possible values are: YES The LS is automatically started when the node is started.
Administration Commands query_ls For an SDLC link station, this parameter identifies the address of the secondary station on this LS. The value of this parameter depends on how the port that owns this LS is configured, as follows: • If the port is used only for incoming calls (out_link_act_lim on define_sdlc_port is 0), this parameter is reserved.
Administration Commands query_ls_routing INVALID_LINK_NAME The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the value specified in the ls_name parameter was not valid. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_ls_routing lu_name Name of the local LU for which routing data is to be returned. This name is an 8-byte character string. This parameter is ignored if list_options is set to FIRST_IN_LIST. fq_partner_lu Fully qualified name of the partner LU for which routing data is to be returned. Specify 3–17 type-A characters that consist of a 1–8 character network name, followed by a period, followed by a 1–8 character partner LU name.
Administration Commands query_lu_0_to_3 Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_LU_NAME The list_options parameter was set to LIST_INCLUSIVE, but the value specified for the lu_name parameter did not match any existing LS routing data record.
Administration Commands query_lu_0_to_3 Maximum number of LUs for which data should be returned. You can specify 1 to return data for a specific LU, a number greater than 1 to return data for multiple LUs, or 0 (zero) to return data for all LUs. list_options The level of information required for each entry and the position in the list of LUs from which SNAplus2 begins to return data.
Administration Commands query_lu_0_to_3 If the node is not running, this parameter is ignored; SNAplus2 returns information about all LUs regardless of host attachment. 2.142.
Administration Commands query_lu_0_to_3 LU host attachment type. When the command is issued to a running node, this parameter takes one of the following values: DIRECT_ATTACHED LU is directly attached to the host system. DLUR_ATTACHED LU is supported by DLUR on the local node. DLUR LU is supported by passthrough DLUR from a downstream node. PU_CONCENTRATION LU is supported by PU concentration from a downstream node. 2.142.
Administration Commands query_lu_0_to_3 plu_rcv_data_bytes plu_sidh plu_sidl plu_odai plu_ls_name plu_name bind_lu_type session_id description nau_address pool_name pu_name priority lu_model term_method decimal hex number hex number constant character character constant hex array character decimal character character constant constant constant 8 8 8 31 8 8 If the command executes successfully and you specified DETAIL as the list_options parameter value, the following parameters are returned: lu_name Nam
Administration Commands query_lu_0_to_3 DLUR LU is supported by passthrough DLUR from a downstream node. PU_CONCENTRATION LU is supported by PU concentration from a downstream node. For each of the two sessions (LU-SSCP session and PLU-SLU session), the following parameters are included. The parameter names must begin with either lu_sscp_ or plu_ to distinguish between the two session types: rcv_ru_size Maximum RU size that can be received. (In the LU-SSCP session statistics, this parameter is reserved.
Administration Commands query_lu_0_to_3 odai Origin Destination Assignor Indicator. Possible values are: YES The BIND sender is the node containing the secondary link station. NO The BIND sender is the node containing the primary link station. ls_name Link station name associated with statistics. The following parameters are not distinguished by session type: plu_name Name of the primary LU. This parameter is reserved if the PLU-SLU session is inactive.
Administration Commands query_lu_0_to_3 NETWORK The LU has priority on the network. HIGH High priority is given to the LU. MEDIUM Medium priority is given to the LU. LOW Low priority is given to the LU. lu_model Type of the LU. Possible values are: 3270_DISPLAY_MODEL_2 LU type is a 3270 display model 2. 3270_DISPLAY_MODEL_3 LU type is a 3270 display model 3. 3270_DISPLAY_MODEL_4 LU type is a 3270 display model 4. 3270_DISPLAY_MODEL_5 LU type is a 3270 display model 5. PRINTER LU type is a printer.
Administration Commands query_lu_0_to_3 app_type user_name system_name user_pid user_type user_uid user_gid user_gname description constant character character decimal constant decimal decimal character character 32 32 32 31 The following parameters are returned: app_type Type of application using this LU. This parameter is set to FMI_APPLICATION. user_name The user name with which the 3270 emulation program is running. system_name The computer name on which the program is running.
Administration Commands query_lu_0_to_3 Returned Parameters for an LU Used by an RJE Workstation The detailed information returned contains the following parameters in addition to those shown in Section 2.142.
Administration Commands query_lu_0_to_3 Type of application using this LU. This parameter is set to TN_SERVER. user_ip_address The dotted-decimal IP address of the computer where the TN3270 program is running. port_number The TCP/IP port number that the TN3270 program uses to access TN server. cb_number TN server control block number. cfg_default Specifies whether the TN3270 program is using an explicitly defined TN server user record or is using the configured default record.
Administration Commands query_lu_lu_password This LU is a printer LU that has been associated with a display LU by a define_tn3270_association command, or a display LU that has been associated with a printer LU by a define_tn3270_association command. request_lu_name Requested LU name or associated display LU name. Returned Parameters for an LU Used by an LUA Application The detailed information returned contains the following parameters in addition to those shown in Section 2.142.
Administration Commands query_lu_lu_password 2.143.1 Supplied Parameters Parameter name [query_lu_lu_password] num_entries list_options lu_name lu_alias plu_alias fqplu_name Type decimal constant character character character character Length Default 8 8 8 17 1 LIST_INCLUSIVE (null string) (null string) (null string) (null string) Supplied parameters are: num_entries Maximum number of LUs for which data should be returned.
Administration Commands query_lu_lu_password 2.143.2 Returned Parameters Parameter name plu_alias fqplu_name description protocol_defined protocol_in_use Type character character character constant constant Length 8 17 31 1 1 If the command executes successfully, the following parameters are returned: plu_alias Partner LU alias. fqplu_name A 17-byte fully qualified network name of the partner LU. description A text string describing the LU-LU password, as specified in the definition of the password.
Administration Commands query_lu_pool INVALID_LU_NAME The supplied lu_name parameter did not match the name of any configured LU. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands query_lu_pool FIRST_IN_LIST Start at the first entry in the list LIST_INCLUSIVE Start at the entry specified by the combination of the pool_name and lu_name parameters LIST_FROM_NEXT Start at the entry immediately following the entry specified by the combination of the pool_name and lu_name parameters pool_name Name of the LU pool for which information is required. This parameter is an 8-byte character string. It is ignored if list_options is set to FIRST_IN_LIST.
Administration Commands query_lu_pool lu_sscp_sess_active appl_conn_active plu_sess_active constant constant constant If the command executes successfully and you specified DETAIL as the list_options parameter value, the following parameters are returned: pool_name Name of LU pool to which the LU belongs. description A text string describing the LU pool, as specified in the definition of the pool. lu_name LU name.
Administration Commands query_lu62_timeout INVALID_LU_NAME The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the lu_name parameter value was not valid. INVALID_POOL_NAME The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the pool_name parameter value was not valid.
Administration Commands query_lu62_timeout Maximum number of entries for which data should be returned. You can specify 1 to return data for a specific entry, a number greater than 1 to return data for multiple entries, or 0 (zero) to return data for all entries. list_options The position in the list of entries from which SNAplus2 begins to return data.
Administration Commands query_lu62_timeout resource_name timeout character decimal 17 If the command executes successfully, SNAplus2 returns the following parameters: resource_type The type of the timeout. Possible values are: GLOBAL_TIMEOUT Timeout applies to all LU 6.2 sessions for the local node. The resource_name parameter is set to all zeros. LOCAL_LU_TIMEOUT Timeout applies to all LU 6.2 sessions for the local LU indicated by the resource_name parameter.
Administration Commands query_mds_application 2.146 query_mds_application The query_mds_application command returns a list of applications that have registered for MDS-level messages (by issuing the MS verb REGISTER_MS_APPLICATION). For more information about this MS verb, refer to the HP-UX SNAplus2 MS Programmer’s Guide. This command can be used to obtain information about a specific application or about multiple applications, depending on the options used. This command must be issued to a running node.
Administration Commands query_mds_statistics max_rcv_size The maximum number of bytes the application can receive in one message (specified when an application registers with MDS). For more information about MDS-level application registration, refer to the HP-UX SNAplus2 MS Programmer’s Guide. 2.146.
Administration Commands query_mds_statistics 2.147.1 Supplied Parameters [query_mds_statistics] No parameters are supplied for this command. 2.147.
Administration Commands query_mode Number of MDS_MUs successfully delivered to remote nodes using the MDS_SEND transaction program. parse_errors Number of MDS_MUs received that contained header format errors. failed_deliveries Number of MDS_MUs that this node failed to deliver. ds_searches_performed Number of Directory Services searches used to locate the next hop for an MDS_MU. This parameter is significant for network nodes only.
Administration Commands query_mode sessions are currently active, or all modes that have been used, depending on the options used. The command returns information about current usage of the modes and LUs, not on their definition; use query_mode_definition to obtain the definition of the modes and LUs. This command must be issued to a running node. 2.148.
Administration Commands query_mode LU name of the local LU, as defined in SNAplus2. This name is a type-A character string. To indicate that the LU is identified by its LU alias instead of its LU name, do not specify this parameter. To specify the LU associated with the local CP (the default LU), do not specify either lu_name or lu_alias. lu_alias Locally defined LU alias. This parameter is used only if lu_name is not specified.
Administration Commands query_mode fqplu_name A 17-byte fully qualified network name of the partner LU. 2.148.
Administration Commands query_mode NO Waiting session requests are not satisfied before sessions are deactivated drain_partner Specifies whether the partner LU satisfies waiting session requests before deactivating a session when session limits are changed or reset. Possible values are: YES Waiting session requests are satisfied before sessions are deactivated. NO Waiting session requests are not satisfied before sessions are deactivated.
Administration Commands query_mode If a previous CNOS command set the mode session limit to 0 (zero), but sessions are still active because conversations were using them or waiting to use them, this parameter specifies the number of sessions that have not yet been deactivated. implicit Specifies whether the entry is for an implicit or explicit definition. Possible values are: YES The entry is for an implicit definition, which was created using the default mode name defined by the define_defaults command.
Administration Commands query_mode_definition 2.149 query_mode_definition The query_mode_definition command returns information about modes, including SNA-defined modes. This command can be used to obtain summary or detailed information about a specific mode or about multiple modes, depending on the options used. This command returns information about the definition of the modes, not about their current usage; use query_mode to obtain information about the current usage of a mode by local and partner LUs.
Administration Commands query_mode_definition 2.149.2 Returned Parameters: Summary Information Parameter name mode_name description Type character character Length 8 31 If the command executes successfully and you specified SUMMARY as the list_options parameter value, SNAplus2 returns the following parameters: mode_name Mode name. description A text string describing the mode, as specified in the definition of the mode. 2.149.
Administration Commands query_mode_to_cos_mapping Possible values are: INVALID_MODE_NAME The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the mode_name parameter value was not valid. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_nmvt_application The name of the mode for which information is required, or the name to be used as an index into the list. This value is ignored if list_options is set to FIRST_IN_LIST. To return information about the default COS that is used for any unrecognized mode names, set this parameter to a pair of angle brackets <> (indicating an empty hexadecimal array). 2.150.
Administration Commands query_nmvt_application information about a specific application or about multiple applications, depending on the options used. For more information about this MS verb, refer to the HP-UX SNAplus2 MS Programmer’s Guide. This command must be issued to a running node. 2.151.
Administration Commands query_nn_topology_node conversion_required Specifies whether the registered application requires incoming messages to be converted from NMVT to MDS_MU format. When the application registers for NMVT messages, it specifies whether this conversion is required. Possible values are: YES Incoming messages are converted to MDS_MU format. NO Incoming messages are not converted to MDS_MU format. 2.151.
Administration Commands query_nn_topology_node num_entries list_options node_name node_type frsn decimal constant character constant decimal 1 SUMMARY + LIST_INCLUSIVE (null string) LEARN_NODE 0 17 Note If the frsn parameter is set to a nonzero value, then only node entries with FRSNs equal to or greater than the one specified will be returned. If the frsn parameter is set to 0 (zero), then all node entries are returned.
Administration Commands query_nn_topology_node Virtual routing node (VRN) LEARN_NODE Node type is unknown frsn Flow reduction sequence number. Specify 0 (zero) to return information about all nodes or a nonzero value to return information about nodes with a FRSN greater than or equal to this value. This parameter can be used to ensure that consistent information is obtained when you need to issue several commands to obtain all required information.
Administration Commands query_nn_topology_node function_support branch_aware constant constant If the command executes successfully and you specified DETAIL as the list_options parameter value, the following parameters are returned: node_name Fully qualified name of the node. node_type Type of the node. Possible values are: NETWORK_NODE Network node (NN) END_NODE End node (EN) VRN Virtual routing node (VRN) days_left Number of days before this node entry will be deleted from the topology database.
Administration Commands query_nn_topology_node Peripheral border node function is supported. EXTENDED_BORDER_NODE Return border node function is supported. CDS Central directory server function is supported. GATEWAY Gateway node function is supported. INTERCHANGE_NODE Interchange node function is supported. ISR Intermediate session routing function is supported. HPR Node supports the base functions of High Performance Routing (HPR). RTP_TOWER Node supports the Rapid Transport Protocol tower of HPR.
Administration Commands query_nn_topology_stats Function Not Supported If the command does not execute because the node’s configuration does not support it, SNAplus2 returns the following parameters: primary_rc FUNCTION_NOT_SUPPORTED The local node is an end node or LEN node. This command is valid only for a network node. secondary_rc (This parameter is not used.
Administration Commands query_nn_topology_stats tg_purges total_route_calcs total_route_rejs total_tree_cache_hits total_tree_cache_misses total_tdu_wars decimal decimal decimal decimal decimal decimal If the command executes successfully, the following parameters are returned: max_nodes Maximum number of node records in the Topology Database that were specified in the node definition. A value of 0 (zero) indicates no limit. cur_num_nodes Current number of nodes in this node’s topology database.
Administration Commands query_nn_topology_stats node_purges Total number of topology node records purged from this node’s topology database. A purge occurs when a node record has not been updated in a specified amount of time. The owning node is responsible for broadcasting updates for its resource that it wants kept in the network topology. tg_low_rsns Total number of topology TG updates received by this node with RSN less than the current RSN. Both even and odd RSNs are included in this count.
Administration Commands query_nn_topology_tg total_tdu_wars Number of TDU wars the local node has detected and prevented. 2.153.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command.
Administration Commands query_nn_topology_tg tg_num frsn decimal decimal 0 0 Note If the frsn parameter is set to a nonzero value, then only node entries with FRSNs equal to or greater than the one specified will be returned. If the frsn parameter is set to 0 (zero), then all node entries are returned. Supplied parameters are: num_entries Maximum number of TGs for which data should be returned.
Administration Commands query_nn_topology_tg Virtual routing node (VRN) LEARN_NODE Node type is unknown dest Name of the destination node for the TG. This value is ignored if list_options is set to FIRST_IN_LIST. The name is a type-A character string, consisting of a 1–8 character network name, followed by a period, followed by a 1–8 character destination node name. dest_type Type of the destination node for the TG.
Administration Commands query_nn_topology_tg Name of the node that owns the TG. owner_type Type of the node that owns the TG. Possible values are: NETWORK_NODE Network node (NN) END_NODE End node (EN) VRN Virtual routing node (VRN) dest Name of the destination node for the TG. dest_type Type of the destination node for the TG. Possible values are: NETWORK_NODE Network node (NN) END_NODE End node (EN) VRN Virtual routing node (VRN) tg_num Number associated with the TG.
Administration Commands query_nn_topology_tg intersubnet_tg cp_cp_session_active branch_tg multilink_tg constant constant constant constant If the command executes successfully and you specified DETAIL as the list_options parameter value, the following parameters are returned: owner Name of the node that owns the TG. owner_type Type of the node that owns the TG.
Administration Commands query_nn_topology_tg status Specifies the status of the TG. Possible values are: NONE Transmission group link is not established. TG_OPERATIVE Transmission group link is operative. TG_CP_CP_SESSIONS Transmission group link is operative and carrying CP-CP sessions. TG_QUIESCING Transmission group link is shutting down. TG_HPR Transmission group supports High Performance Routing (HPR) protocols. TG_RTP Transmission group supports Rapid Transport Protocol (RTP).
Administration Commands query_nn_topology_tg Specifies whether the owning node’s contention winner CP-CP session is active. Possible values are: YES The CP-CP session is active. NO The CP-CP session is not active. UNKNOWN The CP-CP session status is unknown. branch_tg Specifies whether the TG is a branch TG. Possible values are: YES The TG is a branch TG. NO The TG is not a branch TG. UNKNOWN The TG type is unknown. 2.154.
Administration Commands query_node secondary_rc (This parameter is not used.) 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.155 query_node The query_node command returns information about the definition of a SNAplus2 node and also on its status if it is active. This command returns information only about a single node.
Administration Commands query_node hpr_support ptf_flags max_ls_exception_events max_compress_level up_time nn_functions_supported en_functions_supported nn_status nn_frsn nn_rsn def_ls_good_xids def_ls_bad_xids dyn_ls_good_xids dyn_ls_bad_xids dlur_release_level fq_nn_server_name current_isr_sessions nns_dlus_served_lu_reg_supp nn_functions2 branch_ntwk_arch_version constant constant decimal constant decimal constant constant constant decimal decimal decimal decimal decimal decimal decimal character deci
Administration Commands query_node mds_supported Specifies whether Management Services (MS) supports Multiple Domain Support (MDS) and Management Services Capabilities. Possible values are: YES MDS is supported. NO MDS is not supported. node_id Node identifier used in XID exchange. This ID is a 4-byte hexadecimal string, consisting of a block number (three hexadecimal digits) and a node number (five hexadecimal digits).
Administration Commands query_node cos_cache_size Size of the COS Database weights cache. tree_cache_size Network node: Size of the Topology Database routing tree cache. The minimum is 8. For an end node or LEN node, this parameter is reserved. tree_cache_use_limit Network node: Maximum number of uses of a cached tree. When this number is exceeded, the tree is discarded and recomputed. This enables the node to balance sessions among equal weight routes.
Administration Commands query_node RSCVs are stored. NO RSCVs are not stored. store_dlur_rscvs Specifies whether RSCVs are stored for diagnostic purposes. If this parameter is set to YES, an RSCV is returned on the query_dlur_lu command; an RSCV is stored for each PLU-SLU session using DLUR. This extra storage can be up to 256 bytes per session. Possible values are: YES RSCVs are stored. NO RSCVs are not stored. dlur_support Specifies whether DLUR is supported.
Administration Commands query_node ptf_flags Options for configuring and controlling program temporary fix (ptf) operation. This parameter is set to NONE or to one or more of the following values which can be combined with a + character. Possible values are: ERP SNAplus2 normally processes an ACTPU(ERP) as an ERP; this resets the PU-SSCP session but does not implicitly deactivate the subservient LU-SSCP and PLU-SLU sessions.
Administration Commands query_node are included in the Attach message that SNAplus2 receives, SNAplus2 normally checks the parameters (and rejects the Attach if they are not valid) even though the invokable TP does not require conversation security. This value disables the checking, so that SNAplus2 does not check security parameters on a received Attach if the invokable TP does not require it.
Administration Commands query_node en_functions_supported Specifies the end node functions that are supported. This parameter can be one or more of the following values, which can be combined with a + character: SEGMENT_GENERATION Node supports segment generation. MODE_TO_COS_MAP Node supports mode name-to-COS name mapping. LOCATE_CDINIT Node supports generation of locates and cross-domain initiate GDS variables for locating remote LUs.
Administration Commands query_node dyn_ls_bad_xids Total number of unsuccessful XID exchanges that have occurred on all dynamic link stations since the node was last started. dlur_release_level Release level of the DLUR architecture supported by the node. This parameter is set to 1 (the only release level of DLUR currently defined); future versions may incorporate later release levels of the DLUR architecture and therefore may return different values. fq_nn_server_name End node only.
Administration Commands query_node_all 2.155.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_node_all node_name Name of the node to be used as an index into the list. This parameter is ignored if list_options is set to FIRST_IN_LIST. If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise it performs a DNS lookup to determine the computer name. 2.156.
Administration Commands query_node_limits 2.157 query_node_limits The query_node_limits command returns information about the functions that your SNAplus2 license allows you to use on a particular node, and about your usage of these functions. These are divided into the following categories: • Node options, which specify the SNAplus2 features that you can use • Node limits, which specify the maximum numbers of SNAplus2 resources that can be in use on the node at any time.
Administration Commands query_node_limits The maximum number of APPC and CPI-C applications that your license allows you to have active at any one time. A value of zero indicates that you cannot use any APPC and CPI-C applications; a value of -1 indicates no limit. max_lua_tps The maximum number of LUA applications that your license allows you to have active at any one time. A value of zero indicates that you cannot use any LUA applications; a value of -1 indicates no limit.
Administration Commands query_node_limits The maximum number of link stations that have been active on this node at any time since the HP-UX computer was restarted. peak_tn3270_connections The maximum number of connections from TN3270 clients that have been active on this node at any time since the HP-UX computer was restarted. peak_data_sessions The maximum number of PLU-SLU sessions that have been active on this node at any time since the HP-UX computer was restarted.
Administration Commands query_node_limits Specifies whether your license allows you to use PU concentration on this node. Possible values are: YES Your license allows this node to provide PU concentration support. NO Your license does not allow this node to provide PU concentration support. tn_server_support Specifies whether your license allows you to use TN server on this node. Possible values are: YES Your license allows this node to provide TN server support.
Administration Commands query_partner_lu Other Conditions Appendix A, Common Return Codes from snapadmin Commands, lists additional combinations of primary and secondary return codes that are common to all commands. 2.158 query_partner_lu The query_partner_lu command returns information about partner LUs that a local LU is currently using or has used.
Administration Commands query_partner_lu Start at the entry immediately following the entry specified by the combination of local and partner LU names If FIRST_IN_LIST is specified, you can use a + character to include the following option: LIST_BY_ALIAS The list is returned in order of LU alias rather than LU name. This option is only valid if FIRST_IN_LIST is also specified.
Administration Commands query_partner_lu partner_cp_name partner_lu_located character constant 17 If the command executes successfully and you specified SUMMARY as the list_options parameter value, the following parameters are returned: plu_alias Partner LU alias. fqplu_name A 17-byte fully qualified network name of the partner LU. description A text string describing the partner LU, as specified in the definition of the partner LU.
Administration Commands query_partner_lu A 17-byte fully qualified network name of the partner LU. description A text string describing the partner LU, as specified in the definition of the partner LU. act_sess_count Total number of active sessions between the local LU and the partner LU. partner_cp_name Fully qualified network name for the CP associated with the partner LU. This parameter is not used if partner_lu_located is set to NO.
Administration Commands query_partner_lu NO The entry is an explicit entry. security_details Specifies the conversation security support as negotiated on the BIND. This parameter can be set to one or more of the following values, which can be combined with a + character: CONVERSATION_LEVEL_SECURITY Conversation security information is accepted on requests to or from the partner LU to allocate a conversation.
Administration Commands query_partner_lu_definition Possible values are: INVALID_LU_ALIAS The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the lu_alias parameter value was not valid. INVALID_LU_NAME The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the lu_name parameter value was not valid.
Administration Commands query_partner_lu_definition Specify the level of information required with one of the following values: SUMMARY Summary information only DETAIL Detailed information Use a + character to combine this value with one of the following values: FIRST_IN_LIST Start at the first entry in the list LIST_INCLUSIVE Start at the entry specified by the plu_alias or fqplu_name parameter LIST_FROM_NEXT Start at the entry immediately following the entry specified by the plu_alias or fqplu_name param
Administration Commands query_partner_lu_definition A 17-byte fully qualified network name of the partner LU. description A text string describing the partner LU, as specified in the definition of the partner LU. 2.159.
Administration Commands query_port Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_PLU_NAME The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the plu_alias or fqplu_name parameter value was not valid.
Administration Commands query_port Detailed information Use a + character to combine this value with one of the following values: FIRST_IN_LIST Start at the first entry in the list LIST_INCLUSIVE Start at the entry specified by the port_name parameter LIST_FROM_NEXT Start at the entry immediately following the entry specified by the port_name parameter port_name Name of the port for which information is required, or the name to be used as an index into the list of ports.
Administration Commands query_port 2.160.3 Returned Parameters: Detailed Information The following information is returned for all DLC types when you specify DETAIL for the list_options parameter.
Administration Commands query_port write_timer_retry link_conn_timer link_conn_timer_retry pri_fdplx sec_fdplx use_rej spec_port_type max_xid_size max_retry_count opt1 opt2 linesp rcv_pool_size poll_wait hmod_data contact_timer contact_timer_retry contact_timer2 contact_timer_retry2 disc_timer disc_timer_retry nve_poll_timer nve_poll_timer_retry nve_poll_timer2 nve_poll_timer_retry2 no_resp_timer no_resp_timer_retry rem_busy_timer rem_busy_timer_retry rr_timer poll_frame poll_on_iframe decimal decimal dec
Administration Commands query_port For Enterprise Extender (HPR/IP), the following parameters are included. The parameters lsap— determined_ip_address are described below; for more information about the remaining parameters, see Section 2.33, define_ip_port.
Administration Commands query_port YES SIM and RIM are supported. NO SIM and RIM are not supported. def_ls_good_xids Total number of successful XID exchanges that have occurred on all link stations defined on this port since the last time this port was started. def_ls_bad_xids Total number of unsuccessful XID exchanges that have occurred on all link stations defined on this port since the last time this port was started.
Administration Commands query_pu Name of the DLC associated with this port. lsap Enterprise Extender (HPR/IP): Link Service Access Point address of the port. version Enterprise Extender (HPR/IP): IP version for which this IP address is defined. This is set to IP_VERSION_4. determined_ip_address Enterprise Extender (HPR/IP): IP address of the local link station. This is a dotted-decimal IP address (such as 193.1.11.100). If the port is inactive, the address appears as 0.0.0.0.
Administration Commands query_pu list_options pu_name host_attachment constant character constant 8 LIST_INCLUSIVE (null string) NONE Supplied parameters are: num_entries Maximum number of PUs for which data should be returned. You can specify 1 to return data for a specific PU, a number greater than 1 to return data for multiple PUs, or 0 (zero) to return data for all PUs. list_options The position in the list of PUs from which SNAplus2 begins to return data.
Administration Commands query_pu max_rcv_pac_win cur_rcv_pac_win send_fmd_data_frames rcv_fmd_data_frames send_data_frames send_data_bytes rcv_data_frames rcv_data_bytes sidh sidl odai pacing_type sscp_id dddlu_supported tcpcv_supported dddlu_offline_supported decimal decimal decimal decimal decimal decimal decimal decimal hex number hex number constant constant hex constant constant constant 6 If the command executes successfully, the following parameters are returned: pu_name PU Name.
Administration Commands query_pu max_rcv_btu_size Maximum BTU size that can be received. This value includes the length of the TH and RH (total 9 bytes), as well as the RU. max_send_pac_win Maximum size of the send pacing window. cur_send_pac_win Current size of the send pacing window. max_rcv_pac_win Maximum size of the receive pacing window. cur_rcv_pac_win Current size of the receive pacing window. send_fmd_data_frames Number of normal flow FMD data frames sent.
Administration Commands query_pu For dependent LU sessions, this parameter is the SSCP ID received in the ACTPU from the host for the PU to which the local LU is mapped. For independent LU sessions, this parameter is set to 0 (zero). This value is an array of six bytes displayed as hexadecimal values. dddlu_supported Specifies whether the host system supports DDDLU (Dynamic Definition of Dependent LUs). Possible values are: YES The host supports DDDLU. NO The host does not support DDDLU.
Administration Commands query_rcf_access The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the supplied name, but the value specified in the pu_name parameter was not valid. State Check If the command does not execute because of a state error, SNAplus2 returns the following parameters: primary_rc STATE_CHECK secondary_rc INVALID_PU_TYPE The PU specified by the pu_name parameter is a remote PU and not a local PU.
Administration Commands query_rje_wkstn ALLOW_QUERY_LOCAL The query_* commands are allowed. ALLOW_DEFINE_LOCAL The define_*, set_*, delete_*, add_*, remove_*, and init_node commands are allowed. ALLOW_ACTION_LOCAL The start_*, stop_*, activate_*, deactivate_*, aping, initialize_session_limit, change_session_limit, and reset_session_limit commands are allowed. ALLOW_QUERY_REMOTE The query_* commands are allowed to provide access to a remote SNAplus2 node.
Administration Commands query_rje_wkstn num_entries list_options workstation_name system_name decimal constant character character 4 128 1 SUMMARY + LIST_INCLUSIVE (null string) (null string) num_entries Maximum number of workstations for which data should be returned. You can specify 1 to return data for a specific workstation, a number greater than 1 to return data for multiple workstations, or 0 to return data for all workstations.
Administration Commands query_rje_wkstn system_name The computer name on which the workstation is running. wkstn_pid The process ID of the workstation. 2.163.
Administration Commands query_rje_wkstn_def INVALID_WORKSTATION The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the specified name, but the workstation_name or system_name parameter was not set to a valid value. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_rje_wkstn_def LIST_INCLUSIVE Start at the entry specified by the workstation_name parameter LIST_FROM_NEXT Start at the entry immediately following the entry specified by the workstation_name parameter workstation_name The name of the workstation for which information is required, or the name to be used as an index into the list of workstations. This parameter is ignored if list_options is set to FIRST_IN_LIST. 2.164.
Administration Commands query_rtp_connection Possible values are: INVALID_WORKSTATION The list_options parameter was set to LIST_INCLUSIVE to list all entries starting from the specified name, but the workstation_name parameter did not match any defined RJE workstation name. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_rtp_connection Use a + character to combine this value with one of the following values: FIRST_IN_LIST Start at the first entry in the list. LIST_INCLUSIVE Start at the entry specified by the rtp_name parameter. LIST_FROM_NEXT Start at the entry immediately following the entry specified by the rtp_name parameter. rtp_name Name of the RTP connection. This value is ignored if the list_options parameter is set to FIRST_IN_LIST. 2.165.
Administration Commands query_rtp_connection 2.165.
Administration Commands query_rtp_connection dest_node_name Fully qualified name of the destination control point for the RTP portion of the session. cos_name Name of the class of service used by the RTP connection. num_sess_active Number of sessions active on this RTP connection. arb_mode Specifies the ARB mode in use on this RTP Connection. Possible values are: ARB_S Standard mode ARB. ARB_R Responsive mode ARB.
Administration Commands query_rtp_connection bytes_discarded Total number of bytes sent by the other end of the RTP connection that were discarded as duplicates of data already received. packets_sent Total number of packets that the local node has sent on this RTP connection. packets_received Total number of packets that the local node has received on this RTP connection. packets_resent Total number of packets that the local node has resent on this RTP connection because packets were lost in transit.
Administration Commands query_rtp_connection The amount of time to wait for a response to a request for a status exchange, measured in milliseconds. A short timer interval provides quick detection of failures but lowers performance. short_req_timeouts Total number of times the short_req_ timer has expired for this RTP connection. liveness_timeouts Total number of times the liveness timer has expired for this RTP connection.
Administration Commands query_rtp_tuning 1 YELLOW 2 RED route Route Selection Control Vector (RSCV) as defined by SNA Formats. This control vector defines the session route through the network and is carried on the BIND. This RSCV is included only if the node’s configuration (specified using define_node) indicates that endpoint RSCVs should be stored. 2.165.
Administration Commands query_security_access_list short_req_retry_limit path_switch_time_low path_switch_time_medium path_switch_time_high path_switch_time_network decimal decimal decimal decimal decimal If the command executes successfully, SNAplus2 returns the following parameters: path_switch_attempts Number of path switch attempts to set on new RTP connections.
Administration Commands query_security_access_list 2.167.1 Supplied Parameters Parameter name Type [query_security_access_list] num_entries decimal list_options constant list_name character user_name character Length Default 14 10 1 LIST_INCLUSIVE (null string) (null string) Supplied parameters are: num_entries Maximum number of security access lists for which data should be returned.
Administration Commands query_session description An optional string of 0–31 characters. num_users Number of user names in the list. For each user name in the list, a security_user_data subrecord is returned with the following information: user_name Name of the user. This is a user ID defined using the define_userid_password command. 2.167.
Administration Commands query_session num_entries list_options lu_name lu_alias plu_alias fqplu_name mode_name session_id decimal constant character character character character character hex array 8 8 8 17 8 8 1 SUMMARY + LIST_INCLUSIVE (null string) (null string) (null string) (null string) (null string) Supplied parameters are: num_entries Maximum number of sessions for which data should be returned.
Administration Commands query_session Fully qualified network name of the partner LU. Specify 3–17 type-A characters that consist of a 1–8 character network name, followed by a period, followed by a 1–8 character partner LU name. For the network name and partner LU name, use only letters, digits 0–9, and special characters $, #, and @. This parameter is used only if the plu_alias parameter is not specified; it is ignored if plu_alias is specified. mode_name Mode name.
Administration Commands query_session cos_name trans_pri ltd_res polarity contention rcv_ru_size send_ru_size max_send_btu_size max_rcv_btu_size max_send_pac_win cur_send_pac_win max_rcv_pac_win cur_rcv_pac_win send_data_frames send_fmd_data_frames send_data_bytes rcv_data_frames rcv_fmd_data_frames rcv_data_bytes sidh sidl odai ls_name (or rtp_name) pacing_type duplex_support sscp_id session_start_time session_timeout character constant constant constant constant decimal decimal decimal decimal decimal d
Administration Commands query_session MEDIUM Medium priority is given to the transmission. HIGH High priority is given to the transmission. NETWORK Highest priority is given to the transmission. ltd_res Specifies whether the session uses a limited resource link. Possible values are: YES Session uses a limited resource link. NO Session does not use a limited resource link. polarity Specifies the polarity of the session.
Administration Commands query_session cur_rcv_pac_win Current size of the receive pacing window on this session. send_data_frames Number of normal flow data frames sent. send_fmd_data_frames Number of normal flow FMD data frames sent. send_data_bytes Number of normal flow data bytes sent. rcv_data_frames Number of normal flow data frames received. rcv_fmd_data_frames Number of normal flow FMD data frames received. rcv_data_bytes Number of normal flow data bytes received.
Administration Commands query_session Returns the conversation duplex support as negotiated on the BIND. Possible values are: HALF-DUPLEX Only half-duplex conversations are supported. FULL_DUPLEX Both full-duplex and half-duplex sessions are supported. Expedited data is also supported. sscp_id For dependent LU sessions, this parameter is the SSCP ID received in the ACTPU from the host for the PU to which the local LU is mapped. For independent LU sessions, this parameter is set to 0 (zero).
Administration Commands query_sna_net 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.169 query_sna_net The query_sna_net command returns information about servers that can act as backup master servers, as defined in the sna.net file. This command can be used to obtain information about a specific server or about multiple servers, depending on the options used.
Administration Commands query_statistics If the computer name includes a . (period) character, SNAplus2 assumes that it is a fully-qualified name; otherwise it performs a DNS lookup to determine the computer name. 2.169.2 Returned Parameters Parameter name security domain_name server_name Type constant character character Length 64 128 If the command executes successfully, SNAplus2 returns the following parameters: security This parameter is reserved.
Administration Commands query_statistics The type of information returned depends on the DLC type: For SDLC, the command returns either statistics (counts of events such as particular frame types sent or received) or operational information (details of parameters currently being used), for either an LS or a port. For Token Ring, FDDI or Ethernet, the command returns statistics information for an LS. For Enterprise Extender, the verb returns statistics information for an LS.
Administration Commands query_statistics Reset the statistics; a subsequent query_statistics command will contain only data gathered after this command was issued. NO Do not reset the statistics; the data on this command will be included in the data returned to a subsequent query_statistics command. dlc_type Type of the DLC. Possible values are: SDLC Synchronous data link control TR Token Ring ETHERNET Ethernet FDDI Fiber distributed data interface X25 X.
Administration Commands query_statistics sims_out rims_in rims_out snrm_in snrm_out dm_in dm_out disc_in disc_out ua_in ua_out decimal decimal decimal decimal decimal decimal decimal decimal decimal decimal decimal If the command executes successfully, the following parameters are returned: index The index value used internally by SNAplus2 to identify the port that owns this LS. address The poll address of the secondary link station.
Administration Commands query_statistics The total number of bytes in I-frames received from the adjacent link station. ioctets_out The total number of bytes in I-frames transmitted to the adjacent link station. uiframes_in The total number of UI frames received from the adjacent link station. uiframes_out The total number of UI frames transmitted to the adjacent link station. xids_in The total number of XID frames received from the adjacent link station.
Administration Commands query_statistics The total number of DM frames transmitted to the adjacent link station. disc_in The total number of DISC frames received from the adjacent link station. disc_out The total number of DISC frames transmitted to the adjacent link station. ua_in The total number of UA frames received from the adjacent link station. ua_out The total number of UA frames transmitted to the adjacent link station. 2.170.
Administration Commands query_statistics state The internal value indicating the processing state of the LS software (for use by support personnel). maxdata The current maximum protocol data unit (PDU) size, including the transmission header (TH) and request header (RH), allowed for the logical link. For a switched line, this value can be negotiated during XID exchange. replyto The current reply timeout, in hundredths of a second.
Administration Commands query_statistics last_fail_frmr_info If the last LS failure was caused by an FRMR frame that was not valid, this parameter contains the information from the FRMR frame. If the LS has not failed or if the failure was not caused by a frame that was not valid, this parameter is set to zeros. last_fail_replyto_s The number of times that the reply timeout expired before the last failure. If the LS has not failed, this parameter is set to 0. g_poll The group poll address for the LS.
Administration Commands query_statistics polls_out The total number of polls sent to adjacent link stations. poll_rsps_out The total number of polls responded to by adjacent link stations. local_busies The total number of times the local link station has entered the receive not ready busy state (RNR). remote_busies The total number of times remote link stations have entered the receive not ready busy state (RNR).
Administration Commands query_statistics slow_poll_method slow_poll_timer constant decimal If the command executes successfully, the following parameters are returned: index The index value used internally by SNAplus2 to identify the port. role The link role of the port. Possible values are: PRIMARY Port is the primary link. SECONDARY Port is the secondary link. NEGOTIABLE Port role is negotiable. type Specifies whether the port is operating as though connected to a leased or switched line.
Administration Commands query_statistics 2.170.6 Returned Parameters: Token Ring / Ethernet / FDDI LS Statistics Parameter name ls_st_mus_sent ls_st_mus_received ls_st_bytes_sent ls_st_bytes_received Type decimal decimal decimal decimal If the command executes successfully, the following parameters are returned: ls_st_mus_sent The number of frames sent from SNAplus2 on this LS since the LS was started. ls_st_mus_received The number of frames received by SNAplus2 on this LS since the LS was started.
Administration Commands query_statistics mac_addr The MAC address of the port, determined during port activation. max_btu_size The maximum BTU size, determined during port activation. This value includes the length of the TH and RH (total 9 bytes), as well as the RU. ls_count The number of link stations currently using the port. This number includes stations for which XIDs have been sent but SABME has not yet been sent. ui_frames_sent The total number of unnumbered TEST and XID frames issued on this port.
Administration Commands query_statistics 2.170.8 Returned Parameters: Enterprise Extender Parameter name udp_low_out udp_med_out udp_high_out udp_network_out udp_llc_out Type decimal decimal decimal decimal decimal Length If the command executes successfully, the following parameters are returned: udp_low_out The number of UDP datagrams sent that contained low priority APPN data. udp_med_out The number of UDP datagrams sent that contained medium priority APPN data.
Administration Commands query_tn3270_access_def secondary_rc Possible values are: LINK_DEACTIVATED The specified link is not currently active. PORT_DEACTIVATED The specified port is not currently active. Function Not Supported If the command does not execute because the node’s configuration does not support it, SNAplus2 returns the following parameter: primary_rc FUNCTION_NOT_SUPPORTED The DLC type does not support returning statistics information. secondary_rc (This parameter is not used.
Administration Commands query_tn3270_access_def The level of information required for each client and the position in the list of clients from which SNAplus2 begins to return data.
Administration Commands query_tn3270_access_def client_address address_format character constant 67 If the command executes successfully and you specified SUMMARY as the list_options parameter value, SNAplus2 returns the following parameters: default_record Specifies whether this entry is the default record. Possible values are: YES This entry is the default record. The client_address parameter is not used. NO This entry is a TN3270 record for the specified client address.
Administration Commands query_tn3270_access_def default_record Specifies whether this entry is the default record. Possible values are: YES This entry is the default record. The client_address parameter is not used. NO This entry is a TN3270 record for a specified client. client_address The TCP/IP address of the TN3270 client. description An optional string describing the client. address_format Specifies the format of the client_address parameter.
Administration Commands query_tn3270_association Access to specific LUs is allowed. Clients are allowed to request access to a specific LU or LU pool; clients do not have to use the LU or LU pool chosen by TN server. NO Access to specific LUs is not allowed. 2.171.4 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands query_tn3270_association num_entries Maximum number of associations for which data should be returned. You can specify 1 to return data for a specific association, a number greater than 1 to return data for multiple associations, or 0 to return data for all associations. list_options The position in the list of associations from which SNAplus2 begins to return data.
Administration Commands query_tn3270_defaults The list_options parameter was set to LIST_INCLUSIVE, but the display LU specified in the display_lu_name parameter did not match any existing association. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands query_tn_server_trace Send Telnet NOP messages. TM Send Telnet DO TIMING-MARK messages. keepalive_interval Interval (in seconds) between consecutive keep-alive messages. The interval should be long enough to minimize network traffic, especially if there are typically many idle client connections. The shorter the keepalive interval, the quicker failures are detected, but the more network traffic is generated.
Administration Commands query_tp trace_flags The types of tracing currently active. If no tracing is active, or if tracing is active for all types of messages, one of the following values is returned: NONE No tracing is active. ALL Tracing of all types of messages is active. If tracing is used on specific message types, SNAplus2 returns one or more of the following values are returned (combined using a + character): TCP Messages between TN server and TN3270 clients are traced.
Administration Commands query_tp num_entries list_options lu_name lu_alias tp_name decimal constant character character character 8 8 64 1 LIST_INCLUSIVE (null string) (null string) (null string) Supplied parameters are: num_entries Maximum number of TPs for which data should be returned. You can specify 1 to return data for a specific TP, a number greater than 1 to return data for multiple TPs, or 0 to return data for all TPs.
Administration Commands query_tp_definition A text string describing the TP, as specified in the definition of the TP. instance_limit Maximum number of simultaneously active instances of the specified TP. instance_count Number of instances of the specified TP that are currently active. locally_started_count Number of instances of the specified TP which have been started locally (by the TP issuing a TP_STARTED verb).
Administration Commands query_tp_definition on the options used. This command returns information about the definition of the TPs, not about their current usage; use query_tp to obtain usage information. 2.176.1 Supplied Parameters Parameter name [query_tp_definition] num_entries list_options tp_name Type decimal constant character Length Default 64 1 SUMMARY + LIST_INCLUSIVE (null string) Supplied parameters are: num_entries Maximum number of TPs for which data should be returned.
Administration Commands query_tp_definition TP name. description A text string describing the TP, as specified in the definition of the TP. 2.176.
Administration Commands query_tp_load_info 2.177 query_tp_load_info The query_tp_load_info command returns information about TP load information entires.. 2.177.1 Supplied Parameters Parameter name [query_tp_load_info] num_entries list_options tp_name lualias Type Length decimal constant character character 1 64 8 Default LIST_INCLUSIVE (null string) (null string) Supplied parameters are: num_entries Maximum number of extra data control blocks for which data should be returned.
Administration Commands query_tp_load_info path arguments type timeout userid group stdin stdout stderr env character character constant decimal character character character character character character 255 255 64 64 255 255 255 255 If the command executes successfully, SNAplus2 returns the following parameters: tp_name The TP name of the TP load info entry. lualias The LU alias of the TP load info entry.
Administration Commands query_trace_file stderr Full path name of standard error file or device. env Environment variables required by the TP in the form VARIABLE = VALUE. 2.177.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands query_trace_file CS File contains tracing on data transferred across the SNAplus2 domain between the specified computer and other nodes. This trace type is activated by the set_cs_trace command. BCK_CS File contains tracing on data transferred across the SNAplus2 domain between a current-level server and back-level computers. This trace type is activated by the set_bck_cs_trace command. TN_SERVER File contains tracing on the SNAplus2 TN server component.
Administration Commands query_trace_type If no path is included, the file is stored in the default directory for diagnostics files, /var/opt/sna. If a path is included, this path is either a detailed path (starting with a [/] character) or a path relative to the default directory. 2.178.
Administration Commands query_trace_type No tracing is active. ALL Tracing of all types is active. If tracing is activated for a specific message, one or more of the following values is returned (combined using a + character): APPC APPC messages are traced. FM FM messages are traced. LUA LUA messages are traced. NOF NOF messages are traced. MS MS messages are traced. PV APPC and CPI-C messages for back-level computers are traced. DLPI DLPI messages are traced. SDLC SDLC messages are traced.
Administration Commands query_userid_password Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands remove_dlc_trace 2.180.2 Returned Parameters Parameter name user_id description profile Type character character character Length 10 31 10 (Up to ten profiles can be returned on the profile parameter.) If the command executes successfully, SNAplus2 returns the following parameters: user_id User identifier. description A text string describing the user ID and password, as specified in the definition of the user ID and password.
Administration Commands remove_dlc_trace 2.181.1 Supplied Parameters Parameter name [remove_dlc_trace] resource_type resource_name sidh sidl odai message_type Type constant character hex byte hex byte constant constant Length 8 Default ALL_DLC_TRACES (null string) 0 0 NO TRACE_ALL Supplied parameters are: resource_type The resource type of the trace entry to remove or modify. Possible values are: ALL_DLC_TRACES Remove all DLC tracing options, so that no resources are traced.
Administration Commands remove_dlc_trace The session ID high byte used in identifying the LFSID for a session on an LS. sidl The session ID low byte used in identifying the LFSID for a session on an LS. odai The Origin Destination Assignor Indicator used in identifying the LFSID for a session on an LS. Possible values are: YES The BIND sender is the node containing the secondary link station. NO The BIND sender is the node containing the primary link station.
Administration Commands reset_session_limit Parameter Check If the command does not execute because of a parameter error, SNAplus2 returns the following parameters: primary_rc PARAMETER_CHECK secondary_rc Possible values are: INVALID_RESOURCE_TYPE The value specified in the resource_type parameter was not valid. INVALID_MESSAGE_TYPE The value specified in the message_type parameter was not valid. INVALID_DLC_NAME The DLC named in resource_name does not have any tracing options set.
Administration Commands reset_session_limit 2.182.
Administration Commands reset_session_limit YES Reset the maximum negotiable session limit for this LU-LU-mode combination to 0 (so that sessions cannot be activated until the limit is changed by initialize_session_limit). NO Leave the maximum negotiable session limit unchanged. responsible Indicates whether the source (local) or target (partner) LU is responsible for deactivating sessions after the session limit is reset. Possible values are: SOURCE The local LU is responsible for deactivating sessions.
Administration Commands reset_session_limit Possible values are: AS_SPECIFIED The command executed successfully. The session limits were changed as specified. FORCED The session limits were set to 0 even though CNOS negotiation failed. AS_NEGOTIATED The session limits were changed, but one or more values were negotiated by the partner LU. 2.182.
Administration Commands reset_session_limit State Check If the command does not execute because of a state error, SNAplus2 returns the following parameters: primary_rc STATE_CHECK secondary_rc MODE_RESET No sessions are currently active for this LU-LU-mode combination. Use initialize_session_limit instead of reset_session_limit to specify the limits.
Administration Commands set_bck_cs_trace 2.183 set_bck_cs_trace The set_bck_cs_trace command specifies options for back-level client-server tracing—the tracing of data sent between a current-level SNAplus2 server and a back-level server or client.
Administration Commands set_bck_cs_trace Specifies whether to initialize tracing (define the tracing state at all interfaces) or to change the state of tracing at one or more interfaces (leaving the others unchanged). Possible values are: YES Initialize tracing. The trace_flags parameter defines the required state of tracing at all interfaces. NO Change the state of tracing.
Administration Commands set_central_logging 2.184 set_buffer_availability The set_buffer_availability command specifies the amount of STREAMS buffer space that SNAplus2 can use at any one time. This information enables the node to make efficient use of the buffer space available, and enables you to ensure that buffer space is available for other processes on the HP-UX computer. 2.184.
Administration Commands set_cs_trace enabled constant YES Supplied parameter is: enabled Specifies whether to enable or disable central logging. Possible values are: YES Enable central logging. All log messages are sent to a single central file on the node that is currently the central logger. NO Disable central logging. Log messages from each server are sent to a file on that server (specified using set_log_file). 2.185.
Administration Commands set_cs_trace computer name with the -n option as you would normally specify a node name. (You cannot issue the command on the client computer itself.) Alternatively, you can start the client with tracing enabled using the command snap start -t. On Windows clients, client-server tracing is controlled by options in the Windows Registry(Win32 clients) or in the sna.ini file (Win16 clients). For more information, refer to HP-UX SNAplus2 Diagnostics Guide. 2.186.
Administration Commands set_cs_trace trace_direction Specifies the direction or directions in which tracing is required. This parameter is ignored if trace_flags is set to NONE. Possible values are: CS_SEND Trace messages flowing from the target computer to the computer defined by dest_sys. CS_RECEIVE Trace messages flowing from the computer defined by dest_sys to the target computer. CS_BOTH Trace messages flowing in both directions. 2.186.
Administration Commands set_global_log_type 2.187 set_global_log_type The set_global_log_type command specifies the types of information that SNAplus2 records in log files. It specifies default values that are used on all computers; you can then use set_log_type (or, for a Windows client, options in the Windows Registry or in the client initialization file)to override these defaults on a particular computer. For more information about log files, see Section 2.189, set_log_file.
Administration Commands set_global_log_type text string and parameters. To obtain more details about the cause of the log and any action required, use the snaphelp utility. NO Use detailed logging in the audit log file. Each message in the log file includes a full listing of the message header information, the message text string and parameters, and additional information about the cause of the log and any action required.
Administration Commands set_kernel_memory_limit Possible values are: NOT_CENTRAL_LOGGER The command was issued to a specific node. It must be issued without specifying a node name. INVALID_SUCCINCT_SETTING The succinct_audits or succinct_errors parameter was not set to a valid value. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands set_log_file State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.189 set_log_file The set_log_file command manages a file that SNAplus2 uses to record log messages.
Administration Commands set_log_file The action to be taken on the log file. Specify one of the following values: NO_FILE_ACTION Use the file specified in the file_name parameter as the log file, and the file specified in the backup_file_name parameter as the backup file. After this command completes successfully, all log messages of the type defined by log_file_type are written to the new log file. If a log file was used before this command is issued, the log file is left unchanged.
Administration Commands set_log_type • Activating audit logging as well as exception logging • Using central logging instead of distributed logging • Using detailed logging instead of succinct logging 2.189.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.189.
Administration Commands set_log_type audit exception succinct_audits succinct_errors constant constant constant constant LEAVE_UNCHANGED LEAVE_UNCHANGED LEAVE_UNCHANGED LEAVE_UNCHANGED Supplied parameters are: override Specifies whether to override the global log types specified on set_global_log_type or to revert to using global log types. Possible values are: YES Override the global log types.
Administration Commands set_log_type NO Use detailed logging in the audit log file. Each message in the log file includes a full listing of the message header information, the message text string and parameters, and additional information about the cause of the log and any action required. LEAVE_UNCHANGED Leave succinct logging or detailed logging unchanged from the existing definition.
Administration Commands set_tn_server_trace 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.191 set_tn_server_trace The set_tn_server_trace command specifies tracing options for the SNAplus2 TN server feature. This command must be issued to a running node. 2.191.
Administration Commands set_trace_file Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands set_trace_file TN_SERVER File contains tracing on the SNAplus2 TN server component. IPS File contains tracing on kernel components for the specified node. This type of tracing is activated by the set_trace_type or add_dlc_trace command. dual_files Specifies whether tracing uses one file or to two files. Possible values are: YES Tracing uses two files.
Administration Commands set_trace_type 2.192.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands set_trace_type The types of tracing required. For more information about these trace types, refer to HP-UX SNAplus2 Diagnostics Guide. If init_flags is set to YES, select the values corresponding to the interfaces where you want tracing to be active, and do not select the values corresponding to the interfaces where you want it to be inactive. If init_flags is set to NO, select the values corresponding to the interfaces where you want to change the state of tracing.
Administration Commands set_trace_type DGRM Trace internal control messages between SNAplus2 components truncation_length The maximum length, in bytes, of the information written to the trace file for each message. If a message is longer than this value, SNAplus2 writes only the start of the message to the trace file and discards the data beyond truncation_length. Truncation enables you to record the most important information for each message but avoid filling up the file with long messages.
Administration Commands start_dlc State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.194 start_dlc The start_dlc command activates a DLC. When this command is issued, the associated node is activated automatically if it is not already active.
Administration Commands start_internal_pu primary_rc STATE_CHECK secondary_rc DLC_DEACTIVATING The specified DLC has already been started, and is being deactivated. 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.195 start_internal_pu The start_internal_pu command requests DLUR to initiate SSCP-PU session activation for a previously defined local PU that is served by DLUR.
Administration Commands start_internal_pu 2.195.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands start_ls primary_rc UNSUCCESSFUL secondary_rc Possible values are: DLUS_REJECTED The DLUS rejected the session activation request. DLUS_CAPS_MISMATCH The configured DLUS name was not a DLUS node. PU_FAILED_ACTPU The local node rejected a message from the DLUS. This can be caused by an internal error, a resource shortage, or a problem with the received message; check the SNAplus2 log files for messages providing more information.
Administration Commands start_ls To leave the LS inactive but specify that it can be activated (either by SNAplus2 or by the remote system) when required, specify one or both of the following values (combined using a logical OR): AUTO_ACT The LS can be automatically activated by SNAplus2 when required for a session. This value should be used only when the LS is defined to automatically activated (auto_act_supp in the LS definition is set to YES).
Administration Commands start_port ALREADY_STARTING The specified LS is already starting. Unsuccessful If the command does not execute successfully because the SNA subsystem on the remote computer cannot be contacted, SNAplus2 returns the following parameters: primary_rc LS_FAILURE secondary_rc Possible values are: PARTNER_NOT_FOUND No response was received from the port associated with this LS. For Token Ring, Ethernet, FDDI: check that the mac_address parameter in the LS definition is correct.
Administration Commands start_port Supplied parameters are: port_name Name of the port to be started. The port must already have been defined. 2.197.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.197.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands status_all 2.198 status_all The status_all command returns status information about all resources. This command returns all status information that is returned by other status_* commands. For more details about status information returned by each status_* command, see Section 2.199, status_connectivity, Section 2.200, status_dependent_lu, Section 2.201, status_dlur, Section 2.202, status_lu62, and Section 2.203, status_node. 2.198.
Administration Commands status_all 12 LU5 DISPLAY Active Model 5 displ 3270 display user: liz Computer: george 13 DEPLU2 LU62 Active Used by APP2 Partner LU: APPN.PARTNER Mode: MODE1 PU6 DOWN Inactive Downstream to 99 DSLU99 PRINTER Inactive DS for the ot -------------------------------------------------------------------------------DLUR PU LU DLUS PLU Description -------------------------------------------------------------------------------DSPU1 (Downstream) APPN.DLUS DLU1 Inactive Inactive DLU2 APPN.
Administration Commands status_connectivity 2.198.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Administration Commands status_dependent_lu TRP1 TR Inactive My first por TR Inactive Link to host TRP2 TR Active My second po TRL1 AS400 TR Active Link to AS/4 TRL2 PUNAME TR Stopping Link to othe ETH0 Eth Active Another DLC ETHER0 Eth Active My Ethernet ETH0 PU5 Eth On demand Link for app DOWN PU6 Eth Inactive Downstream t SDLC0 SDLC Active SDLC dev 1 SDLCP0 SDLC Inactive My first por HOST PU0 SDLC Inactive Link to host -------------------------------------------------------------------------------TRL0
Administration Commands status_dependent_lu Return status for all dependent LUs. DISPLAY Return status for all dependent display LUs. PRINTER Return status for all dependent printer LUs. RJE Return status for all dependent LUs used for Remote Job Entry (RJE). LU6 Return status for all dependent LUs of type 6.2. OTHER Return status for all dependent LUs that are not used for display, printer, RJE, or dependent LU type 6.2. 2.200.
Administration Commands status_dependent_lu Application Type Information Displayed FMI application — RJE TN3270 application RJE workstation: wkstn_name Computer: system_name If the configured address format is dotted decimal: TN3270 address: 1.2.3.4 otherwise: TN3270 address: 1.2.3.4 (cfg_address) Dependent LU 6.2 Partner LU: fqplu_name Mode: mode_name The following example illustrates the information returned for the status_dependent_lu command.
Administration Commands status_dependent_lu 12 LU5 DISPLAY Active Model 5 displ 3270 display user: liz Computer: george 13 DEPLU2 LU62 Active Used by APP2 Partner LU: APPN.PARTNER Mode: MODE1 -------------------------------------------------------------------------------- Status about a particular LU type is obtained by specifying the LU type in the command. You can specify any of the following values: DISPLAY 3270 display LU PRINTER 3270 printer LU RJE RJE workstation LU62 Dependent LU type 6.
Administration Commands status_dlur 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.201 status_dlur The status_dlur command returns information about the status of the node’s PUs that use dependent LU requester (DLUR) and their LUs. On a running node, this command also returns information about downstream PUs that use DLUR. Downstream PUs are displayed as Downstream.
Administration Commands status_lu62 Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands status_node 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.203 status_node The status_node command returns a list of the nodes in the domain and gives their status, configuration role, and description.. 2.203.1 Supplied Parameters [status_node] No parameters are supplied for this command. 2.203.
Administration Commands status_remote_node Parameter Check No parameter errors occur for this command. State Check No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command. 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.
Administration Commands stop_dlc APPN.WILD Yes Inactive APPN.SOS1 APPN.ZAMBIA ----------------------------------------------------------------------------------- 2.204.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution. Parameter Check No parameter errors occur for this command.
Administration Commands stop_internal_pu 2.205.2 Returned Parameters No parameters are returned by SNAplus2 when this command executes successfully. 2.205.3 Error Return Codes If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Administration Commands stop_internal_pu This command must be issued to a running node. 2.206.1 Supplied Parameters Parameter name [stop_internal_pu] pu_name stop_type Type Length character constant 8 Default ORDERLY_STOP Supplied parameters are: pu_name Name of the internal PU for which the SSCP-PU session will be deactivated. This name is a type-A character string starting with a letter. stop_type Specifies how to stop the PU.
Administration Commands stop_ls PU_NOT_ACTIVE The PU is not active. Function Not Supported If the command does not execute because the node’s configuration does not support it, SNAplus2 returns the following parameters: primary_rc FUNCTION_NOT_SUPPORTED The node does not support DLUR; this support is defined by the dlur_support parameter on the define_node command. secondary_rc (This parameter is not used.
Administration Commands stop_ls To stop an active LS and return to the default settings for auto-activation and remote activation, set this parameter to NO. To specify that an inactive LS cannot be activated by SNAplus2, or cannot be activated by the remote system, specify one or both of the following values (combined with a + character): AUTO_ACT The LS cannot be automatically activated by SNAplus2. REMOTE_ACT The LS cannot be activated by the remote system.
Administration Commands stop_port NO_SECONDARY_RC The stop_type parameter specified an orderly stop, but the LS was then stopped by a second command specifying an immediate stop, or by a failure condition. Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary return codes that are common to all commands. 2.208 stop_port The stop_port command stops a port. This command also stops any active link stations that are using the port.
Administration Commands term_node INVALID_PORT_NAME The port_name parameter did not match the name of a defined port. UNRECOGNIZED_DEACT_TYPE The stop_type parameter was not set to a valid value. State Check If the command does not execute because of a state error, SNAplus2 returns the following parameters: primary_rc STATE_CHECK secondary_rc STOP_PORT_PENDING The specified port is already being deactivated.
Administration Commands term_node ABORT Stop immediately without attempting any cleanup processing. This value should be used only in serious error conditions because it may cause problems for other programs that are using the node’s resources. SHUTDOWN Deactivate all link stations associated with the node before stopping. QUIESCE Indicate to the APPN network that the node is quiesced, reset session limits on all modes, unbind all sessions for the node’s LUs, and then stop as for SHUTDOWN.
Appendix ACommon Return Codes from snapadmin Commands AppendixA Common Return Codes from snapadmin Commands This section describes the primary and secondary return code values that are common to all snapadmin commands. Return codes that are specific to a particular command are described in the individual command descriptions. A.
Appendix ACommon Return Codes from snapadmin Commands primary_rc INVALID_VERB secondary_rc (This parameter is not used.) primary_rc FUNCTION_NOT_SUPPORTED secondary_rc (This parameter is not used.) A.3 Parameter Check There are no common parameter check return codes. Parameter check return codes that are specific to a particular command are described in the individual command descriptions. A.
Appendix ACommon Return Codes from snapadmin Commands A.5 System Error If the command does not execute because of a system error, SNAplus2 returns the following parameters: primary_rc UNEXPECTED_SYSTEM_ERROR An operating system call failed while the command was being processed. secondary_rc In this case, the secondary return code is the return code from the operating system call. For the meaning of this return code, check the returned value in the errno.h file on the computer where the error occurred.
Appendix BConfiguration Files AppendixB Configuration Files This appendix describes: • Initial definition of SNAplus2 node and domain resources • Format of configuration files • Changes made to the node and domain resources by the Motif program • File input to the snapadmin program B.1 Initial Configuration Files Configuration records for a node’s resources are included in the node configuration file. When you start the SNAplus2 software, the configuration file /etc/opt/sna/sna_node.
Appendix BConfiguration Files A configuration file consists of a [define_node_config_file] or [define_domain_config_file] header record followed by a series of [define_*] and [set_*] administration records. Each administration record contains the parameters for a SNAplus2 administration command. Header records and administration records are used as follows: • The header record contains information such as the SNAplus2 version number.
Appendix BConfiguration Files is not included, SNAplus2 uses the default value of MEDIUM. The optional parameters description and pool_name are also not included. [define_lu_0_to_3] lu_name = LU$01 nau_address = 1 pu_name = PU2 lu_model = 3270_DISPLAY_MODEL_2 B.2.3 Subrecord Format Some configuration records include data whose format can vary between instances of that record type. For example, the [define_cos] record includes a variable number of node rows and TG rows.
Appendix BConfiguration Files pads Node1 with 123 blank characters so that the value in the node configuration record has the maximum length allowed for this parameter. • If you enter hexadecimal digits A, B, C, D, E, and F on a Motif screen, SNAplus2 changes them to a, b, c, d, e, and f in the configuration file. • If you do not enter a value on a Motif screen for a parameter that defaults to a null string, SNAplus2 adds a null string for that parameter’s value in the configuration file.
Appendix BConfiguration Files and then delete the node configuration file and delete all records from the domain configuration file except for the header record. 4. Start the SNAplus2 software. 5. Use the following command to define the configuration: snapadmin -i new.cfg The value new.cfg stands for the name of the input file you are using (with the modifications that you made in step 1). 6.
Appendix CEnvironment Variables AppendixC Environment Variables This appendix provides an alphabetical listing of all the environment variables that are used by SNAplus2 programs. It includes a brief summary of how SNAplus2 uses each variable, and provides a cross-reference to additional information provided elsewhere in the SNAplus2 documentation set. Most of these environment variables are specific to SNAplus2 programs.
Appendix CEnvironment Variables For more details, refer to the information about preparing to transfer files in HP-UX SNAplus2 3270 User’s Guide. C.2.3 LANG The 3270 and 3179G emulation programs use LANG to specify the host language (the language variant of EBCDIC used by the host computer). You must set LANG before starting the program. For more details, refer to the information about starting the 3270 emulation program in HP-UX SNAplus2 3270 User’s Guide. C.2.
Appendix CEnvironment Variables C.2.8 SNALU1MPP The 3270 emulation program uses SNALU1MPP to specify the maximum print position (line length) for 3270 printer sessions for LU 1 printing and LU 3 unformatted printing. If SNALU1MPP is not set, the program uses the default value 132. For more details, refer to the information about controlling printer sessions in HP-UX SNAplus2 3270 User’s Guide. C.2.
Appendix CEnvironment Variables C.4 Environment Variables That Affect APPC and CPI-C Communications C.4.1 APPCLLU The SNAplus2 CPI-C library uses APPCLLU to specify the name of the local APPC LU used by a CPI-C application. The local LU alias to be used for a CPI-C application can be configured using the define_cpic_side_info command. The environment variable APPCLLU overrides that alias.
Appendix CEnvironment Variables C.6 Environment Variables That Affect the Command-Line Administration Program C.6.1 COLUMNS SNAplus2 uses COLUMNS to control the display of information returned on the status_* administration commands. The amount of information that can be returned depends on the width of your display; SNAplus2 attempts to determine this using the COLUMNS environment variable, and uses a default value of 80 if COLUMNS is not set.
Appendix CEnvironment Variables For more details, refer to the information about controlling tracing on user-space components in HP-UX SNAplus2 Diagnostics Guide. C.7.5 SNATRUNC The SNAplus2 API libraries use SNATRUNC to specify the maximum length of data stored for each trace message that is written to API trace files. Set SNATRUNC to a decimal number specifying the maximum number of bytes to be traced from each message. Excess bytes are ignored and are not written to the trace file.
Index 3270 diagnostics parameters defining . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5250 user defining . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A access list, conversation security . . . activate_session command . . . . . active transaction, Management Services add_backup command . . . . . . . add_dlc_trace command . . . . . . adjacent node defining directory entries . . . . . deleting directory entries . . . . .
viewing definition . . . . . . . . . . . CN defining . . . . . . . . . . . . . . . deleting . . . . . . . . . . . . . . . viewing definition and current status . . . viewing information about ports . . . . . COLUMNS environment variable . . . . . . command-line administration program, file input communications path to a remote LU, checking configuration file format . . . . . . . . . . . . . . . header information defining . . . . . . . . . . . . . viewing . . . . . . . . . . . . . initial . . . . . . . . .
define_downstream_lu_ range command define_dspu_template command . . . define_emulator_user command . . . define_ethernet_dlc command . . . . define_ethernet_ls command . . . . . define_ethernet_port command . . . . define_fddi_dlc command . . . . . . define_fddi_ls command . . . . . . define_fddi_port command . . . . . define_focal_point command . . . . define_ip_dlc command . . . . . . define_ip_ls command . . . . . . . define_ip_port command . . . . . . define_local_lu command . . . . . .
delete_ls_routing . . . . . . . . . . . delete_lu62_timeout command . . . . . . delete_lu_0_to_3 command . . . . . . . delete_lu_0_to_3_range command . . . . delete_lu_lu_password command . . . . . delete_lu_pool command . . . . . . . . delete_mode command . . . . . . . . . delete_partner_lu command . . . . . . . delete_port command . . . . . . . . . delete_rcf_access command . . . . . . . delete_rje_wkstn command . . . . . . . delete_security_access_list command . . . delete_tn3270_access command . . . . .
defining . . . . . . . . . . . deleting . . . . . . . . . . . viewing definition . . . . . . . environment variables . . . . . . error log file defining . . . . . . . . . . . viewing definition . . . . . . . examples of administration commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 . 261 . 383 .
defining . . . . . . . . . . . . . . . . . viewing definition . . . . . . . . . . . . . log messages central logging viewing definition . . . . . . . . . . . central logging, defining . . . . . . . . . . central logging, viewing definition of target server defining types recorded . . . . . . . . . . file where stored defining . . . . . . . . . . . . . . . viewing definition . . . . . . . . . . . global settings defining types recorded . . . . . . . . . viewing definition of types recorded . . . .
M MAC address, Token Ring / Ethernet / FDDI . . Management Services active transaction, viewing current status . . . default PU defining . . . . . . . . . . . . . . viewing definition . . . . . . . . . . focal point defining . . . . . . . . . . . . . . deleting . . . . . . . . . . . . . . viewing definition and current status . . . MDS statistics, viewing current status . . . . MDS-level application, viewing current status . NMVT-level application, viewing current status manual set . . . . . . . . . . . . .
password LU-LU, defining . . . . . . . . . . . . . . . . session-level security defining . . . . . . . . . . . . . . . . . . deleting . . . . . . . . . . . . . . . . . . viewing definition . . . . . . . . . . . . . . password, conversation security defining . . . . . . . . . . . . . . . . . . . . deleting . . . . . . . . . . . . . . . . . . . . viewing definition . . . . . . . . . . . . . . . . password, LU-LU deleting . . . . . . . . . . . . . . . . . . . . viewing definition . . . . . . . . . . . . . . .
query_central_logging command . . . query_cn command . . . . . . . . query_cn_port command . . . . . . query_conversation command . . . . query_cos command . . . . . . . . query_cos_node_row command . . . query_cos_tg_row command . . . . . query_cpic_side_info command . . . query_cs_trace command . . . . . . query_default_pu command . . . . . query_defaults command . . . . . . query_directory_entry command . . . query_directory_lu command . . . . query_directory_stats command . . . query_dlc command . . . .
query_rtp_connection . . . . . . query_security_access_list command query_session command . . . . . query_sna_net command . . . . . query_statistics command . . . . . query_tn3270_access_def command . query_tn3270_association command . query_tn3270_defaults command . . query_tn_server_trace command . . query_tp command . . . . . . . query_tp_definition command . . . query_tp_load_info command . . . query_tp_tuning command . . . . query_trace_file command . . . . query_trace_type command . . . .
viewing definition . . . . . . . . . . . . set_bck_cs_trace command . . . . . . . . . set_buffer_availability command . . . . . . . set_central_logging command . . . . . . . . set_cs_trace command . . . . . . . . . . . set_global_log_type command . . . . . . . . set_kernel_memory_limit command . . . . . . set_log_file command . . . . . . . . . . . set_log_type command . . . . . . . . . . . set_tn_server_trace command . . . . . . . . set_trace_file command . . . . . . . . . . . set_trace_type command . . . .
status_lu62 command . . . . . status_node command . . . . . status_remote_node command . . stop_dlc command . . . . . . stop_internal_pu command . . . stop_ls command . . . . . . . stop_port command . . . . . . STREAMS buffers defining limit . . . . . . . viewing limit and current usage subrecords . . . . . . . . . . T term_node command . . . . . TN server tracing defining . . . . . . . . . viewing definition . . . . . TN3270 client defining . . . . . . . . . deleting . . . . . . . . . viewing definition .
defining access permissions . . . . . removing access permissions . . . . viewing definition of access permissions usage log file defining . . . . . . . . . . . . . viewing definition . . . . . . . . . user ID, conversation security defining . . . . . . . . . . . . . deleting . . . . . . . . . . . . . viewing definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 . . . . . . . . . . . . . . . . . . . . . . . . . . 279 . . . . . . . . . . . . . . . . . . . . . . . . . . 515 . .
