HP HP-UX SNAplus2 R7 Reference Guide

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

Contents

Legal Notices.............................................................................................................................................24

Warranty............................................................................................................................................24

U.S. Government License.. ..............................................................................................................24

Copyright Notices.............................................................................................................................24

Trademark Notices............................................................................................................................24

Publishing History.....................................................................................................................................25

New and Changed Information in This Edition.. .............................................................................. 25

Before You Begin...................................................................................................................................... 26

Prerequisite Knowledge....................................................................................................................26

About This Book...............................................................................................................................26

Organization of This Book....................................................................................................... 26

Typographic Conventions.........................................................................................................26

SNAplus2 Publications.....................................................................................................................27

Publications for Users..............................................................................................................27

Publications for Administrators.. .............................................................................................. 28

Publications for Programmers..................................................................................................28

Related Publications.........................................................................................................................29

Chapter 1 Introduction to SNAplus2 Administration Commands.. .................................................. 30

1.1 Using snapadmin.. .................................................................................................................. 31

1.1.1 Command Line Options...............................................................................................31

1.1.2 Parameter Syntax Used for Administration Commands..............................................33

1.1.3 Examples of Administration Commands.....................................................................37

Chapter 2 Administration Commands.. ............................................................................................... 38

2.1 activate_session......................................................................................................................38

2.1.1 Supplied Parameters.. ................................................................................................. 38

2.1.2 Returned Parameters..................................................................................................39

2.1.3 Error Return Codes.. ...................................................................................................39

2.2 add_backup.............................................................................................................................40

2.2.1 Supplied Parameters.. ................................................................................................. 40

2.2.2 Returned Parameters..................................................................................................41

2.2.3 Error Return Codes.. ...................................................................................................41

2.3 add_dlc_trace..........................................................................................................................41

2.3.1 Supplied Parameters.. ................................................................................................. 42

2.3.2 Returned Parameters..................................................................................................43

2.3.3 Error Return Codes.. ...................................................................................................43

2.4 aping........................................................................................................................................44

2.4.1 Supplied Parameters.. ................................................................................................. 44

2.4.2 Returned Parameters..................................................................................................46

2.4.3 Error Return Codes.. ...................................................................................................47

2.5 change_session_limit..............................................................................................................49

2.5.1 Supplied Parameters.. ................................................................................................. 49

2.5.2 Returned Parameters..................................................................................................50

2.5.3 Error Return Codes.. ...................................................................................................51

2.6 deactivate_conv_group............................................................................................................52

2.6.1 Supplied Parameters.. ................................................................................................. 52

2.6.2 Returned Parameters..................................................................................................53

2.6.3 Error Return Codes.. ...................................................................................................53

2.7 deactivate_lu_0_to_3..............................................................................................................54

2.7.1 Supplied Parameters.. ................................................................................................. 54

2.7.2 Returned Parameters..................................................................................................54

2.7.3 Error Return Codes.. ...................................................................................................54

2.8 deactivate_session..................................................................................................................55

2.8.1 Supplied Parameters.. ................................................................................................. 55

2.8.2 Returned Parameters..................................................................................................56

2.8.3 Error Return Codes.. ...................................................................................................56

2.9 deﬁne_3270_diag....................................................................................................................57

2.9.1 Supplied Parameters.. ................................................................................................. 57

2.9.2 Returned Parameters..................................................................................................59

2.9.3 Error Return Codes.. ...................................................................................................59

2.10 deﬁne_adjacent_len_node....................................................................................................59

2.10.1 Supplied Parameters.. ............................................................................................... 60

2.10.2 Returned Parameters................................................................................................ 60

2.10.3 Error Return Codes.. .................................................................................................60

2.11 deﬁne_cn...............................................................................................................................61

2.11.1 Supplied Parameters.. ............................................................................................... 61

2.11.2 Returned Parameters................................................................................................ 63

2.11.3 Error Return Codes.. .................................................................................................63

2.12 deﬁne_cos.............................................................................................................................64

2.12.1 Supplied Parameters.. ............................................................................................... 64

2.12.2 Returned Parameters................................................................................................ 69

2.12.3 Error Return Codes.. .................................................................................................69

2.13 deﬁne_cpic_side_info.. .......................................................................................................... 70

2.13.1 Supplied Parameters.. ............................................................................................... 70

2.13.2 Returned Parameters................................................................................................ 71

2.13.3 Error Return Codes.. .................................................................................................71

2.14 deﬁne_default_pu..................................................................................................................72

2.14.1 Supplied Parameters.. ............................................................................................... 72

2.14.2 Returned Parameters................................................................................................ 72

iii

2.14.3 Error Return Codes.. .................................................................................................73

2.15 deﬁne_defaults...................................................................................................................... 73

2.15.1 Supplied Parameters.. ............................................................................................... 73

2.15.2 Returned Parameters................................................................................................ 74

2.15.3 Error Return Codes.. .................................................................................................74

2.16 deﬁne_directory_entry...........................................................................................................74

2.16.1 Supplied Parameters.. ............................................................................................... 75

2.16.2 Returned Parameters................................................................................................ 76

2.16.3 Error Return Codes.. .................................................................................................76

2.17 deﬁne_dlur_defaults.............................................................................................................. 77

2.17.1 Supplied Parameters.. ............................................................................................... 77

2.17.2 Returned Parameters................................................................................................ 78

2.17.3 Error Return Codes.. .................................................................................................78

2.18 deﬁne_domain_conﬁg_ﬁle.....................................................................................................79

2.18.1 Supplied Parameters.. ............................................................................................... 79

2.18.2 Returned Parameters................................................................................................ 79

2.18.3 Error Return Codes.. .................................................................................................79

2.19 deﬁne_downstream_lu..........................................................................................................79

2.19.1 Supplied Parameters.. ............................................................................................... 80

2.19.2 Returned Parameters................................................................................................ 81

2.19.3 Error Return Codes.. .................................................................................................81

2.20 deﬁne_downstream_lu_range............................................................................................... 82

2.20.1 Supplied Parameters.. ............................................................................................... 83

2.20.2 Returned Parameters................................................................................................ 84

2.20.3 Error Return Codes.. .................................................................................................84

2.21 deﬁne_dspu_template...........................................................................................................85

2.21.1 Supplied Parameters.. ............................................................................................... 86

2.21.2 Returned Parameters................................................................................................ 87

2.21.3 Error Return Codes.. .................................................................................................87

2.22 deﬁne_emulator_user............................................................................................................88

2.22.1 Supplied Parameters.. ............................................................................................... 88

2.22.2 Returned Parameters................................................................................................ 92

2.22.3 Error Return Codes.. .................................................................................................93

2.23 deﬁne_ethernet_dlc...............................................................................................................93

2.24 deﬁne_ethernet_ls.................................................................................................................93

2.25 deﬁne_ethernet_port.............................................................................................................93

2.26 deﬁne_fddi_dlc......................................................................................................................93

2.27 deﬁne_fddi_ls........................................................................................................................93

2.28 deﬁne_fddi_port.. .................................................................................................................. 94

2.29 deﬁne_focal_point.................................................................................................................94

2.29.1 Supplied Parameters.. ............................................................................................... 94

2.29.2 Returned Parameters................................................................................................ 95

2.29.3 Error Return Codes.. .................................................................................................95

2.30 deﬁne_internal_pu.................................................................................................................96

2.30.1 Supplied Parameters.. ............................................................................................... 96

2.30.2 Returned Parameters................................................................................................ 98

2.30.3 Error Return Codes.. .................................................................................................98

2.31 deﬁne_ip_dlc.........................................................................................................................99

2.31.1 Supplied Parameters.. ............................................................................................... 99

2.31.2 Returned Parameters.............................................................................................. 100

2.31.3 Error Return Codes.. ............................................................................................... 100

2.32 deﬁne_ip_ls.........................................................................................................................101

2.32.1 Supplied Parameters.. ............................................................................................. 101

2.32.2 Returned Parameters.............................................................................................. 109

2.32.3 Error Return Codes.. ............................................................................................... 109

2.33 deﬁne_ip_port.. ................................................................................................................... 111

2.33.1 Supplied Parameters.. ............................................................................................. 111

