tcp/ip for vse 2.2 command reference - october 2017

Command Reference

Version 2 Release 2

TCP/IP is a communications facility that

permits bi-directional communication

between VSE-based software and

software running on other platforms

equipped with TCP/IP.

This manual contains detailed

explanations of the commands available

for configuring TCP/IP FOR VSE.

Published October 2017

Copyright © by CSI International

Copyright © 1996–2017 by CSI International

All Rights Reserved

RESTRICTED RIGHTS LEGEND

Use, duplication, or disclosure by the Government is subject to the restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer

Software clause at DFARS 252.227-7013.

This material contains confidential and proprietary material of Connectivity

Systems, Inc., hereafter referred to as CSI International and CSI, and may not be used in any way without written authorization from CSI International. This

material may not be reproduced, in whole or in part, in any way, without prior

written permission from CSI International.

Permission is hereby granted to copy and distribute this document as follows:

• Each copy must be a complete and accurate copy.

• All copyright notices must be retained.

• No modifications may be made.

• The use of each copy is restricted to the evaluation and/or promotion of CSI International’s TCP/IP FOR VSE product or in accordance with a license agreement.

TCP/IP FOR VSE Command Reference

Version 2 Release 2

October 2017

Published by CSI International

Phone: 800-795-4914

Fax: 740-986-6022

Internet: http://www.csi-international.com

Product questions: [email protected]

Technical support: [email protected]

Review comments: [email protected]

http://www.csi-international.com/

mailto:[email protected]



CSI International Technical Support

i

During Business Hours Monday through Friday, 9:00 A.M. through 5:00 P.M. EST/EDT.

Telephone: Toll Free in the USA

Worldwide

800-795-4914

740-420-5400

Email: [email protected]

Web: http://csi-international.com/problemreport_vse.htm

Emergency Service 24/7 After business hours and 24 hours on Saturday and Sunday.

Telephone: Toll Free in the USA 800-795-4914

Worldwide 740-420-5400

CSI International provides support to address each issue according to

its severity.


http://csi-international.com/problemreport_vse.htm

ii

Actualizaciones a Este Manual

La siguiente tabla describe las actualizaciones a este manual. Las

actualizaciones pueden ser identificadas por un número fijo en la base

de datos del soporte de CSI International.

Octubre 2017

ID Comando Descripción del Cambio Pág.

DEFINE FTPD Agregado el soporte al protocolo TLS 1.2.

Agregado el operando SSLMODE=.

68

DEFINE TLSD Agregado el soporte al protocolo TLS 1.2. 127

FIREWALL Actualizada la descripción del operando REPORT. 176

Agregados los operandos ALLOWED y BLOCKED.

Tabla de Contenidos

iii

Soporte Técnico CSI International ........................................................................................... i

Actualizaciones a Este Manual ................................................................................................1

1. Resumen de Sintaxis ...........................................................................................................6

2. Descripción de Comandos ................................................................................................ 17

Lista de Resumen ............................................................................................................................ 18

ACCESS .......................................................................................................................................... 26

ASECURITY ................................................................................................................................... 27

AUTOLOAD ................................................................................................................................... 31

CHECKSUM ................................................................................................................................... 32

CLOSE FILE .................................................................................................................................... 33

CONNECT_SEQUENCE ................................................................................................................. 34

CONSOLE_HOLD .......................................................................................................................... 37

DEFINE ADAPTER ......................................................................................................................... 38

DEFINE ALTIP ............................................................................................................................... 41

DEFINE CGI .................................................................................................................................... 43

DEFINE EVENT .............................................................................................................................. 44

DEFINE FILE .................................................................................................................................. 54

DEFINE FILEIO .............................................................................................................................. 66

DEFINE FTPD ................................................................................................................................. 68

DEFINE GPSD ................................................................................................................................ 78

DEFINE HTTPD .............................................................................................................................. 87

DEFINE LINK ................................................................................................................................. 90

DEFINE LOG .................................................................................................................................. 97

DEFINE LPD .................................................................................................................................100

DEFINE MASK .............................................................................................................................103

DEFINE MENU ............................................................................................................................. 105

DEFINE NAME ............................................................................................................................. 106

DEFINE NTPD .............................................................................................................................. 107

DEFINE PUBLISHER ................................................................................................................... 109

DEFINE ROUTE ........................................................................................................................... 111

iv

DEFINE SOTRACE .......................................................................................................................118

DEFINE TELNETD .......................................................................................................................121

DEFINE TLSD ...............................................................................................................................127

DEFINE TRACE ............................................................................................................................131

DEFINE TRANSLATION..............................................................................................................133

DEFINE USER ..............................................................................................................................135

DELETE ALTIP ........................................................................................................................................ 139

DELETE CGI .................................................................................................................................140

DELETE EVENT ...................................................................................................................................... 141

DELETE FILE ...............................................................................................................................142

DELETE FILEIO ...................................................................................................................................... 143

DELETE FTPD ..............................................................................................................................144

DELETE GPSD ..............................................................................................................................145

DELETE HTTPD ...........................................................................................................................146

DELETE LINK ..............................................................................................................................147

DELETE LPD ................................................................................................................................148

DELETE MASK ............................................................................................................................149

DELETE MENU ............................................................................................................................150

DELETE NAME ............................................................................................................................151

DELETE NTPD .............................................................................................................................152

DELETE PUBLISHER ...................................................................................................................153

DELETE ROUTE ...........................................................................................................................154

DELETE TELNETD ......................................................................................................................155

DELETE TLSD ..............................................................................................................................156

DELETE TRACE ...........................................................................................................................157

DELETE USER ..............................................................................................................................158

DIAGNOSE ................................................................................................................................... 159

DISCOVER ................................................................................................................................... 164

DOWNCHECK .............................................................................................................................. 166

DUMP ........................................................................................................................................... 167

DUMPOPTION ............................................................................................................................. 170

EMAIL ....................................................................................................................................................... 171

EXECUTE ..................................................................................................................................... 174

EXTPGVS ..................................................................................................................................... 175

FIREWALL ................................................................................................................................... 176

FLUSH .......................................................................................................................................... 178

FTPBATCH_FETCH ..................................................................................................................... 179

GATEWAY ...................................................................................................................................180

IBBLOK ........................................................................................................................................182

INCLUDE ......................................................................................................................................184

v

IPSTAT ..........................................................................................................................................185

ISOLATION ..................................................................................................................................186

LISTIDCAMS ................................................................................................................................187

LOCAL_DLBL ..............................................................................................................................188

MESSAGE (or MSG) .....................................................................................................................189

MODIFY CONSOLE .....................................................................................................................191

MODIFY FILE ..............................................................................................................................193

MODIFY LOG ...............................................................................................................................204

MODIFY ROUTE ..........................................................................................................................206

PING ..............................................................................................................................................211

PING_MESSAGE ..........................................................................................................................213

PORTQUEUE ................................................................................................................................214

PORTRANGE ................................................................................................................................216

QUERY ACTIVE ..........................................................................................................................217

QUERY ALL .................................................................................................................................219

QUERY ALTIPS............................................................................................................................222

QUERY ARPS ...............................................................................................................................223

QUERY CGIS ................................................................................................................................225

QUERY CONNECTIONS..............................................................................................................226

QUERY DIAGNOSE .....................................................................................................................230

QUERY DUMPOPTIONS .............................................................................................................231

QUERY EMAIL ............................................................................................................................ 232

QUERY EVENTS .......................................................................................................................... 233

QUERY EXTERNAL .................................................................................................................... 235

QUERY EXTTYPES ..................................................................................................................... 236

QUERY FILEIO ............................................................................................................................ 238

QUERY FILES .............................................................................................................................. 239

QUERY FIREWALL ..................................................................................................................... 240

QUERY FRAGMENTS ................................................................................................................. 241

QUERY FTPDS ............................................................................................................................. 242

QUERY GPSDS ............................................................................................................................ 244

QUERY HOME ............................................................................................................................. 245

QUERY HTTPDS .......................................................................................................................... 246

QUERY IBBLOKS ........................................................................................................................ 247

QUERY IPSTAT ........................................................................................................................... 248

QUERY ISTATISTICS .................................................................................................................. 250

QUERY LINKS ............................................................................................................................. 251

QUERY LOCKS ............................................................................................................................ 252

QUERY LOGS .............................................................................................................................. 253

QUERY LPDS ............................................................................................................................... 254

vi

QUERY MASKS ...........................................................................................................................255

QUERY MENUS ...........................................................................................................................256

QUERY NAMES ...........................................................................................................................257

QUERY NTPD ..............................................................................................................................259

QUERY OPENFILES ....................................................................................................................260

QUERY OPTIONS (or QUERY SET) ............................................................................................261

QUERY PORTQUEUE ..................................................................................................................262

QUERY PRODKEYS ....................................................................................................................263

QUERY PROGRAMS ...................................................................................................................264

QUERY PUBLISHERS..................................................................................................................265

QUERY ROUTES ..........................................................................................................................266

QUERY SECURITY ......................................................................................................................268

QUERY STATISTICS (or QUERY STATS) ..................................................................................269

QUERY STOR ...............................................................................................................................273

QUERY TASKS ............................................................................................................................ 276

QUERY TELNETDS ..................................................................................................................... 278

QUERY TLSDS ............................................................................................................................. 279

QUERY TRACES .......................................................................................................................... 280

QUERY TRANSLATIONS............................................................................................................ 281

QUERY TRUSTED ....................................................................................................................... 282

QUERY USERS ............................................................................................................................ 283

QUERY VERSIONS ...................................................................................................................... 284

QUIESCE ...................................................................................................................................... 285

RAPTRAC ..................................................................................................................................... 287

RECORD ....................................................................................................................................... 289

REDEFINE .................................................................................................................................... 290

RELOAD ....................................................................................................................................... 292

RESUME ....................................................................................................................................... 294

SDOPEN_EXTRA ......................................................................................................................... 295

SECURITY .................................................................................................................................... 296

SEGMENT .................................................................................................................................... 300

SEPARATOR_PAGES .................................................................................................................. 301

SET AUTO_TIME ......................................................................................................................... 303

SET DEFAULT_DOMAIN ............................................................................................................ 304

SET DIAGNOSE ........................................................................................................................... 305

SET DNSn ..................................................................................................................................... 306

SET DNSTn ................................................................................................................................... 308

SET FIXED_RETRANSMIT ......................................................................................................... 309

SET IPADDR ............................................................................................................................................ 311

SET LINK_RETRY ....................................................................................................................... 313

vii

SET MASK ....................................................................................................................................314

SET MAXIMUM_MESSAGES .....................................................................................................316

SET MAX_EMAIL_EVENTS .......................................................................................................317

SET MAX_FTP_EVENTS .............................................................................................................318

SET MAX_LPR_EVENTS ............................................................................................................319

SET MAX_SEGMENT ..................................................................................................................320

SET PAGE_COUNT ......................................................................................................................322

SET PASSWORD ..........................................................................................................................323

SET POWERPASSWORD .............................................................................................................324

SET POWERUSERID ....................................................................................................................325

SET PULSE_TIME ........................................................................................................................326

SET RETRANSMIT ......................................................................................................................328

SET TELNET_TRANSLATE ........................................................................................................330

SET TELNETD_BUFFERS ...........................................................................................................331

SET TELNETD_BUFSIZE ............................................................................................................332

SET WINDOW ..............................................................................................................................333

SHUTDOWN .................................................................................................................................335

SINGLEDEST ...............................................................................................................................337

SPINCHECK .................................................................................................................................339

START ..........................................................................................................................................340

STEALTH......................................................................................................................................341

STOP ............................................................................................................................................. 342

SUSPEND ..................................................................................................................................... 344

TRACERT ..................................................................................................................................... 345

TRAFFIC ....................................................................................................................................... 347

TRUST .......................................................................................................................................... 348

UPCASE ........................................................................................................................................ 349

VERIFY_MEMORY...................................................................................................................... 350

WAITFOR ..................................................................................................................................... 351

3. Comandos Obsoletos ...................................................................................................... 352

1

1 Introducción

Sintaxis de Comando

Antes de utilizar la Referencia de Comandos TCP/IP FOR VSE, es

importante comprender las convenciones y la sintaxis utilizado. Cada descripción de comando incluye la siguiente información:

Resumen de Uso

Diagrama de Sintaxis

Lista de Argumento

Ejemplos de uso mostrando mensajes de salida

Comandos Relacionados

Nota: Los campos de mensaje son explicados en Mensajes TCP/IP FOR VSE.

Los diagramas de sintaxis de comando en este manual aparecen como se muestra a

continuación:

COMMand REQuired=value,{KEY1|KEY2|KEY3}

[,OPTParm={Yes|No|number}] [,VALue=87]

[,BIGval=4K] [,TIME=30s]

Este ejemplo muestra como letras mayúsculas y minúsculas son usadas

en los nombres de los comandos. Las mayúsculas son requeridas. El

resto de letras son opcionales y pueden ser incluidas para aclarar. A

cualquier cadena que usted utilice en la línea de comando se le revisa la sintaxis, y debe ser correcta.

Esta convención también aplica a los argumentos y valores de palabras clave.

2

Capítulo 1 Introducción

Argumentos Las siguientes convenciones de argumento son usadas en el ejemplo

anterior:

REQuired= Los parámetros Required se muestran sin corchetes. Las

mayúsculas y minúsculas indican el mínimo requerido de

caracteres.

Los marcadores genéricos para valores se indican en letra itálica.

KEY En donde usted puede especificar una palabra clave; éste aparece

sin un signo de igual. Los “{}” indican que usted debe seleccionar

uno de los valores en la lista. Dado que la lista no está entre en

corchetes, el parámetro es requerido. Si el parámetro fuera opcional, aparecería de la siguiente manera…

[KEY1|KEY2|KEY3]

… en donde el valor subrayado (KEY2) es el predeterminado.

OPTParm= Un parámetro opcional aparece entre corchetes. En el ejemplo, los

valores disponibles están limitados a las opciones mostradas. Las palabras clave son mostradas en letra no itálica, con las mayúsculas

indicando la abreviación mínima. Los valores en itálica indican un

marcador genérico, en este caso, un valor numérico. El valor predeterminado es subrayado.

VALue= Cuando un valor opcional puede ser especificado, el valor

predeterminado aparece como un texto en letra no itálica.

BIGVal= Frecuentemente, valores numéricos extensos necesitan ser especificados. Esto puede ser ingresado con números normales o

utilizando un “sufijo multiplicador”. En seguida se muestran

algunos ejemplos de cómo los sufijos pueden ser usados:

4K = 4,096

4k = 4,000

1M = 1,048,576

4M = 4,194,304

4m = 4,000,000

TIME= Un intervalo de tiempo debe ser especificado con varios comandos. Usualmente, este intervalo es especificado en unidades de 300

segundos. Esta unidad de medida es común en la programación

VSE.

Debido a que resulta tedioso codificar horas, minutos, o segundos en unidades de 300 segundos, usted puede utilizar un sufijo de “s,”

“m,” o “h” para ocasionar una conversación apropiada.

3


Especificando Valores

Marcadores de Argumentos

Tenga en cuenta que las mayúsculas representan lo mismo cuando se trata de valores de tiempo.

2s = 600/300th

2m = 36,000/300th

1h = 1,080,000/300th

Los Valores pueden ser especificados como se muestra en seguida:

Los valores múltiples generalmente son separados por comas y

encerrados entre paréntesis.

UNIT=040

UNIT=(040,041)

Si un rango de valores es provisto, los valores son separados

con un guion y encerrados entre paréntesis:

UNIT=(040-044)

Los “Nombres” utilizados por la pila TCP/IP FOR VSE

generalmente son de hasta 16 caracteres. El primer carácter es

alfabético, y el resto puede ser alfabético o numérico.

Cada argumento en un comando tiene requisitos de formato

específicos. Algunos formatos son usados repetidamente en todo el

producto. Para eliminar explicaciones redundantes de formatos, los

tipos estándar son representados con nombres reservados in los

diagramas de sintaxis. Estos tipos se muestran enseguida.

name64 Esta cadena es la misma que name16, excepto porque la longitud

máxima es de 64 caracteres.

name16 Este representa in nombre interno de TCP/IP. Estos nombres no

diferencian mayúsculas de minúsculas, y son guardados en mayúsculas. Cada nombre consiste en 1 a 16 caracteres alfabéticos

(A–Z), numéricos (0–9), o especiales (_. $ @ # & ¢). El primer

carácter debe ser alfabético (A–Z).

name8

Un nombre de 1 a 8 caracteres, indiferentes a mayúsculas y

minúsculas. Consiste de caracteres alfabéticos (A–Z), numéricos (0–9), o especiales (_. $ @ # & ¢). El primer carácter debe ser alfabético

(A–Z).

4


id Este es un uso especial de un campo name16. Al ser solicitado, el valor debe ser único dentro de la pila TCP/IP para un grupo en

particular. Por ejemplo, usted sólo puede tener un DEFINE LINK

con un ID específico, pero un DEFINE HTTPD podría tener el mismo nombre porque está en un grupo diferente. Se utiliza para

identificar daemons, entradas de tablas y otros elementos que

deben ser identificados individualmente.

pubname Los nombres públicos no distinguen entre mayúsculas y minúsculas.

Cada pubname consiste en 1 a 6 segmentos de 1 a 8 caracteres cada uno. Los segmentos están separados por puntos (.), diagonales (/) o

diagonales inversas (\). Cada segmento debe comenzar con una letra

(A–Z). El resto de los caracteres pueden ser letras, números o caracteres especiales (_ - $ @ #).

member

Esto representa un miembro en una librería VSE. No distingue

entre mayúsculas y minúsculas y tiene una longitud de 1 a 8 caracteres, sin contar la extensión de 1 a 8 caracteres. Los archivos

a transferir son localizados indicando la ubicación de su sistema de

archivos. Los archivos que contienen definiciones y comandos

TCP/IP se localizan utilizando la cadena de búsqueda de la partición, no el sistema de archivos TCP/IP.

ext El parámetro ext indica la extensión de nombre de un miembro de la librería VSE. No distingue entre mayúsculas y minúsculas, y puede

tener de 1 a 16 caracteres de longitud.

5


port Un número de puerto TCP/IP. Los protocolos UDP y TCP utilizan

números de puerto para establecer comunicaciones con clientes y

servidores remotos específicos. Los números varían de 1 a 65635.

Cuando el "0" es utilizado, la pila automáticamente sustituye un número apropiado sin usar.

Al especificar un número de puerto como parámetro, no utilice

comas. Dependiendo de la aplicación, las comas pueden tener un significado especial. Por ejemplo, en el comando FTP PORT, el

número de puerto se especifica como dos números decimales (0–

255) separados por una coma. Para obtener el verdadero número de

puerto, estos dos campos se convierten en un byte hexadecimal cada uno, se concatenan en un campo de dos bytes y luego se vuelven a

convertir en un solo número decimal.

ip4addr

Las direcciones IPv4 consisten en cuatro números decimales

separados por puntos. Cada campo numérico varía de 0 a 255.

Puede incluir ceros al principio en cada campo si así lo desea.

ipaddr

Una dirección IPv4.

host

Un nombre de host de acuerdo a los estándares DNS o a una dirección IP.

num

Un valor numérico.

sec

Tiempo en segundos.

sec300

Tiempo en unidades de 300 segundos.

msec

Tiempo en milisegundos.

min

Tiempo en minutos.

6

2 Resumen de Sintaxis

La siguiente tabla resume la sintaxis de cada comando. Puedes utilizarla

como una rápida referencia.

Comando Argumentos

ACCess Query CLEAR ALlow,IPaddress = ip4addr PRevent,IPaddress = ip4addr

ASECUrity [,ICMP={YES|NO}] [,FTPD={YES|NO}] [,WEBL={YES|NO}] [,FTPC={YES|NO}] [,ARP={YES|NO}] [,IPAV={YES|NO}] [,BLOCKIP={YES|NO}] [,BLOCKCNt=num] [,SCAN={YES|NO}]

AUTOLoad {ON|OFF]}

CHECKSum {SOftware|HArdware|OFf}

CLOSe FILE PUBlic=pubname

CONNECT_Sequence {ON|OFF}

CONSOLE_Hold {ON|OFF}

DEFine ADAPter LINKid=id ,IPaddr=ip4addr ,TYPe={ETHERnet|TOKEN_ring| FDDI} [,NUMber=0] [,MTU=num]

DEFine ALTip ID=id ,IPaddr=ip4addr

DEFine CGI PUBlic=member ,TYPE={CGI|CGI-BAL|CGI-REXX}

7

Capítulo 2 Resumen de Sintaxis

Comando Argumentos

DEFine Event ID=id [,ACTion={Lpr|Ftp|EMAIL}] [,CLass=X] [,Queue={Lst|Pun|Rdr}] [,REtry=1] [,RETRY_Time=45s] [,HOSTname={USERinfo|DEST|ROOM|DEPT|BLDG|NONE}] [,SINGle={Yes|No}] [,USErid=$EVENT] [,PASSword=$EVENT] [,PRIOrity={Yes|No}] [,ORDEr={Yes|JOBNUMber|No}] [,POWERSYSid=sysid] [,JECLscript={YES|NO}] [,SCRIPTtype=L|type] [,SCRIPTName=name] [,NULLfile={Skip|Ignore|Process|Fail|Delete}] [,FCBPrefix=string4]

DEFine FILE TYPe={ESDS|KSDS|SAM|LIBrary|ICCF|POWer| VSAMCAT|VTOC|HFS|DSPACE|BIM-EDIT|CONDOR| FALCON|TAPE|VOLLIE} [,DLBL=name8] ,PUBlic=pubname [,DRIVer=member] [,ALLOWsite={Yes|No} [,READonly={Yes|No}] [,CC={Yes|No}] [,TRcc={YES|NO}] [,CRlf={Yes|No}] [,RECFm=F|FB|V|VB|S|SV|SU|SB] [,LRECL=num] [,BLKsize=num] [,GID=snum] [,UID=snum][,TRANslate=name16] [,SITE={Yes|No}][,DBLOCKS=num] [,EXT=name8] [VOLid=volser] [,CIPHER={NULL-SHA1|SDESCBC-NULL| SDESCBC-SHA1|TDESCBC-NULL| TDESCBC-SHA1|AES128C-NULL| AES128C-SHA1|AES192C-NULL|AES192C-SHA1|AES256C-NULL| AES256C-SHA1|KEYMASTER}] [,CIPHERKEY=CIALHFSK]

DEFine FILEIO TYPe={ESDS|KSDS|SAM|LIBrary|ICCF|POWer| VSAMCAT|VTOC| HFS|DSPACE|BIM-EDIT|TAPE} [,DRIVer=phase-name]

DEFine FTPd ID=id [,PORT=21] [,MAXACTive=3] [,UNIX={Yes|No|Binary}] [,TRANslate=name16] [,TIMEOut=2m] [,BSize=64K] [,WELCOME=member] [,EXTtypes={Yes|No}] [,EXTRADATA={FAIL|WARN|IGNORE|ACCEPT}] [,DYNfiles={Yes|No}] [,ALLowabort={Yes|No}] [,HESitate=0] [,IDLEtimeout=0] [,SITELAST={Yes|No}] [,SSL={YES|NO|YESCLAuth}] [,SSLKEY=member] [,SSLVERsion={SSL30|TLS10|TLS11|TLS12}] [,SSLCIPHER={ALL|WEAK|STRONG|AES|DES|NULL|HARDware| MEDIUM}]

[,SSLDATAconn={CLEAR|PRIVATE}] [,ZEROerr={Yes|No}] [,IPaddr=ip4addr] [,JOURnal={Yes|No}] [,UPPERcase={Yes|No}] [,SENDFast={Yes|No}] [,REXX={Yes|No}] [,SENDWack={Yes|No}] [,SSLMODE={IMPLICIT|EXPLICIT}]

8


Comando Argumentos

DEFine GPSd ID=id ,IPaddr=host ,TERMname=lu [,ALTlength=132] [,BRACKet_eject={Yes|No}] [,CMDn=string] [,CONTrol_order=NFU] [,DEBug={Yes|No}] [,EMULate={3287|Transparent}] [,INSerts=member] [,INSESsion={No|Yes}] [,LINELength=132] [,LOG={No|Yes}] [,LOGMode=mode] [,MAXChars=1m] [,MAXIdle=10s] [,MAXLines=10k] [,MAXPages=1k] [,NRT=60s] [,NRC=3] [,NOEJect={No|Yes}] [,OUTput={Lpr|Direct}[,PORT=515]] [,PRinter=name] [,Queuing={Disk|Memory}] [,STORage=pubname] [,TARGet=appl] [,TRANslate=name16] [,TYPE=VTAM] [,VRC=10] [,VRT=60s]

DEFine HTTpd ID=id ,ROOT=pubname [,PORT=80][,CONfine={Yes|No}] [,TRANslate=name16] [,TIMEOut=5m] [,SECure={Yes|No}] [,LIBrary=pubname ,SUBlibrary=name8]

DEFine LINK ID=id ,IPaddr=ip4addr ,TYpe={CLAW|LCS|CTCa|OSAX|IPNET} [,DEVices=hexaddr] [,SYSid=num] [,MTU=num] [,FORCe] [,OUTBuffers=4] [,HOSTName=name8] [,HOSTAppl=TCPIP] [,WSName=name8] [,WSAppl=name8] [,INFactor=4] [,OUTFactor=4] [,RETRY_Time=time] [,STOPPED] [,STOPLan={Yes|No}] [,SHUTdown={Yes|No}] [,VMReset={Yes|No}] [,ALTIP=(ip4addr [,ip4addr,...,ip4addr])] [,ROUTER=None|Primary|Secondary}] [,OSAPort={0|1] [,DATapath=cuu] [,PORTName=name8]

DEFine LOG ID=id ,TYPE={PRinter} ,LOGICALUnit=lunit [,LINELength=num] [,TIMEstamp={Left|Right|None}] [,routes]

DEFine LPD PRinter=name16, Queue=pubname [,LIBrary=pubname1] [,SUBlibrary=name] [,TRANslate=name] [,HEXdump={YES|NO}] [,USERid=$LPD] [,PASSword=$LPD]

DEFine MASK NETwork=ip4addr, MASk=ip4addr

DEFine MENu ID=id, MEMber=member

DEFine NAME NAMe=name16 {[,IPaddr=ip4addr] | [,SCRipt=member]}

DEFine NTPd ID=id [,PORt=37] [,PRotocol={Udp|Tcp}] [,GMT=snum] [,ADJustment=snum]

DEFine PUBlisher ID=id ,IMODlist=member

9


Comando Argumentos

DEFine ROUTe ID=id ,LINKid=name16 [,ADAPter=0] ,IPaddr=ip4addr [,GATEway=ip4addr1] [,AFTer=id] [,MTU=num] [,MSS=num] [,CRETran=msec] [,DRETran=msec] [,FIXRetran={Yes|No}] [,MINRetran=msec] [,MAXRetran=msec] [,PULse=sec] [,WINdow=num] [,RPAuse=msec] [,RETRY=num]

DEFine SOTRACe ID=id [,IPaddr=ip4addr] [,PORT=port] [,SCOPE={All|Internal|External|Obsolete}] [,MAXData=60] [,PHASE=member] [,SIZe=500] [,KIND={TCP|UDP|FTP|CLIENT|TELNET}]

DEFine TELnetd ID=id ,TARget=name8 ,TERMname=luname [,COunt=num] [,BASE=1] [,TN3270E={Listener|Effector}] [,PORT=23] [,MENu=name16] [,LOGMode=S3270] [,LOGMODE3=D4B32783] [,LOGMODE4=D4B32784] [,LOGMODE5=D4B32785] [,IPaddr=0.0.0.0] [,BUFfersize=num] [,CLOSE={Always|Seldom}][,GENeric=name16] [,GRoup=name16] [,POOL={Yes|No}] [,DRIVer=TELNETD]

DEFine TLSd ID=id ,CERTLibrary=name8 ,CERTMember=name8 ,CERTSublibrary=name8 [,CIPher=09] [,MINVers={0300|0301|0302|0303}] [,PORT=443] [,PASSport=80] [,TYPE={1|2}]

DEFine TRACe ID=id [,IPaddr=ip4addr] [,PORT=port] [,SIZe=500] [,KIND={TCP|UDP|ICMP|ALL}]

DEFine TRANslation MEMber=member [,ENTry=name] [,NAMe=name16] [,DEFault=name16]

TYpe=Double ,MEMber=member ,AScii=name ,EBcdic=name ,NAMe=name16 [,DEFault=name16]

DEFault=name16

DEFine USEr ID=name16 [,PASSword=name16] [,DATA=any] [,GID=snum] [,UID=snum] [,MAILbox=str] [,FTP={YES|NO}] [,LPR={YES|NO}] [,WEB={YES|NO}] [,TELNET={YES|NO}] [,ROOT=path]

DELete ALTIP ID=id

DELete CGI PUBLIC=pubname

DELete EVENT {ID=id|ALL[,FORCE]}

DELete FILE PUBlic=pubname

DELete FILEIO ID=name

10


Comando Argumentos

DELete FTPd ID=id

DELETE GPSD ID=id

DELete HTTPd ID=id

DELete LINK ID=id

DELete LPD ID=id

DELete MASK NETwork=ip4addr

DELete MENu ID=id

DELete NAME NAME={name|DYNAMIC}

DELete NTPd ID=id

DELete PUBLisher ID=id

DELete ROUTe ID=id

DELete TELnetd ID=id

DELete TLSd ID=id

DELete TRACe DELete TRACES

ID=id

DELete USEr NAMe=id

DIAGnose {OFF|[-]keyword}

DISCover host

DOWNcheck {ON|OFF}

DUMP {ALL|BUFfers|BUS|CONnects|DIRectory|Events|EXITS| FRAgments|FREquests|FTPds|GIVesockets|GPSds|HTTpds|IVBlok| LINks|LPDs|MASks|MENus|NAMes|PARTITION|PROGrams|ROUtes| SOCkets|STAts|TASks|TELnetds|TIMERS|TLSds|TRACes| TRANslations|USErs|VERsions}

DUMPOption FILeio={Csi|Ibm|None}

11


Comando Argumentos

EMAIL [,SMTPd=ip4addr] [,ATsign=7C] [,FRom=string64] [,DESTination=string64] [,REPlyto=string64] [,RPORT=25] [,SUBject=string64] [,USERid=$EMAIL] [,PASSword=$EMAIL] [,LUSERid=$EMAIL] [,LPASSword=$EMAIL] [,TRANslation=name16] [,TRAttachments=name16] [,TRMail=name16] [,CHECKname={Yes|No}] [,GMT=snum]

EXECute member

EXTPGVS {ON|OFF}

FIREWALL {ON|OFF|LOAD [PHASE=phase-name]|WARN|FAIL|MSGON|MSGOFF| DEBUGON|DEBUGOFF|REPORT|ALLOW|BLOCK}

FLUSH ip4addr [,port]

FTPBatch_fetch {ON|OFF}

GATEway {ON|OFF}

IBBLok [RELEase|RESET|CLear] [,{SIZE=num|,MTU=num}] [,FREE=num] [,STORage=num|PERcent=percent]

INCLude member [,DELAY]

IPSTAT {ON|OFF}

ISOLAtion {ON|OFF}

LISTIDCAMS {ON|OFF}

LOCAL_DLBL {ON|OFF}

MESsage (or MSG) MSGID=msgid [Console={Yes|No}] [Log={Yes|No}] [SCROLlable={Yes|No}]

MODify CONsole [,LINELength=num] [,TIMEstamp={Left|Right|None}] [,routes]

12


Comando Argumentos

MODify FILE PUBlic=pubname [,TYPe={ESDS|KSDS|SAM|LIBrary|ICCF|POWer|VSAMCAT|VTOC| HFS|DSPACE|BIM-EDIT|CONDOR|FALCON|VOLLIE|TAPE}] [,DLBL=name8] [,DRIVer=member] [,ALLOWsite={Yes|No}] [,READonly={Yes|No}] [,CC={Yes|No}] [,TRcc={YES|NO}] [,CRlf={Yes|No}] [,RECFm=F|FB|V|VB|S|SV|SU|SB] [,LRECL=num] [,BLKsize=num] [,GID=snum] [,UID=snum] [,TRANslate=name16] [,SITE={Yes|No}] [,DBLOCKS=num] [,EXT=name8] [VOLid=volser] [,CIPHER={NULL-SHA1| SDESCBC-NULL|SDESCBC-SHA1|TDESCBC-NULL|TDESCBC-SHA1| AES128C-NULL|AES128C-SHA1| AES192C-NULL|AES192C-SHA1| AES256C-NULL|AES256C-SHA1| KEYMASTER}] [,CIPHERKEY=CIALHFSK]

MODify LOG ID=id [,LINELength=num] [,TIMEstamp={Left|Right|None}] [,routes]

MODify ROUTe ID=id [,LINKid=name16] [,NUMber=0] [,IPaddr=ip4addr] [,GATEway=ip4addr1] [,AFTer=id] [,MTU=num] [,MSS=num] [,CRETran=msec] [,DRETran=msec] [,FIXRetran={Yes|No}] [,MINRetran=msec] [,MAXRetran=msec] [,PULse=sec] [,WINdow=num] [,RPAuse=msec] [,RETRY=num]

PING host

PING_Message {ON|OFF}

PORTQueue PORT=port [,TIMEOUT=sec] [,DEPTH=num]

PORTRange LOw=port ,HIgh=port

Query ACTive [,SYSLST] TYPe={TELnetd|FTPd|LINK|ALL}

Query ALL [,SYSLST]

Query ALTips [,SYSLST]

Query ARPs [,SYSLST] [,IPaddr=ip4addr]

Query CGIs [,SYSLST] [,PUBlic=pubname]

Query CONnections [,SYSLST] [,IPaddr=ip4addr] [,FPort=port] [,LPort=port] [,STate={Listen|Established}] [,EXTended] [,Trace]

Query DIAGnose [,SYSLST]

Query DUMPoptions [,SYSLST]

Query EMAil [,SYSLST]

13


Comando Argumentos

Query Events [,SYSLST] [,ID=id] [,DETail]

Query EXTERNAL [,SYSLST]

Query EXTtypes [,SYSLST]

Query FILEIo [,SYSLST]

Query Files [,SYSLST] [,PUBlic=pubname]

Query FIREWALL [,SYSLST]

Query FRAGments [,SYSLST]

Query FTPds [,SYSLST] [,ID=id] [,EXTended]

Query GPSD [,SYSLST] [,ID=id]

Query HOME [,SYSLST]

Query HTtpds [,SYSLST] [,ID=id]

Query IBbloks [,SYSLST]

Query IPSTAT [,SYSLST]

Query ISTATistics [,SYSLST]

Query LINks [,SYSLST] [,ID=id]

Query LOCKs [,SYSLST]

Query LOGs [,SYSLST]

Query LPds [,SYSLST] [,ID=id]

Query MASKs [,SYSLST]

Query MENus [,SYSLST]

Query NAMes [,SYSLST] [,TYPe={ALL|STATIC|DYNAMIC}]

Query NTPd [,SYSLST] [,ID=id]

Query OPENfiles [,SYSLST]

Query OPTions [,SYSLST]

14


Comando Argumentoss

Query PORTqueue [,SYSLST]

Query PRODkeys [,SYSLST] [,ALL]

Query PROGrams [,SYSLST]

Query PUBLishers [,SYSLST] [,ID=id]

Query ROUTes [,SYSLST] [,ID=id|IPaddr=ip4addr]

Query SECURity [,SYSLST]

Query SET [,SYSLST]

Query STATistics [,SYSLST]

Query STOR [,SYSLST] [SAVe|TRend|MAXimum]

Query TASKs [,SYSLST] [,ID=hexnum|NAMe=name] [,EXTENDED]

Query TELnetds [,SYSLST] [,ID=name]

Query TLSDs [,SYSLST] [,ID=id]

Query TRACes [,SYSLST]

Query TRANslations [,SYSLST]

Query TRUSted [,SYSLST]

Query USERs [,SYSLST] [,NAMe=name]

Query VERsions [,SYSLST]

QUIESce {ON|Off}

RAPTRAC START|REPORT|STOP

RECord {ON|OFF}

REDefine START

RELOad {EXTtypes|HACKlist|TERMtypes}

RESume tasknum

15


Comando Argumentos

SECURity [ON|OFF] [,BATCH={ON|OFF}] [,PHASE=member] [,XDATA=string] [,ADATA=string] [,ASMDATE=string] [,ASMTIME=string] [,VERSION=string] [,AUTO={ON|OFF}] [,EXIT={ON|OFF}] [,ARP={ON|OFF}] [,MODE={WARN|FAIL}] [,LOGGING={ALL|FAIL|NONE}] [,DUMP=ALL|FAIL|NONE}] [,LOCK]

SEGment [NEW]

SEParator_pages {OFF|ON|[-]Email|[-]FTp|[-]HTtp|[-]LPr}

SET AUTO_TIME=sec300

SET CONSOLE_PORT=port

SET DEFAULT_DOMAIN=string

SET DIAGNOSE {NOCONSOLE|CONSOLE}

SET DNSn=ip4addr

SET DNSTn=sec300

SET FIXED_RETRansmit {ON|OFF}

SET IPaddr=ip4addr

SET LINK_retry=time

SET MASK=ip4addr

SET MAX_Email_events=num

SET MAX_Ftp_events=num

SET MAX_Lpr_events=num

SET MAX_Segment=num

SET MAXIMUM_MESSAGES=num

SET PAGE_COunt=num

SET PASSword=string

SET POWERPassword=string8

SET POWERUserid=string8

16


Comando Argumentos

SET PULse_time=sec300

SET RETransmit=time

SET TELNET_Translate=name16

SET TELNETD_BUFFers=num

SET TELNETD_BUFSize=num

SET WINdow=num

SHUTdown [Immediate]

SINGledest {ON|OFF}

SPINcheck {ON|OFF}

START [LINKid=id]

STEALTH {ON|OFF}

STOP [LINKid=id]

SUSPend Taskid

TRACert host

TRAFFic {ON|OFF|FULL}

TRUSt {ADD|DELete} ,IPaddress=ip4addr

Upcase {ON|OFF}

VERIFY_MEMORY {ON|OFF}

WAITfor {Vtam|TIME=nn}

17

3 Descripción de Comandos

Las páginas de este capítulo contienen la información complete de referencia para los comandos de TCP/IP FOR VSE.

Una tabla a modo de resumen de comando precede el primer

comando. Esta tabla contiene una breve descripción de cada

comando.

18

Capítulo 3 Descripción de Comandos: Lista Resumen

Lista Resumen

Los comandos de TCP/IP FOR VSE son resumidos en la siguiente tabla.

Comando Descripción

ACCESS Controla el acceso a VSE por dirección IP

ASECURITY Configura la Salida de Seguridad Automática

AUTOLOAD Determina la carga automática de controladores de

archivos I/O cuando los archivos son definidos

CHECKSUM Controla cómo las sumas de verificación son calculadas

CLOSE FILE Cierra un archive abierto

CONNECT_SEQUENCE Controla si las solicitudes de conexión se asignan

mediante la verificación del patrón de la dirección IP

CONSOLE_HOLD Mantiene un aviso de comando en la consola

DEFINE ADAPTER Crea una definición de adaptador dentro del alcance de un

DEFINE LINK

DEFINE ALTIP Causa que la pila monitoreé y responda a las solicitudes

ARP por direcciones de inicio adicionales

DEFINE CGI Carga un programa CGI y lo pone a disposición para su uso

DEFINE EVENT Monitorea una clase POWER para la distribución automática de

reportes

DEFINE FILE Define un archivo en el sistema de archivos TCP/IP y lo asocia con un controlador I/O de archivo

DEFINE FILEIO Carga una fase de controlador I/O de archivo para un tipo de

archivo en el almacenamiento

DEFINE FTPD Crea un daemon de protocolo de transferencia de archivos

DEFINE GPSD Crea un daemon de servidor de impresión general

DEFINE HTTPD Crea un daemon de protocolo de transferencia de hipertexto

(servidor web)

DEFINE LINK Crea un enlace entre TCP/IP y una red o una pila conectada

directamente

DEFINE LOG Crea un archivo de registro del sistema

DEFINE LPD Crea un daemon de impresora en líneas

DEFINE MASK Crea una máscara de subred para una red particular



19

DEFINE MENU Carga un archivo de menú y lo hace disponible para ser usado por los daemons telnet

DEFINE NAME Asocia un nombre TCP/IP con una dirección IP o un

archivo de script

DEFINE NTPD Crea un daemon de servidor de tiempo de red

DEFINE PUBLISHER Crea un daemon de publicación

DEFINE ROUTE Añade una entrada a la tabla de enrutamiento TCP/IP

DEFINE SOTRACE Inicia un rastreo de socket

DEFINE TELNETD Crea un daemon TN3270 o TN3270E

DEFINE TLSD Crea un daemon SSL/TLS

DEFINE TRACE Inicia un trazo de datagrama

DEFINE TRANSLATION Carga y controla las tablas de traducción ASCII/EBCDIC

DEFINE USER Crea una ID de usuario y contraseña

DELETE ALTIP Elimina una dirección de inicio alternativa

DELETE CGI Elimina un programa CGI del almacenamiento

DELETE EVENT Termina el monitoreo de una clase POWER

DELETE FILE Elimina un archivo del sistema de archivos TCP/IP

DELETE FILEIO Elimina una fase del controlador I/O de archivo del

almacenamiento

DELETE FTPD Termina un daemon de protocolo de transferencia de archivos

DELETE GPSD Termina un daemon de servidor de impresión general

DELETE HTTPD Termina un daemon de protocolo de transferencia de

hipertexto (servidor web)

DELETE LINK Elimina un enlace entre TCP/IP y una red o una pila conectada directamente

DELETE LPD Termina un daemon de impresora en línea

DELETE MASK Elimina una máscara de subred para una red en particular

DELETE MENU Elimina un archivo de menú TN3270 de la memoria

DELETE NAME Elimina un nombre simbólico TCP/IP



20

DELETE NTPD Termina un daemon de servidor de tiempo de red

DELETE PUBLISHER Termina un daemon de editor

DELETE ROUTE Elimina una entrada de la tabla de enrutamiento de red

DELETE TELNETD Termina un daemon TN3270 o TN3270E

DELETE TLSD Termina un daemon SSL/TLS

DELETE TRACE Termina un rastreo y libera su almacenamiento

DELETE USER Elimina una entrada de ID de usuario y contraseña

DIAGNOSE Controla las opciones de visualización de diagnóstico

DISCOVER Determina el "mejor" tamaño de MTU para un host remoto

DOWNCHECK Controla el aviso de seguridad para el comando SHUTDOWN

DUMP Volcado formateado de varios bloques de control TCP/IP

DUMPOPTION Controla el formato de los volcados de almacenamiento

iniciados por TCP/IP

EMAIL Establece opciones predeterminadas globales para el cliente

EMAIL

EXECUTE Ejecuta un script de comando de operador

EXTPGVS Controla si las solicitudes de socket de partición

externa se asignan en el almacenamiento de partición

privada de 31 bits o en el almacenamiento GETVIS

del sistema de 31 bits.

FIREWALL Controla y monitorea la característica opcional de Firewall

Shield

FLUSH Termina todo el procesamiento con un host remoto específico

FTPBATCH_FETCH Determina el uso automático del programa FTPBATCH

cuando se solicita el programa por lotes FTP

GATEWAY Controla el reenvío de datagramas no destinados a la pila VSE

IBBLOK Controla la asignación y retención de Bloques de Buffer

de Internet

INCLUDE Incluye un miembro de la librería en el conjunto de

parámetros de inicialización

IPSTAT Controla si se asigna un ISBLOK para cada dirección IP que accede a la pila

ISOLATION Evita que se cumplan las solicitudes de conexión entrantes



21

LISTIDCAMS Para VSAMCAT: controla si los resultados de las

operaciones DELETE/DEFINE CLUSTER de un IDCAMS

de llamada se envían a SYSLST

LOCAL_DLBL Controla si los servidores internos (DEFINE FTPD)

permiten a los usuarios remotos FTP especificar archivos VSE utilizando un DLBL local

MESSAGE Controla la supresión de mensajes

MODIFY CONSOLE Controla cómo se muestran los mensajes en la consola; es

un atajo para MODIFY LOG,ID=CONSOLE

MODIFY FILE Cambia los parámetros y las características de una

entrada en el sistema de archivos TCP/IP

MODIFY LOG Cambia las características de un archivo de registro del sistema

MODIFY ROUTE Cambia valores en una entrada existente en la tabla de rutas

OPENCHECK Habilita una verificación periódica de archivos abiertos

por varios procesos

PING Emite una solicitud de eco ICMP (PING)

PING_MESSAGE Controla el mensaje de consola "solicitud de ping recibida"

PORTQUEUE Controla cómo se ponen en fila las solicitudes de

conexión entrantes para una aplicación

PORTRANGE Controla el rango para la asignación de puertos dinámicos

QUERY ACTIVE Muestra el estado de los daemonss activos

QUERY ALL Emite todos los comandos QUERY

QUERY ALTIPS Muestra todas las direcciones IP alternativas

QUERY ARPS Muestra el contenido actual de la tabla ARP

QUERY CGIS Muestra todos los programas CGI disponibles actualmente

QUERY CONNECTIONS Muestra el estado de una o más conexiones

QUERY DIAGNOSE Muestra la configuración de diagnóstico actual

QUERY DUMPOPTIONS Muestra opciones para volcados producidos por TCP/IP

QUERY EMAIL Muestra la configuración del cliente EMAIL

QUERY EVENTS Muestra el estado del procesamiento de automatización.



22

QUERY EXTERNAL Muestra información sobre particiones externas a TCP/IP

QUERY EXTTYPES Muestra el contenido de la tabla de Tipos Externos

QUERY FILES Muestra el contenido del sistema de archivos TCP/IP

QUERY FILEIO Muestra el estado de los programas del controlador I/O de

archivo.

QUERY FIREWALL Muestra la configuración actual del firewall que se aplica.

QUERY FRAGMENTS Muestra el estado del reensamblaje de datagramas

fragmentados.

QUERY FTPDS Muestra el estado de los daemons del protocolo de

transferencia de archivos.

QUERY GPSDS Muestra el estado de los daemons del servidor de impresión

general.

QUERY HOME Muestra todas direcciones IP en la tabla "Dirección de Inicio"

QUERY HTTPDS Muestra el estado de los daemons del protocolo de

transferencia de hipertexto (Servidor web)

QUERY IBBLOKS Muestra la configuración y las estadísticas de IBBLOK

QUERY IPSTAT Muestra estadísticas de direcciones IP almacenadas en ISBLOK.

QUERY ISTATS Muestra estadísticas que detallan las funciones internas de la pila

QUERY LINKS Muestra el estado de los enlaces de red

QUERY LOCKS Muestra el estado actual de bloqueo

QUERY LOGS Muestra consolas/registros disponibles, junto a propiedades

QUERY LPDS Muestra el estado de los daemons de la impresora de líneas

QUERY MASKS Muestra todas las máscaras de subred definidas por número de red

QUERY MENUS Muestra los menús disponibles para uso con TN3270

QUERY NAMES Muestra los nombres TCP/IP y sus valores asociados.

QUERY NTPDS Muestra el estado de los daemons NTP

QUERY OPENFILES Muestra una lista de archivos que están abiertos actualmente

QUERY OPTIONS Muestra los valores actuales de los parámetros modificables

QUERY PORTQUEUE Muestra estadísticas de solicitudes de conexión en fila

QUERY PUBLISHER Muestra el estado del daemon editor



23

QUERY PRODKEYS Muestra las claves de producto TCP/IP que se utilizan, los nombres de los productos con licencia y las fechas de

vencimiento de las claves

QUERY PROGRAMS Muestra las fases del programa que usa TCP/IP, sus

características, sus ubicaciones de memoria y la librería

desde la que se cargó cada una

QUERY ROUTES Muestra el contenido de la tabla de enrutamiento de red o la ruta tomada para llegar a una dirección específica

QUERY SECURITY Muestra la configuración de seguridad actual

QUERY SET Sinónimo de QUERY OPTIONS

QUERY STATISTICS Muestra un resumen de la información relacionada con la pila

QUERY STOR Muestra información detallada sobre el uso de la memoria

QUERY SUSPENDED Muestra una lista de tareas suspendidas

QUERY TASKS Muestra una lista de pseudo tareas

QUERY TELNETDS Muestra los daemons TN3270 y TN3270E

QUERY TLSD Muestra los daemons TLS actualmente activos

QUERY TRACES Muestra una lista de rastreo actualmente en ejecución

QUERY TRANSLATES Muestra una lista de las tablas de traducción disponibles

QUERY TRUSTED Muestra las direcciones IP "confiables" actualmente

QUERY USERS Muestra una lista de ID de usuario definidos

QUERY VERSIONS Muestra las versiones y los niveles de mantenimiento

de los componentes de la pila

QUIESCE Evita nuevas conexiones mientras permite que las

conexiones existentes continúen

RAPTRAC emite datos de seguimiento de procesos para el Soporte

Técnico de CSI

RECORD Controla la grabación de estadísticas de pseudo tareas en

SYSLST

REDEFINE Permite redefinir un daemon basado en parámetros

previamente ingresados

RELOAD Recarga una tabla interna

RESUME Reanuda el procesamiento de una pseudo tarea suspendida



24

SDOPEN_EXTRA Controla pruebas adicionales para garantizar que

un archivo SAM se abrió correctamente

SECURITY Controla las funciones de seguridad TCP/IP

SEGMENT Segmenta los archivos SYSLST y de registro, haciéndolos

disponibles para imprimir

SEPARATOR_PAGES Controla la generación de páginas de separación POWER

SET AUTO_TIME Determina cuándo la automatización debe verificar las filas

POWER

SET DEFAULT_DOMAIN Establece un nombre de dominio que se agregará

automáticamente a los nombres no calificados

SET DIAGNOSE Habilita la visualización de mensajes DIAGNOSE en la consola

SET DNSn Define un servidor de nombres de dominio (DNS) para la

resolución de nombres

SET DNSTn Controla el valor de tiempo de espera para el DNS indicado

SET FIXED_RETRANSMIT Controla la configuración predeterminada para el parámetro

FIXRETRAN = en DEFINE ROUTE

SET IPADDR Establece la dirección de inicio predeterminada para la pila

SET LINK_RETRY Determina el intervalo de tiempo predeterminado entre

intentos de reinicializar un enlace de red fallido

SET MASK Establece una máscara de subred predeterminada

SET MAX_EMAIL_EVENTS Establece el número máximo de eventos EMAIL simultáneos

para el procesamiento de automatización

SET MAX_FTP_EVENTS Establece el número máximo de eventos FTP simultáneos


SET MAX_LPR_EVENTS Establece el número máximo de eventos LPR simultáneos


SET MAX_SEGMENT Controla la configuración predeterminada para el Tamaño

Máximo de Segmento entrante (MSS= parámetro en DEFINE

ROUTE)

SET MAXIMUM_MESSAGES Establece el número máximo de mensajes en fila (no

impresos) del sistema en SYSLOG

SET PASSWORD Establece una contraseña para ingresar comandos de consola

SET POWERPASSWORD Establece la contraseña para el acceso POWER



25

SET POWERUSERID Establece la ID de usuario para el acceso POWER

SET PULSE_TIME Establece el valor predeterminado para el intervalo entre sondas

de conexiones inactivas (PULSE= en DEFINE ROUTE)

SET RETRANSMIT Establece el valor predeterminado para los parámetros

CRETRANS= y DRETRANS= en DEFINE ROUTE

SET TELNET_TRANSLATE Establece el nombre de la tabla de traducción que se

utilizará con las conexiones Telnet (no TN3270)

SET TELNETD_BUFFERS Establece el tamaño del grupo de buffers compartido por

los daemons TN3270

SET TELNETD_BUFSIZE Determina el tamaño de los buffers TN3270 individuales

SET WINDOW Establece el tamaño predeterminado para la ventana de

entrada TCP (parámetro WINDOW= en DEFINE ROUTE)

SHUTDOWN Termina el procesamiento y apaga la pila

SINGLEDEST Determina cómo el procesamiento de automatización

maneja múltiples informes en fila para el mismo destino (host).

SPINCHECK Controla cómo TCP/IP monitorea las pseudo tareas desbocadas

START Inicia el motor de despacho TCP/IP o un enlace de red

"detenido"

STEALTH Controla si una solicitud de conexión rechazada se restablece

o se ignora

STOP Detiene el motor de despacho TCP/IP

SUSPEND Detiene el procesamiento por una pseudo tarea

TRACERT Muestra cada "salto" en una ruta junto con el tiempo

requerido para llegar a éste

TRAFFIC Controla qué tráfico de red permite la entrada a la pila

TRUST Establece que una dirección IP es confiable y se debe ignorar la actividad sospechosa

UPCASE Determina si la consola y los mensajes de registro se muestran en mayúsculas o minúsculas o se fuerzan a

mayúsculas

VERIFY_MEMORY Controla el monitor de almacenamiento

WAITFOR Hace que el proceso de inicialización espere un evento específico

26

Capítulo 3 Descripción de Comandos: ACCES

ACCESS

Sintaxis

El comando ACCESS puede ser utilizado para restringir el acceso a

direcciones IP de host remotas basadas en VSE. También muestra

direcciones bloqueadas.

ACCESS {Query| CLEAR| ALlow,IPaddress = ip4addr |

PRevent,IPaddress = ip4addr}

Argumentos

Ejemplo

Notas


Query Muestra direcciones actualmente en modo “prevenir”.

CLEAR Elimina todas las direcciones actualmente en modo “prevenir”.

ALlow Remueve las direcciones especificadas del modo “prevenir”.

PRevent Añade la dirección especificada a la tabla de direcciones de la

cual el tráfico no será aceptado.

Las siguientes notas aplican al comando:

Algunos procesos internos TCP/IP añaden automáticamente una

dirección a la tabla “prevenir” si se detecta un intento de hack.

La salida de seguridad puede especificar que se agregue

una dirección a la tabla "prevenir".

Ante de que una dirección pueda agregarse automáticamente a la

tabla “prevenir”, la dirección debe realizar un intento de conexión.

ASECURITY

Configura la Salida de Seguridad Automática.

SECURITY

Controla las funciones de seguridad TCP/IP.

STEALTH

Controla si una solicitud de conexión rechazada es reiniciada o ignorada.

access prevent,ip=192.168.1.66 IPI107I All traffic with 192.168.1.66 will be prevented

access clear IPI110I All traffic with 192.168.1.66 will be allowed IPI108I Access CLEAR complete

27

Capítulo 3 Descripción de Comandos: ASECURITY

ASECURITY

Sintaxis

El comando automático SECURITY proporciona muchas de las

características de una salida de seguridad personalizada sin necesidad de

programar una salida.

ASECUrity [,ICMP={YES|NO}] [,FTPD={YES|NO}]

[,FTPC={YES|NO}] [,ARP={YES|NO}]

[,IPAV={YES|NO}] [,BLOCKIP={YES|NO}]

[,BLOCKCNt=count] [,SCAN={YES|NO}]

[,WEBL={YES|NO}]

Argumentos ICMP= Este parámetro controla cómo responde la pila a las solicitudes PING.

YES Permite respuestas normales a las solicitudes ICMP ECHO (ping).

NO Impide que VSE responda a las solicitudes entrantes de ICMP PING. Esto es útil para detener los "barridos de ping", que se

usan comúnmente para encontrar máquinas activas en una red

TCP/IP. Esta configuración no afecta a las solicitudes de ping que se originan en VSE.

FTPD= Este parámetro controla cómo se manejan los intentos de iniciar

una sesión FTP.

YES Permite una conexión normal daemons FTP.

NO Impide nuevas sesiones FTP. Las sesiones ya establecidas no

se ven afectadas. Controla las solicitudes de conexión al

daemon FTP y bloquea el mensaje de bienvenida del sistema 220. Esto se puede usar para detener temporalmente nuevas

sesiones FTP.

FTPC= Al igual que con FTPD=, este parámetro permite establecer

una conexión FTP, pero hace que los comandos sean rechazados con un mensaje de "Comando 500 rechazado".

YES Los comandos se procesan normalmente.

NO Los siguientes comandos son rechazados: USER, PASS, ACCT, QUIT, REIN, SYST, HELP, NOOP, PBSZ, PROT, y

AUTH.

28


ARP= Este parámetro controla cómo la pila responde a las solicitudes ARP. Podría ser útil para detener toda la actividad entrante actual

debido a un ataque ARP.

YES Permite una respuesta ARP normal.

NO Requiere que SECURITY ARP= ON esté vigente. TCP/IP no

responde a las solicitudes ARP.

IPAV= Este parámetro controla todo el tráfico IP entrante (datagramas IP).

YES Permite el procesamiento normal de IP.

NO Requiere que SECURITY IP= ON esté vigente. Especificar

"NO" inmediatamente evita el procesamiento de todos los

datagramas de IP entrantes. Este es un paso drástico, pero que

podría ser útil si hay un ataque de Internet en curso.

BLOCKIP= Permite el bloqueo automático de una dirección IP después de

alcanzar un número permitido de violaciones de seguridad. Este número lo establece BLOCKCNt=. El comando ACCESS

puede usarse para restablecer el bloque para una dirección IP.

YES Bloquee automáticamente una dirección IP específica

después de las violaciones de seguridad BLOCKCNt. Este

es el valor predeterminado.

NO No bloquea automáticamente el acceso por dirección IP.

BLOCKCNt= Este es el valor utilizado por BLOCKIP para determinar la cantidad máxima de violaciones de seguridad antes de bloquear la

dirección IP. El recuento puede variar de 1 a 255. El valor

predeterminado es cero (nunca).

SCAN= Esta es la solicitud HTTPD Scanblock.

YES Si un usuario remoto intenta abrir una conexión al daemon

HTTP, incluso parcialmente (medio abierto), y luego finaliza la conexión sin enviar ningún dato, TCP/IP FOR VSE rastrea este

evento y bloquea la dirección IP del usuario después de un

número predeterminado de dichas llamadas. El número máximo de dichas llamadas es siempre 3, a menos que BLOCKIP= YES

(el valor predeterminado) y BLOCKCNt estén configurados

29


en 1 o 2. Consulte también BLOCKIP=. Un mensaje

HTTP908W es emitido siempre cuando se intenta una conexión medio abierta. El comando ACCESS puede

usarse para restablecer el bloque para una dirección IP.

YES es el valor predeterminado.

NO Las direcciones IP no se bloquean después del número

predeterminado de llamadas medio abiertas.

WEBL= Esta es la Solicitud de Pantalla de Inicio de Sesión Web.

YES

El daemon HTTP mantiene un nivel mínimo de seguridad de acceso basado en la dirección de red. Para hacer esto, el

daemon mantiene una tabla de direcciones IP "activas", que son

las que han accedido recientemente a una página web específica, eliminando la necesidad de iniciar sesión en cada

enlace. Cuando se recibe una solicitud de una dirección que no

está en la tabla, el daemon muestra automáticamente una

página que solicita un ID de usuario y contraseña. Estos valores se verifican a través de los mecanismos estándar TCP/IP FOR

VSE.

Si es válida, la dirección IP se agrega a la tabla y se transmite la solicitud original. La dirección IP se elimina de la tabla cuando

se solicita explícitamente (una solicitud realizada por

"BLANKING.HTML") o cuando expira el temporizador de inactividad HTTPD (TIMEOUT=).

NO Ninguna revisión de seguridad automática es realizada.

Ejemplo Vea el manual de Mensajes TCP/IP FOR VSE para más información

sobre cada mensaje en este ejemplo.

asecurity icmp=yes,blockip=yes,blockcnt=10 IPN759I Security status change: Auto security changed ICMP=Y IPN759I Security status change: Auto security changed BLOCKIP=Y IPN473I Auto Security blocking by IP address Enabled IPN474I Auto Security blocking by IP address after 10 violations

30


Notas


Las siguientes notas aplican a este comando:

El uso de la Salida de Seguridad Automática está controlado

por el comando SECURITY. Una vez que haya seleccionado

las opciones con ASECURITY, deberá aún habilitar la salida con SECURITY.

Al bloquear direcciones IP, recuerde que los usuarios pueden estar

detrás de un enrutador que les hace "compartir" una sola dirección

IP.

Si utiliza la función de Seguridad Automática, asegúrese que

cualquier ID de usuario (DEFINE USER) tenga los valores correctos en el campo DATA=.

ACCESS

Controla el acceso a VSE por dirección IP.

DEFINE USER

Crea una ID de usuario y contraseña.

DELETE USER

Elimina una entrada de ID de usuario y contraseña.

ISOLATION

Previene que se cumplan las solicitudes de conexión entrantes.

PING_MESSAGE

Controla el mensaje de la consola "solicitud de ping recibida".

QUERY ARPS

Muestra el contenido actual de la tabla ARP.

QUERY SECURITY

Muestra la configuración de seguridad actual.

QUERY USERS

Muestra una lista de ID de usuarios definidos.

SECURITY


31

Capítulo 3 Descripción de Comandos: AUTOLOAD

AUTOLOAD

Sintanxis

Argumentos

El comando AUTOLOAD controla la carga del controlador de archivo.

Cuando un archivo es definido, TCP/IP normalmente verifica que el

controlador apropiado de I/O del archivo esté cargado e inicializado. Al deshabilitar la carga automática, los controladores de I/O de archivos

sólo se pueden cargar en DEFINE FILEIO.

AUTOLoad [ON|OFF]

ON

Los controladores de I/O de archivo se cargan e inicializan

cuando se define un archivo del tipo apropiado. Este es el valor predeterminado.

OFF Los controladores de I/O de archivo no se cargan e inicializan

automáticamente.

Ejemplo


DEFINE FILE Define un archivo para el sistema de archivos TCP/IP FOR VSE y lo

asocia con un controlador de I/O de archivo.

DEFINE FILEIO

Define un controlador de I/O de archivo para un tipo de archivo.

QUERY FILES

Muestra el contenido del sistema de archivos TCP/IP FOR VSE.

QUERY FILEIO

Muestra el estado de los programas del controlador de I/O de archivos.

autoload on IPN268I AutoLoad now set to On

32

Capítulo 3 Descripción de Comandos: CHECKSUM

CHECKSUM

Sintaxis

Argumentos

El comando CHECKSUM controla si TCP/IP FOR VSE calcula y

verifica las sumas de verificación en el tráfico entrante.

CHECKSum [SOftware|HArdware|OFf]

SOftware Las sumas de comprobación de los datagramas entrantes son

calculados y validados utilizando un algoritmo de software interno. Este es el valor predeterminado.

HArdware Las sumas de comprobación de los datagramas entrantes y

salientes se calculan y validan utilizando la instrucción

CHECKSUM de hardware. La instrucción CHECKSUM está

disponible en la mayoría de las CPU.

OFf Las sumas de verificación de los datagramas entrantes se ignoran.

Las sumas de comprobación de los datagramas salientes se siguen

calculando utilizando la última técnica especificada (hardware o software).

Ejemplo

Exposición


Las sumas de verificación son una parte vital del protocolo TCP/IP.

Ningún sistema de producción debería funcionar sin ellos. Debe

desactivar el cálculo de las sumas de verificación sólo cuando esté depurando una instalación o cuando esté intentando determinar qué

dispositivo de red está transmitiendo datos defectuosos.

QUERY OPTIONS

Muestra los valores actuales de los parámetros modificables.

checksum off IPN386I Inbound Checksum set OFF IPN300I Enter TCP/IP Command

checksum on IPN385I Inbound Checksum set ON

33

Capítulo 3 Descripción de Comandos: CLOSE FILE

CLOSE FILE

El comando CLOSE FILE le permite cerrar un archivo que fue abierto

por el sistema de archivos TCP/IP FOR VSE. Esto tipicamente es el

resultado de una condición anormal en la que el procesamiento no se completó, lo que provocó que un archivo VSAM, por ejemplo, sea

"propiedad" de la partición TCP/IP.

Sintaxis

Argumentos

Ejemplo

Notas


Este comando debe usarse sólo en circunstancias extraordinarias.

CLOSe FILE PUBlic=pubname

PUBlic= El nombre del archivo a cerrar.


Tenga mucho cuidado cuando emita el comando CLOSE FILE. No

se realiza ninguna comprobación para determinar si el archivo que se está cerrando está realmente en uso. Si cierra un archivo activo,

los resultados son impredecibles e indeseables. En general, la única

vez que debe usar CLOSE FILE es cuando falla un proceso FTP y

todos los demás métodos de limpieza no han tenido éxito.

Si varios procesos están utilizando un archivo, CLOSE FILE actúa en

la primera instancia que encuentra. Usted debe ejecutar el comando

varias veces para cerrar todas las instancias del archivo.

QUERY FILES


QUERY OPENFILES

Muestra una lista de archivos que están abiertos actualmente.

close file,pub=ewf.save.t999.print IPN579I A close request has been queued for: EWF.SAVE.T999.PRINT

34

Capítulo 3 Descripción de Comandos: CONNECT_SEQUENCE

CONNECT_SEQUENCE

El comando CONNECT_SEQUENCE controla cómo las solicitudes de

sesión de servicios TCP/IP FOR VSE se basan en la dirección IP.

Sintaxis

Argumentos

Este comando afecta a TelnetD, FTPD y potencialmente a cualquier

aplicación de servidor TCP que emita una solicitud de socket de escucha en VSE. Vea las notas abajo.

CONNECT_Sequence {ON|OFF}

ON Cuando un cliente solicita una sesión, se asigna un daemon

correspondiente según el que mejor se ajuste, dependiendo

de la dirección IP.

OFF Cuando un cliente solicita una sesión, se asigna un daemon por

primera vez, independientemente de la dirección IP. Este es el valor predeterminado.

Exposición Siempre que un cliente remoto, como Telnet o FTP, solicita una sesión,

el administrador de la sesión debe asignar la solicitud a un daemon. Esto

se realiza haciendo coincidir la dirección IP del solicitante con la dirección IP codificada en la definición del daemon.

Las direcciones IP pueden coincidir en función de una especificación completa, una coincidencia en la subred o una coincidencia en el

número de red. Un daemon con una especificación 0.0.0.0 coincidirá

con cualquier solicitud.

Cuando CONNECT_SEQUENCE se establece en OFF, el primer

daemon que coincide con cualquier prueba es asignado. El IPADDR=

se ignora por completo y cualquier cliente puede conectarse sin que coincida ninguna dirección IP.

Cuando CONNECT_SEQUENCE se establece en ON, se pueden hacer

varios pases a través de la lista de daemons disponibles. Los criterios de

coincidencia, en orden, son los siguientes:

Una coincidencia exacta de la dirección IP por cualquier daemon

disponible.

Una coincidencia de una dirección IP con el número de red y el

número de subred de la conexión entrante.

Una coincidencia de una dirección IP con el número de red de la

conexión entrante.

Cualquier daemon con una dirección IP de 0.0.0.0, que es la predeterminada. Cualquier conexión entrante puede coincidir con

este valor.

35


El comando SET MASK no tiene efecto en el proceso de

selección. El siguiente ejemplo de Telnet supone que las siguientes definiciones parciales existen con

CONNECT_SEQUENCE ON:

Las solicitudes de clientes entrantes se atenderán en la siguiente

secuencia:

• Los clientes con IPADDR 10.108.034.10 se conectarían a

ID=AAAA.

• Los clientes con IPADDR 10.32.nnn.nnn se conectarían a

ID=BBBB.

• Los clientes con IPADDR 10.nnn.nnn.nnn se conectarían a

ID=CCCC, además de las direcciones 10.108.034.101 y

10.32.nnn.nnn que reciben servicio de ID=AAAA e ID=BBBB.

TCP/IP FOR VSE también considera el recuento total por

daemon:

• Si el número de clientes excede la cuenta ID=AAAA (3),

entonces el cliente con IPADDR 10.108.034.010 se conectaría a ID=BBBB.

• Si el número de clientes excede la cuenta ID = BBBB (40),

entonces los clientes con IPADDR=10.32.*.* se conectarían a

ID = CCCC.

• Si el número de clientes excede la cuenta ID=CCCC (100), los

clientes se conectarían a ID = DDDD.

Si hubo ni un ID=DDDD definido que permitiera a cualquier

cliente conectarse a éste -tiene la configuración predeterminada

de IPADDR=0.0.0.0-, las solicitudes de conexión del cliente que

no coinciden con las configuraciones ID=AAAA, ID=BBBB o ID=CCCC IPADDR= serían rechazada

DEFINE TELNETD,ID=AAAA,COUNT=3, IP=10.108.34.10

DEFINE TELNETD,ID=BBBB,COUNT=40, IP=10.32.0.0

DEFINE TELNETD,ID=CCCC,COUNT=100,IP=10.0.0.0

DEFINE TELNETD,ID=DDDD,COUNT=200,IP=0.0.0.0

36


Ejemplo

Notas



Otro método para asignar daemons específicos a las solicitudes de

sesión del cliente entrantes es usar múltiples puertos.

Dependiendo de sus requisitos, este método puede ser más fácil de administrar y más eficiente de operar.

Cualquier aplicación de servidor TCP que emita una solicitud de

socket de escucha en VSE puede controlar las direcciones IP remotas

a las que se le permita conectarse especificando FOIP= en la solicitud

de apertura del socket pasivo. Pero esto se limita a las aplicaciones TCP que usan la interfaz de macro ensamblador, y

CONNECT_SEQUENCE ON debe estar activo.

DEFINE FTPD

Crea un daemon de Protocolo de Transferencia de Archivos (FTP).

DEFINE TELNETD

Crea un daemon TN3270 o TN3270E.

connect_seq on IPN569I Full connect sequence set to on

37

Capítulo 3 Descripción de Comandos: CONSOLE_HOLD

CONSOLE_HOLD

Sintaxis

Argumentos

El comando CONSOLE_HOLD controla la visualización del símbolo

del sistema en la consola del operador VSE.

CONSOLE_Hold {ON|OFF}

ON TCP/IP FOR VSE muestra el símbolo de la consola inmediatamente

al inicio y mantiene el símbolo independientemente de la acción del operador.

OFf TCP/IP FOR VSE se inicializa sin un símbolo de consola. Se

requiere enviar mensajes a la partición antes de que el operador

pueda ingresar comandos. El símbolo se vuelve a mostrar hasta que se realiza una entrada nula. Este es el valor predeterminado.

Ejemplo

Notas Las siguientes notas aplican a este comando:

Para ingresar comandos a TCP/IP FOR VSE, debe enviar un mensaje

a la partición y esperar a que aparezca el símbolo del sistema. Una

vez que ingresa un comando, el símbolo del sistema se vuelve a

mostrar hasta que se realiza una entrada nula. Establecer CONSOLE_HOLD ON mantiene el símbolo en la pantalla

independientemente de las entradas nulas.

Si incluye CONSOLE_HOLD ON en su plataforma de inicialización,

el símbolo del sistema será mostrado automáticamente en la

inicialización de TCP/IP FOR VSE.

Las versiones anteriores de TCP/IP FOR VSE requerían un

considerable almacenamiento de 24 bits para cargar el analizador de

comandos. Este requisito se ha eliminado y no se logran ahorros de memoria al eliminar el símbolo del sistema.

También puede ingresar comandos usando el parámetro DATA= del

comando VSE MSG.

console_hold off IPN482I TCP/IP for VSE reply ID will not be maintained

console_hold on IPN482I TCP/IP for VSE reply ID will be maintained

38

Capítulo 3 Descripción de Comandos: DEFINE ADAPTER

DEFINE ADAPTER

Sintaxis

El comando DEFINE ADAPTER identifica un adaptador específico

dentro de un controlador de comunicaciones 3172, OSA o compatible

con 3172. Este comando es válido sólo cuando sigue un comando DEFINE LINK emitido previamente que define a un 3172 o un OSA.

DEFine ADAPter LINKid=id [,IPaddr=ip4addr]

,TYPe={ETHERnet|TOKEN_ring|FDDI} [,NUMber=0]

[,MTU=num]

Argumentos LINKid= Este campo debe especificar la ID del comando DEFINE LINK

que define el 3172 u OSA que contiene este adaptador.

IPaddr= Especifica la dirección IP que se utilizará con este adaptador. Esto es esencial para el multi-homing porque la dirección IP de TCP/IP FOR

VSE debe ser coherente con la red a la que está conectada. Si se

omite IPaddr=, la dirección IP especificada en el comando SET

IPADDR es asignada al adaptador.

TYPE= Especifica el tipo de red a la que este adaptador está físicamente

conectado.

ETHERnet Este es un adaptador Ethernet.

TOKEN_ring Este es un adaptador Token_Ring.

FDDI Este es un adaptador FDDI.

NUMber= Especifica la posición del adaptador dentro del 3172. Los

números de adaptador varían de 0 a 99. La mayoría de los dispositivos usan valores de 0 a 3. La unidad de control IBM

2216 N-WAYS admite hasta 16 adaptadores.

MTU= Especifica el tamaño máximo de la unidad de transmisión que se utilizará con este adaptador. Un tamaño de MTU de 576 siempre es

válido. Este es el valor mínimo, y se requiere su aceptación de todas

las implementaciones de TCP/IP como parte del estándar. Este valor

también es el menos eficiente. Los valores recomendados se muestran en la tabla de tamaños de MTU a continuación. Tenga en

cuenta que el valor que elija debe ser compatible con todos y cada

uno de los dispositivos de la red.

39


Tamaños MTU

Ejemplo

Notas

La siguiente tabla muestra los tamaños máximos y predeterminados de

MTU para los diferentes tipos de adaptadores.

Tipo de Adaptador

Tamaño MTU max.

Tamaño MTU pred.

Ethernet 1,500 1,500

Token Ring: red de 4-megabit 4,000 1,500

Token Ring: red de 8-megabit 8,000 1,500

FDDI 2,000 1,500

Vea el manual de Mensajes TCP/IP FOR VSE para obtener información

sobre cada mensaje en este ejemplo.


Este comando debe referir a una unidad de control 3172 u OSA

que ya se ha definido con un comando DEFINE LINK.

Debe emitir este comando desde el miembro de la librería de

inicialización. No se puede emitir desde la consola, excepto en

circunstancias especiales; ver el ejemplo de arriba.

Una vez que se ha definido un 3172 u OSA, se deben emitir todos

los comandos DEFINE ADAPTER relacionados antes de que

TCP/IP pueda procesar (aparte de la inicialización).

Para emitir un conjunto de DEFINE LINK y comandos DEFINE

ADAPTER relacionados desde la consola, primero emita el

comando STOP. Esto evita que TCP/IP complete prematuramente el procesamiento de DEFINE LINK antes de que se especifique

toda la información del adaptador. Una vez que haya completado

sus definiciones, emita el comando START para reanudar el procesamiento.

define link,id=link3172,type=osa2,dev=(032,33)

define adapter,linkid=link3172,number=0,type=ethernet, - ip=192.168.1.161,mtu=1500

IPT100I Internet Link Level (ILL) Processor LCS starting IPL491I OSA link LINK3172 started on devices 0032 – 0033 IPL491I OSA link LINK3172 started adapter 0 as 192.168.1.161

40


Si tiene problemas para comunicarse con uno o más hosts en su red,

intente reducir el tamaño de MTU.

Independientemente de la configuración de MTU, TCP/IP FOR

VSE acepta datagramas entrantes de cualquier tamaño.


DEFINE LINK

Crea un enlace entre TCP/IP y una red o una pila conectada

directamente.

DEFINE ROUTE

Agrega una entrada a la tabla de enrutamiento TCP/IP.

EXECUTE

Ejecuta un script de comando de operador.

QUERY LINKS

Muestra el estado de los enlaces de red.

SET IPADDR

Establece la dirección de inicio predeterminada para la pila.

START

Inicia el motor de despacho TCP/IP o un enlace de red "detenido".

STOP

Detiene el motor de despacho TCP/IP.

41

Capítulo 3 Descripción de Comandos: DEFINE ALTIP

DEFINE ALTIP

Sintaxis

Argumentos

El comando DEFINE ALTIP identifica direcciones IP (de red)

adicionales a las que TCP/IP FOR VSE responderá cuando reciba una

solicitud ARP.

DEFine ALTip ID=id ,IPaddr=ip4addr

ID=

Es una ID para identificar la entrada de la tabla.

IPaddr= Es una dirección para la cual TCP/IP FOR VSE responderá a las

solicitudes ARP.

Ejemplo

Exposición

Notas

Las reglas de enrutamiento TCP/IP requieren que los hosts con la

misma red o número de subred residan en la misma red física (Ethernet, Token Ring, etc.). Los hosts con diferentes números de red o subred no

pueden residir en la misma red física. Existen técnicas que permiten que

dos redes lógicas compartan una sola red física (y viceversa). Sin embargo, esto no es fácil y no es compatible. Esto significa que, si

desea que una o más particiones TCP/IP FOR VSE se conecten a su red

utilizando una única partición propietaria del adaptador, estas

particiones auxiliares necesitan direcciones IP en una red o subred separada.

Para reducir la proliferación de redes, DEFINE ALTIP hace que la

partición propietaria del adaptador sirva como proxy para el auxiliar. Esto significa que cada partición auxiliar aparece en la red física como si

realmente estuviera conectada a ella.

El comando DEFINE ALTIP hace posible que los enrutadores de la

misma red física conozcan las direcciones IP alternativas.


Los datagramas que coinciden con una dirección "altip" son

enrutados automáticamente, independientemente de la configuración de GATEWAY.

Las IP alternativas son útiles sólo junto con DEFINE LINK que

especifique TYPE=IPNET o TYPE=CTCA.

define altip,id=sys2,ipaddr=64.10.5.2 IPN380I Alternative IP address, ID: SYS2 IPAddr: 64.10.5.2

42

Capítulo 3 Descripción de Comandos: DEFINE ALTIP


DEFINE LINK

Crea un enlace entre TCP/IP y una red o con una pila

conectada directamente.

DEFINE ROUTE


DELETE ALTIP

Elimina una dirección de inicio alternativa.

GATEWAY

Controla el reenvío de datagramas no destinados a la pila VSE.

QUERY ALTIPS

Muestra todas las direcciones IP alternativas.

43

Capítulo 3 Descripción de Comandos: DEFINE CGI

DEFINE CGI

Sintaxis

Argumentos

El comando DEFINE CGI agrega una fase CGI o un programa

REXX a TCP/IP FOR VSE. Una vez agregado, el CGI puede ser

solicitado con una solicitud de navegador web.

DEFine CGI PUBlic=member,TYPE={CGI|CGI-BAL|CGI-REXX}

PUBlic=

El nombre del programa a ser solicitado.

TYPE= Es uno de los siguientes valores:

CGI Una rutina CGI de "estilo antiguo".

CGI-BAL Una rutina de ensamblador que utiliza la definición de interfaz actual.

Ejemplo

Notas

Comando Relacionados

CGI-REXX Una rutina CGI codificada en REXX.


Vea la Guía del Programador TCP/IP FOR VSE para obtener más

información sobre cómo escribir programas CGI.

La respuesta en el ejemplo anterior se refiere a un archivo que se está

definiendo. Esto es normal.

DELETE CGI

Elimina un programa CGI del almacenamiento.

QUERY CGIS

Muestra todos los programas CGI disponibles actualmente.

define cgi,public='addrbk',type=cgi-rexx IPN694I Entry defined

44

Capítulo 3 Descripción de Comandos: DEFINE EVENT

DEFINE EVENT

Sintaxis

El comando DEFINE EVENT le permite establecer acciones que se

activan cuando ocurren eventos específicos en su sistema VSE.

DEFine EVent ID=id [,ACTion={Lpr|Ftp|EMAIL}] [,CLass=X]

[,FCBPrefix=string4]

[,HOSTname={USERinfo|DEST|ROOM|DEPT|BLDG|NONE}]

[,JECLscript={YES|NO}]

[,NULLfile={Skip|Ignore|Process|Fail|Delete}]

[,ORDEr={Yes|JOBNUMber|No}] [,PASSword=$EVENT]

[,PRIOrity={Yes|No}] [,POWERSYSid=sysid]

[,Queue={Lst|Pun|Rdr}] [,REtry=1]

[,RETRY_Time=45s] [,SCRIPTName=name]

[,SCRIPTType=L|type] [,SINGle={Yes|No}]

[,USErid=$EVENT]

Argumentos ID= Es un nombre único para identificar el evento.

ACTion= Determina la acción que se tomará para este evento, de la siguiente manera:

Lpr El procesamiento de eventos sigue el protocolo LPR. Esto significa que se debe proporcionar un daemon LP en el host

remoto. Este es el valor predeterminado.

Ftp El procesamiento de eventos sigue el protocolo FTP. Esto significa

que se debe proporcionar un daemon FTP en el host remoto.

Email El procesamiento de eventos sigue el protocolo SMTP. Esto

significa que se debe proporcionar un daemon SMTP en el host

remoto para procesar el correo electrónico saliente.

CLass= La clase VSE/POWER en la que ocurrirá el evento. La clase

predeterminada es "X".

FCBPrefix= Si es proporcionado, este valor de 1 a 4 caracteres se utiliza en un

comando "SET FCBPREFIX=" pasado a los clientes EMAIL y LPR. Los eventos FTP no se ven afectados. Por defecto, no se

emite el comando "SET FCBPREFIX=".

45


HOSTname= Especifica un campo JECL para inspeccionar la dirección IP del host remoto o el nombre de un archivo de script. Los valores permitidos son USERinfo,

DEST, ROOM, DEPT, BLDG y NONE. NONE especifica ignorar estos

campos JECL y usar el valor del parámetro SCRIPTName= o del campo SCRIPT= JECL, si está configurado.

El valor predeterminado para HOSTNAME= es USERinfo.

El diagrama de flujo enseguida muestra cómo el cliente automático

determina el nombre del script / dirección IP a utilizar. La precedencia del campo JECL especificado por HOSTNAME=

depende de si la acción se establece en FTP o LPR/EMAIL

Si falta un campo de JECL y SCRIPTName= se omite de la instrucción DEFINE EVENT, el informe se trata como un error y no

se procesa. El informe luego entra en DISP=Y. Si se especifica un

campo y contiene un valor, SCRIPTName= se ignora.

Nota: ICCF anulará algunas configuraciones JECL e insertará un

nombre de usuario o un nombre SAS en el campo DEST= o USER= JECL. Puede hacer un PDISPLAY LST, ALL, FULL después de

crear el informe para ver cómo se configura un sitio en particular.

JECLscript= Establece si se debe anular el nombre de script predeterminado

establecido por SCRIPTName= con un nombre diferente

establecido en JECL.

YES Utilice el valor establecido por "SCRIPT=value" en el LST

JECL, si este campo está configurado. Si se omite, use el valor

establecido por SCRIPTName=. El ejemplo 2, página 51, muestra cómo usar JECLscript=YES.

NO No anule el nombre establecido por SCRIPTName=. Este es

el valor predeterminado.

Nota: Además de configurar el parámetro JECLscript=YES, deberá modificar su inicio VSE/POWER para incluir la segunda instrucción

DEFINE a continuación:

Inserte esa línea después de la línea "CICSDATA" que normalmente

viene con el inicio predeterminado. Para verificar si la entrada correcta está definida para VSE/POWER como parte de la inicialización de

VSE/POWER, puede emitir un comando PDISPLAY AUSTMT. La

respuesta muestra todos los campos definidos por el usuario. Si

"SCRIPT" está entre ellos, entonces agregar SCRIPT= a su LST JECL funcionará. De lo contrario, deberá modificar su inicio VSE / POWER.

DEFINE L,CICSDATA,3F00,1,255,* DEFINE L,SCRIPT,FFDC,1,8,C

46


Cómo el Cliente Automático Determina el Nombre de Scrip o Dirección IP

Inicio A

Está

DEFINE EVENT

HOSTNAME=NONE

listo?

YES

Está

DEFINE EVENT

JECLSCRIPT=YES

listo?

YES

Está

* $$ LST

SCRIPT=scriptname

listo?

YES

NO NO NO

Use DEFINE EVENT

SCRIPTNAME=scriptname

Use * $$ LST

SCRIPT=scriptname

Está

DEFINE EVENT

HOSTNAME=USERinfo|

DEST|ROOM|DEPT|

BLDG

listo?

YES

Está este campo

JECL listo?

YES

Use el valor JECL

seleccionado.

NO NO

Revise * $$ LST

USER='scriptname' A

(default for HOSTNAME=)

Sólo para FTP

Está

* $$ LST

DEST=(*,scriptname)

listo?

YES Use * $$ LST

DEST=(*,scriptname)

NO

Está

* $$ JOB

LDEST=(*,scriptname)

listo?

YES Use * $$ JOB

LDEST=(*,scriptname)

NO

47


NULLfile= Este parámetro especifica cómo se deben manejar los archivos

VSE/POWER vacíos (sin registros).

Skip El archivo NO será procesado.

Ignore Este valor es sinónimo de SKIP.

Process El archivo se procesará normalmente. Dependiendo del tipo o

transferencia, destino y otros factores, esto puede ocasionar

otros errores. Este valor es el predeterminado.

Fail El informe se enviará a DISP=Y.

Delete El informe se eliminará de la fila VSE/POWER.

ORDEr= Este parámetro se aplica a las operaciones FTP y LPR. Controla el orden en que se procesan las entradas de la fila VSE/POWER. La

configuración ORDER afecta sólo el evento que está definiendo, que

es para una fila y clase específica. Los valores son los siguientes.

Yes El cliente Auto-EVENT procesa las entradas en el orden en que las

devuelve un comando “PDISPLAY queue,FREE,CCLASS=class”.

La entrega de subproceso único está habilitada (SINGLe= YES está forzado) para garantizar que se mantenga este orden. YES es el

valor predeterminado. Para obtener más información sobre el

comando PDISPLAY, consulte el manual de IBM Administración y Operación de VSE/POWER.

JOBNUMber El cliente Auto-EVENT clasifica las entradas devueltas por un

comando “PDISPLAY queue,FREE,CCLASS=class antes de

procesarlas. Las entradas se ordenan por número de trabajo

VSE/POWER y luego por número de segmento VSE/POWER. La entrega de subproceso único está habilitada (SINGLe= YES

está forzado) para garantizar que se mantenga este orden.

No Las entradas se procesan sin ningún orden en particular. Las entregas serán de subprocesos múltiples dependiendo de cómo

se configuren los parámetros relacionados (SINGLe=YES|NO,

así como los valores MAX_FTP_EVENTS y MAX_LPR_EVENTS). Vea también el comando

SINGLEDEST para obtener información relacionada.

Debido a que las entradas de fila VSE/POWER pueden ser segmentadas, el orden de JOBNUMBER puede diferir del

orden predeterminado en algunos casos.

48


Puede comparar los resultados para determinar qué configuración es

la más adecuada para su entorno.

Después de definir un evento, QUERY EVENTS mostrará la

configuración ORDER= de la siguiente manera para ORDER=NO,

ORDER=JOBNUMBER y ORDER=YES, respectivamente:

T1 0101 IPN427I Priority: Yes, Order: None, Script: L

T1 0101 IPN427I Priority: Yes, Order: Jobnum, Script: L

T1 0101 IPN427I Priority: Yes, Order: Yes, Script: L

PASSword= Una contraseña en mayúscula de 1 a 16 caracteres que se utilizará

para iniciar sesión en los clientes FTP o LPR locales. El valor

predeterminado es "$EVENT"

POWERSYSid= Si opera en un entorno de spool compartido, debe especificar el POWER

SYSID de su sistema "local". Debido a que el procesamiento de automatización no puede acceder a archivos que pertenecen a sistemas que

no sean el “local”, este parámetro limita lo que el evento "ve". Si especifica

un valor en un entorno no compartido, o si especifica un valor incorrecto, no se producirá ningún proceso de automatización para este evento.

PRIOrity Este campo indica si el valor del campo JECL PRI= se utilizará para

determinar el orden de procesamiento de eventos.

Yes El valor PRI se tendrá en cuenta al determinar el orden en que

se seleccionan los eventos para su procesamiento. Este es el

valor predeterminado.

No El valor PRI será ignorado.

Queue= Palabra clave. Esta es la fila POWER a ser monitoreada.

Lst La fila POWER LST será monitoreada. Valor predeterminado.

Pun La fila POWER PUN será monitoreada.

Rdr La fila POWER RDR será monitoreada.

REtry= Numérico, de 0 a 9.

Si el servidor remoto rechaza una conexión con el daemon de automatización, se vuelve a intentar el número especificado de

veces antes de que se abandone la operación y la lista se coloque en

estado DISP= Y. El valor predeterminado es 1.

49


RETRY_Time= Numérico, de 0 a 99999, en unidades de 300 segundos.

Especifica el intervalo de tiempo entre reintentos para una conexión

rechazada. El valor predeterminado es 13500 (45 segundos)

SCRIPTName= Este es el nombre del script que se usará si se especifica HOSTname=

NONE para no permitir la inspección de los campos JECL. El nombre debe definirse en TCP/IP FOR VSE con DEFINE NAME y puede

tener de 1 a 8 caracteres. Será aplicado a cada informe que se procese.

No debe contener un tipo de archivo. No hay predeterminado.

SCRIPTtype= Esta es la extensión del nombre del archivo que se agregará al

nombre del script antes de recuperarlo de una librería. Este valor sigue las reglas normales del librero y puede tener de 1 a 8 caracteres

de longitud. El valor predeterminado es "L".

SINGle= Este parámetro sólo se aplica a las operaciones FTP y LPR. Controla si la salida es de subproceso único, lo que significa que los elementos

vinculados para el mismo destino se envían en serie. Este control es

útil para destinos que no pueden procesar más de un archivo a la vez.

Yes Los artículos se envían con un solo subproceso en todos los

destinos. YES es forzado cuando ORDER=YES (el valor

predeterminado) u ORDER=JOBNUM. Es opcional cuando ORDER=NO.

Nota: El comando SINGLEDEST ON es diferente. Este

comando le dice al proceso de automatización que seleccione

elementos de subproceso único vinculados al mismo destino y asociados con el mismo nombre de script. Pero permite que

otros elementos, vinculados a diferentes destinos (diferentes

nombres de script), se envíen al mismo tiempo. Vea el comando

SINGLEDEST para más información.

No Múltiples envíos simultáneos pueden suceder si los elementos no están ordenados (ORDEN=NO) y el número de elementos es

menor que la configuración de evento MAX para ese cliente.

Por ejemplo, si MAX_LPR_EVENTS se establece en 3 y se

producen tres envíos, el envío se detiene hasta que el número máximo activo sea menor que 3. NO es el valor predeterminado

cuando ORDER=NO.

USErid= Una ID de usuario en mayúscula de 1 a 16 caracteres que se usará

para iniciar sesión en el cliente FTP o LPR local. El valor

predeterminado es "$EVENT".

50


Ejemplo 1 Este es un ejemplo de Auto FTP.

set auto_time=1500 IPN268I AUTO_TIME now set to 1500 300th sec set max_ftp=3 IPN268I MAX_FTP now set to 3 define event,id=autoftp1,type=power,queue=lst,class=x,action=ftp define event,id=autoftp2,type=power,queue=pun,class=x,action=ftp define event,id=autolpr1,type=power,queue=lst,class=y, - action=lpr,hostname=dest

TCP900I Startup ClientD PowerSysid:N PnetNodeId: Addr:00633050

query events IPN253I << TCP/IP Events >> IPN587I Event Pause Interval: 1500 (5 Seconds) IPN273I Maximum LPR Events: 5 Current Events: 0 IPN273I Maximum FTP Events: 3 Current Events: 0 IPN273I Maximum Email Events: 1 Current Events: 0 IPN426I Event ID: AUTOLPR1 IPN428I Class: Y, Queue: LST, Action: LPR, POWER SYSID: IPN427I Priority: Yes, Order: Jobnum, Script: L IPN429I Host field: DEST, User ID: $EVENT, Single: N IPN430I Action: LPR, Retries: 1, Time: 45 sec IPN426I Event ID: AUTOFTP2 IPN428I Class: X, Queue: PUN, Action: FTP, POWER SYSID: IPN427I Priority: Yes, Order: Jobnum, Script: L IPN429I Host field: USER, User ID: $EVENT, Single: N IPN430I Action: FTP, Retries: 1, Time: 45 sec IPN426I Event ID: AUTOFTP1

IPN428I Class: X, Queue: LST, Action: FTP, POWER SYSID: IPN427I Priority: Yes, Order: Jobnum, Script: L IPN429I Host field: USER, User ID: $EVENT, Single: N IPN430I Action: FTP, Retries: 1, Time: 45 sec

51


Ejemplo 2

Este ejemplo muestra cómo definir un cliente LPR automático y usarlo.

Primero, aquí hay un ejemplo de DEFINE EVENT para un cliente LPR que escanea CLASS=K, sin información de script contenida en ningún

campo. Establece un nombre de script predeterminado y permite al

usuario anular ese valor predeterminado.

Después de definir el EVENTO, puede emitir un QUERY EVENT para

ver la nueva configuración. Si no se definió esta configuración, verá los valores predeterminados de estos campos. Y si ese es el caso,

JECLscript se establecerá en NO (predeterminado)).

Aquí está la salida muestra de la consulta.

Usted podría entonces ejecutar los siguientes trabajos:

En estos dos casos, el primer trabajo se entregará con LPRSCRD como

nombre de script predeterminado. El segundo trabajo se entregará con LPRSCR2 como el nombre del script, anulando así el nombre

predeterminado, porque SCRIPT= se agregó a la instrucción $$ LST.

SCRIPT se definió como VSE/POWER.

* $$ JOB JNM=AUTOLPR1,CLASS=0 * $$ LST CLASS=K,DISP=D,SCRIPT=LPRSCR2 // JOB AUTOLPR // EXEC LIBR ACC S=BIMLIB.CSICNFG LISTDIR *.* /* /& * $$ EOJ

* $$ JOB JNM=AUTOLPR1,CLASS=0 * $$ LST CLASS=K,DISP=D // JOB AUTOLPR // EXEC LIBR ACC S=BIMLIB.CSICNFG LISTDIR *.* /* /& * $$ EOJ

T1 0110 IPN426I Event ID: ALPRLSTK LST(K) LPR T1 0110 IPN428I Class: K, Queue: LST, Action: LPR, POWER SYSID: T1 0110 IPN427I Priority: Yes, Order: No, Script: L T1 0110 IPN429I Host field: NONE, User ID: $EVENT, Single: N T1 0110 IPN430I Action: LPR, Retries: 1, Time: 45 sec T1 0110 IPN434I JECLScript: Yes, Scriptname: LPRSCRD

DEFINE EVENT,ID=ALPRLSTK,TYPE=POWER,CLASS=K,QUEUE=LST,ACTION=LPR, - HOSTNAME=NONE,ORDER=NO,JECL=YES,SCRIPTNAME=LPRSCRD

52


Notas



LPR es un protocolo de spooling. Esto significa que el daemon remoto

debe aceptar la transmisión completa y almacenarla de alguna manera.

Algunas impresoras fingen ser daemons sin capacidad suficiente para aceptar y almacenar una transmisión completa. Cuando la impresora se

queda sin papel o se agota el buffer, cierra la ventana de transmisión (y

LPR se bloquea hasta que puede completar la transmisión) o

simplemente deja de reconocer las transmisiones de TCP/IP. En este último caso, LPR finalmente agota el tiempo y se realizan los

procedimientos de recuperación de errores.

De acuerdo con los estándares publicados para LPR/LPD, si una

transmisión falla por algún motivo, la retransmisión comienza al inicio del archivo.

Si un LPD remoto rechaza una conexión, se considera un error de

comunicación y se inician procedimientos de recuperación de error.

Para evitar degradar el servicio a otros usuarios de la red, el LPR automático tiene un solo subproceso. Esto es necesario porque un

daemon LP configurado correctamente acepta datos tan rápido como se

pueden transmitir. Las operaciones concurrentes de LPR corren el riesgo de inundar una red física. Vea también el comando SINGLEDEST.

Pseudo dispositivos LPD que no pueden recibir transmisiones

completas de manera rápida y confiable pueden reducir seriamente

el rendimiento.

Cualquier reporte que no se procese después de que se hayan

realizado los reintentos necesarios se establece en DISP=Y. Esto

evita el reprocesamiento continuo del mismo archivo.

Consulte la Guía del Usuario de TCP/IP FOR VSE para obtener más

información sobre el comando DEFINE EVENT y el uso del cliente FTP automático, el cliente LPR automático y el cliente EMAIL

automático.

Asegúrese de que el USERID y el PASSWORD se hayan creado

con DEFINE USER y que la entrada tenga la autoridad suficiente

para usar los clientes FTP o LPR, según corresponda (EMAIL no

lo requiere).

Si VSE/POWER requiere un ID de usuario/contraseña para

acceder a la fila, entonces se puede especificar mediante los

comandos SET POWERUSERID y SET POWERPASSWORD,

respectivamente.

ASECURITY FTPC

Establece si se rechazan ciertos comandos FTP..

DEFINE USER


53


DELETE EVENT

Termina el monitoreo de una clase VSE/POWER.

FLUSH

Termina todo el procesamiento con un host remoto específico.

QUERY EVENTS

Muestra el estado del procesamiento de automatización.

SET AUTO_TIME

Determina el intervalo para que la automatización verifique las filas POWER.

SET MAX_EMAIL_EVENTS

Establece el número máximo de eventos EMAIL simultáneos

para el procesamiento de automatización.

SET MAX_FTP_EVENTS

Establece el número máximo de eventos FTP simultáneos para el

procesamiento de automatización.

SET MAX_LPR_EVENTS

Establece el número máximo de eventos LPR simultáneos para el procesamiento de automatización.

SET POWERPASSWORD

Establece la contraseña para el acceso VSE/POWER.

SET POWERUSERID

Establece la ID de usuario para el acceso VSE/POWER.

SINGLEDEST

Determina cómo el procesamiento de automatización maneja múltiples informes en fila para el mismo destino (host).

54

Capítulo 3 Descripción de Comandos: DEFINE FILE

DEFINE FILE

Sintaxis

El comando DEFINE FILE agrega un archivo al sistema de archivos

TCP/IP FOR VSE. Éste puede ser un archivo VSAM, una librería VSE, el conjunto de librerías ICCF, las filas VSE/POWER, un archivo

secuencial, un repositorio HFS o un espacio de datos.

DEFine FILE TYPe={ESDS|KSDS|SAM|LIBrary|ICCF|POWer|

VSAMCAT|VTOC|HFS|DSPACE|BIM-EDIT|CONDOR|

FALCON|VOLLIE|TAPE} [,DLBL=name8]

,PUBlic=pubname [,DRIVer=member]

[,ALLOWsite={Yes|No}] [,READonly={Yes|No}]

[,CC={Yes|No}] [,TRcc={YES|NO}]

[,CRlf={Yes|No}] [,RECFm=F|FB|V|VB|S|SV|SU|SB]

[,LRECL=num] [,BLKsize=num] [,GID=snum]

[,UID=snum] [,TRANslate=name16]

[,SITE={Yes|No}] [,DBLOCKS=num] [,EXT=name8]

[VOLid=volser] [,CIPHER={NULL-SHA1|

SDESCBC-NULL|SDESCBC-SHA1|TDESCBC-NULL|

TDESCBC-SHA1|AES128C-NULL|AES128C-SHA1|

AES192C-NULL|AES192C-SHA1|AES256C-NULL|

AES256C-SHA1|KEYMASTER}] [,CIPHERKEY=CIALHFSK]

Argumentos

TYPE= Especifica el tipo de conjunto de datos que se define.

ESDS Un conjunto de datos VSAM ESDS. Las solicitudes de lectura

FTP dan como resultado la transmisión del archivo completo.

KSDS Un conjunto de datos VSAM KSDS. Las solicitudes de lectura FTP

dan como resultado la transmisión del archivo completo. Las

solicitudes de escritura se procesan como operaciones VSAM

INSERT.

SAM Un conjunto de datos del Método de Acceso Secuencial.

LIBrary Una librería VSE. Realizar una lista de directorio en el nombre

público devuelve una lista de las sub-librerías. La calificación adicional del nombre público con un nombre de sub-librería

(como public.name.sublib) devuelve una lista de los miembros.

Las solicitudes de lectura FTP recuperan el contenido de un miembro. Las solicitudes de escritura crean o reemplazan el

contenido de un miembro.

55


ICCF Una estructura de librería ICCF. El listado del directorio no es compatible. Para recuperar datos, use un nombre completo que

consiste en el nombre público, el número de la librería y el

nombre del miembro (pubname.num.member). Escribir en una librería ICCF no es compatible.

Tenga en cuenta que para acceder a una librería ICCF

utilizando FTP, su ID de usuario y contraseña de FTP deben ser

idénticos a su ID de usuario y contraseña de ICCF.

POWer Una fila VSE/POWER. Para recuperar información de VSE/POWER, especifique el nombre público calificado con LST,

RDR o PUN, seguido de la clase, más del nombre del trabajo.

También se pueden agregar dos calificadores adicionales: número

de trabajo y sufijo de trabajo, según sea necesario. Escribir en VSE/POWER crea un archivo en la fila especificada.

VSAMCAT Un catálogo VSAM. Una lista de directorio devuelve los nombres

de todos los archivos en ese catálogo. Las operaciones admitidas

incluyen lectura, escritura, creación, eliminación, cambio de nombre y anexos. Se proporciona una lista completa de las

operaciones compatibles en la Guía del Usuario de TCP/IP FOR

VSE, cap. 2, “FTP”.

VTOC Un volumen completo de VSE. Puede realizar operaciones

limitadas en un archivo definido con TYPE= VTOC. Una lista de operaciones admitidas por TYPE= VTOC se encuentra en la

Guía de Instalación de TCP/IP FOR VSE.

HFS Sistema de Archivos Jerárquico de CSI. Este tipo de archivo

admite un sistema de archivos de tipo PC o Linux con múltiples

niveles de subdirectorio y nombres largos de archivo.

DSPACE Causa que un espacio de datos se asigne y se use como un archivo. Vea

la Guía de Instalación de TCP/IP FOR VSE para más información.

BIM-EDIT Producto BIM-EDIT de CSI International. Este tipo requiere una

licencia BIM-EDIT, y debe vincular el archivo .OBJ para que el

módulo del controlador de I/O sea utilizable. Debe usar DEFINE

FILEIO para cargar el módulo del controlador de I/O BIM-EDIT en el almacenamiento. Vea DEFINE FILEIO para obtener una

nota sobre BIM-EDIT y la secuencia de inicio de TCP/IP.

CONDOR, FALCON, VOLLIE Tipos de archivos asociados con productos que no son de CSI.

Para cada tipo, debe obtener un módulo de controlador de I/O

proporcionado por el proveedor e instalarlo. Vea “Ejemplo de

Archivo Vollie™,” página 64, para más información.

56


TAPE Un archivo de unidad de cinta. Debe usar DEFINE FILEIO para cargar

el módulo del controlador TAPE I/O asociado en el almacenamiento.

DLBL= Un nombre DLBL. Esto especifica la instrucción DLBL que se utilizará

para abrir el archivo. Debe ser accesible para la partición TCP/IP FOR VSE. Los archivos de tipo "POWER" no requieren ni usan un DLBL.

PUBlic= Un nombre único que identifica este conjunto de datos para los

usuarios. Este nombre sigue las mismas reglas que los nombres de

conjuntos de datos VSE, por lo que puede establecer el nombre público igual al nombre real del conjunto de datos. Para una

discusión de los nombres públicos, consulte la Guía de Instalación

de TCP/IP FOR VSE, capítulo 1, “Fundamentos de TCP/IP”.

DRIVer= Si se especifica, esta fase se carga desde la lista de búsqueda de la biblioteca cuando se inicializa el controlador del conjunto de datos. En general, debe dejar

este valor sea predeterminado a la fase proporcionada para el tipo de archivo.

Si QUERY FILEIO no incluye la fase que necesita, debe usar DEFINE

FILEIO para cargar la fase antes de poder especificarla en DEFINE FILE.

READonly= Esta configuración se puede utilizar para limitar selectivamente el acceso FTP a este archivo.

No Los usuarios de FTP pueden escribir y actualizar este archivo, sujeto a otros procedimientos de seguridad (predeterminado)

Yes Los usuarios NO tienen acceso de escritura o actualización a este

archivo, independientemente de otros procedimientos de seguridad.

ALLOWsite= Los comandos FTP SITE que son específicos de un tipo de archivo (por

ejemplo, SITE PALTER) se pasan al controlador de I/O del archivo al

que se está accediendo actualmente. La codificación NO para este parámetro anula lo que se especifique en la definición FTPD y se pueda

utilizar para evitar que comandos no autorizados sean emitidos.

No Los usuarios de FTP NO pueden pasar comandos SITE al

controlador de I/O del archivo asociado con este archivo.

Yes Los usuarios de FTP pueden pasar comandos SITE al controlador de I/O de archivo asociado con este archivo.

57


EXT= Para TYPE=VSAMCAT, especifica un “sufijo” que se agregará al nombre del archivo. Por ejemplo, EXT=“.TXT” garantizaría que todas

las referencias a los archivos en el catálogo se supongan “texto”

CC= Proporciona un valor predeterminado para el comando FTP SITE

CC. Si no se especifica, el valor lo proporciona el cliente o usuario.

Nota: Esta configuración de CC puede anularse. Consulte la sección

“RECFM, LRECL, BLKSIZE”, página 60, para detalles.

Yes Se supone que el primer byte de cada registro es un byte de

retorno de carro, y este byte se retiene como parte de los datos.

No Durante las descargas (desde VSE), se descarta el primer byte

de cada registro. Durante las cargas (a VSE), se antepone un carácter en blanco a cada registro.

TRcc= Proporciona un valor predeterminado para el comando FTP SITE

TRCC. Si no se especifica, el valor lo proporciona el cliente o usuario.

Nota: Esta configuración de TRCC se puede anular. Consulte la

sección “RECFM, LRECL, BLKSIZE”, pág. 60, para detalles.

No No se realiza ningún procesamiento especial para simular el retorno del carro.

Yes Los códigos de retorno de carro ANSI (+, 0, -, 1) provocan la simulación

del carácter CC. Los caracteres de control de formularios (CR, LF, FF) se agregan a los registros de salida según sea necesario.

CRlf= Proporciona un valor predeterminado para el procesamiento

delimitador de registro CRLF. Si no se especifica, el valor lo

proporciona el cliente o usuario.

Nota: Esta configuración de CRLF se puede anular. Consulte la sección “RECFM, LRECL, BLKSIZE”, pág 60, para detalles.

Yes Cada registro cargado en VSE debe finalizar con un

delimitador apropiado, generalmente CR/LF. En la descarga,

se agrega el delimitador apropiado a cada registro.

No No se agregan delimitadores en la descarga y no se esperan

delimitadores en la carga. Para los registros entrantes, el

flujo de datos se divide en función del valor LRECL.

58


RECFm= Proporciona un valor predeterminado para el comando FTP SITE RECFM.

Especifique un formato de registro de F, FB, V, VB o S. (El

formato de cadena es válido sólo con los archivos de la librería). Este valor NO anula el valor RECFM especificado en la definición

de DLBL. Si no se especifica en DLBL o DEFINE FILE, puede

suministrarse mediante un comando FTP SITE.

Nota: Esta configuración de RECFM puede anularse. Vea la


LRECL= Proporciona un valor predeterminado para el comando FTP SITE LRECL.

Esta es la longitud del registro lógico. Es un valor numérico y debe

ser coherente con el valor utilizado cuando se creó el archivo. El valor predeterminado es 80. Consulte las tablas siguientes para

obtener información sobre la selección de LRECL. Este valor no se

obtiene de la información de DLBL y debe proporcionarse en un archivo DEFINE FILE o con un comando FTP SITE.

Nota: Esta configuración de LRECL se puede anular. vea la


BLKsize= Proporciona un valor predeterminado para el comando FTP “SITE BLKSIZE”.

Este valor es el tamaño de bloque utilizado en el conjunto de datos. Esta información debe ser coherente con el valor utilizado cuando

se creó el archivo. No hay predeterminado. Consulte las tablas en

las secciones a continuación para obtener información sobre la selección de BLKSIZE. Este valor no se obtiene de la información

de DLBL y debe ser proporcionado por DEFINE FILE o con un

comando FTP SITE.

Nota: Esta configuración de BLKSIZE se puede anular. vea la


TRANslate= Proporciona un valor predeterminado para el comando FTP SITE

TRANSLATE cuando el archivo debe traducirse entre los modos

ASCII y EBCDIC. Si se omite, el valor predeterminado es la tabla

de traducción predeterminada de TCP/IP FOR VSE.

Para que sea válida, la tabla de traducción nombrada debe estar

cargada en el momento en que se abre el archivo y no cuando se emite el DEFINE FILE.

El comando DEFINE TRANSLATION explica la definición y carga de las tablas de traducción.

59


SITE= Los comandos SITE se procesan jerárquicamente. El daemon FTP maneja la mayoría de los comandos por sí mismo. Cualquier comando que éste no

entienda se pasa al controlador de I/O de del archivo seleccionado

actualmente, según lo determine el último comando de CD emitido.

No Los comandos FTP SITE que el daemon FTP no reconoce no se pasan a la rutina del controlador específico del archivo.

Yes Los comandos FTP SITE que no son reconocidos por el daemon

FTP se pasan a la rutina del controlador de I/O de archivo para su posible procesamiento. Este es el valor predeterminado.

GID= Numérico firmado, de -9999999 a +9999999.

Define este archivo como parte de un grupo. TCP/IP FOR VSE no utiliza

este campo, sino que lo pasa a la salida de seguridad TCP/IP FOR VSE.

También se puede asignar un valor GID con DEFINE USER.

UID= Numérico firmado, de -9999999 a +9999999.

Asocia este archivo con una ID de usuario de estilo UNIX. TCP/IP FOR

VSE pasa este campo a la salida de seguridad TCP/IP FOR VSE. También

se puede asignar un valor UID con el comando DEFINE USER.

DBLOCKS= Para TYPE=DSPACE, especifica la cantidad de espacio que se asignará al archivo virtual.

VOLid= Para TYPE=VTOC, especifica la ID de volumen del disco.

CIPHER= Para TYPE=HFS, indica que los archivos deben almacenarse en

forma cifrada utilizando el método especificado. Si se omite este parámetro, no se realiza ningún cifrado o descifrado.

CIPHERKEY= Para los archivos cifrados TYPE=HFS, esta palabra clave

proporciona el nombre de la fase que contiene información sobre las

claves de cifrado. La fase predeterminada se envía con TCP/IP y contiene claves de muestra. Debe crear su propia fase con sus

propias claves antes de usar esta función en un entorno de

producción. Hay más información disponible en la Guía del

Programador TCP/IP FOR VSE.

60


Ejemplo

RECFM, LRECL, BLKSIZE

Los valores aceptables para RECFM, LRECL y BLKSIZE dependen de

cómo definió originalmente el archivo, el método de acceso que usa y el modo de acceso (lectura o escritura). Cuando los valores aceptables

dependen del modo de acceso, debe especificar qué modo está

definiendo. Si especifica un modo, y luego necesita acceder al archivo en el otro modo, su administrador puede emitir un segundo comando

DEFINE FILE para darle al archivo un segundo nombre con las

características del otro modo. Para suministrar valores que no son

aceptados por el comando DEFINE FILE, use los comandos SITE.

Nota: Si el procesamiento EXTTYPES NO está en vigor y SITELAST=YES en

FTP, los comandos SITE tienen prioridad sobre los siguientes parámetros

DEFINE FILE: BLKSIZE, CC, CRLF, LRECL, RECFM y TRCC.

Consulte también el capítulo 6, “Configuración de Daemons FTP”, en la Guía de Instalación de TCP/IP FOR VSE.

Las siguientes secciones contienen tablas que muestran valores

aceptables para RECFM, LRECL y BLKSIZE para tipos de archivo

específicos. Los encabezados de "Input" indican que está leyendo desde el disco, y los encabezados de "Output" indican que está

escribiendo en el disco. Estos términos no indican si está utilizando el

cliente FTP o el daemon.

define file,public='power',type=power IPN264I File defined, Dataset: POWER

define file,public='tcpip',dlbl=tcpip,type=library IPN264I File defined, Dataset: TCPIP

define file,public='prd1',dlbl=prd1,type=library IPN264I File defined, Dataset: PRD1

define file,public='prd2',dlbl=prd2,type=library IPN264I File defined, Dataset: PRD2

define file,public='ijsysrs',dlbl=ijsysrs,type=library IPN264I File defined, Dataset: IJSYSRS

define file,public='analyze',dlbl=analyze,type=sam, - recfm=fb,lrecl=4096,blksize=4096 IPN264I File defined, Dataset: IJSYSRS

61


Archivo de Disco Secuencial y VSAM-Managed Consideaciones de Archivo SAM

Para archivos de disco secuenciales y archivos SAM administrados

por VSAM, tenga en cuenta la siguiente información:

Los registros de longitud fija se rellenan cuando es necesario.

Cuando se produce relleno, los archivos de texto se rellenan con

espacios en blanco y los archivos binarios se rellenan con ceros.

Para eliminar la necesidad de comandos SITE, su administrador VSE

puede definir el mismo archivo físico con dos nombres públicos

diferentes (para entrada y salida) y asignar diferentes valores LRECL y BLKSIZE a cada uno.

Aunque los archivos SAM administrados por VSAM de IBM

aparecerán como archivos ESDS al realizar una IDCAMS LISTCAT

del catálogo VSAM, se recomienda que los lea como archivos SAM

en lugar de archivos ESDS. Esto se debe a que las rutinas de IBM que realizan la salida SAM del archivo a menudo no actualizan

correctamente el catálogo después de que se cierra el archivo. Esto

puede resultar en transferencias incompletas cuando se usan ciertos clientes FTP gráficos.

RECFM SU se interpreta como un archivo no bloqueado extendido.

RECFM SB se interpreta como un archivo bloqueado extendido.

La siguiente tabla muestra los valores apropiados para este tipo de archivo

RECFM

Input LRECL

Input BLKSIZE

Output LRECL

Output BLKSIZE

F Tamaño de

Registro

N/A Tamaño de

Registro +8

N/A

FB Tamaño de

Registro

Tamaño de

Registro por Factor

de Bloqueo

Tamaño de

Registro

(Tamaño de

Registro por Factor de

Bloqueo) + 8

V Tamaño de

Registro

Máximo

N/A Tamaño de

Registro

Máximo +8

N/A

VB Tamaño de Registro

Máximo

Tamaño Máximo de

Bloqueo

Tamaño de Registro

Máximo

Tamaño Máximo de

Bloqueo +8

SU Tamaño de

Registro

Máximo

N/A Tamaño de

Registro

Máximo +8

N/A

SB Tamaño de Registro

Máximo

Tamaño Máximo de

Bloqueo

Tamaño de Registro

Máximo

Tamaño Máximo de

Bloqueo +8

62


Consideraciones a Archivos VSAMCAT

Consideraciones a Archivos ESDS, KSDS

Para los archivos VSAMCAT, tenga en cuenta la siguiente información.

Para los archivos de salida, si el archivo aún no existe, el comando

SITE establecerá los valores de los parámetros utilizados en el

comando DEFINE CLUSTER que se pasará como una subtarea a la utilidad IBM IDCAMS antes de escribir en el archivo.

Si el archivo de salida ya existe, se ignorarán los comandos SITE y

no se solicitará la utilidad IDCAMS. Esto significa que los

comandos SITE que usa deben coincidir con los atributos esperados.

Para los archivos de entrada, sus comandos SITE no necesitan coincidir

con los atributos del archivo existente. Esto aplica a todos los tipos de archivos VSAM.

Los registros de longitud fija se rellenan si es necesario al escribir en

el spool VSE/POWER. Cuando se produce relleno, los archivos de texto se rellenan con espacios en blanco y los archivos binarios se

rellenan con ceros binarios.

Si utiliza el tipo “bloqueado” (VB o FB) para la salida, se

proporcionará el parámetro “(nnnn)” del comando DEFINE

CLUSTER RECFM pasado a la utilidad IDCAMS, donde nnnn es

la longitud del registro. De lo contrario, utilice el formato de registro “F” o “V”.

La siguiente tabla muestra los valores apropiados.

Input Output

recfm lrecl blksize lrecl blksize

F Tamaño del Registro N/A N/A1 N/A

1

V Tamaño Máximo

del Registro

N/A N/A1 N/A

1

1 Depende de si existe el archivo de salida. Los parámetros del

comando SITE se pasan a la utilidad IDCAMS sólo después de la creación del archivo.

Para los archivos VSAM ESDS y KSDS, tenga en cuenta la siguiente información.

Los registros de longitud fija se rellenan si es necesario al escribir en

el spool VSE/POWER. Cuando se produce relleno, los archivos de

texto se rellenan con espacios en blanco y los archivos binarios se

rellenan con ceros.


RECFM

Input LRECL Input BLKSIZE

Output LRECL

Output BLKSIZE

F Tamaño de Registro N/A N/A N/A

V Tamaño Máximo de

Registro

N/A N/A N/A

63


Consideraciones a Archivos TAPE

Consideraciones a Archivos VSE/POWER

Para archivos TAPE, tenga en cuenta la siguiente información:


Cuando se produce relleno, los archivos de cinta se rellenan con


Para eliminar la necesidad de comandos SITE, su administrador VSE puede definir el mismo archivo físico con dos nombres públicos

diferentes (para entrada y salida) y asignar diferentes valores

LRECL y BLKSIZE a cada uno.

La siguiente tabla muestra los valores apropiados para los archivos TAPE.

Input Output


F Tamaño de

Registro

N/A Tamaño de

Registro +8

N/A

FB Tamaño de

Registro

Tamaño de

Registro por Valor de

Bloqueo

Tamaño de

Registro

(Tamaño de

Registro por Valor de

Bloqueo) + 8

V Tamaño de

Registro

Máximo

N/A Tamaño de

Registro

Máximo +8

N/A

VB Tamaño de

Registro

Máximo

Tamaño

Máximo de

Bloqueo

Tamaño de

Registro

Máximo

Tamaño

Máximo de

Bloqueo +8

UN Tamaño de

Registro Máximo

N/A Tamaño de

Registro Máximo

N/A

Para archivos VSE / POWER, tenga en cuenta la siguiente información:

Los registros de longitud fija se rellenan si es necesario al

escribir en el carrete POWER. Cuando se produce relleno, los

archivos de texto se rellenan con espacios en blanco y los archivos binarios se rellenan con ceros.

El LRECL mínimo para los archivos de fila POWER RDR es 80

y el máximo es 128.

El LRECL mínimo para los archivos de fila POWER LST es 1

y el máximo es 32766.

Los archivos de fila LRECL para POWER PUN deben ser 80.

64


La siguiente tabla muestra los valores apropiados para este tipo de archivo.

RECFM

Input LRECL Input BLKSIZE

Output LRECL

Output BLKSIZE


V Tamaño de Registro Máximo

N/A N/A N/A

Consideraciones a Archivos ICCF

Consideraciones a Archivos de Librería

Ejemplo de Archivo CA Vollie™

Para los archivos ICCF, tenga en cuenta la siguiente información:

Los archivos son sólo lectura.

Los archivos siempre contienen registros de 80 bytes, independientemente

de la especificación.


RECFM

Input LRECL

Input BLKSIZE

Output LRECL

Output BLKSIZE

F N/A N/A N/A N/A

Para los archivos de la librería, tenga en cuenta la siguiente información:

FTP de fases no es compatible.

Los miembros de la librería siempre contienen registros fijos de 80

bytes o un archivo de cadena que consta de una sola cadena de bytes.

El formato de librería SV es una forma especial de archivo de

cadena definida por CSI International. Se utiliza para cargar miembros HTML en librerías VSE.


RECFM

Input LRECL

Input BLKSIZE

Output LRECL

Output BLKSIZE

F 80 N/A 80 N/A

SV Variable N/A Variable N/A

S N/A N/A N/A N/A

El siguiente ejemplo muestra cómo definir un archivo de CA Vollie.

1. Localice el IPNFVOLL.OBJ en OEM.TCPIP (una sublibrería CSI).

2. LINK el objeto a una fase, colóquelo en OEM.CONFIG (una sublibrería CSI), y catalogue la fase como OLLFILE.

65


3. Realice un ciclo de TCP/IP FOR VSE, luego emita un DEFINE FILE:

El archivo TYPE=VOLLIE puede ser usado ahora. Por ejemplo, podría

usar el cliente de EMAIL de TCP/IP FOR VSE para adjuntar un miembro de CA Vollie a un correo electrónico.


AUTOLOAD

Determina la carga automática de los controladores de I/O de archivos cuando se definen los archivos.

DEFINE FILEIO

Carga una fase de controlador de I/O de archivo en el almacenamiento.

DEFINE TRANSLATION

Carga y controla las tablas de traducción ASCII/EBCDIC.

DELETE FILE

Elimina un archivo del sistema de archivos TCP/IP FOR VSE.

MODIFY FILE

Cambia los parámetros y las características de una entrada en el sistema de

archivos TCP/IP FOR VSE.

QUERY FILES


QUERY FILEIO

Muestra el estado de los programas del controlador de I/O de archivo.

SECURITY

Controla las funciones de seguridad TCP/IP FOR VSE.

DEFINE FILE,TYPE=VOLLIE,DLBL=OLLFILE,PUBLIC='OLLFILE'

66

Capítulo 3 Descripción de Comandos: DEFINE FILEIO

DEFINE FILEIO

Sintaxis

Argumentos

Ejemplo

Notas

El comando DEFINE FILEIO carga una fase de controlador de I/O de archivo

en el almacenamiento. Consulte las notas a continuación para obtener

orientación sobre el uso de este comando.

DEFine FILEIO TYPe=type [,DRIVer=phase-name]

TYPE= Una etiqueta que aparece en la salida QUERY FILEIO. Consulte el comando DEFINE FILE para obtener una lista de tipos de archivo

válidos.

Nota: Este comando no se aplica a los módulos de controlador

suministrados por el proveedor para los tipos de archivos que no son

CSI: CONDOR, FALCON y VOLLIE. Vea “Ejemplo de Archivo CA Vollie™ ”, pág. 64.

DRIVer= Si se especifica, esta fase se carga desde la lista de búsqueda de la librería cuando se inicializa el controlador del conjunto de datos. Si

no se especifica, se utiliza una fase predeterminada.


Un controlador de I/O de archivo es un programa externo que interactúa

con la pila TCP/IP FOR VSE y controla la adquisición y entrega de datos. Los

módulos de controlador para los tipos de archivos más comunes, como LIBR y POWER, se cargan automáticamente cuando la pila se inicializa. (AUTOLOAD

debe establecerse en ON). El comando DEFINE FILEIO es necesario para

cargar cualquier módulo de controlador que no se cargue automáticamente. Una vez que se carga un módulo, ese programa de acceso especializado estará

disponible para las aplicaciones TCP/IP FOR VSE. Por ejemplo, debe usar

DEFINE FILEIO para cargar un módulo de controlador para el tipo BIM-EDIT.

Use DEFINE FILEIO para cargar estos tipos de módulo:

Un módulo de controlador para un tipo de archivo asociado con

un producto CSI International como BIM-EDIT. Este tipo

requiere una licencia BIM-EDIT, y debe vincular el archivo

.OBJ para que el módulo del controlador sea utilizable. Vea

también “Para BIM-EDIT” a continuación.

Un módulo de controlador definido por el usuario.

define fileio,type=BIM-EDIT IPN264I File driver defined, Dataset: BIM-EDIT

define fileio,type=LIBRARY,PHASE=MYFILEIO IPN264I File driver defined, Dataset: LIBRARY

67

Capítulo 3 Descripción de Comandos: DEFINE FILEIO

Todos los tipos de archivo tienen una fase de controlador

predeterminada. Si anula el valor predeterminado al especificar una fase del controlador cuando define un archivo (usando DEFINE FILE),

es posible que necesite usar DEFINE FILEIO para cargar esa fase en el

almacenamiento. Use QUERY FILEIO después de la inicialización del sistema para verificar qué controladores están cargados. Se pueden

asociar varias fases de controlador con un tipo de archivo determinado.

En el ejemplo anterior, una entrada de tipo LIBRARY está asociada

con la fase MYFILEIO. Otra entrada de tipo LIBRARY está asociada

con la fase predeterminada IPNFLIBR, que se carga al inicio.

DEFINE FILEIO no se necesita normalmente. Debe usarlo sólo si

tiene problemas para usar un método de acceso a archivos

específico, como BIM-EDIT, para acceder a un sistema de archivos. Use QUERY FILEIO para verificar primero si el controlador

necesario, con el tipo de archivo designado, está cargado. Si no está

cargado, use DEFINE FILEIO. Sin embargo, si ya está cargado, entonces sabrá que un controlador faltante no es el problema.

Para BIM-EDIT: el orden de inicio de TCP/IP y BIM-EDIT es

importante para que la interfaz BIM-EDIT funcione correctamente. TCP/IP debe seguir a BIM-EDIT. Si se inició TCP/IP antes de BIM-

EDIT, entonces puede ser necesario emitir las siguientes instrucciones:

aunque parezca que el controlador de archivo IO para BIM-EDIT se cargó en el momento del inicio de TCP/IP.

Después necesita una instrucción DEFINE FILE como:


AUTOLOAD

Controla la carga automática de los controladores de I/O de archivo.

DEFINE FILE

Define un archivo en el sistema de archivos TCP/IP y lo asocia

con un controlador de I/I de archivo.

DELETE FILEIO

Elimina un controlador de I/O de archivo del almacenamiento.

QUERY FILEIO

Muestra el estado de los programas del controlador de I/O de archivo.

QUERY FILES

Muestra el contenido del sistema de archivos TCP/IP.

DELETE FILEIO,ID=IPNFBIME

DEFINE FILEIO TYPE=BIM-EDIT

DEFINE FILE,PUBLIC='BIMEDIT',DLBL=BIFLIB,TYPE=BIM-EDIT

68

Capítulo 3 Descripción de Comandos: DEFINE FTPD

DEFINE FTPD

Sintaxis

El comando DEFINE FTPD inicia un daemon FTP (servidor).

DEFine FTPd ID=id [,PORT=21] [,MAXACTive=3]

[,UNIX={Yes|No|Binary}] [,TRANslate=name16]

[,TIMEOut=2m] [,BSize=64K] [,WELCOME=member]

[,EXTtypes={Yes|No}]

[,EXTRADATA={FAIL|WARN|IGNORE|ACCEPT}]

[,DYNfiles={Yes|No}] [,ALLowabort={Yes|No}]

[,HESitate=0] [,IDLEtimeout=0]

[,SITELAST={Yes|No}] [,SSL={YES|NO|YESCLAuth}]

[,SSLKEY=member]

[,SSLVERsion={SSL30|TLS10|TLS11|TLS12}]

[,SSLCIPHER={ALL|WEAK|STRONG|AES|DES|NULL|

HARDware|MEDIUM}]

[,SSLMODE={IMPLICIT|EXPLICIT}]

[,SSLDATAconn={CLEAR|PRIVATE}]

[,ZEROerr={Yes|No}] [,IPaddr=ip4addr]

[,UPPERcase={Yes|No}] [,SENDFast={Yes|No}]

[,REXX={Yes|No}] [,SENDWack={Yes|No}]

Argumentos ID= Nombre único para identificar este daemon.

PORT= Especifica el número de puerto TCP/IP que debe monitorear este daemon

FTP. El puerto predeterminado es 21. Puede especificar cualquier valor

entre 0 y 65535, pero debe evitar los valores inferiores a 4096 para evitar colisiones con puertos que tienen usos estándar. FTP utiliza el puerto

especificado para establecer la conexión de control. Cuando se transfieren

datos, se asigna otro puerto para la conexión de datos.

BSize= El tamaño de los buffers que utilizará FTP. El tamaño predeterminado es 65536. Puede anular cualquier valor entre 4096

y 131072.

EXTtypes= La mayoría de los clientes FTP GUI “mienten” sobre los tipos de

archivos. Siempre especifican transferencias “binarias”. Como esto no funcionará si el archivo contiene texto, la Tabla de Tipos

Externos asigna los archivos a tipos de archivos específicos

marcando la extensión. Los valores de transferencia predeterminados para ese tipo de archivo se utilizan.

69


Yes (Predeterminado) El daemon FTP consulta al miembro EXTTYPES.L

(cargado por RELOAD EXTYPES), busca una entrada de tipo de archivo que coincida con cualquier parte del nombre del archivo y

utiliza valores de transferencia asignados si se encuentra una

coincidencia. Estos valores anulan otras configuraciones.

No El daemon FTP no consulta al miembro EXTTYPES.L. Todas

las opciones de procesamiento deben especificarse explícitamente. Consulte también SITELAST = para obtener

más información sobre cómo especificar opciones.

UPPERcase= Las RFC que definen el comportamiento de FTP indican que el cliente sólo puede confiar en el valor numérico de cada respuesta. El texto es

sólo para uso humano. Si los problemas de traducción lo requieren,

este parámetro garantiza que el texto se envíe sólo en mayúsculas.

Yes Hace que las respuestas al cliente estén en mayúsculas.

No (Predeterminado) Las respuestas al cliente están en mayús. y minús.

SENDWack= Normalmente, el daemon FTP transmite datos tan rápido como puede

escribirse en la red. Sin embargo, dependiendo de la sobrecarga del sistema de archivos, esto puede monopolizar la CPU y/o la red. Este parámetro se

puede usar para hacer que el daemon acelere la transmisión de salida.

Yes Hace que el daemon espere una respuesta del cliente remoto

después de que se envíe cada buffer de transferencia. Esto ayuda a acelerar las transmisiones para evitar monopolizar la CPU y la red.

No (Predeterminado) El daemon no espera automáticamente a

que se reconozca cada buffer antes de llenar otro.

REXX= Los usuarios de FTP pueden ejecutar procedimientos REXX en la partición

TCP/IP. Hacerlo puede exponer la pila a demoras e inestabilidad, sin

embargo, tenga cuidado si establece esta opción en YES.

Yes Permite a los usuarios ejecutar REXX utilizando el comando

SITE REXX. Tenga en cuenta que permitir esta función expone a

la pila a posibles problemas de seguridad, rendimiento e integridad.

No (Predeterminado) El comando SITE REXX no está permitido.

70


SENDFast= Normalmente, el daemon FTP llena un buffer mientras se transmite el otro. Esto generalmente es suficiente para mantener los datos fluyendo

a su velocidad máxima. Sin embargo, si la configuración del sistema es

tal que esto proporciona un almacenamiento en buffer inadecuado, un método alternativo permite el almacenamiento en buffer adicional.

Yes Los buffers de transferencia se llenan y se ponen en fila hasta que el total

de bytes en fila alcanza un valor igual a cuatro buffers de transferencia.

No (Predeterminado) Dos buffers de transferencia se llenan y se ponen en fila para la transmisión de salida. Un buffer no se rellena hasta que la pila

remota reconoce el recibo de los datos.

HESitate= Este valor se usa para acelerar la transmisión de datos cuando existe la preocupación de que la velocidad de transferencia de datos pueda exceder

lo que la red y el sistema pueden soportar. Cuando está vigente, se produce

una pausa de la longitud especificada después de cada SEND y RECEIVE.

Los valores permitidos son de 0 a 99999 (unidades de 300 segundos).

Un valor de 0 (el valor predeterminado) evita el paso.

IDLEtimeout= Si no es cero, esto especifica el tiempo máximo (en unidades de 300 segundos)

que una sesión FTP puede permanecer inactiva antes de finalizar. El tiempo de

inactividad no se acumula mientras una conexión de datos está abierta. Los valores permitidos varían de 0 (predeterminado) a 999999 (~ 56 minutos).

SSL= Al definir un daemon FTP, debe elegir si las conexiones serán normales (sin

cifrar, texto claro) o seguras (cifradas y autenticadas en algún nivel). El uso de

SSL requiere que el cliente y el host remoto también admitan el cifrado. Cuando SSL está habilitado, es una práctica normal usar un puerto que no sea

el valor estándar de 21.

NO (Predeterminado) Las conexiones encriptadas no son compatibles.

YES Las conexiones serán encriptadas.

YESCLAUth Las conexiones se encriptarán y el cliente debe proporcionar

un certificado de autorización.

SSLKEY= La library.sublibrary.member de la que el procesamiento SSL

obtendrá miembros de los tipos “.prvk”, “.cert”, and “.root.”

71


SSLVERsion= Esta opción especifica la versión mínima del protocolo TLS/SSL

que los clientes deben usar al conectarse.

TLS12 Sinónimo: 0303 TLS12 es el más seguro, pero no todos los clientes pueden admitirlo.

TLS11 Sinónimo: 0302

TLS11 es más mejorado.

TLS10 Sinónimos: 0301, TLSV1 El protocolo TLS contiene importantes correcciones de seguridad

y mejoras sobre SSL30.

SSL30 Sinónimos: 0300, SSLV3

SSLCIPHER= Para las sesiones SSL/TLS, este parámetro determina qué cifrados

estarán disponibles. El valor depende de la versión de protocolo SSL/TLS utilizada.

Los valores válidos para las versiones de protocolo SSL30,

TLS1.0 y TLS1.1 son los siguientes:

ALL (Predeterminado) Use los conjuntos de aplicaciones establecidos por la opción SSLCIPH= en $SOCKOPT.PHASE. En la fase

predeterminada, la opción SSLCIPH= está configurada en "A", lo que permite utilizar todos los conjuntos de cifrado compatibles. Para

obtener más información, consulte el “Apéndice A: Fase de opciones de $SOCKOPT” en la Guía del Programador de TCP/IP FOR VSE.

WEAK Las siguientes cifras débiles se permiten:

09 RSA_DESCBC_SHA

08 RSA_DES40CBC_SHA1

MEDIUM Las siguientes cifras de mediana fuerza son permitidas:

2F RSA_AES128CBC_SHA

0A RSA_3DESCBC_SHA

09 RSA_DESCBC_SHA

STRONG Las siguientes cifras fuertes son permitidas:

35 RSA_AES256CBC_SHA


72


0A RSA_3DESCBC_SHA

AES Las siguientes cifras son permitidas:

35 RSA_AES256CBC_SHA


DES Las siguientes cifras son peritidas:

0A RSA_3DESCBC_SHA

09 RSA_DESCBC_SHA

08 RSA_DES40CBC_SHA1

NULL Las siguientes cifras nulas son permitidas:

02 RSA_NULL_SHA1

01 RSA_NULL_MD5

HARDware Cuando se especifica HARDware, el hardware de Crypto Assist será

consultado para todas las asistencias disponibles de la Función de Asistencia Criptográfica CP (CPACF, por sus siglas en inglés). Tenga

cuidado al seleccionar esta opción para asegurarse de que la CPU de su

sitio admite las instrucciones de consulta de KMC.

Los valores válidos para la versión del protocolo TLS 1.2 son los siguientes.

Estas suites no son compatibles con el algoritmo DES. La compatibilidad con TLS 1.2 también requiere la función de hardware CPACF de IBM.

ALL (Predeterminado) Use los conjuntos de aplicaciones establecidos por

la opción SSLCIPH= en $SOCKOPT.PHASE. En la fase predeterminada, la opción SSLCIPH= está configurada en "A", lo

que permite utilizar todos los conjuntos de cifrado compatibles. Para

obtener más información, consulte el “Apéndice A: Fase de opciones

de $SOCKOPT” en la Guía del Programador de TCP/IP FOR VSE.

WEAK La siguiente cifra débil es permitida:

2F RSA_AES128CBC_SHA160

MEDIUM La siguiente cifra de media fuerza es permitida:

35 RSA_AES256CBC_SHA160

3C RSA_AES128CBC_SHA256

STRONG La siguiente cifra fuerte es permitida:

3D RSA_AES256CBC_SHA256

73


SSLMODE= Establece el modo de negociación. Los valores son los siguientes.

IMPLICIT (Predeterminado) La negociación SSL/TLS se realiza inmediatamente cuando se establece la conexión (antes de

que se envíe el mensaje de bienvenida 220).

EXPLICIT La negociación SSL/TLS se retrasa hasta que se recibe un comando AUTH. Esto es algo menos seguro porque el mensaje inicial de bienvenida 220 se envía en texto claro.

SSLDATAconn= Esta opción controla el encriptado en la conexión de datos.

CLEAR (Predeterminado) Hace que los datos se transmitan de

forma clara, sin cifrado.

PRIVATE Hace que los datos se transmitan en un estado encriptado.

SITELAST= Esta opción determina la capacidad del usuario para anular ciertos valores

que pueden haberse especificado en comandos individuales DEFINE FILE.

Yes

Los comandos SITE tienen prioridad sobre los siguientes

parámetros DEFINE FILE: BLKSIZE, CC, CRLF, LRECL,

RECFM, TRCC. Nota: Los valores de transferencia predeterminados asignados por la tabla EXTTYPES para un

tipo de archivo coincidente siempre tienen prioridad cuando

EXTTYPES = YES.

No (Predeterminado) Los parámetros especificados en los comandos

DEFINE FILE tienen prioridad sobre la configuración del

comando SITE de un usuario.

DYNfiles= En algunos casos, es posible que desee permitir que los usuarios

especifiquen archivos mediante DLBL en lugar de restringirlos a

usar nombres públicos definidos en el sistema de archivos TCP/IP.

Yes (Predeterminado) Los usuarios pueden acceder a archivos fuera del sistema de

archivos TCP/IP (archivos autónomos) especificando el DLBL de un archivo. Para obtener más información, consulte la Guía del Usuario de TCP/IP FOR

VSE, capítulo 2, “FTP”, subsección “Nombres de Archivos VSE”

No Especificar NO impide el acceso a los archivos por DLBL,

restringiendo el acceso a sólo aquellos archivos definidos

por el comando DEFINE FILE.

74


Esta es la configuración recomendada para evitar el

acceso no deseado a los archivos.

ALLowabort= Una vez que comienza la transmisión de datos, la conexión de control permanece inactiva hasta que se completa. Una excepción es el comando

"abortar". Si está habilitado, el daemon monitorea la conexión de control

durante la transferencia de datos y permite que el cliente anule la transferencia.

Yes (Predeterminado) El cliente puede enviar un comando de cancelación (ABRT) para detener la transmisión de datos actual.

No El daemon ignora cualquier entrada en la conexión de control hasta

que se complete la transferencia de datos.

EXTRADATA= Esta opción controla lo que se hace cuando un archivo de texto entrante

tiene datos adicionales al final. Los “datos adicionales” (que sólo pueden aparecer en un archivo de texto) se definen como una cadena de texto que

no termina correctamente con un CR / LF u otro delimitador válido.

FAIL (Predeterminado) La transferencia falla y el archivo no se

almacena. Aparece un mensaje FTP343W y se envía un código

de falla 5xx al cliente.

WARN Se genera un mensaje de advertencia, pero el archivo se

almacena. Se envía un código normal al cliente. Los datos

adicionales se descartan.

IGNORE No se generan mensajes. El archivo se almacena y los datos

adicionales se descartan.

ACCEPT No se generan mensajes. El archivo se almacena con los datos adicionales

como si fuera un registro completo delimitado correctamente.

MAXACTIVE= Cada daemon FTP admite múltiples sesiones concurrentes. Este parámetro le permite establecer el número máximo de sesiones de

usuario que pueden estar activas en un momento dado. Los valores

varían de 1 a 32767. El valor predeterminado es 3.

UNIX= En general, los clientes FTP GUI interpretan y muestran información relacionada con la sesión FTP. Para que esto suceda, la

información proporcionada por el daemon debe estar en la forma

que el cliente espera. El formato esperado es el producido por un

daemon Unix. Los valores válidos son los siguientes.

75


Binary Cuando el cliente FTP especifica "BINARY" (TYPE I), se realiza una verdadera transferencia binaria. El comando DIR

devuelve una lista de directorios en el formato estándar de

Unix que los clientes GUI entienden.

Yes El daemon FTP imita la operación de Unix. Esto es importante si

utiliza clientes FTP gráficos (GUI) porque muchos de estos clientes no pueden reconocer una lista de directorios de estilo VSE. Para

dejar de operar en el modo de emulación Unix, el usuario puede

ingresar el comando FTP “CD\” o usar “SITE UNIX OFF”.

No El daemon FTP funciona en modo VSE. Este es el valor predeterminado.

Las listas de directorio se devuelven en formato "VSE" con información

pertinente a los archivos basados en mainframe. Para ingresar al modo Unix,

el usuario puede ingresar un comando “CD/” o usar “SITE UNIX ON.”

WELCOME= Esta opción especifica el miembro VSE que contiene texto específico del

sitio que se envía al usuario junto con el mensaje 220 al comienzo de cada nueva sesión. Este miembro debe estar catalogado. Por ejemplo, si el

nombre del miembro es “GREETING”, entonces “GREETING L” debe

catalogarse en la cadena LIBDEF como parte de la inicialización de

TCP/IP. No se utiliza texto en las columnas 73 a 80.

TRANslate= Especifica el nombre de una tabla de traducción opcional para la

traducción ASCII/EBCDIC.

Esta especificación anula el comando SITE TRANSLATE. No

anula el parámetro TRANSLATE= del comando DEFINE FILE asociado con la transferencia. Si desea que los usuarios de FTP

puedan especificar una tabla de traducción, omita este parámetro

en el comando DEFINE FTPD.

TIMEOut= Especifica un intervalo de tiempo de espera para la conexión de

datos en unidades de 300 segundos. Aunque los protocolos FTP no

reconocen el concepto de tiempo de espera, es esencial desde un punto de vista práctico. Cuando se excede el intervalo de tiempo

sin una respuesta de ningún tipo del host remoto, la sesión FTP

finaliza. Esto ocurre sólo durante la transmisión de datos real; el

daemon esperará el valor IDLETIMEOUT en un nuevo comando. El valor predeterminado es 36000 (2 minutos); El valor máximo es

999999 (~ 56 minutos).

ZEROerr= Este parámetro determina cómo reacciona el daemon cuando se le

pide que procese un archivo vacío (nulo).

76


Yes (Predeterminado) Se genera un mensaje de error de nivel 500

(un error fatal) cuando un usuario intenta transferir un archivo vacío (uno con cero bytes de datos).

No La transferencia de un archivo vacío se considera aceptable.

IPaddr= Si se especifica, la dirección IP remota en una solicitud de conexión

entrante se compara con este valor. Dependiendo de cómo se

configure el comando CONNECT_SEQUENCE, la selección será el primer ajuste o el mejor se ajuste.

La coincidencia no se realiza cuando tanto el cliente como el

daemon se ejecutan bajo la misma pila.

Ejemplo


No hay un comando MODIFY FTPD. Para cambiar las

especificaciones, debe eliminar y redefinir el daemon FTP.

Las transferencias de archivos pueden monopolizar fácilmente su interfaz de red e incluso la propia red. La ejecución de múltiples transferencias

simultáneas de archivos puede reducir la velocidad de transferencia y

degradar el tiempo de respuesta de la red. Considere esto cuidadosamente al determinar la cantidad de daemons FTP que definirá. Vea la Guía de

Instalación de TCP/IP FOR VSE para obtener más información sobre

cómo definir daemons FTP.

El programa de utilidad FTPBATCH se puede configurar para ejecutarse como un servidor FTP. Esto le permite ajustar su prioridad de

procesamiento a un valor más bajo sin afectar las porciones de la pila que

dependen del tiempo. Vea la Guía de Instalación de TCP/IP FOR VSE

para obtener detalles sobre la configuración de un servidor FTPBATCH.

Vea la Guía del Usuario de TCP/IP FOR VSE para obtener

información sobre la ejecución en modo de compatibilidad UNIX.

Consulte “SecureFTP para VSE” en la Guía de Características

opcionales de TCP/IP FOR VSE para obtener más información sobre

el uso de los parámetros SSL=, SSLKEY=, SSLCIPHER=,

SSLVERSION=, SSLMODE= y SSLDATACONN=.

Los cifrados predeterminados se establecen mediante la palabra clave

SSLCIPH en $SOCKOPT. Vea la Guía del Programador TCP/IP FOR

VSE, “Apéndice A: $Fase de opciones de SOCKOPT”.

define ftpd,id=ftp01,port=21,unix=yes,welcome=greet1,maxact=5 FTP900I FTP Daemon: FTP01 listening on 192.168.1.161,21

77



ASECURITY FTPC

Establece si se rechazan ciertos comandos FTP.

CONNECT_SEQUENCE

Controla si las solicitudes de conexión se asignan mediante la

verificación de patrones de dirección IP.

DEFINE FILE

Define un archivo en el sistema de archivos TCP/IP y lo asocia con un controlador de I/O de archivo.

DEFINE TRANSLATION


DELETE FTPD

Termina un daemon de Protocolo de Transferencia de Archivos.

PORTRANGE Controla el rango para la asignación dinámica de puertos.

QUERY ACTIVE

Muestra el estado de los daemons activos.

QUERY FTPDS

Muestra el estado de los daemons del Protocolo de Transferencia de

Archivos.

RELOAD

Recarga una mesa de control.

78

Capítulo 3 Descripción de Comandos: DEFINE GPSD

DEFINE GPSD

Sintaxis

Argumentos

Este comando se utiliza para definir e iniciar el procesamiento por un

daemon del Servidor de Impresión General (GPS). La instrucción de

sintaxis completa es la siguiente. Consulte las definiciones de parámetros individuales para su aplicación en situaciones específicas.

DEFine GPSd ID=id ,IPaddr=host ,TERMname=lu

[,ALTlength=132] [,BRACKet_eject={Yes|No}]

[,CMDn=string] [,CONTrol_order=NFU]

[,DEBug={Yes|No}] [,EMULate={3287|Transparent}]

[,INSerts=member] [,INSESsion={No|Yes}]

[,LINELength=132] [,LOG={No|Yes}]

[,LOGMode=mode] [,MAXChars=1m] [,MAXIdle=10s]

[,MAXLines=10k] [,MAXPages=1k] [,NRT=60s]

[,NRC=3] [,NOEJect={No|Yes}]

[,OUTput={Lpr|Direct} [,PORT=515]]

[,PRinter=name] [,Queuing={Disk|Memory}]

[,STORage=pubname] [,TARGet=appl]

[,TRANslate=name16] [,TYPE=VTAM] [,VRC=10]

[,VRT=60s]

ALTLength= Especifica la longitud de línea que se utilizará si una aplicación usa el comando ERASE WRITE ALTERNATE. Si una aplicación emite un

comando ERASE WRITE ALTERNATE, la impresora 3270 se

configura con sus características alternativas. Consulte la descripción del parámetro LINELEN para obtener más información sobre GPS y

longitudes de línea. Esto no se usa con EMULATE=TRANSPARENT.

BRACKET_EJECT= El GPS normalmente interpreta que un "soporte de inicio" de VTAM causa

un avance de formulario. Si este comportamiento no es apropiado en su entorno, codifique NO. No se utiliza con EMULATE=TRANSPARENT.

Yes El GPS realiza una expulsión de página cada vez que se recibe

un "inicio de soporte" de VTAM.

No El GPS ignora un “soporte de inicio” de VTAM.

CMDn= Se proporcionan tres comandos, CMD1=, CMD2= y CMD3=, para

admitir versiones intermedias de GPS. Los valores y las acciones de

los parámetros variarán con cada versión. Use este argumento sólo cuando lo indique el Soporte Técnico de CSI.

79


CONTrol_order= Una cadena de 1 a 3 caracteres: U, F y N.

Durante el procesamiento LPR/LPD, se construye y transmite un

archivo de control. Este archivo contiene comandos como "imprimir" y "eliminar". Aunque los RFC no tienen claro el orden

requerido, el valor predeterminado de "NFU" funciona con la gran

mayoría de los daemons LPD. Si es necesario, puede modificar el orden u omitir uno de los comandos. Este parámetro se usa sólo con

OUTPUT=LPR.

N El nombre del archivo de impresión en cuestión.

F El comando "imprimir".

U El comando "eliminar".

DEBug= El GPS proporciona un modo de depuración que captura y guarda datos adicionales.

Cuando la depuración está activa, las transmisiones VTAM sin

procesar se guardan en el archivo de almacenamiento. Puede revisar

los datos para ver con precisión con qué GPS tiene que trabajar. Cuando haya terminado, debe eliminar manualmente estos archivos.

Tenga en cuenta que el modo de depuración puede requerir un

espacio considerable en la librería, dependiendo de la cantidad de datos que se impriman.

Yes Ejecute este daemon GPS en modo de depuración. También

debe incluir el parámetro STORAGE=. También tenga en cuenta que la codificación YES hace que cada daemon requiera

un almacenamiento adicional de 100k (aprox.) De 24 bits.

No (Predeterminado) Ejecute este daemon en modo normal.

EMULate= Este parámetro controla el tipo de emulación de impresora realizada.

3287 (Predeterminado) GPS emula una impresora 3287 en la medida de lo posible.

Transparent El GPS transmite los datos exactamente como los recibió de la

conexión VTAM. Se eliminan el carácter de comando y el carácter de control de escritura (WCC). El resto de la secuencia

se trata como una "página". No se realiza la traducción a ASCII.

80


ID= Este es un identificador único asignado al daemon GPS. Este

identificador aparece en los mensajes y se muestra relacionado con este daemon.

INSERts= Si se especifica, esta fase se carga y su contenido se incluye en los

datos enviados a la impresora. Los datos de INSERTS incluyen información de control que puede preceder a un informe, seguir un

informe y seguir cada alimentación de formulario incrustado.

INSESsion= Determina si el daemon intenta una conexión inmediata con la

aplicación TARGET= o si espera una solicitud de conexión

externa. Tenga en cuenta que, si la aplicación libera el enlace, el daemon

no realiza intentos de enlace adicionales, independientemente de

esta configuración.

Yes El daemon GPS está dirigido a intentar vincularse con la

aplicación especificada en el parámetro TARGET= inmediatamente al inicio.

No (Predeterminado) El daemon GPS espera a que la aplicación

inicie la solicitud de enlace.

IPaddr= Esta es la dirección IP del host remoto al que se transmitirán los

datos. Si se especifica un nombre de host, puede tener hasta 64

caracteres.

LINELength= Esto establece la longitud máxima de la línea de la impresora. La

emulación 3287 proporciona una longitud de línea máxima de 132.

Cuando se llena la línea, la impresora fuerza una operación de

nueva línea. Si su aplicación necesita imprimir líneas más largas, puede aumentar la longitud máxima de línea de la impresora hasta

255 caracteres. No se utiliza con EMULATE=TRANSPARENTE.

LOGMode= Esto establece el VTAM LOGMODE que se utilizará para negociar un enlace con la aplicación VTAM. El valor predeterminado (y

recomendado) es DSC2K. Este es un LOGMODE no SNA

suministrado por IBM para impresoras. Este parámetro es efectivo sólo si también especifica los parámetros INSESSION=YES y

TARGET=.

81


LOG= Esta opción controla el uso de un archivo de registro.

Yes Hace que el daemon GPS cree un archivo de registro. El nombre

del archivo de registro es el valor especificado para TERMNAME con una extensión de LOG. Este archivo se sobrescribe cada vez

que se reinicia el daemon. El archivo es un archivo de texto

simple, y puede usar las instalaciones estándar de VSE para verlo o imprimirlo. También debe incluir el parámetro STORAGE=.

Tenga en cuenta que codificar YES hará que cada daemon

requiera un almacenamiento adicional de 100k (aprox.) de 24 bits.

No (Predeterminado) No se abrirá ni usará ningún archivo de registro.

MAXChars= Los caracteres máximos que pueden acumularse antes de forzar una

operación LPR. Debido a que LPR es un protocolo en fila y el GPS está emulando un dispositivo en serie, el GPS usa el parámetro MAXCHARS

como una forma de determinar cuándo segmentar el informe y

transmitirlo usando LPR. La desventaja de la activación por recuento de caracteres es que se introducen saltos de página extraños. El valor

predeterminado es 1,000,000 de caracteres; el máximo es 999,999,999.

Este parámetro sólo tiene efecto si también se especifica OUTPUT=LPR.

MAXIdle= Cuando se utiliza el protocolo LPR/LPD, este parámetro especifica cuánto tiempo de inactividad (en intervalos de 300 segundos) puede

transcurrir antes de forzar una operación LPR. Debido a que LPR es

un protocolo en fila y el GPS está emulando un dispositivo en serie, el GPS usa el parámetro MAXIDLE como una forma de determinar

cuándo segmentar el informe y transmitirlo usando LPR. El “tiempo

de inactividad” se define como el tiempo entre las transmisiones de VTAM a GPS. El valor debe establecerse lo suficientemente alto

como para que los retrasos normales en el procesamiento no causen

una transmisión prematura del informe y saltos de página extraños.

Si se utiliza la interfaz de socket directo, este parámetro indica el

tiempo de inactividad transcurrido antes de que se cierre la

conexión de la impresora. Tenga en cuenta que la propia impresora puede interrumpir la conexión después de un intervalo inactivo

predeterminado. Si esto sucede, se producirán procedimientos de

recuperación de errores. Normalmente, el tiempo de espera de una

impresora es de entre 45 y 90 segundos, por lo que seleccionar un valor MAXIDLE razonable evitará esto.

El valor predeterminado es 3.000 (10 segundos). El valor máximo es 99,999.

82


MAXLines= Especifica las líneas de texto máximas que pueden acumularse antes de una operación LPR si es forzado. Debido a que LPR es un protocolo en

fila y el GPS está emulando un dispositivo en serie, el GPS usa el

parámetro MAXLINES como una forma de determinar cuándo segmentar el informe y transmitirlo usando LPR. La desventaja de la activación por

recuento de líneas es que se introducen saltos de página extraños. El valor

predeterminado es 10,000 líneas. El máximo permitido es 9,999,999.


MAXPages= Especifica el número máximo de páginas que pueden acumularse antes de una operación LPR si es forzado. Debido a que LPR es un protocolo en

fila y el GPS está emulando un dispositivo en serie, el GPS usa el

parámetro MAXPAGES como una forma de determinar cuándo segmentar el informe y transmitirlo usando LPR. La ventaja de activar por

conteo de páginas es que no se introducen saltos de página extraños. El

valor predeterminado es 1000 páginas. El máximo permitido es 99,999.


NRT= Este es el intervalo de tiempo que se utiliza entre reintentos de

operaciones de red, incluido LPR/LPD. Los valores oscilan entre 0 y 550

minutos. Este valor también se puede especificar como "NETWORK_RETRY_Time=". El valor predeterminado es 60s.

NRC= Este valor controla cuántas veces se volverán a intentar las fallas de red

potencialmente recuperables, incluido LPR/LPD. Los valores permitidos

oscilan entre 0 y 99.999. Este parámetro también se puede especificar

como "NETWORK_RETRY_Count=". El valor predeterminado es 3.

NOEJect= Muchos informes comienzan con un carácter de expulsión de página. El GPS normalmente pasa este carácter a la impresora. Sin embargo, según

la impresora o el daemon LP, esto puede crear una página en blanco

adicional. Tenga en cuenta que el GPS finaliza cada informe con un avance de formulario para forzar la impresión de la página final.

No se utiliza con EMULATE=TRANSPARENT.

Yes Al especificar YES, se suprime el carácter de fuente de

formulario inicial al comienzo de una lista.

No Especifique NO si no desea suprimir los caracteres de

fuente de formulario inicial.

83


OUTPut= Una palabra clave que controla cómo se conecta el GPS con el host remoto.

Lpr (Predeterminado) GPS acumula datos en "reportes" de longitud apropiada y luego transmite estos informes a un LPD remoto

utilizando el protocolo LPR.

Direct El GPS se conecta directamente con una impresora de "red". Los datos se transmiten como recibidos y no se acumulan.

Este tipo de conexión es compatible con las impresoras

JetDirect de Hewlett-Packard y muchas otras. Cuando se especifica DIRECT, el GPS abre la conexión de datos al

recibir la primera solicitud de VTAM para entregar datos. La

conexión permanece abierta hasta que la conexión VTAM

esté inactiva durante el tiempo especificado por MAXIDLE..

PORT= Este parámetro designa el puerto remoto donde se deben enviar los

datos. Para el procesamiento LPR, este valor debe ser 515, el valor

predeterminado. Para el procesamiento directo, este valor debe ser

el especificado por el fabricante de la impresora de red.

PRinter= 1 a 16 caracteres de mayúsculas y minúsculas.

Especifica un nombre de mayúsculas y minúsculas de 1 a 16 caracteres de

una fila de impresión LPD. Este valor se envía al LPD en el host remoto

para identificar la impresora de destino. Debe conocer este nombre y especificarlo aquí. De lo contrario, el LPD rechaza el intento de establecer

una sesión. Este es un parámetro requerido si OUTPUT=LPR está

especificado o implícito. El parámetro se ignora para OUTPUT=DIRECT.

Queuing= Una palabra clave que indica dónde debe almacenar datos el GPS

hasta que se acumule un "informe" completo.

Disk Cada informe se almacena en el archivo del disco de almacenamiento hasta que se procesa como una secuencia de datos

LPR. La desventaja de la puesta en fila basada en disco es que se

requiere una cantidad considerable (100k) de almacenamiento de 24 bits para admitir las rutinas y memorias intermedias de I/O. La

ventaja es que el archivo del disco se conserva en caso de error.

Memory Cada informe se almacena en GETVIS de 31 bits hasta que se procesa como una secuencia de datos LP. La ventaja es que no se

requiere GETVIS de 24 bits. La desventaja es que, si la partición

TCP/IP falla o se cierra antes de que se complete la transmisión, los datos se pierden. Si la transmisión LPR falla, los datos se escriben

en el disco antes de que el daemon se apague.

84


STORage= Especifica la biblioteca que se utilizará para organizar los datos LPR y para los archivos opcionales de registro y depuración. El archivo

especificado se refiere a un archivo definido para el sistema de archivos

TCP/IP. Este es un parámetro obligatorio si QUEUING=DISK, LOG=YES, DEBUG=YES o OUTPUT=LPR es especificado o implícito.

TARGet= Identifica el nombre de la aplicación VTAM (APPL) con el que

desea vincular el GPS inmediatamente al inicio. Este parámetro es

efectivo sólo si también especifica INSESSION=YES. Si especifica INSESSION=NO o si omite este parámetro, el GPS no intenta un

enlace y, en cambio, espera a que una aplicación inicie un enlace.

TERMname= Especifica el nombre de la aplicación VTAM que el GPS usa para

conectarse con VTAM. Este nombre también es el LUNAME que el

GPS usa para comunicarse con otras aplicaciones VTAM. Este es un parámetro requerido.

TRANslate= Especifica el nombre de la tabla de traducción que se utilizará al

convertir la secuencia de datos EBCDIC a ASCII. Si no se especifica,

se utiliza la tabla predeterminada del sistema. Este parámetro no tiene sentido si EMULATE=TRANSPARENT está en vigor.

TYPe= Especifica la interfaz que se utilizará para conectarse con la aplicación.

VTAM El daemon GPS obtiene datos a través de una interfaz VTAM.

Esta es la única interfaz predeterminada y actualmente disponible.

VRC= Numérico, de 0 a 99999.

Este valor controla la cantidad de veces que un daemon GPS volverá a

intentar cualquier operación VTAM (recuperable) antes de darse por vencido. Los valores aceptables varían de 0 (sin reintentos) a 99,999. El

valor predeterminado es 10. Este parámetro también se puede especificar como "VTAM_RETRY_Count ="

VRT= Utilizado junto con VRC=, este parámetro controla cuánto tiempo transcurre (en unidades de 300 segundos) antes de volver a intentar

cualquier operación VTAM. Los valores aceptables varían de 0 (sin

reintento) a 9,999,999. El valor predeterminado es 18000 (1 minuto). Este parámetro también se puede especificar como

"VTAM_RETRY_Time =".

85


Visión General del Proceso

Control de Segmentación

La función GPS está diseñada para permitir que las aplicaciones VSE dirijan los

flujos de impresión a impresoras habilitadas para TCP/IP. Estas impresoras pueden ser compatibles con un daemon de impresora de línea (LPD) o pueden

estar conectadas directamente a la red (Direct Socket)).

Para una aplicación VSE, el GPS parece ser una serie de impresoras conectadas a

VTAM, cada una con su propio LUname. La impresión se envía a través de la conexión VTAM como si el destino fuera una impresora física 3287.

Cuando el GPS transmite la impresión a la impresora remota, puede usar el protocolo LPD. El protocolo LPD requiere que el destino remoto sea un servidor.

Con esta técnica, el GPS debe almacenar el flujo de VTAM, formatearlo y luego

enviarlo al LPD como un conjunto de datos. Aunque la aplicación adjunta VTAM

considera que la impresión se dirige directamente a una impresora, el GPS debe dividir arbitrariamente la transmisión en una transmisión LPD discreta. El GPS

intenta segmentar informes sólo en los límites de la página. De esta manera, la

versión impresa final parecerá ser una transmisión continua.

Tenga en cuenta que el protocolo LPD REQUIERE que el host remoto reciba

completamente la transmisión antes de que pueda comenzar la impresión. En general,

esto significa que el LPD debe ejecutarse en un servidor con almacenamiento en disco. Pocas "impresoras de red" tienen esta capacidad. En cambio, simplemente imprimen el

flujo de datos a medida que se recibe. El conjunto de datos de control LPD se ignora y

se descarta. Desafortunadamente, esto tiene tres inconvenientes:

Debido a que se ignora el archivo de control, también se ignoran las solicitudes de copias múltiples, páginas de banner y otros elementos.

Debido a que los datos se imprimen en tiempo real, la conexión está

atada por la duración. Dicha impresora no puede ser compartida por

múltiples usuarios (una impresora ocupada parece estar fuera de línea

para todos los demás solicitantes).

El protocolo LPD para la recuperación de errores indica que cualquier

lote que no se transmite y reconoce por completo debe reiniciarse desde

el principio. Esto significa que cualquier interrupción en la impresión dará como resultado páginas duplicadas.

Una mejor técnica, cuando está disponible, es la conexión de "socket directo".

Esto es compatible con la mayoría de las impresoras de "red". Cuando se usa la interfaz de socket directo, no se usa ningún protocolo. Los datos recibidos por la

impresora se envían directamente al papel. El GPS no almacena en buffer.

Cuando se utiliza el protocolo LPD, el flujo de impresión debe dividirse en

partes discretas para la transmisión. Cómo y cuándo ocurre esto es controlado por los parámetros "MAX". MAXPAGES controla el número de páginas que se

incluirán en cada informe. Este es un valor nominal. Debido a la forma en que

los datos se transmiten al GPS desde la aplicación, se pueden incluir páginas adicionales. Estas páginas rara vez contienen muchos datos. Se incluyen otros

dos valores "MAX", MAXLINES y MAXCHARS, para manejar informes que

no tienen saltos de página incrustados. Estos parámetros aseguran que el GPS

no se vea inundado por un flujo de datos que no puede segmentar.

86


Si un informe es roto por MAXLINES o MAXCHARS, el salto

probablemente estará dentro de una página.

Finalmente, MAXIDLE controla cuándo se deben enviar los datos

restantes a la impresora después de que la conexión VTAM se vuelve

inactiva.

La segmentación no se produce con una conexión de socket directa, aunque MAXIDLE hará que se cierre la conexión TCP/IP con la

impresora.

Ejemplo

Notas


No hay un comando MODIFY GPSD. Para cambiar cualquier

especificación, debe eliminar y redefinir el daemon.

DELETE GPSD

Termina un daemon del Servidor de Impresión General.

QUERY GPSDS

Muestra el estado de los daemons del Servidor de Impresión General.

define gpsd,id=gps1,storage=gps.save, ipaddr=rmt1,printer=prt1 GPS900I GPS1 GPS Daemon Starting FPS917I GPS1 Waiting for BIND

87

Capítulo 3 Descripción de Comandos: DEFINE HTTPD

DEFINE HTTPD

Sintaxis

El comando DEFINE HTTPD inicia un daemon (servidor) HTTP

(Web). Sólo necesita un daemon, independientemente de la cantidad

de sesiones web que se admitan.

DEFine HTTpd ID=id ,ROOT=pubname [,PORT=80]

[,CONfine={Yes|No}] [,TRANslate=name16]

[,TIMEOut=5m] [,SECure={Yes|No}]

[,LIBrary=pubname ,SUBlibrary=name8]

Argumentos ID= Este ID define de forma exclusiva este daemon.

ROOT= Especifica el nombre público de una librería y sub-librería para ser

utilizado por el daemon HTTP. Esta librería, por defecto, contiene

todos los HTML, JPGS y otros objetos que son servidos por el daemon HTTP.

PORT= Especifica el número de puerto TCP/IP a ser monitoreado por el

daemon HTTP. El puerto predeterminado es 80. Puede especificar

cualquier valor entre 0 y 65.535, pero debe evitar los valores inferiores a 4096 para evitar colisiones con puertos que tienen usos estándar.

CONfine= Controla si las solicitudes se limitan a la especificación ROOT=.

Yes La especificación ROOT= siempre tiene el prefijo de cualquier

solicitud del cliente. Si no se encuentra el archivo, la solicitud falla.

No La especificación ROOT= está prefijada a cada solicitud del cliente. Si no se encuentra el archivo, se realiza otro intento

sin el prefijo ROOT=. Este es el valor predeterminado.

TRANslate= El daemon HTTP con frecuencia realiza la traducción EBCDIC a ASCII. Este parámetro especifica el nombre de una tabla de traducción

(como se define usando el comando DEFINE TRANSLATION) para

usar cuando se realiza esa traducción. El daemon también utiliza esta tabla cuando realiza la traducción de ASCII a EBCDIC.

TIMEOut= Este parámetro es efectivo sólo si se especifica SECURE=YES.

Este valor es el intervalo de inactividad después del cual el usuario

debe volver a suministrar un ID de usuario y contraseña. El valor predeterminado es 90,000 (5 minutos). Los valores permitidos

oscilan entre 0 y 9.999.999.

88


SECure= El daemon HTTP puede mantener un nivel mínimo de seguridad de acceso basado en la dirección de red. Para hacer esto, el daemon mantiene una

tabla de direcciones IP activas. Cuando se recibe una solicitud de una

dirección que no está en la tabla, el daemon muestra automáticamente una página solicitando un ID de usuario y contraseña. Estos valores se verifican

a través de los mecanismos estándar TCP/IP FOR VSE. Si es válido, la

dirección IP se agrega a la tabla y transmite la solicitud original.

La dirección IP se elimina de la tabla cuando se solicita explícitamente

(una solicitud realizada para "BLANKING.HTML") o cuando expira el temporizador de inactividad (TIMEOUT =).

Yes Los procedimientos de seguridad integrados del daemon están habilitados.

No (Predeterminado) La comprobación de seguridad automática no se realiza.

LIBrary= Especifica la librería que contiene los documentos de seguridad

especiales PASSWORD.HTML, VIOLATED.HTML, y

BLANKING.HTML. Si omite este parámetro, los documentos de

seguridad deben estar en el directorio raíz.

SUBlibrary= Este parámetro, junto con el parámetro LIB=, le permite especificar

la sub-librería que contiene los documentos especiales de seguridad PASSWORD.HTML, VIOLATED.HTML, y BLANKING.HTML.

Ejemplo


No hay un comando MODIFY HTTPD. Para cambiar cualquiera de las especificaciones, debe eliminar y redefinir el daemon HTTP.

En general, cuando se recibe una solicitud HTTP, las barras

diagonales se reemplazan por puntos, la cadena ROOT se agrega

como un prefijo y, si no hay ningún archivo o CGI en la solicitud, la

cadena ".INDEX.HTML" es añadido como sufijo. Cada nodo del nombre resultante se ubica en el sistema de archivos hasta que se

encuentre un archivo real o se agote el nombre solicitado. Si se

encuentra un archivo, las partes extrañas no utilizadas del nombre se descartan. Si no se encuentra ningún archivo y se especifica

CONFINE= NO, todo el proceso se repite sin la cadena ROOT.

define http,id=web,root=prd2.html

HTT900I Daemon Startup HTTP ID:WEB Port:80

89


HTML no es sensible a los saltos de línea. Sin embargo, los archivos

de la librería VSE están limitados a líneas de 80 caracteres. Si necesita saltar una línea para fines de continuación, termínela con un

ampersand (&). El daemon HTTP elimina el ampersand y agrega la

siguiente línea antes de transmitir el registro.

No se recomienda ejecutar varios daemon HTTP en el mismo

puerto. El rendimiento no mejora y no hay forma de predecir qué

daemon se asignará a una solicitud determinada.

Puede ejecutar múltiples daemons HTTP en diferentes puertos.

Esto es útil cuando también especifica diferentes librerías o cuando necesita múltiples tablas de traducción. Esto le brinda la capacidad

de alojar múltiples sitios web.


ASECURITY WEBL Establece la seguridad de acceso en base a la dirección de red.

DEFINE CGI

Carga un programa CGI y lo pone a disposición para su uso.

DEFINE FILE

Define un archivo en el sistema de archivos TCP/IP y lo asocia

con un controlador I/O de archivo.

DEFINE TRANSLATION


DELETE HTTPD

Termina un daemon del Protocolo de Transferencia de Hipertexto (servidor web).

QUERY CGIS

Muestra todos los programas CGI disponibles.

QUERY HTTPS

Muestra el estado de los daemons del Protocolo de Transferencia de Hipertexto (servidor web).

RELOAD

Recarga una tabla de control.

SECURITY


90

Capítulo 3 Descripción de Comandos: DEFINE LINK

DEFINE LINK

Sintaxis

El comando DEFINE LINK define e inicializa un dispositivo

de conexión de red.

DEFine LINK ID=id ,IPaddr=ip4addr

,TYpe={CLAW|LCS|CTCa|OSAX|IPNET}

[,DEVices=hexaddr] [,SYSid=num] [,MTU=num]

[,FORCe] [,OUTBuffers=4] [,HOSTName=name8]

[,HOSTAppl=TCPIP] [,WSName=name8]

[,WSAppl=name8] [,INFactor=4] [,OUTFactor=4]

[,RETRY_Time=time] [,STOPPED]

[,STOPLan={Yes|No}] [,SHUTdown={Yes|No}]

[,VMReset={Yes|No}]

[,ALTIP=(ip4addr [,ip4addr,...,ip4addr])]

[,ROUTER=None|Primary|Secondary}]

[,OSAPort={0|1] [,DATapath=cuu]

[,PORTName=name8] [,BUSY=nnn]

Argumentos TYpe= Este parámetro requerido indica el tipo de enlace que se está definiendo.

CLAW Interfaz CLAW conectada a una RS/600, Cisco u otra

computadora.

LCS Controlador LAN Channel Station o cualquier otro controlador de

comunicaciones 3172 compatible. Estos incluyen todas las formas del Adaptador de Sistemas Abiertos (OSA, por sus siglas en inglés)

de IBM, excepto cuando se ejecuta en modo QDIO (para ese caso,

utilice "OSAX")

Los sinónimos permitidos para LCS son “OSA”, “OSA2” y “3172”.

OSAX Un IBM OSA Express ejecutándose en modo QDIO.

CTCa Un adaptador canal a canal conectado a otro TCP/IP. El otro

TCP/IP se puede ejecutar en VSE, MVS o VM.

IPNET Un enlace de partición cruzada a otra copia de TCP/IP FOR

VSE que se ejecuta en la misma imagen de VSE.

91


DEVices= Especifica la dirección de unidad en la que reside el dispositivo. Cuando el dispositivo requiere varias direcciones, especifique la

dirección más baja. El sistema deriva las direcciones adicionales

agregando una tras otra hasta que se calculan suficientes direcciones. Para los enlaces CTCA, puede especificar dos

direcciones, separadas por comas y encerradas entre paréntesis.

SYSid= Solo para TYPE=IPNET. Especifica un numero ID que identifica

otro TCP/IP para VSE que se ejecuta en otra partición. Este número

es idéntico al valor especificado para el parámetro ID= en el campo PARM de la tarjeta EXEC del otro TCP/IP FOR VSE.

IPaddr= Especifica la dirección de red TCP/IP que se utilizará con este

enlace. La especificación permite que el host TCP/IP aparezca como

una dirección diferente para propósitos de multi-homing. Si se omite, la dirección especificada por SET IPADDR= será usada. Si

hay comandos DEFINE ADAPTER asociados, la dirección IP debe

especificarse allí, y no en DEFINE LINK.

MTU= La Unidad Transmisión Máxima transmitida en este adaptador. El valor máximo para Ethernet es 1500. Otros tipos de red permiten

valores de hasta 65535. En todos los casos, el valor mínimo es 576.

El tamaño de MTU de los datagramas individuales puede ajustarse mediante gateways a medida que pasan entre redes físicas. Este

ajuste se realiza por fragmentación. Debido a que la fragmentación

reduce la eficiencia, evite un desajuste de tamaño de MTU entre

sus redes en la medida de lo posible. Puede usar parámetros en las instrucciones DEFINE ROUTE para hacer ajustes de MTU

basados en la ruta.

FORCe Cuando se especifica, ordena al controlador de enlace que

inspeccione la entrada de la tabla PUB asignada. Si la entrada PUB se define incorrectamente, se corrige. Si no se especifica FORCE,

no se realiza ninguna inspección. Si la entrada PUB es incorrecta, el

controlador de enlace puede fallar o funcionar de manera errática. Tenga precaución con este parámetro. Si codifica la dirección

incorrecta del dispositivo, queda inutilizable para otros fines hasta la

próxima IPL.

RETRY_Time= Si la inicialización del enlace falla, este parámetro especifica el

intervalo de tiempo antes de que se vuelva a intentar la inicialización. Si se omite este parámetro, se utiliza el valor global

especificado en el comando SET LINK_RETRY.

Los valores permitidos varían de 0 (sin reintento) a 500 min (30000 s).

92


STOPPED El controlador de enlace permanece en el estado “detenido” hasta que el operador emite un comando START. Esto es particularmente útil

para enlaces que no se deben usar de inmediato, como los enlaces

TYPE=IPNET que se usan para comunicarse con particiones de prueba que ejecutan TCP/IP FOR VSE.

STOPLan= Cuando se apaga un LCS (o su equivalente), se emite un comando

STOPLAN al dispositivo. Si esto causa problemas con un

dispositivo compartido, o si el dispositivo no admite el comando

STOPLAN, entonces se puede evitar STOPLAN.

Yes Se emite STOPLAN. Este es el valor predeterminado.

No STOPLAN no se emitirá durante el cierre del enlace. Esta

configuración debe usarse sólo si se encuentra un problema.

SHUTdown= Cuando se apaga un LCS (o su equivalente), se emite un comando

SHUTDOWN para el dispositivo. Si esto causa problemas con un

dispositivo compartido, o si el dispositivo no admite el comando SHUTDOWN, se puede evitar el comando SHUTDOWN.

Yes Se emite SHUTDOWN. Este es el valor predeterminado.

No No se emite un SHUTDOWN durante el cierre del enlace. Esta

configuración debe usarse solo si se encuentra un problema.

VMReset= Este parámetro controla si se usará o no un comando CP RESET

junto con un enlace CTCA en un entorno VM.

Yes TCP/IP FOR VSE emite comandos CP RESET para

adaptadores virtuales de canal a canal, cuando corresponda. Este es el valor predeterminado.

No El comando CP RESET no se utiliza. Use esta configuración solo

cuando lo indique el Soporte Técnico de CSI.

93


NOTA: Los siguientes siete parámetros son sólo para TYPE=CLAW.

INFactor= Sólo para TYPE=CLAW. Este parámetro controla el tamaño de los

buffers de entrada para la interfaz CLAW. El valor puede variar de 1 a 8 y representa el tamaño del buffer en kilobytes. El valor

predeterminado y recomendado es 4. El tamaño óptimo para este valor

depende del tamaño de los bloques de datos. Establecer un tamaño

demasiado grande desperdicia el almacenamiento fijo. Establecer un tamaño demasiado pequeño aumenta el número de I/Os.

OUTFactor= Sólo para TYPE=CLAW. Este parámetro controla el tamaño de los

buffers de salida para la interfaz CLAW. El valor puede variar de 1 a

8 y representa el tamaño del buffer en kilobytes. El valor predeterminado y recomendado es 4. Establecer un tamaño

demasiado grande desperdicia el almacenamiento fijo.

OUTBuffers= Sólo para TYPE=CLAW. El número máximo de buffers de salida

que se encadenan juntos para la operación de salida CLAW. Especifique un valor entre 1 y 16. El valor predeterminado es 4.

Establecer un tamaño demasiado grande desperdicia el

almacenamiento fijo. Establecer un tamaño demasiado pequeño aumenta el número de I/Os.

HOSTName= Sólo para TYPE=CLAW. El nombre de 1 a 8 caracteres del sistema informático host.

Este valor debe coincidir con el valor esperado por la estación de

trabajo (establecido durante la configuración de la estación de trabajo). Si el valor que codifica no es aceptable para la estación de

trabajo, TCP/IP FOR VSE detecta dinámicamente el nombre

correcto y vuelve a intentar la conexión.

HOSTAppl= Sólo para TYPE=CLAW. El nombre de 1 a 8 caracteres de la

aplicación que se ejecuta en el sistema informático host. Este

valor debe coincidir con el valor esperado por la estación de

trabajo. El valor recomendado es TCPIP.

WSName= Sólo para TYPE=CLAW. El nombre de 1 a 8 caracteres de la

estación de trabajo. Este valor debe coincidir con el valor asignado

a la estación de trabajo durante la configuración de la estación de trabajo. Si el valor que codifica no es correcto, TCP/IP para VSE lo

corregirá y volverá a intentar la conexión.

WSAppl= Sólo para TYPE=CLAW. El nombre de 1 a 8 caracteres de la

aplicación que se ejecuta en la estación de trabajo. Este valor debe coincidir con el valor esperado por la estación de trabajo. El valor

correcto es probablemente TCPIP.

94


NOTA: Los siguientes seis parámetros son sólo para TYPE=OSAX.

ALTIP= Válido sólo con TYPE=OSAX. Si su sistema z / VSE es un host "multi-homed" (conocido por más de una dirección IP) o si la pila TCP/IP FOR

VSE sirve como puerta de entrada a otras pilas, puede asignar hasta

nueve direcciones IP adicionales a esta interfaz. Consulte su documentación de OSA Express para obtener más información sobre el

uso de este parámetro.

BUSY= Válido sólo con TYPE=OSAX. Especifica el tiempo de espera antes de

volver a intentar las transmisiones salientes después de una indicación de

ocupado del adaptador. Los valores válidos oscilan entre 100 msec y 5000 msec; el valor predeterminado es 500 msec. Durante su

procesamiento, el controlador de enlace OSA Express pasa datagramas al

adaptador. Si el adaptador se queda sin espacio en el buffer, emite un código de retorno "ocupado". El controlador de enlace espera un período

establecido (BUSY=value) y vuelve a intentar la transmisión. Lo hace

repetidamente hasta que se borra la condición de ocupado.

El "tiempo de retransmisión" de un datagrama no se ve afectado por el retraso del controlador de enlace. El tiempo de retransmisión para cada datagrama

comienza cuando el adaptador realmente ha aceptado el datagrama.

ROUTER= Válido sólo con TYPE=OSAX. Este parámetro le permite capturar el tráfico

dirigido a hosts "desconocidos". TCP/IP FOR VSE lo procesa de acuerdo con los parámetros de enrutamiento vigentes. Consulte su documentación de

OSA Express para obtener más información sobre este parámetro.

Primary Este enlace se marcará como "primario". Todo el tráfico entrante para hosts desconocidos se entregará a este enlace. Si GATEWAY ON está

vigente, cualquier datagrama no dirigido a esta pila se pasará a través

de la tabla de enrutamiento y luego se enrutará en consecuencia.

Secondary Este enlace se marcará como "secundario". Todo el tráfico entrante para

hosts desconocidos se entregará a este enlace si no se ha especificado

ningún otro enlace activo como "primario". Si GATEWAY ON está

vigente, cualquier datagrama no dirigido a esta pila se pasará a través de la tabla de enrutamiento y luego se enrutará en consecuencia.

None Este enlace sólo recibirá datagramas específicamente dirigidos a él.

Este es el valor predeterminado.

OSAPort= Valido solo con TYPE=OSAX. Si su OSA Express admite dos

puertos por CHPID, este parámetro se puede utilizar para

seleccionar el puerto que se utilizará. El valor predeterminado es "0".

95


Consulte su documentación de OSA Express para obtener más

información sobre este parámetro.

DATapath= Válido sólo con TYPE=OSAX. Este valor indica la dirección

OSA Express CUU que se utilizará para la transmisión de datos.



PORTName= Válido sólo con TYPE=OSAX. Este parámetro le permite especificar

el nombre simbólico del puerto OSA Express que se utilizará con

este enlace. Para la mayoría de los adaptadores OSA Express, este parámetro es obsoleto y se ignora.



Ejemplo

Notas Las siguientes notas aplican para este comando:

PRECAUCIÓN: Si elimina un enlace de hardware y necesita definir

otra conexión como el nuevo enlace, siga estos pasos:

1.- Elimine todas las rutas definidas usando DELETE ROUTE.

2.- Defina el nuevo enlace usando DEFINE LINK.

3.- Defina las rutas nuevamente DEFINE ROUTE.

Si no sigue este orden, después de definir el nuevo enlace, el tráfico no se dirigirá correctamente al hardware de conexión apropiado.

Como alternativa a estos pasos, puede alternar la pila TCP/IP.

Se necesita especial atención al definir un controlador LCS ya que este

dispositivo puede contener múltiples adaptadores. Debe identificar estos

adaptadores incluyendo al menos un comando DEFINE ADAPTER

define link,id=linklcs,type=lcs,dev=(032,33)

define adapter,linkid=linklcs,number=0,type=ethernet, - ip=192.168.1.161,mtu=1500

IPT100I Internet Link Level (ILL) Processor LCS starting IPL491I OSA link LINKLCS started on devices 0032 – 0033 IPL491I OSA link LINKLCS started adapter 0 as 192.168.1.161

96


Todos los comandos DEFINE LINK que requieren comandos

DEFINE ADAPTER deben incluirse en el miembro de la librería de inicialización. Después de la inicialización, las rutinas del controlador

de enlace son elegibles para el inicio inmediato. Esto significa que si

ingresa un comando DEFINE LINK adicional después de la inicialización, el controlador de enlace apropiado se inicia antes de

que pueda ingresar cualquier comando DEFINE ADAPTER

relacionado. Si debe definir un enlace de tipo LCS después de la

inicialización, cree un miembro de librería que contenga los comandos necesarios y use el comando EXECUTE para procesarlo.

Use DISCOVER para encontrar un tamaño de MTU apropiado entre dos

hosts.

El comando DEFINE ROUTE puede usarse para reducir los tamaños

de MTU y MSS para un destino o ruta específicos. Por ejemplo, es posible que desee utilizar una MTU de 1500 para dispositivos

"locales" y una MTU más pequeña para dispositivos que pasan a

través de una puerta de enlace a Internet.


DEFINE ADAPTER

Crea una definición de adaptador dentro del alcance de DEFINE LINK.

DEFINE ROUTE


DISCOVER

Determina el "mejor" tamaño de MTU para un host remoto.

EXECUTE


QUERY STATS

Muestra las estadísticas del controlador de enlace OSAX cuando

se usa la opción LINKID=.

SET IPADDR


SET LINK_RETRY Determina el intervalo de tiempo predeterminado entre los intentos

de reinicializar un enlace de red fallido.

97

Capítulo 3 Descripción de Comandos: DEFINE LOG

DEFINE LOG

Sintaxis

Los mensajes se escriben en la consola y en uno o más archivos de registro. Dos

registros, "CONSOLE" y "SYSLST", se definen y configuran automáticamente

para usted. Puede definir registros adicionales con DEFINE LOG.

DEFine LOG ID=id ,TYPE={PRinter} ,LOGICALUnit=lunit

[,LINELength=num]

[,TIMEstamp={Left|Right|None}] [,routes]

Argumentos ID= Un ID que se asignará a esta entrada. El valor recomendado es el

utilizado para LOGICALUNIT=.

TYPE= Indica el tipo de registro que se está definiendo. Actualmente,

"PRINTER" es el único valor admitido.

LOGICALUnit= El dispositivo lógico que se utilizará, por ejemplo, SYS021. Esta opción se puede abreviar como "LU=". Por defecto, SYSLST se usa

si no se especifica una unidad lógica.

LINELength= Numérico, 40–132. Este valor indica la longitud máxima de línea que se escribirá. Cuando una línea excede esta longitud, se divide en blanco y se agrega un carácter de continuación (>). Este valor puede variar de 40 a 132. Si no se especifica, TCP/IP seleccionará un valor basado en el dispositivo.

TIMEstamp= Se puede aplicar una marca de fecha y hora a cada línea. Esto puede

estar a la izquierda de cada línea o a la derecha.

Left (Predeterminado) Este registro tiene marcas de tiempo a la izquierda de cada línea.

Right Este registro tiene marcas de tiempo a la derecha de cada línea.

None Este registro no tiene marcas de tiempo.

routes Los valores opcionales indican niveles de mensajes que se agregaron o restaron de la lista de tipos que se registrarán. Tenga

en cuenta que la lista se procesa de izquierda a derecha, por lo que

especificar "ALL, –NODIAG" garantiza que todo menos los mensajes de diagnóstico se escriban en este registro.

98


Por defecto, todos los mensajes se escriben en los registros de

"impresión", y todos los mensajes, excepto el diagnóstico, se muestran en la consola.

[NO]CRITical Los mensajes de naturaleza crítica se registran/suprimen.

[NO]VITAL Los mensajes de naturaleza vital se registran/suprimen.

[NO]WARNing Los mensajes de advertencia se registran/suprimen.

[NO]IMPORTant Los mensajes importantes se registran/suprimen.

[NO]INFOrmational El mensaje informativo general se registra/suprime.

[NO]RESPonse Las respuestas a los comandos se registran/suprimen.

[NO]DIAGnose Los mensajes producidos en respuesta al comando DIAGNOSE

se registran/suprimen. Tenga en cuenta que estos mensajes

pueden ser voluminosos y rápidos.

[NO]SECurity Los mensajes relacionados con la seguridad se registran/suprimen.

ALL Todos los tipos de mensajes están registrados.

NONE No hay mensajes registrados.

99


Ejemplo

Notas


Asegúrese de que todos los mensajes estén grabados en alguna parte. De lo contrario, cuando ocurre un problema, puede ser difícil obtener la

información de diagnóstico necesaria.

MESSAGE

Controla la supresión de mensajes.

MODIFY LOG

Cambia las características de un archivo de registro del sistema.

QUERY LOGS

Muestra las consolas y registros disponibles y sus propiedades.

define log,id=sys007,type=printer,lu=sys007,linel=132 modify log,id=syslst,nodiag modify log,id=console,nodiag query logs IPN253I << TCP/IP Console Logs >> IPT240I CONSOLE on CONSOLE IPT241I Line Length: 65 Lines per page: 0 Timestamp: None IPT242I Total lines: 0 Total pages: 0 IPT243I Logging: Critical Vital Warning Important Info Response Security IPT240I SYSLST on SYSLST IPT241I Line Length: 132 Lines per page: 86 Timestamp: Left IPT242I Total lines: 300 Total pages: 0 IPT243I Logging: Critical Vital Warning Important Info Response Security IPT240I SYS007 on SYS007 IPT241I Line Length: 132 Lines per page: 0 Timestamp: None IPT242I Total lines: 44 Total pages: 0 IPT243I Logging: All

100

Capítulo 3 Descripción de Comandos: DEFINE LPD

DEFINE LPD

Sintaxis

El comando DEFINE LPD inicia un daemon Line Printer (servidor). Los LPD

permiten que los hosts remotos envíen archivos a entradas de fila VSE / POWER

o archivos VSE y miembros de la librería. El host remoto debe ser capaz de transmitir los archivos utilizando el protocolo LPR / LPD (esto no es FTP). Debe

proporcionar una definición para cada impresora virtual que se admitirá.

DEFine LPD PRinter=name16, Queue=pubname

[,LIBrary=pubname1] [,SUBlibrary=name]

[,TRANslate=name] [,HEXdump={YES|NO}]

[,USERid=$LPD] [,PASSword=$LPD]

Argumentos PRinter= Nombre de impresora de 1 a 16 caracteres, detecta mayúsculas y

minúsculas. Este valor debe ser único y es el nombre con el que los clientes externos conocen esta impresora.

Queue= Especifica la ubicación para recibir la salida enrutada a este daemon. Esta ubicación debe ser un nombre público válido del sistema de

archivos TCP/IP FOR VSE (consulte DEFINE FILE). Consulte las

secciones que siguen para obtener información adicional.

LIBrary= Especifica una librería que se utilizará para el almacenamiento

temporal de un archivo. Si no especifica un nombre de librería, los

datos entrantes se almacenan temporalmente en la memoria. Esto

significa que el archivo más grande que se puede manejar está limitado a la memoria disponible.

SUBlibrary= Especifica una sub-librería para el almacenamiento temporal de un

archivo. Este parámetro solo tiene significado si ha especificado un

valor para LIB=. Si se omite, TCP/IP FOR VSE usa la sub-librería predeterminada TEMP.

TRANslate= Especifica el nombre de la tabla que se utilizará para la traducción de

ASCII a EBCDIC.

HEXdump= Este es proporcionado como una opción de depuración.

Yes Los archivos entrantes se convierten al formato de volcado

hexadecimal. Se incluye el contenido del archivo de control. Esto puede ser útil en problemas de depuración con LPR/LPD.

No (Predeterminado) Los archivos se almacenan normalmente.

101


USERid= Una ID de usuario de 1 a 16 caracteres. El valor predeterminado

es "$LPD". Este valor se pasa al procesamiento de seguridad.

PASSword= Una contraseña de 1 a 16 caracteres. El valor predeterminado es

"$LPD". Este valor se pasa al procesamiento de seguridad.

Ejemplo

Notas

Escribir en VSE/POWER

Escribir a VSAM KSDS

Escribir a VSAM ESDS


Un solo LPD puede manejar varias solicitudes simultáneas. Por

defecto, los listados se almacenan en la memoria intermedia hasta que se completen. Cuando se completa, el listado se envía a su

destino final. Recomendamos que especifique una librería y una

sub-librería que se utilizará para el almacenamiento temporal.

La sub-librería utilizada para el almacenamiento temporal de archivos incompletos no debe utilizarse para otros fines y debe

especificar REUSE=INMEDIATE.

La escritura en una fila VSE/POWER solo es posible si al nombre del

conjunto de datos especial POWER se le asigna un nombre público utilizando un comando DEFINE FILE. El resto de esta discusión asume que

ha seguido el procedimiento recomendado para asignar el nombre público

POWER al nombre especial del conjunto de datos POWER. En el comando

DEFINE LPD, debe proporcionar una especificación QUEUE que consista en el nombre público POWER calificado con la fila y la clase POWER. Por

ejemplo, puede especificar QUEUE=POWER.LST.A.

Cuando un cliente LPR establece un enlace al daemon, puede pasar un nombre de trabajo. Esto se define en el protocolo LPR. Si el nombre

del trabajo cumple con los requisitos sintácticos de un nombre de

trabajo POWER, se usa de esa manera. De lo contrario, el nombre de un trabajo se construye como "LPDFAnnn", donde nnn es el número

de trabajo de tres dígitos transmitido por el cliente LPR (el protocolo

requiere la transmisión de un número de trabajo.

QUEUE= debe especificar un nombre público totalmente calificado del

sistema de archivos TCP/IP FOR VSE (no hay una estructura de

directorio disponible para un KSDS). Cualquier registro enviado por el cliente LPR se pasa a VSAM como un INSERT. Excepto para fines

especiales, este tipo de operación tiene poco uso.

QUEUE= debe especificar un nombre público totalmente calificado

del sistema de archivos TCP/IP FOR VSE (no hay una estructura de

directorio disponible para un ESDS). Los registros enviados por el cliente LPR se agregan al final del conjunto de datos.

define lpd,printer=local,queue='power.lst.a' define lpd,printer=hex,queue='power.lst.a',hexdump=yes LPD900I Daemon Startup LPD

102


Escribir a una Librería VSE


QUEUE= debe especificar el nombre público asignado a una librería

VSE, calificado con un nombre de sub-librería (por ejemplo, si el nombre público es PRD2 y la sub-librería deseada es LST, entonces el

código QUEUE=PRD2.LST). Cuando un cliente LPR establece un

enlace al daemon, puede pasar un nombre de trabajo. El nombre del trabajo se trunca a ocho caracteres. El tipo de miembro se deriva del

nombre de origen transmitido (definido en el protocolo). Si no hay un

nombre de origen disponible o si no es adecuado para su uso como tipo de miembro, se utilizará la palabra LISTA. Si ya existe un miembro

duplicado, se sobrescribe.

DEFINE FILE Define un archivo en el sistema de archivos TCP/IP y lo asocia

con un controlador de I/O de archivo.

DEFINE USER


DELETE LPD

Termina un daemon Line Printer.

QUERY FILES

Muestra el contenido del sistema de archivos TCP/IP.

QUERY LPDS

Muestra el estado de los daemons de Line Printer.

103

Capítulo 3 Descripción de Comandos: DEFINE MASK

DEFINE MASK

Sintaxis

Argumentos

Ejemplo

Notas


El comando DEFINE MASK le permite establecer una tabla de máscaras

de subred. Esto le permite usar diferentes máscaras en diferentes redes.

DEFine MASK NETwork=ip4addr, MASk=ip4addr

NETwork= Aunque este parámetro especifica una dirección IP completa, sólo la

parte de la red se usa para identificar la red a la que se aplicará la máscara. Si el primer byte está en el rango de 1 a 127, el número de

red es un byte. Si el primer byte está en el rango de 128 a 191, el

número de red son los dos primeros bytes. Si el primer byte está en el rango de 192 a 223, el número de red son los primeros tres bytes.

En todos los casos, la parte del host de la dirección se ignora.

MASk= Este es el valor de la máscara que debe aplicarse a la dirección de

red para obtener el número de subred. Este valor se codifica de la

misma manera que una dirección de red TCP/IP n.n.n.n, donde cada instancia de n es la representación decimal de un byte.


Sólo se puede especificar una máscara de subred para una red determinada.

El comando DEFINE MASK no devuelve una respuesta. Puede

emitir QUERY MASKS para determinar todas las máscaras vigentes

en este momento.

Vea la discusión sobre direcciones IP, máscaras y subredes en el Guía

de instalación de TCP/IP FOR VSE.

Si no se define una máscara para una red en particular, se usa la

máscara predeterminada (SET MASK=).

DEFINE ROUTE


define mask network=192.168.30.4, mask=255.255.255.0

query masks IPN253I << TCP/IP Network Masks >> IPN575I Network: 192.168.30.0 (12,625,950) Mask: 255.255.255.0 IPN575I Network: 127.0.0.0 (127) Mask: 255.0.0.0 IPN575I Network: Default (--) Mask: 255.255.255.0

104

Capítulo 3 Descripción de Comandos: DEFINE MASK

DELETE MASK

Elimina una máscara de subred para una red particular.

QUERY MASKS

Muestra todas las máscaras de subred definidas por número de red.

QUERY ROUTES

Muestra el contenido de la tabla de enrutamiento de red o la ruta

tomada para llegar a una dirección específica.

105

Capítulo 3 Descripción de Comandos: DEFINE MENU

DEFINE MENU

Sintaxis

Argumentos

El comando DEFINE MENU le permite cargar un menú telnet desde una

librería y ponerlo a disposición de los daemons telnet.

DEFine MENu ID=id, MEMber=member

ID= El nombre que se asignará al menú. Este nombre debe ser único y

hace referencia el comando DEFINE TELNETD.

Ejemplo

Notas


MEMber= El nombre del miembro que contiene la definición del menú. El valor especificado se agrega con un sufijo ".L" para formar el

nombre completo.


Las instrucciones para crear un menú telnet se encuentran en la Guía de Instalación de TCP/IP FOR VSE.

El comando DEFINE MENU no devuelve una respuesta. Puede emitir

el comando QUERY MENUS a los menús disponibles actualmente.

Los menús se comprueban en busca de errores y se compilan durante la ejecución de este comando. Cualquier error que esté marcado

suprime la operación de definición.

Los daemons de Telnet comprueban la existencia de un menú sólo cuando se intenta una conexión.

DEFINE TELNETD


DELETE MENU

Elimina un archivo de menú TN3270 de la memoria.

QUERY MENUS

Muestra los menús disponibles para uso TN3270.

QUERY TELNETDS

Muestra los daemons TN3270 y TN3270E.

define menu,id=menuadm,member=menu1

query menus IPN253I << TCP/IP Menu Definitions >> IPN391I ID: MENUUSR Member: MENU2 IPN391I ID: MENUADM Member: MENU1

106

Capítulo 3 Descripción de Comandos: DEFINE NAME

DEFINE NAME

Sintaxis

El comando DEFINE NAME le permite crear nombres simbólicos.

Los clientes TCP/IP FOR VSE pueden usar estos nombres como una

forma conveniente de referirse a otros elementos.

DEFine NAME NAMe=name64

{[,IPaddr=ip4addr]|[,SCRipt=member]}

Argumentos

Ejemplo

Notas


NAMe= El nombre simbólico sin distinción entre mayúsculas y minúsculas de 1 a 64 caracteres que se definirá.

IPaddr= Una dirección de red IPv4. Si este parámetro está codificado, las

referencias al nombre especificado se asignarán a esta dirección.

SCRipt= Si se especifica este parámetro, el comando crea un nombre simbólico que se puede usar para referirse a un "script". Una vez

definido, el script se puede usar con cualquier cliente que use la

resolución de nombres de dominio, incluidos Email, LPR y Ping. El nombre del miembro tiene el sufijo ".L" y se encuentra utilizando la

cadena de búsqueda estándar en la partición TCP/IP FOR VSE..

Los nombres que se refieren a las direcciones IP anulan la búsqueda de DNS.

DEFINE EVENT

Supervisa una clase POWER para la distribución automática de informes.

DELETE NAME

Elimina un nombre simbólico TCP/IP FOR VSE creado por DEFINE NAME.

QUERY NAMES

Muestra el contenido de la tabla de nombres simbólicos

creada por DEFINE NAME.

define name,name=printer17,ipaddr=201.52.101.72

107

Capítulo 3 Comandos Relacionados: DEFINE NTPD

DEFINE NTPD

Sintaxis

El comando DEFINE NTPD inicia un daemon de protocolo de tiempo

de red. Este servicio permite que otros hosts en la red se sincronicen

con el reloj VSE TOD.

DEFine NTPd ID=id [,PORt=37] [,PRotocol={Udp|Tcp}]

[,GMT=snum] [,ADJustment=snum]

Argumentos ID= Un nombre único que identifica al daemon.

PORt= El número de puerto a monitorear para solicitudes de tiempo. El

puerto estándar y predeterminado es el 37.

PRotocol= Una palabra clave, una de las siguientes:

Udp Este daemon responde a solicitudes utilizando el protocolo UDP. Este es el valor predeterminado.

Tcp Este daemon responde a las solicitudes que utilizan el protocolo TCP.

GMT= Numérico firmado, de -99999 a +99999.

Este es el número de horas que se agregarán/restarán a la configuración del reloj VSE TOD antes de transmitir a un cliente.

Esto es útil si su reloj local no tiene el desplazamiento de zona

horaria adecuado o si está involucrado el horario de verano.

ADJustment= Numérico firmado, de -99999 a +99999.

Este es un número entero de segundos con signo que se agregará/restará a la configuración del reloj VSE TOD antes de

transmitir a un cliente. Debido al cálculo variable de los segundos

bisiestos, etc., puede ser necesario proporcionar un ajuste fino. La mejor manera de determinar este valor es iniciar un daemon NTP,

hacer que un cliente obtenga el tiempo y determinar el ajuste

requerido, si corresponde.

Ejemplo

define ntpd,id=ntp1 NTP100I NTP Daemon Running

108

Capítulo 3 Comandos Relacionados: DEFINE NTPD

Notas



El protocolo de tiempo de red simplemente consiste en transmitir el

tiempo actual como el número de segundos transcurrido desde el 1

de enero de 1900 (el último año del siglo XIX).).

Además de los días bisiestos agregados cada cuatro años (2000 es un año bisiesto), los segundos bisiestos también se han agregado a

intervalos desde 1972.

NTPD incluye segundos bisiestos en sus cálculos.

Cada host remoto requiere que el software del cliente solicite la hora

y configure el reloj local. Uno de esos clientes es Tardis. Hay una

versión shareware disponible en http://www.kaska.demon.co.uk.

Los clientes NTP intentan permitir el retraso de la transmisión de la

red. La precisión de los relojes mantenidos con NTP, sin embargo, probablemente será sólo dentro de +/- 2 segundos.

DELETE NTPD

Termina un daemon de Network Time Server.

QUERY NTPDS

Muestra el estado de los daemons NTP.

http://www.kaska.demon.co.uk/

109

Capítulo 3 Descripción de Comandos: DEFINE PUBLISHER

DEFINE PUBLISHER

Sintaxis

Argumentos

El comando DEFINE PUBLISHER crea un daemon de edición que se

puede usar para notificar procesos externos de eventos completados

en la partición TCP/IP FOR VSE.

DEFine PUBlisher ID=id ,IMODlist=member

ID= Un nombre único que identificará a este daemon.

IMODlist= Identifica un "libro L" que se inspeccionará para determinar una lista de números de eventos de publicación y el IMOD

correspondiente que será ejecutado bajo el control de las

FAQS/ASO de CSI International. El formato de este archivo se

explica en la sección "Exposición" a continuación.

Ejemplo

Exposición El editor está destinado a notificar aplicaciones y procesos externos de eventos relacionados con TCP/IP, como la transferencia exitosa de un

archivo. El editor emite un mensaje de notificación de formato definido que

otros programas pueden interpretar fácilmente. Cuando se usa con CSI-FAQS/ASO, los IMOD se pueden programar para automatizar acciones

dependientes. Esta instalación está destinada a eliminar la necesidad de

"raspar la pantalla" de la consola del operador para determinar la finalización

del evento y proporcionar un formato inmutable para la automatización.

En el entorno de producción de CSI International, utilizamos el evento 1 del

editor (archivo FTP recibido) para ejecutar un IMOD que emite un comando

de "actualización" para que Entrée de CSI International purgue la copia "antigua" de su caché. El mismo evento también inicia otro FTP para copiar

el archivo actualizado a nuestra copia de seguridad del sitio activo.

El archivo especificado por el parámetro IMODLIST = contendrá una asignación de "números de evento publicados" al IMOD que se activará. Se

codifican cuatro campos, separados por uno o más espacios en blanco:

1. El Número de Evento Publicado (ver el ejemplo a continuación)

2. La palabra clave “IMOD”

3. El nombre de IMOD

4. Comentarios opcionales

Cualquier línea que comienza con “*” se considera un comentario.

define publisher,id=pub01,imodlist=list01 IPN694I Publishing Daemon now active

110

Capítulo 3 Descripción de Comandos: DEFINE PUBLISHER

Ejemplo

Notas


El siguiente trabajo cataloga un archivo IMOD de muestra.

Puede encontrar información adicional sobre el uso de Publisher en la Guía de

Instalación de TCP/IP FOR VSE.

DELETE PUBLISHER

Termina un daemon de Publisher.

QUERY PUBLISHER

Muestra el estado del daemon de Publisher.

// EXEC LIBR ACC SUBL=PRD2.CONFIG CATALOG IMODLIST.L REPLACE=YES * * This is the IMODLIST= member for the DEFINE PUBLISH,IMODLIST= * * It is read by the Publishing Daemon to map Published Events * * to specific IMODs. * * * * The format is: * * event_num IMOD imodname comments * * Fields are separated by 1 or more blanks * * 01 IMOD $FTPFRCV EVENT-ITEM 1 = FTP FILE RECEIVED 02 IMOD $FTPFSNT EVENT-ITEM 2 = FTP FILE SENT /+ /*

111

Capítulo 3 Descripción de Comandos: DEFINE ROUTE

DEFINE ROUTE

Sintaxis

El comando DEFINE ROUTE se usa para construir una tabla de

enrutamiento con el propósito de enrutar datagramas y proporcionar

características de transmisión basadas en la ruta.

DEFine ROUTe ID=id ,LINKid=name16 [,ACTion={Next|Stop}]

[,ADAPter=0] ,IPaddr=ip4addr

[,GATEway=ip4addr1] [,AFTer=id] [,MTU=num]

[,MSS=num] [,CRETran=msec] [,DRETran=msec]

[,FIXRetran={Yes|No}] [,MINRetran=msec]

[,MAXRetran=msec] [,PULse=sec] [,WINdow=num]

[,RPAuse=msec] [,RETRY=num]

Argumentos ID= Este es el valor de carácter que se utilizará al emitir una QUERY o

DELETE en esta ruta. No hay valor predeterminado.

LINKid= Este es el mismo valor que se especifica en el parámetro ID= del

comando DEFINE LINK que será el destino para esta entrada de

la tabla de ruta. No hay valor predeterminado.

ACTion= Next

Indica que la comparación de ruta que tiene lugar continuará con la

siguiente ruta en una condición de no coincidencia. Este es el valor

predeterminado.

Stop La comparación de ruta se detendrá en este punto y no continuará más

cuando se encuentre una condición de coincidencia o no coincidencia.

ADAPter= Para enlaces con adaptadores, esto dirige la ruta al adaptador numerado específico. El valor predeterminado es "0". Este

parámetro es necesario si el parámetro NÚMERO= del DEFINE

ADAPTER objetivo no es "0".

IPaddr= Una dirección de red TCP/IP o dirección de "host cero". El valor predeterminado es 255.255.255.255. Todos los mensajes destinados

a esta dirección se envían en el enlace asociado.

GATEway= La dirección de red completa de una puerta de enlace a otras redes.

El valor predeterminado es 255.255.255.255. Una coincidencia en esta entrada de la tabla hace que el paquete de datos se envíe a la

puerta de enlace especificada.

112


AFTer= El valor del parámetro de nombre que identifica la instrucción DEFINE ROUTE después de la cual se debe insertar Ésta. Si se omite

este parámetro, la entrada de ruta se agrega al final de la tabla. Se

puede codificar un valor especial de "TOP" para que la instrucción de ruta se inserte en la parte superior de la lista.

La colocación en la tabla es muy importante porque el procedimiento de

búsqueda se realiza de arriba a abajo para la primera coincidencia (a

excepción de "0.0.0.0", que siempre coincide con la última).

MTU= El valor de MTU que se utilizará con esta ruta. No hay predeterminado. Esto sólo

tiene sentido si es menor que el valor especificado por DEFINE LINK o DEFINE

ADAPTER de destino. Este parámetro sólo controla el tamaño de los datagramas de salida. Sin embargo, también determina el valor más grande que se puede usar

para el tamaño máximo de segmento (MSS).

MSS= El tamaño máximo de segmento que se utilizará con esta ruta. El valor de

MSS se envía al host remoto durante la negociación de una conexión TCP.

Especifica la pieza de datos más grande que se puede enviar en un solo datagrama. Al seleccionar un tamaño de MSS, debe tener en cuenta que hay

40 bytes de información de encabezado más allá de la porción de datos. Por

lo tanto, para un tamaño de MTU de 1500, el MSS máximo es MTU-40, o 1460. Cuando se determina el MSS para una conexión, siempre se reduce a

MTU-40. Si no se especifica ningún valor para MSS, se establece en el MSS

predeterminado o 40 menos que el MTU, lo que sea menor. La MTU es el

valor más grande que se puede usar sin fragmentación de datagramas. El comando SET MAX_SEGMENT establece el MSS predeterminado (32684

es el valor predeterminado del sistema).

CRETran= Esto especifica el número de milisegundos que TCP/IP esperará un ACK en

respuesta a una solicitud de conexión (SYN). Una vez transcurrido este intervalo, se ingresa al modo de retransmisión. El valor predeterminado es

1000. El comando SET RETRANSMIT establece este valor predeterminado

en 1/300 segundos (300 es el valor predeterminado del sistema para este

comando).

DRETran= Esto especifica el número de milisegundos que TCP/IP esperará un ACK

en respuesta a una transmisión de datagramas en una conexión establecida.

Una vez transcurrido este intervalo, se ingresa al modo de retransmisión. El valor predeterminado es 1000. El comando SET RETRANSMIT establece

este valor predeterminado en 1/300 segundos (300 es el valor

predeterminado del sistema para este comando).

FIXRetran= Yes

Los valores especificados para DRETRAN= y RPAUSE=

permanecerán constantes mientras dure la conexión.

113


No Los valores para DRETRAN= y RPAUSE= comenzarán según lo especificado, pero se ajustarán dinámicamente a medida que

se analice la respuesta de la red.

El valor predeterminado del sistema es NO. El comando SET

FIXED_RETRANSMIT actualiza la configuración predeterminada para este parámetro.

MINRetran= Si se especifica FIXRETRAN= NO, este es el tiempo mínimo (en milisegundos) que se puede asignar dinámicamente a DRETRAN.

El valor predeterminado es 500.

MAXRetran= Si se especifica FIXRETRAN= NO, este es el tiempo máximo (en

milisegundos) que se puede asignar dinámicamente a DRETRAN.

El valor predeterminado es 2000.

RPAuse= Una vez que se ha ingresado al modo de retransmisión, este es el tiempo (en milisegundos) que transcurrirá entre los intentos de

retransmisión. El valor predeterminado es 500.

RETRY= Este parámetro especifica el número de veces que un datagrama

no reconocido se retransmitirá antes de que la conexión se considere inactiva. El valor predeterminado es 50.

PULse= Este parámetro especifica el tiempo (en 1/300 segundos) que una

conexión puede estar inactiva, sin tráfico de ningún tipo, antes de

que se realice una sonda para determinar si el host remoto todavía está activo. El comando SET PULSE_TIME establece el valor

predeterminado para este parámetro (el valor predeterminado del

sistema es 18000, lo que equivale a 60 segundos).

WINdow= Este valor indica el tamaño deseado de la ventana de recepción. El comando SET WINDOW establece el valor predeterminado

para este parámetro (el valor predeterminado del sistema es

65535).

114


Ejemplo

Vea el manual de Mensajes TCP/IP FOR VSE para obtener una

explicación de cada mensaje en este ejemplo.

La siguiente tabla muestra el nombre del parámetro DEFINE ROUTE

para algunos valores de parámetros mostrados.

Etiqueta Nombre de Parametro

Max Seg: MSS

SYN Retran: CRETran

Data Retran: DRETran

Fixed: FIXRetran

Retran Min: MINRetran

Max: MAXRetran

Retry Delay: RPAuse

Retries: RETRY

RWin: WINdow

IP Address: 0.0.0.0 Mask: 255.255.255.0 Net: -- Subnet: -- Host: -- Gateway IP Address: 192.168.1.1 MTU: 0 Max Seg: 1400 Pulse: 60s SYN Retran: 1000ms Data Retran: 1000ms Fixed: No Retran Min: 500ms Max: 2000ms Retry Delay: 500ms Retries 50 RWin: 65535

Link ID: LINK3172 ID: DEFAULT IPN448I IPN449I IPN450I IPN537I IPN875I IPN876I IPN877I IPN882I IPN884I

DEFINE ROUTE,ID=DEFAULT, LINKID=LINK3172, IPADDR=0.0.0.0, - ADAPTER = 0, GATEWAY=192.168.001.1, MSS=1400

IP Address: 192.168.1.0 Mask: 255.255.255.0 Net: 192.168.1.0 Subnet: -- Host: -- MTU: 5040 Max Seg: 5000 Pulse: 60s SYN Retran: 1000ms Data Retran: 1000ms Fixed: No Retran Min: 500ms Max: 2000ms Retry Delay: 500ms Retries 50 RWin: 65535

Link ID: LINK3172 ID: LOCAL IPN448I IPN449I IPN450I IPN875I IPN876I IPN877I IPN882I IPN884I

DEFINE ROUTE,ID=LOCAL, LINKID=LINK3172, IPADDR=192.168.001.000, - ADAPTER=0,MSS=5000,MTU=5040

115


Notas


TCP/IP FOR VSE busca las instrucciones de ruta en el mismo orden

en que se ingresan (excepto para una entrada con una dirección IP

cero). El uso del parámetro AFTER= garantiza una secuencia adecuada de la tabla de ruta.

Para examinar el orden de búsqueda, use el comando QUERY

ROUTES. Esto muestra la tabla de rutas en el orden de búsqueda

(excepto las entradas con una dirección IP completamente cero).

Una instrucción de ruta con una dirección IP completamente cero

sólo coincide después de que se hayan probado todas las demás entradas (en orden).

Una vez que una instrucción de ruta coincide con la dirección IP, se

verifica la disponibilidad del enlace designado. Si no se puede usar el enlace, la búsqueda continúa con la siguiente entrada de ruta.

Cuando emite un comando DELETE LINK porque

desea deshabilitar un enlace, o

desea cambiar uno o más atributos de un enlace, o

desea recuperarse de un enlace que fue desactivado por

un comando de hardware,

entonces todas las instrucciones DEFINE ROUTE que se

refieren a ese enlace se eliminan automáticamente.

Si desea redefinir un enlace que eliminó, primero debe esperar a

que se complete el comando DELETE y luego confirmar que LINK

ya no existe emitiendo un comando QUERY LINKS. Después de

eso, debe definir el enlace y luego restablecer las rutas con el comando DEFINE ROUTE.

Por ejemplo, después de emitir DELETE LINK, usted puede

1. Usar QUERY LINKS para confirmar que el enlace se ha ido

2. Usar DEFINE LINK para restablecer el enlace

3. Usar DEFINE ROUTE para restablecer las rutas.

Alternativamente, para restablecer un enlace que eliminó,

simplemente puede alternar la pila TCPIP FOR VSE. Se utilizarán

las definiciones de inicialización.


DEFINE ADAPTER


DEFINE ALTIP

Causa que la pila supervise y responda a las solicitudes ARP de direcciones de inicio adicionales.

116


DEFINE MASK

Crea una máscara de subred para una red en particular.

DELETE ALTIP


DELETE LINK

Elimina un enlace entre TCP/IP y una red o una pila


DELETE ROUTE

Elimina una entrada de la tabla de enrutamiento de red.

DISCOVER

Determina el "mejor" tamaño de MTU para un host remoto.

GATEWAY


MODIFY ROUTE

Cambia los valores de una entrada existente en la Tabla de Ruta.

QUERY ARPS


QUERY LINKS


QUERY MASKS


QUERY ROUTES



QUERY OPTIONS


SET IPADDR


SET MASK

Establece una máscara de subred predeterminada.

SET FIXED_RETRANSMIT

Establece el valor predeterminado para el parámetro FIXRetran= en DEFINE ROUTE.

SET MAX_SEGMENT

Controla la configuración predeterminada para el tamaño máximo

de segmento entrante (MSS= en DEFINE ROUTE).).

117


SET PULSE_TIME

Controla la configuración predeterminada para el intervalo

entre sondas de conexiones inactivas (PULSE= en DEFINE

ROUTE).

SET RETRANSMIT

Controla la duración del intervalo predeterminado antes de que TCP/IP FOR VSE entre en modo de retransmisión para paquetes de

datos no reconocidos (CRETRANS= y DRETRANS= en DEFINE

ROUTE)).

SET WINDOW

Controla la configuración predeterminada de la ventana entrante TCP (WINDOW= en DEFINE ROUTE).

TRACERT Muestra cada "salto" en una ruta junto con el tiempo

requerido para llegar a él.

118

Capítulo 3 Descripción de Comandos: DEFINE SOTRACE

DEFINE SOTRACE

Sintaxis

El comando DEFINE SOTRACE inicia una operación de rastreo para solicitudes

de Socket. Cada solicitud de Socket se guarda en la memoria hasta que se emita

un comando DELETE TRACE correspondiente. El comando DUMP se puede usar en cualquier momento para generar los buffers de rastreo acumulados.

DEFine SOTRACe ID=id [,IPaddr=ip4addr] [,PORT=port]

[,SCOPE={All|Internal|External|Obsolete}]

[,MAXData=60] [,PHASE=member] [,SIZe=500]

[,KIND={TCP|UDP|FTP|CLIENT|TELNET}]

Argumentos ID= Un nombre único que identifica esta entrada de rastreo. Este nombre se usa junto con los comandos DELETE TRACE y QUERY

TRACES.

IPaddr= Limita el rastreo a una dirección IP específica. Sólo se considera

el tráfico que involucra la dirección especificada.

PORT= Limita el rastreo a un puerto específico. Sólo se considera el tráfico

que involucra el puerto especificado.

PHASE= Limita el rastreo a una fase específica. Sólo se considera el tráfico que

involucra la fase especificada. El nombre de fase de una conexión se puede encontrar con un comando QUERY CONNECTIONS.

SCOPE= Internal

Sólo se consideran las solicitudes de socket realizadas desde

la partición de la pila.

External Sólo se consideran las solicitudes de socket realizadas desde fuera de la partición de la pila.

Obsolete Sólo se consideran las solicitudes de socket con listas de

parámetros obsoletas. Esto puede ser útil al intentar ubicar aplicaciones que pueden necesitar recompilarse.

All (Predeterminado) Se consideran todas las solicitudes de Socket.

MAXData La cantidad de datos de cada llamada de socket que se incluirá en el

rastreo. El valor predeterminado es 60 bytes por solicitud de socket.

Los valores aceptables varían de 0 a 64K.

119


SIZe= Indica la cantidad máxima de bloques de mensajes que se deben retener durante el rastreo. Los bloques viejos se descartan a favor de los bloques más nuevos. El

valor predeterminado es 500. Los valores permitidos son de 10 a 64K.

KIND= Este parámetro se puede usar para limitar el rastreo a tipos específicos de

solicitudes de Socket. Por defecto, se registran las solicitudes TCP.

TCP Rastrea las solicitudes TCP estándar. Estas son las solicitudes

más frecuentemente asociadas con aplicaciones que utilizan

TCP/IP para la comunicación. Este es el valor predeterminado.

UDP Rastrea las solicitudes UDP. Las solicitudes UDP generalmente se usan cuando el rendimiento es esencial. En

UDP, la aplicación maneja todo el reconocimiento, la

retransmisión y la verificación de contenido.

FTP Rastrea sólo solicitudes de socket que especifiquen un tipo de FTP.

CLIENT Rastrea las solicitudes de socket asociadas con la interfaz

de cliente TCP/IP FOR VSE. Esto incluye solicitudes de socket con tipos de PING y LPR.

Ejemplo

Notas


TELNET Rastrea sólo solicitudes de socket que especifiquen un tipo de telnet.


Una vez que se han acumulado los datos de rastreo, el comando DUMP se puede usar para volcar los datos.

Asegúrese de terminar su rastreo con DELETE TRACE después de

usar el comando DUMP. Debido a que todo el tráfico a una

dirección rastreada se retiene en la memoria, se pueden inmovilizar

grandes cantidades de almacenamiento virtual.

Puede rastrear múltiples direcciones simultáneamente emitiendo múltiples comandos DEFINE TRACE. Cada rastreo debe tener una identificación única.

DEFINE TRACE Inicia una traza de datagrama.

define sotrace,id=trace1,phase=testserv IPN210I Socket Trace ID TRACE1 defined and running.

120


DELETE TRACE

Termina un rastro y libera su almacenamiento.

DUMP

Realiza un volcado formateado de varios bloques de control TCP/IP.

QUERY TRACES

Muestra una lista de trazas actualmente en ejecución.

SEGMENT

Segmenta el SYSLST y los archivos de registro, haciéndolos

disponibles para imprimir.

121

Capítulo 3 Descripción de Comandos: DEFINE TELNETD

DEFINE TELNETD

Sintaxis

El comando DEFINE TELNETD define e inicializa uno o más

daemons Telnet (servidores). Cada daemon proporciona una sesión

TN3270 o TN3270E.

DEFine TELnetd ID=id ,TARget=name8 ,TERMname=luname

[,COunt=num] [,BASE=1]

[,TN3270E={Listener|Effector}] [,PORT=23]

[,MENu=name16] [,LOGMode=S3270]

[,LOGMODE3=D4B32783] [,LOGMODE4=D4B32784]

[,LOGMODE5=D4B32785] [,IPaddr=0.0.0.0]

[,BUFfersize=num] [,CLOSE={Always|Seldom}]

[,GENeric=name16] [,GRoup=name16]

[,POOL={Yes|No}] [,DRIVer=TELNETD]

Argumentos BASE= Cuando se usa junto con el parámetro COUNT=, BASE= especifica

el primer sufijo de dos dígitos para asignar. El valor predeterminado es 1. Los valores permitidos son de 0 a 99.

BUFfersize= Cuando POOL=NO está en efecto, cada daemon asigna sus propios

buffers estáticos.

Cuando sea apropiado, puede utilizar el parámetro BUFFERSIZE=

para controlar el tamaño de cada buffer. Si no se especifica, se

utiliza el valor establecido por el comando SET TELNETD_BUFSIZE=. Los valores válidos oscilan entre 8.192 y

65.535.

Reducir el valor predeterminado puede resultar en fallos de sesión o

pérdida de datos. El aumento del valor predeterminado debe hacerse

sólo en casos en los que se muestran incorrectamente pantallas muy

grandes y complejas.

CLose= Este parámetro controla el método por el cual el daemon Telnet

finaliza su sesión con la aplicación. Los siguientes valores puede ser codificados:

Always El daemon Telnet cierra y reabre su VTAM ACB cada vez

que se completa una sesión. Este es el valor predeterminado.

Seldom El daemon Telnet cierra y reabre su VTAM ACB sólo si la sesión anterior terminó con un error.

122


COunt= Especificar cualquier valor para COUNT= causa que se definan de uno a 100 daemons Telnet utilizando los otros parámetros DEFINE TELNETD

como patrón. Se agrega un sufijo de dos dígitos, 00 a 99, a los valores

ID= y TERMNAME=. El valor inicial para este sufijo de dos dígitos se especifica utilizando el parámetro BASE=. El valor predeterminado es

para definir un sólo daemon sin el uso de sufijos numéricos.

DRIVer= El nombre de la fase que se cargará para proporcionar soporte al

daemon Telnet. El valor predeterminado para TELNETD. Especificar

cualquier otro valor puede anular su garantía.

ID= Este es un identificador único asignado al daemon Telnet. Este

identificador se puede usar en comandos posteriores para seleccionar un daemon específico. Si también se especifica

COUNT=, se agrega un sufijo de dos dígitos a cada valor ID=.

IPaddr=

Si se especifica, este daemon sólo se conecta con las solicitudes emitidas

desde un host remoto cuya dirección IP coincide con el patrón proporcionado. Si se especifica una dirección IP completa, la coincidencia

debe ser exacta. Si la dirección especifica la red y la subred (la parte del

host de la dirección es cero), se realiza una coincidencia genérica.

La selección de un daemon disponible puede ser el primer o el que mejor se ajuste. Esto es controlado por el comando CONNECT_SEQUENCE.

LOGMode= Este es el modo de registro de VTAM que se utilizará para negociar sesiones de VTAM para un terminal modelo 2. Este modo de registro

no debe ser SNA. El valor predeterminado y recomendado es S3270.

LOGMODEn= Donde "n" es de 3 a 5 para proporcionar la habilidad de especificar

modos de registro para modelos 3270 de 3 a 5. El modo de registro no

debe ser SNA. Los valores predeterminados y recomendados son:

D4B32783, D4B32784 y D4B32785, respectivamente.

GENeric=

Un nombre de 1 a 16 caracteres; no diferencia mayúsculas y minúsculas.

Este parámetro sólo tiene significado cuando va acompañado de

TYPE=LISTENER.

Este parámetro tiene efecto cuando un cliente TN3270E solicita una sesión,

pero NO especifica una preferencia LUname. En este caso, se asigna el primer daemon efector disponible cuyo nombre de GROUP coincide con el

nombre GENERIC del daemon oyente. Si no se especifica GENERIC,

todos los daemon efectores son elegibles.

El valor predeterminado es un valor nulo. Si no desea sesiones "genéricas",

especifique un valor que no coincida con ningún nombre de GROUP.

123


GRoup= Un nombre de 1 a 16 caracteres. No diferencia mayúsculas y minúsculas.

Este parámetro sólo tiene significado cuando va acompañado de TN3270E=LISTENER o TN3270E=EFFECTOR.

Cuando se especifica para un daemon de escucha, la solicitud del usuario

para un LUname se aceptará sólo si el daemon efector requerido tiene el

mismo nombre de GRUPO.

El valor predeterminado para este valor es nulo. Si no se especifica ningún

valor en un daemon de escucha, no hay restricción de grupo sobre qué

daemon efectores se pueden usar.

MENu= Nombre de 1 a 16 caracteres.

Hace referencia a un menú previamente definido por un comando DEFINE MENU. Si se especifica, el contenido del menú se muestra al

usuario en la conexión inicial con el daemon.

Si se especifica, este valor anula cualquier especificación de TARGET=

(excepto que el valor de TARGET= se pasa al menú como la aplicación

predeterminada).

Tras la finalización de una sesión Telnet, la conexión con el cliente remoto

siempre se cierra. El daemon NO regresa al menú hasta que se solicite una

nueva conexión.

POOL= Este parámetro determina la ubicación de los buffers de datos del daemon.

Yes Este daemon de Telnet comparte un grupo de buffers con otros

daemons que especifican POOL=YES. Se requiere un buffer para

pasar datos a través del daemon en cualquier dirección. El número de buffers disponibles es controlado por el comando SET

TELNETD_BUFFERS. El uso del buffer se puede mostrar con el

comando QUERY STATS.

No Este es el valor predeterminado. Cuando NO está en vigor, cada daemon adquiere sus propios buffers (31 bits). Aunque esto puede

resultar en un uso considerable del almacenamiento, se requiere

menos CPU para procesar los datos. El parámetro BUFFERSIZE=

se puede usar para controlar el tamaño de los buffers individuales.

PORT= Este es el puerto "conocido" que los clientes remotos usarán para conectarse

con un daemon Telnet en espera. El puerto predeterminado (y estándar) es

23. Una razón para seleccionar otros puertos es crear grupos de daemons Telnet.

124


TARget= Éste es el nombre de la aplicación VTAM con la que se conectará este daemon. Si MENU= también se suministra, entonces TARGET= se ignora.

Se requiere TARGET= o MENU= para todos los daemons TN3270 y

TN3270E Effector.

TERMname= Este es el nombre de la aplicación VTAM (ACB) que el daemon Telnet usará para conectarse con VTAM. Dicho de otra manera, este valor será

el LUname de la sesión Telnet. Si también se especifica COUNT=, se

agregará un sufijo de dos dígitos al valor TERMNAME=. TERMNAME=

es obligatorio para todos los daemons TN3270 y TN3270E Effector.

TN3270e= TN3270E es una versión más nueva del protocolo TN3270 que permite

un soporte más "avanzado" para dispositivos de tipo 3270. Una

característica de TN3270E es la especificación del cliente de LUname.

Tenga en cuenta que esto solo se aplica a las sesiones 3270 y no a las impresoras, que son manejadas por la función opcional del Servidor de

Impresión General (GPS).

Para proporcionar soporte TN3270E, debe definir dos tipos de daemon:

de escucha y efectores. Un daemon de escucha abre una conexión de "escucha" y espera a que un cliente solicite una sesión. Una vez que un

cliente está conectado, el oyente negocia una sesión TN3270E (incluido

LUname) y luego pasa la sesión al daemon efector apropiado. El daemon

efector posee el LUname y conduce la sesión real. Una vez que se negocia una sesión, el daemon de escucha abre otra conexión de

"escucha" y espera nuevas solicitudes de conexión.

Una razón frecuente para usar TN3270E es la “seguridad”. La idea es asignar un nombre de LU específico a un usuario en particular. Sin

embargo, este esquema depende en gran medida del “código de honor.”

Para proporcionar cierto control sobre la asignación de LUname, puede asignar una dirección IP (o subred o red) a un daemon de escucha. Una

vez que se asigna una dirección (o patrón), sólo aquellos clientes cuya

dirección IP coincida con la del escucha pueden obtener una conexión con ese escucha en particular.

Los daemons escucha pueden estar limitados en su elección de daemons

efectores. Si el escucha tiene un valor especificado para GROUP=, sólo puede pasar sesiones a efectores con una especificación GROUP= idéntica.

Otro parámetro del daemon de escucha, GENERIC=, proporciona

situaciones en las que el cliente NO especifica un LUname de preferencia.

En este caso, se selecciona un daemon efector aleatorio del GROUP

identificado por el parámetro GENERIC= del escucha.

Especifique uno de los siguientes valores para definir un daemon TN3270E:

125


Listener Este daemon escucha a un cliente Telnet para solicitar una sesión y luego negocia una sesión TN3270E. Después de una

negociación exitosa, la sesión se pasa al daemon efector

apropiado y el daemon de escucha vuelve al modo de escucha.

Effector Este daemon no tiene capacidad para iniciar una sesión Telnet.

Acepta una sesión prenegociada de un daemon de escucha y

luego continúa la sesión TN3270E entre el cliente y la aplicación VTAM utilizando su LUname predefinido.

Ejemplo

Notas

Control de LUnames


Se requiere un daemon Telnet para cada sesión de terminal Telnet simultánea solicitada por un usuario remoto. Las sesiones de Telnet

salientes, como las iniciadas desde una transacción CICS a otra plataforma,

usan daemons proporcionados en el extremo remoto. No considere las

sesiones salientes cuando determine la cantidad de aemons que necesita.

Si los daemons de Telnet se niegan a iniciar o conectarse, verifique los

valores de almacenamiento y buffer de VTAM y los valores de espacio de

datos de VSE/ESA. Recuerde que el parámetro DSPACE especificado por JCL establece un valor máximo. La cantidad real de DSPACE disponible

para todas las solicitudes se establece en tiempo de IPL.

Al configurar IDs de APPL VTAM para terminales telnet, asegúrese de

especificar EAS= 1. Esto reduce la cantidad de almacenamiento requerido

para soportar cada sesión.

Los protocolos TN3270 están basados en EBCDIC. No se realiza traducción

ASCII.

Cuando un cliente TN3270 abre una conexión con uno de los daemons

TN3270 de TCP/IP, se establece la conexión y se asigna el daemon antes

de cualquier negociación con el cliente. Debido a que cada daemon tiene un LUname preasignado, cada sesión de telnet obtiene su LUname de

manera aleatoria.

Si usted DEBE controlar la asignación de LUname, puede utilizar uno de los siguientes métodos:

define telnetd,id=tln,target=dbdcics,termname=tcp, base=0, count=5 TEL900I Daemon Startup Telnet Termname: TCP00 Port: 23 TEL900I Daemon Startup Telnet Termname: TCP01 Port: 23 TEL900I Daemon Startup Telnet Termname: TCP02 Port: 23 TEL900I Daemon Startup Telnet Termname: TCP03 Port: 23 TEL900I Daemon Startup Telnet Termname: TCP04 Port: 23

126


Puede definir varios grupos de daemons telnet. Cada grupo supervisa

un número de puerto diferente. La desventaja es que el usuario final debe conocer y especificar el puerto apropiado al conectarse.

Puede especificar una dirección IP cuando defina un daemon telnet

individual. Dependiendo de cómo se configure el comando

CONNECT_SEQUENCE, puede controlar con precisión la

asignación de daemon telnet en función de la dirección IP del

solicitante.

No mezcle daemons TN3270 y TN3270E con el mismo número de

puerto. Puede usar ambos tipos de daemon si asigna números de

puerto diferentes.


CONNECT_SEQUENCE

Controla si las solicitudes de conexión se asignan mediante la verificación del patrón de dirección IP.

DEFINE MENU Carga un archivo de menú y lo pone a disposición de los daemons Telnet.

DELETE TELNETD

Termina un daemon TN3270 o TN3270E.

DIAGNOSE

Controla las opciones de visualización de diagnóstico.

FLUSH


QUERY ACTIVE


QUERY STATISTICS

Muestra un resumen de la información relacionada con la pila.

QUERY TELNETDS


SET PULSE_TIME

Controla la configuración predeterminada para el intervalo entre sondas

de conexiones inactivas (PULSE= parámetro en DEFINE ROUTE).

SET TELNETD_BUFFERS

Determina el tamaño del grupo de buffers compartido por los daemons TN3270.

SET TELNETD_BUFSIZE

Determina el tamaño de los buffers TN3270 individuales.

127

Capítulo 3 Descripción de Comandos: DEFINE TLSD

DEFINE TLSD

Sintaxis

El comando DEFINE TLSD inicia un daemon SSL/TLS para manejar

el cifrado y descifrado.

DEFine TLSd ID=id ,CERTLibrary=name8 ,CERTMember=name8

,CERTSublibrary=name8 [,CIPher=09]

[,MINVers={0300|0301|0302|0303}] [,PORT=443]

[,PASSport=80] [,TYPE={1|2}]

Argumentos ID= Un nombre único para identificar este daemon.

CERTLibrary= Identifica el nombre de la librería que contiene la clave

privada y los certificados que utilizará este daemon.

CERTMember= Identifica el nombre del miembro que contiene la clave

privada y los certificados que utilizará este daemon.

CERTSublibrary= Identifica la sub-librería que contiene la clave privada que utilizará

este daemon.

CIPher= Una cadena de valores hexadecimales que indican los conjuntos de

cifrado aceptables. Cuando se negocia una conexión, el cliente

deberá seleccionar un conjunto de cifrado de esta lista. Los valores válidos para las versiones de protocolo SSL30, TLS 1.0 y TLS 1.1

son los siguientes:

01 — RSA_NULL_MD5

02 — RSA_NULL_SHA

08 — RSA_SDES040_SHA

09 — RSA_SDES056_SHA

0A — RSA_TDES168_SHA

2F — RSA_AES128_SHA

35 — RSA_AES256_SHA

Cuando se utiliza la versión del protocolo TLS 1.2, los conjuntos de

cifrado admitidos son los siguientes. Estas suites no son compatibles con el algoritmo DES.

2F — RSA_AES128CBC_SHA160

35 — RSA_AES256CBC_SHA160

128


3C — RSA_AES128CBC_SHA256

3D — RSA_AES256CBC_SHA256

MINVers= T Este valor especifica la versión mínima aceptable de SSL/TLS.

0300 Este es el estándar SSL "antiguo" (SSL30) y es menos seguro. La mayoría de los clientes podrán proporcionar este nivel de

soporte.

0301 Este valor requiere que los clientes se adhieran al estándar TLS 1.0 como se establece en IETF RFC2246. Esta versión es más

segura y muchos clientes lo soportan.

0302 Esta es la versión TLS 1.1. Proporciona seguridad mejorada.

0303 Esta es la versión TLS 1.2. Proporciona aún más seguridad,

pero no todos los clientes lo soportan.

PASSport=

Este es el número de puerto único con el que se conectará la aplicación habilitada para SSL/TLS.

Si este valor es idéntico al valor PORT=, esto indica que la

aplicación ha implementado directamente la API SSL/TLS.

PORT= Este es el número de puerto único con el que los clientes se conectarán. Se puede especificar cualquier número de puerto, del 1 al 65,535.

TYPE= Uno de dos valores numéricos puede ser especificados para indicar

si el cliente debe proporcionar autenticación al conectarse.

1 (Predeterminado) No se realiza la autenticación del cliente.

2 La autenticación del cliente se aplica.

129


Ejemplo


Los servidores SSL/TLS siempre deben proporcionar un certificado

al cliente durante la negociación. El cliente luego usa el certificado para autenticar el servidor.

Dadas la librería, la sub-librería y el nombre de miembro

especificados, tres miembros con las extensiones de “.PRVK”,

“.ROOT” y “.CERT” deben existir y contener información válida.

Consulte la Guía de Características Opcionales de TCP/IP FOR

VSE para obtener más información sobre la configuración de la

función SSL/TLS de TCP/IP FOR VSE para VSE.

Cipher suites 0A y 2F son suficientes para la mayoría de las

aplicaciones. Tenga en cuenta que la suite 0A es un cifrado basado en

DES que no es compatible con TLS 1.2.

Cipher suite 35 proporciona el encriptado más seguro para aplicaciones

más sensibles para las versiones de protocolo SSL30, TLS 1.0 y TLS

1.1. Cipher suite 3D proporciona el cifrado más fuerte para la versión del protocolo TLS 1.2.

La compatibilidad con TLS 1.2 también requiere la función CP Assist

for Cryptographic Function (CPACF) de IBM.

Cipher suites 01 y 02 no proporcionan encriptado y, generalmente, no

deben incluirse en la lista.

La codificación CIPHER=08090A2F35 (valores concatenados)

proporciona la mayor flexibilidad para establecer una conexión

encriptada para las versiones de protocolo SSL30, TLS 1.0 y TLS 1.1. Para la versión del protocolo TLS 1.2, la codificación

CIPHER=2F353C3D proporciona la mayor flexibilidad.

Port: 992 Match IP: 0.0.0.0 Menu: MENU01 Terminal: TELNLU01

ID: TELN01 (Inactive) TEL920I TEL921I TEL922I

define tlsd,id=tls01,port=992,passport=992,cipher=08090a2f35 - certlib=prodlib,certsublib=phase,certmember=sample01

query tlsd

IPN253I << TCP/IP TLS Daemons >> IPN617I ID: TLS01 Cipher: 08090A2F35 IPN618I Port: 992 Passport: 992 Type: Server IPN619I Driver: SSLD Minimum version: 0300

define telnetd,id=teln01,tcpappl=telnlu01,menu=menu01,pool=yes,port=992 TEL900I Daemon Startup Telnet Termname: TELNLU01 Port: 992

query telnet IPN253I << TCP/IP Telnet Daemons >>

130


El uso de una conexión cifrada protege los datos SÓLO durante la

transmisión. En la mayoría de los casos donde los datos son robados o falsificados, el acto se realiza en los puntos finales, antes de que los

datos se encripten o después de que se desencripten.


DEFINE FTPD

Crea un daemon de Protocolo de Transferencia de Archivos.

DEFINE HTTPD

Crea un daemon del Protocolo de Transferencia de Hipertexto

(servidor web).

DEFINE TELNETD


DELETE TLSD

Termina un daemon SSL/TLS.

QUERY TLSD

Muestra los daemons TLS actualmente activos.

131

Capítulo 3 Descripción de Comandos: DEFINE TRACE

DEFINE TRACE

Sintaxis

El comando DEFINE TRACE inicia una operación de rastreo para

datagramas. El tráfico IP se guarda en la memoria hasta que se emite el

comando DELETE TRACE correspondiente. El comando DUMP se puede usar en cualquier momento para generar los buffers de rastreo acumulados

DEFine TRACe ID=id [,IPaddr=ip4addr] [,PORT=port]

[,SIZe=500] [,KIND={TCP|UDP|ICMP|ALL}]

Argumentos ID= Un nombre único que identifica esta entrada de rastreo. Este

nombre se usa junto con los comandos DELETE TRACE y

QUERY TRACES.

IPaddr= Limita el rastreo a una dirección IP específica. Solo se considera el

tráfico que involucra la dirección especificada (entrante o saliente).

KIND= Este parámetro selecciona el tipo de tráfico de red que es registrada.

TCP Solo se rastrean los datagramas que contienen cargas TCP

útiles. Este es el valor predeterminado.

UDP Solo se rastrean datagramas que contienen cargas UDP útiles.

ICMP Solo se rastrean los datagramas ICMP (por ejemplo, PING).

ALL Todos los datagramas están incluidos en el rastreo.

PORT= Limita el rastreo a un puerto específico. Solo se considera el tráfico que involucra el puerto especificado (saliente o entrante.

Ejemplo

SIZe= Indica la cantidad máxima de bloques de mensajes que se deben

retener durante el rastreo. Los bloques viejos se descartan a favor de

los bloques más nuevos. El valor predeterminado es 500. Los valores permitidos están en el rango de 10 a 64K.

define trace,id=trace2,ipaddr=192.168.1.66,kind=udp IPN210I Trace ID TRACE2 defined and running.

IPN213I TRACE2 tracing traffic between 192.168.1.161; 21 and 192.168.1.66; 2646

IPN213I TRACE2 tracing traffic between 192.168.1.161; 4109 and 192.168.1.66; 2647

132

Capítulo 3 Descripción de Comandos: DEFINE TRACE

Notas



Una vez que se han acumulado los datos de rastreo, el comando

DUMP se puede usar para volcar los datos.

Asegúrese de terminar su rastreo con DELETE TRACE después de usar el comando DUMP. Debido a que todo el tráfico a una

dirección rastreada se retiene en la memoria, se pueden inmovilizar

grandes cantidades de almacenamiento virtual.

Puede rastrear múltiples direcciones simultáneamente emitiendo múltiples

comandos DEFINE TRACE. Cada rastreo debe tener una ID única.

DEFINE SOTRACE

Inicia un rastreo de socket.

DELETE TRACE

Termina un rastreo y libera su almacenamiento.

DUMP


QUERY TRACES

Muestra una lista de rastreos en ejecución actualmente.

SEGMENT

Segmenta el SYSLST y los archivos de registro, haciéndolos disponibles para imprimir.

133

Capítulo 3 Descripción de Comandos: DEFINE TRANSLATION

DEFINE TRANSLATION

El comando DEFINE TRANSLATION controla la disponibilidad de las

tablas de traducción utilizadas por varios clientes y daemons TCP/IP FOR

VSE. Puede cargar, nombrar y proporcionar la traducción predeterminada.

Sintaxis

Argumentos

Hay tres formas disponibles de este comando. El primero define las tablas de traducción de un solo byte. La segunda define las traducciones en juegos de

caracteres de doble byte (DBCS). La tercera establece una tabla de traducción

cargada previamente como el valor predeterminado de todo el sistema.

DEFine TRANslation MEMber=member [,ENTry=name]

[,NAMe=name16] [,DEFault=name16]

DEFine TRANslation TYpe=Double ,MEMber=member

AScii=name ,EBcdic=name ,NAMe=name16

[,DEFault=name16]

DEFine TRANslation DEFault=name16

MEMber= Especifica el nombre del miembro de la librería en el que reside el

origen de una o más tablas de traducción. El miembro es un "libro .L" y debe residir en una librería en la cadena de búsqueda de la

partición. La información sobre el formato de los miembros y la

personalización de las tablas de traducción se encuentra en la Guía de Instalación de TCP/IP FOR VSE.

ENTry= Los miembros de la tabla de traducción de un solo byte pueden

contener cualquier cantidad de tablas de traducción. Especifique este parámetro para restringir el procesamiento a una sola tabla de

traducción. Si omite este parámetro y el parámetro NAME, todas las

tablas de traducción del miembro se cargan y se identifican en el sistema por sus nombres de entrada. Este parámetro se ignora si se

especifica TYPE=DOUBLE.

NAMe= Especifica el nombre que se asignará a la tabla de traducción después

de cargarla. Es obligatorio si se especifica TYPE=DOUBLE. Para

tablas de un solo byte, NAME= por defecto es el valor de ENTRY=.

DEFault= Al especificar este parámetro, solo o junto con la carga de una o más

tablas de traducción, cambia la tabla predeterminada del sistema. Esta

es la tabla que se usa para la traducción ASCII/EBCDIC cuando el usuario no la anula.

134

Capítulo 3 Descripción de Comandos: DEFINE TRANSLATION

TYpe= Indica el tipo de tabla que se está definiendo

Single Se cargará un conjunto de caracteres de un solo byte (SBCS).


Double Se cargará un conjunto de caracteres de doble byte (DBCS).

AScii= Si especifica TYPE=DOUBLE, debe usar este parámetro para

especificar el nombre de la página de códigos ASCII utlizada para

generar la tabla de traducción.

EBcdic= Si especifica TYPE = DOUBLE, debe usar este parámetro para especificar el nombre de la página de códigos EBCDIC utilizada

para generar la tabla de traducción.

Ejemplo

Notas



Una vez cargada, una tabla de traducción no se puede eliminar. Si la tabla

con el mismo nombre se vuelve a cargar, la nueva tabla reemplazará a la

anterior.

Los conjuntos de caracteres de doble byte se usan solo con chino, japonés

y coreano.

Para definir una tabla de traducción DBCS, también debe definir una tabla de traducción SBCS correspondiente y asignarles nombres idénticos.

Vea la Guía de Instalación de TCP/IP FOR VSE para obtener más

información sobre el uso de tablas de traducción.

QUERY TRANSLATES

Muestra una lista de las tablas de traducción disponibles.

SET TELNET_TRANSLATE

Establece el nombre de la tabla de traducción que se usará con las conexiones Telnet (no TN3270).

define translate,mem=ipxlate,entry=os_02,default=os_02 IPN651I SBCS translation tables being loaded from IPXLATE.L IPN654I Translation table created: OS_02 IPN656I SBCS Table loading complete for member IPXLATE IPN657I Default SBCS translate table set to OS_02

135

Capítulo 3 Descripción de Comandos: DEFINE USER

DEFINE USER

Sintaxis

El comando DEFINE USER le permite especificar las ID de

usuario de los usuarios TCP/IP FOR VSE autorizados de en

ausencia de una salida de seguridad proporcionada por el usuario.

DEFine USEr ID=name16 [,PASSword=name16] [,DATA=any]

[,GID=snum] [,UID=snum] [,MAILbox=str]

[,FTP={YES|NO}] [,LPR={YES|NO}]

[,WEB={YES|NO}] [,TELNET={YES|NO}] [,ROOT=path]

Argumentos ID= Este valor se utilizará como ID de usuario. Será convertido en mayúsculas.

PASSword= Si se especifica, el usuario debe proporcionar el valor correspondiente

antes de permitir el inicio de sesión.

Las contraseñas tienen de 1 a 16 caracteres y siempre se convierten a mayúsculas.

DATA= Esta es una cadena de datos opcional de hasta 40 caracteres especificados por el usuario.

TCP/IP FOR VSE no examina este campo en la entrada. Su contenido se

pasa a la Salida de Seguridad Automática (si está activa) y luego a la

salida de seguridad suministrada por la instalación, si usted proporciona una. No se cambia a mayúsculas. Si el campo contiene espacios en

blanco o comas, debe estar entre comillas simples.

Cuando se pasa a la Salida de Seguridad Automática, cada posición de la cadena de datos debe contener "Y" o "N" para indicar que las funciones

están permitidas (Y) o no permitidas (N). Las posiciones dentro de la

cadena de datos corresponden al valor pasado en el campo SXTYPE del SXBLOK DSECT. Los valores se muestran a continuación en la sección

“Salida de Seguridad Automática,” página 137.

GID= Numérico firmado, de -9999999 a +9999999.

GID define a este usuario como parte de un grupo. TCP/IP FOR VSE no utiliza este campo, sino que lo pasa a la salida de seguridad.

UID= Numérico firmado, de -9999999 a +9999999.

UID asocia a este usuario con un ID de usuario de estilo UNIX. TCP/IP

FOR VSE pasa este campo a la salida de seguridad.

136


FTP= Determina si el usuario está autorizado a usar FTP.

LPR= Determina si el usuario está autorizado para usar LPR.

WEB= Determina si el usuario está autorizado para realizar solicitudes HTTP. Tenga en cuenta que el daemon HTTP también debe configurarse para

aceptar la ID de usuario.

TELNET= Determina si el usuario está autorizado para acceder a los menús de

Telnet. Para que esto sea efectivo, el menú debe tomar medidas para

sondear una ID de usuario y contraseña.

ROOT= Si se especifica y el usuario está autorizado para FTP, la sesión FTP

comenzará en este directorio. El usuario podrá cambiar a subdirectorios

de nivel inferior, pero no podrá acceder a directorios de nivel superior.

Si este valor contiene caracteres especiales, debe estar encerrado en apóstrofes.

Ejemplo


Las ID de usuario y contraseñas no distinguen mayúsculas/minúsculas.

Deben evitarse los caracteres especiales porque un usuario puede tener dificultades para proporcionar valores coincidentes exactos de algunas

plataformas.

Si no se especifica la contraseña, se acepta cualquier valor proporcionado

por el usuario a menos que la salida de seguridad (si la hubiera) determine lo contrario.

Para modificar una entrada, debe eliminarla y redefinirla.

define user,id=don,password=republican, data='Spills Coffee' define user,id=leo, data='Drinks Coffee' ftp=yes, - IPN237I ++SUPRESSED++

query users IPN253I << TCP/IP User IDs >> IPN475I User ID: LEO IPN476I Data: Drinks Coffee IPN883I Valid for: FTP IPN475I User ID: DON IPN476I Data: Spills Coffee

IPN883I Valid for: *All*

137


En caso de entradas duplicadas, se utiliza la que se ingresó primero.

El daemon FTP, el daemon Telnet (si se proporciona un menú que

contiene los campos apropiados) y el daemon HTTP comprueban

los ID de usuario y las contraseñas. El daemon HTTP verifica las ID de usuario si el parámetro SECURITY=ON se especifica en el

comando DEFINE HTTPD.

Si FTP=, LPR=, WEB= o TELNET= no limitan la ID de usuario, entonces

la ID de usuario está autorizada para ser utilizada con todos los servicios.


información sobre ID de usuario y seguridad.

Cualquier instruccion de entrada cuyo primer carácter es "+" no se repite

en el registro TCP/IP. Esto incluye cada línea de una línea "continua" de

comandos.

Salida de Seguridad Automática

Cuando se activa mediante los comandos SECURITY y ASECURITY, la

Salida de seguridad automática valida a cada usuario para la tarea que se

realiza. La autorización del usuario se verifica examinando posiciones de campo específicas en la cadena DATA= suministrada con DEFINE USER.

Para permitir una función debe aparecer una “Y” en su posición asignada;

para no permitir la función, codifique “N”. La siguiente tabla muestra los

números de columna y sus funciones asignadas. Los valores son los que se encuentran en el campo SXTYPE de la macro de mapeo SXBLOK. Para ver

ejemplos, consulte “Administrador de Seguridad Automática” en el capítulo

9, “Seguridad”, en la Guía de Instalación de TCP/IP FOR VSE.

1. Revisión de Password

2. Revisión de Lectura

3. Revisión de Escritura

4. Revisión de Actualizaciones

5. Seguridad de Inicio

6. Seguridad de Apagado

7. Verificación de la Dirección de Hardware

8. Verificación de la Dirección IP

9. Revisión del Comando SITE

10. Revisión de Delete

11. Revisión de Rename

12. Revisión de Create

13. Revisión del Comando EXEC

138


14. Revisión de APPEND

15. Revisión OPDIR

16. Revisión de RDDIR

17. Revisión de CWD

18. Revisión de SHELL

19. Revisión de ICMP

20. Solicitude del Daemon LOGIN

21. Solicitud de RPC

22. Solicitud de la Pantalla de Inicio Web

23. Solicitud de HTTPD SCANBLOCK

24. Crear Directorio

25. Eliminar Directorio

26. Último CWD

27. Incio de la Salida Automática

28. Apagado de la Salida Automática

29. Comando FTPD


ASECURITY


DELETE USER


QUERY USERS

Muestra una lista de ID de usuario definidos.

SECURITY


139

Capítulo 3 Descripción de Comandos: DELETE ALTIP

DELETE ALTIP

Sintaxis

Argumentos

El comando DELETE ALTIP elimina las direcciones IP que fueron

identificadas previamente con el comando DEFINE ALTIP.

DELete ALTIP ID=id

ID= El parámetro ID= que se especificó en el comando DEFINE

ALTIP que creó la entrada.

Ejemplo

Notas


Eliminar una entrada ALTIP no cancela inmediatamente sus efectos. Esto se

debe a que la mayoría de los hosts en su red emiten una solicitud ARP y luego

retienen los resultados por un período de tiempo. Estos valores finalmente caducan (o el host se reinicia) y se emite una nueva solicitud ARP.

DEFINE ALTIP

Causa que la pila supervise y responda a las solicitudes ARP de direcciones de inicio adicionales.

DEFINE LINK

Crea un enlace entre TCP/IP y una red o una pila conectada

directamente.

DEFINE ROUTE


QUERY ALTIPS


delete altip,id=sys2 IPN581I ALTIP SYS2 has been deleted.

140

Capítulo 3 Descripción de Comandos: DELETE CGI

DELETE CGI

Sintaxis

Argumentos

Ejemplo

Notas


El comando DELETE CGI elimina un programa CGI del

almacenamiento. Cuando elimina un CGI, solo está eliminando el

módulo del almacenamiento. No está eliminando la definición CGI. La próxima vez que se solicita el programa, se vuelve a cargar en el

almacenamiento. Esto es útil cuando desea actualizar un CGI.

DELete CGI PUBLIC=pubname

PUBLIC= Especifica el nombre de fase de un programa de ensamblador o el

nombre de PROC para un CGI REXX.

Para obtener más información sobre el uso de CGI con TCP/IP FOR VSE, consulte la Guía del Programador TCP/IP FOR VSE.

DEFINE CGI


QUERY CGIS


delete cgi,pub=procavg IPN694I CGI Deleted

141

Capítulo 3 Descripción de Comandos: DELETE EVENT

DELETE EVENT

Sintaxis

Argumentos

El comando DELETE EVENT le permite eliminar eventos creados por el

comando DEFINE EVENT.

DELete EVENT {ID=id|ALL[,FORCE]}

ID= El parámetro ID que se especificó en el comando DEFINE EVENT

que creó la entrada.

ALL Si se especifica, todos los eventos se eliminan y el evento

finaliza.

Ejemplo

Notas


FORCE Si se especifica con ALL, este parámetro fuerza una terminación

inmediata del evento automático. Toda transmisión en proceso se

pierde. Si no se especifica con ALL, este parámetro se ignora.


El DEFINE EVENT inicial crea un único daemon de tarea automática

que monitorea la fila POWER y procesa los archivos. Esta tarea

permanece hasta que se elimine el último evento con DELETE EVENT.

Eliminar un evento puede no tener efecto inmediato. Emitir una

eliminación marca el elemento para su eliminación. El daemon de tarea

automática realiza la eliminación real cuando completa cualquier transmisión en curso.

El uso de FORCE durante la transmisión de un archivo (FTP o LPR)

puede hacer que el daemon remoto se cuelgue. Tal evento es raro, y

los mecanismos normales de tiempo de espera de la red deberían

corregir la condición de bloqueo en unos minutos.

DEFINE EVENT

Monitorea una clase POWER para la distribución automática de reportes.

QUERY EVENTS


delete event,id=ftp_listen IPN800I Event scheduled for deletion: FTP_LISTEN TCP913I Event Deleted: FTP_LISTEN

142

Capítulo 3 Descripción de Comandos: DELETE FILE

DELETE FILE

Sintaxis

Argumentos

Ejemplo

Notas


El comando DELETE FILE elimina un archivo del sistema de archivos

TCP/IP FOR VSE.

DELete FILE PUBlic=pubname

PUBlic= El nombre público del archive a ser eliminado.


Eliminar un archivo no tiene ningún efecto en los usuarios que ya

lo han abierto.

Cuando los archivos son definidos, se crea una estructura de directorio. Los archivos sólo existen en el nivel más bajo de esta estructura. Por

ejemplo, si define un archivo como TEST.USERS.VSAM.FILE1, el

sistema de archivos contiene cuatro directorios (root, /TEST,

/TEST/USERS/ y /TEST/USERS/VSAM) y una entrada de archivo (en directorio de nivel más bajo). Si elimina el archivo, sólo desaparece la

entrada del archivo. El directorio /TEST/USERS/VSAM todavía existe

pero está vacío. No hay forma de eliminar la estructura del directorio.

DEFINE FILE

Define un archivo en el sistema de archivos TCP/IP FOR VSE y lo

asocia con un controlador I/O de archivo.

QUERY FILES


delete file,public=bimlib IPN581I File definition has been deleted.

143

Capítulo 3 Descripción de Comandos: DELETE FILEIO

DELETE FILEIO

Sintaxis

Argumentos

Ejemplo

Notas

El comando DELETE FILEIO elimina una fase cargada del controlador

de I/O del almacenamiento.

DELete FILEIO,PHASE=name

PHASE= Un nombre de fase listado en la salida QUERY FILEIO.


Debe usar DELETE FILEIO para eliminar un nombre de fase cargado

antes de poder volver a cargar esa fase.

El orden de inicio de TCP/IP y BIM-EDIT es importante para que la interfaz BIM-EDIT funcione correctamente. Si TCP/IP se inició antes

de BIM-EDIT, entonces puede ser necesario emitir las siguientes

instrucciones

aunque parezca que el controlados de archivo IO para BIM-EDIT se

cargó en el momento del inicio de TCP/IP.

Luego necesitará una instrucción DEFINE FILE como

En general, solo debe eliminar las fases del controlador que se

cargaron con DEFINE FILEIO.


DEFINE FILEIO

Carga una fase de controlador I/O de archivo en el almacenamiento.

QUERY FILEIO

Muestra el estado de los programas del controlador I/O de archivo.

DELETE FILEIO,ID=IPNFBIME

DEFINE FILEIO TYPE=BIM-EDIT

DEFINE FILE,PUBLIC='BIMEDIT',DLBL=BIFLIB,TYPE=BIM-EDIT

delete fileio,phase=IPNFBIME IPN264I File driver deleted, Dataset: IPNFBIME

144

Capítulo 3 Descripción de Comandos: DELETE FTPD

DELETE FTPD

Sintaxis

Argumentos

El comando DELETE FTPD elimina un daemon (servidor) FTP del

sistema.

DELete FTPd ,ID=id

ID=

El ID del daemon FTP a ser eliminado.

Ejemplo

Notas



No hay un comando MODIFY FTPD. Para cambiar cualquier especificación, debe eliminar y redefinir el daemon FTP.

Para finalizar una sesión FTP bloqueada, considere usar el

comando FLUSH.

ASECURITY


DEFINE FTPD


DEFINE USER


FLUSH


QUERY FTPDS


Archivos.

QUERY CONNECTIONS

Muestra el estado de una o más conexiones.

QUIESCE

Evita nuevas conexiones mientras permite que las conexiones

existentes continúen.

delete ftpd,id=ftp01 FTP912I FTP01 not accepting connections on port 21 FTP908I Daemon Shutdown FTP Id: FTP01 Port: 21

145

Capítulo 3 Descripción de Comandos: DELETE GPSD

DELETE GPSD

Sintaxis

Argumentos

El comando DELETE GPSD finaliza un Daemon GPS activo. Cuando

usted emite este comando, el procesamiento se detiene inmediatamente.

DELETE GPSD ID=id

ID= El parámetro ID= utilizado para definir el Daemon GPS.

Ejemplo


DEFINE GPSD

Crea un daemon de Servidor de Impresión General.

QUERY GPSDS

Muestra el estado de los daemons de Servidor de Impresión General.

delete gpsd,id=gpsd1 GPS922I GPSD1 GPS Shutting down GPS924I GPSD1 GPS Shutdown complete

146

Capítulo 3 Descripción de Comandos: DELETE HTTPD

DELETE HTTPD

Sintaxis

Argumentos

El comando DELETE HTTPD elimina un daemon (servidor) HTTP

del sistema.

DELete HTTPd ID=id

ID= El valor ID= utilizado para definir el daemon HTTP a eliminar.

Ejemplo

Notas


No hay un comando MODIFY HTTPD. Para cambiar las especificaciones,

debe eliminar y redefinir el daemon.

DEFINE HTTPD

Crea un daemon de Protocolo de Transferencia de Hipertexto (servidor web).

QUERY HTTPDS

Muestra el estado de los daemons de Protocolo de Transferencia de Hipertexto (servidor web).

delete http,id=h1 HTT903I Daemon Shutdown HTTP

147

Capítulo 3 Descripción de Comandos: DELETE LINK

DELETE LINK

Sintaxis

Argumentos

El comando DELETE LINK le permite eliminar un dispositivo de

acceso a la red o un controlador de su configuración actual.

DELete LINK ID=id

ID= El valor ID= utilizado para definir el enlace que será eliminado.

Ejemplo


PRECAUCIÓN:

Si necesita adjuntar dinámicamente un nuevo enlace, después

de ejecutar DELETE LINK debe seguir estos pasos:

1. Elimine todas las rutas definidas usando DELETE ROUTE.

2. Defina el nuevo enlace usando DEFINE LINK.

3. Defina las rutas nuevamente usando DEFINE ROUTE.

Si no sigue este orden, después de definir el nuevo enlace, el tráfico

no se dirigirá correctamente al hardware de conexión apropiado.

Como alternativa a estos pasos, puede alternar la pila TCP/IP.

Cuando utiliza el comando DELETE LINK, se omitirán todas las instrucciones ROUTE que hacen referencia al enlace. Estos se

reactivarán cuando, y si, se redefine el enlace.

Cuando utiliza el comando DELETE LINK, las entradas en la tabla

ARP se descartan automáticamente.

Todas las definiciones de adaptador asociadas con el enlace también serán eliminadas.


DEFINE ADAPTER


DEFINE LINK

Crea un enlace entre TCP/IP FOR VSE y una red o una pila conectada directamente.

QUERY LINKS


delete link id=link3172 IPT101I Link Driver Processor LCS stopping

148

Capítulo 3 Descripción de Comandos: DELETE LPD

DELETE LPD

Sintaxis

Argumentos

El comando DELETE LPD elimina un LPD (servidor) del sistema. Si el

LPD está actualmente en uso, se marca para su eliminación tan pronto

como finalice la operación actual.

DELete LPD ID=id

ID= El valor PRINTER= utilizado para definer el LPD a eliminar.

Ejemplo


DEFINE LPD

Crea un daemon de Impresión en Línea.

FLUSH


query lpds IPN253I << TCP/IP Line Printer Daemons >> IPN444I Print Name: HEX UserID: $LPD Hexdump Mode IPN445I Queue: POWER.LST.A. IPN446I Library: MEMORY. IPN444I Print Name: LOCAL UserID: $LPD IPN445I Queue: POWER.LST.A. IPN446I Library: MEMORY. delete lpd,id=local LPD932I LPD queue scheduled for deletion: LOCAL LPD935I LPD queue deleted: LOCAL query lpds IPN253I << TCP/IP Line Printer Daemons >> IPN444I Print Name: HEX UserID: $LPD Hexdump Mode IPN445I Queue: POWER.LST.A. IPN446I Library: MEMORY.

149

Capítulo 3 Descripción de Comandos: DELETE MASK

DELETE MASK

Sintaxis

Argumentos

Ejemplo

Notas


El comando DELETE MASK elimina una entrada en la tabla de máscara

de subred.

DELete MASK NETwork=ip4addr

NETwork= La red cuya máscara será eliminada. La parte del host, si no es

cero, se ignora.


Para una discusión sobre el direccionamiento, consulte la sección

“Direccionamiento de red” en la Guía de Instalación de TCP/IP FOR VSE.

La máscara de subred predeterminada no se ve afectada por el

comando DELETE MASK. Para cambiar la máscara predeterminada, use el comando SET MASK.

Eliminar una entrada de máscara de subred cambia la forma en que

se interpretan las instrucciones DEFINE ROUTE.

Eliminar una máscara de subred puede afectar la forma en que se

asignan los daemons Telnet y FTP, si sus definiciones usan el

parámetro IPADDR=.

DEFINE MASK


QUERY MASKS


QUERY ROUTES

Muestra el contenido de la tabla de enrutamiento de red o la ruta tomada para llegar a una dirección específica.


delete mask network=192.168.30.0 IPN581I Mask 192.168.30.0 has been deleted.

150

Capítulo 3 Descripción de Comandos: DELETE MENU

DELETE MENU

Sintaxis

Argumentos

El comando DELETE MENU elimina un menú telnet y libera el

almacenamiento.

DELete MENu ID=id

ID= El identificador del comando DEFINE MENU que creó el menú que

usted está borrando.

Ejemplo

Notas



Un daemon telnet sólo accede a los menús cuando se solicita una conexión.

Eliminar un menú mientras está siendo mostrado a un usuario

produce resultados impredecibles.

DEFINE MENU

Carga un archive de menú y lo habilita para ser utilizado por daemons

Telnet.

DEFINE TELNETD Crea un daemon TN3270 o TN3270E

QUERY MENUS

Muestra los menús disponibles para uso TN3270.

QUERY TELNETDS


delete menu,id=menuadm IPN581I Menu MENUADM has been deleted.

151

Capítulo 3 Descripción de Comandos: DELETE NAME

DELETE NAME

Sintaxis

Argumentos

Ejemplo


El comando DELETE NAME elimina una entrada de la tabla de nombres

simbólicos.

DELete NAME NAME={name|DYNAMIC}

NAME= El nombre simbólico que se eliminará. No distingue mayúsculas de

minúsculas. Un nombre especial reservado se puede especificar, "DYNAMIC", para eliminar todas las entradas almacenadas en caché

creadas por una búsqueda DNS.

DEFINE NAME

Asocia un nombre TCP/IP FOR VSE con una dirección IPv4 o un

archivo de script.

QUERY NAMES

Muestra los nombres TCP/IP FOR VSE y los valores asociados.

delete name,name=devpun IPN581I Name DEVPUN has been deleted.

152

Capítulo 3 Descripción de Comandos: DELETE NTPD

DELETE NTPD

Sintaxis

Argumentos

El comando DELETE NTPD elimina un daemon de Protocolo de

Tiempo de Red del sistema.

DELete NTPd ID=id

ID= La ID que identifica al daemon que se va a eliminar

Ejemplo


DEFINE NTPD

Inicia un daemon NTP.

DEFINE NTPD

Crea un daemon de Servidor de Tiempo de Red.

QUERY NTPDS


delete ntpd,id=ntp1 NTP102I NTP Daemon shutdown complete

153

Capítulo 3 Descripción de Comandos: DELETE PUBLISHER

DELETE PUBLISHER

Sintaxis

Argumentos

El comando DELETE PUBLISHER elimina un daemon Publisher de su

configuración.

DELete PUBLisher ID=id

ID= El identificador del comando DEFINE PUBLISHER que creó el

daemon que está eliminando.

Ejemplo


DEFINE PUBLISHER

Crea un daemon Publisher.

QUERY PUBLISHER

Muestra el estado del daemon Publisher.

delete publisher,id=pub01 IPN694I Publishing Daemon shutting down

154

Capítulo 3 Descripción de Comandos: DELETE ROUTE

DELETE ROUTE

Sintaxis

Argumentos

El comando DELETE ROUTE elimina la información de enrutamiento

de la tabla de enrutamiento interno TCP/IP FOR VSE.

DELete ROUTe ID=id

ID= El parámetro ID especificado con el comando DEFINE ROUTE que

creó la entrada de ruta.

Ejemplo


DEFINE ROUTE

Agrega una entrada a la tabla de enrutamiento TCP/IP FOR VSE.

MODIFY ROUTE

Cambia los valores de una entrada existente en la tabla de enrutamiento.

QUERY ROUTES



delete route id=default

IPN581I Route DEFAULT has been deleted.

155

Capítulo 3 Descripción de Comandos: DELETE TELNETD

DELETE TELNETD

Sintaxis

Argumentos

El comando DELETE TELNETD elimina un daemon Telnet de su

configuración.

DELete TELnetd ID=id

ID= El identificador del comando DEFINE TELNETD que creó el

daemon que usted está eliminando.

Ejemplo

Notas



Para borrar una sesión no deseada, intente usar el comando FLUSH. El usuario se descarta y el daemon se libera para otros usuarios.

Si las sesiones Telnet se quedan pendientes, considere un valor más

bajo para SET PULSE_TIME. Esto permite que TCP/IP FOR VSE detecte y restablezca las sesiones Telnet "huérfanas" automáticamente.

DEFINE TELNETD

Crea un daemon TN3270 o TN3270E

FLUSH


QUERY TELNETDS


SET PULSE_TIME

Controla la configuración predeterminada para el intervalo entre

sondas de conexiones inactivas (PULSE= parámetro en DEFINE ROUTE).

delete telnetd,id=lu05 TEL918I Daemon Shutdown Telnet Termname:TELNLG05

156

Capítulo 3 Descripción de Comandos: DELETE TLSD

DELETE TLSD

Sintaxis

Argumentos

El comando DELETE TLSD elimina un daemon SSL/TLS de su

configuración.

DELete TLSd ID=id

ID= El identificador del comando DEFINE TLSD que creó el daemon

que usted está eliminando.

Ejemplo

Notas



Eliminar un daemon TLS termina cualquier conexión que lo esté usando.

El comando QUIESCE puede ser útil para evitar nuevas conexiones

mientras se completan las existentes.

DEFINE TLSD

Crea un daemon SSL/TLS.

FLUSH


QUERY CONNECTIONS


QUERY TLSD

Muestra los daemons TLS actualmente activos.

QUIESCE Impide nuevas conexiones pero permite que las conexiones


delete tlsd,id=tlsdtnds TLS903I Daemon Shutdown TLS Id:TLSDTNDS

157

Capítulo 3 Descripción de Comandos: DELETE TRACE

DELETE TRACE

Sintaxis

Argumentos

El comando DELETE TRACE finaliza un rastreo en ejecución y libera

todo el almacenamiento asociado a ella. Esto incluye rastreos iniciadas

con DEFINE TRACE y DEFINE SOTRACE.

DELete {TRACe ID=id | TRACES}

ID= El ID que identifica la entrada del rastreo que se eliminará. Este nombre fue asignado por un comando DEFINE TRACE correspondiente.

Ejemplo

Notas


Debe emitir el comando DUMP para volcar el rastreo en ejecución antes de emitir el comando DELETE TRACE porque DELETE

TRACE libera todo el almacenamiento relacionado con el rastreo.

DEFINE SOTRACE

Inicia un rastreo de socket.

DEFINE TRACE

Inicia un rastreo de datagrama.

DUMP

Realiza un volcado formateado de varios bloques de control TCP/IP

FOR VSE.

QUERY TRACES

Muestra una lista de rastreos actualmente en ejecución.

delete traces IPN581I Trace TRACE2 has been deleted. IPN581I Trace TRACE1 has been deleted.

158

Capítulo 3 Descripción de Comandos: DELETE USER

DELETE USER

Sintaxis

Argumentos

Ejemplo


El comando DELETE USER elimina una ID de usuario de la tabla de ID

de usuario.

DELete USEr NAMe=id

NAMe = El nombre de usuario a ser eliminado.

DEFINE USER


QUERY USERS

Muestra una lista de ID de los usuarios definidos.

delete user,name=guest IPN581I User GUEST has been deleted.

159

Capítulo 3 Descripción de Comandos: DIAGNOSE

DIAGNOSE

El comando DIAGNOSE le permite recopilar información de diagnóstico

específica para una función determinada. El resultado del comando está

destinado principalmente a ayudar al Soporte Técnico de CSI a resolver los problemas que pueda encontrar.

Sintaxis

Argumentos

Para dirigir el resultado del comando DIAGNOSE a SYSLST y a la

consola TPC/IP, vea el comando SET DIAGNOSE.

DIAGnose {OFF|[-]keyword}

keyword

Al especificar una de las palabras clave a continuación, se activa el

mensaje de diagnóstico relacionado. Especificar una palabra clave con un prefijo “-” desactiva los diagnósticos relacionados.

ARPs Rastrea solicitudes de Protocolo de Resolución de Direcciones (ARP).

AUTOmation Muestra los scripts de correo electrónico activados por los comandos

DEFINE EVENT a medida que se ejecutan los scripts. Analiza lo que sucede antes de que el cliente interno obtenga el control y también

después de que el cliente interno haya finalizado, como la disposición

final de un informe. Esto puede ayudar a resolver problemas relacionados con EMAIL, LPR o FTP automático

CHECksum Cuando están vigentes, los datagramas rechazados debido a una suma

de verificación fallida se resumen y se vuelcan. Esta configuración se desactiva después de que 10 datagramas son interceptados y mostrados.

CLEAnup Muestra el progreso del proceso de limpieza periódica de la pila.

CLOSe Produce mensajes de diagnóstico relacionados con las diversas etapas para el proceso CLOSE de la conexión TCP.

CONNect Este es un alias para la palabra clave TCP en la página 162.

CONNReject | CONReject Muestra diagnósticos para solicitudes de conexión rechazadas para conexiones TCP.

CONTrol Produce información sobre solicitudes de conexión SOCKET

CONTROL.

DEBug Produce información sobre ciertos módulos y sus funciones que

generalmente es útil solo para CSI Software Development, pero

160


también puede ser solicitada por el Soporte Técnico de

CSI al depurar un problema que afecta a esos módulos.

DNC Produce información relacionada con el Nombre de Dominio del Cliente.

DTLOAD Monitorea la carga y gestion de fases.

EMAIL Produce diagnósticos de clientes de correo electrónico.

FILEIO Produce mensajes que contienen recuentos de registros del sistema de archivos.

FILEREQ Produce información sobre solicitudes del sistema de archivos.

FRAGment Monitorea la fragmentación/desfragmentación de datagramas.

FTP Produce diagnósticos relacionados con clientes FTP internos (no

FTPBATCH)).

FTPD Produce información adicional del daemon FTP

GETVIS Muestra usos altos del sistema GETVIS cuando se emite en la

partición TCP/IP. Esto es diferente de CLEANUP, que también

provoca mensajes y volcados relacionados con la limpieza de

conexiones abandonadas. Nota: Para mostrar el uso de GETVIS por subgrupos, use el comando VSE GETVIS SVA,DETAILS.

GPS Produce diagnósticos de daemon GPS.

HASHing Produce diagnósticos relacionados con los servicios

CCBLOK (Bloque de Control de Conexión).

HTTP Produce información de los procesos HTTPD.

IBBLOK Produce diagnósticos de gestión IBBLOK.

ICMP Rastrea la producción y el manejo de datagramas ICMP (ping).

LIBR Monitorea el I/O de los miembros de la Librería.

161


LINK Produce diagnósticos de controlador de enlace (que no sea CLAW).

LOCks Produce mensajes de diagnóstico para el administrador de bloqueos internos.

LPD Produce el diagnóstico del daemon de Impresión en Línea.

LPR Produce diagnósticos para procesos relacionados con LPR.

MISRoutedip Cuando está vigente, los datagramas de IP mal enrutados se

resumen y se vuelcan. Esta configuración se desactiva después

de que 10 datagramas son interceptados y mostrados.

NONIp Cuando está vigente, los datagramas que no son IP se resumen

y se vuelcan. Esta configuración se desactiva después de que 10

datagramas son interceptados y mostrados.

OFF Desactiva la operación de diagnóstico y restablece todas las opciones.

PERForm Muestra datos de rendimiento después del cierre de cada conexión.

POWer Vuelca las áreas de datos devueltas desde la interfaz de programación de aplicaciones POWER. Debe usar este parámetro solo si tiene

problemas con el controlador POWER File/IO o según lo indique el

Soporte Técnico de CSI.

PUBLish Hace que la información se almacene ("publique") y que luego pueda revisarse ejecutando la utilidad por lotes PUBLISH.

PULSe Produce información durante las operaciones de salida de PULSE.

REJICmp Cuando está vigente, los datagramas ICMP entrantes rechazados

se resumen y se vuelcan. Esta configuración se desactiva después de que 10 datagramas son interceptados y mostrados.

REJIGmp Cuando está vigente, los datagramas IGMP entrantes se resumen y

se vuelcan. Esta configuración se desactiva después de que 10


162


REJLngth Cuando está vigente, los datagramas entrantes rechazados debido a una longitud inadecuada se resumen y se vuelcan. Esta configuración se

desactiva después de que 10 datagramas son interceptados y mostrados.

REJProto Cuando está vigente, los datagramas entrantes rechazados debido a un “protocolo desconocido” se resumen y descartan. Esta configuración se

desactiva después de que 10 datagramas son interceptados y mostrados.

REJUdp Cuando está vigente, los datagramas UDP entrantes rechazados se resumen y se vuelcan. Esta configuración se desactiva después de que 10


RESet Muestra información cada vez que el host o cliente externo restablece

una conexión TCP.

RETRANsmit Monitorea las operaciones de retransmisión TCP.

ROUTing Muestra información mientras se buscan las tablas de enrutamiento.

SECUrity Produce diagnóstico de procesamiento de seguridad.

SOCkets Produce mensajes de interfaz de socket.

SSL Produce diagnósticos de Layers de Sockets Seguros.

TCP Produce diagnósticos voluminosos en SYSLST que son útiles para el Soporte Técnico de CSI en el diagnóstico de problemas de TCP. Úselo

brevemente sólo cuando lo recomiende el Soporte Técnico de CSI y

durante los periodos en que no afectará su entorno de producción.

TELetd Produce información de daemons TN3270.

TELProxy Produce diagnósticos de Telnet Proxy.

UDP Permite el seguimiento de diagnóstico de datagramas UDP a través de la

pila.

WEB Al igual que HTTP, emite mensajes que pueden ser de interés al depurar un problema. A diferencia de DIAGNOSE HTTP, se centra en

características especiales en lugar de operaciones HTTP generales.

163


Ejemplo

Notas



El resultado del comando DIAGNOSE puede ser voluminosa.

Múltiples opciones de diagnóstico pueden estar vigentes al mismo tiempo.

Volver a emitir el comando DIAGNOSE con un operando diferente agrega

(o resta) el nuevo valor. Para eliminar un valor, puede borrarlo individualmente con un prefijo “-”, o puede usar el operando "OFF" para

borrar todas las entradas.

MODIFY LOG


QUERY DIAGNOSE

Muestra la configuración actual de DIAGNOSE vigente.

RAPTRAC

Registra eventos significativos que ocurren durante el procesamiento

de TCP/IP FOR VSE. Se utiliza para la resolución de problemas en la dirección del Soporte Técnico de CSI.

SET DIAGNOSE Permite la visualización de la consola de mensajes resultantes del comando

DIAGNOSE.

I diagnose perform IPN524I Diagnose status for Perform set to on

164

Capítulo 3 Descripción de Comandos: DISCOVER

DISCOVER

Sintaxis

Argumentos

Ejemplo

Notas


El comando DISCOVER le permite determinar el tamaño de MTU más

grande permitido para un host remoto en particular.

DISCover host

host Especifica la dirección IP del host de destino. Ésta puede ser una

dirección numérica real o un nombre simbólico que puede resolverse en una dirección IP.


Cada comando DISCOVER emite múltiples PING de diferentes

longitudes para determinar el tamaño máximo de MTU disponible.

Si la ruta al host remoto cambia, el valor de MTU puede cambiar.

Si la ruta al host remoto no es confiable (por ejemplo, si hay pérdida de paquetes), DISCOVER puede devolver un valor inferior al

óptimo. Por esta razón, puede ser útil repetir el comando.

DEFINE LINK

Crea un enlace entre TCP/IP FOR VSE y una red o una pila


DEFINE ROUTE


TCP910I The best MTU discovered: 1500.

discover 192.168.2.10 TCP910I Test for MTU 576 succeeded

TCP910I Test for MTU 1501 failed TCP910I Test for MTU 1038 succeeded TCP910I Test for MTU 1269 succeeded TCP910I Test for MTU 1385 succeeded TCP910I Test for MTU 1443 succeeded TCP910I Test for MTU 1472 succeeded TCP910I Test for MTU 1486 succeeded TCP910I Test for MTU 1493 succeeded TCP910I Test for MTU 1497 succeeded TCP910I Test for MTU 1499 succeeded TCP910I Test for MTU 1500 succeeded TCP910I Test for MTU 1501 failed

165

Capítulo 3 Descripción de Comandos: DISCOVER

PING

Emite una solicitud de Eco ICMP (PING).

TRACERT

Muestra cada “salto” en una ruta junto con el tiempo necesario

para alcanzarlo.

166

Capítulo 3 Descripción de Comandos: DOWNCHECK

DOWNCHECK

Sintaxis

Argumentos

El comando DOWNCHECK controla si se requiere una

confirmación cuando se ingresa el comando SHUTDOWN.

DOWNcheck {ON|OFF}

ON (Predeterminado) Cuando se ingresa un comando SHUTDOWN, se

le solicita al operador la verificación.

OFF Un comando SHUTDOWN del operador entra en vigencia

inmediatamente, sin un aviso.

Ejemplo


QUERY OPTIONS


SHUTDOWN

Termina el procesamiento y cierra la pila.

downcheck on IPN268I DOWNCHECK now set to ON

167

Capítulo 3 Descripción de Comandos: DUMP

DUMP

Sintaxis

El comando DUMP se utiliza con fines de diagnóstico. Cuando se emite,

formatea e imprime el contenido del almacenamiento solicitado en SYSLST.

DUMP {ALL|BUFfers|BUS|CONnects|DIRectory|Events|EXITS

FRAgments|FREquests|FTPds|GIVesockets|GPSds|

HTTpds|IVBlok|LINks|LPDs|MASks|MENus|NAMes|

PARTITION|PROGrams|ROUtes|SOCkets|STAts|TASks|

TELnetds|TIMERS|TLSds|TRACes|TRANslations|

USErs|VERsions}

Argumentos

ALL

Todas las áreas elegibles son volcadas. Esta opción requiere mucho

espacio de CPU y spool.

BUFfers Los buffers Telnet agrupados son volcados.

BUS El bus de datos (IBBLOK) es volcado.

CONnects Los bloques de control de conexión son volcados.

DIRectory Los bloques de directorio del sistema de archivos son volcados.

Events Los Bloques de Eventos de automatización actualmente en fila se vuelcan.

EXITS Los contenidos de los bloques de control (XIBLOK) creados mediante la

emisión de DEFINE EXITS son volcados.

FRAgments Los fragmentos de datagramas que se están procesando actualmente se vuelcan.

FREquests Las solicitudes de I/O de archivos en proceso son volcadas.

FTPds Los bloques de control que pertenecen a los daemons FTP se vuelcan.

GIVesockets La fila GiveSocket es volcada.

GPSds Los bloques de control que pertenecen a los daemons GPS se vuelcan.

168


HTTpds Los bloques de control que pertenecen a daemons HTTP se vuelcan.

IVBlok El Bloque Interno del Vector es volcados.

LINks Se descargan los bloques de control del controlador de enlace.

LPDs Los bloques de control LPD son volcados.

MASks Las máscaras creadas por DEFINE MASKS son volcadas

MENus Los menús TelnetD son volcados.

NAMes Los bloques creados por DEFINE NAME son volcados.

PARTITION El almacenamiento de particiones para la pila TCP/IP es volcado.

PROGrams Los programas cargados son volcados.

ROUtes La tabla de enrutamiento es volcada.

SOCkets Los bloques de socket asignados actualmente se vuelcan.

STAts El contenido de la tabla de estadísticas es volcado.

TASks Los bloques de control de pseudo tarea son volcados.

TELnetds Los bloques de control que pertenecen a los daemons Telnet se vuelcan.

TIMERS Todos los temporizadores definidos internamente y en espera de

finalización son volcados.

TLSds Los bloques de control que pertenecen a los daemons TLS son volcados.

TRACes Vuelca el contenido de todos los comandos DEFINE TRACE y DEFINE

SOTRACE que se ejecutan actualmente.

169


TRANslations Las tablas de traducción son volcadas.

USErs Los bloques de usuario, creados por DEFINE USER, son volcados.

VERsions La tabla de versiones es volcada.

Ejemplo

Notas



Exceptuando DUMP TRACES, el resultado del comando DUMP es

de poca utilidad para la instalación. En general, debe usar este

comando solo cuando lo indique el Soporte Técnico de CSI.

Independientemente de la configuración del registro, el comando

DUMP nunca envía datos a la consola.

El resultado del comando DUMP puede ser voluminoso. Es probable que el

procesamiento TCP/IP FOR VSE se vea afectado durante el volcado.

DEFINE SOTRACE

Inicia un Rastreo de Socket.

DEFINE TRACE

Inicia un Rastreo de Datagrama.

QUERY TRACES

Muestra una lista de los rastreos actualmente en ejecución.

dump users IPN206I Dump has completed

170

Capítulo 3 Descripción de Comandos: DUMPOPTION

DUMPOPTION

Sintaxis

Argumentos

Este comando le permite especificar opciones de volcado para errores

relacionados con TCP/IP.

DUMPOption FILeio={Csi|Ibm|None}

FILeio= Esta opción controla los volcados causados cuando la subtarea de I/O

de archivo termina de forma anómala. Se considera que esta subtarea es “prescindible” porque la pila no puede atrapar ciertas condiciones

comunes relacionadas con I/O ni se puede programar una rutina de

reintento. Después de un fin anormal, la subtarea se vuelve a unir y se recuperan todas las solicitudes de I/O enfilala.

Csi El volcado producido está en formato CSI y se formatean

varias áreas internas relacionadas con TCP/IP. Este es el valor predeterminado.

Ibm El volcado se crea en formato estándar de IBM. Esto puede ser

más útil si el problema es recurrente y/o si involucra una rutina

de I/O de archivo suministrada por el usuario, si se consulta a IBM, o si se trata de otro software de terceros.

Ejemplo


None No se producen volcados. Use esta opción cuando ya tenga información de diagnóstico y los volcados adicionales serían un

desperdicio de recursos.

QUERY FILEIO

Muestra el estado de los programas del controlador de I/O de archivos.

QUERY PROGRAMS

Muestra las fases del programa que usa TCP/IP, sus características, sus ubicaciones de memoria y la biblioteca desde la que se cargó

cada una.

dumpoption fileio=csi

IPN818I Dump Options for File I/O set to CSI format

171

Capítulo 3 Descripción de Comandos: EMAIL

EMAIL

Sintaxis

Argumentos

El comando EMAIL establece y muestra varios valores globales utilizados

por el cliente EMAIL para transmitir mensajes de correo electrónico.

EMAIL [,SMTPd=ip4addr] [,ATsign=7C] [,FRom=string64]

[,DESTination=string64] [,REPlyto=string64]

[,RPORT=25] [,SUBject=string64]

[,USERid=$EMAIL] [,PASSword=$EMAIL]

[,LUSERid=$EMAIL] [,LPASSword=$EMAIL]

[,TRANslation=name16] [,TRAttachments=name16]

[,TRMail=name16] [,CHECKname={Yes|No}]

[,GMT=snum]

The EMAIL command may be repeated, as needed, to establish and change the values. Default values are supplied the first time EMAIL is

issued. Thereafter, if a parameter is omitted, the current value is left

unchanged. Issuing EMAIL with no parameters is equivalent to issuing QUERY EMAIL.

ATsign= La representación hexadecimal (EBCDIC) del carácter utilizado para

separar la parte de ID de usuario de una dirección de correo electrónico del nombre de dominio. El valor predeterminado es “7C” (@)

CHECKname= Controla si el cliente EMAIL busca un nombre de correo electrónico válido.

Yes (Predeterminado) El nombre del correo electrónico se verifica

para asegurarse de que sea sintácticamente correcto.

No Los nombres de correo electrónico no se verifican y se usan tal cual.

DESTination= Una cadena de 1 a 64 caracteres que define un dominio

predeterminado para las direcciones de correo electrónico. El cliente

EMAIL forma una dirección completa agregando el signo arroba (@) y esta cadena al parámetro $$ LST DEST= cuando DEFINE EVENT

especifica HOSTname=USER. Establecer este valor es útil cuando un

dominio predeterminado (SET DEFAULT_DOMAIN) no puede asignarse globalmente en el miembro de inicialización TCP/IP FOR

VSE. El dominio que establezca con DESTINATION= tiene prioridad

sobre el valor definido por el comando SET DEFAULT_DOMAIN.

FRom= Una cadena de 1 a 64 caracteres que se utilizará como el campo

predeterminado "DE" en los correos electrónicos.

172


GMT= Un número con signo en el rango de +/- 2359 que se agrega algebraicamente a la hora local para obtener la hora GMT. Los tiempos transmitidos en

mensajes de correo electrónico siempre se expresan como valores GMT. Si

no se especifica, se utiliza el valor establecido durante IPL.

LPASSword= Esta es la "contraseña local" de 1 a 16 caracteres que se pasará a la Salida de Seguridad.

LUSERid= Este es el "ID de usuario local" de 1 a 16 caracteres que se pasará a

la Salida de Seguridad.

PASSword= Esta es la "contraseña SMTP" de 1 a 16 caracteres que se utiliza para

acceder al servidor SMTP si el cliente EMAIL especifica AUTH=ON.

REPlyto= Una cadena de 1 a 64 caracteres que se utilizará como el campo

predeterminado “REPLY TO” en los correos electrónicos.

RPORT= Este es el puerto remoto para el servidor SMTP.

SMTPd= La dirección IP que identifica el SMTP a través del cual se enrutará

el correo electrónico.

SUBject= Una cadena de 1 a 64 caracteres que se utilizará como el campo

predeterminado “SUBJET” en los correos electrónicos.

TRANslation= El nombre de la tabla de traducción que se utilizará para traducir entre

EBCDIC y ASCII. Si no se especifica, se usa el valor predeterminado del

sistema.

TRAttachments= El nombre de la tabla de traducción que se utilizará para convertir archivos adjuntos de EBCDIC a ASCII. Si no se especifica, se

utiliza el valor vigente para TRANSLATION=.

TRMail= El nombre de la tabla de traducción que se utilizará para convertir el

texto del "cuerpo" del correo electrónico de EBCDIC a ASCII. Si no se especifica, se utiliza el valor vigente para TRANSLATION=.

USERid= Este es el "ID de usuario SMTP" de 1 a 16 caracteres que se utiliza para acceder al servidor SMTP si el cliente EMAIL especifica AUTH=ON.

173


Ejemplo


DEFINE EVENT

Monitorea una clase POWER para la distribución automática de informes.

QUERY EMAIL Muestra la configuración del cliente EMAIL. Nota: La emisión del

comando EMAIL sin ningún parámetro produce los mismos resultados.

SET DEFAULT_DOMAIN

Establece un nombre de dominio que se agregará automáticamente a

los nombres no calificados.

email gmt=-500 IPN253I << TCP/IP EMAIL >> IPN835I UserID: $EMAIL RPort: 25 IPN838I Truncate: NO - AtSign: 7C GMT: -05:00 IPN840I Translation table (General): Default IPN840I Translation table (Text): Default IPN840I Translation table (Attachments): Default

174

Capítulo 3 Descripción de Comandos: EXECUTE

EXECUTE

Sintaxis

Argumentos

Ejemplo

Notas


El comando EXECUTE ordena a TCP/IP FOR VSE que busque un

miembro de una librería VSE y ejecute el contenido como si las líneas se

hubieran ingresado desde la consola.

EXECute member

member El nombre del miembro que contiene los comandos que se ejecutarán. Se agrega un tipo de miembro de ".L" al nombre. El

miembro debe ser accesible en la cadena de búsqueda LIBDEF

para la partición TCP/IP FOR VSE.


Puede ser conveniente mantener conjuntos de comandos similares

(como los comandos DEFINE USER) en miembros separados y

luego ejecutarlos con el comando EXECUTE.

El comando EXECUTE funciona como el comando INCLUDE.

INCLUDE

Incluye un miembro de la librería en el conjunto de parámetros de inicialización.

exec newroute IPN397I Loading command deck NEWROUTE IPN398I Command deck NEWROUTE has been completely loaded IPN179I Direct Route 192.169.8.7= Net: 43272 Subnet: 0 Host: 7 IPN179I Direct Route 192.169.8.9= Net: 43272 Subnet: 0 Host: 9

175

Capítulo 3 Descripción de Comandos: EXTPGVS

EXTPGVS

El comando EXTPGVS le permite controlar si las solicitudes de socket de

partición externa se asignan en el almacenamiento de partición privada de

31 bits o en el almacenamiento GETVIS del sistema de 31 bits.

Sintaxis

Argumentos

Usted emite este comando en la partición TCP/IP FOR VSE.

EXTPGVS {ON|OFF}

ON El programa residente SVA, ASOCKET, carga $BSOCKET.PHASE en

una partición privada GETVIS. Las solicitudes de socket externo se ponen en fila de forma independiente en un bloque de control de partición anclado

en el campo COMREG-IJBTCPP2. El programa CSOCKET de la partición TCP/IP luego utiliza el modo de registro de acceso para extraer las

solicitudes de socket TCP asignadas en la partición privada de 31 bits GETVIS de la partición externa a la partición TCP/IP.

EXTPGVS ON, el valor predeterminado, supone que tiene un almacenamiento SVA adecuado para realizar la asignación/desasignación

de SOCKET. Es el método preferido para un mejor rendimiento.

OFF El programa ASOCKET utiliza el método heredado de asignación de

solicitudes de socket de partición externa en el almacenamiento GETVIS del sistema de 31 bits. En el momento en que se produce una solicitud de

envío de socket, el programa copia los buffers de la aplicación en el

sistema GETVIS y lo pone en fila en la partición TCP/IP.

EXTPGVS OFF se recomienda para sitios con almacenamiento SVA

inadecuado, como lo indican los mensajes IPN960C de TCP/IP FOR

VSE que advierten sobre un almacenamiento SVA inadecuado.

Notas

Comandos Relacioados


Para EXTPGVS ON, TCP/IP emite una suma de verificación en los datos, de

modo que cuando se modifiquen y si cambian, se detectarán las diferencias.

Solicitudes no TCP no serán afectadas por la configuración EXTPGVS ON.

Use el comando QUERY EXTERNAL para ver las estadísticas generales de SOCKET para una partición por lotes específica, así

como el uso en un entorno de múltiples pilas. Las estadísticas se

restablecen al comienzo de un nuevo paso de trabajo.

DIAGNOSE GETVIS

Muestra los usos de mayor constancia del sistema GETVIS

cuando se emite en la partición TCP/IP.

QUERY EXTERNAL

Muestra estadísticas de particiones de aplicaciones de socket externas.

176

Capítulo 3 Descripción de Comandos: FIREWALL

FIREWALL

El comando FIREWALL controla y monitorea la característica

opcional de Firewall Shield.

Sintaxis

Argumentos

Para obtener información sobre esta característica, consulte la

Guía de Características Opcionales de TCP/IP FOR VSE.

La sintaxis es

FIREWALL {ON|OFF|LOAD [PHASE=phase-name]|WARN|FAIL|

MSGON|MSGOFF|DEBUGON|DEBUGOFF|REPORT|ALLOWED|

BLOCKED}

ON Es la configuración predeterminada si el parámetro FIREWALL= se usa

en la instrucción EXEC IPNET y una fase de configuración del firewall se carga con éxito durante el inicio de TCP/IP. Si el firewall no está

encendido inicialmente, o se apaga con el comando FIREWALL OFF, se

puede emitir FIREWALL ON para activar o reactivar el firewall.

OFF Desactiva la función de Firewall Shield.

LOAD PHASE=phase-name Activa una nueva configuración de firewall. Esto significa que se cargará y activará una nueva fase de configuración del firewall. El

nombre de fase predeterminado es FIREWALL, pero la palabra clave

PHASE= se puede usar para cargar una fase de configuración diferente.

WARN Establece el firewall en modo de advertencia. Las violaciones de

firewall se muestran y registran, pero se permite un intento de acceso

cuando este modo está activo.

Cuando está en modo de advertencia, la verificación inicial de una

dirección IP que no coincide con un rango puede pasar a la siguiente capa. Los puertos TCP, los puertos UDP y el ICMP también se

verifican, y esas verificaciones pueden mostrar mensajes bloqueados

adicionales en las capas más profundas para el protocolo correspondiente.

FAIL Establece el firewall en modo de falla. Las violaciones de firewall

se muestran y registran, y cada datagrama asociado se descarta inmediatamente.

MSGON Muestra todos los intentos bloqueados en la consola y SYSLST.

177

Capítulo 3 Descripción de Comandos: FIREWALL

MSGOFF Muestra la primera aparición de intentos bloqueados en la consola y SYSLST, pero no se muestran los bloques posteriores. Se mantiene

un contador y se puede usar FIREWALL REPORT para ver el

número de bloques para cualquier dirección IP y puerto específicos.

DEBUGON Activa el modo de depuración y se crean volcados de diagnóstico durante el procesamiento del firewall.

Precausion:

FIREWALL DEBUGON puede enviar rápidamente muchos

volcados a SYSLST en la partición TCP/IP. Utilice esta configuración solo bajo la dirección del Soporte Técnico.

DEBUGOFF Desactiva el modo de depuración y no se realizarán volcados de diagnóstico.

REPORT Muestra las direcciones IP permitidas y las direcciones IP que

fueron permitidas, pero luego bloqueadas por TCPPORTS, UDPPORTS o ICMP.

ALLOWED Muestra una lista de direcciones IP permitidas y la cantidad de veces

que se permitió cada una.

BLOCKED Muestra una lista de direcciones IP que fueron bloqueadas porque no

están en la tabla de firewall.


IPSTAT

Controla si se asigna un ISBLOK para cada dirección IP que

accede a la pila.

QUERY FIREWALL

Muestra la configuración actual del firewall que se aplica.

QUERY IPSTAT

Muestra estadísticas de direcciones IP almacenadas en ISBLOK.

178

Capítulo 3 Descripción de Comandos: FLUSH

FLUSH

Sintaxis

Argumentos

Ejemplo

Notas


El comando FLUSH hace que TCP/IP FOR VSE elimine todos los datos

y termine todas las conexiones con la dirección IP especificada.

FLUSH ip4addr [,port]

ip4addr

La dirección de red (IP) que se vaciará.

port Si se especifica, el número de puerto remoto restringe la operación del

comando FLUSH a conexiones y datos relacionados con el puerto. Si no se especifica ningún número de puerto, todas las conexiones y datos

asociados con la dirección IP se vacían.

El comando FLUSH es útil para terminar sesiones TN3270 “huérfanas”.

También se puede usar para limpiar sesiones FTP que están bloqueadas.

QUERY CONNECTIONS


QUERY TELNETDS

Muestra daemons TN3270 y TN3270E.

flush 100.100.1.1 IPN500I All TCP/IP processing stopped IPN357I Traffic has been flushed for IP: 100.100.1.1 Port: 0 IPN499I TCP/IP processing started

179

Capítulo 3 Descripción de Comandos: FTPBATCH_FETCH

FTPBATCH_FETCH

TCP/IP FOR VSE proporciona dos clientes FTP por lotes. Uno, solicitado

usando EXEC FTPBATCH, proporciona su propio daemon FTP interno y

usa la partición TCP/IP solo para la transmisión de datos. El otro cliente, EXEC FTP, es solo un cliente y se basa en un daemon FTP que se ejecuta

en la partición TCP/IP.

Sintaxis

Argumentos

Este comando le permite forzar una solicitud de FTPBATCH,

independientemente del programa ejecutado.

FTPBatch_fetch {ON|OFF}

ON Cuando se ejecuta el programa por lotes “FTP”, el programa

FTPBATCH se buscará y ejecutará en su lugar.

OFF La ejecución por lotes de “FTP” ejecutará el cliente FTP por lotes.

Ejemplo

Notas



El cliente “FTP” por lotes lee las tarjetas de control y pasa los

comandos al cliente FTP interno TCP/IP FOR VSE. Esto significa que

todo el procesamiento de I/O/de disco/cinta y FTP se produce en la partición de la pila.

FTPBATCH es autónomo y se ejecuta en una partición por lotes separada.

Utiliza la partición de pila solo para procesar solicitudes de socket.

QUERY OPTIONS


ftpbatch_fetch on IPN249I Value for FTPBATCH Fetch set to on

180

Capítulo 3 Descripción de Comandos: GATEWAY

GATEWAY

Sintaxis

Argumentos

El comando GATEWAY controla si TCP/IP FOR VSE reenvía las

transmisiones entre redes.

GATEway {ON|OFF}

ON Los datagramas no dirigidos a la pila se pasan a través de la tabla de

enrutamiento y se envían a través del enlace apropiado.

OFF Los datagramas no dirigidos a la pila o pilas conectadas directamente

se descartan. Este es el valor predeterminado y recomendado.

Ejemplo

Notas


Las siguients notas aplican a este comando:

Independientemente de la configuración de GATEWAY, la pila siempre

reenvía datagramas a cualquier pila identificada por DEFINE ALTIP.

El uso de TCP/IP FOR VSE como enrutador no es un uso rentable de la CPU si hay otras rutas disponibles. Utilice el soporte de puerta de

enlace para redirigir el tráfico a otras particiones o LPARS que no

tienen su propio acceso directo a la red.

La mayoría del tráfico IP "enrutado" es causado por un problema con la

tabla de enrutamiento de un enrutador externo. Si el tráfico no deseado llega a VSE, esta situación debe investigarse y corregirse.

Vea la Guía de Instalación de TCP/IP FOR VSE para obtener

información sobre el uso de GATEWAY ON junto con la definición de múltiples pilas TCP/IP FOR VSE que comparten un adaptador de red.

DEFINE ADAPTER


DEFINE ALTIP

Hace que la pila monitoree y responda a las solicitudes ARP de direcciones de inicio adicionales.

DEFINE LINK Crea un enlace entre TCP/IP FOR VSE y una red o una pila conectada

directamente.

gateway off IPN268I GATEWAY now set to OFF

181

Capítulo 3 Descripción de Comandos: GATEWAY

DEFINE ROUTE


QUERY HOME

Muestra todas las direcciones IP en la tabla “Home Addres”.

QUERY STATISTICS


QUERY OPTIONS


182

Capítulo 3 Descripción de Comandos: IBBLOK

IBBLOK

Sintaxis

Argumentos

Este comando le permite monitorear y controlar el uso de Bloques de

Bufferr de Internet (IBBLOK)

IBBLok [{RELEase|RESET|CLear}]

[,{SIZE=num|,MTU=num}] [,FREE=num]

[,STORage=num|PERcent=percent]

(Null Arguments) Si no se especifican argumentos, se muestran los valores y

estadísticas actuales.

RELEase Causa que todos los IBBLOK que no están en uso sean liberados.

RESET Causa que las estadísticas sobre el uso de IBBLOK se restablezcan.

CLear

Hace que se borren las configuraciones de IBBLOK previamente realizadas.

SIZE= Mutuamente exclusivo con MTU=. Esto se utiliza para seleccionar un

IBBLOK de tamaño específico para que se haga referencia con el

parámetro FREE=.

MTU= Mutuamente exclusivo con SIZE=. Esto se usa para seleccionar un

IBBLOK de tamaño específico por el tamaño de MTU de los datos que

puede contener, para que se haga referencia con el parámetro FREE=.

FREE= Utilizado junto con el parámetro SIZE= o MTU=, FREE especifica el

número máximo de IBBLOK de un tamaño particular que se conservará

cuando esté vacío. Cualquier IBBLOK vacío que exceda este valor se liberará automáticamente. Los valores pueden variar de 0 a 1000.

Tenga en cuenta que los IBBLOK se dimensionan en incrementos de 128

bytes.

STORage= Mutuamente exclusivo con PERCENT=, este parámetro le permite establecer un valor de tamaño máximo para IBBLOK. Tenga cuidado

de no sub-especificar este valor porque la falta de disponibilidad de

IBBLOK causará fallas en la conexión. Los valores pueden variar de 20 a 1,000,000.

PERcent= Mutuamente exclusivo con STORAGE=, este parámetro le permite

especificar el porcentaje de partición GETVIS de 31 bits que se permitirá

para la asignación de IBBLOK. Los valores pueden variar de 5 a 100.

183

Capítulo 3 Descripción de Comandos: IBBLOK

Ejemplo


Consulte el comando QUERY IBBLOKS para obtener una explicación

de los campos del mensaje en este ejemplo.

QUERY IBBLOKS

Muestra la configuración y las estadísticas de IBBLOK.

QUERY STOR

Muestra información detallada sobre el uso de la memoria.

ibblok IPN253I << TCP/IP IBBLOK Activity >> IPN896I Counts - Current: 47 Peak: 86 Failed: 0 IPN897I Space - Current: 36k Peak: 109k Max: 51,092k (127%) IPN889I Size: 384 MTU: 64 Free: 24/50 Hits: 4,465 Misses: 24 IPN889I Size: 512 MTU: 192 Free: 4/20 Hits: 569 Misses: 4 IPN889I Size: 640 MTU: 320 Free: 2/20 Hits: 54 Misses: 2 IPN889I Size: 768 MTU: 448 Free: 1/20 Hits: 24 Misses: 1 IPN889I Size: 896 MTU: 576 Free: 1/20 Hits: 12 Misses: 1 IPN889I Size: 1,024 MTU: 704 Free: 2/20 Hits: 20 Misses: 2 IPN889I Size: 1,152 MTU: 832 Free: 1/20 Hits: 32 Misses: 1

IPN889I Size: 1,280 MTU: 960 Free: 3/20 Hits: 32 Misses: 3 IPN889I Size: 1,408 MTU: 1,088 Free: 1/20 Hits: 31 Misses: 1 IPN889I Size: 1,536 MTU: 1,216 Free: 1/20 Hits: 32 Misses: 1 IPN889I Size: 1,664 MTU: 1,344 Free: 1/20 Hits: 7 Misses: 1

IPN889I Size: 1,792 MTU: 1,472 Free: 1/20 Hits: 1 Misses: 1 IPN889I Size: 1,920 MTU: 1,600 Free: 5/5 Hits: 2,892 Misses: 2,679 IPN889I Size: 64K+ MTU: -- Free: 0/0 Hits: 0 Misses: 0

184

Capítulo 3 Descripción de Comandos: INCLUDE

INCLUDE

Sintaxis

Argumentos

Ejemplo

Notas


El comando INCLUDE ordena a TCP/IP FOR VSE que busque un

miembro de una librería VSE y ejecute los contenidos como si

estuvieran incluidos en el miembro de inicialización.

INCLude member [,DELAY]

member

Especifica el nombre del miembro que contiene los comandos que

se ejecutarán. La librería y la sub-librería son las mismas que contienen el miembro de inicialización. Se agrega un tipo de

miembro de “.L” al nombre. El miembro normalmente se procesa

antes del comando que sigue a INCLUDE.

DELAY Especifica que el contenido del miembro no se ejecutará hasta que se

complete la inicialización de TCP/IP FOR VSE y se esté ejecutando el motor de despacho.


Puede ser conveniente mantener conjuntos de comandos similares

(como los comandos DEFINE USER) en miembros separados y

luego ejecutarlos con el comando INCLUDE.

El comando INCLUDE funciona como el comando EXECUTE.

Cuando se encuentra una instrucción INCLUDE en un miembro, el

procesamiento de ese miembro se suspende hasta que el miembro

incluido se haya procesado (a menos que se especifique DELAY).

Durante la inicialización de TCP/IP FOR VSE, todos los comandos

de configuración se leen y procesan antes de que se active el motor de despacho. El uso del parámetro DELAY le permite proporcionar

comandos (como PING) que se retrasan hasta que se completa la

inicialización y el motor se ha activado.

EXECUTE


include newroute IPN397I Loading command deck NEWROUTE IPN398I Command deck NEWROUTE has been completely loaded IPN179I Direct Route 192.169.8.7= Net: 43272 Subnet: 0 Host: 7 IPN179I Direct Route 192.169.8.9= Net: 43272 Subnet: 0 Host: 9

185

Capítulo 3 Descripción de Comandos: IPSTAT

IPSTAT

El comando IPSTAT controla si se asigna un ISBLOK para cada

dirección IP que accede a la pila. Cada ISBLOK mantiene estadísticas

para una dirección IP.

Sintaxis

Argumentos

La función Firewall Shield utiliza campos en el ISBLOK, por lo que, si se está utilizando el firewall, IPSTAT no se puede desactivar. vea capítulo 5,

“Protección del Firewall”, en la Guía de Funciones Opcionales de

TCP/IP FOR VSE para obtener más información sobre esta función.

IPSTAT {ON|OFF}

ON Permite la asignación de ISBLOK. Este es el valor predeterminado.

OFF Inhabilita la asignación de ISBLOK. Esta configuración no tiene

efecto a menos que el firewall haya sido deshabilitado por el

comando FIREWALL OFF.

Ejemplo

Notas


Este comando es útil al probar la función Firewall Shield..

La configuración OFF afecta las estadísticas de la dirección IP reportada

por el comando QUERY IPSTAT.

QUERY IPSTAT

Muestra estadísticas de la dirección IP.

FIREWALL

Controla y monitorea la característica opcional de Firewall Shield.

ipstat on IPN268I IPSTAT now set to ON

186

Capítulo 3 Descripción de Comandos: ISOLATION

ISOLATION

Sintaxis

Argumentos

El comando ISOLATION evita que los hosts remotos establezcan

conexiones con daemons TCP/IP FOR VSE o aplicaciones.

ISOLAtion {ON|OFF}

ON Esta configuración evita todas las solicitudes de conexión entrantes.

Las solicitudes de salida continúan funcionando.

OFF Esta configuración permite que se realicen solicitudes de conexión entrantes.

Ejemplo

Notas


Esta característica es útil sólo cuando no desea absolutamente ningún

acceso remoto a su sistema.

QUERY OPTIONS


isolation on IPN268I ISOLATION now set to ON

187

Capítulo 3 Descripción de Comandos: LISTIDCAMS

LISTIDCAMS

Sintaxis

Argumentos

El comando LISTIDCAMS se usa con VSAMCAT. Controla si los

resultados de las operaciones DELETE/DEFINE CLUSTER de una

llamada IDCAMS se envían a SYSLST.

LISTIDCAMS {ON|OFF}

ON Los resultados DELETE/DEFINE CLUSTER se envían a SYSLST. Este es el valor predeterminado.

OFF Los resultados no se envían a SYSLST.

Exposición

Ejemplo

El controlador VSAMCAT llama a IDCAMS para definir un "clúster"

(definición de miembro) antes de que pueda escribir en él. También llama a IDCAMS para eliminar un miembro VSAMCAT de un catálogo. Por

defecto, cuando se ejecuta como un trabajo por lotes, IDCAMS envía su

salida a SYSLST para que pueda verificarlo en caso de que haya algún problema. Sin embargo, cuando otro programa llama a IDCAMS, puede

elegir NO enviar a SYSLST. Por lo general, es bueno enviar al SYSLST

del TCP/IP en caso de que haya algún problema que deba corregirse. Pero si esto no es una preocupación, entonces la salida a SYSLST se puede

desactivar configurando LISTIDCAMS en OFF.

LISTIDCAMS OFF IPN268I LISTIDCAMS now set to Off

188

Capítulo 3 Descripción de Comandos: LOCAL_DLBL

LOCAL_DLBL

El comando LOCAL_DLBL controla si los usuarios remotos de FTP

pueden especificar archivos VSE utilizando un DLBL local. Los

archivos que se especifican utilizando un carácter de porcentaje (%) y un DLBL se denominan archivos autónomos. Dichos archivos no están

definidos para TCP/IP FOR VSE y no tienen un nombre público.

Este comando controla el acceso a archivos autónomos para todos los

servidores FTP internos (daemons) creados con DEFINE FTPD. No afecta el funcionamiento de los servidores externos que se

configuraron mediante FTPBATCH.

Nota: Este comando es compatible con versiones anteriores. El

parámetro DYNFILE= en DEFINE FTPD y FTPBATCH proporciona el mismo control para daemons individuales y debería usarse en su lugar.

Sintaxis

Argumentos

Para obtener detalles sobre la sintaxis utilizada para especificar archivos

autónomos, ve la Guía del Usuario de TCP/IP FOR VSE, capítulo 2,

“FTP”, subsección “Nombres de Archivos VSE”.

LOCAL_Dlbl {ON | OFF}

ON Los usuarios remotos de FTP pueden omitir el sistema de archivos

TCP/IP FOR VSE y transferir archivos VSE utilizando una sintaxis de archivo autónoma. Este es el valor predeterminado.

OFF Los usuarios remotos de FTP no pueden especificar archivos autónomos

y sólo pueden especificar archivos que se hayan definido en TCP/IP

FOR VSE utilizando DEFINE FILE. Esta configuración anula la configuración predeterminada DYNFILE=YES en DEFINE FTPD.

Ejemplo


DEFINE FILE

Define un archivo para el sistema de archivos TCP/IP FOR VSE.

DEFINE FTPD

Configura un servidor FTP interno (daemon).

QUERY OPTIONS


128 LOCAL_DLBL OFF

F8 0106 IPN268I LOCAL_DLBL now set to OFF

189

Capítulo 3 Descripción de Comandos: MESSAGE (o MSG)

MESSAGE (or MSG)

El comando MENSAJE le permite suprimir el tráfico de la consola

por número de mensaje.

Sintaxis

Nota: MSG es sinónimo de MENSAJE en TCP/IP FOR VSE. No

confunda este comando con el comando “MSG partition-id” de IBM.

MESsage MSGID=msgid [Console={Yes|No}] [Log={Yes|No}]

[SCROLlable={Yes|No}]

Argumentos

MSGid= Identifica el mensaje cuyas características de visualización deben

modificarse. El identificador del mensaje se especifica sin el

indicador de importancia final.

Console= Controla la visualización de mensajes en la consola.

Yes El mensaje se mostrará en la consola.

No El mensaje no se mostrará en la consola.

Log= Controla la grabación de mensajes en los registros impresos.

Yes El mensaje se imprimirá en el registro.

No El mensaje no se imprimirá en el registro.

SCROLlable= Controla si un mensaje se muestra en modo desplazable en la

consola.

Yes El mensaje será desplazable.

No El mensaje no será desplazable. Tenga mucho cuidado porque

los mensajes no desplazables deben eliminarse manualmente.

Una vez que la pantalla de la consola se llena con mensajes no desplazables, el procesamiento cesará hasta que se eliminen.

190

Capítulo 3 Descripción de Comandos: MESSAGE (o MSG)

Ejemplo

Notas



Tenga cuidado al suprimir mensajes. Asegúrese de que no desea ver el mensaje antes de suprimir.

Si tiene un producto de automatización de consola, es posible que desee

especificar criterios de supresión de mensajes utilizando esa función para

que toda la supresión de mensajes se origine en el mismo lugar.

DEFINE LOG

Crea un archivo de registro del sistema.

MODIFY LOG Cambia las características de un archivo de registro del sistema.

message msgid=tel936,console=no IPN801I Message suppression updated for TEL936 message msgid=tel936,console=yes IPN801I Message suppression updated for TEL936

191

Capítulo 3 Descripción de Comandos: MODIFY CONSOLE

MODIFY CONSOLE

Sintaxis

Argumentos

Este comando le permite controlar cómo se muestran los mensajes en la

consola del operador. Es un atajo para MODIFY LOG,ID=CONSOLE.

MODify CONsole [,LINELength=num]


LINELength= Este valor indica la longitud máxima de línea que se escribirá. Cuando

una línea excede esta longitud, se divide en blanco y se agrega un

carácter de continuación (>). Los valores válidos son de 40 a 132.

TIMEstamp= Valores válidos: Izquierda, Derecha, Ninguno. Este valor controla

dónde se colocan la fecha y la marca de tiempo en cada línea.

routes Los valores opcionales indican niveles de mensajes que se agregan o

restan de la lista de tipos que se registrarán. Tenga en cuenta que la

lista se procesa de izquierda a derecha, por lo que especificar "ALL NODIAG" garantiza que todo menos los mensajes de diagnóstico se

escriban en este registro.





[NO]INFOrmational Los mensajes informativos generales se registran/suprimen.



se registran/suprimen. Tenga en cuenta que estos mensajes

pueden ser voluminosos y rápidos.


ALL Todos los tipos de mensajes están registrados.

192

Capítulo 3 Descripción de Comandos: MODIFY CONSOLE

Ejemplo

Notas


NONE No se registrarán mensajes..

Tenga cuidado que todos los mensajes se graben en alguna parte. De lo

contrario, cuando ocurre un problema, puede ser difícil obtener la información de diagnóstico necesaria.

DEFINE LOG


MESSAGE


MODIFY LOG


MODIFY CONSOLE es un atajo para MODIFY LOG, ID=CONSOLE.

QUERY LOGS

Muestra las consolas y los registros disponibles junto con sus propiedades.

modify console,none,resp,security query logs IPN253I << TCP/IP Console Logs >> IPT240I CONSOLE on CONSOLE IPT241I Line Length: 65 Lines per page: 0 Timestamp: None IPT242I Total lines: 0 Total pages: 0 IPT243I Logging: Response Security

193

Capítulo 3 Descripción de Comandos: MODIFY FILE

MODIFY FILE

Sintaxis

Argumentos

El comando MODIFY FILE cambia las características de una entrada

previamente definida en el sistema de archivos.

MODify FILE PUBlic=pubname

[,TYPe={ESDS|KSDS|SAM|LIBrary|ICCF|POWer|

VSAMCAT|VTOC|HFS|DSPACE|BIM-EDIT|CONDOR|FALCON|

VOLLIE|TAPE}] [,DLBL=name8] [,DRIVer=member]

[,ALLOWsite={Yes|No} [,READonly={Yes|No}]

[,CC={Yes|No}] [,TRcc={YES|NO}]

[,CRlf={Yes|No}] [,RECFm=F|FB|V|VB|S|SV|SU|SB]

[,LRECL=num] [,BLKsize=num] [,GID=snum]

[,UID=snum] [,TRANslate=name16]

[,SITE={Yes|No}] [,DBLOCKS=num] [,EXT=name8]

[VOLid=volser] [,CIPHER={NULL-SHA1|

SDESCBC-NULL|SDESCBC-SHA1|TDESCBC-NULL|

TDESCBC-SHA1|AES128C-NULL|AES128C-SHA1|

AES192C-NULL|AES192C-SHA1|AES256C-NULL|

AES256C-SHA1| KEYMASTER}][,CIPHERKEY=CIALHFSK]

Los parámetros especificables siguen de cerca los de DEFINE FILE. En

todos los casos, si se omite un parámetro, el valor no se modifica.

TYPE= Especifica el tipo de conjunto de datos.

ESDS Un conjunto de datos VSAM ESDS. Las solicitudes de lectura

FTP dan como resultado la transmisión del archivo completo.

KSDS Un conjunto de datos VSAM KSDS. Las solicitudes de lectura FTP

dan como resultado la transmisión del archivo completo. Las solicitudes de escritura son procesadas como operaciones VSAM

INSERT.

SAM Un conjunto de datos del Método de Acceso Secuencial.

LIBrary Una librería VSE. Realizar una lista de directorio en el nombre

público devuelve una lista de las sub-librerías. La calificación

adicional del nombre público con un nombre de sub-librería (como public.name.sublib) devuelve una lista de los miembros.

Las solicitudes de lectura FTP recuperan el contenido de un

miembro. Las solicitudes de escritura crean o reemplazan el contenido de un miembro.

194


ICCF

Una estructura de librería ICCF. El listado del directorio no es

compatible. Para recuperar datos, use un nombre completo que consista en el nombre público, el número de la librería y el

nombre del miembro (como pubname.num.member). Escribir

en una librería ICCF no es compatible.

Tenga en cuenta que para acceder a una librería ICCF utilizando FTP, su ID de usuario y contraseña de FTP deben ser

idénticos a su ID de usuario y contraseña de ICCF.

POWer Una fila POWER. Para recuperar información de POWER, especifique el

nombre público calificado con LST, RDR o PUN, seguido de la clase y luego por el nombre del trabajo. También se pueden agregar dos

calificadores adicionales, número de trabajo y sufijo de trabajo, según sea

necesario. Escribir en POWER crea un archivo en la filaa especificada.

VSAMCAT Un catálogo VSAM. Una lista de directorio devuelve los nombres de

todos los archivos en ese catálogo. Las operaciones admitidas incluyen

lectura, escritura, creación, eliminación, cambio de nombre y anexos. Se

proporciona una lista completa de las operaciones compatibles en la Guía del Usuario de TCP/IP FOR VSE en el capítulo "FTP".

VTOC Un volumen completo de VSE. Puede realizar operaciones

limitadas en un archivo definido con TYPE=VTOC. La Guía de Instalación de TCP/IP FOR VSE contiene una lista de operaciones

compatibles con TYPE=VTOC.

HFS Sistema de archivos jerárquicos de CSI International. Este tipo de

archivo admite un sistema de archivos de tipo PC o Linux con

múltiples niveles de subdirectorio y nombres largos de archivo.

DSPACE Hace que un espacio de datos se asigne y se use como un archivo. Vea

la Guía de Instalación de TCP/IP FOR VSE para más información.

BIM-EDIT Producto BIM-EDIT de CSI International. Este tipo requiere una licencia

BIM-EDIT, y debe vincular el archivo .OBJ para que el módulo del

controlador de I/O sea utilizable. Debe usar DEFINE FILEIO para cargar el módulo del controlador de I/O BIM-EDIT en el almacenamiento.

CONDOR, FALCON, VOLLIE Tipos de archivos asociados con productos que no son CSI. Para cada

tipo, debe obtener un módulo de controlador de I/O proporcionado por el proveedor y luego instalarlo. Vea “Ejemplo de Archivo CA

Vollie™,” en la página 64 para más información.

195


TAPE Un archivo de unidad de cinta. Debe usar DEFINE FILEIO para

cargar el módulo del controlador I/O asociado en el almacenamiento.

DLBL= Un nombre DLBL. Esto especifica la instrucción DLBL que se utilizará

para abrir el archivo. Debe ser accesible para la partición TCP/IP FOR VSE. Los archivos de tipo “POWER” no requieren ni usan un DLBL.

DRIVer= Si se especifica, esta fase se carga desde la lista de búsqueda de la librería

cuando se inicializa el controlador del conjunto de datos. En general, debe dejar

que este valor sea predeterminado a la fase proporcionada para el tipo de archivo. Si QUERY FILEIO no incluye la fase que necesita, debe usar DEFINE

FILEIO para cargar la fase antes de poder especificarla en DEFINE FILE.

PUBlic= El nombre único que identifica este conjunto de datos para los usuarios.

Este es el nombre asignado al archivo por el comando DEFINE FILE.

READonly= Esta configuración se puede utilizar para limitar selectivamente el acceso FTP a este archivo.

No Los usuarios de FTP pueden escribir y actualizar este archivo, sujeto

a otros procedimientos de seguridad.

Yes Los usuarios NO tienen acceso de escritura o actualización a este

archivo, independientemente de otros procedimientos de seguridad.

ALLOWsite= Los comandos FTP SITE que son específicos de un tipo de archivo

(por ejemplo, SITE PALTER) se pasan al controlador de I/O del archivo al que se está accediendo actualmente. Codificar NO en este

parámetro anula lo que pueda especificarse en la definición FTPD y

puede usarse para evitar que se emitan comandos no autorizados.

No Los usuarios de FTP no pueden pasar comandos SITE al controlador de I/O de archivo asociado con este archivo.

Yes Los usuarios de FTP pueden pasar comandos SITE al controlador

de I/O de archivo asociado con este archivo.

EXT= Para TYPE=VSAMCAT, especifica un sufijo que se agregará al

nombre del archivo. Por ejemplo, EXT=.TXT garantizaría que todas

las referencias a los archivos en el catálogo se supongan como “texto.”

196


CC= Proporciona un valor predeterminado para el comando FTP SITE

CC. Si no se especifica, el valor lo proporciona el cliente o usuario.

Nota: Esta configuración se puede anular. Vea la nota en la sección

“RECFM, LRECL, BLKSIZE” a continuación para más información.

Yes Se asume que el primer byte de cada registro es un byte de

control de carro, y este byte se retiene como parte de los datos.

No Durante las descargas (desde VSE), se descarta el primer byte

de cada registro. Durante las cargas (a VSE), se antepone un carácter en blanco a cada registro.

TRcc= Proporciona un valor predeterminado para el comando FTP SITE

TRCC. Si no se especifica, el valor lo proporciona el cliente o usuario.

Nota: Esta configuración se puede anular. Vea la nota en la sección “RECFM, LRECL, BLKSIZE” a continuación para más información.

No No se realiza ningún procesamiento especial para simular el control del carro.

Yes Los códigos de control de carro ANSI (+, 0, -, 1) provocan la simulación del carácter CC. Los caracteres de control de formularios

(CR, LF, FF) se agregan a los registros de salida.

CRlf= Proporciona un valor predeterminado para el procesamiento

delimitador de registro CRLF. Si no se especifica, el valor lo

proporciona el cliente o usuario.



Yes Cada registro cargado en VSE debe finalizar con un delimitador apropiado, generalmente CR/LF. En la descarga, se agrega el

delimitador apropiado a cada registro.

No No se agregan delimitadores en la descarga y no se esperan delimitadores en la carga. Para los registros entrantes, el flujo de

datos se divide en función del valor LRECL.

197


RECFm= Provee un valor predeterminado para el comando FTP SITE RECFM.

Especifique un formato de registro de F, FB, V, VB o S. El formato de

cadena es válido solo con los archivos de la Liblioteca. Esta configuración NO anula el valor especificado en la definición de DLBL.

Si el valor no se especifica en DLBL o DEFINE FILE, entonces se

puede suministrar utilizando un comando SITE.



LRECL= Provee un valor predeterminado para el comando FTP SITE LRECL.

Este valor es la longitud del registro lógico. Es un valor numérico y

debe ser coherente con el valor utilizado cuando se creó el archivo. El valor predeterminado es 80. Consulte las siguientes tablas para obtener

información sobre la selección.

Este valor no se obtiene de la información DLBL y debe proporcionarse,

ya sea por DEFINE FILE o con un comando FTP SITE.



BLKsize= Provee un valor predeterminado para el comando FTP SITE BLKSIZE.

Este valor es el tamaño de bloque utilizado en el conjunto de datos.

Esta información debe ser coherente con el valor utilizado cuando

se creó el archivo. No hay defecto. Consulte las siguientes tablas

para obtener información sobre la selección. Este valor no se obtiene de la información DLBL y debe

proporcionarse, ya sea por DEFINE FILE o con un comando FTP

SITE.

Nota: Esta configuración se puede anular. Vea la nota en la sección “RECFM, LRECL, BLKSIZE” a continuación para más información.

TRANslate= Proporciona un valor predeterminado para el comando FTP SITE TRANSLATE cuando el archivo debe traducirse entre los modos

ASCII y EBCDIC. Si se omite, el valor predeterminado es la tabla de

traducción predeterminada de TCP/IP FOR VSE.

Para que sea válida, la tabla de traducción nombrada debe estar cargada en el momento en que se abre el archivo, en lugar de cuando

se emite DEFINE FILE.

El comando DEFINE TRANSLATION explica la definición y carga

de las tablas de traducción.

198


SITE= Los comandos SITE se procesan jerárquicamente. El daemon FTP maneja la mayoría de los comandos por sí mismo. Cualquier comando

que el daemon no entienda se pasa al controlador de I/O del archivo

seleccionado, según lo determine el último comando de CD emitido.

No Los comandos FTP SITE que no son reconocidos por el daemon FTP no se pasan a la rutina del controlador específico del archivo.

Yes Los comandos FTP SITE que no son reconocidos por el daemon

FTP se pasan a la rutina del controlador de I/P para su posible

procesamiento.

GID=

Numérico firmado, de -9999999 a +9999999.

Define este archivo como parte de un grupo. TCP/IP FOR VSE no

utiliza este campo, sino que lo pasa a la salida de seguridad TCP/IP

FOR VSE. También se puede asignar un valor GID con DEFINE USER.

UID=

Numérico firmado, de -9999999 a +9999999.

Asocia este archivo con una ID de usuario de estilo UNIX. TCP/IP

FOR VSE pasa este campo a la salida de seguridad TCP/IP FOR

VSE. También se puede asignar un valor UID con DEFINE USER.

DBLOCKS= Para TYPE=DSPACE, especifica el espacio que se asignará al

archivo virtual.

VOLid= Para TYPE=VTOC, especifica la ID de volumen del disco.

CIPHER= Para TYPE=HFS, indica que los archivos deben almacenarse en

forma cifrada utilizando el método especificado. Si se omite este

parámetro, no se realiza el cifrado o descifrado.

CIPHERKEY= Para los archivos cifrados TYPE=HFS, esta palabra clave proporciona

el nombre de la fase que contiene información sobre las claves de

cifrado. La fase predeterminada se envía con TCP/IP y contiene claves

de muestra. Debe crear su propia fase con sus propias claves antes de usar esta función en un entorno de producción. Vea la Guía del

Programador TCP/IP FOR VSE para más información.

199


Ejemplo

RECFM, LRECL, BLKSIZE

Consideraciones de Archivos de Discro Secuencial y Archivos SAM Administrados por VSAM

Los valores aceptables para RECFM, LRECL y BLKSIZE dependen de cómo

definió originalmente el archivo, el método de acceso que usa y el modo de acceso (lectura o escritura). Cuando los valores aceptables dependen del modo

de acceso, debe especificar qué modo está definiendo. Si especifica un modo y

luego necesita acceder al archivo en el otro modo, su administrador puede emitir un segundo comando DEFINE FILE para darle al archivo un segundo

nombre con características del otro modo. Para suministrar valores que no son

aceptados por el comando DEFINE FILE, use los comandos SITE.

Nota: Si el procesamiento EXTTYPES no está en vigor para el archivo y

SITELAST=YES en FTP, entonces los comandos SITE tienen prioridad sobre

los siguientes parámetros DEFINE FILE: BLKSIZE, CC, CRLF, LRECL, RECFM, TRCC. Para obtener más información, consulte la Guía de Instalación

de TCP/IP FOR VSE, capítulo 6, "Configuración de Clientes FTP y Daemons".

Las siguientes secciones contienen tablas que muestran valores aceptables

para RECFM, LRECL y BLKSIZE. Los encabezados de "Entrada" indican

que está leyendo desde el disco, y los encabezados de "Salida" indican que está escribiendo en el disco. Estos términos no indican si está utilizando el

cliente FTP o el daemon FTP.

Para archivos de disco secuenciales y archivos SAM administrados por

VSAM, tenga en cuenta lo siguiente:


Cuando se produce relleno, los archivos de texto se rellenan con



puede definir el mismo archivo físico con dos nombres públicos diferentes (para entrada y salida) y asignar diferentes valores LRECL

y BLKSIZE a cada uno.

Aunque los archivos SAM administrados por VSAM de IBM

aparecerán como archivos ESDS al realizar una LISTCAT IDCAMS

del catálogo VSAM, se recomienda que los lea como archivos SAM en lugar de archivos ESDS. Esto se debe a que las rutinas de IBM

que realizan la salida SAM del archivo a menudo no actualizan

correctamente el catálogo después de que se cierra el archivo. Esto

puede resultar en transferencias incompletas cuando se usan ciertos clientes FTP gráficos.

RECFM SU se interpreta como un archivo no bloqueado extendido.

RECFM SU se interpreta como un archivo bloqueado extendido.

modify file public=ijsysrs,readonly=yes IPN163I Adjusted Dataset: IJSYSRS

200


La siguiente tabla muestra los valores apropiados para este tipo de archivo

RECFM

Entrada

LRECL

Entrada BLKSIZE

Salida LRECL

Salida

BLKSIZE

F Tamaño del Registro

N/A Tamaño del Registro +8

N/A

FB Tamaño del

Registro

Tamaño del

Registro por el Factor

Bloqueo

Tamaño del

Registro

(Tamano de

Registro por el Factor

Bloqueo)+8

V Tamaño del

Registro

Máximo

N/A Tamaño del

Registro

Máximo +8

N/A

VB Tamaño del

Registro

Máximo

Tamaño de

Bloqueo

Máximo

Tamaño del

Registro

Máximo

Tamaño de

Bloqueo

Máximo +8

SU Maximum

record size

N/A Tamaño del

Registro Máximo +8

N/A

SB Tamaño del

Registro

Máximo

Tamaño de

Bloqueo

Máximo

Tamaño del

Registro

Máximo

Tamaño de

Bloqueo

Máximo +8

Consideraciones a Archivos VSAMCAT

Para los archivos VSAMCAT, tenga en cuenta la siguiente información.

Para los archivos de salida, si el archivo aún no existe, el comando

SITE establecerá los valores de los parámetros utilizados en el

comando DEFINE CLUSTER que se pasará como una subtarea a la utilidad IBM IDCAMS antes de escribir en el archivo.

Si el archivo de salida ya existe, se ignorarán los comandos SITE y

no se invocará la utilidad IDCAMS. Esto significa que los comandos

SITE que usa deben coincidir con los atributos esperados.

Para los archivos de entrada, sus comandos SITE no necesitan coincidir con los atributos del archivo existente. Esto es cierto para todos los tipos

de archivos VSAM.

Los registros de longitud fija se rellenan si es necesario al escribir en el spool VSE/POWER. Cuando se produce relleno, los archivos de texto se rellenan

con espacios en blanco y los archivos binarios se rellenan con ceros binarios.

Si utiliza el tipo “bloqueado” (VB o FB) para la salida, entonces el

parámetro “(nnnn)” del comando DEFINE CLUSTER RECFM

201


se proporcionará a la utilidad IDCAMS, donde nnnn es la longitud

del registro. De lo contrario, utilice el formato de registro "F" o "V".


Entrada Salida


F Tamaño de Resgistro N/A N/A1 N/A

1

V Tamaño Máximo de Registro N/A N/A1 N/A

1

1 Depende de si existe el archivo de salida. Los parámetros del comando SITE

se pasan a la utilidad IDCAMS solo después de la creación del archivo.

Consideraciones a Archivos TAPE

Para archivos TAPE, tenga en cuenta la siguiente información:

Los registros de longitud fija se rellenan cuando es necesario. Cuando

se produce relleno, los archivos de cinta se rellenan con espacios en

blanco y los archivos binarios se rellenan con ceros.


puede definir el mismo archivo físico con dos nombres públicos

diferentes (para entrada y salida) y asignar diferentes valores LRECL y BLKSIZE a cada uno.

La siguiente tabla muestra los valores apropiados para los archivos TAPE.

Entrada Salida


F Tamaño de

Registro

N/A Tamaño de

Registro +8

N/A

FB Tamaño de

Registro

Tamaño de

Registro por

Factor Bloque

Tamaño de

Registro

(Tamaño de

Registro por

Factor Bloque)

+8

V Máximo

Tamaño de Registro

N/A Máximo

Tamaño de Registro +8

N/A

VB Máximo

Tamaño de Registro

Tamaño

de Bloque Máximo

Máximo

Tamaño de Registro

Tamaño de

Bloque Máximo +8

UN Máximo

Tamaño de

Registro

N/A Máximo

Tamaño de

Registro

N/A

202


Consideraciones a Archivos VSE/POWER

Consideraciones a Archivos ESDS, KSDS

Consideraciones a Archivos ICCF

Para los archivos POWER, tenga en cuenta lo siguiente:

Los registros de longitud fija se rellenan si es necesario al escribir en el

spool POWER. Cuando se produce relleno, los archivos de texto se rellenan

con espacios en blanco y los archivos binarios se rellenan con ceros.

El LRECL mínimo para los archivos de fila POWER RDR es 80 y el máximo es 128.

El LRECL mínimo para los archivos de fila POWER LST es 1 y

el máximo es 32766.

Los archivos de fila LRECL para POWER PUN deben ser 80.

La siguiente tabla muestra los valores apropiados para los archivos POWER.

RECFM

Entrada LRECL Entrada BLKSIZE

Salida LRECL

Salida BLKSIZE

F Tamano de Registro N/A N/A N/A

V Máximo Tamano de Registro N/A N/A N/A

Para los archivos VSAM ESDS y KSDS, la siguiente tabla muestra los

valores apropiados:

RECFM

Entrada LRECL Entrada BLKSIZE

Salida LRECL

Salida BLKSIZE


V Máximo Tamaño de Registro N/A N/A N/A

Para archivos ICCF, tenga en cuenta lo siguiente:

Los archivos son solo de lectura.

Los archivos siempre contienen registros de 80 bytes, independientemente de la especificación.

La siguiente tabla muestra los valores apropiados para los archivos ICCF.

RECFM

Entrada LRECL

Entrada BLKSIZE

Salida LRECL

Salida BLKSIZE

F 80 N/A 80 N/A

203


Consideraciones a Archivos Library


Para los archivos Library, tenga en cuenta lo siguiente:

FTP de fases no es compatible.

Los registros en un archivo de cadena consisten en una sola cadena de bytes.

El formato Librarý "SV" es una forma especial de archivo de cadena

definida por CSI International. Se utiliza para cargar miembros HTML en

librerías VSE.

La siguiente tabla muestra los valores apropiados para los archivos de la biblioteca.

RECFM

Entrada LRECL

Entrada BLKSIZE

Salida LRECL

Salida BLKSIZE

F 80 N/A 80 N/A

SV Variable N/A Variable N/A

S N/A N/A N/A N/A

AUTOLOAD

Determina la carga automática de los controladores de I/O de

archivos cuando se definen los archivos.

DEFINE FILE

Define un archivo en el sistema de archivos TCP/IP FOR VSE y lo asocia con un controlador I/O de archivo.

DEFINE FILEIO

Carga una fase de controlador I/O de archivo para un tipo de archivo.

DEFINE TRANSLATION


DELETE FILE


QUERY FILES


QUERY FILEIO


SECURITY


204

Capítulo 3 Descripción de Comandos: MODIFY LOG

MODIFY LOG

Sintaxis

Los mensajes se escriben en la consola y en uno o más archivos de registro.

Este comando le permite cambiar las características de un registro.

MODify LOG ID=id [,LINELength=num]


Argumentos ID= El ID que identifica el registro a modificar. Los valores CONSOLE

y SYSLST se definen automáticamente. Nota: MODIFY CONSOLE

es un acceso directo para MODIFY LOG, ID=CONSOLE.

LINELength= Este valor indica la longitud máxima de línea que se escribirá. Cuando una línea excede esta longitud, se divide en blanco y se agrega un

carácter de continuación (>). Los valores válidos son de 40 a 132.

TIMEstamp= Valores válidos: izquierda, derecha, ninguno. Este valor controla

dónde se colocan la fecha y la marca de tiempo en cada línea.

routes Los valores opcionales indican niveles de mensajes que se agregaron o restaron de la lista de tipos que se registrarán. Tenga en cuenta que la

lista se procesa de izquierda a derecha, por lo que especificar "ALL

NODIAG" garantiza que todo menos los mensajes de diagnóstico se

escriban en este registro.





[NO]INFOrmational Los mensajes informativos generales se registran/suprimen.



se registran/suprimen. Tenga en cuenta que estos mensajes pueden ser voluminosos y rápidos.

205

Capítulo 3 Descripción de Comandos: MODIFY LOG


ALL Todos los tipos de mensajes son registrados.

Ejemplo

Notas


NONE Ningún mensaje en registrado.


Asegúrese de que todos los mensajes estén grabados en alguna

parte. De lo contrario, cuando ocurre un problema, puede ser

difícil obtener la información de diagnóstico necesaria.

El ejemplo anterior muestra cómo suprimir mensajes "sensibles" de SYSLST mientras se establece una pista de auditoría de seguridad en

un archivo separado y protegido.

DEFINE LOG


MESSAGE


MODIFY CONSOLE

Este es un atajjo para el comando MODIFY LOG,ID=CONSOLE.

QUERY LOGS

Muestra las consolas y registros disponibles, junto con sus propiedades.

define log,id=sys007,type=printer,lu=sys007,linel=132 modify log,id=syslst,all,noresp,nosecurity

modify log,id=console,all,nodiag modify log,id=sys007,none,resp,security query logs IPN253I << TCP/IP Console Logs >> IPT240I CONSOLE on CONSOLE IPT241I Line Length: 65 Lines per page: 0 Timestamp: None IPT242I Total lines: 0 Total pages: 0 IPT243I Logging: Critical Vital Warning Important Info Response Secur IPT240I SYSLST on SYSLST IPT241I Line Length: 132 Lines per page: 86 Timestamp: Left IPT242I Total lines: 300 Total pages: 0 IPT243I Logging: Critical Vital Warning Important Info Diag IPT240I SYS007 on SYS007 IPT241I Line Length: 132 Lines per page: 0 Timestamp: None IPT242I Total lines: 44 Total pages: 0 IPT243I Logging: Response Security

206

Capítulo 3 Descripción de Comandos: MODIFY ROUTE

MODIFY ROUTE

Sintaxis

El comando MODIFY ROUTE cambia los valores asignados a una

entrada de ruta ya definida. También puede usar este comando para

cambiar el orden de las entradas de ruta existentes.

MODify ROUTe ID=id [,LINKid=name16] [,NUMber=0]

[,IPaddr=ip4addr] [,GATEway=ip4addr1]

[,AFTer=id] [,MTU=num] [,MSS=num]

[,CRETran=msec] [,DRETran=msec]

[,FIXRetran={Yes|No}] [,MINRetran=msec]

[,MAXRetran=msec] [,PULse=sec] [,WINdow=num]

[,RPAuse=msec] [,RETRY=num]

Argumentos LINKid= Este es el mismo valor que se especifica en el parámetro ID= del comando DEFINE LINK que será el destino para esta entrada de

la tabla de ruta.

NUMber= Para enlaces con adaptadores, esto dirige la ruta al adaptador numerado específico. El valor predeterminado es “0”. Este

parámetro es obligatorio si el parámetro NMBER= del DEFINE ADAPTAER objetivo no es “0”.

IPaddr= Una dirección de red TCP/IP o dirección de "host cero". Todos los

mensajes destinados a esta dirección se envían en el enlace asociado.

GATEway= La dirección de red completa de una puerta de enlace a otras redes.

Una coincidencia en esta entrada de la tabla hace que el paquete de

datos se envíe a la puerta de enlace especificada.

AFTer= El valor del parámetro que identifica la instrucción DEFINE ROUTE

después de la cual se debe mover este. Si se omite este parámetro, la

posición de la entrada de ruta en la tabla no se modifica. Se puede

codificar un valor especial de “TOP” para que la instrucción de ruta se mueva al principio de la lista.

La ubicación en la tabla es muy importante porque el procedimiento de búsqueda es una búsqueda de arriba a abajo por la primera

coincidencia (a excepción de “0.0.0.0", que siempre coincide al final)

207


MTU= El valor de MTU que se utilizará con esta ruta. Este valor es significativo sólo si es menor que el valor especificado por DEFINE

LINE o DEFINE ADAPTER de destino. Normalmente, este

parámetro sólo controla el tamaño de los datagramas salientes.

MSS= El Tamaño Máximo de Segmento que se utilizará con esta ruta. El MSS se transmite al host remoto durante el procesamiento abierto y

controla el tamaño de los datagramas que está construyendo el host

remoto. La especificación MSS siempre se reduce a MTU-40.

CRETran= Esto especifica el número de milisegundos que TCP/IP FOR VSE esperará un ACK en respuesta a una solicitud de conexión (SYN). Una

vez transcurrido este intervalo, se ingresa al modo de retransmisión.

DRETran= Esto especifica el número de milisegundos que TCP/IP FOR VSE

esperará un ACK en respuesta a una transmisión de datagramas en

una conexión establecida. Una vez transcurrido este intervalo, se ingresa al modo de retransmisión.

FIXRetran= Yes

Los valores especificados para DRETRAN= y RPAUSE=

permanecen constantes durante la conexión.

No Los valores para DRETRAN = y RPAUSE = comienzan como se especifica, pero se ajustan dinámicamente a medida que se

analiza la respuesta de la red.

MINRetran= Si se especifica FIXRETRAN=NO, este es el tiempo mínimo (en


MAXRetran= Si se especifica FIXRETRAN=NO, este es el tiempo máximo (en


RPAuse= Una vez que se ha ingresado al modo de retransmisión, este es el tiempo

(en milisegundos) que transcurrirá entre los intentos de retransmisión.

RETRY= Este parámetro especifica el número de veces que un datagrama no reconocido se retransmitirá antes de que la conexión se considere

inactiva.

208


PULse= Esto especifica cuánto tiempo (en segundos) una conexión puede estar inactiva (sin tráfico de ningún tipo) antes de que se realice una

sonda para determinar si el host remoto todavía está activo.

WINdow= Este valor indica el tamaño deseado de la Ventana de Recepción.

Ejemplo

query routes IPN253I << TCP/IP Routes >> IPN448I ID: DEFAULT Link ID: LINK3172, 0 IPN449I IP Address: 0.0.0.0 Mask: 255.255.255.0 IPN450I Net: -- Subnet: -- Host: -- IPN448I ID: *Internal Link ID: *Internal IPN449I IP Address: 127.0.0.0 Mask: 255.0.0.0 IPN450I Net: 127.0.0.0 Subnet: -- Host: -- IPN448I ID: *Internal001 Link ID: *Internal IPN449I IP Address: 192.168.1.161 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: 0.0.0.161 IPN448I ID: LOCAL Link ID: LINK3172, 0 IPN449I IP Address: 192.168.1.0 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: --

modify route,id=default,after=local

query routes IPN253I << TCP/IP Routes >> IPN448I ID: *Internal Link ID: *Internal IPN449I IP Address: 127.0.0.0 Mask: 255.0.0.0 IPN450I Net: 127.0.0.0 Subnet: -- Host: -- IPN448I ID: *Internal001 Link ID: *Internal IPN449I IP Address: 192.168.1.161 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: 0.0.0.161 IPN448I ID: LOCAL Link ID: LINK3172, 0 IPN449I IP Address: 192.168.1.0 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: -- IPN448I ID: DEFAULT Link ID: LINK3172, 0 IPN449I IP Address: 0.0.0.0 Mask: 255.255.255.0 IPN450I Net: -- Subnet: -- Host: --


TCP/IP FOR VSE busca las instrucciones de ruta en el mismo orden en que

se ingresan (excepto para una entrada con una dirección IP completamente en cero). El uso del parámetro AFTER= garantiza una secuencia adecuada

de la tabla de ruta.

Para examinar el orden de búsqueda, use el comando QUERY ROUTES.

Esto muestra la tabla de rutas en el orden de búsqueda (excepto las entradas

con una dirección IP completamente en cero).

209


Una instrucción de ruta la dirección IP completamente en cero sólo coincide

después de que se hayan probado todas las demás entradas (en orden).

Una vez que una instrucción de ruta coincide con la dirección IP, se

verifica la disponibilidad del enlace designado. Si el enlace no se

puede usar, la búsqueda continúa con la siguiente entrada de ruta.

Cuando se emite un comando DELETE LINK porque

desea deshabilitar un enlace,

desea cambiar uno o más atributos de un enlace, o

desea recuperarse de un enlace que fue desactivado por

un comando de hardware,

todas las instrucciones DEFINE ROUTE que se refieren a ese enlace

se eliminan automáticamente.

Si desea redefinir un enlace que eliminó, primero debe esperar a

que se complete el comando DELETE y luego confirmar que LINK

ya no existe emitiendo un comando QUERY LINKS. Después de eso, debe definir el enlace y luego restablecer las rutas con el

comando DEFINE ROUTE.

Por ejemplo, después de emitir DELETE LINK, puede

1. Usar QUERY LINKS para confirmar que el enlace se ha ido

2. Usar DEFINE LINK para restablecer el enlace

3. Usar DEFINE ROUTE para restablecer las rutas.

Alternativamente, para restablecer un enlace que eliminó, simplemente

puede alternar la pila TCPIP FOR VSE.


DEFINE ADAPTER


DEFINE ALTIP Hace que la pila monitoree y responda a las solicitudes ARP de direcciones

de inicio adicionales.

DEFINE MASK


DEFINE ROUTE


DELETE ALTIP


210


DELETE LINK

Elimina un enlace entre TCP/IP FOR VSE y una red o una pila


DELETE ROUTE

Elimina una entrada de la tabla de enrutamiento de red.

DISCOVER

Determina el “major” tamaño de MTU para un host remoto.

GATEWAY


QUERY ARPS


QUERY LINKS


QUERY MASKS


QUERY ROUTES



QUERY OPTIONS


SET IPADDR


SET MASK


SET MAX_SEGMENT Controla la configuración predeterminada para el Tamaño Máximo de

Segmento entrante.

SET PULSE_TIME

Controla la configuración predeterminada para el intervalo entre sondas

de conexiones inactivas (PULSE= parámetro en DEFINE ROUTE)

SET RETRANSMIT

Controla la duración del intervalo predeterminado antes de que TCP/IP FOR VSE entre en modo de retransmisión para paquetes de datos no reconocidos.

SET WINDOW

Controla la configuración predeterminada de la ventana de entrada TCP.

TRACERT

Muestra cada "salto" en una ruta junto con el tiempo necesario para llegar a ésta.

211

Capítulo 3 Descripción de Comandos: PING

PING

Sintaxis

Argumentos

Ejemplo

Notas

El comando PING permite probar una ruta de comunicación sin involucrar a

clientes y servidores en cada extremo. La función PING básica es compatible

en un nivel bajo por la mayoría de las pilas TCP/IP.

PING host

host Especifica la dirección IP del host a ser probada. Esta puede ser una dirección numérica real o un nombre simbólico que puede resolverse

en una dirección IP.


Cada comando PING hace que se intenten cinco operaciones Ping. Se

muestra el resultado de cada intento.

El proceso PING falla en función de un método de tiempo de espera.

Los mensajes de respuesta pueden no ser instantáneos.

El comando PING es extremadamente útil para determinar la

capacidad de llegar a un cliente remoto.

Si el comando PING falla y el host remoto funciona, asegúrese de

que se hayan emitido los comandos DEFINE ROUTE adecuados.

PING también puede emitirse con la transacción CICS PING y el

cliente PING por lotes.

Algunas puertas de enlace no reenviarán tráfico a VSE hasta que

hayan recibido tráfico de VSE. PING es un método útil para

proporcionar este tráfico inicial.

Si el comando PING falla y está utilizando un nombre simbólico que

está siendo resuelto por un servidor de nombres de dominio externo,

asegúrese de que puede hacer PING con éxito el servidor de nombres de dominio.

ping e-vse.com TCP915I PINGING 012.182.034.227 (e-vse.com) TCP910I PING 1 was successful, milliseconds: 00058. TCP910I PING 2 was successful, milliseconds: 00072. TCP910I PING 3 was successful, milliseconds: 00065. TCP910I PING 4 was successful, milliseconds: 00072. TCP910I PING 5 was successful, milliseconds: 00074. TCP910I PING Complete

212

Capítulo 3 Descripción de Comandos: PING


PING_MESSAGE

Controla el mensaje de la consola "solicitud de ping recibida".

TRACERT

Muestra cada "salto" en una ruta junto con el tiempo necesario

para llegar a ésta.

213

Capítulo 3 Descripción de Comandos: PING_MESSAGE

PING_MESSAGE

Sintaxis

Argumentos

El comando PING_MESSAGE controla la producción de mensajes

de consola producidos por TCP/IP FOR VSE cada vez que se recibe

una solicitud PING de la red.

PING_Message {ON|OFF}

ON Habilita la notificación de la consola cada vez que se recibe una solicitud de ping entrante. Este es el valor predeterminado.

OFF No se muestra ningún mensaje en la consola cuando se detecta

una solicitud de ping entrante.

Ejemplo

Notas



La recepción de una solicitud PING no significa que se puedan

realizar conexiones TCP/IP. Hacer una conexión siempre requiere comunicaciones bidireccionales. Antes de que sea posible una

conexión, PING debe tener éxito en ambas direcciones.

La Salida de Seguridad Automática se puede configurar para evitar que la pila responda a las solicitudes de PING.

El comando SECURITY se puede usar para pasar las solicitudes

PING entrantes a la Salida de seguridad del usuario para su evaluación antes que la pila responda.

ASECURITY


PING

Emite una solicitud de Eco ICMP (PING).

SECURITY


ping_message on IPN538I Ping Message has been set ON IPC108I ICMP Echo request has been received from: 192.168.5.100

214

Capítulo 3 Descripción de Comandos: PORTQUEUE

PORTQUEUE

El comando PORTQUEUE establece, modifica y deshabilita la fila de

puertos.

Este comando solo se puede ejecutar después de que TCP/IP FOR VSE se haya

iniciado por completo. Para ejecutarlo desde el miembro de inicialización TCP/IP FOR VSE (la plataforma de inicialización), use el comando “INCLUDE

lib_member, DELAY” y coloque el comando PORTQUEUE en lib_member.

Sintaxis

Argumentos

Ejemplo

Exposición

Nota:

Para usar la fila de puertos con aplicaciones de socket BSD, QUEDMAX debe

establecerse en 0 en la fase de opciones $SOCKOPT. Para obtener más

información, consulte la descripción de la función LISTEN () en la Guía del Programador TCP/IP FOR VSE, capítulo 2, “Interfaz de socket BSD.”

PORTQueue PORT=port [,TIMEOUT=sec] [,DEPTH=num]

PORT= El número de puerto para el que se debe establecer o modificar la

fila. Los valores válidos varían de 1 a 65535.

TIMEOUT= Este es el tiempo que una conexión en fila puede esperar el servicio antes

de descartarse. Los valores válidos varían de 1 a 60 segundos. Si no se

especifica, la pila asigna un valor de su elección para una nueva especificación y deja los valores existentes tal como se encuentran.

DEPTH= Este es el número máximo de conexiones que se pueden poner en fila en

un momento dado. Una vez que se alcanza este número, se rechazan las

solicitudes entrantes adicionales. Los valores válidos varían de 0 (sin filas) a 100. Si no se especifica, cualquier valor existente permanece sin cambios.

El procesamiento estándar TCP/IP es simple en concepto. Cada conexión consta de una serie de interacciones, como se muestra, entre dos aplicaciones:

1. La aplicación A emite un OPEN pasivo (un escucha).

2. La aplicación B emite una OPEN activa.

3. Las solicitudes emiten ENVIOS y RECEPCIONES según corresponda.

4. Cada aplicación emite un CIERRE.

portqueue port=4099, timeout=5, depth=10 IPN405I Port queue values successfully set

215

Capítulo 3 Descripción de Comandos: PORTQUEUE

En general, la aplicación que emite la OPEN pasiva (el escucha) se considera

el servidor, y la aplicación que emite la OPEN activa se considera el cliente.

Por ejemplo, un servidor web emite su escucha en el conocido puerto 80. Cuando un navegador (el cliente) quiere obtener una página web, emite una

OPEN activa al puerto 80 y envía su solicitud.

Una vez que el servidor llena la solicitud, la conexión se cierra y el servidor vuelve a emitir su escucha para esperar la solicitud del próximo cliente.

En la práctica, la dificultad con este proceso es hacer frente a las solicitudes

de conexión que ocurren cuando el servidor ya está procesando otra

solicitud, es decir, cuando no hay una escucha en efecto. Las reglas que rigen la pila son explícitas y requieren que rechace forzosamente (RESET)

cualquier solicitud de conexión que no pueda emparejarse inmediatamente

con una conexión de escucha existente.

La forma más común de garantizar que todas (la mayoría) de las solicitudes de conexión sean exitosas es mantener múltiples conexiones de escucha en el

servidor para el mismo puerto local. A medida que se completa cada uno de

estas OPEN pasivas, el servidor lo reemplaza inmediatamente con otra conexión. El procesamiento de las conexiones establecidas puede

superponerse en cualquier grado deseado.

Sin embargo, esta programación es compleja y aún permite que algunas

solicitudes se pierdan debido a retrasos en el procesamiento a nivel de la aplicación. Y es aún más difícil proporcionar la capacidad de cambiar la

profundidad de la fila sin requerir modificaciones al código del programa.

La instalación PORTQUEUE evita estos problemas y elimina la necesidad

de la mayoría de los subprocesos múltiples en las aplicaciones. Para usarlo, primero debe determinar el número de puerto en el que se deben poner en

fila las solicitudes de conexión. Por ejemplo, una aplicación de servidor web

elegiría el conocido puerto 80.

Una vez que el puerto se designa como elegible para la fila, las solicitudes de conexión entrantes que no se pueden emparejar con conexiones de escucha

existentes se asignan a una conexión de escucha “en blanco”, que la pila

proporciona automáticamente. Esta conexión se negocia por proxy con una ventana cerrada. Cuando el servidor finalmente emite una escucha, se asigna

la siguiente conexión abierta por proxy, la ventana se abre a su valor normal

y el procesamiento continúa de la manera esperada.


QUERY PORTQUEUE Muestra estadísticas asociadas con solicitudes de conexión en fila.

INCLUDE

Indica a TCP/IP FOR VSE que busque un miembro de una librería

VSE y ejecute los contenidos como si estuvieran incluidos en el

miembro de inicialización.

216

Capítulo 3 Descripción de Comandos: PORTRANGE

PORTRANGE

Sintaxis

Argumentos

Ejemplo

Exposición


El comando PORTRANGE controla el rango de puertos locales que

se utilizan para la asignación dinámica.

PORTRange LOw=port_num,HIgh=port_num

LOw= El número de puerto más bajo que se asignará dinámicamente. El

valor debe ser al menos 1024 menor que el especificado por HIGH=, y debe estar en el rango de 1024 a 65535.

HIgh= El número de puerto más alto que se asignará dinámicamente. El valor debe ser al menos 1024 mayor que el especificado por LOW=,

y debe estar en el rango de 4096 a 65535.

Las aplicaciones de servidor generalmente emiten una OPEN pasiva (una

escucha) en un puerto conocido y luego esperan que se conecte un cliente

externo. Debido a que deben encontrarse fácilmente, especifican explícitamente

el puerto local que se utilizará. En el caso de FTP, la asignación del puerto local para una conexión de datos es diferente.

Una vez que un cliente FTP ha establecido una conexión de control con cada uno de los dos daemonss, debe emitir instrucciones a cada daemon para

permitirles abrir una conexión de datos. El cliente le indica a un daemon que

emita una OPEN pasiva y luego devuelva el número de puerto al cliente. El cliente luego le indica al otro daemon que emita una OPEN activa a ese puerto.

Típicamente, el daemon FTP pasivo le pide a la pila local que proporcione el

siguiente número de puerto disponible. Esto permite que la pila garantice que transcurran los intervalos de tiempo adecuados entre la reutilización del puerto.

También asegura que la combinación de dirección y puerto sea única.

El uso de PORTRANGE puede garantizar que el número de puerto asignado sea

aceptable para los requisitos del firewall. Un sitio puede estar limitado a un

rango de puertos basado en especificaciones de red internas, y la asignación de

puertos fuera de ese rango causaría fallas intermitentes de los programas escritos por el usuario.

DEFINE FTPD


QUERY CONNECTIONS


portrange low=32768,high=65535 IPN127I Port range changed to 32,768 65,535

217

Capítulo 3 Descripción de Comandos: QUERY ACTIVE

QUERY ACTIVE

Sintaxis

Argumentos

El comando QUERY ACTIVE muestra sesiones Telnet activas,

sesiones FTP activas, enlaces activos o las tres.

Query ACTive [,SYSLST] TYPe={TELnetd|FTPd|LINK|ALL}

SYSLST Los resultados de la consulta se envían solo a SYSLST. Si se omite esta

opción, los resultados se envían a SYSLST y a la consola. Este argumento es posicional y debe colocarse inmediatamente después del comando.

TYPe= Especifica los datos que se mostrarán.

TELnetd Muestra todos los daemons Telnet activos.

FTPd Muestra todos los daemons FTP activos.

LINK Muestra todos los enlaces activos.

ALL Muestra todos los daemonss y enlaces activos.

Ejemplo Vea Mensajes TCP/IP FOR VSE para una explicación de cada mensaje.

query active IPN435I ID: FTP01 Port: 21 Driver: FTPDAEMN SSL: No IPN874I Buffers: 2 Buffer size: 65536 bytes IPN350I Current Status: Listen IPN362I Maximum sessions: 5, Current: 1 IPN364I Userid: EWF connected from 192.168.1.66,1158 IPN365I Started at: 13:57:49 2015/03/08 IPN368I Last Command: LIST IPN363I Last Command time: 13:57:51 2015/03/08 IPN368I Last reply: 226 Closing data connection IPN363I Last reply time: 13:57:51 2015/03/08 IPN253I << TCP/IP ACTIVE LINKS >> IPN440I ID: LINK3172 Type: 802.3 Adapter: 0 IPN438I MTU: 1500 IP Address: 192.168.1.161 IPN441I MAC address: 00:00:E2:90:C0:45 IPN350I Current Status: Active IPN437I ID: LINK3172 Type: OSA2 Dev: (0032,0033) IPN350I Current Status: Active IPN437I ID: *Internal Type: *Int Dev: (0000,0000) IPN438I MTU: 32767 IP Address: 127.0.0.1 IPN350I Current Status: Active

218

Capítulo 3 Descripción de Comandos: QUERY ACTIVE

Notas


El resultado de este comando puede ser voluminoso.

QUERY FTPDS


Archivos.

QUERY LINKS Muestra el estado de los enlaces de red.

QUERY TELNETDS


219

Capítulo 3 Descripción de Comandos: QUERY ALL

QUERY ALL

Sintaxis

Argumentos

Ejemplo

Notas


El comando QUERY ALL muestra toda la información disponible.

Query ALL [,SYSLST]

SYSLST Los resultados de la consulta se envían solo a SYSLST. Si se omite

esta opción, los resultados se envían a SYSLST y a la consola.


El resultado de este comando puede ser voluminosa.

Toda la información que muestra QUERY ALL se puede obtener a

través de comandos de consulta más específicos.

Las líneas de respuesta individuales que comprenden la salida a QUERY

ALL están documentadas en el manual de mensajes TCP/IP FOR VSE.

QUERY ALTIPS


QUERY ARPS


QUERY CGIS


QUERY CONNECTIONS


QUERY DUMPOPTION

Muestra opciones para volcados producidos por TCP/IP.

QUERY EMAIL Muestra la configuración del cliente de correo electrónico. Nota: La

emisión del comando EMAIL sin ningún parámetro produce los mismos

resultados.

QUERY EVENTS


QUERY FILES


query all,syslst

220


QUERY FILEIO


QUERY FTPDS

Muestra el estado de los daemons del Protocolo de Transferencia de Archivos.

QUERY GPSDS

Muestra el estado de los daemons del Servidor de Impresión General.

QUERY HOME

Muestra todas las direcciones IP en la tabla “dirección particular”.

QUERY HTTPDS

Muestra el estado de los daemons del Protocolo de Transferencia

de Hipertexto (servidor web).

QUERY ISTATS

Muestra estadísticas que detallan las funciones internas de la pila.

QUERY LINKS


QUERY LPDS

Muestra el estado de los daemons de Impresora en Línea.

QUERY MASKS


QUERY MENUS

Muestra los menús disponibles para uso de TN3270.

QUERY NAMES

Muestra los nombres TCP/IP FOR VSE y los valores asociados a

ellos.

QUERY NTPDS


QUERY OPENFILES

Muestra una lista de archivos que están abiertos actualmente.

QUERY OPTIONS Muestra los valores actuales de los parámetros modificables.

QUERY PRODKEYS

Muestra las claves de producto TCP/IP FOR VSE que se utilizan, los nombres de los productos con licencia y las fechas de vencimiento de

las claves.

QUERY PROGRAMS

Muestra las fases del programa que usa TCP/IP FOR VSE, sus

características, sus ubicaciones de memoria y la librería desde la que se cargó cada una.

221


QUERY ROUTES



QUERY SECURITY


QUERY STATISTICS


QUERY SUSPENDED

Muestra una lista de tareas suspendidas.

QUERY TASKS

Muestra una lista de pseudo tareas.

QUERY TELNETDS


QUERY TRACES

Muestra una lista de rastreos actualmente en ejecución.

QUERY TRANSLATES

Muestra una lista de tablas de traducción disponibles.

QUERY USERS


QUERY VERSIONS

Muestra las versiones y los niveles de mantenimiento de los componentes de la pila.

222

Capítulo 3 Descripción de Comandos: QUERY ALTIPS

QUERY ALTIPS

Sintaxis

Argumentos

Ejemplo


El comando QUERY ALTIPS muestra el contenido actual de la

tabla de direcciones IP alternativas.

Query ALTips [,SYSLST]

SYSLST Los resultados de la consulta se envían sólo a SYSLST. Si se omite


DEFINE ALTIP

Hace que la pila supervise y responda a las solicitudes ARP

de direcciones de inicio adicionales.

DELETE ALTIP

Elimina una dirección de inicio alterna.

GATEWAY


QUERY HOME

Muestra todas las direcciones IP en la tabla “Direcciones de Inicio”.

QUERY LINKS


QUERY ROUTES

Muestra el contenido de la tabla de enrutamiento de red o la ruta tomada para llegar a una dirección específica.

query altips IPN253I << TCP/IP Alternate IP Addresses >> IPN380I Alternative IP address, ID: TEST IPAddr: 64.10.5.5 IPN380I Alternative IP address, ID: SYS2 IPAddr: 64.10.5.2

223

Capítulo 3 Descripción de Comandos: QUERY ARPS

QUERY ARPS

Sintaxis

Argumentos

Ejemplo

Notas


El comando QUERY ARPS muestra el contenido de la tabla del

Protocolo de Resolución de Direcciones (ARP). Esta tabla asigna

una dirección de red TCP/IP a una dirección de hardware físico.

Query ARPs [,SYSLST] [,IPaddr=ip4addr]

SYSLST Los resultados de la consulta se envían sólo a SYSLST. Si se omite esta


IPaddr= Especifica la dirección de red TCP/IP para la que se debe mostrar la entrada

ARP. Si se omite, se muestran todas las entradas de la tabla ARP

Consulte el Manual de Mensajes TCP/IP FOR VSE para obtener una


Las siguientes notas aplican para este comando:

La pila actualiza la tabla cada vez que recibe un ARP. Si cambia

una dirección MAC, se emite un mensaje de alerta.

El campo “C:” en la respuesta del comando se refiere a la cantidad de veces que VSE ha tenido un ARP desde la dirección IP. Un gran número

en este campo podría significar que un host en particular está creando

una sobrecarga TCP/IP innecesaria al solicitar ARP frecuentemente.

Si una dirección IP se reasigna a una dirección MAC diferente, su primer

intento de contactar a VSE (por ejemplo, PING) actualizará la tabla ARP. Esto también ocurre si el dispositivo emite un ARP de difusión.

QUERY ALTIPS


QUERY LINKS


query arps IPN253I << TCP/IP ARP Table >> IPN409I Information for Link LINK3172, Adapter 0 IPN410I 192.168.1.4 > 00:00:00:00:00:00 C: 0 IPN410I 192.168.1.1 > 00:0C:41:80:DD:30 C: 1 IPN410I 192.168.1.66 > 00:19:B9:75:5E:96 C: 3

224

Capítulo 3 Descripción de Comandos: QUERY ARPS

QUERY ROUTES



DEFINE ROUTE


225

Capítulo 3 Descripción de Comandos: QUERY CGIS

QUERY CGIS

Sintaxis

Argumentos

Ejemplo


El comando QUERY CGIS proporciona información sobre las rutinas de la

Interfaz de Puerta de Enlace Común (CGI) utilizadas por los daemons HTTP.

Query CGIs [,SYSLST] [,PUBlic=pubname]



PUBlic= Especifica el CGI que se mostrará. Si se omite esta opción, se muestran

todos los CGI.

Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación

de cada mensaje en este ejemplo.

DEFINE CGI


DELETE CGI

Elimina un programa CGI del almacenamiento.

QUERY PROGRAMS

Muestra las fases del programa que usa TCP/IP FOR VSE, sus características, sus ubicaciones de memoria y la biblioteca desde la

que se cargó cada una.

query cgis IPN253I << TCP/IP CGIs >> IPN432I Public Name: CGIIPLDT IPN433I Type: CGI DLBL: Driver: CGIIPLDT IPN432I Public Name: CGIIPLD2 IPN433I Type: CGI-BAL DLBL: Driver: IPNFCGIB IPN432I Public Name: CGISTATS IPN433I Type: CGI DLBL: Driver: CGISTATS IPN432I Public Name: CGISUBM1 IPN433I Type: CGI DLBL: Driver: CGISUBM1 IPN432I Public Name: VSECOM

226

Capítulo 3 Descripción de Comandos: QUERY CONNECTIONS

QUERY CONNECTIONS

Sintaxis

El comando QUERY CONNECTIONS devuelve información

detallada sobre el estado de las conexiones TCP/IP FOR VSE.

Query CONnections [,SYSLST] [,IPaddr=ip4addr]

[,FPort=port] [,LPort=port]

[,STate={Listen|Established}] [,EXTended]

[,Trace]

Argumentos SYSLST Los resultados de la consulta se envían solo a SYSLST. Si se omite esta


IPaddr= Si se especifica, sólo se muestran las conexiones para la dirección específica.

FPort= Si se especifica, la pantalla se limita a las conexiones que utilizan este

puerto externo.

LPort= Si se especifica, la pantalla se limita a las conexiones que utilizan este

puerto local.

STate= Este parámetro limita la visualización al estado de la conexión.

Listen Solo se muestran las conexiones en estado de escucha.

Established Solo se muestran las conexiones establecidas. Esto incluye conexiones que están en proceso de finalización.

EXTended Este parámetro hace que se muestre información extendida sobre la

conexión. Si se omite, solo se muestra información resumida.

Trace Este parámetro hace que se muestre una mini traceo que muestra los pocos datagramas de entrada y/o salida anteriores.

227


Ejemplo 1

Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una

explicación de cada mensaje en estos ejemplos.

query connections IPN253I << TCP/IP Connections >> IPT353I >21 0.0.0.0, 0 TCP 0 Listen IPT345I Open by FTPDAEMN in F4 Ident: C59A9E0A96075000 IPT356I Total sockets: RECV: 0 (0); SEND: 0 (0); STAT: 0; CLOSE: 0 ABORT: 0 CNTL: 0

IPT353I >21 192.168.1.66, 3911 TCP 0 Established IPT345I Open by FTPDAEMN in F4 Ident: C59A952773C1E000 IPT341I Start: 13:57:54 Idle: 0.020 Duration: 2.579 IPT356I Total sockets: RECV: 12 (43); SEND: 12 (535); STAT: 12; CLOSE: 0 ABORT: 0 CNTL: 12

IPT360I Socket RECV 0 bytes, Duration: 0.656 Timeout: 1/00:00:03.663 IPT353I >515 0.0.0.0, 0 TCP 0 Listen IPT345I Open by LPD in F4 Ident: C599C9ACA0687000 IPT356I Total sockets: RECV: 0 (0); SEND: 0 (0); STAT: 0; CLOSE: 0 ABORT: 0 CNTL: 0

228


Ejemplo 2

query connections,extended IPN253I << TCP/IP Connections >> IPT353I >21 0.0.0.0, 0 TCP 0 Listen IPT345I Open by FTPDAEMN in F4 Ident: C59A9E0A96075000 IPT356I Total sockets: RECV: 0 (0); SEND: 0 (0); STAT: 0; CLOSE: 0 ABORT: 0 CNTL: 0

IPT353I >21 192.168.1.66, 3911 TCP 0 Established IPT345I Open by FTPDAEMN in F4 Ident: C59A952773C1E000 IPT341I Start: 13:57:54 Idle: 10.595 Duration: 13.154 IPT342I Send IS: 70F02774 Data: 535 IPT342I Recv IS: F06E1465 Data: 43 IPT343I Route: LOCAL; MTU: 1,500; Send MSS: 1,460 (1,460); Recv MSS: 1,460; Buffer: 65,534/1,825

IPT344I Send: 25 blocks, 536 bytes. Retrans: 0 blocks, 0 bytes. Eff: 34% IPT344I Recv: 16 blocks, 44 bytes. Duplicate: 0 blocks, 0 bytes. Eff: 6% IPT350I Send Window: 70F0298C thru 70F12774; 65,000 bytes. Max: 65,535. Closed: 0. Time closed: 0.000 IPT350I Recv Window: F06E1491 thru F06F148F; 65,534 bytes. Max: 65,534. Closed: 0. Time closed: 0.000 IPT347I Fixed Retrans; Init: 1,000/1,000; Limit: 500/2,000; Delay: 500; Retries: 50 IPT348I Retran Start: 1,000; Times: 0; Current: Off; Blocks: 0; Cost: 0 sec IPT349I Pulse: Enabled; Interval: 60 sec; Count: 0 IPT352I Roundtrip: Min: 2 ms; Max: 217 ms; Last: 217 ms IPT356I Queued sockets: RECV: 1 (0); SEND: 0 (0); STAT: 0; CLOSE: 0 ABORT: 0 CNTL: 0

IPT356I Total sockets: RECV: 12 (43); SEND: 12 (535); STAT: 12; CLOSE: 0 ABORT: 0 CNTL: 12 IPT360I Socket RECV 0 bytes, Duration: 11.231 Timeout: 23:59:53.088 IPT353I >515 0.0.0.0, 0 TCP 0 Listen IPT345I Open by LPD in F4 Ident: C599C9ACA0687000 IPT356I Total sockets: RECV: 0 (0); SEND: 0 (0); STAT: 0; CLOSE: 0 ABORT: 0 CNTL: 0

229


Ejemplo 3

query connections,lport=21,trace IPN253I << TCP/IP Connections >> IPT353I >21 0.0.0.0, 0 TCP 0 Listen IPT345I Open by FTPDAEMN in F4 Ident: C59A9E0A96075000 IPT356I Total sockets: RECV: 0 (0); SEND: 0 (0); STAT: 0; CLOSE: 0 ABORT: 0 CNTL: 0

IPT353I >21 192.168.1.66, 3911 TCP 0 Established IPT345I Open by FTPDAEMN in F4 Ident: C59A952773C1E000 IPT341I Start: 13:57:54 Idle: 0.000 Duration: 1:02.563 IPT356I Total sockets: RECV: 12 (43); SEND: 12 (535); STAT: 12; CLOSE: 0 ABORT: 0 CNTL: 12

IPT360I Socket RECV 0 bytes, Duration: 1:00.640 Timeout: 23:59:03.679 IPT357I RECV: F06E1485 A: 70F02909 W: FE6B D: 0000 C: 10 ACK IPT357I RECV: F06E1485 A: 70F02909 W: FE6B D: 0006 C: 18 ACK,PSH IPT357I SEND: 70F02909 A: F06E148B W: FFFE D: 0031 C: 18 ACK,PSH IPT357I RECV: F06E148B A: 70F0293A W: FE3A D: 0000 C: 10 ACK IPT357I RECV: F06E148B A: 70F0293A W: FE3A D: 0006 C: 18 ACK,PSH IPT357I SEND: 70F0293A A: F06E1491 W: FFF8 D: 0000 C: 10 ACK IPT357I SEND: 70F0293A A: F06E1491 W: FFFE D: 0000 C: 10 ACK IPT357I SEND: 70F0293A A: F06E1491 W: FFFE D: 0035 C: 18 ACK,PSH IPT357I RECV: F06E1491 A: 70F0296F W: FE05 D: 0000 C: 10 ACK IPT357I SEND: 70F0296F A: F06E1491 W: FFFE D: 001D C: 18 ACK,PSH IPT357I RECV: F06E1491 A: 70F0298C W: FDE8 D: 0000 C: 10 (002) ACK IPT357I SEND: 70F0298B A: F06E1491 W: FFFE D: 0000 C: 10 * ACK


DEFINE SOTRACE


DEFINE TRACE


FLUSH


PORTQUEUE

Controla cómo se ponen en fila las solicitudes de conexión

entrantes para una aplicación.

230

Capítulo 3 Descripción de Comandos: QUERY DIAGNOSE

QUERY DIAGNOSE

Sintaxis

Argumentos

Ejemplo


El comando QUERY DIAGNOSE muestra los modos de diagnóstico

habilitados actualmente.

Query DIAGnose [,SYSLST]



DIAGNOSE

Controla las opciones de visualización de diagnóstico.

QUERY LOGS Muestra las consolas y registros disponibles y sus propiedades.

query diagnose IPN805I Diagnose on for: PERFORM

231

Capítulo 3 Descripción de Comandos: QUERY DUMPOPTIONS

QUERY DUMPOPTIONS

Sintaxis

Argumentos

Ejemplo


El comando QUERY DUMPOPTIONS muestra la configuración de formato

actual para los volcados.

Query DUMPoptions [,SYSLST]



DUMPOPTION

Controla el formato de los volcados de almacenamiento iniciados por

TCP/IP.

query dumpoptions IPN818I Dump Options for File I/O set to CSI format

232

Capítulo 3 Descripción de Comandos: QUERY EMAIL

QUERY EMAIL

Sintaxis

Argumentos

Ejemplo


El comando QUERY EMAIL enumera muchos de los valores actuales

que establece el comando EMAIL.

Query EMAil [,SYSLST]





DEFINE EVENT


EMAIL

Establece opciones globales predeterminadas para el cliente de

correo electrónico. Nota: La emisión de este comando sin ningún parámetro produce los mismos resultados que QUERY EMAIL.

query email IPN253I << TCP/IP EMAIL >> IPN835I UserID: $EMAIL RPort: 25 IPN838I Truncate: NO AtSign: 7C GMT: (System) IPN840I Translation table (General): Default IPN840I Translation table (Text): Default IPN840I Translation table (Attachments): Default

233

Capítulo 3 Descripción de Comandos: QUERY EVENTS

QUERY EVENTS

Sintaxis

Argumentos

El comando QUERY EVENTS le permite inspeccionar la configuración actual de los

eventos del sistema TCP/IP FOR VSE. Estos eventos son procesados por un daemon

de automatización y resultan en transferencias FTP, LPR o correo electrónico.

Query EVents [,SYSLST] [,ID=id] [,DETail]



ID= El ID del evento a ser listado. Si se omite, se muestran todos los eventos.

DETail Muestra no solo el evento, sino todos los procesos que esperan ser

entregados, se están entregando o han terminado de entregarse, pero

la disposición final aún no se ha realizado (eliminar el informe o cambiarlo a “HOLD”).

Ejemplo 1 Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación

de cada mensaje en este ejemplo y el siguiente.

query events IPN253I << TCP/IP Events >> IPN587I Event Pause Interval: 1500 (5 Seconds) IPN273I Maximum LPR Events: 5 Current Events: 0 IPN273I Maximum FTP Events: 3 Current Events: 0 IPN273I Maximum Email Events: 1 Current Events: 0 IPN426I Event ID: AUTOLPR1 IPN428I Class: Y, Queue: LST, Action: LPR, POWER SYSID: IPN427I Priority: Yes, Order: Yes, Script: L IPN429I Host field: DEST, User ID: $EVENT, Single: N IPN430I Action: LPR, Retries: 1, Time: 45 sec IPN426I Event ID: AUTOFTP2 IPN428I Class: X, Queue: PUN, Action: FTP, POWER SYSID: IPN427I Priority: Yes, Order: Yes, Script: L IPN429I Host field: USER, User ID: $EVENT, Single: N IPN430I Action: FTP, Retries: 1, Time: 45 sec IPN426I Event ID: AUTOFTP1

IPN428I Class: X, Queue: LST, Action: FTP, POWER SYSID: IPN427I Priority: Yes, Order: Yes, Script: L IPN429I Host field: USER, User ID: $EVENT, Single: N IPN430I Action: FTP, Retries: 1, Time: 45 sec

234

Capítulo 3 Descripción de Comandos: QUERY EVENTS

Ejemplo 2


DEFINE EVENT


DELETE EVENT

Termina el monitoreo de una clase POWER.

SEPARATOR_PAGES

Controla la generación de páginas de separación POWER.

SET AUTO_TIME

Determina el intervalo para que la automatización verifique las filas

POWER.

QUERY EVENTS,DETAILS IPN253I << TCP/IP Queued Event Settings >> IPN237I (Generated on 10/05/15 at 11.02) IPN273I Maximum LPR Events: 5 Current Events: 0 IPN273I Maximum FTP Events: 1 Current Events: 0 IPN273I Maximum Email Events: 1 Current Events: 0 IPN273I Maximum overall Events: 7 Current Events: 0 IPN237I SINGLEDEST is on IPN237I AUTO_TIME is 30 seconds IPN253I << TCP/IP Queued Event Details >> IPN426I Event ID: CLASSM LST(M) EMAIL IPN443I SVA-21429-000 <SYSENHED >In Process IPN443I SVA-33192-000 <SYSENHED >Failed to send, retrying IPN443I SVA-44958-000 <SYSENHED >Completed and awaiting purge

235

Capítulo 3 Descripción de Comandos: QUERY EXTERNAL

QUERY EXTERNAL

El comando QUERY EXTERNAL muestra cierta información sobre

particiones externas a la pila TCP/IP FOR VSE que se comunican con

la pila. Los detalles incluyen esas conexiones dentro de la pila TCP/IP FOR VSE, así como los atributos de las particiones que no son TCP/IP

FOR VSE.

Sintaxis

Argumentos

Ejemplo

Notas


El resultado muestra cada número de identificación de TCP/IP FOR

VSE, lo que significa que, si tiene dos pilas que operan dentro de la misma VSE, verá dos identificadores de pila diferentes. Esto indica si

existe una conexión entre dos pilas TCP/IP FOR VSE diferentes.

Query EXTERNAL [,SYSLST]


opción, los resultados se envían tanto a SYSLST como a SYSLOG.

Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación de cada mensaje en este ejemplo.

Use este comando cuando desee ver las estadísticas generales de SOCKET para

una partición por lotes específica, así como el uso en un entorno de múltiples

pilas.

EXTPGVS

Permite asignar solicitudes de socket de partición externa en el almacenamiento de partición privada de 31 bits.

QUERY OPTIONS


Q EXTERNAL IPN684I BG PXBLOK:217E8F00 PIK:0010 TIK:0021 STACK:00 SQBLOK:0033D000 IPN685I BG last socket job step 20160724 5:40:27.116 IPN686I T1 csoc=0 + ntcp=0 = 0 IPN687I T1 spas=0 + async=0 + ntlk=0 = 0 IPN689I T1 Total passive opens(15) successful connects(2)

236

Capítulo 3 Descripción de Comandoss: QUERY EXTTYPES

QUERY EXTTYPES

Sintaxis

Argumentos

Ejemplo

El comando QUERY EXTTYPES muestra las entradas en la tabla

Tipos Externos que se cargaron por última vez en el almacenamiento.

Query EXTtypes [,SYSLST]

SYSLST Los resultados de la consulta se envían sólo a SYSLST. Si esta

opción se omite, los resultados se envían a SYSLST y a la consola.

Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación de

cada mensaje en este ejemplo.

TEXT Text FB text/plain TIF Binary S image/tiff TIFF Binary S image/tiff TTF Binary S application/octet-stream TXT Text FB text/plain VCF Binary S application/octet-stream WAV Binary S audio/x-wav WRL Text FB x-world/x-vrml WRZ Text FB x-world/x-vrml XLS Binary S application/excel XLT Binary S application/excel XML TextC FB application/xml ZIP Binary S application/zip

AIF Binary S audio/x-aiff AIFC Binary S audio/x-aiff AIFF Binary S audio/x-aiff ASC Text FB text/plain AU Binary S audio/basic AVI Binary S video/x-msvideo BIN Binary S application/octet-stream BINJOB Bin80 S BJB Bin80 S CAB Binary S application/octet-stream

IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I ... IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I IPN844I

query exttypes IPN253I << TCP/IP External Names Table >>

237

Capítulo 3 Descripción de Comandoss: QUERY EXTTYPES

Notas



La tabla Tipos Externos es utilizada por varias aplicaciones (FTP,

HTTP, EMAIL) para asociar propiedades con un archivo basado en la

extensión del archivo.

Cada línea en la salida muestra un tipo de archivo incluido, el tipo de transferencia asignado (Binario, Bin80, TEXT o TEXTC), el formato

(Cadena o Bloque fijo) y el tipo de contenido MIME, que identifica el

formato de los archivos en el Internet. Para FTP, los valores predeterminados para LRECL, BLKSIZE y RECFM están asociados

con cada tipo de transferencia. Para obtener más información,

consulte la Guía de Instalación de TCP/IP FOR VSE, capítulo 6,

"Configuración de Clientes y Daemons FTP", subsección "Control de valores predeterminados mediante EXTTYPES.L".

DEFINE FTPD


DEFINE HTTPD

Crea un daemon del Protocolo de Transferencia de Hipertexto (servidor web).

EMAIL

Establece opciones globales predeterminadas para el cliente de correo

electrónico.

RELOAD

Recarga una mesa de control.

238

Capítulo 3 Descripción de Comandos: QUERY FILEIO

QUERY FILEIO

Sintaxis

Argumentos

Ejemplo


El comando QUERY FILEIO muestra información sobre los controladores

I/O de archivos instalados.

Query FILEIo [,SYSLST]





DEFINE FILE

Define un archivo en el sistema de archivos TCP/IP FOR VSE y lo asocia con un controlador I/O de archivo.

DEFINE FILEIO

Define un controlador I/O de archivo para un tipo de archivo.

QUERY FILES


query fileio IPN253I << TCP/IP File I/O Drivers >> IPN640I REXX Driver: IPNFREXX Entry: 805D3050 Use: 0 IPN640I LIBRARY Driver: IPNFLIBR Entry: 805BC050 Use: 0 IPN640I POWER Driver: IPNFPOWR Entry: 005B2050 Use: 0

239

Capítulo 3 Descripción de Comandos: QUERY FILES

QUERY FILES

Sintaxis

Argumentos

Ejemplo

Comando Relacionado

El comando QUERY FILES le permite inspeccionar la especificación

actual de uno o más archivos en el sistema de archivos TCP/IP FOR VSE.

Query FIles [,SYSLST] [,PUBlic=pubname]



PUBlic= El nombre público de un archivo para ser listado. Si se omite, se enumeran todos los archivos.


DEFINE FILE

Define un archivo en el sistema de archivos TCP/IP FOR VSE y lo

asocia con un controlador I/O de archivo.

DELETE FILE


query files IPN253I << TCP/IP Files >> IPN432I Public Name: DEVLIB IPN433I Type: LIBRARY DLBL: DEVLIB Driver: IPNFLIBR IPN545I GID: +0 UID: +0 Permissions: ------ IPN432I Public Name: IJSYSRS IPN433I Type: LIBRARY DLBL: IJSYSRS Driver: IPNFLIBR IPN545I GID: +0 UID: +0 Permissions: ------ IPN432I Public Name: POWER IPN433I Type: POWER DLBL: Driver: IPNFPOWR IPN545I GID: +0 UID: +0 Permissions: ------ IPN432I Public Name: PRD1 IPN433I Type: LIBRARY DLBL: PRD1 Driver: IPNFLIBR IPN545I GID: +0 UID: +0 Permissions: ------ IPN432I Public Name: PRD2 IPN433I Type: LIBRARY DLBL: PRD2 Driver: IPNFLIBR IPN545I GID: +0 UID: +0 Permissions: ------ IPN432I Public Name: PRODLIB IPN433I Type: LIBRARY DLBL: PRODLIB Driver: IPNFLIBR IPN545I GID: +0 UID: +0 Permissions: ------

240

Capítulo 3 Descripción de Comandos: QUERY FIREWALL

QUERY FIREWALL

Sintaxis

Argumentos

Ejemplo


El comando QUERY FIREWALL muestra la configuración actual del

firewall que se aplica para la función opcional Firewall Shield.

Query FIREWALL [,SYSLST]





FIREWALL

Controla y monitorea la característica opcional de Firewall Shield.

IPSTAT

Controla si se asigna un ISBLOK para cada dirección IP que accede a la pila.

QUERY IPSTAT

Muestra estadísticas de direcciones IP almacenadas en ISBLOK.

query firewall IPI208I FIREWALL loaded at 82240980 with 10 ranges defined

IPI210I FIREWALL range allowed 127.0.0.1-127.0.0.1 Hits:248 ICMP=YES FREEPBLK=NO IPI215I TCPPORTS:ALL.

IPI216I UDPPORTS:ALL. IPI210I FIREWALL range allowed 38.101.62.131-38.101.62.131 Hits:582 ICMP=YES FREEPBLK=NO IPI215I TCPPORTS:ALL. IPI216I UDPPORTS:ALL.

IPI210I FIREWALL range allowed 38.101.62.132-38.101.62.255 Hits:0 ICMP=YES FREEPBLK=YES IPI215I TCPPORTS:ALL. IPI216I UDPPORTS:ALL. IPI210I FIREWALL range allowed 69.55.70.38-69.55.70.38 Hits:0 ICMP=YES FREEPBLK=NO IPI215I TCPPORTS:ALL.

IPI216I UDPPORTS:ALL. IPI210I FIREWALL range allowed 216.29.249.42-216.29.249.42 Hits:0 ICMP=YES FREEPBLK=NO IPI215I TCPPORTS:NONE. IPI216I UDPPORTS:ALL. IPI210I FIREWALL range allowed 39.101.62.0-39.101.62.255 Hits:0 ICMP=YES FREEPBLK=YES

IPI215I TCPPORTS:00021,00020.

IPI216I UDPPORTS:NONE.

241

Capítulo 3 Descripción de Comandos: QUERY FRAGMENTS

QUERY FRAGMENTS

Sintaxis

Argumentos

Ejemplo

El comando QUERY FRAGMENTS le permite inspeccionar el estado

actual del proceso de reensamblaje de datagramas fragmentados.

Query FRAGments [,SYSLST]





query fragments IPN253I << TCP/IP IP Fragmentation >> IPN812I Pending Fragments: 3 IPN812I Pending Datagrams: 2 IPN812 Total Fragments: 987 IPN812I Total Reassembled: 857 IPN812I Total Used: 752 IPN812I Total Expired: 15 IPN812I Total Duplicates: 27 IPN812I Total Invalid: 0

242

Capítulo 3 Descripción de Comandos: QUERY FTPDS

QUERY FTPDS

Sintaxis

Argumentos

El comando QUERY FTPD muestra las características de los daemons

FTP definidos actualmente.

Query FTPds [,SYSLST] [,ID=id] [,EXTended]



ID= El ID del daemon FTP asignado por un comando DEFINE FTPD.

EXTended Se muestra información adicional para cada daemon. Nota: El valor de “Tiempo de Espera Inactivo” no se muestra si se usó el valor predeterminado

(0).

Ejemplo Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación


query ftpds IPN253I << TCP/IP FTP Daemons >> IPN435I ID: FTP01 Port: 21 Driver: FTPDAEMN SSL: No IPN874I Buffers: 2 Buffer size: 65536 bytes IPN350I Current Status: Listen IPN362I Maximum sessions: 5, Current: 1 IPN364I Userid: EWF connected from 192.168.1.66,3928 IPN881I 1 FTP Daemons defined, 1 sessions active

query ftpds,extended IPN253I << TCP/IP FTP Daemons >> IPN435I ID: FTPD9921 Port: 9921 Driver: FTPDAEMN SSL: No IPN874I Buffers: 2 Buffer size: 65536 bytes IPN350I Current Status: Listen IPN362I Maximum sessions: 3, Current: 0 IPN435I ID: FTPD0021 Port: 21 Driver: FTPDAEMN SSL: No IPN874I Buffers: 2 Buffer size: 65536 bytes IPN872I Xmit hesitation: 0, Idle timeout: 120 seconds IPN350I Current Status: Listen IPN362I Maximum sessions: 13, Current: 1 IPN364I Userid: DSTOEVER connected from 192.168.0.153,1870 IPN365I Started at: 17:00:15 2010/02/27 IPN366I 2:files sent, 3:files received IPN367I 79,426 bytes sent (79,426), 90,646 bytes received IPN368I Last Command: RETR SERVP15G.ZIP IPN363I Last Command time: 17:02:55 2010/02/27 IPN368I Last reply: 226 Closing data connection IPN363I Last reply time: 17:02:57 2010/02/27 IPN881I 2 FTP Daemons defined, 1 sessions active

243

Capítulo 3 Descripción de Comandos: QUERY FTPDS


DEFINE FTPD

Crea un daemons de Protocolo de Transferencia de Archivos.

DELETE FTPD

Termina un daemon de Protocolo de Transferencia de Archivos.

QUERY ACTIVE


244

Capítulo 3 Descripción de Comandos: QUERY GPSDS

QUERY GPSDS

Sintaxis

Argumentos

El comando QUERY GPSD proporciona información sobre daemons

GPS.

Query GPSD [,SYSLST] [,ID=id]



ID= El ID del daemon GPS específico para el que desea información. Si

se omite este argumento, se muestran todos los daemons.

Ejemplo




DEFINE GPSD

Crea un daemon de Servidor de Impresión General.

DELETE GPSD

Termina un daemon de Servidor de Impresión General.

query gpsd,id=gpsd3 IPN253I << TCP/IP GPS Daemons >> GPS930I GPSD3 Host: 192.168.020.007 Printer: KEDIT GPS931I GPSD3 Termname: GPS3 Logmode: DSC2K GPS932I GPSD3 User: Translate: Script: GPS933I GPSD3 Log=NO Debug=NO GPS934I GPSD3 Insess=DBDCCICS Target: GPS935I GPSD3 Storage=PRD2.SAVE GPS936I GPSD3 Retries: 3 Delay: 18000 GPS937I GPSD3 Maxpages: 100 Now queued: 0 GPS938I GPSD3 Maxlines: 10000 Now queued: 0 GPS939I GPSD3 Maxchars: 1000000 Now queued: 0 GPS940I GPSD3 Maxidle: 3000 (10 seconds)

245

Capítulo 3 Descripción de Comandos: QUERY HOME

QUERY HOME

Sintaxis

Argumentos

Ejemplo


El comando QUERY HOME hace que se muestren todas las direcciones IP

por las cuales la pila es conocida y accesible.

Query HOME [,SYSLST]





DEFINE ADAPTER


DEFINE ALTIP

Hace que la pila supervise y responda a las solicitudes ARP de direcciones de inicio adicionales.

DEFINE LINK

Crea un enlace entre TCP/IP FOR VSE y una red o una pila conectada directamente.

SET IPADDR


query home IPN253I << TCP/IP Home Addresses >>

IPN582I 127.0.0.1 Link *Internal IPN582I 192.168.1.161 Main

IPN582I 192.168.1.161 Link LINK3172 IPN582I 192.168.1.162 ARP

246

Capítulo 3 Descripción de Comandos: QUERY HTTPDS

QUERY HTTPDS

Sintaxis

Argumentos

El comando QUERY HTTPDS muestra las características de los daemons

HTTP (Web) actualmente definidos.

Query HTtpds [,SYSLST] [,ID=id]



ID= Especifica el nombre del daemon HTTP asignado por el comando

DEFINE HTTPD. Si se omite esta opción, se muestran todos los daemons HTTP.

Ejemplo




ASECURITY WEBL Establece la seguridad de acceso en función de la dirección de red.

DEFINE HTTPD

Crea un daemon del Protocolo de Transferencia de Hipertexto (servidor

web).

DELETE HTTPD

Termina un daemon del Protocolo de Transferencia de Hipertexto (servidor

web).

query httpds IPN253I << TCP/IP HTTP Daemons >> IPN509I ID: H1 Port: 80 Driver: HTTPD IPN510I Confine: NO Root: TBXBITL.TBXBITL. IPN867I Ignorename: Yes Max: 50 Actual: 0 HTT946I Security: No Scanblocker: NO HTT948I Translate: OS_02 SOSI: None/None HTT949I Count: 3 Timeout: 90000 HTT950I -------------------------------------

247

Capítulo 3 Descripción de Comandos: QUERY IBBLOKS

QUERY IBBLOKS

Sintaxis

Argumentos

Ejemplo

El comando QUERY IBBLOKS muestra la configuración actual y las

estadísticas relacionadas con el uso del bloque de buffer de Internet.

Query IBbloks [,SYSLST]



Los campos clave en este ejemplo se describen en la tabla a continuación. Vea

el Manual de Mensajes TCP/IP FOR VSE para obtener más información.

Campo Descripción

Size Los Buffers (IBBLOK) se asignan en incrementos discretos de 128 bytes. Los buffers de hasta 8K bytes de longitud se retienen en un grupo IBBLOK para su reutilización, y

los buffers del mismo tamaño se rastrean y se muestran como un grupo. Este valor

indica el tamaño de IBBLOK al que se aplican los siguientes valores de campo.

MTU El datagrama de tamaño máximo que cabe en el buffer. Básicamente, este es el tamaño de datos más 40 bytes para los encabezados.

Free El número de IBBLOK actualmente libres del total para este tamaño en el grupo.

Hits La cantidad de veces que se encontró un IBBLOK libre de este tamaño en el grupo y se

reutilizó.

Misses El número de veces que no se encontró un IBBLOK libre de este tamaño cuando se

solicitó y se asignó memoria. Los IBBLOK superiores a 8K siempre se asignan y liberan.

Notas Use el comando IBBLOK para monitorear y controlar el uso de IBBLOK.

query ibbloks IPN253I << TCP/IP IBBLOK Activity >> IPN896I Counts - Current: 47 Peak: 86 Failed: 0 IPN897I Space - Current: 36k Peak: 109k Max: 51,092k (127%) IPN889I Size: 384 MTU: 64 Free: 24/50 Hits: 4,465 Misses: 24 IPN889I Size: 512 MTU: 192 Free: 4/20 Hits: 569 Misses: 4 IPN889I Size: 640 MTU: 320 Free: 2/20 Hits: 54 Misses: 2 IPN889I Size: 768 MTU: 448 Free: 1/20 Hits: 24 Misses: 1 IPN889I Size: 896 MTU: 576 Free: 1/20 Hits: 12 Misses: 1 IPN889I Size: 1,024 MTU: 704 Free: 2/20 Hits: 20 Misses: 2 IPN889I Size: 1,152 MTU: 832 Free: 1/20 Hits: 32 Misses: 1 IPN889I Size: 1,280 MTU: 960 Free: 3/20 Hits: 32 Misses: 3 IPN889I Size: 1,408 MTU: 1,088 Free: 1/20 Hits: 31 Misses: 1 IPN889I Size: 1,536 MTU: 1,216 Free: 1/20 Hits: 32 Misses: 1

IPN889I Size: 1,664 MTU: 1,344 Free: 1/20 Hits: 7 Misses: 1 IPN889I Size: 1,792 MTU: 1,472 Free: 1/20 Hits: 1 Misses: 1 IPN889I Size: 1,920 MTU: 1,600 Free: 5/5 Hits: 2,892 Misses: 2,679

IPN889I Size: 64K+ MTU: -- Free: 0/0 Hits: 0 Misses: 0

248

Capítulo 3 Descripción de Comandos: QUERY IPSTAT

QUERY IPSTAT

El comando QUERY IPSTAT muestra el contenido de ISBLOK para las

direcciones IP que han accedido a la pila cuando el comando IPSTAT

está en ON (el valor predeterminado). La característica opcional de Firewall Shield usa el contenido de los ISBLOKS.

Sintaxis

Argumentos

Ejemplo

Precaución:

Este comando genera más de 70 líneas de salida para cada dirección IP

(ISBLOK) y podría ejecutarse durante mucho tiempo si hay una gran

cantidad de ISBLOK.

Query IPSTAT [,SYSLST]





query ipstat IPN253I << TCP/IP IP Statistics >> IPN516I .......................... IPN516I IP Address. ......................... 127.0.0.1 IPN516I Performance Information.......................... IPN516I - Overall.................................... IPN516I - TCP Connections ........................ 2 IPN516I - Total Connect Time. ....................... 0 IPN516I - Maximum Turn Around. ....................... 0 IPN516I - Maximum Depth. ......................... 0 IPN516I - Maximum Window. ........................ 0 IPN516I - SWS Mode................................... IPN516I - Time ................................... 0 IPN516I - Count. ................................. 0 IPN516I - Depth Mode................................. IPN516I - Time ................................... 0 IPN516I - Count. ................................. 0 IPN516I - Retransmit Mode............................ IPN516I - Time ................................... 0 IPN516I - Times in Mode. ......................... 0 IPN516I - Count. ................................. 0 IPN516I Application Information.......................... IPN516I - FTP........................................ IPN516I - Connections. ........................... 0 IPN516I - Inbound Files. ......................... 0 IPN516I - Outbound Files. ........................ 0 IPN516I - Inbound File Bytes. ....................... 0 IPN516I - Outbound File Bytes. ....................... 0 IPN516I - HTTP....................................... IPN516I - Connections. ........................... 0

249

Capítulo 3 Descripción de Comandos: QUERY IPSTAT

IPN516I - Inbound Files. ......................... 0 IPN516I - Outbound Files. ........................ 0 IPN516I - Inbound File Bytes. ....................... 0 IPN516I - Outbound File Bytes. ....................... 0 IPN516I - Telnet..................................... IPN516I - Connections. ........................... 0 IPN516I - Inbound Files. ......................... 0 IPN516I - Outbound Files. ........................ 0 IPN516I - Inbound File Bytes. ....................... 0 IPN516I - Outbound File Bytes. ....................... 0 IPN516I Transfer Information.......................... IPN516I - Non IP..................................... IPN516I - Datagrams. ............................. 0 IPN516I - Bytes. ................................. 0 IPN516I - Misdirected IP............................. IPN516I - Datagrams. ............................. 0 IPN516I - Bytes. ................................. 0 IPN516I - ARP Inbound................................ IPN516I - Inbound Datagrams. ....................... 0 IPN516I - Outbound Datagrams. ....................... 0 IPN516I - Inbound Bytes. ......................... 0 IPN516I - Outbound Bytes. ........................ 0 IPN516I - ICMP....................................... IPN516I - Inbound Datagrams. ....................... 0 IPN516I - Outbound Datagrams. ....................... 0 IPN516I - Inbound Bytes. ......................... 0 IPN516I - Outbound Bytes. ........................ 0 IPN516I - IP......................................... IPN516I - Inbound Datagrams. ...................... 19 IPN516I - Outbound Datagrams. ...................... 18 IPN516I - Inbound Bytes. ..................... 7,160 IPN516I - Outbound Bytes. .................... 6,796 IPN516I - TCP........................................ IPN516I - Inbound Datagrams. ...................... 19 IPN516I - Outbound Datagrams. ...................... 18 IPN516I - Inbound Bytes. ..................... 7,160 IPN516I - Outbound Bytes. .................... 6,796 IPN516I - UDP........................................ IPN516I - Inbound Datagrams. ....................... 0 IPN516I - Outbound Datagrams. ....................... 0 IPN516I - Inbound Bytes. ......................... 0 IPN516I - Outbound Bytes. ........................ 0 IPN516I - Refused Data............................... IPN516I - Inbound Datagrams. ....................... 0 IPN516I - Inbound Bytes. ......................... 0


IPSTAT

Controla si se crea un ISBLOK para cada dirección IP que accede a

la pila TCP/IP FOR VSE.

FIREWALL Controla y monitorea la característica opcional de Firewall Shield.

250

Capítulo 3 Descripción de Comandos: QUERY ISTATISTICS

QUERY ISTATISTICS

Sintaxis

Argumentos

Ejemplo


QUERY ISTATISTICS provoca la visualización de estadísticas internas

TCP/IP FOR VSE. TCP/IP FOR VSE mantiene contadores para

proporcionar información sobre cómo funcionan varios procesos internos.

Query ISTATistics [,SYSLST]





QUERY STATISTICS


QUERY OPTIONS


query istatistics IPN253I << TCP/IP Internal Statistics >> IPN516I Total Dispatches. ....................... 4,579 IPN516I - All Bound. .............................. 335

251

Capítulo 3 Descripción de Comandos: QUERY LINKS

QUERY LINKS

Sintaxis

Argumentos

El comando QUERY LINKS muestra el estado de los enlaces TCP/IP a

las diversas redes físicas.

Query LINks [,SYSLST] [,ID=id]



ID= La ID (como se especifica en el comando DEFINE LINK) que

identifica el enlace que se mostrará. Si se omite esta opción, se muestran todos los enlaces.

Ejemplo

Notas




Para dispositivos de tipo LCS, también se muestran todos los adaptadores

asociados con un enlace.

DEFINE ADAPTER


DEFINE LINK

Crea un enlace entre TCP/IP FOR VSE y una red o una pila conectada

directamente.

DELETE LINK

Elimina un enlace entre TCP/IP FOR VSE y una red o una pila conectada directamente.

MTU: 32767 IP Address: 127.0.0.1 Current Status: Active

Type: *Int Dev: (0000,0000) ID: *Internal

ID: LINK3172 Type: OSA2 Dev: (0032,0033) Current Status: Active ID: LINK3172 Type: 802.3 Adapter: 0 MTU: 1500 IP Address: 192.168.1.161 MAC address: 00:00:E2:90:C0:45 Current Status: Active

IPN437I IPN350I IPN440I IPN438I IPN441I IPN350I IPN437I IPN438I IPN350I

query links IPN253I << TCP/IP LINKS >>

252

Capítulo 3 Descripción de Comandos: QUERY LOCKS

QUERY LOCKS

Sintaxis

Argumentos

Ejemplo

El comando QUERY LOCKS muestra información sobre el mecanismo de bloqueo

interno de la pila. Muestra la cantidad de veces que una subtarea se puede pausar

debido a conflictos o como resultado del equilibrio normal de tareas.

Query LOCKs [,SYSLST]





query locks IPN253I << TCP/IP Lock Information >> IPN936I Lock: SOBLOK Requests: 0 Conflicts: 0 IPN936I Lock: TKBLOK Requests: 115 Conflicts: 0 IPN936I Lock: CCBLOK Requests: 9260 Conflicts: 20 IPN936I Lock: LDBLOK Requests: 109 Conflicts: 0 IPN936I Lock: IBBLOK Requests: 3135 Conflicts: 0 IPN936I Lock: FILEIO Requests: 1521 Conflicts: 0 IPN936I Lock: ANBLOK Requests: 0 Conflicts: 0

253

Capítulo 3 Descripción de Comandos: QUERY LOGS

QUERY LOGS

Sintaxis

Argumentos

Ejemplo


Este comando muestra el estado de las diferentes pantallas y registros de

TCP/IP FOR VSE.

Query LOGs [,SYSLST]





DEFINE LOG


MODIFY LOG


query logs IPN253I << TCP/IP Console Logs >> IPT240I CONSOLE on CONSOLE IPT241I Line Length: 65 Lines per page: 0 Timestamp: None IPT242I Total lines: 0 Total pages: 0 IPT243I Logging: Critical Vital Warning Important Info Response Security IPT240I SYSLST on SYSLST IPT241I Line Length: 132 Lines per page: 86 Timestamp: Left IPT242I Total lines: 300 Total pages: 0 IPT243I Logging: Critical Vital Warning Important Info Diag IPT240I SYS007 on SYS007 IPT241I Line Length: 132 Lines per page: 0 Timestamp: None IPT242I Total lines: 44 Total pages: 0 IPT243I Logging: Response Security

254

Capítulo 3 Descripción de Comandos: QUERY LPDS

QUERY LPDS

Sintaxis

Argumentos

El comando QUERY LPDS muestra el estado de los daemons de

Impresión en Línea actualmente.

Query LPds [,SYSLST] [,ID=id]


esta opción, los resultados se envían a SYSLST y a la consola. Este argumento es posicional y debe colocarse inmediatamente después

del comando.

ID= El ID de un daemon de Line Printer, según lo especificado por el comando DEFINE LPD. Si se omite esta palabra clave, se muestran

todos los daemons de Impresión en Línea.

Ejemplo




DEFINE LPD

Crea un daemon de Impresión en Línea.

DELETE LPD

Termina un daemons de Impresión en Línea.

query lpds IPN253I << TCP/IP Line Printer Daemons >> IPN444I Print Name: HEX UserID: $LPD Hexdump Mode IPN445I Queue: POWER.LST.A. IPN446I Library: MEMORY. IPN444I Print Name: LOCAL UserID: $LPD IPN445I Queue: POWER.LST.A.

IPN446I Library: MEMORY.

255

Capítulo 3 Descripción de Comandos: QUERY MASKS

QUERY MASKS

Sintaxis

Argumentos

Ejemplo

Notas


El comando QUERY MASKS muestra el contenido actual de la tabla de

máscara de subred.

Query MASKs [,SYSLST]




Solo se puede especificar una máscara de subred para una red determinada.

Vean la discusón de direcciones IP, mascaras y subredes en la Guía de Instalación TCP/IP FOR VSE.

i no se define una máscara para una red en particular, se usa la máscara

predeterminada (SET MASK=).

DEFINE MASK


DELETE MASK

Elimina una máscara de subred para una red particular.

QUERY ROUTES Muestra el contenido de la tabla de enrutamiento de red o la ruta



256

Capítulo 3 Descripción de Comandos: QUERY MENUS

QUERY MENUS

Sintaxis

Argumentos

Ejemplo


El comando QUERY MENUS muestra los menús actualmente disponibles

para uso de los daemons Telnet.

Query MENus [,SYSLST]



DEFINE MENU

Carga un archivo de menú y lo pone a disposición de los daemons de Telnet.

DEFINE TELNETD

Crea un daemonTN3270 o TN3270E.

DELETE MENU

Elimina un archivo de menú TN3270 de la memoria.

QUERY TELNETDS


query menus IPN253I << TCP/IP Menu Definitions >> IPN391I ID: MENUUSR Member: MENU2 IPN391I ID: MENUADM Member: MENU1

257

Capítulo 3 Descripción de Comandos: QUERY NAMES

QUERY NAMES

Sintaxis

Argumentos

El comando QUERY NAMES muestra el contenido de la tabla de nombres

simbólicos creada por DEFINE NAME (direcciones de solo IPv4).

Query NAMes [,SYSLST] [,TYPe={ALL|STATIC|DYNAMIC}]



TYPe= Especifica un subconjunto de nombres para mostrar:

STATIC Solo se muestran los nombres que se definieron explícitamente con

un comando DEFINE NAME. Este es el valor predeterminado.

DYNAMIC Solo se muestran los nombres que se resolvieron mediante una solicitud DNS y que actualmente están en caché. (Los nombres

agregados por DEFINE NAME no se muestran).

ALL Se muestran las entradas estáticas y dinámicas.

Ejemplo

query names IPN253I << TCP/IP Names >> IPN503I Symbolic Name: AUTOFTP IPN504I Script Name: AUTOFTP IPN503I Symbolic Name: AUTOLPR IPN504I Script Name: AUTOLPR IPN503I Symbolic Name: DEVPUNE IPN504I Script Name: DEVPUNE IPN503I Symbolic Name: DEVPUN IPN504I Script Name: DEVPUN IPN503I Symbolic Name: DEVLST IPN504I Script Name: DEVLST IPN503I Symbolic Name: DELL IPN504I IP Address: 192.168.1.66 IPN503I Symbolic Name: VSE01 IPN504I IP Address: 192.168.1.162 IPN503I Symbolic Name: VSE26 IPN504I IP Address: 192.168.1.161 IPN503I Symbolic Name: VSE IPN504I IP Address: 192.168.1.161

258

Capítulo 3 Descripción de Comandos: QUERY NAMES


DEFINE NAME

Asocia un nombre TCP/IP con una dirección IPvv4 o un archivo de script.

DELETE NAME

Elimina un nombre simbólico TCP/IP de la tabla de nombres creada

por DEFINE NAME.

259

Capítulo 3 Descripción de Comandos: QUERY NTPD

QUERY NTPD

Sintaxis

Argumentos

El comando QUERY NTPD proporciona información sobre un daemon

NTP actualmente en ejecución.

Query NTPd [,SYSLST] [,ID=id]



ID= Especifica la ID del comando DEFINE NTPD que creó el daemon

que desea mostrar. Si se omite esta palabra clave, se muestran todos los daemons NTP.

Ejemplo




DEFINE NTPD

Crea un daemon de Network Time Server.

DELETE NTPD

Termina un daemon de Network Time Server.

query ntpd IPN253I << TCP/IP NTP Daemons >> NTP105I NTP Daemon: ID NTP1 NTP106I Protocol: UDP Port 37 NTP107I Hour correction: +0 Second correction: +0 NTP108I Requests: 0 Last requestor: 0.0.0.0

260

Capítulo 3 Descripción de Comandos: QUERY OPENFILES

QUERY OPENFILES

Sintaxis

Argumentos

Ejemplo

Notas


Este comando muestra una lista de todos los archivos que están abiertos

actualmente en el sistema de archivos de la partición TCP/IP FOR VSE.

Query OPENfiles [,SYSLST]





Si varios procesos están utilizando un archivo, el archivo se muestra varias veces.

CLOSE FILE

Cierra un archivo abierto.

QUERY FILES


IPN432I Public Name: EWF.SAVE.T999.PRINT IPN433I Type: LIBRARY DLBL: EWF Driver: IPNFLIBR IPN577I Mode: Output Record Counter: 2

Output Record Counter: 0 EWF Driver: IPNFLIBR LIBRARY DLBL: IPN433I Type:

IPN577I Mode:

query openfiles IPN576I << TCP/IP Open Files >> IPN432I Public Name: EWF.SAVE.T999.LOG

261

Capítulo 3 Descripción de Comandos: QUERY OPTIONS (or QUERY SET)

QUERY OPTIONS (or QUERY SET)

El comando QUERY OPTIONS enlista la configuración actual de todas

las variables accesibles mediante el comando SET.

Sintaxis

Argumentos

Ejemplo

QUERY SET es sinónimo de QUERY OPTIONS.

Query OPTions [,SYSLST]



query options IPN253I << TCP/IP Current Options >> IPN452I System ID: 00 IPN453I IP Address: 192.168.1.161 Submask: 255.255.255.0 IPN454I Link Retry Time: 1800 IPN458I Console Hold: On Record: Off IPN459I Gateway: Off Isolation: Off IPN804I Telnet translation will use System Default IPN806I Checksum: Software Connect_Sequence: Off IPN806I Downcheck: Off Dynamic_Route: On IPN806I Fixed_Retransmit: Off Full_CETI: On IPN806I Full_Critical: Off Local_DLBL: On IPN806I Ping_Message: On IPN806I Email Separator_Pages: Off IPN806I HTTP Separator_Pages: Off IPN806I LPR Separator_Pages: Off IPN806I FTP Separator_Pages: Off IPN806I SDOpen_Extra: Off Spincheck: On IPN806I Traffic: On Singledest: On IPN806I ARPdelete: Off ARP_Time: 90000 IPN806I Auto_time: 1500 Pulse_Time: 18000 IPN806I Console_Port: 0 IPN806I DNS1: 65.24.7.3 Timeout: 1200 IPN806I DNS3: 65.24.7.6 Timeout: 1200 IPN806I Reuse_Size: 10 IPN806I Window_Depth: 5 IPN806I Default_Domain: IPN806I Separator Page Count: 0 IPN806I FTPBATCH_Fetch: Off IPN806I Subtask_OPEN: Off Stealth mode: Off IPN806I Memory Verification: Off IPN806I Buffer Validation: Off POWERUSERID: SYSTCPIP IPN806I ListIDCAMS: On AutoLoad: On

262

Capítulo 3 Descripción de Comandos: Command Descriptions: QUERY PORTQUEUE

QUERY PORTQUEUE

Sintaxis

Argumentos

Ejemplo

Notas


El comando QUERY PORTQUEUE muestra el estado actual de todos

los puertos donde se están poniendo en fila las conexiones.

Query PORTqueue [,SYSLST]





La puesta en fila de puertos puede establecerse mediante aplicaciones (BSD). El

operador puede anular los valores establecidos por las aplicaciones. Consulte las siguientes referencias para obtener más información.

Guía de Instalación de TCP/IP FOR VSE, capítulo 12,

“Rendimiento”, subsección “Filas de puertos”

Guía del Programador TCP/IP FOR VSE, capítulo 2, "Interfaz

de socket BSD”

PORTQUEUE

Controla cómo se ponen en fila las solicitudes de conexión

entrantes para una aplicación.

QUERY CONNECTIONS


query portqueue IPN253I << TCP/IP Port Queuing >> IPN400I Port: 88 Timeout: 60 sec Limit: 100 IPN401I Queued: 0/0/0 Reject: 0 Good: 0 Lost: 0 IPN402I Avg wait: 0 msec; Avg lost: 0 msec; Int: 5:16.754 IPN403I Partition: FB Phase: IPNET IPN400I Port: 80 Timeout: 60 sec Limit: 100 IPN401I Queued: 0/59/177 Reject: 0 Good: 105 Lost: 72 IPN402I Avg wait: 1,226 msec; Avg lost: 3,209 msec; Int: 5:16.764 IPN403I Partition: FB Phase: IPNET

263

Capítulo 3 Descripción de Comandos: QUERY PRODKEYS

QUERY PRODKEYS

Sintaxis

Argumentos

El comando QUERY PRODKEYS muestra las claves de producto

actualmente en uso.

Query PRODkeys [,SYSLST] [,ALL]



ALL Además de mostrar las claves de producto que están en uso, esta opción

también muestra aquellos productos para los que no tiene una clave válida para la ID de CPU específica indicada en la salida.

Ejemplo 1

Ejemplo 2

Notas


Cuando existen múltiples claves para una característica particular, TCP/IP

FOR VSE selecciona la mejor clave disponible.

QUERY PROGRAMS

Muestra las fases del programa que usa TCP/IP FOR VSE, sus

características, sus ubicaciones de memoria y la librería desde la

que se cargó cada una.

query prodkeys IPN253I << TCP/IP Product Keys >> IPN886I Stack....... (CSI) Expires on 2017/07/15 IPN886I SSL......... (CSI) Expires on 2017/07/15 IPN886I GPS......... (CSI) Expires on 2017/07/15 IPN886I SecureFTP... (CSI) Expires on 2017/07/15

query prodkeys,ALL IPN253I << TCP/IP Product Keys >> IPN885I CPU ID: 01D377 (014377) IPN886I Stack....... (CSI) Expires on 2020/12/31 IPN886I Base........ included in Stack IPN886I Firewall.... not licensed

264

Capítulo 3 Descripción de Comandos: QUERY PROGRAMS

QUERY PROGRAMS

Sintaxis

Argumentos

Ejemplo

El comando QUERY PROGRAMS muestra información sobre las diversas

fases que se utilizan para proporcionar TCP/IP y servicios relacionados.

Query PROGrams [,SYSLST]




query programs IPN253I << TCP/IP Phases and Routines >> IPN636I FTPDAEMN 00604050 02E250 80604050 SYST RENT PRODLIB.PHASE IPN636I IPDSLIBR 005F6050 000958 805F6050 SYST RENT PRODLIB.PHASE IPN636I IPTRLOAD 005103A0 0026F1 00000000 SYST RENT PRODLIB.PHASE IPN636I ASOCKET 00319000 0011A8 80319020 SYS SVA PRODLIB.PHASE IPN636I CLIENTD 00633050 011F78 80633050 0020 PRODLIB.PHASE IPN636I CSOCKET 0361F050 002D98 8361F050 SYS PRODLIB.PHASE IPN636I IOAPPEND 002E60F0 000460 802E60F0 SYS SVA PRODLIB.PHASE IPN636I IPCCSERV 0361A050 002AE8 8361A050 SYS PRODLIB.PHASE IPN636I IPNCICMP 0354A050 001600 8354A050 0013 PRODLIB.PHASE IPN636I IPNCOCMP 03552850 000540 83552850 0014 PRODLIB.PHASE IPN636I IPNETAS 005AD050 000B00 805AD050 SYS PRODLIB.PHASE IPN636I IPNFLIBR 005BC050 016D20 805BC050 PRODLIB.PHASE IPN636I IPNFPOWR 005B2050 009788 005B2050 PRODLIB.PHASE IPN636I IPNFREXX 005D3050 0011E8 805D3050 PRODLIB.PHASE IPN636I IPNIRAW1 03558050 000F50 83558050 0007 PRODLIB.PHASE IPN636I IPNIRAW2 03556050 001848 83556050 0008 PRODLIB.PHASE IPN636I IPNIVFGH 03627050 004A60 83627050 SYS PRODLIB.PHASE IPN636I IPNLIEEE 03549850 0004B0 83549850 0017 PRODLIB.PHASE IPN636I IPNLOEEE 03549050 000450 83549050 0018 PRODLIB.PHASE IPN636I IPNL127 03647850 000680 83647850 0002 PRODLIB.PHASE IPN636I IPNRBSDC 044852D0 014D30 844892B0 SYS SVA PRODLIB.PHASE IPN636I IPNROUTE 03622050 001288 83622050 SYS PRODLIB.PHASE IPN636I IPNTITCP 0354E050 001AD8 8354E050 000F PRODLIB.PHASE IPN636I IPSECURE 00595050 003260 00595050 SYS PRODLIB.PHASE IPN636I LOCKMGRX 0052C050 004AB8 8052C050 SYS PRODLIB.PHASE IPN636I LPD 03559050 00B1A0 83559050 0005 PRODLIB.PHASE IPN636I MSKELIP 03649050 0193E8 83649050 SYS PRODLIB.PHASE IPN636I PRODKEYS 00525850 000310 00525850 SYS PRODLIB.CONFIG IPN636I SOCKPASS 0361D050 001CD8 8361D050 SYS PRODLIB.PHASE IPN636I SOCTRACE 03624050 002E08 83624050 SYS PRODLIB.PHASE IPN636I VERCHECK 00522050 0036A0 00522050 SYS PRODLIB.PHASE


QUERY VERSIONS

Muestra las versiones y los niveles de mantenimiento de los

componentes de la pila.

265

Capítulo 3 Descripción de Comandos: QUERY PUBLISHERS

QUERY PUBLISHERS

Sintaxis

Argumentos

El comando QUERY PUBLISHERS muestra el estado de los

daemons publisher.

Query PUBLishers [,SYSLST] [,ID=id]



ID= El ID del daemon publisher, según lo asignado por el comando DEFINE

PUBLISHER. Si se omite esta palabra clave, se muestran todos los daemon publisher.

Ejemplo




DEFINE PUBLISHER

Crea un daemon publisher.

DELETE PUBLISHER

Termina un daemon publisher.

query publishers IPN694I PUBLISH01 publishing daemon active IPN694I Event-to-action List: IPN694I Event-Item 1 will be passed to ENTRFRSH CSI-FAQS IMOD handler

266

Capítulo 3 Descripción de Comandos: QUERY ROUTES

QUERY ROUTES

Sintaxis

Argumentos

El comando QUERY ROUTES muestra el contenido actual de la

tabla de enrutamiento.

Query ROUTes [,SYSLST] [,ID=id|IPaddr=ip4addr]



ID= El ID de la instrucción de ruta que se mostrará. Si no especifica el

parámetro ID= o el parámetro IPADDR=, se muestran todas las entradas de la tabla de ruta.

IPaddr= Especifica la dirección de red TCP/IP completa que se mostrará. Se

busca en la tabla de enrutamiento y se muestra la primera entrada coincidente. Si no especifica el parámetro ID= o el parámetro

IPADDR=, se muestran todas las entradas de la tabla de ruta.



query routes IPN253I << TCP/IP Routes >> IPN448I ID: *Internal Link ID: *Internal IPN449I IP Address: 127.0.0.0 Mask: 255.0.0.0 IPN450I Net: 127.0.0.0 Subnet: -- Host: -- IPN875I MTU: 32767 Max Seg: 32727 Pulse: 60s IPN876I SYN Retran: 100ms Data Retran: 100ms Fixed: Yes IPN877I Retran Min: 100ms Max: 100ms IPN882I Retry Delay: 100ms Retries 10 IPN884I RWin: 65534 IPN448I ID: *Internal001 Link ID: *Internal IPN449I IP Address: 192.168.1.161 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: 0.0.0.161 IPN875I MTU: 32767 Max Seg: 32727 Pulse: 60s IPN876I SYN Retran: 100ms Data Retran: 100ms Fixed: Yes IPN877I Retran Min: 100ms Max: 100ms IPN882I Retry Delay: 100ms Retries 10 IPN884I RWin: 65534 IPN448I ID: LOCAL Link ID: LINK3172, 0 IPN449I IP Address: 192.168.1.0 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: -- IPN875I MTU: 5040 Max Seg: 5000 Pulse: 60s IPN876I SYN Retran: 1000ms Data Retran: 1000ms Fixed: No

267

Capítulo 3 Descripción de Comandos: QUERY ROUTES

(continuación)

Ejemplo 2

Notas



Puede usar el comando QUERY ROUTES con el parámetro IPADDR para ayudar a determinar qué enlace utiliza TCP/IP FOR VSE para esa

dirección IP. La tabla de enrutamiento se busca en orden y se muestra

la primera entrada coincidente. Este es el mismo algoritmo que utiliza TCP/IP FOR VSE cuando necesita enviar un paquete a la red.

Las rutas cuyas ID comienzan con “*” se generaron automáticamente para

controlar el enrutamiento interno de los datagramas dentro de la pila.

DEFINE MASK


DEFINE ROUTE


IPN877I Retran Min: 500ms Max: 2000ms IPN882I Retry Delay: 500ms Retries 50 IPN884I RWin: 65535 IPN448I ID: DEFAULT Link ID: LINK3172, 0 IPN449I IP Address: 0.0.0.0 Mask: 255.255.255.0 IPN450I Net: -- Subnet: -- Host: -- IPN537I Gateway IP Address: 192.168.1.1 IPN875I MTU: 0 Max Seg: 1400 Pulse: 60s IPN876I SYN Retran: 1000ms Data Retran: 1000ms Fixed: No IPN877I Retran Min: 500ms Max: 2000ms IPN882I Retry Delay: 500ms Retries 50 IPN884I RWin: 65535

query route,ipaddr=192.168.1.66 IPN253I << TCP/IP Routes >> IPN449I IP Address: 192.168.1.66 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: 0.0.0.66 IPN448I ID: LOCAL Link ID: LINK3172, 0 IPN449I IP Address: 192.168.1.0 Mask: 255.255.255.0 IPN450I Net: 192.168.1.0 Subnet: -- Host: -- IPN875I MTU: 5040 Max Seg: 5000 Pulse: 60s IPN876I SYN Retran: 1000ms Data Retran: 1000ms Fixed: No IPN877I Retran Min: 500ms Max: 2000ms IPN882I Retry Delay: 500ms Retries 50 IPN884I RWin: 65535

268

Capítulo 3 Descripción de Comandos: QUERY SECURITY

QUERY SECURITY

Sintaxis

Argumentos

Ejemplo


El comando QUERY SECURITY muestra el estado de seguridad actual

de la partición TCP/IP FOR VSE.

Query SECURity [,SYSLST]





ASECURITY


QUERY USERS


SECURITY


Security Mode: Fail Log: Fail Dump: Fail Disabled Batch Security:

Security Exit: Undefined IPN750I IPN750I IPN752I

FTPD= ICMP=Y IPAV= WEBL= BLOCKIP=Y FTPC= Enabled ARP= Automatic Security:

Undefined Exit data: IP Address Checking: Disabled

Disabled ARP Checking: Security Processing: Enabled IPN750I

IPN750I IPN750I IPN751I IPN750I

query security IPN253I << TCP/IP Security Settings >>

269

Capítulo 3 Descripción de Comandos: QUERY STATISTICS (or QUERY STATS)

QUERY STATISTICS (or QUERY STATS)

El comando QUERY STATISTICS muestra las estadísticas de TCP/IP

FOR VSE. TCP/IP FOR VSE mantiene contadores para volúmenes de

datos y eventos de transferencia. Este comando se emite automáticamente durante el apagado del sistema.

Sintaxis

Argumentos

Ejemplo 1

QUERY STATISTICS también se puede usar para mostrar estadísticas

de controladores de enlace para un adaptador OSA Express. QUERY

STATS es sinónimo de QUERY STATISTICS.

Query STATistics [,SYSLST] [,LINKid=nnnn[,RESET]]


opción, los resultados se envían a SYSLST y a la consola. Este argumento

es posicional y debe colocarse inmediatamente después del comando.

LINKid= Especifica el ID de enlace de un adaptador OSA Express. Esta

opción hace que el comando muestre estadísticas solo para este enlace. La opción RESET restablece los contadores para este enlace

después de que se muestran las estadísticas.

En el Ejemplo 2 se ven estadísticas de muestra para un adaptador OSA Express.

query statistics IPN253I << TCP/IP Operational Statistics >> IPN516I FTP Daemons ................................. 1 IPN516I - Cur. Active. .............................. 0 IPN516I - Max. Active. .............................. 1 IPN516I - Cur. Buffers .............................. 0 IPN516I - Max. Act Buff. ............................ 0 IPN516I Telnet Daemons .............................. 0 IPN516I - Current Active. ........................... 0 IPN516I - Maximum Active. ........................... 0 IPN516I - Current Buffers. .......................... 0 IPN516I - Max Act Buffers. .......................... 0 IPN516I LP Daemons. ................................. 2 IPN516I HTTP Daemons. ............................... 0 IPN516I FTP Sessions. ............................... 2 IPN516I Telnet Sessions. ............................ 0 IPN516I LPR Requests. ............................... 0 IPN516I HTTP Requests. .............................. 0 IPN516I TCP Inbound Reject. ......................... 0 IPN516I FTP Files Sent .............................. 2 IPN516I FTP Files Received. ......................... 0

270


(continuación)

IPN516I FTP File Bytes Sent. ................... 65,001 IPN516I FTP File Bytes Recv. ........................ 0 IPN516I Telnet Bytes Sent. .......................... 0 IPN516I Telnet Bytes Recv. .......................... 0 IPN516I TCP Bytes Sent ......................... 67,659 IPN516I TCP Bytes Received. ..................... 3,054 IPN516I UDP Bytes Sent .............................. 0 IPN516I UDP Bytes Received. ......................... 0 IPN516I IP Bytes Sent. ......................... 78,395 IPN516I IP Bytes Received. ..................... 12,238 IPN516I Storage Releases. ........................... 0 IPN516I Received Blocks. ........................... 43 IPN516I - Inbound Datagrams. ....................... 59 IPN516I - Non-IP. .................................. 4 IPN516I - Miss Routed IP. .......................... 0 IPN516I - Discarded UDP. ........................... 0 IPN516I - Unsupported ICMP. ........................ 0 IPN516I - Unsupported IGMP. ........................ 0 IPN516I - Unsup. Protocol. ......................... 0 IPN516I - Connect Reject. .......................... 0 IPN516I - TCP Checksum Err. ........................ 0 IPN516I - IP Checksum Err. ......................... 0 IPN516I - UDP Checksum Err. ........................ 0 IPN516I - Datagram len Err. ........................ 0 IPN516I - ARPs. .................................... 2 IPN516I - ARP Requests ............................. 0 IPN516I Transmitted Blocks. ....................... 115 IPN516I - Outbound Datagrams. ...................... 94 IPN516I - ARP Requests ............................. 0 IPN516I - ARP Replies. ............................. 1 IPN516I VERCHECK. ................................... 1 IPN516I IPMSSG. ..................................... 1 IPN516I MSKELIP. .................................... 1 IPN516I CLIENTD. .................................... 1 IPN516I IPNAFTP. .................................... 2

271


Ejemplo 2 Los campos clave en este ejemplo se explican en la tabla a continuación.

Campo Explicación (del Manual de Mensajes TCP/IP FOR VSE)

RECEIVED BLOCKS Recuento total recibido.

RECEIVED BYTES Total de bytes recibidos.

RECEIVED BYTES, LARGE Total de bytes recibidos en datagramas mayores a 576 bytes.

RECEIVED BLOCKS, LARGE Total de bloques recibidors mayors a 576 bytes.

SEND BYTES Total de bytes enviados.

SEND BLOCKS Total de bloques enviados.

SEND, FULL BLOCK Total de veces que el adaptador aceptó un bloque e informó que había transferido su buffer.

SEND, BUFFERED Total de veces que el adaptador aceptó un bloque e informó que había sido almacenado en el buffer.

SEND, BUSY Total de veces que el adaptador rechazó un bloque porque todas sus memorias intermedias estaban llenas. Este recuento incluye todos los intentos de reintento.

SEND, MAX BUFFER Máximo de bytes almacenados en buffer antes de enviar el buffer.

SEND, CLEAR Total de veces que el buffer se borró manualmente.

BUSY MODE Total de veces que el adaptador entró en modo ocupado. Este valor se incrementa cada vez que un SEND falla inicialmente porque el

dispositivo estaba ocupado. Estos intentos fallidos se agregaron a

la cadena de datagramas en espera de una transmisión exitosa.

BUSY MODE, LONGEST Mayor número de veces seguidas que el adaptador reportó ocupado.

MSG F3,DATA=QUERY STATS,LINKID=OSA854 AR 0015 1I40I READY F3 0111 0003: IPL613I OSA EXPRESS STATISTICAL SUMMARY FOR LINK OSA854 F3 0111 0003: IPL614I MTU: 1500 INTERVAL: 7:07:43.356 F3 0111 0003: IPL615I RECEIVED BLOCKS. .............. 122,143

F3 0111 0003: IPL615I RECEIVED BYTES. ........... 129,246,830 F3 0111 0003: IPL615I RECEIVED BYTES, LARGE ..... 127,762,068 F3 0111 0003: IPL615I SEND BYTES. ............... 109,642,920

F3 0111 0003: IPL615I SEND BLOCKS. .................. 120,287 F3 0111 0003: IPL615I SEND, FULL BLOCK. ............... 2,930 F3 0111 0003: IPL615I SEND, BUFFERED ................ 116,654 F3 0111 0003: IPL615I SEND, CLEAR. ................... 51,783

F3 0111 0003: IPL615I SEND, BUSY. ....................... 703 F3 0111 0003: IPL615I SEND, MAX BUFFER. .............. 24,000 F3 0111 0003: IPL615I BUSY MODE. .......................... 0 F3 0111 0003: IPL615I BUSY MODE, LONGEST. ................. 0

272



DEFINE LINK

Define los parámetros del enlace.

QUERY ISTATS


273

Capítulo 3 Descripción de Comandos: QUERY STOR

QUERY STOR

Sintaxis

Argumentos

El comando QUERY STOR le permite monitorear el uso del

almacenamiento en la partición TCP/IP. El detalle proporcionado supera

con creces el producido por el comando VSE GETVIS.

Query STOR [,SYSLST] [,SAVe|TRend|MAXimum]

Query STOR [,SYSLST] ,SPid=name [,DUmp={Yes|No}]

SYSLST Los resultados de la consulta se envían sólo a SYSLST. Si se omite esta opción, los resultados se envían a SYSLST y a la consola. Este argumento


SAVe Cuando se especifica, los totales actuales de la pantalla se guardan

para futuras comparaciones.

TRend Cuando se especifica después de un SAVE, los datos mostrados muestran los cambios desde el SAVE.

Los valores que se muestran pueden estar "firmados", lo que indica

un aumento o una disminución en el almacenamiento.

MAXimum Esta opción hace que se muestren los valores más utilizadosa para

cada subpool y valor.

SPid= Especifica una ID de subpool particular. Cuando se especifica, la

pantalla resume cada elemento de almacenamiento en la

subagrupación con nombre. El número de líneas escritas puede ser voluminoso.

DUmp= Controla si los contenidos de las áreas de almacenamiento

especificadas se vuelcan.

Yes

No

Se produce un volcado de almacenamiento formateado. Estos

datos no se muestran en una consola, sino que se enrutan a

archivos de impresora elegibles.

El almacenamiento no se vuelca. Este es el valor predeterminado.

274


Ejemplo 1

Ejemplo 2


explicación de cada mensaje en los ejemplos 1 a 4.

query stor,trend IPN253I << TCP/IP Storage Trends >> IPN921I Map Pages: 10 Subpools: 57 IPN925I -----24 bit---- -----31 bit---- IPN930I SPID Elem Storage Elem Storage Requests IPN922I ARBLOK +0 +0K +2 +0K 0k IPN922I BEGINS +0 +0K +1 +0K 0k IPN922I CCBLOK +0 +0K +13 +172K 0k IPN922I CLBLOK +0 +0K +1 +0K 0k IPN922I COBLOK +1 +0K +1 +0K 0k IPN922I DIBLOK +1 +0K +3 +264K 0k IPN922I DRBLOK +0 +0K +3 +0K 0k IPN922I DWRKAR +1 +0K +1 +8K 0k IPN922I DYSTOR +6 +1K +10 +11K 570k IPN922I EMAIL +0 +0K +1 +0K 0k IPN922I EXTTYP +0 +0K +1 +8K 0k IPN922I FIBLOK +13 +3K +0 +0K 0k IPN922I FTBLOK +1 +0K +0 +0K 0k IPN922I FTBXWK +0 +0K +1 +2K 0k

query stor IPN253I << TCP/IP Current Storage Information >> IPN921I Map Pages: 10 Subpools: 57 IPN925I -----24 bit---- -----31 bit---- IPN930I SPID Elem Storage Elem Storage Requests IPN922I ARBLOK 0 0K 2 1K 0k IPN922I BEGINS 0 0K 1 1K 0k IPN922I CCBLOK 0 0K 13 173K 0k IPN922I CHBLOK 0 0K 0 0K 0k IPN922I CLBLOK 0 0K 1 1K 0k IPN922I COBLOK 1 1K 1 1K 0k IPN922I DIBLOK 1 1K 3 265K 0k IPN922I DRBLOK 0 0K 3 1K 0k IPN922I DWRKAR 1 1K 1 8K 0k IPN922I DYNAM 0 0K 0 0K 0k

275


Ejemplo 3

Ejemplo 4

query stor,spid=rtblok IPN253I << TCP/IP Storage Information >> IPN926I Address: 5D7000 Length: D8 IPN927I Macid: IPNET15 Locate: 805593BE IPN928I Usage: ID: IPN929I Allocated at: 09/24/2016 14:28:41 IPN926I Address: 5D7100 Length: D8 IPN927I Macid: IPNET15 Locate: 805593BE IPN928I Usage: ID: IPN929I Allocated at: 09/24/2016 14:28:41

query stor,spid=rtblok,dump=yes IPN253I << TCP/IP Storage Information >> IPN926I Address: 5D7000 Length: D8 IPN927I Macid: IPNET15 Locate: 805593BE IPN928I Usage: ID: IPN929I Allocated at: 09/24/2016 14:28:41 IPN861I Storage Dump Storage Dump, SPID=RTBLOK 005D7000 000000 D9E3C2D3 D6D20000 5CC995A3 85999581 *RTBLOK..*Interna|........\ ...... * 005D7010 000010 93404040 40404040 005D7100 40404040 *l .).. |.@@@@@@@.|q.@@@@* 005D7020 000020 40404040 40404040 40404040 40404040 * |@@@@@@@@@@@@@@@@*

Line(s) 005D7030 (000030) through 005D704F (00004F) same as above 005D7050 000050 40404040 40404040 40404040 7F000000 * "...|@@@@@@@@@@@@ ... * 005D7060 000060 00000000 5CC995A3 85999581 93404040 *....*Internal |....\ ....... @@@* 005D7070 000070 40404040 005D5000 00000000 00000000 * .)&.........|@@@@.|P. ....... * 005D7080 000080 00000000 00000000 7F000000 00007FFF *........".....".|. .............. * 005D7090 000090 00007FD7 00000064 00000064 80000000 *.."P............|.......d...d ... * 005D70A0 0000A0 00000064 00000064 0000000A 0000003C *................|...d...d ...... <* 005D70B0 0000B0 0000FFFE 00000064 D5000000 7F000000 *........N..."...|.......d ....... * 005D70C0 0000C0 B22C41E0 00000000 00000000 00000000 *...\............|.,A. ........... * 005D70D0 0000D0 00000000 00000000 *........ | ...... @@@@@@@@*

276

Capítulo 3 Descripción de Comandos: QUERY TASKS

QUERY TASKS

Sintaxis

El comando QUERY TASKS muestra las pseudo tareas actualmente activas.

Todo el trabajo realizado por TCP/IP FOR VSE se asigna a pseudo tareas

internas. Las pseudo tareas son similares a las verdaderas tareas de VSE, pero son controladas y despachadas por el motor TCP/IP FOR VSE.

Query TASKs [,SYSLST] [,ID=hexnum|NAMe=name]

[,EXTended]

Argumentos SYSLST Los resultados de la consulta se envían sólo a SYSLST. Si se omite esta opción, los resultados se envían a SYSLST y a la consola. Este argumento


ID= Sólo se muestra la pseudo tarea con el número de tarea especificado.

NAMe= Se muestran todas las pseudo tareas que ejecutan la fase nombrada.

EXTended Úselo cuando lo solicite el Soporte Técnico de CSI. Muestra

información extendida sobre tareas como el número total de IBBLOKS; el almacenamiento de buses en fila; si una tarea es despachable; BCE en

espera y “BCE reales”; y temporizadores en ejecusión. Esta información

sólo es útil para el Soporte Técnico de CSI.



query tasks IPN253I << TCP/IP Pseudo Tasks >> IPN468I 0000: DRIVER D: 0 000000

IPN468I 0002: IPNL127 D: 349 000132 IPNL127 IPN468I 0004: FTPDAEMN D: 5 0064B6 FTPDAEMN IPN468I 0005: LPD D: 1 0005A6 LPD IPN468I 0006: IPNLRAWX D: 133 000132 IPNLRAWX IPN468I 0007: IPNIRAW1 D: 415 0004BA IPNIRAW1 IPN468I 0008: IPNIRAW2 D: 1 00092A IPNIRAW2 IPN468I 0009: IPNIIIP D: 415 000498 IPNIIIP IPN468I 000A: IPNIOIP D: 433 00088C IPNIOIP IPN468I 000B: IPNIPRE1 D: 433 000270 IPNIPRE1 IPN468I 000C: IPNIPRE2 D: 433 000A76 IPNIPRE2 IPN468I 000D: IPNIGARB D: 1,277 00021E IPNIGARB IPN468I 0002: IPNL127 D: 349 000132 IPNL127 IPN468I 0004: FTPDAEMN D: 5 0064B6 FTPDAEMN IPN468I 0005: LPD D: 1 0005A6 LPD IPN468I 000E: IPNIARP D: 6 00020C IPNIARP

(continúa)

277

Capítulo 3 Descripción de Comandos: QUERY TASKS

IPN468I 000F: IPNTITCP D: 410 000E9A IPNTITCP IPN468I 0010: IPNTOTCP D: 428 00041C IPNTOTCP IPN468I 0011: IPNUIUDP D: 1 000716 IPNUIUDP IPN468I 0012: IPNUOUDP D: 1 0002F4 IPNUOUDP IPN468I 0013: IPNCICMP D: 6 000838 IPNCICMP IPN468I 0014: IPNCOCMP D: 6 00037C IPNCOCMP IPN468I 0015: IPNGIGMP D: 1 00034E IPNGIGMP IPN468I 0016: IPNGOGMP D: 1 000222 IPNGOGMP IPN468I 0017: IPNLIEEE D: 1 0002E6 IPNLIEEE IPN468I 0018: IPNLOEEE D: 1 00028C IPNLOEEE IPN468I 001F: IPNTYTCP D: 1 006AF6 IPNTYTCP IPN468I 0020: IPNLOSA2 D: 223 000402 IPNLOSA2 IPN468I 0025: CLIENTD D: 15,252 00060A CLIENTD IPN468I 0045: FTPX1000 D: 1 00213A FTPDAEMN IPN468I 0046: IPNTYTCP D: 1 006AF6 IPNTYTCP

Ejemplo 2

Ejemplo 3


RESUME

Reanuda el procesamiento de una pseudo tarea suspendida.

SUSPEND

Detiene el procesamiento por una pseudo tarea..

query tasks,name=ipntytcp IPN253I << TCP/IP Pseudo Tasks >> IPN468I 001F: IPNTYTCP D: 1 006AF6 IPNTYTCP IPN468I 0046: IPNTYTCP D: 1 006AF6 IPNTYTCP

ECB: 8066500C Content: 813DDC00

0 000000 1 000132 IPNL127

0000: DRIVER D: 0002: IPNL127 D:

IPN468I IPN468I IPN471I

QUERY TASKS,EXT IPN253I << TCP/IP Pseudo Tasks >>

278

Capítulo 3 Descripción de Comandos: QUERY TELNETDS

QUERY TELNETDS

Sintaxis

Argumentos

El comando QUERY TELNETDS muestra los daemons Telnet definidos

actualmente.

Query TELnetds [,SYSLST] [,ID=name]



ID= Especifica la ID del comando DEFINE TELNETD que creó el daemon

que desea mostrar. Si se omite, se muestran todos los daemons de Telnet.

Ejemplo




DEFINE TELNETD


DELETE TELNETD

Termina un daemon TN3270 o TN3270E.

query telnetds,id=cf42 IPN469I << TCP/IP TELNET Daemons >> IPN470I ID: CF42 IPN471I Terminal: TELNLU42 Target: PRODCICS IPN472I Port: 1042 Driver: TELNETD IPN473I Menu: IPN549I Logmode2: S3270 Logmode3: D4B32783 IPN356I Logmode4: D4B32784 Logmode5: D4B32785 IPN350I Current Status: Inactive

query telnetds,id=lu05 IPN469I << TCP/IP TELNET Daemons >> IPN470I ID: LU05 IPN471I Terminal: TELNLG05 Target: DBDCCICS IPN472I Port: 23 Driver: TELNETD IPN473I Menu: IPN549I Logmode2: S3270 Logmode3: D4B32783 IPN356I Logmode4: D4B32784 Logmode5: D4B32785 IPN350I Current Status: Active IPN351I Current IPaddr: 192.168.0.2 IPN352I Current Applid: DBDCCICS IPN354I Current Logmod: S3270

279

Capítulo 3 Descripción de Comandos: QUERY TLSDS

QUERY TLSDS

Sintaxis

Argumentos

El comando QUERY TLSDS muestra el estado de los daemons SSL/TLS.

Query TLSDs [,SYSLST] [,ID=id]


opción, los resultados se envían a SYSLST y a la consola. Este argumento


ID= Especifica el ID del daemon TLS asignado por el comando DEFINE

TLSD. Si se omite esta opción, se muestran todos los daemons TLS.

Ejemplo


DEFINE TLSD

Crea un daemon SSL/TLS.

query tlsd IPN253I << TCP/IP TLS Daemons >> IPN617I ID: TLS01 Cipher: 08090A2F35 IPN618I Port: 992 Passport: 992 Type: Server IPN619I Driver: SSLD Minimum version: 0300

280

Capítulo 3 Descripción de Comandos: QUERY TRACES

QUERY TRACES

Sintaxis

Argumentos

Ejemplo

Notas


El comando QUERY TRACES lista todos los rastreos actualmente activos.

Query TRACes [,SYSLST]





Todos los rastreos listados por el comando QUERY TRACES están en progreso y están acumulando almacenamiento.

DEFINE SOTRACE


DEFINE TRACE


DELETE TRACE

Termina un rastreo y libera su almacenamiento.

DUMP


query traces IPN253I << TCP/IP Traces >> IPN534I ID: TRACE1 Type: IBBLOK Kind: TCP IPN374I Count: 51 Max: 500 IP: 192.168.1.66 Port: 0 Num: 0 IPN534I ID: TRACE2 Type: Socket Kind: ALL Scope: All IPN374I Count: 107 Max: 500 IP: 0.0.0.0 Port: 0 Num: 0

281

Capítulo 3 Descripción de Comandos: QUERY TRANSLATIONS

QUERY TRANSLATIONS

Sintaxis

Argumentos

Ejemplo


El comando QUERY TRANSLATIONS muestra las tablas de traducción

disponibles actualmente y las opciones relacionadas.

Query TRANslations [,SYSLST]



DEFINE TRANSLATION



Establece el nombre de la tabla de traducción que se usará con las

conexiones Telnet (no TN3270).

query trans IPN253I << TCP/IP Translate Tables >> IPN542I SYSTEM IPN542I US_ENG_03 IPN542I OS_02 (Default)

282

Capítulo 3 Descripción de Comandos: QUERY TRUSTED

QUERY TRUSTED

Sintaxis

Argumentos

Ejemplo


El comando QUERY TRUSTED muestra una lista de direcciones IP

que se han marcado como “de confianza”.

Query TRUSted [,SYSLST]



TRUST

Establece que una dirección IP es confiable y que se debe ignorar

la actividad sospechosa.

query trusted IPN253I << TCP/IP Trusted IP Addresses >> IPN127I 192.168.1.66 IPN127I 192.168.1.1 12.182.34.168

283

Capítulo 3 Descripción de Comandos: QUERY USERS

QUERY USERS

Sintaxis

Argumentos

Ejemplo


El comando QUERY USERS enlista el contenido de la tabla de ID de

usuario. Esta tabla se construye utilizando el comando DEFINE USER.

Query USERs [,SYSLST] [,NAMe=name]



NAMe= Muestra una entrada específica basada en la ID de usuario. Las ID de usuario no distinguen entre mayúsculas y minúsculas. Si más de una

entrada coincide con la ID de usuario (es decir, si hay una entrada

duplicada), se muestran todas las entradas coincidentes. El procesador de seguridad reconoce sólo la primera entrada.

DEFINE USER


DELETE USER


query users IPN253I << TCP/IP User IDs >> IPN475I User ID: TBDBITL IPN883I Valid for: Web IPN475I User ID: UPLOAD IPN883I Valid for: *All* IPN475I User ID: GUEST IPN883I Valid for: *All* IPN475I User ID: AUTOFTP IPN883I Valid for: FTP, LPR IPN475I User ID: EWF IPN883I Valid for: FTP, LPR, Web, Telnet

284

Capítulo 3 Descripción de Comandos: QUERY VERSIONS

QUERY VERSIONS

Sintaxis

Argumentos

Ejemplo

El comando QUERY VERSIONS muestra la versión actual y el nivel de

mantenimiento de todas las fases TCP/IP FOR VSE.

Query VERsions [,SYSLST]



query versions IPN253I << TCP/IP Version Information >> IPN209I Service Pack F (APAR PK33472) has been applied. Pack status is GA IPN115I Fixes applied: 002, 003, 006 (Test), 008 (Test), 009 (Test), 103, 105 IPN115I Fixes applied: 106, 109, 114, 115, 116, 118, 122, 123, 128, 133, 134 IPN115I Fixes applied: 135, 143, 144, 145, 146, 147, 148, 149, 150, 152, 154 IPN115I Fixes applied: 155, 159, 160, 163, 164, 165, 172, 174, 177, 178, 179 IPN115I Fixes applied: 180, 185, 186, 188, 189, 191, 192, 193, 195, 196, 197 IPN115I Fixes applied: 198, 211, 213, 218, 220, 235, 238, 240, 254, 257, 261 IPN115I Fixes applied: 263, 265, 266, 273, 274, 276, 278, 279, 281, 282, 283 IPN115I Fixes applied: 285, 286, 289, 290, 291, 292, 295, 296, 297, 298, 303 IPN115I Fixes applied: 332, 341, 342, 349, 354, 362, 366, 384, 391, 396, 397 IPN115I Fixes applied: 399, 502, 504, 506, 507, 509, 510, 511, 512, 513, 517

IPN115I Fixes applied: 519, 520, 521, ASOCKET at ZP15F172, CLIENTD at ZP15F512 IPN115I Fixes applied: CMDEXEC at ZP15F188, CSOCKET at ZP15F148, FTPDAEMN at ZP15F366 IPN115I Fixes applied: IPDRIVER at ZP15F114, IPMSSG at ZP15F177, IPNADNSC at ZP15F509 IPN115I Fixes applied: IPNAFTPC at ZP15F292, IPNET at ZP15F114, IPNFPOWR at ZP15F504 IPN115I Fixes applied: IPNIGARB at ZP15F114, IPNLRAWX at ZP15F009 IPN115I Fixes applied: IPNRBSDC at ZP15F286, IPNTYTCP at ZP15F192 IPN115I Fixes applied: IPNUIUDP at ZP15F145, IPSERVIB at ZP15F257 IPN115I Fixes applied: MSKELIP at ZP15F174 IPN111I ASOCKET 01.05 F 02/19/08 09.49 ZP15F172 IPN111I CLIENTD 01.05 F 02/19/08 09.50 ZP15F512 IPN111I CMDEXEC 01.05 F 03/03/08 08.07 ZP15F188 IPN111I CMDPARS 01.05 F 03/01/08 10.10 IPN111I CMDSTASK 01.05 F 02/29/08 10.38 IPN111I CSOCKET 01.05 F 03/02/08 23.58 ZP15F148 IPN111I FTPDAEMN 01.05 F 02/29/08 09.58 ZP15F366 . . . IPN111I IPSPINCP 01.05 F 02/25/08 21.24 IPN111I IPSTORX 01.05 F 02/19/08 10.10 IPN111I LOCKMGRX 01.05 F 04/19/07 21.17 IPN111I LPD 01.05 F 02/19/08 10.10 IPN111I MSKELIP 01.05 F 03/02/08 23.58 ZP15F174 IPN111I SOCKPASS 01.05 F 02/21/08 00.26 IPN111I SOCTRACE 01.05 F 02/11/08 11.26 IPN111I VERCHECK 01.05 F 03/03/08 22.56


QUERY PROGRAMS

Muestra las fases del programa que usa TCP/IP, sus características, sus

ubicaciones de memoria y la librería desde la que se cargó cada una.

285

Capítulo 3 Descripción de Comandos: QUIESCE

QUIESCE

Sintaxis

Argumentos

El comando QUIECE deshabilita el procesamiento de la aplicación al

evitar nuevas conexiones. Las conexiones existentes no se alteran.

QUIESce {ON|Off}

ON Cuando QUIESCE ON está en vigor, la pila rechaza las solicitudes

para establecer nuevas conexiones; sin embargo, las conexiones existentes continúan funcionando normalmente.

Off Cuando se emite QUIESCE OFF, se reanuda el procesamiento normal.

Ejemplo

Notas


Cuando QUIESCE ON está en vigor, las aplicaciones que emiten

solicitudes de socket OPEN son notificadas de un “apagado del

sistema”, y las solicitudes de conexión entrantes se rechazan con un RESET. Dependiendo del host y la aplicación, puede que no sea

posible simplemente reanudar el procesamiento.

Siempre que exista una condición QUIESCE ON, una pantalla de consola periódica muestra automáticamente el progreso realizado

hacia el estado inactivo. Esta pantalla incluye un recuento de

conexiones activas por número de puerto local. Una vez que el

sistema está inactivo, se emite un mensaje de “queja” hasta que se especifique QUIESCE OFF o se cierre TCP/IP FOR VSE.

quiesce on IPN225I TCP/IP quiescing; connection requests are rejected ... IPI515I TCP/IP Stack QUIESCE progress IPI516I 1 connections active on port 21 IPI516I 4 connections active on port 23 ... IPI515I TCP/IP Stack QUIESCE progress IPI516I 2 connections active on port 23 ... IPI517I TCP/IP processing has been quiesced quiesce off IPN226I TCP/IP QUIESCE is canceled. Normal processing resumes.

286

Capítulo 3 Descripción de Comandos: QUIESCE


QUERY CONNECTIONS

Muestra el estado de una o más conexiones

QUERY TASKS


SHUTDOWN

Termina el procesamiento y cierra la pila.

287

Capítulo 3 Descripción de Comandos: RAPTRAC

RAPTRAC

Sintaxis

Argumentos

Ejemplo

Notas

El comando RAPTRAC se usa para registrar eventos significativos que ocurren durante

el procesamiento TCP/IP. Su resultado puede ayudar a diagnosticar problemas.

RAPTRAC {START|REPORT|STOP}

START Habilita el seguimiento de eventos significativos según la configuración

contenida en la fase IPDSEVTB.

REPORT Imprime una sola línea en SYSLST para cada evento capturado desde los buffers de eventos actuales. Los mensajes se emiten en orden

cronológico.

STOP Inhabilita la recopilación de datos de eventos.


La salida de RAPTRAC consta de diagnósticos internos CSI. Utilice

este comando sólo cuando lo solicite el Soporte Técnico de CSI para

solucionar un problema.

Este comando requiere aproximadamente 512K de almacenamiento

GETVIS de partición adicional de 31 bits en la partición TCP/IP.

La fase predeterminada IPDSEVTB está configurada para registrar todos los eventos. El Soporte Técnico de CSI puede proporcionar un

IPDSEVTB personalizado que sea específico para el problema que se

está investigando. La configuración personalizada también puede hacer que el informe RAPTRAC se produzca automáticamente

cuando se produce un evento específico.

El cliente FTP por lotes externo (FTPBATCH) también puede usar

eventos, pero requiere diferentes comandos (SET DIAGNOSE

EVENTS y STATUS EVENTS). Consulte la Guía del Usuario de

TCP/IP FOR VSE para obtener más información.

raptrac start IPN694I RapTrac started

288

Capítulo 3 Descripción de Comandos: RAPTRAC

Los comandos DIAGNOSE se usan normalmente para capturar

continuamente información relacionada con una función específica, pero los mensajes voluminosos emitidos a SYSLOG y SYSLST pueden no

estar relacionados con el problema experimentado en el sitio del cliente.

Estos mensajes adicionales pueden degradar el rendimiento general del sistema y ofuscar el problema real que se analiza. Puede ser más eficiente

capturar datos de problemas usando RAPTRAC porque reúne eventos

continuamente y luego genera líneas de datos (un REPORT) en

secuencia cronológica que revela las interacciones entre múltiples procesos cuando ocurrió el problema. Se pueden identificar y analizar las

miles de interacciones que pueden ocurrir en menos de un segundo.


DIAGNOSE Habilita los mensajes de diagnóstico.

QUERY DIAGNOSE

Muestra la configuración de diagnóstico vigente.

289

Capítulo 3 Descripción de Comandos: RECORD

RECORD

Sintaxis

Argumentos

El comando RECORD controla el registro de información sobre

pseudo tareas internas de TCP/IP FOR VSE.

RECord {ON|OFF}

ON Se escribe un registro de finalización en SYSLST después de la

finalización de cada pseudo tarea.

OFF No se escribe información cuando se completa una pseudo tarea.


Ejemplo

Notas



El formato de los datos que se graban está sujeto a cambios con

cada lanzamiento de TCP/IP FOR VSE.

La grabación se realiza mediante el mensaje IPN878I. Ver el

Manual de Mensajes TCP/IP FOR VSE para el formato de este mensaje.

QUERY OPTIONS

Muestra los valores actuales de los parámetros modificables..

record off IPN268I RECORD now set to OFF

290

Capítulo 3 Descripción de Comandos: REDEFINE

REDEFINE

Sintaxis

Argumentos

El comando REDEFINE vuelve a emitir un comando DEFINE sin requerir

que se vuelvan a ingresar sus parámetros.

REDefine START

REDefine type ,id [,parameters]

START REDEFINE está inactivo hasta que se inicia. Esto significa que no se

almacenan comandos y no se consume almacenamiento de 31 bits.

Sólo el comando REDEFINE puede hacer referencia a los comandos

DEFINE ingresados después de emitir REDEFINE START.

Si desea usar REDEFINE, coloque un comando REDEFINE

START en su paquete de inicialización antes del primer DEFINE que desea almacenar.

type El tipo de daemon que se redefinirá.

GPSd Un daemon GPS se redefinirá.

TELnetd Un daemon Telner será redefinido. Vea la nota, enseguida, del parámetro COUNT=.

FTPd Un daemon FTP será redefinido.

HTTpd Un daemon HTTP será redefinido.

id Este es el valor codificado para ID= en el comando DEFINE original.

parameters Cuando emite un comando REDEFINE, todos los valores de los

parámetros son predeterminados a los utilizados en el DEFINE emitido por última vez para el daemon particular identificado por su

id. Puede anular cualquiera o todos los parámetros, incluido ID=. Si

anula ID=, se inicia un “nuevo” daemon.

291

Capítulo 3 Descripción de Comandos: REDEFINE

Ejemplo

Notas



Si usó el parámetro COUNT= para definir múltiples daemons con un

sólo comando DEFINE, sólo se almacenó este comando. Aunque no puede eliminar y redefinir un daemon creado así, puede hacer

referencia al comando DEFINE original utilizando ID= para hacer

referencia al patrón.

Después de que un daemon usa REDEFINE, cualquier alteración de

parámetros se almacena y se utiliza para el próximo REDEFINE del

mismo daemon.

Si modifica el parámetro ID= para definir un daemon diferente, los parámetros vigentes se almacenan para un futuro REDEFINE

del nuevo daemon. El “patrón” original no se ve afectado.

DEFINE FTPD


DEFINE GPSD

Crea un daemon de servidor de Impresión General.

DEFINE HTTPD Crea un daemon del Protocolo de Transferencia de Hipertexto (servidor web).

DEFINE TELNETD

Crea un daemon TN3270 o TN3270E..

define gpsd,id=gps1,storage=gps.save,ipaddr=rmt1,printer=prt1 GPS900I GPS1 GPS Daemon Starting GPS917I GPS1 Waiting for BIND GPS922I GPS1 GPS Shutting down GPS924I GPS1 GPS Shutdown complete redefine gps,gps1 GPS900I GPS1 GPS Daemon Starting GPS917I GPS1 Waiting for BIND

292

Capítulo 3 Descripción de Comandos: RELOAD

RELOAD

Sintaxis

Argumentos

Ejemplo

Notas

El comando RELOAD actualiza las tablas internas sin la necesidad de

realizar un ciclo de la partición de la pila. Puede usarse para recargar

miembros de la librería que se mantienen en almacenamiento.

RELOad {EXTtypes|HACKlist|TERMtypes}

EXTtypes La tabla Tipos Externos se volverá a cargar desde EXTTYPES.L

HACKlist La tabla "Hack List" se volverá a cargar desde HTTPHACK.L

TERMtypes La tabla Tipos de Terminales se volverá a cargar desde TERMTYPE.L


El daemon HTTP utiliza la tabla Hack List para identificar los intentos de

hackeo al sistema. Esto se hace mediante la identificación de ciertas “solicitudes” clave que nunca se enviarían a un servidor basado en VSE.

Dichas solicitudes indican que el solicitante está realizando exploraciones

aleatorias para localizar a una víctima. Examine el contenido del miembro HTTPHACK.L distribuido para obtener detalles sobre cómo agregar o

quitar cadenas de clave.

La tabla Tipos Externos es utilizada por los daemons HTTP y FTP y el

cliente de correo electrónico para determinar las características del

archivo. Se logra haciendo coincidir la extensión del nombre del archivo con una entrada de tipo archivo en la tabla. Cada tipo de archivo se

asigna a un tipo de transferencia FTP con valores de transferencia

predeterminados (como BLKSIZE). Cada entrada también se asigna a

un tipo de contenido MIME. La información sobre cómo modificar esta tabla se encuentra en el miembro EXTTYPES.L distribuido y en la

Guía de Instalación de TCP/IP FOR VSE (capítulo 6, “Configuración

de clientes y daemon FTP”).

reload exttypes IPA617I Processing EXTTYPES.L load request IPA616I External types table has been loaded.

reload hacklist IPA617I Processing HTTPHACK.L load request IPA616I Hacker-Attack table has been loaded.

reload termtypes IPA617I Processing TERMTYPE.L load request IPA616I Terminal Types Table has been loaded.

293

Capítulo 3 Descripción de Comandos: RELOAD

La tabla Tipos de terminal se utiliza para asignar nombres de tipo

de terminal (tal como los presenta un cliente TN3270E) a un modo de registro VTAM apropiado. Para obtener más información,

consulte al miembro de TERMTYPE.L.


DEFINE FTPD


DEFINE HTTPD

Crea un daemon del Protocolo de Transferencia de Hipertexto (servidor

web).

DEFINE TELNETD


294

Capítulo 3 Descripción de Comandos: RESUME

RESUME

Sintaxis

Argumentos

Ejemplo


El comando RESUME se utiliza para reanudar la ejecución de una pseudo

tarea que se ha suspendido mediante el comando SUSPEND.

RESume tasknum

tasknum Especifica el número hexadecimal de la taare que se reanudará.

QUERY TASKS


SUSPEND

Detiene el procesamiento de pseudo tareas.

resume 000d IPN477I Task 000D has resumed in phase IPNIGARB. Disp: 3,855

295

Capítulo 3 Descripción de Comandos: SDOPEN_EXTRA

SDOPEN_EXTRA

El comando SDOPEN_EXTRA hace que TCP/IP FOR VSE verifique si un

archivo de disco secuencial (SD) ha sido abierto correctamente por el

administrador de archivos SD de un sitio antes de permitir que se transfiera. Si el administrador de archivos SD no puede preparar correctamente (“abrir

previamente”) el archivo, TCP/IP FOR VSE no intentará transferirlo.

Sintaxis

Argumentos

Este comando sólo debe ser utilizado por sitios que hayan encontrado problemas

al enviar cada archivo SD controlado por su software de administrador de disco. De lo contrario, debe establecerse en su valor predeterminado (OFF).

SDOPEN_EXTRA {ON|OFF}

ON El estado abierto de un archivo SD se verifica antes de transferirlo.

OFF El estado de un archivo SD no se verifica antes de transferirlo. Este


Ejemplo

SDOPEN_EXTRA ON IPN268I SDOPEN now set to ON

296

Capítulo 3 Descripción de Comandos: SECURITY

SECURITY

Sintaxis

Argumentos

El comando SECURITY controla qué seguridad, si la hay, se proporciona

para el acceso TCP/IP FOR VSE.

SECURity [ON|OFF] [,BATCH={ON|OFF}] [,PHASE=member]

[,XDATA=string] [,ADATA=string]

[,ASMDATE=string] [,ASMTIME=string]

[,VERSION=string] [,AUTO={ON|OFF}]

[,EXIT={ON|OFF}] [,ARP={ON|OFF}]

[,MODE={WARN|FAIL}] [,LOGGING={ALL|FAIL|NONE}]

[,DUMP=ALL|FAIL|NONE}] [,LOCK]

ON El procesamiento de seguridad está habilitado globalmente

OFF El procesamiento de seguridad está deshabilitado globalmente.

Precaución: tenga mucho cuidado con esta opción.

BATCH= Este parámetro controla si el procesamiento FTPBATCH estará bajo el control del procesamiento de seguridad de la pila, incluidas las

solicitudes a las salidas de seguridad. Esto evita el uso de

FTPBATCH como una forma conveniente de eludir la seguridad.

ON El procesamiento de seguridad está habilitado para FTPBATCH.

OFF El procesamiento de seguridad está deshabilitado para FTPBATCH.

PHASE= Especifica el nombre de una salida de seguridad opcional suministrada por

la instalación. Este valor proporciona sólo el nombre de la fase. La fase no se carga, ni se verifica su existencia hasta que se especifica EXIT=ON.

XDATA= Especifica una cadena de caracteres de 40 bytes que se pasará a la salida

de seguridad suministrada por la instalación cada vez que se solicite.

ADATA= Especifica una cadena de caracteres de 40 bytes que se pasará a la salida

de seguridad automática cada vez que se solicita.

ASMDATE= Especifica una cadena de caracteres de 1 a 8 bytes para compararla con

la fecha de ensamblaje de la salida de seguridad suministrada por la

instalación. Esto se puede utilizar para garantizar que la salida no haya sido manipulada.

297


ASMTIME= Especifica una cadena de caracteres de 1 a 8 bytes para comparar con el tiempo de ensamblaje de la salida de seguridad suministrada por la

instalación. Esto se puede utilizar para garantizar que la salida no haya

sido manipulada.

VERSION= Especifica una cadena de caracteres de 1 a 8 bytes para comparar con el número de versión de la salida de seguridad suministrada por la

instalación. Esto se puede utilizar para garantizar que la salida no haya

sido manipulada.

AUTO= Este parámetro controla si la Salida de Seguridad Automática está habilitada.

ON La seguridad automática está habilitada.

OFF La seguridad automática está deshabilitada.

EXIT= Este parámetro controla la carga y habilitación de la salida de seguridad

suministrada por la instalación.

ON La salida de seguridad suministrada por la instalación se carga y

se solicita su rutina de inicialización.

OFF Se solicita la rutina de finalización de la salida de seguridad

suministrada por la instalación y la salida se retira del

almacenamiento.

ARP= Este parámetro controla si las solicitudes ARP se examinan antes de ser procesadas. Esto podría ser útil si existe preocupación sobre el acceso

no autorizado o el enrutamiento incorrecto de los datos en el segmento

de red local.

ON Las solicitudes ARP se pasan a la salida de seguridad automática

(si está habilitada) y a la salida de seguridad suministrada por la instalación (si está habilitada) para su validación.

OFF Las solicitudes ARP no son revisadas.

298


MODE= Este parámetro determina el nivel de respuesta a las violaciones de seguridad.

WARN Las fallas de seguridad se tratan como advertencias y todas las solicitudes pueden completarse. Esto es útil para probar las reglas

de seguridad antes de aplicarlas.

FAIL Las fallas de seguridad provocan que se deniegue la acción solicitada.

LOGGING= Las solicitudes de seguridad pueden registrarse mínimamente,

agresivamente, o no registrarse en absoluto.

ALL Todas las solicitudes de seguridad están registradas.

FAIL Las solicitudes de seguridad que fallan son registradas.

None Las solicitudes de seguridad no se registran a menos que la salida

de seguridad indique explícitamente que debe ocurrir el registro.

DUMP= Security eXit BLOcK (SXBLOK) contiene toda la información sobre

una solicitud de validación de seguridad en particular. Es creado por el

proceso que requiere autorización y se pasa a todos los procesos y salidas de validación. Una vez completado, el SXBLOK contiene

información que permite o impide la operación en cuestión. Este

parámetro le permite volcar una copia de una solicitud de seguridad

fallida, ya sea para iniciar sesión o para fines de depuración.

ALL El SXBLOK de solicitudes de seguridad fallidas se descarta

independientemente del modo WARN o FAIL.

FAIL El SXBLOK de solicitudes de seguridad fallidas es volcado.

None Los SXBLOK se vuelcan.

LOCK Una vez emitida, todas las configuraciones de seguridad se bloquean

en sus valores actuales. La configuración de seguridad no puede modificarse hasta que la pila se haya completado un ciclo.

299


Ejemplo


ACCESS


ASECURITY


DEFINE USER


QUERY SECURITY


QUERY USERS


security on,auto=on,batch=on IPN759I Security status change: Security Processing Enabled IPN759I Security status change: Automatic Security Enabled IPN759I Security status change: Batch Security Enabled

300

Capítulo 3 Descripción de Comandos: SEGMENT

SEGMENT

Sintaxis

Argumentos

El comando SEGMENT segmenta el archivo SYSLST. Esto le permite

obtener un archivo SYSLST parcial sin cerrar TCP/IP FOR VSE.

SEGment [NEW]

NEW Indica a TCP/IP FOR VSE que emita la macro IPWSEGM en lugar de

la macro SEGMENT.

Algunos clientes han informado problemas con IPWSEGM, por lo que el

predeterminado es usar la macro SEGMENT anterior. SEGMENT NEW se puede utilizar en sistemas que ejecutan VSE/ESA 2.2 o posterior.

Ejemplo

Notas


Cuando se emite SEGMENT, las características del archivo SYSLST se

restablecen a los valores predeterminados de VSE.

DEFINE LOG


MESSAGE

Controls message suppression.

MODIFY LOG


QUERY LOGS


segment

IPN480I TCP/IP FOR VSE log has been segmented.

301

Capítulo 3 Descripción de Comandos: SEPARATOR_PAGES

SEPARATOR_PAGES

Sintaxis

El comando SEPARATOR_PAGES controla si los separadores de

página generados por POWER se generan para diversas operaciones.

SEParator_pages {OFF|ON|[-]Email|[-]FTp|[-]HTtp|[-]LPr}

Argumentos OFF Las páginas de separación generadas por POWER no se incluirán

en ningún proceso. Este es el valor predeterminado.

ON Los archivos leídos de las filas POWER contendrán páginas separadoras generadas por POWER para todos los procesos.

[-]EMail Controla el uso de Email de las páginas de separación generadas por POWER.

[-]FTp Controla el uso FTP de páginas de separación generadas por POWER.

[-]HTtp Controla el uso de HTTP de las páginas de separación generadas por POWER.

[-]LPr Controla el uso de LPR de las páginas de separación generadas por POWER.

Ejemplo

Notas


Según el protocolo LPR/LPD, la responsabilidad de producir páginas de separación pertenece al LPD que envía los datos a una impresora

física. Sin embargo, debido a que muchos daemons comúnmente

disponibles no son compatibles con esta característica, los separadores estándar producidos por POWER pueden pasar.

Las páginas de separación son válidas sólo para la salida POWER y sólo

si solicita que POWER las cree. Vea el manual de IBM VSE/Funciones Centrales de la Arquitectura VSE de Sistemas Empresariales:

Administración y Operación de VSE/POWER (SC33-6633-01) para más

información sobre cómo hacer que POWER cree páginas de separación.

Este comando afecta las operaciones de READ cuando extrae datos

de POWER. Para generar páginas de separación cuando escribe datos

en POWER, consulte el comando SET PAGE_COUNT.

separator_pages on

IPN249I Value for Separator Page set to on

302

Capítulo 3 Descripción de Comandos: SEPARATOR_PAGES


QUERY OPTIONS


SET PAGE_COUNT

Establece el número de páginas de separación generadas por POWER.

303

Capítulo 3 Descripción de Comandos: SET AUTO_TIME

SET AUTO_TIME

Sintaxis

Argumentos

Ejemplo

Notas


El comando SET AUTO_TIME controla con qué frecuencia el procesamiento

de eventos de TCP/IP FOR VSE (según lo habilitado por el comando DEFINE

EVENT) escanea las filas POWER en busca de nuevo trabajo.

SET AUTO_TIME=sec300

sec300

Numérico, de 1500 a 18000, el número de unidades de 300 segundos.

La cantidad de tiempo entre los escaneos de las filas POWER por el

temporizador de eventos TCP/IP FOR VSE.


Consulte la descripción del comando DEFINE EVENT para obtener más información sobre TCP/IP para el procesamiento de eventos VSE.

Un valor grande ahorra CPU pero hace que TCP/IP FOR VSE tarde

más en detectar nuevos trabajos en las filas POWER. Un valor

pequeño usa CPU adicional, pero hace que el procesamiento de

eventos responda mejor al nuevo trabajo.

DEFINE EVENT


QUERY EVENTS


QUERY OPTIONS


set auto_time=1500 IPN268I AUTO_TIME now set to 1500 300th sec

304

Capítulo 3 Descripción de Comandos: SET DEFAULT_DOMAIN

SET DEFAULT_DOMAIN

Sintaxis

Argumentos

Ejemplo

Notas


El comando SET DEFAULT_DOMAIN especifica la parte común de los

nombres de host simbólicos utilizados en su instalación. Este valor se

agrega a la tabla de nombres locales (consulte las Notas a continuación)

SET DEFAULT_DOMAIN=string

string

Una cadena que se utilizará como dominio predeterminado. Si se

especifica un asterisco (*), el valor se anula.

Nota: Para direcciones email, la configuración DESTINATION=

del comando EMAIL tiene prioridad sobre este valor.

Cuando una aplicación emite una solicitud para convertir un nombre

simbólico en una dirección IP, TCP/IP FOR VSE busca en la tabla de

nombres simbólicos. Si no se encuentra ninguna entrada, el nombre se pasa al servidor de nombres de dominio especificado (DNS). Si el DNS no

puede resolver el nombre, se agrega un punto y el dominio predeterminado

al nombre, y todo el proceso de búsqueda (verificación de caché a través

de la búsqueda de DNS) se repite con este nombre compuesto.

Por ejemplo, utilizando el ejemplo anterior, si "helpdesk" no se puede

resolver, se intentará resolver “helpdesk.csi-international.com.”

EMAIL

Establece opciones globales predeterminadas para el cliente EMAIL.

DEFINE NAME

Asocia un nombre TCP/IP con una dirección o un archivo de script.

QUERY NAMES

Muestra el contenido de la tabla de nombres simbólicos creada por

DEFINE NAME.

QUERY OPTIONS

Muestra los valores actuales de los parámetros modificables, incluidas las direcciones de los servidores especificados por SET DNSn.

SET DNSn

Especifica un DNS que se utilizará para la resolución de nombres.

set default_domain=csi-international.com IPN268I DEFAULT_DOMAIN now set to CSI-INTERNATIONAL.COM

305

Capítulo 3 Descripción de Comandos: SET DIAGNOSE

SET DIAGNOSE

Sintaxis

Argumentos

Ejemplo

Notas


El comando SET DIAGNOSE controla en dónde se escriben los mensajes

emitidos por DIAGNOSE. Puede usar este comando para dirigir estos mensajes a

la consola TCP/IP FOR VSE, así como a SYSLST

SET DIAGnose {NOCONSOLE|CONSOLE}

NOCONSOLE Los mensajes producidos en respuesta al comando DIAGNOSE se escriben sólo en SYSLST. Este es el valor predeterminado.

CONSOLE Los mensajes producidos en respuesta al comando DIAGNOSE

se envían tanto a SYSLST como a la consola.

Las siguientes notas aplican:

Si no tiene acceso a SYSLST y está diagnosticando un problema,

entonces este comando es una opción que permite ver los diagnósticos en la consola. Si bien tiene sus usos, tome en cuenta que tiene el

potencial de inundar su consola con mensajes, lo que podría interferir

con las operaciones normales en un entorno de producción.

La salida del comando DIAGNOSE puede ser voluminosa. Use el

comando SET DIAGNOSE CONSOLE con precaución.

DIAGNOSE

Habilita los mensajes de diagnóstico.

QUERY DIAGNOSE

Muestra la configuración actual de DIAGNOSE vigente.

set diagnose console IPN868I DIAGNOSE display on console is on

306

Capítulo 3 Descripción de Comandos: SET DNSn

SET DNSn

Sintaxis

Argumentos

Cada comando SET DNSn especifica la dirección IP de un Servidor de

Nombres de Dominio (DNS) que se utiliza para resolver un nombre de

host a una dirección IP o una dirección IP a un nombre de host.

SET DNSn=ip4addr

n Valor numérico, de 1 a 4.

dentifica el DNS. Se pueden especificar hasta cuatro servidores.

ip4addr La dirección IPv4 del servidor de nombres de dominio que se

utilizará. Si se omite, no se realiza ninguna búsqueda de DNS.

Ejemplo

Notas



Cuando ustednecesita convertir un nombre simbólico en una dirección IP, TCP/IP FOR VSE primero consulta la tabla de nombres locales. Si esta

búsqueda falla, se realiza una llamada al DNS especificado. Si el nombre

aún no se resuelve y se establece una cadena de dominio (SET

DEFAULT_DOMAIN), se agrega un punto y la cadena de dominio al nombre simbólico, y todo el proceso de búsqueda (comprobación de caché a

través de la búsqueda de DNS) se repite utilizando este nombre compuesto.

TCP/IP FOR VSE admite llamadas GetHostByName y GetHostByAddr

al DNS.

Si se especifica más de un DNS, TCP/IP FOR VSE prueba cada DNS a su

vez, comenzando con DNS1, hasta que se reciba una respuesta o se hayan sondeado todos los servidores. El primer servidor que responde determina si

la solicitud es exitosa, lo que significa que si DNS1 responde negativamente

("No existe tal nombre de dominio", por ejemplo), DNS2 no es consultado.

Vea el comando SET DNSTn para obtener información sobre cómo

determinar si los servidores de nombres de dominio han respondido.

DEFINE NAME

Asocia un nombre TCP/IP con una dirección IP o un archivo de

script. La tabla de nombres resultante se busca cuando una

aplicación realiza una llamada para convertir un nombre simbólico en una dirección IP.

SET DNS1=65.24.7.3 IPN254I DNS 1 address is 65.24.7.3, Timeout is 1200

307

Capítulo 3 Descripción de Comandos: SET DNSn

QUERY NAMES

Muestra el contenido de la tabla de nombres simbólicos creada por

DEFINE NAME.

QUERY OPTIONS

Muestra los valores actuales de los parámetros modificables, incluidas

las direcciones IP de los servidores especificados por SET DNSn.

SET DEFAULT_DOMAIN

Establece un nombre de dominio que se agregará automáticamente a los nombres no calificados.

SET DNSTn

Controla el valor de tiempo de espera que se utilizará para un

DNS correspondiente (especificado por SET DNSn).

308

Capítulo 3 Descripción de Comandos: SET DNSTn

SET DNSTn

Sintaxis

Argumentos

Cada comando SET DNSTn especifica un valor de tiempo de espera para un

comando SET DNSn correspondiente. Por ejemplo, el comando SET DNST1

especifica el valor de tiempo de espera para el servidor de nombres de dominio (DNS) especificado por SET DNS1.

SET DNSTn=sec300

n

Valor numérico, del 1 al 4, que identifica la entrada DNS para modificar.

Se pueden especificar hasta cuatro servidores.

sec300 Valor numérico, del 300 a 65535, el número de unidades de 300

segundos.

Especifica el valor de tiempo de espera que se utilizará para el DNS

correspondiente. El valor predeterminado es 1200 (4 segundos).

Ejemplo


QUERY OPTIONS

Muestra los valores actuales de los parámetros modificables, incluida la dirección de cada DNS definido con SET DNSn.

SET DNSn

Especifica la dirección IPv4 de un servidor de nombres de dominio.

set dnst1=1500 IPN254I DNS 1 address is 65.24.7.3, Timeout is 1500

309

Capítulo 3 Descripción de Comandos: SET FIXED_RETRANSMIT

SET FIXED_RETRANSMIT

Sintaxis

Argumentos

El comando FIXED_RETRANSMIT establece el valor predeterminado

para el parámetro FIXRETRAN= en el comando DEFINE ROUTE.

SET FIXED_RETRansmit={ON|OFF}

ON El valor predeterminado para el parámetro DEFINE ROUTE FIXRETRAN= se

establece en YES. Esto significa que si FIXRETRAN= no se especifica en la instrucción de ruta, los valores especificados para DRETRAN= y RPAUSE= en

DEFINE ROUTE permanecerán constantes durante la conexión.

OFF El valor predeterminado para el parámetro DEFINE ROUTE FIXRETRAN= se establece en NO. Esto significa que si FIXRETRAN=

no se especifica en la instrucción de ruta, los valores para DRETRAN= y

RPAUSE= comienzan como se especifica, pero se ajustarán

dinámicamente a medida que se analice la respuesta de la red. OFF es el predeterminado por el sistema.

Ejemplo


El parámetro DEFINE ROUTE FIXRETRAN= tiene prioridad sobre SET FIXED_RETRANSMIT. Usar FIXRETRAN= en cada instrucción

de ruta es la forma recomendada de actualizar esta configuración.

Si el parámetro FIXRETRAN= no está establecido en una instrucción

DEFINE ROUTE, la configuración predeterminada se muestra en la

salida DEFINE ROUTE como se muestra (el campo Fixed:).

El uso de SET FIXED_RETRANSMIT no afecta las definiciones de ruta existentes.

Consulte DEFINIR RUTA para obtener más información sobre los

parámetros DRETRAN= y RPAUSE=.


DEFINE ROUTE

Agrega una entrada a la tabla de enrutamiento TCP / IP..

IPN876I SYN Retran: 1000ms Data Retran: 1000ms Fixed: No

set fixed_retransmit=on IPN251I Fixed retransmission rate set to on

310

Capítulo 3 Descripción de Comandos: SET FIXED_RETRANSMIT

MODIFY ROUTE


QUERY OPTIONS


QUERY ROUTES



311

Capítulo 3 Descripción de Comandos: SET IPADDR

SET IPADDR

Sintaxis

Argumentos

Ejemplo

Notas


The SET IPADDR command sets the default network address of TCP/IP

FOR VSE.

SET IPaddr=ip4addr

IPaddr= La dirección de red predeterminada de la partición TCP/IP FOR VSE.


El comando SET IPADDR= debe especificarse en el miembro de la

librería de inicialización y, una vez especificado, no debe cambiarse

sin reiniciar TCP/IP FOR VSE.

El mensaje IPN188I en respuesta al comando SET IPADDR

muestra los números de red y subred después de aplicar la máscara

de subred. La máscara se configura con el comando SET MASK.

Esta dirección IP debe "anularse" con el parámetro IPADDR= en los

comandos DEFINE LINK y DEFINE adaptador.

DEFINE ADAPTER


DEFINE ALTIP Hace que la pila supervise y responda a las solicitudes ARP de

direcciones de inicio adicionales.

DEFINE LINK Crea un enlace entre TCP/IP y una red o con una pila conectada

directamente.

DEFINE MASK Crea una máscara de subred para una red en particular.

QUERY LINKS


QUERY MASKS


SET IPADDR=192.168.1.161 IPN268I IPADDRESS now set to 192.168.1.161 IPN188I IP Address 192.168.1.161 = Net: 192.168.1.0 Subnet: -- Host: 0.0.0.161

312

Capítulo 3 Descripción de Comandos: SET IPADDR

QUERY OPTIONS


SET MASK


313

Capítulo 3 Descripción de Comandos: SET LINK_RETRY

SET LINK_RETRY

Sintaxis

Argumentos

Ejemplo

Notas


El comando SET LINK_RETRY especifica el período de tiempo

predeterminado que debe transcurrir antes de que TCP/IP FOR VSE

intente reiniciar un controlador de enlace que no se inicializa.

SETLINK_retry=sec300

sec300 Numérico, de 0 a 9999999, el número de unidades de 300 segundos.

El intervalo de espera entre intentos de inicializar un controlador

de enlace. El valor predeterminado es 18000 (60 segundos).

También puede especificar un valor de LINK_RETRY= en el comando

DEFINE LINK. Ese valor anula el valor predeterminado global definido por SET LINK_RETRY.

DEFINE LINK

Crea un enlace entre TCP/IP y una red o con una pila conectada

directamente.

QUERY OPTIONS


set link_retry=1800 IPN268I LINK_RETRY now set to 1800

314

Capítulo 3 Descripción de Comandos: SET MASK

SET MASK

Sintaxis

Argumentos

Ejemplo

Notas


El comando SET MASK identifica qué parte del número de host en una

dirección de red se usa para identificar una subred.

SET MASK=ip4addr

ip4addr Especifica el valor de la máscara que se aplicará a la dirección de

red para obtener el número de subred. Este valor se codifica en notación decimal con puntos de la misma manera que una dirección

de red TCP / IP, es decir, n.n.n.n, donde cada instancia de n es la

representación decimal de un byte.


Las direcciones IP consisten en un número de red y un número de host. Para mayor flexibilidad, se puede aplicar una máscara al

número de host para obtener un número de subred. Este número de

subred se puede usar cuando se codifican instrucciones DEFINE

ROUTE y cuando se desean direcciones genéricas.

SET MASK establece la máscara que se aplicará a cualquier red que

no esté definida explícitamente con un comando DEFINE MASK.

El mensaje IPN188I en respuesta al comando SET IPADDR muestra los números de red y subred después de aplicar la máscara de subred.

La dirección IP se configura con el comando SET IPADDR.

Vea la Guía de Instalación de TCP/IP FOR VSE para más información

sobre la definición de redes y subredes.

CONNECT_SEQUENCE

Controla si las solicitudes de conexión se asignan mediante la

verificación del patrón de dirección IP.

DEFINE FTPD


DEFINE MASK


set mask=255.255.255.0 IPN268I MASK now set to 255.255.255.0 IPN188I IP Address 192.168.1.161 = Net: 192.168.1.0 Subnet: -- Host: 0.0.0.161

315

Capítulo 3 Descripción de Comandos: SET MASK

DEFINE ROUTE


DEFINE TELNETD


QUERY MASKS


QUERY OPTIONS


SET IPADDR



Establece el nombre de la tabla de traducción que se usará con las

conexiones Telnet (no TN3270).

316

Capítulo 3 Descripción de Comandos: SET MAXIMUM_MESSAGES

SET MAXIMUM_MESSAGES

El comando SET MAXIMUM_MESSAGES establece el número máximo

de mensajes del sistema en fila (no impresos) antes de que la pila ignore el

resto y rechace los mensajes entrantes adicionales a SYSLOG. Si los mensajes sólo se deben enrutar a SYSLST, esos mensajes se seguirán

enviando a la impresora. Si los mensajes van a ir a SYSLST así como a

SYSLOG, pero hay una fila, entonces no se emitirá ninguno.

Sintaxis

Argumentos

Normalmente, el límite se alcanza solo si los mensajes van a SYSLOG y

el operador se desplaza hacia atrás en la consola y lo deja en ese modo. Esto bloquearía efectivamente la salida del mensaje.

SET MAXIMUM_MESSAGES=num

num

Numérico; de 0 a 9999999. El valor predeterminado es 1000.

Ejemplo


MESSAGE


MODIFY CONSOLE

Controla cómo se muestran los mensajes en la consola.

QUERY LOGS


SET DIAGNOSE

Permite la visualización de la consola de mensajes resultantes del comando DIAGNOSE.

SET MAXIMUM_MESSAGES=500 IPN268I MAXIMUM_MESSAGES now set to 500

317

Capítulo 3 Descripción de Comandos: SET MAX_EMAIL_EVENTS


Sintaxis

Argumentos

Este comando controla cuántos eventos EMAIL simultáneos serán

manejados por el procesamiento de Automatización.

SET MAX_Email_events=num

num Numérico, del 1 al 9999999. El valor predeterminado es 1.

Ejemplo

Notas



La transmisión de correo electrónico generalmente ocurre rápidamente.

Un servidor SMTP puede limitar la cantidad de conexiones

simultáneas con un host.

Si una transmisión de correo electrónico requiere servicios

auxiliares, como la conversión de PDF, debe considerar cuánta carga

de CPU es apropiada para la partición TCP/IP FOR VSE.

DEFINE EVENT


QUERY EMAIL

Muestra la configuración del cliente EMAIL.

QUERY EVENTS


SET MAX_FTP_EVENTS



SET MAX_LPR_EVENTS

Establece el número máximo de eventos LPR simultáneos para el procesamiento de automatización.

SINGLEDEST Determina cómo el procesamiento de automatización maneja

múltiples informes en fila para el mismo destino (host).

set max_email_events=1 IPN268I MAX_EMAIL now set to 1

318

Capítulo 3 Descripción de Comandos: SET MAX_FTP_EVENTS

SET MAX_FTP_EVENTS

Sintaxis

Argumentos

Este comando controla cuántos eventos FTP simultáneos serán

manejados por el procesamiento de automatización.

SET MAX_Ftp_events=num


Ejemplo

Notas



Las transmisiones FTP generalmente ocurren rápidamente.

Cada hilo FTP consume una sesión FTP disponible. Asegúrese de

que haya suficientes sesiones libres disponibles.

Si la transmisión FTP requiere servicios auxiliares, como conversión

o cifrado de PDF, considere la cantidad de carga de CPU adecuada

para la partición TCP/IP FOR VSE.

DEFINE EVENT


QUERY EVENTS


QUERY FTPDS


Archivos.


Establece el número máximo de eventos EMAIL simultáneos para el procesamiento de Automatización.

SET MAX_LPR_EVENTS Establece el número máximo de eventos LPR simultáneos para el

procesamiento de Automatización.

SINGLEDEST

Determina cómo el procesamiento de automatización maneja


set max_ftp_events=1 IPN268I MAX_FTP now set to 1

319

Capítulo 3 Descripción de Comandos: SET MAX_LPR_EVENTS

SET MAX_LPR_EVENTS

Sintaxis

Argumentos

Este comando controla cuántos eventos LPR simultáneos serán manejados

por el procesamiento de Automatización.

SET MAX_Lpr_events=num


Ejemplo

Notas



La transmisión LPR a un verdadero LPD generalmente ocurre rápidamente.

Un servidor LPD limita el número de conexiones simultáneas con un

host.

Si el LPD de destino es en realidad una impresora, una sola transmisión

LPR puede requerir minutos u horas. Durante este tiempo, el consumo

de recursos (CPU, I/O) es generalmente bajo.

DEFINE EVENT


QUERY EVENTS



Establece el número máximo de eventos EMAIL simultáneos para el


SET MAX_FTP_EVENTS



SINGLEDEST Determina cómo el procesamiento de automatización maneja


set max_lpr_events=3 IPN268I MAX_LPR now set to 3

320

Capítulo 3 Descripción de Comandos: SET MAX_SEGMENT

SET MAX_SEGMENT

El comando SET MAX_SEGMENT limita el tamaño de los segmentos

de datos TCP entrantes. Este comando establece el valor predeterminado

para el parámetro MSS= en las instrucciones DEFINE ROUTE.

Sintaxis

Argumentos

SET MAX_SEGMENT y SET MAXSEGMENT son sinónimos.

SET MAX_Segment={32684|num}

num

Numérico; del 576 al 65495.

El tamaño máximo de los segmentos de datos TCP a ser negociados por TCP/IP FOR VSE. El valor predeterminado es 32684. El valor

recomendado es 65495.

Ejemplo

Notas


Cuando se negocia una conexión TCP, cada lado le dice al otro el

tamaño del segmento de datos máximo que se puede enviar.

Normalmente, TCP/IP FOR VSE solicita el segmento de tamaño máximo que se puede lograr sin fragmentación de datagramas. Esto

se puede calcular como el tamaño de MTU menos 40.

Si tiene problemas con el flujo de datos entrantes, reducir el

tamaño máximo de segmento puede ayudar a diagnosticar el

problema. Tenga en cuenta que esto no tiene ningún efecto sobre

el tamaño de los datagramas salientes.

El parámetro DEFINE ROUTE MSS= tiene prioridad sobre SET

MAX_SEGMENT. Establecer MSS= en cada instrucción

DEFINE ROUTE es la forma recomendada de actualizar el valor.

El valor MSS= que se usa para una instrucción DEFINE ROUTE

se muestra en la salida DEFINE ROUTE de la siguiente manera (el campo Max Seg).

El uso de SET MAX_SEGMENT no afecta las definiciones de ruta existentes.

IPN875I MTU: 0 Max Seg: 32684 Pulse: 60s

set max_segment=65495 IPN268I MAXIMUM_SEGMENT now set to 65495

321

Capítulo 3 Descripción de Comandos: SET MAX_SEGMENT


DEFINE ROUTE


QUERY OPTIONS


322

Capítulo 3 Descripción de Comandos: SET PAGE_COUNT

SET PAGE_COUNT

Sintaxis

Argumentos

El comando SET PAGE_COUNT determina cuántas páginas de

separación generadas por POWER se utilizan con cada archivo leído

desde POWER si JSEP está habilitado.

SET PAGE_COunt=num

num Numérico, de 0 a 255.

El número de páginas de separación generadas por POWER que se

solicitarán. El valor predeterminado es 0.

Ejemplo

Notas


También debe usar el comando SEPARATOR_PAGES para especificar

qué procesos son elegibles para recibirlos.

QUERY OPTIONS


SEPARATOR_PAGES

Controla la generación de páginas de separación POWER.

set page_count=3 IPN268I PAGE_COUNT now set to 65535

323

Capítulo 3 Descripción de Comandos: SET PASSWORD

SET PASSWORD

Sintaxis

Argumentos

Ejemplo

Notas


El comando SET PASSWORD establece una contraseña que se requiere

al enviar mensajes a la partición TCP/IP FOR VSE.

SET PASSword=string

string Cadena de 1 a 8 caracteres, sin distinción entre mayúsculas y minúsculas.

Esta contraseña es necesaria cuando emite el comando MSG a la

partición TCP / IP FOR VSE.


No hay respuesta de este comando y no puede consultar el valor de la contraseña actual.

Si coloca este comando en su plataforma de inicialización, puede

anteponer el comando con un signo más (+) para suprimir la

impresión eco de la contraseña.

Para eliminar la contraseña, emita el comando SET PASSWORD=

sin parámetro.

La capacidad de ingresar comandos mediante la interfaz por lotes

IPNETCMD no es afectada por contraseñas. Si la seguridad es un problema,

asegúrese de que IPNETCMD no esté disponible para los usuarios.

Vea el capítulo "Seguridad" en la Guía de Instalación de TCP/IP FOR VSE

para obtener más información sobre el uso de esta función.

CONSOLE_HOLD

Mantiene un símbolo del sistema de la consola.

set password=wavv msg f4 IPN223A Please enter password wavv IPN300A Enter TCP/IP Command

324

Capítulo 3 Descripción de Comandos: SET POWERPASSWORD

SET POWERPASSWORD

Sintaxis

Argumentos

Ejemplo


El comando SET POWERPASSWORD establece una contraseña que

se utilizará para el acceso TCP/IP FOR VSE a las filas VSE/POWER.

SET POWERPassword=string8

string8 Cadena de 1 a 8 caracteres, sin distinción entre mayúsculas y minúsculas.

Esta contraseña se usa para acceder a POWER. Aunque no hay un

valor predeterminado para este parámetro, el acceso POWER

generalmente no requiere una contraseña.

SET POWERUSERID

Establece la ID de usuario para el acceso POWER.

set powerpassword=fishbulb IPN268I POWERPASSWORD now set to ++Suppressed++

325

Capítulo 3 Descripción de Comandos: SET POWERUSERID

SET POWERUSERID

Sintaxis

Argumentos

Ejemplo


El comando SET POWERUSERID establece el ID de usuario que

utilizará TCP/IP al acceder a las filas VSE/POWER.

SET POWERUserid=string8

string8 Cadena de 1 a 8 caracteres, sin distinción entre mayúsculas y minúsculas.

Esta es la ID de usuario que se usará para el acceso POWER. La

ID de usuario predeterminada es “SYSTCPIP”.

SET POWERPASSWORD

Establece la contraseña para el acceso POWER.

set poweruserid=SYSTCPIP IPN268I POWERUSERID now set to SYSTCPIP

326

Capítulo 3 Descripción de Comandos: SET PULSE_TIME

SET PULSE_TIME

El comando SET PULSE_TIME establece el intervalo después del cual TCP/IP

FOR VSE prueba las conexiones inactivas para ver si deben terminarse.

Sintaxis

Argumentos

Ejemplo

Notas

Este comando establece el valor predeterminado para el parámetro PULSE=

en el comando DEFINE ROUTE.

SET PULse_time={18000|sec300}

sec300


Especifica el intervalo de tiempo que TCP / IP FOR VSE permite que

una conexión TCP permanezca inactiva antes de probar la presencia continua de un host remoto. El valor predeterminado es 18000 (un

minuto). Establecer un valor de 0 desactiva el mecanismo de pulso.


TCP/IP FOR VSE prueba una conexión TCP inactiva

retransmitiendo un paquete vacío con el mismo número de secuencia que el último byte reconocido. Los protocolos TCP requieren que el

host remoto vuelva a reconocer byte y lo descarte. Si no se reconoce

el byte, las rutinas de retransmisión estándar obtienen el control y, si

aún no se recibe un reconocimiento, la conexión se interrumpe y se notifica a la aplicación propietaria de la conexión.

Si una PC que ejecuta una sesión TN3270 se inicia sin terminar la

sesión, el daemon TN3270 asociado permanece en sesión porque no

tiene forma de saber que el host remoto se ha ido. Cuando se activa el proceso de pulso, la sesión se cierra.

Un valor bajo PULSE_TIME da como resultado un procesamiento

innecesario. Un valor PULSE_TIME alto permite que persistan las conexiones inactivas.

El mecanismo de pulso también es útil para restaurar las conexiones

que se han dormido.

El parámetro DEFINE ROUTE PULSE= tiene prioridad sobre

SET PULSE_TIME. Establecer PULSE= en cada instrucción

DEFINE ROUTE es la forma recomendada de actualizar el valor.

set pulse_time=30s IPN268I PULSE_TIME now set to 9000 300th sec

327

Capítulo 3 Descripción de Comandos: SET PULSE_TIME

El valor del parámetro PULSE que se usa en una definición de ruta se

muestra en la salida DEFINE ROUTE de la siguiente manera (el campo Pulse:). El valor se muestra en segundos.

Si el parámetro PULSE= no está establecido en la instrucción

DEFINE ROUTE, el valor que se muestra es el predeterminado.

El uso de SET PULSE_TIME no afecta las definiciones de ruta existentes.


DEFINE ROUTE


QUERY OPTIONS


IPN875I MTU: 0 Max Seg: 32684 Pulse: 60s

328

Capítulo 3 Descripción de Comandos: SET RETRANSMIT

SET RETRANSMIT

El comando SET RETRANSMIT controla la longitud del intervalo

predeterminado antes de que TCP/IP FOR VSE entre en modo de

retransmisión para paquetes de datos no reconocidos.

Sintaxis

Argumento

Ejemplo

Set retransmit=300

Este comando establece el valor predeterminado para los parámetros CRETRANS= y DRETRANS= en las instrucciones DEFINE ROUTE.

SET RETransmit={300|sec300}

sec300


Especifica el intervalo de tiempo para esperar a que se reconozca un datagrama.

El valor predeterminado es 300, lo que equivale a 1000 ms o 1 segundo.

IPN268I RETRANSMIT now set to 300

Exposición

Notas

El protocolo de transmisión IP requiere que cada paquete de datos se

entregue oportunamente o se deseche. No hay excepciones, y los datos no se pueden poner en fila o retrasarse de ninguna manera. No existe un

mecanismo que permita a IP informar al remitente que se ha perdido o

descartado un paquete de datos.

Para permitir el hábito IP de descartar paquetes de datos, TCP requiere

un reconocimiento por cada paquete de datos enviado (desde el TCP

que recibe el paquete). Si no se reconoce de recibo, TCP debe

retransmitir el paquete de datos.

En circunstancias normales, TCP/IP FOR VSE observa (en cada conexión)

el tiempo requerido para recibir un reconocimiento. Éste utiliza este valor para determinar cuándo un reconocimiento está vencido y se requiere una

retransmisión. El valor proporcionado por SET RETRANSMIT se utiliza

como punto de partida para cada nueva conexión.

El valor adecuado para el temporizador de retransmisión predeterminado es una función de la velocidad de su red y las capacidades de los hosts en

su red. Puede usar el comando DIAGNOSE con la opción PERFORM

para determinar si tiene problemas de retransmisión.


El concepto de tiempo de retransmisión se ha dividido en dos

conjuntos de dos valores. Los dos valores son el valor umbral hasta que se requiere una retransmisión y el tiempo entre retransmisiones.

Conjuntos de valores separados pertenecen a solicitudes de conexión

y conexiones establecidas.

329

Capítulo 3 Descripción de Comandos: SET RETRANSMIT

Todos estos valores deben establecerse por separado utilizando

el comando DEFINE ROUTE.

Si los parámetros CRETRANS= y DRETRANS= no están establecidos

en DEFINE ROUTE, el valor SET RETRANSMIT se muestra en la salida DEFINE ROUTE de la siguiente manera (los campos SYN

Retran y Data Retran). Los valores se muestran en milisegundos, que

son las unidades para estos parámetros DEFINE ROUTE.

Los parámetros DEFINE ROUTE CRETRANS= y DRETRANS=

tienen prioridad sobre SET RETRANSMIT. Establecer los parámetros

CRETRANS= y DRETRANS= en cada instrucción DEFINE ROUTE

es la forma recomendada de actualizar estos valores.

El uso de SET RETRANSMIT no afecta las definiciones de ruta existentes.


DEFINE ROUTE


MODIFY ROUTE


QUERY OPTIONS


QUERY ROUTES Muestra el contenido de la tabla de enrutamiento de red o la ruta


IPN876I SYN Retran: 1000ms Data Retran: 1000ms Fixed: No

330

Capítulo 3 Descripción de Comandos: SET TELNET_TRANSLATE


Sintaxis

Argumentos

Examplo

Notas


El comando SET TELNET_TRANSLATE especifica el nombre de una

tabla de traducción que se utilizará para las sesiones Telnet en modo de

línea iniciadas por el cliente Telnet en modo de línea CICS, el cliente por lotes, los clientes Telnet programables y las conexiones de control FTP.

SET TELNET_Translate=name16

name16 El nombre de la tabla de traducción que utilizará el cliente Telnet.


No se verifica la validez del nombre de la tabla de traducción hasta que se necesita. Si el nombre no es válido, se utiliza la tabla de

traducción predeterminada del sistema.

Vea la Guía de Instalación de TCP/IP FOR VSE para más

información sobre cómo definir tablas de traducción.

DEFINE TRANSLATION


QUERY OPTIONS


QUERY TRANSLATES

Muestra una lista de tablas de traducción disponibles.

set telnet_translate=us_eng_03 IPN804I Telnet translation will use US_ENG_03

331

Capítulo 3 Descripción de Comandos: SET TELNETD_BUFFERS

SET TELNETD_BUFFERS

Sintaxis

Argumentos

El comando SET TELNETD_BUFFERS controla el número de

buffers en el grupo de buffers de daemon Telnet.

SET TELNETD_BUFFers=num


El número de buffers en el grupo. El valor predeterminado es 20. Codifique

0 si no se utilizarán daemons Telnet (con POOL=YES). Valores superiores

al número total de daemons desperdician almacenamiento.

Ejemplo

Notas



Los daemon Telnet definidos con el operando POOL=YES

comparten sus buffers. Cada daemon obtiene un buffer sólo

cuando realmente está transfiriendo datos.

Un aumento en el número de buffers es efectivo inmediatamente.

Una disminución en el número de buffers es efectiva

inmediatamente si los buffers que se van a liberar no están en uso.

DEFINE TELNETD

Crea un aemon TN3270 o TN3270E.

QUERY OPTIONS


QUERY STATISTICS


QUERY TELNETDS


set telnetd_buffers=10 IPN268I Telnetd buffers now set to 10

332

Capítulo 3 Descripción de Comandos: SET TELNETD_BUFSIZE

SET TELNETD_BUFSIZE

Sintaxis

Argumentos

El comando SET TELNETD_BUFSIZE controla el tamaño de los

buffers en el grupo de buffers del daemon Telnet.

SET TELNETD_BUFSize=num


El tamaño predeterminado (8192) de los buffers Telnet debería ser

suficiente para todas las operaciones normales de 3270. En casos raros

donde los tamaños de pantalla se maximizan y la complejidad de la pantalla es alta, puede ser necesario aumentar el tamaño del buffer.

Ejemplo

Notas



Los daemons definidos con POOL=NO obtienen sus buffers al inicio. Antes de que un cambio en el tamaño del bufer surta efecto para un

daemon específico, debe reciclarse.

Cuando se cambia el tamaño del buffer, todos los buffers existentes en el

grupo de buffers se liberan y luego se reasignan en el tamaño correcto. Si

se está utilizando un buffer, se liberará cuando se devuelva al grupo.

DEFINE TELNETD


QUERY OPTIONS


QUERY STATISTICS


QUERY TELNETDS


SET TELNETD_BUFFERS

Determina el tamaño del grupo de buffers compartido por los demons

TN3270.

set telnetd_bufsize=8192 IPN268I Telnetd buffers now set to 0 IPN268I TELNETD_BUFSIZE now set to 8192 IPN268I Telnetd buffers now set to 10

333

Capítulo 3 Descripción de Comandos: SET WINDOW

SET WINDOW

El comando SET WINDOW controla la cantidad predeterminada de

datos que se pueden recibir de un host remoto antes de que deba

esperar por un reconocimiento de recibido.

Sintaxis

Argumentos

Este comando establece el valor predeterminado para el parámetro WINDOW= en el comando DEFINE ROUTE.

SET WINdow={65535|num}

num

Numérico, de 1500 a 65535.

El número de bytes que se pueden recibir antes de esperar un

reconocimiento de recibido. El valor predeterminado es 65535.

Ejemplo

Exposición

La “ventana” es el número de bytes que el host remoto está autorizado a enviar. Debido a que cada byte en una conexión TCP está numerada

secuencialmente, la ventana es en realidad el número de secuencia del

byte que sigue a la última posición en la ventana. Una de las reglas es que este punto final nunca puede retroceder (reducir la ventana).

En circunstancias normales, a medida que se reciben datos, se reconocen

y la ventana se amplía aún más. Si los datos llegan más rápido de lo que

pueden acomodarse, aún deben reconocerse de manera oportuna, pero el punto final de la ventana no avanza. Finalmente, se alcanza el punto final

y la ventana se “cierra”.

Una vez que se cierra la ventana, no se pueden enviar más datos hasta que se haya vuelto a abrir. Una de las reglas es que cuando se vuelve a

abrir una ventana, debe volver a abrirse por completo a su tamaño

máximo.

Los enlaces de comunicación se han vuelto más rápidos, y el

almacenamiento VSE disponible es abundante. Para aumentar la

velocidad de transmisión general, TCP / IP FOR VSE almacena mucho más que el tamaño de la ventana, manteniendo la "ventana disponible"

en su valor máximo con cada reconocimiento de archivo.

Al seleccionar un tamaño de ventana, también debe considerar los

valores MTU y MSS.

set window=65535 IPN268I WINDOW now set to 65535

334

Capítulo 3 Descripción de Comandos: SET WINDOW

Notas

Las siguierntes notas aplican a este comando:

El valor de la ventana afecta sólo el tráfico entrante.

El tamaño de la ventana debe ser al menos MTU-40.


información sobre la ventana TCP/IP.

El parámetro DEFINE WINDOW ROUTE= tiene prioridad sobre

SET WINDOW. Establecer WINDOW= en cada instrucción DEFINE ROUTE es la forma recomendada de actualizar el valor.

Si el parámetro WINDOW= no se establece en las instrucciones

DEFINE ROUTE, el valor SET WINDOW es mostrado en la salida

DEFINE ROUTE de la siguiente manera (el campo RWin:). El valor es el número de bytes.

El uso de SET WINDOW no afecta las definiciones de ruta existentes.


DEFINE ROUTE Agrega una entrada a la tabla de enrutamiento TCP/IP.

QUERY OPTIONS


IPN884I RWin: 65535

335

Capítulo 3 Descripción de Comandos: SHUTDOWN

SHUTDOWN

Sintaxis

Argumentos

Ejemplo 1

El comando SHUTDOWN ordena a TCP/IP FOR VSE que finalice todas

las operaciones.

SHUTdown [Immediate]

Immediate Cuando se especifica, el proceso de apagado pasa por alto la

mayoría de los procesos de apagado normales. Sólo se realizan los elementos que pueden evitar un reinicio normal.

shutdown IPN205A Respond "YES" for normal TCP/IP shutdown Reply to IPN205A is YES IPN146I TCP/IP Beginning Shutdown IPN597I Shutdown Stage: 1: Connection Terminations TCP913I Event Deleted: AUTOLPR1 TCP913I Event Deleted: AUTOFTP2 TCP913I Event Deleted: AUTOFTP1 TCP901I Shutdown Client Automation Daemon LPD903I Daemon Shutdown LPD FTP912I FTP01 not accepting connections on port 21 FTP908I Daemon Shutdown FTP Id: FTP01 Port: 21 IPN597I Shutdown Stage: 2: Daemon Terminations IPN597I Shutdown Stage: 3: Link Driver Terminations IPT101I Link Driver Processor LCS stopping IPI101I IP Processor Collector stopping IPN597I Shutdown Stage: 4: Network termination (max. 10 seconds) IPN597I Shutdown Stage: 5: API termination (max. 10 seconds) IPN597I Shutdown Stage: 6: System Task Terminations IPI101I IP Processor Prep 2 stopping IPI101I IP Processor Prep 1 stopping IPI101I IP Processor Raw 1 stopping IPI101I IP Processor Raw 2 stopping IPI101I IP Processor Input IP stopping IPI101I IP Processor Output IP stopping IPT101I TCP Processor Input stopping IPT101I TCP Processor Output stopping IPT101I UDP Processor Input stopping IPT101I UDP Processor Output stopping IPT101I ICMP Processor Input stopping IPT101I ICMP Processor Output stopping IPT101I IGMP Processor Input stopping IPT101I IGMP Processor Output stopping IPT101I Internet Link Level (ILL) Processor Input 802.2 stopping IPT101I Internet Link Level (ILL) Processor Output 802.2 stopping IPN597I Shutdown Stage: 7: Residual Task Termination

(continúa)

336

Capítulo 3 Descripción de Comandos: SHUTDOWN

Ejemplo 2

Notas



Siempre se le solicita al operador que confirme un apagado en

modo inmediato.

Durante el proceso de apagado, la pila notifica a todas las

aplicaciones y daemons. Luego espera a que cierren todas las conexiones y terminen. La pila continúa esperando hasta que no se

realice ningún progreso adicional. Este paso se omite cuando se

especifica “Immediate”.

Tras la notificación de la aplicación, todas las conexiones

restantes se cortan con un RESET. Este paso se omite cuando se

especifica “Immediate”.

Se libera el almacenamiento basado en SVA que no está

destinado a sobrevivir al apagado de la pila.

CONNECT_STATS

Controla la impresión de estadísticas de conexión durante el apagado.

DOWNCHECK

Controla la solicitud de seguridad para el comando SHUTDOWN.

QUIESCE

Evita nuevas conexiones mientras permite que las conexiones


IPN597I Shutdown Stage: 8: Halt Device I/O IPN597I Shutdown Stage: 9: Security Exit Shutdown IPN597I Shutdown Stage: 10: Terminate File I/O IPN597I Shutdown Stage: 11: Subtask Terminations IPN597I Shutdown Stage: 12: Operating System Interface Removal IPN597I Shutdown Stage: 13: Printing Statistics IPN597I Shutdown Stage: 14: Terminating Console Logging

shutdown immediate IPN205A Respond "YES" for IMMEDIATE TCP/IP shutdown Reply to IPN205A is YES IPN146I TCP/IP Beginning Shutdown IPN597I Shutdown Stage: 3: Link Driver Terminations IPT101I Link Driver Processor LCS stopping IPN597I Shutdown Stage: 8: Halt Device I/O IPN597I Shutdown Stage: 11: Subtask Terminations IPN597I Shutdown Stage: 12: Operating System Interface Removal IPN597I Shutdown Stage: 14: Terminating Console Logging

337

Capítulo 3 Descripción de Comandos: SINGLEDEST

SINGLEDEST

Sintaxis

Argumentos

El comando SINGLEDEST determina cómo el procesamiento de automatización

maneja múltiples informes en fila para el mismo destino (host)

SINGledest {ON|OFf}

ON Esto indica que los informes con el mismo nombre de script se tratarán

como si fueran a la misma impresora. Esto no hace que todos los informes se entreguen con un solo subproceso, pero dirige la lógica de entrega para

que no envíe un informe a un destino si ya hay un informe que usa el

mismo nombre de script en tránsito. Este es el valor predeterminado.

Tenga en cuenta lo siguiente:

Para asegurarse que los informes se emiten con un único

subproceso en todos los destinos, use SINGLE=YES en el

comando DEFINE EVENT.

El cliente de automatización asume que cada script que tiene un

nombre diferente tiene un destino diferente. El cliente no sabe

qué destino se puede establecer dentro de un script.

Si ORDER=YES en el comando DEFINE EVENT, todos los

informes llegarán en orden, según el número de la fila POWER. De lo contrario, se entregarán en el orden en que se encuentren y

se completen. Para algunos clientes, especialmente los Email, el

pedido es innecesario. Para otros, como LPD, puede o no ser

importante, según las necesidades del sitio.

Si ORDER=YES y algún informe está colgado (el servidor ha

dejado de responder, por ejemplo), el procesamiento del informe se detiene porque los informes deben llegar en orden.

OFf El procesamiento de automatización no supone que los informes van al

mismo destino, incluso si los nombres de los scripts son los mismos. Esto

provocará la entrega asincrónica de múltiples informes, siempre y cuando "SINGLE=NO" esté establecido en DEFINE EVENT. Tenga en cuenta

que el número máximo de entregas de informes asíncronos se establece

mediante los comandos SET MAX_xxx_EVENTS. No intente entregar múltiples informes al mismo destino a menos que sepa que los destinos

pueden aceptar transmisiones simultáneas.

Ejemplo

singledest on

IPN249I Value for Single Destination set to on

338

Capítulo 3 Descripción de Comandos: SINGLEDEST

Notas



Los eventos EMAIL no están bajo el control de la configuración SINGLEDEST.

Si algún LPD de destino es una impresora física, use

SINGLEDEST ON siempre porque una impresora no puede aceptar más de un informe a la vez.

Algunos servidores no son verdaderos servidores LPD, pero los

simulan y pueden o no aceptar múltiples informes que luego se

enviarán a un verdadero servidor LPD, lo que mejora el rendimiento. Determine si este es su caso.

DEFINE EVENT


QUERY EVENTS


SET MAX_EMAIL_EVENTS Establece el número máximo de eventos Email simultáneos para el


SET MAX_FTP_EVENTS



SET MAX_LPR_EVENTS

Establece el número máximo de eventos LPR simultáneos para el


339

Capítulo 3 Descripción de Comandos: SPINCHECK

SPINCHECK

Sintaxis

Argumentos

El comando SPINCHECK deshabilita el mecanismo de detección de

bucle TCP/IP FOR VSE. Utilice este comando sólo si debe permitir

que se completen procesos extremadamente intensivos en CPU.

SPINcheck {ON|OFF}

ON Dirige a TCP/IP FOR VSE para monitorear el uso de CPU de tareas internas y pseudo tareas. Si se detecta una condición de bucle, se

genera información de diagnóstico y termina TCP/IP FOR VSE. Este


OFF Las rutinas de detección de bucle TCP/IP FOR VSE están deshabilitadas.

Ejemplo


QUERY OPTIONS


spincheck off

IPN268I SPINCHECK now set to OFF

340

Capítulo 3 Descripción de Comandos: START

START

Sintaxis

Argumentos

El comando START reinicia el motor TCP/IP FOR VSE o un enlace de

comunicaciones.

START [LINKid=id]

(Null argument)

El despachador TCP/IP FOR VSE reanuda la ejecución.

id Se inicia el enlace de comunicaciones con esta ID.

Ejemplo 1

Ejemplo 2

Notas



Después de que se ejecuta el comando START, el motor TCP/IP se

reanuda en el punto donde se emitió el comando STOP anterior.

Pueden ocurrir tiempos de espera y desconexiones después de ejecutar START. Esto es normal y es el resultado de demoras

introducidas durante el período de detención.

El comando START se usa para iniciar enlaces de comunicaciones

que se definieron con el parámetro STOPPED.

DEFINE LINK Crea un enlace entre TCP/IP y una red o con una pila conectada

directamente.

STOP

Detiene el motor de despacho TCP/IP.

start

IPN499I TCP/IP processing started

start linkid=xmem_link IPN477I Task 0028 has resumed. IPNLRAW D:1 R:0

341

Capítulo 3 Descripción de Comandos: STEALTH

STEALTH

Sintaxis

Argumentos

Controla cómo la pila maneja las solicitudes de conexión que no

pueden coincidir con una conexión de escucha.

STEALTH {ON|OFF}

ON Las solicitudes de conexión rechazadas se descartan silenciosamente

sin responder con un RESET.

OFF Las solicitudes de conexión que no pueden coincidir con una

conexión de escucha se rechazan forzosamente con un RESET. Este

es el comportamiento predeterminado.

Ejemplo

Notas


El modo sigiloso es útil para disuadir los intentos de hackeo. El host remoto no tiene ninguna evidencia de que exista algo en la dirección que

se está probando. Cuando se intenta un escaneo de puertos, cada puerto

que se prueba requiere la cantidad máxima de tiempo para “fallar.”

QUERY PORTQUEUE Muestra estadísticas asociadas con solicitudes de conexión en fila.

QUERY OPTIONS


stealth on IPN268I Stealth mode now set to ON

342

Capítulo 3 Descripción de Comandos: STOP

STOP

Sintaxis

Argumentos

El comando STOP hace que el motor TCP/IP (1) detenga

temporalmente el envío de pseudo tareas o (2) suspenda los intentos

de activar un enlace de comunicaciones específico.

STOP [LINKid=id]

(Null argument)

Si no se especifica ningún argumento, todo el despachador TCP/IP se

coloca en estado detenido hasta que se emita un comando START.

id El controlador de enlace con esta ID se coloca en un estado detenido.

El resto del producto TPC / IP continúa funcionando.

Ejemplo 1

Ejemplo 2

Notas


Durante el estado detenido, el mecanismo de recolección de socket

continúa funcionando. Esto significa que el sistema y la partición

GETVIS se acumulan hasta que se emite un comando START y se

puedan procesar las solicitudes.

El comando STOP es útil cuando se produce un volcado estático con

el comando DUMP.

Si necesita agregar dinámicamente un enlace 3172, emitir el comando STOP le permite ingresar el comando DEFINE LINK y

los comandos DEFINE ADAPTER relacionados. Si no se emite

STOP, el sistema configura dinámicamente el enlace antes de que se puedan ingresar los comandos DEFINE ADAPTER. Vea también

DEFINE LINK para obtener una declaración de precaución sobre la

definición de un enlace que se eliminó.

Utilice STOP LINKID= sólo con CTCA y enlaces de partición

cruzada (IPNET). Al detener un enlace que conduce un dispositivo

LCS, se produce una recuperación de error excesiva y es probable que falle un reinicio del enlace.

stop IPN500W All TCP/IP processing stopped

stop linkid=link3172 IPN478I Task 0020 suspended in phase IPNLOSA2. Disp: 223

343

Capítulo 3 Descripción de Comandos: STOP


DEFINE ADAPTER


DEFINE LINK

Crea un enlace entre TCP/IP y una red o con una pila conectada

directamente.

QUERY LINKS


START

Inicia el motor de despacho TCP/IP o un enlace de red “detenido”.

344

Capítulo 3 Descripción de Comandos: SUSPEND

SUSPEND

Sintaxis

Argumentos

Ejemplo

Notas


El comando SUSPEND suspende una seudo tarea TCP/IP FOR VSE de

una ejecución posterior.

SUSPend taskid

taskid Es el número de tarea hexadecimal de identificación de la pseudo

tarea a suspender.


La pseudo tarea suspendida no se cambia de ninguna manera, excepto

que no es elegible para el envío.

Puede usar el comando QUERY TASKS para obtener los números de

tarea de TCP/IP para pseudo tareas internas de VSE.

El número de tarea se antepone a cada mensaje de consola mostrado por

TCP/IP para las tareas de VSE.

No suspenda ni reanude TCP/IP para pseudo tareas de VSE a menos que comprenda los efectos de estas acciones.

QUERY TASKS


RESUME Reanuda el procesamiento de una pseudo tarea suspendida.

suspend 000d IPN478I Task 000D suspended in phase IPNIGARB. Disp: 3,855

345

Capítulo 3 Descripción de Comandos: TRACERT

TRACERT

Sintaxis

Argumentos

Ejemplo

El comando TRACERT identifica cada salto entre la pila y el host

remoto.

TRACert host

host Especifica la dirección IP del host de destino. Esta puede ser una

dirección numérica real o un nombre simbólico que puede resolverse en una dirección IP.

Vea el Manual de Mensajes TCP/IP FOR VSE para una explicación de

cada mensaje en este ejemplo.

tracert csi-international.com TCP915I Tracing route to 012.182.034.227 (csi-international.com) TCP910I Hop: 010.089.128.001 at milliseconds: 00008. TCP910I TCP910I Hop: 024.095.086.193 at milliseconds: 00012. TCP910I GIG3-10.WOTNOH1-SWT401.COLUMBUS.RR.COM TCP910I Hop: 065.025.129.155 at milliseconds: 00013. TCP910I TGE1-2.CNVLOH1-SWT401.COLUMBUS.RR.COM TCP910I Hop: 065.025.129.157 at milliseconds: 00011. TCP910I TGE1-2.GRVWOH1-SWT401.COLUMBUS.RR.COM TCP910I Hop: 065.025.129.159 at milliseconds: 00012. TCP910I TGE2-1.CLMBOH1-RTR2.COLUMBUS.RR.COM TCP910I Hop: 065.025.137.245 at milliseconds: 00013. TCP910I TGE1-0-0.CLBOH1-RTR0.MWRTN.RR.COM TCP910I Hop: 066.109.006.068 at milliseconds: 00025. TCP910I AE-4-0.CR0.CHI30.TBONE.RR.COM TCP910I Hop: 066.109.006.155 at milliseconds: 00022. TCP910I AE-1-0.PR0.CHI10.TBONE.RR.COM TCP910I Hop: 004.059.028.109 at milliseconds: 00021. TCP910I XE-10-2-0.EDGE2.CHICAGO2.LEVEL3.NET TCP910I Hop: 004.069.138.190 at milliseconds: 00023. TCP910I VLAN52.EBR2.CHICAGO2.LEVEL3.NET TCP910I Hop: 004.069.140.193 at milliseconds: 00035. TCP910I AE-5-5.EBR2.CHICAGO1.LEVEL3.NET TCP910I Hop: 004.068.101.168 at milliseconds: 00169. TCP910I AE-24-56.CAR4.CHICAGO1.LEVEL3.NET TCP910I Hop: 192.205.033.185 at milliseconds: 00024. TCP910I TCP910I Hop: 012.122.133.138 at milliseconds: 00034. TCP910I CR1.CGCIL.IP.ATT.NET TCP910I Hop: 012.123.007.025 at milliseconds: 00034. TCP910I GAR4.CLBOH.IP.ATT.NET TCP910I Hop: 012.090.239.238 at milliseconds: 00041. TCP910I

(continúa)

346

Capítulo 3 Descripción de Comandos: TRACERT

Notas



ICMP Echo (ping) debe estar permitido en la red para que TRACERT

funcione.

Cada salto muestra la dirección IP y el nombre de dominio asociado

con la dirección. Si el nombre de dominio está en blanco, ninguno

existe o ninguno es devuelto por la búsqueda inversa de DNS.

DISCOVER

Determina el “mejor” tamaño de MTU para un host remoto.

PING

Emite una solicitud de ICMP Echo (PING).

TCP910I Hop: 012.182.034.227 at milliseconds: 00042. TCP910I CSI-INTERNATIONAL.COM

TCP910I TRACERT was successful.

347

Capítulo 3 Descripción de Comandos: TRAFFIC

TRAFFIC

Sintaxis

Argumentos

El comando TRAFFIC controla cómo TCP/IP FOR VSE maneja el tráfico

IP y no-IP. Esto puede ser útil para diagnosticar problemas de rendimiento.

TRAFFic {ON|OFF|FULL}

ON El tráfico IP es procesado por la pila. Esta es la configuración

predeterminada y recomendada.

OFF No se pasa tráfico a la pila. Todos los datagramas entrantes se

descartan.

FULL Todo el tráfico se pasa a la pila, incluido cualquier tráfico que no

sea IP. Esto incluye IPX y NetBEUI, por ejemplo.

Ejemplo

Notas



La mayoría de las unidades de control de red son capaces de filtrar el tráfico no-IP. Si su controlador está equipado con esta capacidad, actívelo.

El tráfico no-IP aumenta el consumo de CPU.

El tráfico no-IP no es un problema con los enlaces CTC, de partición

cruzada (IPNET), OSA-Express o CLAW.

Puede emitir el comando QUERY STATS para determinar si entra tráfico no-IP en su sistema TCP/IP FOR VSE.

QUERY OPTIONS


QUERY STATISTICS


traffic full IPN268I TRAFFIC now set to FULL

348

Capítulo 3 Descripción de Comandos: TRUST

TRUST

Sintaxis

Argumentos

El comando TRUST le permite asignar o eliminar el estado “confiable” de

una dirección IP. Una dirección IP “confiable” nunca está sujeta a que se

revoque su acceso a VSE debido a actividades sospechosas.

TRUSt {ADD|DELete} ,IPaddress=ip4addr

ADD

La dirección especificada está marcada como “confiable.”

DELete La dirección especificada ya no está marcada como “confiable.”

ip4addr Es la dirección IP que debe actualizar su estado de “confianza”.

Ejemplo


ACCESS


QUERY TRUSTED

Muestra las direcciones IP confiables actualmente.

trust add,ipaddress=192.168.1.66 query trust IPN253I << TCP/IP Trusted IP Addresses >> IPN127I 192.168.1.66 IPN127I 192.168.1.1 12.182.34.168

349

Capítulo 3 Descripción de Comandos: UPCASE

UPCASE

Sintaxis

Argumentos

El comando UPCASE especifica el mostrar todo el tráfico de la consola

TCP/IP FOR VSE en mayúsculas.

Upcase {ON|OFF}

ON Todos los mensajes que se muestran en la consola se cambian a mayúsculas.

OFF Todos los mensajes que se muestran en la consola están en mayúsculas y

minúsculas. Este es el valor predeterminado.

Ejemplo

Notas



Algunos datos que muestra TCP/IP para los comandos de la consola VSE distinguen entre mayúsculas y minúsculas.

El comando UPCASE no funciona para las salidas que no son de la

consola, como la salida de un trabajo por lotes FTP. Algunos clientes

TCP/IP para VSE tienen opciones para forzar la traducción a mayúsculas de los mensajes.

Vea la Guía del Usuario de TCP/IP FOR VSE para obtener información

sobre cómo habilitar la traducción de mensajes en mayúsculas en los

clientes FTP.

DEFINE LOG


MODIFY LOG


QUERY LOGS


QUERY OPTIONS


upcase on IPN246I UPPER CASE MESSAGE TRANSLATION SET TO ON UPCASE OFF IPN246I Upper Case message translation set to off

350

Capítulo 3 Descripción de Comandos: VERIFY_MEMORY

VERIFY_MEMORY

Sintaxis

Argumentos

El comando VERIFY_MEMORY deshabilita o habilita la función de

monitor de almacenamiento. El monitor de almacenamiento comprueba

agresivamente la memoria en busca de superposiciones o daños causados por la ejecución incorrecta de tareas o procesos.

VERIFY_MEMORY {ON|OFF}

ON El motor multitarea TCP/IP FOR VSE prueba la validez de cada

elemento de almacenamiento en cada envío. Esta comprobación

aumenta tanto el almacenamiento agregado utilizado como la CPU consumida. Esta es la configuración predeterminada y recomendada.

OFF Inhabilita las pruebas de almacenamiento.

Ejemplo

Notas


Las siguientes notas aplican:

Cuando VERIFY_MEMORY ON está en efecto, el administrador de almacenamiento, que normalmente coloca “bytes de protección”

aleatorios en el área inmediatamente adyacente a cada elemento de

almacenamiento, también prueba si esos bytes de protección están en su lugar al liberar un bloque de almacenamiento. Si faltan los bytes, existe

un problema de superposición de almacenamiento y la pila TCP/IP

emite un mensaje de error de nivel vital para informar el problema.

Aunque esta prueba es costosa en términos del CPU requerido, puede

detectar la mayoría de los casos de corrupción del almacenamiento

mientras el programa infractor aún está bajo control.

Ciclar la pila con STORMON codificado en el campo PARM de la

tarjeta EXEC también permite el monitoreo del almacenamiento. La pila también muestra la ubicación de la memoria de la fase del

administrador de almacenamiento (IPN900D)).

QUERY STOR

Muestra información detallada sobre el uso de la memoria en la partición

TCP/IP FOR VSE.

VERIFY_MEMORY ON IPN268I VERIFY_MEMORY now set to ON VERIFY_MEMORY OFF IPN268I VERIFY_MEMORY now set to OFF

351

Capítulo 3 Descripción de Comandos: WAITFOR

WAITFOR

El comando WAITFOR suspende la inicialización de TCP/IP FOR VSE

hasta que se haya producido el evento especificado.

Sintaxis

Argumentos

Ejemplo

Notas


Puede emitir este comando más de una vez, con un parámetro diferente

para cada instancia. No hay un valor predeterminado, por lo que un parámetro faltante dará como resultado que el comando no se ejecute.

WAITfor {VTam|IPNEt|TIME[=]nn}

VTam La inicialización se detiene hasta que la pila ha detectado que

VTAM se ha inicializado.

IPNEt Este parámetro no hace nada y se ignora la solicitud de espera. Se

utilizó en versiones anteriores y se incluye por compatibilidad.

TIME=nn La inicialización se detiene nn segundos.

Nota: “WAIT TIME nn” (sin el delimitador “=”) es aceptado.

Si WAITFOR se encuentra como un comando después de que el

despachador de la pila se haya activado, se ignorará.

DEFINE TELNETD


INCLUDE

Incluye un miembro de la librería en el conjunto de parámetros de inicialización.

WAITFOR VTAM IPN394I Testing for an active VTAM partition IPN395I Waiting for VTAM to become active IPN395I Waiting for VTAM to become active IPN396I VTAM is active and functioning

352

4 Comandos Obsoletos

Los siguientes comandos TCP/IP FOR VSE ya no son compatibles y no

deben usarse en 2.2.x. Esta lista es acumulativa y puede incluir comandos que fueron desaprobados en versiones anteriores.

Algunos de estos comandos obsoletos pueden parecer aceptados por la pila. Sin embargo, ya no se hace referencia a su configuración, y sus

acciones ya no tienen ningún efecto. Los comandos que entran en esta

categoría se eliminarán en futuras actualizaciones, por lo que es mejor

eliminarlos de los scripts ahora.

Comando

Usado hasta

Notas

ACTIVATE 1.5E Sustituido por RESUME

ARPDELETE 1.5E Procesamiento ARP rediseñado

ATTACH

CONNECT_QUEUE Ya no es necesario

DEBUG Sustituido por DIAGNOSE DEBUG

DEFINE FILESYS Sustituido por EXEC FILESYS utility

DELETE SECURITY 1.5E Sustituido por SECURITY

DIAGNOSE_SECEXIT Sustituido por DIAGNOSE

DISPATCH

DISPATCH_TIME

DYNAMIC_ROUTE Ya no es necesario

FIXED_RETRANSMIT Ya no es necesario

FULL_CETIERROR 1.5E Hardware ya no es soportado

FULL_SEGMENT Ya no es necesario

HOLD Ya no es necesario

353

Capítulo 4 Comandos Obsoletos

Comando

Usado hasta

Notas

LISTIDCAMS Ya no es necesario

LOCALECB Ya no es necesario

MATCH_MESSAGE Ya no es necesario

NFS Ya no es necesario

QUERY SUSPENDED 1.5E

REDISPATCH

RELEASE 1.5E

REUSE Ya no es necesario

REXX_SUPPORT Ya no es necesario

SECURITY_ARP Sustituido por SECURITY

SECURITY_IP Sustituido por SECURITY

SET ARP_TIME 1.5E Procesamiento ARP rediseñado

SET CLOSE_DEPTH 1.5E Control de mensajes entrantes rediseñado

SET CONNECT_SEQ Sustituido por CONNECT_SEQUENCE

SET CONSOLE_PORT Remplazada por la función opcional

SEE-TCP/IP FOR VSE

SET MESSAGE INFO Sustituido por MODIFY LOG

SET REUSE_SIZE 1.5E Sustituido por el comando IBBLOK

SET TRANSFER_BUFFERS Sustituido por DEFINE FTPD

SOCKCHECK Ya no es necesario

tcp/ip for vse 2.2 command reference - october 2017

Documents