NUWIKI:HOST DATA
path: ROBERT NELSON > JOHN LANDGRAF, PH.D. > PEYTON QUINN > JIM LORD > NUWIKI:HOST DATA

NUWIKI SYNTAX

Host based data management

NuWiki provides exclusive syntactical options for the retrieval AND UPDATE of data on a MultiValue host system
according to rules encapsulated on the host.

  • This option is available ONLY for Private, Custom NuWiki installations
    hosted on one's own servers with access to one's own data.
  • Binary Star restricts access to private data on public systems.

Syntax

Syntax for NUEXE using double brace commands, is as follows:

{{NUEXE:tcl command}}

Any valid TCL command can be executed and the result embedded in the current document.

Examples:

  • {{NUEXE:SORT UV.ACCOUNT}}
  • {{NUEXE:CT VOC APP.PROGS}}
  • {{NUEXE:YourProgramName}}
  • {{NUEXE:LIST-ITEM VOC 'APP.PROGS'}}

When executing a TCL command or basic program that CRT's or PRINT's, the output stream becomes embedded in the page.

Technical theory of operation

When a NuWiki page is requested, the stored item is processed by SUBR.NUWIKI.REPLACE.TOKENS which
expands the syntactical conventions similarly to the form:

  • [[ABOUT NUCLEUS|About Nucleus]]
    • to an active link which would follow standard HTML syntax, as:
http://www.nuwiki.com/cgi-bin/nuwiki.cgi?display=ABOUT%20NUCLEUS

When SUBR.NUWIKI.REPLACE.TOKENS encounters a NUEXE operative during it's parsing, a special event occurs, which calls SUBR.NUWIKI.NUEXE.

'SUBR.NUWIKI.NUEXE' will:

  • Execute a TCL command such as LIST, SORT, LIST-ITEM
  • Execute a Nucleus shell command or,
  • a NUQL command statement or,
  • a cataloged BASIC program or,
  • Call a cataloged subroutine

and pass the results in the variable RESP and EXECUTE NUWIKI.HTML.GEN.
NUWIKI.HTML.GEN will incorporate the results of the execution of the host based program into the output stream delivered to the browser.

Example

 {{NUEXE:LIST-ITEM VOC 'APP.PROGS'}} 

001 File - Used to store unsupported programs and user-contributed programs
002 /usr/ibm/uv/APP.PROGS
003 /usr/ibm/uv/D_APP.PROGS

See also

Note: You must be logged as a NuWiki user to access the Vendor update or ICUST update routines.