2.33.2 Returned Parameters.............................................................................................. 115

2.33.3 Error Return Codes.. ............................................................................................... 115

2.33.4 Incoming Calls.........................................................................................................116

2.34 deﬁne_local_lu.................................................................................................................... 116

2.34.1 Supplied Parameters.. ............................................................................................. 116

2.34.2 Returned Parameters.............................................................................................. 119

2.34.3 Error Return Codes.. ............................................................................................... 119

2.35 deﬁne_ls_routing.................................................................................................................120

2.35.1 Supplied Parameters.. ............................................................................................. 120

2.35.2 Returned Parameters.............................................................................................. 121

2.35.3 Error Return Codes.. ............................................................................................... 121

2.36 deﬁne_lu_0_to_3.................................................................................................................122

2.36.1 Supplied Parameters.. ............................................................................................. 122

2.36.2 Returned Parameters.............................................................................................. 124

2.36.3 Error Return Codes.. ............................................................................................... 124

2.37 deﬁne_lu_0_to_3_range......................................................................................................125

2.37.1 Supplied Parameters.. ............................................................................................. 126

2.37.2 Returned Parameters.............................................................................................. 128

2.37.3 Error Return Codes.. ............................................................................................... 128

2.38 deﬁne_lu_lu_password........................................................................................................130

2.38.1 Supplied Parameters.. ............................................................................................. 130

2.38.2 Returned Parameters.............................................................................................. 131

2.38.3 Error Return Codes.. ............................................................................................... 131

2.39 deﬁne_lu_pool.....................................................................................................................131

2.39.1 Supplied Parameters.. ............................................................................................. 131

2.39.2 Returned Parameters.............................................................................................. 132

2.39.3 Error Return Codes.. ............................................................................................... 132

2.40 deﬁne_lu62_timeout............................................................................................................133

2.40.1 Supplied Parameters.. ............................................................................................. 133

2.40.2 Returned Parameters.............................................................................................. 134

2.40.3 Error Return Codes.. ............................................................................................... 134

2.41 deﬁne_mode........................................................................................................................134

2.41.1 Supplied Parameters.. ............................................................................................. 135

2.41.2 Returned Parameters.............................................................................................. 137

2.41.3 Error Return Codes.. ............................................................................................... 137

2.42 deﬁne_node.........................................................................................................................138

2.42.1 Supplied Parameters.. ............................................................................................. 138

2.42.2 Returned Parameters.............................................................................................. 145

2.42.3 Error Return Codes.. ............................................................................................... 146

2.43 deﬁne_partner_lu.. .............................................................................................................. 147

2.43.1 Supplied Parameters.. ............................................................................................. 147

2.43.2 Returned Parameters.............................................................................................. 148

2.43.3 Error Return Codes.. ............................................................................................... 148

2.44 deﬁne_qllc_dlc.....................................................................................................................149

2.44.1 Supplied Parameters.. ............................................................................................. 149

2.44.2 Returned Parameters.............................................................................................. 150

2.44.3 Error Return Codes.. ............................................................................................... 150

2.45 deﬁne_qllc_ls.......................................................................................................................150

2.45.1 Supplied Parameters.. ............................................................................................. 151

2.45.2 Returned Parameters.............................................................................................. 164

2.45.3 Error Return Codes.. ............................................................................................... 164

2.46 deﬁne_qllc_port...................................................................................................................167

2.46.1 Supplied Parameters.. ............................................................................................. 167

2.46.2 Returned Parameters.............................................................................................. 172

2.46.3 Error Return Codes.. ............................................................................................... 172

2.46.4 Incoming Calls.........................................................................................................173

2.47 deﬁne_rcf_access............................................................................................................... 174

2.47.1 Supplied Parameters.. ............................................................................................. 174

2.47.2 Returned Parameters.............................................................................................. 175

2.47.3 Error Return Codes.. ............................................................................................... 175

2.48 deﬁne_rje_wkstn.. ............................................................................................................... 175

2.48.1 Supplied Parameters.. ............................................................................................. 176

2.48.2 Returned Parameters.............................................................................................. 177

2.48.3 Error Return Codes.. ............................................................................................... 177

2.49 deﬁne_rtp_tuning.. .............................................................................................................. 177

2.49.1 Supplied Parameters.. ............................................................................................. 177

2.49.2 Returned Parameters.............................................................................................. 178

2.49.3 Error Return Codes.. ............................................................................................... 178

2.50 deﬁne_sdlc_dlc....................................................................................................................179

2.50.1 Supplied Parameters.. ............................................................................................. 179

2.50.2 Returned Parameters.............................................................................................. 180

2.50.3 Error Return Codes.. ............................................................................................... 180

2.51 deﬁne_sdlc_ls......................................................................................................................181

2.51.1 Supplied Parameters.. ............................................................................................. 181

2.51.2 Returned Parameters.............................................................................................. 195

2.51.3 Error Return Codes.. ............................................................................................... 195

2.51.4 Modem Control Characters..................................................................................... 198

2.52 deﬁne_sdlc_port..................................................................................................................199

2.52.1 Supplied Parameters.. ............................................................................................. 199

2.52.2 Returned Parameters.............................................................................................. 208

2.52.3 Error Return Codes.. ............................................................................................... 209

2.52.4 Incoming Calls.........................................................................................................210

2.53 deﬁne_security_access_list.................................................................................................210

2.53.1 Supplied Parameters.. ............................................................................................. 210

2.53.2 Returned Parameters.............................................................................................. 211

2.53.3 Error Return Codes.. ............................................................................................... 211

2.54 deﬁne_tn3270_access........................................................................................................ 211

2.54.1 Supplied Parameters.. ............................................................................................. 212

2.54.2 Returned Parameters.............................................................................................. 214

2.54.3 Error Return Codes.. ............................................................................................... 214

2.54.4 Using the Telnet Daemon’s TCP/IP Port.................................................................215

2.55 deﬁne_tn3270_association..................................................................................................215

2.55.1 Supplied Parameters.. ............................................................................................. 215

2.55.2 Returned Parameters.............................................................................................. 216

2.55.3 Error Return Codes.. ............................................................................................... 216

2.56 deﬁne_tn3270_defaults....................................................................................................... 216

2.56.1 Supplied Parameters.. ............................................................................................. 217

2.56.2 Returned Parameters.............................................................................................. 217

2.56.3 Error Return Codes.. ............................................................................................... 218

2.57 deﬁne_tp..............................................................................................................................218

2.57.1 Supplied Parameters.. ............................................................................................. 218

2.57.2 Returned Parameters.............................................................................................. 220

2.57.3 Error Return Codes.. ............................................................................................... 220

2.58 deﬁne_tp_load_info.. ...........................................................................................................221

2.58.1 Supplied Parameters.. ............................................................................................. 221

2.58.2 Returned Parameters.............................................................................................. 222

2.58.3 Error Return Codes.. ............................................................................................... 222

2.59 deﬁne_tr_dlc, deﬁne_ethernet_dlc, deﬁne_fddi_dlc............................................................223

2.59.1 Supplied Parameters.. ............................................................................................. 223

2.59.2 Returned Parameters.............................................................................................. 224

2.59.3 Error Return Codes.. ............................................................................................... 224

2.60 deﬁne_tr_ls, deﬁne_ethernet_ls, deﬁne_fddi_ls..................................................................225

2.60.1 Supplied Parameters.. ............................................................................................. 225

vii

2.60.2 Returned Parameters.............................................................................................. 237

2.60.3 Error Return Codes.. ............................................................................................... 237

2.60.4 Bit Ordering in MAC Addresses..............................................................................239

2.61 deﬁne_tr_port, deﬁne_ethernet_port, deﬁne_fddi_port......................................................240

2.61.1 Supplied Parameters.. ............................................................................................. 241

2.61.2 Returned Parameters.............................................................................................. 245

2.61.3 Error Return Codes.. ............................................................................................... 245

2.61.4 Incoming Calls.........................................................................................................246

2.62 deﬁne_userid_password.. ................................................................................................... 247

2.62.1 Supplied Parameters.. ............................................................................................. 247

2.62.2 Returned Parameters.............................................................................................. 248

