Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This problem can be overcome by using the X_START utility. For example, imagine you had the following X_RUN command associated with an icon on your desktop:

...

     X_RUN PROC=TEST01 PART=DEM USER=QPGMR

then by altering format of the X_RUN command behind the icon to:

...

     X_START X_RUN PROC=[TEST01/Process Name/PROCESS]

    PART=[DEM/Partition Identifier /PARTITION] 

...

A [ / / ] or { / / } formatted prompt request must always be formatted exactly like this:

     [default value / description / symbolic name]

or this:

     {default value / description / symbolic name}

Generally you should use the [ / / ] notation in Windows environments.

For example, this is the command invoked when you select Execute Process on a Workstation from the LANSA menu:

%tit%Execute process on workstation

     %tit%Execute process on workstation
%hlp%x_start.009
%basepath%\x_lansa\execute\X_RUN.exe

...

     ROC=[Name/Process/PROC]
LANG=[ENG/Language/LANG]

...

     ART=[DEM/

...

Partition Identifier/PART]
USER=[QPGMR/LANSA User/USER]
%WIN%DBUS=[DBA/

...

Database User/DBUS]
%WIN%PSWD=[*password/

...

Database Password/PSWD]
DBII=[LX_LANSA/

...

Database Name/DBII%reg%LX_DBName]
%W95%DBUT=[SQLANYWHERE/

...

Database Type/DBUT%reg%LX_DBType]
%WNT%DBUT=[MSSQLS/

...

Database Type/DBUT%reg%LX_DBType]
%W95%CMTH=[E/

...

Communication Method/CMTH]
%WNT%CMTH=[C/

...

Communication Method/CMTH]
%W95%CDLL=[E32APPC.DLL/

...

Communications DLL to Use/CDLL%reg%LX_CommsDLLName]
%WNT%CDLL=[WCPIC32.DLL/

...

Communications DLL to Use/CDLL%reg%LX_CommsDLLName]
PRTR=[LPT1/

...

Default Printer/PRTR]

This function causes the Execute process on workstation dialog box to appear.

...

The values entered are then substituted into the command. If XXXXXX was keyed as the process name and SYS as the partition identifier, then the command that is assembled for execution would be:

     X_RUN PROC=XXXXXX PART=SYS USER=QPGMR .... etc .......

Additionally, the value XXXXXX would be remembered with the symbolic name PROCESS and the value SYS would be remembered with the symbolic name PARTITION. This means that the next time the X_START facility is invoked and a [//] or {//} prompt has the symbolic name PROCESS then the remembered value XXXXXX will be used in preference to any default value specified in the [//] or {//} prompt.

...

The data stored in file X_START.SAV is logically formatted as <symbolic name><value><symbolic name><value> and up to 1024 symbolic names may be in use at any time. Neither the symbolic name nor its value should ever be more than 256 characters in length.


Also see

18.1.1 Rules, Limitations and Guidelines

18.1.2 Commands and Special Variables