This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
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.
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
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
Capítulo 3 Descripción de Comandos: Lista Resumen
Comando Descripción
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
Capítulo 3 Descripción de Comandos: Lista Resumen
Comando Descripción
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
Capítulo 3 Descripción de Comandos: Lista Resumen
Comando Descripción
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.
Capítulo 3 Descripción de Comandos: Lista Resumen
Comando Descripció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
Capítulo 3 Descripción de Comandos: Lista Resumen
Comando Descripción
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
Capítulo 3 Descripción de Comandos: Lista Resumen
Comando Descripción
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
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 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
Capítulo 3 Descripción de Comandos: Lista Resumen
Comando Descripción
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
Comandos Relacionados
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
Capítulo 3 Descripción de Comandos: ASECURITY
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
Capítulo 3 Descripción de Comandos: ASECURITY
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
Capítulo 3 Descripción de Comandos: ASECURITY
Notas
Comandos Relacionados
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
Controla las funciones de seguridad TCP/IP.
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
Comandos Relacionados
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
Comandos Relacionados
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
Comandos Relacionados
Este comando debe usarse sólo en circunstancias extraordinarias.
CLOSe FILE PUBlic=pubname
PUBlic= El nombre del archivo a cerrar.
Las siguientes notas aplican a este comando:
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
Muestra el contenido del sistema de archivos TCP/IP FOR VSE.
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
Capítulo 3 Descripción de Comandos: CONNECT_SEQUENCE
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
Capítulo 3 Descripción de Comandos: CONNECT_SEQUENCE
Ejemplo
Notas
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Capítulo 3 Descripción de Comandos: DEFINE ADAPTER
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.
Las siguientes notas aplican a este comando:
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.
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
Capítulo 3 Descripción de Comandos: DEFINE ADAPTER
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.
Comandos Relacionados
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.
Las siguientes notas aplican a este comando:
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
Comandos Relacionados
DEFINE LINK
Crea un enlace entre TCP/IP y una red o con una pila
conectada directamente.
DEFINE ROUTE
Agrega una entrada a la tabla de enrutamiento TCP/IP.
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
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
Capítulo 3 Descripción de Comandos: DEFINE EVENT
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.
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
Capítulo 3 Descripción de Comandos: DEFINE EVENT
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
Capítulo 3 Descripción de Comandos: DEFINE EVENT
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
Capítulo 3 Descripción de Comandos: DEFINE EVENT
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
Capítulo 3 Descripción de Comandos: DEFINE EVENT
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
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
Capítulo 3 Descripción de Comandos: DEFINE FILE
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
Capítulo 3 Descripción de Comandos: DEFINE FILE
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
Capítulo 3 Descripción de Comandos: DEFINE FILE
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
Capítulo 3 Descripción de Comandos: DEFINE FILE
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
sección “RECFM, LRECL, BLKSIZE”, pág. 60, para detalles.
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
sección “RECFM, LRECL, BLKSIZE”, pág. 60, para detalles.
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
sección “RECFM, LRECL, BLKSIZE”, pág. 60, para detalles.
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
Capítulo 3 Descripción de Comandos: DEFINE FILE
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
Capítulo 3 Descripción de Comandos: DEFINE FILE
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
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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
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
2F RSA_AES128CBC_SHA
72
Capítulo 3 Descripción de Comandos: DEFINE FTPD
0A RSA_3DESCBC_SHA
AES Las siguientes cifras son permitidas:
35 RSA_AES256CBC_SHA
2F RSA_AES128CBC_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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
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
Notas Las siguientes notas aplican a este comando:
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
Capítulo 3 Descripción de Comandos: DEFINE FTPD
Comandos Relacionados
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
Carga y controla las tablas de traducción ASCII/EBCDIC.
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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.
Este parámetro sólo tiene efecto si también se especifica OUTPUT=LPR.
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.
Este parámetro sólo tiene efecto si también se especifica OUTPUT=LPR.
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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
Capítulo 3 Descripción de Comandos: DEFINE GPSD
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
Comandos Relacionados
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.
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
Capítulo 3 Descripción de Comandos: DEFINE HTTPD
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
Notas Las siguientes notas aplican a este comando:
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
Capítulo 3 Descripción de Comandos: DEFINE HTTPD
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.
Comandos Relacionados
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
Carga y controla las tablas de traducción ASCII/EBCDIC.
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
Controla las funciones de seguridad TCP/IP.
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
Capítulo 3 Descripción de Comandos: DEFINE LINK
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
Capítulo 3 Descripción de Comandos: DEFINE LINK
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
Capítulo 3 Descripción de Comandos: DEFINE LINK
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
Capítulo 3 Descripción de Comandos: DEFINE LINK
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
Capítulo 3 Descripción de Comandos: DEFINE LINK
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.
Consulte su documentación de OSA Express para obtener más
información sobre este parámetro.
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.
Consulte su documentación de OSA Express para obtener más
información sobre este parámetro.
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
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
Capítulo 3 Descripción de Comandos: DEFINE LINK
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.
Comandos Relacionados
DEFINE ADAPTER
Crea una definición de adaptador dentro del alcance de DEFINE LINK.
DEFINE ROUTE
Agrega una entrada a la tabla de enrutamiento TCP/IP.
DISCOVER
Determina el "mejor" tamaño de MTU para un host remoto.
EXECUTE
Ejecuta un script de comando de operador.
QUERY STATS
Muestra las estadísticas del controlador de enlace OSAX cuando
se usa la opción LINKID=.
SET IPADDR
Establece la dirección de inicio predeterminada para la pila.
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.
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
Capítulo 3 Descripción de Comandos: DEFINE LOG
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
Capítulo 3 Descripción de Comandos: DEFINE LOG
Ejemplo
Notas
Comandos Relacionados
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
Capítulo 3 Descripción de Comandos: DEFINE LPD
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
Las siguientes notas aplican a este comando:
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.
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
Comandos Relacionados
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.
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
Capítulo 3 Descripción de Comandos: DEFINE ROUTE
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
Capítulo 3 Descripción de Comandos: DEFINE ROUTE
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
Capítulo 3 Descripción de Comandos: DEFINE ROUTE
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
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
Capítulo 3 Descripción de Comandos: DEFINE SOTRACE
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
Comandos Relacionados
TELNET Rastrea sólo solicitudes de socket que especifiquen un tipo de telnet.
Las siguientes notas aplican a este comando:
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
Capítulo 3 Descripción de Comandos: DEFINE SOTRACE
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
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.
Comandos Relacionados
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
Crea un daemon TN3270 o TN3270E.
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Realiza un volcado formateado de varios bloques de control TCP/IP.
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).
Este es el valor predeterminado.
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Capítulo 3 Descripción de Comandos: DEFINE USER
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
Notas Las siguientes notas aplican a este comando:
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.
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
Comandos Relacionados
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
Comandos Relacionados
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
Crea una ID de usuario y contraseña.
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
Capítulo 3 Descripción de Comandos: DIAGNOSE
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
Capítulo 3 Descripción de Comandos: DIAGNOSE
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
datagramas son interceptados y mostrados.
162
Capítulo 3 Descripción de Comandos: DIAGNOSE
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
datagramas son interceptados y mostrados.
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
Capítulo 3 Descripción de Comandos: DIAGNOSE
Ejemplo
Notas
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Cambia las características de un archivo de registro del sistema.
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
Comandos Relacionados
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.
Las siguientes notas aplican a este comando:
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
conectada directamente.
DEFINE ROUTE
Agrega una entrada a la tabla de enrutamiento TCP/IP FOR VSE.
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
Comandos Relacionados
QUERY OPTIONS
Muestra los valores actuales de los parámetros modificables.
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.
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.
Comandos Relacionados
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
Comandos Relacionados
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
Muestra el estado de una o más conexiones.
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Muestra los valores actuales de los parámetros modificables.
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
Comandos Relacionados
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
Crea una definición de adaptador dentro del alcance de DEFINE LINK.
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
Agrega una entrada a la tabla de enrutamiento TCP/IP.
QUERY HOME
Muestra todas las direcciones IP en la tabla “Home Addres”.
QUERY STATISTICS
Muestra un resumen de la información relacionada con la pila.
QUERY OPTIONS
Muestra los valores actuales de los parámetros modificables.
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
Comandos Relacionados
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.
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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]
[,TIMEstamp={Left|Right|None}] [,routes]
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]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 Los mensajes informativos generales se registran/suprimen.
[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.
192
Capítulo 3 Descripción de Comandos: MODIFY CONSOLE
Ejemplo
Notas
Comandos Relacionados
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
Crea un archivo de registro del sistema.
MESSAGE
Controla la supresión de mensajes.
MODIFY LOG
Cambia las características de un archivo de registro del sistema.
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
Capítulo 3 Descripción de Comandos: MODIFY FILE
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
Capítulo 3 Descripción de Comandos: MODIFY FILE
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
Capítulo 3 Descripción de Comandos: MODIFY FILE
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.
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 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
Capítulo 3 Descripción de Comandos: MODIFY FILE
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.
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.
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.
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.
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
Capítulo 3 Descripción de Comandos: MODIFY FILE
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
Capítulo 3 Descripción de Comandos: MODIFY FILE
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:
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 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.
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
Capítulo 3 Descripción de Comandos: MODIFY FILE
se proporcionará 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.
Entrada Salida
recfm lrecl blksize lrecl blksize
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.
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.
Entrada Salida
recfm lrecl blksize lrecl 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 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
Capítulo 3 Descripción de Comandos: MODIFY FILE
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
F Tamaño de Registro N/A N/A N/A
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
Capítulo 3 Descripción de Comandos: MODIFY FILE
Consideraciones a Archivos Library
Comandos Relacionados
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
Carga y controla las tablas de traducción ASCII/EBCDIC.
DELETE FILE
Elimina un archivo del sistema de archivos TCP/IP FOR VSE.
QUERY FILES
Muestra el contenido del sistema de archivos TCP/IP FOR VSE.
QUERY FILEIO
Muestra el estado de los programas del controlador I/O de archivo.
SECURITY
Controla las funciones de seguridad TCP/IP FOR VSE.
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]
[,TIMEstamp={Left|Right|None}] [,routes]
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]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 Los mensajes informativos generales se registran/suprimen.
[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.
205
Capítulo 3 Descripción de Comandos: MODIFY LOG
[NO]SECurity Los mensajes relacionados con la seguridad se registran/suprimen.
ALL Todos los tipos de mensajes son registrados.
Ejemplo
Notas
Comandos Relacionados
NONE Ningún mensaje en registrado.
Las siguientes notas aplican a este comando:
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
Crea un archivo de registro del sistema.
MESSAGE
Controla la supresión de mensajes.
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.
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
Capítulo 3 Descripción de Comandos: MODIFY ROUTE
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
milisegundos) que se puede asignar dinámicamente a DRETRAN.
MAXRetran= Si se especifica FIXRETRAN=NO, este es el tiempo máximo (en
milisegundos) que se puede asignar dinámicamente a DRETRAN.
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
Capítulo 3 Descripción de Comandos: MODIFY ROUTE
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: --
Notas Las siguientes notas aplican a este comando:
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
Capítulo 3 Descripción de Comandos: MODIFY ROUTE
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.
Comandos Relacionados
DEFINE ADAPTER
Crea una definición de adaptador dentro del alcance de DEFINE LINK.
DEFINE ALTIP Hace que la pila monitoree y responda a las solicitudes ARP de direcciones
de inicio adicionales.
DEFINE MASK
Crea una máscara de subred para una red en particular.
DEFINE ROUTE
Agrega una entrada a la tabla de enrutamiento TCP/IP FOR VSE.
DELETE ALTIP
Elimina una dirección de inicio alternativa.
210
Capítulo 3 Descripción de Comandos: MODIFY ROUTE
DELETE LINK
Elimina un enlace entre TCP/IP FOR VSE y una red o una pila
conectada directamente.
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
Controla el reenvío de datagramas no destinados a la pila VSE.
QUERY ARPS
Muestra el contenido actual de la tabla ARP.
QUERY LINKS
Muestra el estado de los enlaces de red.
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.
QUERY OPTIONS
Muestra los valores actuales de los parámetros modificables.
SET IPADDR
Establece la dirección de inicio predeterminada para la pila.
SET MASK
Establece una máscara de subred predeterminada.
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.
Las siguientes notas aplican a este comando:
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
Comandos Relacionados
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Configura la Salida de Seguridad Automática.
PING
Emite una solicitud de Eco ICMP (PING).
SECURITY
Controla las funciones de seguridad TCP/IP FOR VSE.
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.
Comandos Relacionados
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
Comandos Relacionados
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
Crea un daemon de Protocolo de Transferencia de Archivos.
QUERY CONNECTIONS
Muestra el estado de una o más conexiones.
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
Comandos Relacionados
El resultado de este comando puede ser voluminoso.
QUERY FTPDS
Muestra el estado de los daemons del Protocolo de Transferencia de
Archivos.
QUERY LINKS Muestra el estado de los enlaces de red.
QUERY TELNETDS
Muestra los daemons TN3270 y TN3270E.
219
Capítulo 3 Descripción de Comandos: QUERY ALL
QUERY ALL
Sintaxis
Argumentos
Ejemplo
Notas
Comandos Relacionados
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.
Las siguientes notas aplican a este comando:
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
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 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
Muestra el estado del procesamiento de automatización.
QUERY FILES
Muestra el contenido del sistema de archivos TCP/IP FOR VSE.
query all,syslst
220
Capítulo 3 Descripción de Comandos: QUERY ALL
QUERY FILEIO
Muestra el estado de los programas del controlador I/O de archivo.
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
Muestra el estado de los enlaces de red.
QUERY LPDS
Muestra el estado de los daemons de Impresora en Línea.
QUERY MASKS
Muestra todas las máscaras de subred definidas por número de red.
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
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 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
Capítulo 3 Descripción de Comandos: QUERY ALL
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 STATISTICS
Muestra un resumen de la información relacionada con la pila.
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 TRACES
Muestra una lista de rastreos actualmente en ejecución.
QUERY TRANSLATES
Muestra una lista de tablas de traducción disponibles.
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.
222
Capítulo 3 Descripción de Comandos: QUERY ALTIPS
QUERY ALTIPS
Sintaxis
Argumentos
Ejemplo
Comandos Relacionados
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
esta opción, los resultados se envían a SYSLST y a la consola.
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
Controla el reenvío de datagramas no destinados a la pila VSE.
QUERY HOME
Muestra todas las direcciones IP en la tabla “Direcciones de Inicio”.
QUERY LINKS
Muestra el estado de los enlaces 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.
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
Comandos Relacionados
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
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.
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
explicación de cada mensaje en este ejemplo.
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.
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
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]
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.
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este ejemplo.
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]
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 es posicional y debe colocarse inmediatamente después del comando.
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
de cada mensaje en este ejemplo.
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
Comandos Relacionados
DEFINE FTPD
Crea un daemons de Protocolo de Transferencia de Archivos.
DELETE FTPD
Termina un daemon de Protocolo de Transferencia de Archivos.
QUERY ACTIVE
Muestra el estado de los daemons activos.
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]
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.
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
Comandos Relacionados
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este ejemplo.
DEFINE GPSD
Crea un daemon de Servidor de Impresión General.
DELETE GPSD
Termina un daemon de Servidor de Impresión General.
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]
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.
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.
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
Comandos Relacionados
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]
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.
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este ejemplo.
QUERY STATISTICS
Muestra estadísticas que detallan las funciones internas de la pila.
QUERY OPTIONS
Muestra los valores actuales de los parámetros modificables.
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]
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.
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
Comandos Relacionados
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este ejemplo.
Para dispositivos de tipo LCS, también se muestran todos los adaptadores
asociados con un enlace.
DEFINE ADAPTER
Crea una definición de adaptador dentro del alcance de DEFINE LINK.
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
Este comando muestra el estado de las diferentes pantallas y registros de
TCP/IP FOR VSE.
Query LOGs [,SYSLST]
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.
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este ejemplo.
DEFINE LOG
Crea un archivo de registro del sistema.
MODIFY LOG
Cambia las características de un archivo de registro del sistema.
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]
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.
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
Comandos Relacionados
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
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]
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.
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
Comandos Relacionados
El comando QUERY PORTQUEUE muestra el estado actual de todos
los puertos donde se están poniendo en fila las conexiones.
Query PORTqueue [,SYSLST]
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.
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este ejemplo.
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
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]
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.
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
Comandos Relacionados
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este 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]
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.
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.
Ejemplo 1 Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
de cada mensaje en este ejemplo.
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Crea una máscara de subred para una red en particular.
DEFINE ROUTE
Agrega una entrada a la tabla de enrutamiento TCP/IP.
Capítulo 3 Descripción de Comandos: QUERY STATISTICS (or QUERY STATS)
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
Capítulo 3 Descripción de Comandos: QUERY STATISTICS (or QUERY STATS)
Comandos Relacionados
DEFINE LINK
Define los parámetros del enlace.
QUERY ISTATS
Muestra estadísticas que detallan las funciones internas de la pila.
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
es posicional y debe colocarse inmediatamente después del comando.
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
Capítulo 3 Descripción de Comandos: QUERY STOR
Ejemplo 1
Ejemplo 2
Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una
explicación de cada mensaje en los ejemplos 1 a 4.
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
es posicional y debe colocarse inmediatamente después del comando.
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.
Ejemplo 1 Vea el Manual de Mensajes TCP/IP FOR VSE para obtener una explicación
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
Comandos Relacionados
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
Las siguientes notas aplican a este comando:
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
Comandos Relacionados
QUERY CONNECTIONS
Muestra el estado de una o más conexiones
QUERY TASKS
Muestra una lista de pseudo tareas.
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.
Las siguientes notas aplican a este comando:
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.
Comandos Relacionados
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.
Este es el valor predeterminado.
Ejemplo
Notas
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
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 del Protocolo de Transferencia de Hipertexto (servidor web).
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
Las siguientes notas aplican a este comando:
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.
Comandos Relacionados
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
Crea un daemon TN3270 o TN3270E.
294
Capítulo 3 Descripción de Comandos: RESUME
RESUME
Sintaxis
Argumentos
Ejemplo
Comandos Relacionados
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
Muestra una lista de pseudo tareas.
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
es el valor predeterminado.
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
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
Comandos Relacionados
Las siguientes notas aplican a este comando:
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
Crea un archivo de registro del sistema.
MODIFY LOG
Cambia las características de un archivo de registro del sistema.
QUERY LOGS
Muestra las consolas y registros disponibles, junto con sus propiedades.
QUERY OPTIONS
Muestra los valores actuales de los parámetros modificables.
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
Comandos Relacionados
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
Comandos Relacionados
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
Crea un daemon TN3270 o TN3270E.
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