2.62.3 Error Return Codes.. ............................................................................................... 248

2.63 delete_adjacent_len_node..................................................................................................248

2.63.1 Supplied Parameters.. ............................................................................................. 249

2.63.2 Returned Parameters.............................................................................................. 249

2.63.3 Error Return Codes.. ............................................................................................... 249

2.64 delete_backup..................................................................................................................... 250

2.64.1 Supplied Parameters.. ............................................................................................. 250

2.64.2 Returned Parameters.............................................................................................. 250

2.64.3 Error Return Codes.. ............................................................................................... 251

2.65 delete_cn.............................................................................................................................251

2.65.1 Supplied Parameters.. ............................................................................................. 251

2.65.2 Returned Parameters.............................................................................................. 252

2.65.3 Error Return Codes.. ............................................................................................... 252

2.66 delete_cos...........................................................................................................................252

2.66.1 Supplied Parameters.. ............................................................................................. 253

2.66.2 Returned Parameters.............................................................................................. 253

2.66.3 Error Return Codes.. ............................................................................................... 253

2.67 delete_cpic_side_info.. ........................................................................................................ 253

2.67.1 Supplied Parameters.. ............................................................................................. 254

2.67.2 Returned Parameters.............................................................................................. 254

2.67.3 Error Return Codes.. ............................................................................................... 254

2.68 delete_directory_entry.........................................................................................................254

2.68.1 Supplied Parameters.. ............................................................................................. 255

2.68.2 Returned Parameters.............................................................................................. 255

2.68.3 Error Return Codes.. ............................................................................................... 255

2.69 delete_dlc............................................................................................................................256

2.69.1 Supplied Parameters.. ............................................................................................. 256

2.69.2 Returned Parameters.............................................................................................. 256

2.69.3 Error Return Codes.. ............................................................................................... 256

viii

2.70 delete_downstream_lu........................................................................................................257

2.70.1 Supplied Parameters.. ............................................................................................. 257

2.70.2 Returned Parameters.............................................................................................. 257

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.71.3 Error Return Codes.. ............................................................................................... 259

2.72 delete_dspu_template.........................................................................................................259

2.72.1 Supplied Parameters.. ............................................................................................. 259

2.72.2 Returned Parameters.............................................................................................. 260

2.72.3 Error Return Codes.. ............................................................................................... 261

2.73 delete_emulator_user..........................................................................................................261

2.73.1 Supplied Parameters.. ............................................................................................. 261

2.73.2 Returned Parameters.............................................................................................. 262

2.73.3 Error Return Codes.. ............................................................................................... 262

2.74 delete_focal_point...............................................................................................................263

2.74.1 Supplied Parameters.. ............................................................................................. 263

2.74.2 Returned Parameters.............................................................................................. 263

2.74.3 Error Return Codes.. ............................................................................................... 263

2.75 delete_internal_pu...............................................................................................................264

2.75.1 Supplied Parameters.. ............................................................................................. 264

2.75.2 Returned Parameters.............................................................................................. 264

2.75.3 Error Return Codes.. ............................................................................................... 265

2.76 delete_local_lu.................................................................................................................... 265

2.76.1 Supplied Parameters.. ............................................................................................. 266

2.76.2 Returned Parameters.............................................................................................. 266

2.76.3 Error Return Codes.. ............................................................................................... 266

2.77 delete_ls..............................................................................................................................266

2.77.1 Supplied Parameters.. ............................................................................................. 266

2.77.2 Returned Parameters.............................................................................................. 267

2.77.3 Error Return Codes.. ............................................................................................... 267

2.78 delete_ls_routing.................................................................................................................267

2.78.1 Supplied Parameters.. ............................................................................................. 268

2.78.2 Returned Parameters.............................................................................................. 268

2.78.3 Error Return Codes.. ............................................................................................... 268

2.79 delete_lu_0_to_3.................................................................................................................269

2.79.1 Supplied Parameters.. ............................................................................................. 269

2.79.2 Returned Parameters.............................................................................................. 269

2.79.3 Error Return Codes.. ............................................................................................... 270

2.80 delete_lu_0_to_3_range......................................................................................................270

2.80.1 Supplied Parameters.. ............................................................................................. 270

2.80.2 Returned Parameters.............................................................................................. 271

2.80.3 Error Return Codes.. ............................................................................................... 271

2.81 delete_lu_lu_password........................................................................................................272

2.81.1 Supplied Parameters.. ............................................................................................. 272

2.81.2 Returned Parameters.............................................................................................. 272

2.81.3 Error Return Codes.. ............................................................................................... 273

2.82 delete_lu_pool.....................................................................................................................273

2.82.1 Supplied Parameters.. ............................................................................................. 273

2.82.2 Returned Parameters.............................................................................................. 274

2.82.3 Error Return Codes.. ............................................................................................... 274

2.83 delete_lu62_timeout............................................................................................................274

2.83.1 Supplied Parameters.. ............................................................................................. 274

2.83.2 Returned Parameters.............................................................................................. 275

2.83.3 Error Return Codes.. ............................................................................................... 275

2.84 delete_mode........................................................................................................................276

2.84.1 Supplied Parameters.. ............................................................................................. 276

2.84.2 Returned Parameters.............................................................................................. 276

2.84.3 Error Return Codes.. ............................................................................................... 276

2.85 delete_partner_lu.. .............................................................................................................. 277

2.85.1 Supplied Parameters.. ............................................................................................. 277

2.85.2 Returned Parameters.............................................................................................. 277

2.85.3 Error Return Codes.. ............................................................................................... 278

2.86 delete_port.. ........................................................................................................................ 278

2.86.1 Supplied Parameters.. ............................................................................................. 278

2.86.2 Returned Parameters.............................................................................................. 278

2.86.3 Error Return Codes.. ............................................................................................... 278

2.87 delete_rcf_access............................................................................................................... 279

2.87.1 Supplied Parameters.. ............................................................................................. 279

2.87.2 Returned Parameters.............................................................................................. 279

2.87.3 Error Return Codes.. ............................................................................................... 279

2.88 delete_rje_wkstn.. ............................................................................................................... 280

2.88.1 Supplied Parameters.. ............................................................................................. 280

2.88.2 Returned Parameters.............................................................................................. 280

2.88.3 Error Return Codes.. ............................................................................................... 280

2.89 delete_security_access_list.................................................................................................281

2.89.1 Supplied Parameters.. ............................................................................................. 281

2.89.2 Returned Parameters.............................................................................................. 281

2.89.3 Error Return Codes.. ............................................................................................... 281

2.90 delete_tn3270_access........................................................................................................ 282

2.90.1 Supplied Parameters.. ............................................................................................. 282

2.90.2 Returned Parameters.............................................................................................. 283

2.90.3 Error Return Codes.. ............................................................................................... 283

2.91 delete_tn3270_association..................................................................................................284

2.91.1 Supplied Parameters.. ............................................................................................. 284

2.91.2 Returned Parameters.............................................................................................. 284

2.91.3 Error Return Codes.. ............................................................................................... 284

2.92 delete_tp..............................................................................................................................285

2.92.1 Supplied Parameters.. ............................................................................................. 285

2.92.2 Returned Parameters.............................................................................................. 285

2.92.3 Error Return Codes.. ............................................................................................... 285

2.93 delete_tp_load_info.. ...........................................................................................................286

2.93.1 Supplied Parameters.. ............................................................................................. 286

2.93.2 Returned Parameters.............................................................................................. 286

2.93.3 Error Return Codes.. ............................................................................................... 286

2.94 delete_userid_password.. ................................................................................................... 287

2.94.1 Supplied Parameters.. ............................................................................................. 287

2.94.2 Returned Parameters.............................................................................................. 287

2.94.3 Error Return Codes.. ............................................................................................... 287

2.95 init_node..............................................................................................................................288

2.95.1 Supplied Parameters.. ............................................................................................. 288

2.95.2 Returned Parameters.............................................................................................. 288

2.95.3 Error Return Codes.. ............................................................................................... 288

2.96 initialize_session_limit.........................................................................................................289

2.96.1 Supplied Parameters.. ............................................................................................. 289

2.96.2 Returned Parameters.............................................................................................. 291

