Comandos de VSCode

La extensión WaRPGate agrega 11 comandos a la paleta de comandos (Ctrl+Shift+P / F1), todos con el prefijo WaRPGate:. Esta página muestra un ejemplo real de cada uno, con capturas de pantalla.

WaRPGate: Validate File

Corre el compilador en modo validación sobre el archivo .warp activo: revisa la sintaxis y la semántica (tipos, referencias, variables no declaradas, etc.) sin generar ningún archivo. Los errores y warnings aparecen en el canal de salida “WaRPGate”.

Ejemplo: un Program que asigna una variable no declarada.

@Source {
    &CodigoCliente = &Inexistente
}

WaRPGate: Generate

Corre el compilador completo sobre el archivo activo: valida y, si no hay errores, genera los archivos RPGLE/DDS/CL localmente (no despliega nada a IBM i). Es el equivalente a --action generate del CLI.

WaRPGate: Build & Deploy

Genera igual que el comando anterior y además sube los archivos al IBM i configurado en @Connection del .warpcfg, para compilarlos ahí (CRTPF/CRTLF/CRTBNDRPG/CRTDSPF). Como esto se conecta a un sistema real, siempre pide confirmación antes de continuar.

WaRPGate: Select Project File (.warproj)

Cuando el workspace tiene más de un .warproj, este comando elige cuál usar para validar/generar/desplegar. El proyecto elegido queda recordado para los demás comandos.

WaRPGate: Reverse Engineer DDS…

Reconstruye un archivo .warp de tabla a partir de un miembro DDS que ya existe en IBM i. Pide, en orden: la ruta QSYS.LIB del miembro DDS de la tabla, los miembros DDS de los índices (LF) a incluir en @Indexes (opcional), y el nombre del .warp a generar. Al final confirma antes de conectarse.

WaRPGate: Preview Layout

Muestra el @Layout del archivo activo como una pantalla de terminal IBM i 5250 (ver IntelliSense en VSCode). Si el Screen usa Popup: True, el preview dibuja la ventana en su posición y tamaño reales dentro de la pantalla completa.

Ejemplo: un Screen popup con un DataGridView de 3 columnas.

WaRPGate: Select Active Profile (@Profile)

Disponible en la paleta de comandos y en el menú contextual del editor sobre un archivo .warp. Abre un selector con los perfiles (@Profile) declarados en el .warpcfg del proyecto activo, más la opción “Use project default”. La elección queda recordada para ese proyecto (persiste al reiniciar VSCode) y se refleja en una barra de estado propia (ícono de capas), que también abre el mismo selector con un clic.

Sin una elección explícita, la extensión no envía --profile al compilador y el CLI cae solo al Default Profile declarado en @Project — ver Archivo de proyecto.

WaRPGate: Select Layout Block

Cuando un Program (reporte) tiene más de un Block en su @Layout, este comando elige cuál mostrar en el Preview Layout — el preview siempre muestra un único Block a la vez.

WaRPGate: Request License

Pide un nombre o empresa a nombre de quien se emitirá la licencia, abre un diálogo para guardar el archivo request.json y ejecuta --action license-request. Al terminar muestra el identificador del equipo con los botones Copy Machine ID (copia el identificador al portapapeles) y Reveal File (abre la ubicación del archivo en el explorador del sistema). Envía el request.json y el identificador del equipo a warpgate@softwarehouse.pe.

WaRPGate: Install License

Abre un selector para elegir el license.json recibido de Software House. Verifica que sea una licencia (si es el archivo de solicitud o no es un JSON válido, muestra un error) y lo copia a la ruta que lee el compilador: %APPDATA%\warpgate\license.json en Windows, ~/.config/warpgate/license.json en Linux/macOS. Si WARPGATE_LICENSE_FILE está definida, se usa esa ruta.

Si ya existe una licencia en esa ruta, pide confirmación antes de reemplazarla: la anterior deja de valer. Al terminar ofrece el botón Check Status.

WaRPGate: License Status

Ejecuta --action license-status y muestra el estado de la licencia, su vencimiento y el producto. Si warpgate.projectFile está configurado, usa el @License de ese proyecto (y el perfil activo, si hay uno elegido); si no, consulta la licencia individual de la ruta por defecto. El detalle completo queda en el canal de salida “WaRPGate”.

Para el flujo completo de solicitud e instalación, ver Licenciamiento.

Idioma de los mensajes del compilador

El setting warpgate.language (auto | es | en, por defecto auto) define el idioma de los diagnósticos que muestra el compilador. La extensión lo pasa como --lang en todas las llamadas al compilador. Con auto se usa el idioma de VSCode: español si empieza con es, inglés en otro caso.

Este setting solo afecta los mensajes del compilador; no cambia los menús ni los hovers de la extensión. Ver también Diagnósticos.