2.96.3 Error Return Codes.. ............................................................................................... 291

2.97 path_switch.. ....................................................................................................................... 293

2.97.1 Supplied Parameters.. ............................................................................................. 293

2.97.2 Returned Parameters.............................................................................................. 293

2.97.3 Error Return Codes.. ............................................................................................... 293

2.98 query_3270_diag.. .............................................................................................................. 294

2.98.1 Supplied Parameters.. ............................................................................................. 294

2.98.2 Returned Parameters.............................................................................................. 295

2.98.3 Error Return Codes.. ............................................................................................... 295

2.99 query_3270_user................................................................................................................ 296

2.99.1 Supplied Parameters.. ............................................................................................. 296

2.99.2 Returned Parameters: Summary Information.........................................................298

2.99.3 Returned Parameters: Detailed Information........................................................... 298

2.99.4 Error Return Codes.. ............................................................................................... 299

2.100 query_3270_user_sessions.. ............................................................................................ 299

2.100.1 Supplied Parameters.. ........................................................................................... 300

2.100.2 Returned Parameters: Summary Information.......................................................301

2.100.3 Returned Parameters: Detailed Information......................................................... 301

2.100.4 Error Return Codes.. ............................................................................................. 301

2.101 query_active_transaction.................................................................................................. 302

2.101.1 Supplied Parameters.. ........................................................................................... 302

2.101.2 Returned Parameters............................................................................................ 303

2.101.3 Error Return Codes.. ............................................................................................. 304

2.102 query_adjacent_nn............................................................................................................305

2.102.1 Supplied Parameters.. ........................................................................................... 305

2.102.2 Returned Parameters............................................................................................ 305

2.102.3 Error Return Codes.. ............................................................................................. 306

2.103 query_available_tp.. .......................................................................................................... 307

2.103.1 Supplied Parameters.. ........................................................................................... 307

2.103.2 Returned Parameters............................................................................................ 308

2.103.3 Error Return Codes.. ............................................................................................. 308

2.104 query_bck_cs_trace..........................................................................................................309

2.104.1 Supplied Parameters.. ........................................................................................... 309

2.104.2 Returned Parameters............................................................................................ 309

2.104.3 Error Return Codes.. ............................................................................................. 309

2.105 query_buffer_availability.................................................................................................... 310

2.105.1 Supplied Parameters.. ........................................................................................... 310

2.105.2 Returned Parameters............................................................................................ 310

2.105.3 Error Return Codes.. ............................................................................................. 312

2.106 query_central_logger.........................................................................................................312

2.106.1 Supplied Parameters.. ........................................................................................... 313

2.106.2 Returned Parameters............................................................................................ 313

2.106.3 Error Return Codes.. ............................................................................................. 313

2.107 query_central_logging.......................................................................................................313

2.107.1 Supplied Parameters.. ........................................................................................... 313

2.107.2 Returned Parameters............................................................................................ 314

2.107.3 Error Return Codes.. ............................................................................................. 314

2.108 query_cn.. .........................................................................................................................314

2.108.1 Supplied Parameters.. ........................................................................................... 315

2.108.2 Returned Parameters............................................................................................ 315

2.108.3 Error Return Codes.. ............................................................................................. 317

2.109 query_cn_port................................................................................................................... 317

2.109.1 Supplied Parameters.. ........................................................................................... 318

2.109.2 Returned Parameters............................................................................................ 318

2.109.3 Error Return Codes.. ............................................................................................. 319

2.110 query_conversation...........................................................................................................319

2.110.1 Supplied Parameters.. ........................................................................................... 319

2.110.2 Returned Parameters............................................................................................ 320

2.110.3 Error Return Codes.. ............................................................................................. 321

2.111 query_cos..........................................................................................................................322

2.111.1 Supplied Parameters.. ........................................................................................... 322

2.111.2 Returned Parameters............................................................................................ 323

2.111.3 Error Return Codes.. ............................................................................................. 324

2.112 query_cos_node_row........................................................................................................ 324

2.112.1 Supplied Parameters.. ........................................................................................... 324

2.112.2 Returned Parameters............................................................................................ 325

2.112.3 Error Return Codes.. ............................................................................................. 326

xii

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.. ............................................................................................. 330

2.114 query_cpic_side_info.........................................................................................................330

2.114.1 Supplied Parameters.. ........................................................................................... 330

2.114.2 Returned Parameters............................................................................................ 331

2.114.3 Error Return Codes.. ............................................................................................. 332

2.115 query_cs_trace..................................................................................................................332

2.115.1 Supplied Parameters.. ........................................................................................... 332

2.115.2 Returned Parameters............................................................................................ 333

2.115.3 Error Return Codes.. ............................................................................................. 333

2.116 query_default_pu...............................................................................................................334

2.116.1 Supplied Parameters.. ........................................................................................... 334

2.116.2 Returned Parameters............................................................................................ 334

2.116.3 Error Return Codes.. ............................................................................................. 335

2.117 query_defaults...................................................................................................................335

2.117.1 Supplied Parameters.. ........................................................................................... 335

2.117.2 Returned Parameters............................................................................................ 335

2.117.3 Error Return Codes.. ............................................................................................. 336

2.118 query_directory_entry........................................................................................................336

2.118.1 Supplied Parameters.. ........................................................................................... 337

2.118.2 Returned Parameters: Summary Information.......................................................339

2.118.3 Returned Parameters: Detailed Information......................................................... 339

2.118.4 Error Return Codes.. ............................................................................................. 342

2.119 query_directory_lu.............................................................................................................342

2.119.1 Supplied Parameters.. ........................................................................................... 342

2.119.2 Returned Parameters: Summary Information.......................................................343

2.119.3 Returned Parameters: Detailed Information......................................................... 343

2.119.4 Error Return Codes.. ............................................................................................. 345

2.120 query_directory_stats........................................................................................................345

2.120.1 Supplied Parameters.. ........................................................................................... 345

2.120.2 Returned Parameters............................................................................................ 346

2.120.3 Error Return Codes.. ............................................................................................. 347

2.121 query_dlc...........................................................................................................................347

2.121.1 Supplied Parameters.. ........................................................................................... 347

2.121.2 Returned Parameters: Summary Information.......................................................348

2.121.3 Returned Parameters: Detailed Information......................................................... 349

2.121.4 Error Return Codes.. ............................................................................................. 351

2.122 query_dlc_trace.................................................................................................................351

2.122.1 Supplied Parameters.. ........................................................................................... 351

2.122.2 Returned Parameters............................................................................................ 353

2.122.3 Error Return Codes.. ............................................................................................. 355

xiii

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.124 query_dlur_lu.. ..................................................................................................................357

2.124.1 Supplied Parameters.. ........................................................................................... 357

2.124.2 Returned Parameters: Summary Information.......................................................358

2.124.3 Returned Parameters: Detailed Information......................................................... 359

2.124.4 Error Return Codes.. ............................................................................................. 359

2.125 query_dlur_pu................................................................................................................... 360

2.125.1 Supplied Parameters.. ........................................................................................... 360

2.125.2 Returned Parameters: Summary Information.......................................................362

2.125.3 Returned Parameters: Detailed Information......................................................... 362

2.125.4 Error Return Codes.. ............................................................................................. 364

2.126 query_dlus.........................................................................................................................365

2.126.1 Supplied Parameters.. ........................................................................................... 365

2.126.2 Returned Parameters............................................................................................ 366

2.126.3 Error Return Codes.. ............................................................................................. 368

2.127 query_domain_conﬁg_ﬁle................................................................................................. 369

2.127.1 Supplied Parameters.. ........................................................................................... 369

2.127.2 Returned Parameters............................................................................................ 369

2.127.3 Error Return Codes.. ............................................................................................. 369

2.128 query_downstream_lu.......................................................................................................370

2.128.1 Supplied Parameters.. ........................................................................................... 370

2.128.2 Returned Parameters: Summary Information.......................................................371

2.128.3 Returned Parameters: Detailed Information......................................................... 372

2.128.4 Error Return Codes.. ............................................................................................. 376

2.129 query_downstream_pu......................................................................................................377

2.129.1 Supplied Parameters.. ........................................................................................... 377

2.129.2 Returned Parameters............................................................................................ 378

2.129.3 Error Return Codes.. ............................................................................................. 380

2.130 query_dspu_template........................................................................................................381

2.130.1 Supplied Parameters.. ........................................................................................... 381

2.130.2 Returned Parameters............................................................................................ 381

2.130.3 Error Return Codes.. ............................................................................................. 383

2.131 query_emulator_user_def................................................................................................. 383

2.131.1 Supplied Parameters.. ........................................................................................... 383

2.131.2 Returned Parameters: Summary Information.......................................................384

2.131.3 Returned Parameters: Detailed Information......................................................... 384

2.131.4 Error Return Codes.. ............................................................................................. 387

2.132 query_focal_point..............................................................................................................387

2.132.1 Supplied Parameters.. ........................................................................................... 387

2.132.2 Returned Parameters............................................................................................ 388

xiv

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.133.3 Error Return Codes.. ............................................................................................. 392

2.134 query_isr_session............................................................................................................. 392

2.134.1 Supplied Parameters.. ........................................................................................... 392

2.134.2 Returned Parameters: Summary Information.......................................................393

2.134.3 Returned Parameters: Detailed Information......................................................... 394

2.134.4 Error Return Codes.. ............................................................................................. 396

2.135 query_kernel_memory_limit..............................................................................................397

2.135.1 Supplied Parameters.. ........................................................................................... 397

2.135.2 Returned Parameters............................................................................................ 397

2.135.3 Error Return Codes.. ............................................................................................. 398

2.136 query_local_lu...................................................................................................................398

2.136.1 Supplied Parameters.. ........................................................................................... 398

2.136.2 Returned Parameters: Summary Information.......................................................400

2.136.3 Returned Parameters: Detailed Information......................................................... 400

2.136.4 Error Return Codes.. ............................................................................................. 402

2.137 query_local_topology.........................................................................................................403

2.137.1 Supplied Parameters.. ........................................................................................... 403

2.137.2 Returned Parameters: Summary Information.......................................................404

2.137.3 Returned Parameters: Detailed Information......................................................... 405

2.137.4 Error Return Codes.. ............................................................................................. 407

2.138 query_log_ﬁle....................................................................................................................408

2.138.1 Supplied Parameters.. ........................................................................................... 408

2.138.2 Returned Parameters............................................................................................ 408

2.138.3 Error Return Codes.. ............................................................................................. 409

2.139 query_log_type..................................................................................................................409

2.139.1 Supplied Parameters.. ........................................................................................... 409

2.139.2 Returned Parameters............................................................................................ 409

2.139.3 Error Return Codes.. ............................................................................................. 410

2.140 query_ls.............................................................................................................................411

2.140.1 Supplied Parameters.. ........................................................................................... 411

2.140.2 Returned Parameters: Summary Information.......................................................412

2.140.3 Returned Parameters: Detailed Information......................................................... 414

2.140.4 Error Return Codes.. ............................................................................................. 429

2.141 query_ls_routing................................................................................................................430

2.141.1 Supplied Parameters.. ........................................................................................... 430

2.141.2 Returned Parameters............................................................................................ 431

2.141.3 Error Return Codes.. ............................................................................................. 431

2.142 query_lu_0_to_3.. ............................................................................................................. 432

2.142.1 Supplied Parameters.. ........................................................................................... 432

2.142.2 Returned Parameters: Summary Information.......................................................434

2.142.3 Returned Parameters: Detailed Information......................................................... 435

2.142.4 Error Return Codes.. ............................................................................................. 443

2.143 query_lu_lu_password...................................................................................................... 443

2.143.1 Supplied Parameters.. ........................................................................................... 444

2.143.2 Returned Parameters ...........................................................................................445

2.143.3 Error Return Codes.. ............................................................................................. 445

2.144 query_lu_pool....................................................................................................................446

2.144.1 Supplied Parameters.. ........................................................................................... 446

2.144.2 Returned Parameters: Summary Information.......................................................447

2.144.3 Returned Parameters: Detailed Information......................................................... 447

2.144.4 Error Return Codes.. ............................................................................................. 448

2.145 query_lu62_timeout...........................................................................................................449

2.145.1 Supplied Parameters.. ........................................................................................... 449

2.145.2 Returned Parameters............................................................................................ 450

2.145.3 Error Return Codes.. ............................................................................................. 451

2.146 query_mds_application..................................................................................................... 452

2.146.1 Supplied Parameters.. ........................................................................................... 452

2.146.2 Returned Parameters............................................................................................ 452

2.146.3 Error Return Codes.. ............................................................................................. 453

2.147 query_mds_statistics.........................................................................................................453

2.147.1 Supplied Parameters.. ........................................................................................... 454

2.147.2 Returned Parameters............................................................................................ 454

2.147.3 Error Return Codes.. ............................................................................................. 455

2.148 query_mode...................................................................................................................... 455

2.148.1 Supplied Parameters.. ........................................................................................... 456

2.148.2 Returned Parameters: Summary Information.......................................................457

2.148.3 Returned Parameters: Detailed Information......................................................... 458

2.148.4 Error Return Codes.. ............................................................................................. 460

2.149 query_mode_deﬁnition......................................................................................................461

2.149.1 Supplied Parameters.. ........................................................................................... 461

2.149.2 Returned Parameters: Summary Information.......................................................462

2.149.3 Returned Parameters: Detailed Information......................................................... 462

2.149.4 Error Return Codes.. ............................................................................................. 462

2.150 query_mode_to_cos_mapping..........................................................................................463

2.150.1 Supplied Parameters.. ........................................................................................... 463

2.150.2 Returned Parameters............................................................................................ 464

2.150.3 Error Return Codes.. ............................................................................................. 464

2.151 query_nmvt_application.................................................................................................... 464

2.151.1 Supplied Parameters.. ........................................................................................... 465

2.151.2 Returned Parameters............................................................................................ 465

2.151.3 Error Return Codes.. ............................................................................................. 466

xvi

2.152 query_nn_topology_node..................................................................................................466

2.152.1 Supplied Parameters.. ........................................................................................... 466

2.152.2 Returned Parameters: Summary Information.......................................................468

2.152.3 Returned Parameters: Detailed Information......................................................... 468

2.152.4 Error Return Codes.. ............................................................................................. 470

2.153 query_nn_topology_stats..................................................................................................471

2.153.1 Supplied Parameters.. ........................................................................................... 471

2.153.2 Returned Parameters............................................................................................ 471

2.153.3 Error Return Codes.. ............................................................................................. 474

2.154 query_nn_topology_tg.......................................................................................................474

2.154.1 Supplied Parameters.. ........................................................................................... 474

2.154.2 Returned Parameters: Summary Information.......................................................476

2.154.3 Returned Parameters: Detailed Information......................................................... 477

2.154.4 Error Return Codes.. ............................................................................................. 480

2.155 query_node....................................................................................................................... 481

2.155.1 Supplied Parameters.. ........................................................................................... 481

2.155.2 Returned Parameters............................................................................................ 481

2.155.3 Error Return Codes.. ............................................................................................. 490

2.156 query_node_all..................................................................................................................490

2.156.1 Supplied Parameters.. ........................................................................................... 490

2.156.2 Returned Parameters............................................................................................ 491

2.156.3 Error Return Codes.. ............................................................................................. 491

2.157 query_node_limits.............................................................................................................492

2.157.1 Supplied Parameters.. ........................................................................................... 492

2.157.2 Returned Parameters............................................................................................ 492

2.157.3 Error Return Codes.. ............................................................................................. 495

2.158 query_partner_lu...............................................................................................................496

2.158.1 Supplied Parameters.. ........................................................................................... 496

2.158.2 Returned Parameters: Summary Information.......................................................497

2.158.3 Returned Parameters: Detailed Information......................................................... 498

2.158.4 Error Return Codes.. ............................................................................................. 500

2.159 query_partner_lu_deﬁnition...............................................................................................501

2.159.1 Supplied Parameters.. ........................................................................................... 501

2.159.2 Returned Parameters: Summary Information.......................................................502

2.159.3 Returned Parameters: Detailed Information......................................................... 503

2.159.4 Error Return Codes.. ............................................................................................. 503

2.160 query_port.........................................................................................................................504

2.160.1 Supplied Parameters.. ........................................................................................... 504

2.160.2 Returned Parameters: Summary Information.......................................................505

2.160.3 Returned Parameters: Detailed Information......................................................... 506

2.160.4 Error Return Codes.. ............................................................................................. 510

2.161 query_pu........................................................................................................................... 510

2.161.1 Supplied Parameters.. ........................................................................................... 510

2.161.2 Returned Parameters............................................................................................ 511

xvii

2.161.3 Error Return Codes.. ............................................................................................. 514

2.162 query_rcf_access..............................................................................................................515

2.162.1 Supplied Parameters.. ........................................................................................... 515

2.162.2 Returned Parameters............................................................................................ 515

2.162.3 Error Return Codes.. ............................................................................................. 516

2.163 query_rje_wkstn................................................................................................................516

2.163.1 Supplied Parameters.. ........................................................................................... 516

2.163.2 Returned Parameters: Summary Information.......................................................517

2.163.3 Returned Parameters: Detailed Information......................................................... 518

2.163.4 Error Return Codes.. ............................................................................................. 518

2.164 query_rje_wkstn_def.........................................................................................................519

2.164.1 Supplied Parameters.. ........................................................................................... 519

2.164.2 Returned Parameters: Summary Information.......................................................520

2.164.3 Returned Parameters: Detailed Information......................................................... 520

2.164.4 Error Return Codes.. ............................................................................................. 520

2.165 query_rtp_connection........................................................................................................521

2.165.1 Supplied Parameters.. ........................................................................................... 521

2.165.2 Returned Parameters: Summary Information.......................................................522

2.165.3 Returned Parameters: Detailed Information......................................................... 523

2.165.4 Error Return Codes.. ............................................................................................. 527

2.166 query_rtp_tuning............................................................................................................... 527

2.166.1 Supplied Parameters.. ........................................................................................... 527

2.166.2 Returned Parameters............................................................................................ 527

2.166.3 Error Return Codes.. ............................................................................................. 528

2.167 query_security_access_list.. ............................................................................................. 528

2.167.1 Supplied Parameters.. ........................................................................................... 529

2.167.2 Returned Parameters............................................................................................ 529

2.167.3 Error Return Codes.. ............................................................................................. 530

2.168 query_session...................................................................................................................530

2.168.1 Supplied Parameters.. ........................................................................................... 530

2.168.2 Returned Parameters: Summary Information.......................................................532

2.168.3 Returned Parameters: Detailed Information......................................................... 532

2.168.4 Error Return Codes.. ............................................................................................. 536

2.169 query_sna_net.. ................................................................................................................537

2.169.1 Supplied Parameters.. ........................................................................................... 537

2.169.2 Returned Parameters............................................................................................ 538

2.169.3 Error Return Codes.. ............................................................................................. 538

2.170 query_statistics..................................................................................................................538

2.170.1 Supplied Parameters.. ........................................................................................... 539

2.170.2 Returned Parameters: SDLC LS Statistics...........................................................540

2.170.3 Returned Parameters: SDLC LS Operational Information....................................543

2.170.4 Returned Parameters: SDLC Port Statistics.........................................................545

2.170.5 Returned Parameters: SDLC Port Operational Information................................. 546

xviii

2.170.6 Returned Parameters: Token Ring / Ethernet / FDDI LS Statistics......................548

2.170.7 Returned Parameters: Token Ring, Ethernet, or FDDI Port Statistics................. 548

2.170.8 Returned Parameters: Enterprise Extender..........................................................550

2.170.9 Error Return Codes.. ............................................................................................. 550

2.171 query_tn3270_access_def................................................................................................551

2.171.1 Supplied Parameters.. ........................................................................................... 551

2.171.2 Returned Parameters: Summary Information.......................................................552

2.171.3 Returned Parameters: Detailed Information......................................................... 553

2.171.4 Error Return Codes.. ............................................................................................. 555

2.172 query_tn3270_association................................................................................................ 555

2.172.1 Supplied Parameters.. ........................................................................................... 555

2.172.2 Returned Parameters............................................................................................ 556

2.172.3 Error Return Codes.. ............................................................................................. 556

2.173 query_tn3270_defaults......................................................................................................557

2.173.1 Supplied Parameters.. ........................................................................................... 557

2.173.2 Returned Parameters............................................................................................ 557

2.173.3 Error Return Codes.. ............................................................................................. 558

2.174 query_tn_server_trace...................................................................................................... 558

2.174.1 Supplied Parameters.. ........................................................................................... 558

2.174.2 Returned Parameters............................................................................................ 558

2.174.3 Error Return Codes.. ............................................................................................. 559

2.175 query_tp............................................................................................................................ 559

2.175.1 Supplied Parameters.. ........................................................................................... 559

2.175.2 Returned Parameters............................................................................................ 560

2.175.3 Error Return Codes.. ............................................................................................. 561

2.176 query_tp_deﬁnition............................................................................................................561

2.176.1 Supplied Parameters.. ........................................................................................... 562

2.176.2 Returned Parameters: Summary Information.......................................................562

2.176.3 Returned Parameters: Detailed Information......................................................... 563

2.176.4 Error Return Codes.. ............................................................................................. 563

2.177 query_tp_load_info............................................................................................................564

2.177.1 Supplied Parameters.. ........................................................................................... 564

2.177.2 Returned Parameters............................................................................................ 564

2.177.3 Error Return Codes.. ............................................................................................. 566

2.178 query_trace_ﬁle.................................................................................................................566

2.178.1 Supplied Parameters.. ........................................................................................... 566

2.178.2 Returned Parameters............................................................................................ 567

2.178.3 Error Return Codes.. ............................................................................................. 568

2.179 query_trace_type...............................................................................................................568

2.179.1 Supplied Parameters.. ........................................................................................... 568

2.179.2 Returned Parameters............................................................................................ 568

2.179.3 Error Return Codes.. ............................................................................................. 569

2.180 query_userid_password....................................................................................................570

xix

2.180.1 Supplied Parameters.. ........................................................................................... 570

2.180.2 Returned Parameters............................................................................................ 571

2.180.3 Error Return Codes.. ............................................................................................. 571

2.181 remove_dlc_trace.. ............................................................................................................571

2.181.1 Supplied Parameters.. ........................................................................................... 572

2.181.2 Returned Parameters............................................................................................ 573

2.181.3 Error Return Codes.. ............................................................................................. 573

2.182 reset_session_limit............................................................................................................574

2.182.1 Supplied Parameters.. ........................................................................................... 575

2.182.2 Returned Parameters............................................................................................ 576

2.182.3 Error Return Codes.. ............................................................................................. 577

2.183 set_bck_cs_trace...............................................................................................................579

2.183.1 Supplied Parameters.. ........................................................................................... 579

2.183.2 Returned Parameters............................................................................................ 580

2.183.3 Error Return Codes.. ............................................................................................. 580

2.184 set_buffer_availability.. ...................................................................................................... 581

2.184.1 Supplied Parameters.. ........................................................................................... 581

2.184.2 Returned Parameters............................................................................................ 581

2.184.3 Error Return Codes.. ............................................................................................. 581

2.185 set_central_logging...........................................................................................................581

2.185.1 Supplied Parameters.. ........................................................................................... 581

2.185.2 Returned Parameters............................................................................................ 582

2.185.3 Error Return Codes.. ............................................................................................. 582

2.186 set_cs_trace...................................................................................................................... 582

2.186.1 Supplied Parameters.. ........................................................................................... 583

2.186.2 Returned Parameters............................................................................................ 584

2.186.3 Error Return Codes.. ............................................................................................. 584

2.187 set_global_log_type.......................................................................................................... 585

2.187.1 Supplied Parameters.. ........................................................................................... 585

2.187.2 Returned Parameters............................................................................................ 586

2.187.3 Error Return Codes.. ............................................................................................. 586

2.188 set_kernel_memory_limit.................................................................................................. 587

2.188.1 Supplied Parameters.. ........................................................................................... 587

2.188.2 Returned Parameters............................................................................................ 587

2.188.3 Error Return Codes.. ............................................................................................. 587

2.189 set_log_ﬁle........................................................................................................................588

2.189.1 Supplied Parameters.. ........................................................................................... 588

2.189.2 Returned Parameters............................................................................................ 590

2.189.3 Error Return Codes.. ............................................................................................. 590

2.190 set_log_type......................................................................................................................590

2.190.1 Supplied Parameters.. ........................................................................................... 590

2.190.2 Returned Parameters............................................................................................ 592

2.190.3 Error Return Codes.. ............................................................................................. 592

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.192 set_trace_ﬁle..................................................................................................................... 594

2.192.1 Supplied Parameters.. ........................................................................................... 594

2.192.2 Returned Parameters............................................................................................ 595

2.192.3 Error Return Codes.. ............................................................................................. 596

2.193 set_trace_type...................................................................................................................596

2.193.1 Supplied Parameters.. ........................................................................................... 596

2.193.2 Returned Parameters............................................................................................ 598

2.193.3 Error Return Codes.. ............................................................................................. 598

2.194 start_dlc.............................................................................................................................599

2.194.1 Supplied Parameters.. ........................................................................................... 599

2.194.2 Returned Parameters............................................................................................ 599

2.194.3 Error Return Codes.. ............................................................................................. 599

2.195 start_internal_pu...............................................................................................................600

2.195.1 Supplied Parameters.. ........................................................................................... 600

2.195.2 Returned Parameters............................................................................................ 600

2.195.3 Error Return Codes.. ............................................................................................. 601

2.196 start_ls...............................................................................................................................602

2.196.1 Supplied Parameters.. ........................................................................................... 602

2.196.2 Returned Parameters............................................................................................ 603

2.196.3 Error Return Codes.. ............................................................................................. 603

2.197 start_port...........................................................................................................................604

2.197.1 Supplied Parameters.. ........................................................................................... 604

2.197.2 Returned Parameters............................................................................................ 605

2.197.3 Error Return Codes.. ............................................................................................. 605

2.198 status_all...........................................................................................................................606

2.198.1 Supplied Parameters.. ........................................................................................... 606

2.198.2 Returned Information.............................................................................................606

2.198.3 Error Return Codes.. ............................................................................................. 608

2.199 status_connectivity.. .......................................................................................................... 608

2.199.1 Supplied Parameters.. ........................................................................................... 608

2.199.2 Returned Information.............................................................................................608

2.199.3 Error Return Codes.. ............................................................................................. 609

2.200 status_dependent_lu.........................................................................................................609

2.200.1 Supplied Parameters.. ........................................................................................... 609

2.200.2 Returned Information.............................................................................................610

2.200.3 Error Return Codes.. ............................................................................................. 612

2.201 status_dlur.........................................................................................................................613

2.201.1 Supplied Parameters.. ........................................................................................... 613

2.201.2 Returned Information.............................................................................................613

xxi

2.201.3 Error Return Codes.. ............................................................................................. 613

2.202 status_lu62........................................................................................................................614

2.202.1 Supplied Parameters.. ........................................................................................... 614

2.202.2 Returned Information.............................................................................................614

2.202.3 Error Return Codes.. ............................................................................................. 614

2.203 status_node.......................................................................................................................615

2.203.1 Supplied Parameters.. ........................................................................................... 615

2.203.2 Returned Information.............................................................................................615

2.203.3 Error Return Codes.. ............................................................................................. 615

2.204 status_remote_node..........................................................................................................616

2.204.1 Parameters.. .......................................................................................................... 616

2.204.2 Returned Information.............................................................................................616

2.204.3 Error Return Codes.. ............................................................................................. 617

2.205 stop_dlc.............................................................................................................................617

2.205.1 Supplied Parameters.. ........................................................................................... 617

2.205.2 Returned Parameters............................................................................................ 618

2.205.3 Error Return Codes.. ............................................................................................. 618

2.206 stop_internal_pu................................................................................................................618

2.206.1 Supplied Parameters.. ........................................................................................... 619

2.206.2 Error Return Codes.. ............................................................................................. 619

2.207 stop_ls...............................................................................................................................620

2.207.1 Supplied Parameters.. ........................................................................................... 620

2.207.2 Returned Parameters............................................................................................ 621

2.207.3 Error Return Codes.. ............................................................................................. 621

2.208 stop_port.. ......................................................................................................................... 622

2.208.1 Supplied Parameters.. ........................................................................................... 622

2.208.2 Returned Parameters............................................................................................ 622

2.208.3 Error Return Codes.. ............................................................................................. 622

2.209 term_node.........................................................................................................................623

2.209.1 Supplied Parameters.. ........................................................................................... 623

2.209.2 Returned Parameters............................................................................................ 624

2.209.3 Error Return Codes.. ............................................................................................. 624

Appendix A Common Return Codes from snapadmin Commands...............................................625

A.1 Communications Subsystem Not Active...............................................................................625

A.2 Function Not Supported....................................................................................................... 625

A.3 Parameter Check.................................................................................................................. 626

A.4 State Check.. ........................................................................................................................ 626

A.5 System Error.........................................................................................................................626

Appendix B Conﬁguration Files.. .......................................................................................................628

B.1 Initial Conﬁguration Files...................................................................................................... 628

xxii

B.2 Conﬁguration File Format.....................................................................................................628

B.2.1 Record Ordering in a Conﬁguration File.. ......................................................................... 629

B.2.2 Record Format...................................................................................................................629

B.2.3 Subrecord Format..............................................................................................................630

B.3 Changes Made to the Conﬁguration Files by the Motif Administration Program.................630

B.4 File Input to the snapadmin Program...................................................................................631

B.4.1 Sample snapadmin Input Files.......................................................................................... 631

B.4.2 Sample Files Delivered with SNAplus2............................................................................. 632

Appendix C Environment Variables................................................................................................... 633

C.1 Environment Variables That Affect All Functions.. ............................................................... 633

C.1.1 LANG.................................................................................................................................633

C.1.2 PATH..................................................................................................................................633

C.2 Environment Variables That Affect 3270 Emulation.............................................................633

C.2.1 CONVERTTRANS............................................................................................................. 633

C.2.2 IND_FILE...........................................................................................................................633

C.2.3 LANG.................................................................................................................................634

C.2.4 SNAP3270_LOWER_RIGHT.............................................................................................634

C.2.5 SNAP3270_SI and SNAP3270_SO.................................................................................. 634

C.2.6 SNAP3270_SPLIT_CHAR.................................................................................................634

C.2.7 SNABLANKSCREEN.........................................................................................................634

C.2.8 SNALU1MPP......................................................................................................................635

C.2.9 SNAMSG...........................................................................................................................635

C.2.10 SNAP3270_COLOR........................................................................................................635

C.2.11 SNAPRMPL.....................................................................................................................635

C.3 Environment Variables That Affect RJE Workstations......................................................... 635

C.3.1 SNABLANKSCREEN.........................................................................................................635

C.3.2 SNAMSG...........................................................................................................................635

C.4 Environment Variables That Affect APPC and CPI-C Communications..............................636

C.4.1 APPCLLU...........................................................................................................................636

C.4.2 APPCTPN..........................................................................................................................636

C.4.3 SHLIB_PATH......................................................................................................................636

C.4.4 CLASSPATH...................................................................................................................... 636

C.5 Environment Variables That Affect the CSV API.. ............................................................... 636

C.5.1 SNATBLG.. ........................................................................................................................ 636

C.6 Environment Variables That Affect the Command-Line Administration Program................637

C.6.1 COLUMNS.........................................................................................................................637

C.7 Environment Variables That Affect Tracing.. ........................................................................ 637

C.7.1 SNATRC.............................................................................................................................637

C.7.2 SNACTL.............................................................................................................................637

C.7.3 SNATRACESIZE................................................................................................................637

C.7.4 SNATRCRESET.................................................................................................................637

C.7.5 SNATRUNC.......................................................................................................................638

xxiii

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 ﬁtness 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.

Warranty

A copy of the speciﬁc warranty terms applicable to your Hewlett-Packard product and replacement parts can be obtained from your local Sales and Service Ofﬁce.

U.S. Government License

Proprietary computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s standard commercial license.

Reproduction, adaptation, or translation of this document without prior written permission is prohibited, except as allowed under the copyright laws.

Trademark Notices

UNIX is a registered trademark in the United States and other countries, licensed exclusively through The Open Group.

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. To ensure that you receive the updated or new editions, you should subscribe to the appropriate product support service. See your HP sales representative for details.

Edition 1: March 1998

Edition 2: October 1998

Edition 3: June 2001

Edition 4: April 2005

New and Changed Information in This Edition

SNAplus2 can now operate as an APPN Network Node, which resides in the backbone of an APPN network and provides resource location and session routing facilities. Alternatively, it can still operate as an End Node or LEN Node (as in earlier versions).

SNAplus2 can also operate as a Branch Network Node, allowing the APPN network to be separated into branches to simplify its topology and reduce network management overheads. A Branch Network Node provides network node functions to end nodes in a branch separated from the main APPN network, while acting as an end node in the main network itself.

The High-Performance Routing (HPR) feature of APPN is now included. This provides Rapid Transport Protocol (RTP), minimizing cycles and storage requirements for routing network layer packets through intermediate nodes on a session route, and Automatic Network Routing (ANR), enabling APPN networks to automatically reroute sessions if a portion of the originally computed route fails.

Enterprise Extender (HPR/IP) connectivity is now included. This provides HPR functionality over IP connections, to support SNA applications connected over an IP network.

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. See the Related publications section for details of manuals that provide this information.

About This Book

This section explains how information is organized and presented in this book.

Organization of This Book

This book is organized as follows:

• Chapter 1, Introduction to SNAplus2 Administration Commands, provides an overview of the tasks involved in administering SNAplus2, provides an overview of how to use the describes characteristics (such as parameter type) that are common to parameters used by all commands.

• Chapter 2, Administration Commands, provides detailed information about the parameters required for speciﬁc administration operations such as deﬁning, starting, or querying a particular resource.

• Appendix A, Common Return Codes from snapadmin Commands, lists error return codes that are common to all commands.

• Appendix B, Conﬁguration Files, describes the contents of the data ﬁles that control how SNAplus2 operates and explains how to modify these ﬁles if required.

• Appendix C, Environment Variables, provides a brief summary of all the environment variables that are used by SNAplus2 programs.

snapadmin administration program, and

Typographic Conventions

Table 1, Typographic Conventions shows the typographic styles used in this document.

Table 1 Typographic Conventions

Special Element Sample of Typography

Document title

File or path name

Directory name

HP-UX SNAplus2 Administration Command Reference

sna.err

/var/opt/sna

Special Element Sample of Typography

Before You Begin

SNAplus2 Publications

Program or application

Command or utility

snapadmin

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).

(

Option or ﬂag

Parameter

Literal value or selection that the user can enter

-d

lu_name

255

(including default values)

Constant (one of several possible parameter values)

Return value

FIRST_IN_LIST

INVALID_LU_ALIAS

Variable representing a supplied value inﬁle

Environment variable

User input

LD_RUN_PATH

snapadmin

status_dependent_lu,pu_name=ETH0

Function, call, or entry point

Data structure

Field name (in a data structure)

ctime()

alert_3270_data

c_cﬂag

Keyboard keys

Hexadecimal value

[ENTER]

0x20

SNAplus2 Publications

SNAplus2 publications include user guides, administrator guides, and programmer guides. The following sections describe the contents of each book.

Publications for Users

SNAplus2 provides the following user guides:

HP-UX SNAplus2 General Information

Provides a general overview of the SNAplus2 product.

HP-UX SNAplus2 3270 User’s Guide

Explains how to perform the following functions when you use 3270 emulation:

• Starting and stopping 3270 emulation

• Transferring ﬁles

• Using customization features such as remapping your keyboard and displaying colors

• Interpreting status-line information

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. These applications use independent LU 6.2 protocols to communicate with similar applications running on other nodes in an SNA network.

SNAplus2 Glossary

Provides a comprehensive list of terms and their deﬁnitions used in the SNAplus2 library.

Publications for Administrators

SNAplus2 provides the following administrator guides:

HP-UX SNAplus2 Installation

Explains how to install the SNAplus2 software and set up system ﬁles.

HP-UX SNAplus2 Migration Guide

Provides information about upgrading to the current version of SNAplus2 from previous versions. It includes information about converting conﬁguration ﬁles, rebuilding applications that use the SNAplus2 application program interfaces (APIs), and changes in other SNAplus2 functions.

HP-UX SNAplus2 Administration Guide

Explains how to enable, conﬁgure, and manage SNAplus2. This guide provides information about SNA concepts, and an overview of the features provided by SNAplus2. It describes how to conﬁgure and manage SNAplus2 using the Motif administration program, and provides guidance for users of the command-line administration program.

HP-UX SNAplus2 Administration Command Reference

Explains how to use the SNAplus2 command-line administration program and shows the syntax of all SNAplus2 administration commands.

HP-UX SNAplus2 Diagnostics Guide

Explains how to investigate and resolve common problems and provides an overview of diagnostic tools, including logging and tracing.

Publications for Programmers

SNAplus2 provides the following programmer guides. Each guide includes conceptual and detailed reference information.

HP-UX SNAplus2 APPC Programmer’s Guide

Contains the information you need to write application programs using Advanced Program-to-Program Communication (APPC).

HP-UX SNAplus2 CPI-C Programmer’s Guide

Contains the information you need to write application programs using Common Programming Interface for Communications (CPI-C).

HP-UX SNAplus2/TN3270 HLLAPI Programmer’s Guide

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.

HP-UX SNAplus2 MS Programmer’s Guide

Contains the information you need to write applications using the Management Services (MS) API.

HP-UX SNAplus2 NOF Programmer’s Guide

Contains the information you need to write applications using the Node Operator Facility (NOF) API.

Related Publications

For information about SNA, APPN or LU 6.2 architecture, refer to the following IBM documents:

• IBM Systems Network Architecture: LU6.2 Reference: Peer Protocols SC31-6808

• IBM Systems Network Architecture: APPN Architecture Reference SC30-3422.

• IBM Systems Network Architecture: Management Services SC30-3346

• IBM Systems Network Architecture: Formats GA27-3136

• IBM APPN Architecture and Product Implementations Tutorial GG24-3669

• IBM AS/400 Advanced Peer-to-Peer Networking GG24-3287

• IBM Communications Manager/2 System Management Programming Reference SC31-6173

• IBM Communications Manager/2 APPC Programming Guide and Reference SC31-6160

• IBM System/370 Principles of Operation GA22-7000

• IBM Systems Network Architecture: Technical Overview GC30-3073

Introduction to SNAplus2 Administration Commands

1 Introduction to SNAplus2 Administration Commands

SNAplus2 administration commands are accessible through the snapadmin command-line administration program that can be used to conﬁgure and manage the SNAplus2 node. The HP- UX SNAplus2 Administration Guide describes how to conﬁgure and manage the SNAplus2 node using speciﬁc administration commands.

This book describes how to use the Administration commands are used for conﬁguring, checking status of, and managing resources. Most administration commands belong to one of these categories as follows:

Conﬁguring

The following types of commands are used to conﬁgure resources:

define_*

Creates a new define_* record in the conﬁguration ﬁle, or replaces a record for the same resource with the new deﬁnition.

delete_*

Removes the corresponding define_* record from the ﬁle.

Checking status

The following types of commands are used to check the conﬁguration and status of resources:

query_*

Returns information from the conﬁguration ﬁle on the appropriate resource, but does not modify the ﬁle.

status_*

snapadmin

program and the commands that you can issue through

program. The

snapadmin program is a

snapadmin.

Provides summary information about the state of resources.

Managing

The following types of commands are used to manage resources:

start_*, init_*,oractivate_*

Explicitly starts a conﬁgured resource. Some resources can be activated implicitly as a result of activating other resources.

stop_*, term_*,ordeactivate_*

Explicitly stops a resource. Some resources can be stopped implicitly (for example, as a result of a period of inactivity).

set_*

Sets tracing and logging parameters.

Administrative commands are listed alphabetically in Chapter 2, Administration Commands.

+ 621 hidden pages